WinMain

Składnia

Argumenty

hInstance	Uchwyt do obecnej instancji programu.
hPrevInstance	Uchwyt do poprzedniej instancji programu. Wartość tego argumentu wynosi zawsze NULL. Aby określić, czy inna instancja tego programu obecnie istnieje, należy utworzyć muteks o unikalnej nazwie używając funkcji CreateMutex.
lpCmdLine	Argumenty podane w wierszu polecenia dla programu (bez nazwy programu). Aby pobrać całe polecenie, wywołaj funkcję » WinAPI ♦ GetCommandLine.
nCmdShow	Określa, w jaki sposób okno zostanie wyświetlone. Wartość tego argumentu może być jedną z poniższych stałych: Nazwa Wartość Znaczenie SW_HIDE 0 Ukrywa okno tego programu i aktywuje inne okno. SW_MAXIMIZE 3 Maksymalizuje określone okno. SW_MINIMIZE 6 Minimalizuje określone okno i aktywuje następne okno na osi Z. SW_RESTORE 9 Aktywuje i wyświetla okno. Jeśli okno jest zminimalizowane lub zmaksymalizowane, system przywraca oryginalne rozmiary oraz pozycję tego okna. Program powinien użyć tej flagi podczas przywracania zminimalizowanego okna. SW_SHOW 5 Aktywuje okno i wyświetla je w bieżących rozmiarach i pozycji. SW_SHOWMAXIMIZED 3 Aktywuje okno i wyświetla je jako zmaksymalizowane. SW_SHOWMINIMIZED 2 Aktywuje okno i wyświetla je jako zminimalizowane. SW_SHOWMINNOACTIVE 7 Wyświetla okno jako zminimalizowane. Efekt jest podobny do SW_SHOWMINIMIZED, ale okno nie jest aktywowane. SW_SHOWNA 8 Wyświetla okno w bieżących rozmiarach i pozycji. Efekt jest podobny do SW_SHOW, ale okno nie jest aktywowane. SW_SHOWNOACTIVATE 4 Wyświetla okno w ostatnich rozmiarach i pozycji. Efekt jest podobny do SW_SHOWNORMAL, ale okno nie jest aktywowane. SW_SHOWNORMAL 1 Aktywuje i wyświetla okno. Jeśli okno jest zminimalizowane lub zmaksymalizowane, system przywraca oryginalne rozmiary oraz pozycję tego okna. Program powinien użyć tej flagi podczas wyświetlania okna po raz pierwszy.

Zwracana wartość

Jeśli nie wystąpią żadne błędy, funkcja zakończy się po zwróceniu komunikatu WM_QUIT i powinna zwrócić wartość zawartą w argumencie wParam ostatniego komunikatu. Jeśli funkcja zakończy się przed wejściem do pętli komunikatów, powinna zwrócić zero.

Dodatkowe informacje

Nazwa WinMain jest używana zazwyczaj w wielu projektach. W zależności od szkieletu projektu, wywołanie tej funkcji może być poprzedzone oraz zakończony przez dodatkowe działania zależne od danego projektu. Ta funkcja powinna być używana do rozpoczęcia programu, wyświetlenia głównego okna i utworzenia pętli komunikatów kontrolującą zachowanie programu aż do jego zakończenia. Należy zakończyć działanie pętli komunikatów po otrzymaniu komunikatu WM_QUIT. W tym momencie ta funkcja powinna zakończyć działanie programu i zwrócić wartość zawartą w argumencie wParam. Jeśli komunikat WM_QUIT zostanie pobrany jako wynik wywołania funkcji PostQuitMessage, wartość argumentu wParam jest również wartością argumentu nExitCode funkcji PostQuitMessage. Programy ANSI mogą używać argumentu lpCmdLine tej funkcji, aby uzyskać dostęp do linii poleceń programu (bez jego nazwy). Należy pamiętać, że argument lpCmdLine wykorzystuje typ LPSTR, a nie LPTSTR. To powoduje, że ta funkcja nie może być wykorzystana w programach Unicode. Funkcja GetCommandLineW może być użyta do uzyskania linii poleceń jako łańcucha znaków Unicode. Niektóre projekty mogą zapewniać inne punkty rozpoczęcia programu zapewniające pobieranie linii poleceń w formacie Unicode. Na przykład kompilator Microsoft Visual Studio C++ używa w tym celu nazwy wWinMain.

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Winbase.h (dołącza Windows.h)

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms633559(v=vs.85).aspx