共用方式為


WNDCLASSEXA 結構 (winuser.h)

包含窗口類別資訊。 它與 RegisterClassExGetClassInfoEx 函式搭配使用。

WNDCLASSEX 結構類似於 WNDCLASS 結構。 有兩個差異。 WNDCLASSEX 包含 cbSize 成員,指定結構的大小,以及 hIconSm 成員,其中包含與視窗類別相關聯之小型圖示的句柄。

語法

typedef struct tagWNDCLASSEXA {
  UINT      cbSize;
  UINT      style;
  WNDPROC   lpfnWndProc;
  int       cbClsExtra;
  int       cbWndExtra;
  HINSTANCE hInstance;
  HICON     hIcon;
  HCURSOR   hCursor;
  HBRUSH    hbrBackground;
  LPCSTR    lpszMenuName;
  LPCSTR    lpszClassName;
  HICON     hIconSm;
} WNDCLASSEXA, *PWNDCLASSEXA, *NPWNDCLASSEXA, *LPWNDCLASSEXA;

成員

cbSize

類型: UINT

這個 結構的大小,以位元組為單位。 將此成員設定為 sizeof(WNDCLASSEX)。 在呼叫 GetClassInfoEx 函 式之前,請務必設定此成員。

style

類型: UINT

類別樣式 (s) 。 這個成員可以是 類別樣式的任何組合。

lpfnWndProc

類型: WNDPROC

視窗程式的指標。 您必須使用 CallWindowProc 函 式來呼叫視窗程式。 如需詳細資訊,請參閱 WindowProc

cbClsExtra

類型: int

在視窗類別結構之後配置的額外位元組數目。 系統會將位元組初始化為零。

cbWndExtra

類型: int

在窗口實例之後配置的額外位元組數目。 系統會將位元組初始化為零。 如果應用程式使用 WNDCLASSEX 來註冊使用資源檔中 的 CLASS 指示詞所建立的對話方塊,則必須將此成員設定為 DLGWINDOWEXTRA

hInstance

類型: HINSTANCE

實例的句柄,其中包含 類別的窗口程式。

hIcon

類型: HICON

類別圖示的句柄。 此成員必須是圖示資源的句柄。 如果此成員為 NULL,系統會提供預設圖示。

hCursor

類型: HCURSOR

類別數據指標的句柄。 這個成員必須是數據指標資源的句柄。 如果這個成員是 NULL,每當滑鼠移至應用程式的視窗時,應用程式必須明確設定游標圖形。

hbrBackground

類型: HBRUSH

類別背景筆刷的句柄。 這個成員可以是筆刷的句柄,用來繪製背景,也可以是色彩值。 色彩值必須是下列其中一種標準系統色彩, (值 1 必須新增至所選的色彩) 。 如果指定色彩值,您必須將它轉換成下列其中一個 HBRUSH 類型:

  • COLOR_ACTIVEBORDER
  • COLOR_ACTIVECAPTION
  • COLOR_APPWORKSPACE
  • COLOR_BACKGROUND
  • COLOR_BTNFACE
  • COLOR_BTNSHADOW
  • COLOR_BTNTEXT
  • COLOR_CAPTIONTEXT
  • COLOR_GRAYTEXT
  • COLOR_HIGHLIGHT
  • COLOR_HIGHLIGHTTEXT
  • COLOR_INACTIVEBORDER
  • COLOR_INACTIVECAPTION
  • COLOR_MENU
  • COLOR_MENUTEXT
  • COLOR_SCROLLBAR
  • COLOR_WINDOW
  • COLOR_WINDOWFRAME
  • COLOR_WINDOWTEXT
當類別使用 UnregisterClass 取消註冊時,系統會自動刪除類別背景筆刷。 應用程式不應該刪除這些筆刷。

當此成員為 NULL 時,每當應用程式要求在工作區中繪製時,都必須繪製自己的背景。 若要判斷是否必須繪製背景,應用程式可以處理WM_ERASEBKGND訊息,或測試 BeginPaint 函式所填入 PAINTSTRUCT 結構的 fErase 成員。

lpszMenuName

類型: LPCTSTR

Null 終止字元字串的指標,指定類別功能表的資源名稱,因為名稱會出現在資源檔中。 如果您使用整數來識別功能表,請使用 MAKEINTRESOURCE 宏。 如果這個成員是 NULL,屬於此類別的視窗沒有預設功能表。

lpszClassName

類型: LPCTSTR

以 Null 終止的字串或為 Atom 的指標。 如果此參數是 Atom,它必須是先前呼叫 RegisterClass 或 RegisterClassEx 式所建立的類別 Atom。 Atom 必須以低順序的 lpszClassName 字組表示;高序字必須是零。

如果 lpszClassName 是字串,則會指定視窗類別名稱。 類別名稱可以是向 RegisterClass 或 RegisterClassEx 註冊的任何名稱,或是任何預先定義的控件類別名稱。

lpszClassName 的最大長度為 256。 如果 lpszClassName 大於最大長度, RegisterClassEx 函 式將會失敗。

hIconSm

類型: HICON

與窗口類別相關聯的小型圖示句柄。 如果此成員為 NULL,系統會搜尋 hIcon 成員所指定的圖示資源,以取得適當大小的圖示,以作為小型圖示。

備註

注意

winuser.h 標頭會將 WNDCLASSEX 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 winuser.h (包含 Windows.h)

另請參閱

概念

GetClassInfoEx

參考

RegisterClassEx

UnregisterClass

窗口類別