WNDCLASSA 結構 (winuser.h)

發行項
03/09/2024

包含 RegisterClass 函式所註冊的視窗類別屬性。

此結構已由與 RegisterClassEx 函式搭配使用的 WNDCLASSEX 結構取代。如果您不需要設定與視窗類別相關聯的小型圖示，您仍然可以使用 WNDCLASS 和 RegisterClass 。

語法

typedef struct tagWNDCLASSA {
  UINT      style;
  WNDPROC   lpfnWndProc;
  int       cbClsExtra;
  int       cbWndExtra;
  HINSTANCE hInstance;
  HICON     hIcon;
  HCURSOR   hCursor;
  HBRUSH    hbrBackground;
  LPCSTR    lpszMenuName;
  LPCSTR    lpszClassName;
} WNDCLASSA, *PWNDCLASSA, *NPWNDCLASSA, *LPWNDCLASSA;

成員

style

類型： UINT

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

lpfnWndProc

類型： WNDPROC

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

cbClsExtra

類型： int

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

cbWndExtra

類型： int

在窗口實例之後配置的額外位元組數目。系統會將位元組初始化為零。如果應用程式使用 WNDCLASS 來註冊使用資源檔中 的 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

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

lpszClassName

類型： LPCTSTR

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

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

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

備註

注意

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

規格需求

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