WNDCLASSA 結構（winuser.h）

發行項
11/20/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 訊息，或測試 PAINTSTRUCT 結構成員的 fErase 結構，由 beginPaint 函式所填入。

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）