GetWindowLong

Funkcja GetWindowLong pobiera informacje dotyczące określonego okna. Funkcja również pobiera wartość (długa) 32-bitowych na określone przesunięcie do pamięci dodatkowe okna okna.

(GetWindowLong) LONG HWND  hWnd, / / uchwyt oknaintnIndex / / przesunięcia wartości do pobrania);
 

Parametry

hWnd

Dojście do okna i, pośrednio, klasę, do której należy okna.

nIndex

Określa odległość od zera wartość, która ma być pobrana. Prawidłowymi wartościami są wartości z zakresu od zera poprzez liczba bajtów pamięci dodatkowe okna, minus cztery; na przykład jeśli określono 12 lub więcej bajtów dodatkowa pamięć, wartość 8 byłby indeks do trzeciego 32-bitową liczbą całkowitą. Aby pobrać każda inna wartość, określ jedną z następujących wartości:

Wartość	Działania
GWL_EXSTYLE	Pobiera style okien rozszerzony.
GWL_STYLE	Pobiera style okien.
GWL_WNDPROC	Pobiera adres procedury okna lub uchwyt, reprezentująca adres procedury okna. Należy użyć funkcji CallWindowProc aby wywołać procedurę okna.
GWL_HINSTANCE	Pobiera uchwyt wystąpienia aplikacji.
GWL_HWNDPARENT	Pobiera uchwyt okna nadrzędnego, ewentualne.
GWL_ID	Pobiera identyfikator okna.
GWL_USERDATA	Pobiera wartość 32-bitowe, skojarzoną z okna. Każde okno ma odpowiednią wartość 32-bitowe, przeznaczone do wykorzystania przez aplikację, która utworzyła okna.

Następujące wartości są również dostępne, gdy parametr hWnd identyfikuje okno dialogowe:

Wartość	Działania
DWL_DLGPROC	Pobiera adres procedury pole dialogowe lub uchwyt, reprezentująca adres procedury pole dialogowe. Należy użyć funkcji CallWindowProc do wywoływania procedur pole dialogowe.
DWL_MSGRESULT	Pobiera wartość zwrócona przez wiadomość przetwarzane w procedurze pole dialogowe.
DWL_USER	Pobiera dodatkowych informacji prywatnych aplikacji, takich jak uchwyty lub wskaźniki.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest żądanej wartości 32-bitowy.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Rezerwa pamięci dodatkowe okna określając wartość różną od zera w członek cbWndExtra struktury WNDCLASSEX używane w funkcji RegisterClassEx.

Systemu Windows CE: Parametr nIndex musi być wielokrotnością liczby 4 bajty. Odwołań do niewyrównanych dostępu nie jest obsługiwane.

Windows CE nie obsługuje wartości GWL_HINSTANCE i GWL_HWNDPARENT w parametrze nIndex.

Windows CE 1.0 nie obsługuje również wartości DWL_DLGPROC i GWL_USERDATA w parametrze nIndex.

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:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Okno klasy omówienie, funkcje klasy okno, CallWindowProc, RegisterClassEx, SetParent, SetWindowLong, WNDCLASS

Index