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

クラスのスタイル。このメンバーは、クラススタイルの任意の組み合わせにすることができます。

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 で終わる文字列へのポインター、またはアトムです。このパラメーターがアトムの場合は、RegisterClass または RegisterClassEx 関数以前の呼び出しによって作成されたクラスアトムである必要があります。 atom は、lpszClassNameの下位ワードに含まれている必要があります。高次ワードはゼロでなければなりません。

lpszClassName が文字列の場合は、ウィンドウクラス名を指定します。クラス名には、RegisterClass または RegisterClassEx登録されている任意の名前、または定義済みのコントロールクラス名のいずれかを指定できます。

lpszClassName の最大長は 256 です。 lpszClassName が最大長を超える場合、RegisterClass 関数は失敗します。

備考

手記

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNDCLASS を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	winuser.h (Windows.h を含む)

次の方法で共有

WNDCLASSA 構造体 (winuser.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース