GetClassLong

Funkcja GetClassLong pobiera określonej wartości (długa) 32-bitowe ze struktury WNDCLASSEX związane z określonego okna.

(DWORD GetClassLong 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 wartość 32-bitowych, aby pobrać. Aby pobrać 32-bitowymi wartościami z pamięci klasy ekstra, należy określić przesunięcie bajtu pozytywne, 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 klasy ekstra, minus cztery; na przykład jeśli określono 12 lub więcej bajtów pamięci klasy ekstra, wartość 8 byłby indeks do trzeciego 32-bitową liczbą całkowitą. Aby pobierać inne wartości od struktury WNDCLASSEX , określić jedną z następujących wartości:
Wartość Działania
GCW_ATOM Pobiera wartość ATOM , która jednoznacznie identyfikuje klasy okna. Jest to ten sam atomu, że funkcja RegisterClassEx zwraca.
GCL_CBCLSEXTRA Pobiera rozmiar, w bajtach, dodatkowa pamięć, skojarzone z klasą.
GCL_CBWNDEXTRA Pobiera rozmiar, w bajtach, pamięci dodatkowe okna związane z każdego okna w klasie. Aby uzyskać informacje o tym, jak uzyskać dostęp do tej pamięci zobacz GetWindowLong.
GCL_HBRBACKGROUND Pobiera uchwyt pędzla tła, skojarzone z klasą.
GCL_HCURSOR Pobiera uchwyt kursor skojarzone z klasą.
GCL_HICON Pobiera uchwyt ikony skojarzonej z klasą.
GCL_HICONSM Pobiera uchwyt mała ikona skojarzone z klasą.
GCL_HMODULE Pobiera dojścia modułu, który zarejestrował klasy.
GCL_MENUNAME Pobiera adres ciąg nazwy menu. Ciąg identyfikuje zasób menu skojarzone z klasą.
GCL_STYLE Pobiera bitów styl klasy okna.
GCL_WNDPROC Pobiera adres procedury okna skojarzone z klasą.

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 klasy ekstra określając wartość różną od zera w członek cbClsExtra struktury WNDCLASSEX używane w funkcji RegisterClassEx.

Systemu Windows CE: Parametr nIndex jest bajt przesunięcie, ale musi być wielokrotnością liczby 4 bajty. Windows CE nie obsługuje odwołań do niewyrównanych dostępu.

Tylko wartości obsługiwane dla parametru nIndex są GCL_HICON i GCL_STYLE.

Jeśli używasz składnika Windows CE Iconcurs, który obsługuje kursory myszy na platformach docelowych właściwe, można także używać wartości GCL_HCURSOR w parametrze nIndex.

Uwaga Wersje systemu Windows CE, obsługujących kursory myszy zawierają składniki Iconcurs i Mcursor, zamiast ikony i kursor składniki.

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, GetWindowLong, RegisterClassEx, SetClassLong, WNDCLASSEX

Index