ShowWindow

Funkcja ShowWindow ustawia stan Pokaż określonego okna.

 (BOOL ShowWindow HWND  hWnd, / / dojście do oknaintnCmdShow / / wyświetlanie stanu okna);
 

Parametry

hWnd
Dojście do okna.
nCmdShow
Określa, w jaki sposób okno ma zostać wyświetlona. Ten parametr jest ignorowany aplikacja wywołuje ShowWindow, po raz pierwszy, jeśli programu, która rozpoczęła stosowanie wartość struktury. W przeciwnym razie ShowWindow jest nazywany, po raz pierwszy wartość powinna być wartością uzyskaną przez funkcję WinMain w jego parametru nCmdShow . W kolejnych zaproszeń ten parametr może mieć jedną z następujących wartości
Wartość Znaczenie
SW_FORCEMINIMIZE Systemu Windows NT 5.0 i nowsze: Minimalizuje okno, nawet jeśli wątek, który jest właścicielem okna jest zawieszona. Flaga ta powinna być stosowana tylko po zminimalizowaniu windows z innego wątku.
SW_HIDE Ukrywa okno i uaktywnia innego okna.
SW_MAXIMIZE Maksymalizuje okno określonego.
SW_MINIMIZE Minimalizuje okno określony i uaktywnia następny okno najwyższego poziomu w kolejności z.
SW_RESTORE Uaktywnia i wyświetla okna. Jeśli okno jest zminimalizowane lub zmaksymalizowane, systemu przywraca go do pierwotnego rozmiaru i położenia. Aplikacja należy określić tę flagę, gdy Przywracanie zminimalizowanego okna.
SW_SHOW Uaktywnia okno i wyświetla go w jego bieżący rozmiar i położenie.
SW_SHOWDEFAULT Ustawia stan Pokaż na podstawie flagi SW_, określonych w wartość struktury przekazany do funkcja CreateProcess przez program, który uruchomił aplikację.
SW_SHOWMAXIMIZED Uaktywnia okno i wyświetli go jako okno zmaksymalizowane.
SW_SHOWMINIMIZED Uaktywnia okno i wyświetli go jako zminimalizowanego okna.
SW_SHOWMINNOACTIVE Wyświetla okno zminimalizowane okno. Aktywne okno pozostaje aktywna.
SW_SHOWNA Wyświetla okno w bieżącym stanie. Aktywne okno pozostaje aktywna.
SW_SHOWNOACTIVATE Wyświetla okno w jego ostatnich rozmiar i położenie. Aktywne okno pozostaje aktywna.
SW_SHOWNORMAL Uaktywnia i wyświetla okno. Jeśli okno jest zminimalizowane lub zmaksymalizowane, systemu przywraca go do pierwotnego rozmiaru i położenia. Wniosek należy określić tę flagę, podczas wyświetlania okna po raz pierwszy.

Zwraca wartości

Jeśli okno był wcześniej widoczny, wartość zwracany jest różna od zera.

Jeśli okno zostało ukryte, wartość zwracany jest zero.

Uwagi

Aplikacja wywołuje ShowWindow, po raz pierwszy go użyć parametru nCmdShow funkcji WinMain jako jego parametru nCmdShow . Kolejne wywołania ShowWindow musi skorzystać z jednej z wartości w danej listy, zamiast określonego przez parametru nCmdShow funkcji WinMain.

Jak zaznaczono w dyskusji parametru nCmdShow , w pierwsze wywołanie ShowWindow jest ignorowana wartość nCmdShow , jeśli program, który został zwodowany stosowania określa informacji startowych zawartych w wartość struktury. W tym przypadku ShowWindow używa informacji określonych w strukturze wartość do pokazywania okna. Na kolejnych zaproszeń aplikacja musi wywołać ShowWindow z nCmdShow ustaw SW_SHOWDEFAULT na wykorzystywanie informacji startowych, dostarczonych przez program, który został zwodowany aplikacji. To zachowanie jest przeznaczona dla następujących sytuacjach

Systemu Windows CE: Parametru nCmdShow nie obsługuje następujące wartości

SW_MAXIMIZE

SW_MINIMIZE

SW_RESTORE

SW_SHOWDEFAULT

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie Windows, okno funkcji, funkcji CreateProcess, właściwości CreateWindow, ShowOwnedPopups, wartość, WinMain

Index