WinAPI

ShowWindow

  • 2010-10-31 18:27
  • 0 komentarzy
  • 1541 odsłon
  • Oceń ten tekst jako pierwszy
// C
BOOL ShowWindow(
    HWND hWnd,
    int nCmdShow
);

// Delphi
function ShowWindow(hWnd : HWND; nCmdShow : integer): boolean; stdcall;


Funkcja ShowWindow ustawia status okna.

Parametry:
hWnd
Uchwyt okna na którym ma być przeprowadzona operacja.

nCmdShow
Definiuje w jaki sposób okno ma być pokazywane. Parametr ten jest ignorowany przy pierwszym wywołaniu tej funkcji jeśli program, który uruchomił aplikację, ustawił dla niej strukturę STARTUPINFO. W przeciwnym wypadku w pierwszym wywołaniu funkcji ShowWindow wartość nCmdShow powinna zostać pobrana z parametru nCmdShow funkcji WinMain.
W dalszych wywołaniach wartość parametru nCmdShow może przyjąć jedną z następujących wartości:
  • SW_FORCEMINIMIZE: Windows 2000/XP: Minimalizuje okno, nawet jeśli wątek odpowiedzialny za obsługę kolejki komunikatów okna nie odpowiada. Ta flaga powinna być używana przy minimalizacji okien obsługiwanych przez inne wątki.
  • SW_HIDE: Ukrywa okno i aktywuje inne.
  • SW_MAXIMIZE: Maksymalizuje podane okno.
  • SW_MINIMIZE Minimalizuje podane okno i aktywuje inne (kolejne względem osi Z).
  • SW_RESTORE: Aktywuje i pokazuje okno. Jeśli okno jest zminimalizowane lub zmaksymailzowane, system przywraca jego oryginalne rozmiary i położenie.
  • SW_SHOW: Aktywuje i pokazuje okno w jego bieżącym rozmiarze i położeniu.
  • SW_SHOWDEFAULT: Ustawia tryb pokazywania okna na tryb podany w strukturze STARTUPINFO. Struktura ta zostaje podana funkcji CreateProcess przez program, który uruchomił bieżącą aplikację.
  • SW_SHOWMAXIMIZED: Aktywuje i maksymalizuje okno.
  • SW_SHOWMINIMIZED: Aktywuje i minimalizuje okno.
  • SW_SHOWMINNOACTIVE: Minimalizuje okno tak jak SW_SHOWMINIMIZED, jednak bez aktywowania okna.
  • SW_SHOWNA: Pokazuje okno w jego bieżącym rozmiarze i położeniu tak jak SW_SHOW, jednak bez aktywowania okna.
  • SW_SHOWNOACTIVATE: Pokazuje okno w jego oryginalnym rozmiarze i położeniu tak jak SW_SHOWNORMAL, jednak bez aktywacji okna.
  • SW_SHOWNORMAL: Aktywuje i pokazuje okno w jego oryginalnym rozmiarze i położeniu. Flaga ta powinna być ustawiona przy pierwszym pokazaniu okna.

Zwracana wartość
Jeśli okno przed wywołaniem funkcji było widoczne, zwracana jest niezerowa wartość (true), w przeciwnym wypadku zwrócone zostaje zero (false).


Zobacz też: