GetWindowLong

Aby napisać kod kompatybilny z 32-bitową oraz 64-bitową wersją systemu Windows, użyj funkcji GetWindowLongPtr.

Składnia

Argumenty

Argument	Opis
hWnd	Uchwyt do okna.
nIndex	Wartość przesunięcia (liczona od zera) do ustawienia. Prawidłowe wartości znajdują się w zakresie od zera do liczby dodatkowych bajtów pamięci dla okna pomniejszonej o rozmiar liczby całkowitej. Wartość tego argumentu może być również jedną z poniższych stałych: Nazwa Wartość Znaczenie GWL_EXSTYLE -20 Pobiera rozszerzony styl okna. GWL_HINSTANCE -6 Pobiera uchwyt do instancji programu. GWL_HWNDPARENT -8 Pobiera uchwyt do okna rodzica (jeśli dane okno ma rodzica). GWL_ID -12 Pobiera identyfikator okna potomnego. GWL_STYLE -16 Pobiera style okna. GWL_USERDATA -21 Pobiera dane użytkownika powiązane z oknem. Takie dane są przeznaczone do użycia przez program, który utworzył okno. Na początku ta wartość jest zerem. GWL_WNDPROC -4 Pobiera adres procedury okna.  Poniższe wartości są również dostępne, gdy argument hWnd określa okno dialogowe: Nazwa Wartość Znaczenie DWL_DLGPROC DWLP_MSGRESULT + sizeof( LRESULT ) Pobiera adres procedury obsługi dialogu. DWL_MSGRESULT 0 Pobiera zwracaną wartość komunikatu przetwarzanego w procedurze okna dialogowego. DWL_USER DWLP_DLGPROC + sizeof( DLGPROC ) Pobiera dodatkowe informacje, takie jak uchwyty lub wskaźniki.

Zwracana wartość

Jeśli funkcja zakończy się prawidłowo, zwracana wartość zawiera żądane informacje o oknie. Jeśli wystąpią błędy, zwracaną wartością jest zero. Aby uzyskać rozszerzone informacje o błędach, wywołaj funkcję _{» WinAPI ♦} GetLastError. Jeśli funkcja _{» WinAPI ♦} SetWindowLong nie została wcześniej wywołana w celu ustawienia danego atrybutu okna, ta funkcja zwróci zero w przypadku pobierania wartości dodatkowej pamięci dla okna lub klasy.

Dodatkowe informacje

Do wywołania procedury obsługi okna pobranej przez tą funkcję należy użyć funkcji _{» WinAPI ♦} CallWindowProc. Zarezerwowana dodatkowa pamięć dla okna przez określenie niezerowej wartości składowej cbWndExtra struktury _{» WinAPI ♦} WNDCLASSEX jest używana z funkcją _{» WinAPI ♦} RegisterClassEx.

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Winuser.h (dołącza Windows.h)
Biblioteka	User32.lib
DLL	User32.dll
UNICODE	GetWindowLongW
ANSI	GetWindowLongA

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/ms633584(vs.85).aspx