На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

WinMain



The WinMain function is called by the system as the initial entry point for a Win32-based application.

int WINAPI WinMain(

HINSTANCE hInstance, // handle to current instance
HINSTANCE hPrevInstance, // handle to previous instance
LPSTR lpCmdLine, // pointer to command line
int nCmdShow // show state of window
);


Parameters

hInstance

Identifies the current instance of the application.

hPrevInstance

Identifies the previous instance of the application. For a Win32-based application, this parameter is always NULL. If you need to detect whether another instance already exists, create a named mutex using the CreateMutex function. If the GetLastError function returns ERROR_ALREADY_EXISTS, another instance of your application exists (it created the mutex).

lpCmdLine

Points to a null-terminated string specifying the command line for the application.

nCmdShow

Specifies how the window is to be shown. This parameter can be one of the following values:

Value Meaning
SW_HIDE Hides the window and activates another window.
SW_MINIMIZE Minimizes the specified window and activates the top-level window in the system's list.
SW_RESTORE Activates and displays a window. If the window is minimized or maximized, Windows restores it to its original size and position (same as SW_SHOWNORMAL).
SW_SHOW Activates a window and displays it in its current size and position.
SW_SHOWMAXIMIZED Activates a window and displays it as a maximized window.
SW_SHOWMINIMIZED Activates a window and displays it as an icon.
SW_SHOWMINNOACTIVE Displays a window as an icon. The active window remains active.
SW_SHOWNA Displays a window in its current state. The active window remains active.
SW_SHOWNOACTIVATE Displays a window in its most recent size and position. The active window remains active.
SW_SHOWNORMAL Activates and displays a window. If the window is minimized or maximized, Windows restores it to its original size and position (same as SW_RESTORE).


Return Values

If the function succeeds, terminating when it receives a WM_QUIT message, it should return the exit value contained in that message's wParam parameter. If the function terminates before entering the message loop, it should return 0.

Remarks

WinMain initializes an application, displays its main window, and then enters a message retrieval-and-dispatch loop that is the top-level control structure for the remainder of the application's execution. The message loop terminates when a WM_QUIT message is received. At that point, WinMain exits the application, returning the value passed in the WM_QUIT message's wParam parameter. If WM_QUIT was received as a result of calling PostQuitMessage, the value of wParam is the value of the PostQuitMessage function's nExitCode parameter. For more information, see Creating a Message Loop.

See Also

CreateMutex, DispatchMessage, GetMessage, PostQuitMessage, TranslateMessage


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

WinMain



Функция WinMain названа системой как начальная точка входа для базирующегося приложения Win32.

int WINAPI WinMain(

hInstance HINSTANCE, // ОПЕРИРУЕТСЯ в текущий hPrevInstance примера HINSTANCE, // ручки в предшествующий пример LPSTR lpCmdLine, // указатель, чтобы приказывать линию показа int состояние nCmdShow // окна
);


Параметры

hInstance

Идентифицирует текущий пример приложения.

hPrevInstance

Идентифицирует предшествующий пример приложения. Для базирующегося приложения Win32, этот параметр всегда НЕДЕЙСТВИТЕЛЕН. Если Вам нужно обнаруживать что независимо другой пример уже существует, создайте поименованный mutex используя функцию CreateMutex. Если функциональный возврат GetLastError ERROR_ALREADY_EXISTS, другой пример вашего приложения существует (это создало mutex).

lpCmdLine

Точки на недействительный расторгнутую строку, определяющие командную линию для приложения.

nCmdShow

Определяет как окно должно быть показано. Этот параметр может быть одним из следующего величин:

Значение Величины
SW_HIDE Прячут окно и активизируют другое окно.
SW_MINIMIZE Минимизирует определенное окно и активизирует окно верхнего уровня в системном списке.
SW_RESTORE Активизирует и отображает окно. Если окно минимизировано или расширено, Окно восстанавливает это в свой оригинальный размер и позицию (также, как SW_SHOWNORMAL).
SW_SHOW Активизирует окно и отображает это в своем текущем размере и позиции.
SW_SHOWMAXIMIZED Активизирует окно и отображает это как расширенное окно.
SW_SHOWMINIMIZED Активизирует окно и отображает это как икона.
SW_SHOWMINNOACTIVE Отображает окно как икону. Активное окно остается активным.
SW_SHOWNA Отображает окно в своем текущем состоянии. Активное окно остается активным.
SW_SHOWNOACTIVATE Отображает окну в своем наиболее последнем размере и позиции. Активное окно остается активным.
SW_SHOWNORMAL Активизирует и отображает окно. Если окно минимизировано или расширено, Окно восстанавливает это в свой оригинальный размер и позицию (также, как SW_RESTORE).


Обратные Величины

Если функция получает, завершение когда она получает сообщение WM_QUIT, это должно возвращать выходную величину содержимую в этом параметре сообщения wParam. Если функция завершается перед вступлением цикла сообщения, она должна возвращать 0.

Замечания

WinMain ИНИЦИАЛИЗИРУЕТ приложение, отображает свое основное окно и затем вводит поиск-сообщение и-цикл отправки, которые - управляющая структура верхнего уровня для разности прикладного выполнения. Цикл сообщения завершается когда сообщение WM_QUIT получено. В этой точке, WinMain выходит из приложения, возвращать величину проходил в сообщение WM_QUIT параметра wParam. Если WM_QUIT был получен в результате разговора PostQuitMessage, величина wParam является величиной PostQuitMessage функционального параметра nExitCode. Более подробно, смотри Создавая Цикл Сообщения.

Смотри Также

CreateMutex, DispatchMessage, GetMessage, PostQuitMessage, TranslateMessage


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz