共用方式為


WNDCLASSEXW 結構 (winuser.h)

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

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

語法

typedef struct tagWNDCLASSEXW {
  UINT      cbSize;
  UINT      style;
  WNDPROC   lpfnWndProc;
  int       cbClsExtra;
  int       cbWndExtra;
  HINSTANCE hInstance;
  HICON     hIcon;
  HCURSOR   hCursor;
  HBRUSH    hbrBackground;
  LPCWSTR   lpszMenuName;
  LPCWSTR   lpszClassName;
  HICON     hIconSm;
} WNDCLASSEXW, *PWNDCLASSEXW, *NPWNDCLASSEXW, *LPWNDCLASSEXW;

成員

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,它必須是先前呼叫 RegisterClassRegisterClassEx 函式所建立的類別 Atom。 atom 必須是 lpszClassName的低序字;高序字必須是零。

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

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

hIconSm

類型: HICON

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

備註

注意

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

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 winuser.h (包括 Windows.h)

另請參閱

概念

GetClassInfoEx

參考

RegisterClassEx

UnregisterClass

視窗類別