DRAWITEMSTRUCT 構造体

[アーティクル]
02/21/2013

DRAWITEMSTRUCT の構造はオーナー描画コントロールまたはメニュー項目を塗りつぶす方法をオーナーウィンドウを特定するために必要な情報を提供します。

typedef struct tagDRAWITEMSTRUCT {
   UINT CtlType;
   UINT CtlID;
   UINT itemID;
   UINT itemAction;
   UINT itemState;
   HWND hwndItem;
   HDC hDC;
   RECT rcItem;
   DWORD itemData;
} DRAWITEMSTRUCT;

パラメーター

CtlType
コントロール型。コントロール型の値は次のとおりです。:
- ODT_BUTTON によって、オーナー描画ボタン
- ODT_COMBOBOX によって、オーナー描画コンボボックス
- ODT_LISTBOX によって、オーナー描画リストボックス
- ODT_MENU によって、オーナー描画メニュー
- ODT_LISTVIEW のリストビューコントロール
- ODT_STATIC によって、オーナー描画静的コントロール
- ODT_TAB のタブコントロール
CtlID
コンボボックス、リストボックス、ボタンのコントロール ID。このメンバーは、メニューでは使用されません。
itemID
リストボックスやコンボボックスの項目のメニューまたはインデックスのメニュー項目 ID。空のリストボックスやコンボボックスに、このメンバーは、コントロールに項目がない場合でも、アプリケーションが rcItem のメンバーで指定された座標でフォーカス四角形を描画するようにする負の値です。ユーザーはリストボックスやコンボボックスが入力フォーカスがあるかどうか、そのことを示すことができます。itemAction のメンバーのビットの設定はリストボックスやコンボボックスが入力フォーカスを持つように四角形を描画するかどうかを指定します。
itemAction
必要な描画操作を定義します。これは、次のビットの一つ以上です:
- ODA_DRAWENTIRE は、このビットと描画コントロール全体が設定されます。
- ODA_FOCUS は、このビットコントロールが入力フォーカスを取得するか失ったときに設定されます。itemState のメンバーは、コントロールにフォーカスがあるかどうかを調べる必要もあります。
- ODA_SELECT は、このビット選択状態が変更されたときに設定されます。itemState のメンバーは、新しい選択状態を決定するためにチェックする必要があります。
itemState
現在の描画のアクションが実行された後に項目の表示状態を指定します。つまり、メニュー項目が淡色表示する場合 ODS_GRAYED 状態フラグが設定されます。状態フラグは次のとおりです。:
- ODS_CHECKED は、このビットメニュー項目がチェックする場合はに設定されます。このビットは、メニューにのみ使用されます。
- ODS_DISABLED は、このビット項目が無効として描画する場合はに設定されます。
- ODS_FOCUS は、このビット項目に入力フォーカスがある場合に設定されます。
- ODS_GRAYED は、このビット項目が淡色表示する場合はに設定されます。このビットは、メニューにのみ使用されます。
- ODS_SELECTED は、このビット項目の状態をオンに設定されます。
- ODS_COMBOBOXEDIT は ownerdrawn のコンボボックスの選択項目フィールド（エディットコントロール）で描画されます。
- ODS_DEFAULT 項目は、既定の項目です。
hwndItem
コンボボックス、リストボックス、ボタンにコントロールのウィンドウハンドルを指定します。メニューの項目を含むメニュー（HMENU）のハンドルを指定します。
hDC
デバイスコンテキストを識別します。このデバイスコンテキストは、コントロールの描画操作を実行するときに使用する必要があります。
rcItem
描画するコントロールの境界を定義する hDC のメンバーで指定されたデバイスコンテキストの四角形。ウィンドウが自動的に何もコンボボックス、リストボックス、ボタンのデバイスコンテキストのオーナー描画されますが、メニュー項目をクリップされます。メニュー項目を描画するとき、所有者は rcItem のメンバーを定義する四角形の境界の外側に描画する必要があります。
itemData
コンボボックスやリストボックスに、このメンバーは、次のいずれかをリストボックスに渡された値が含まれています:
メニューの場合は、このメンバーは、次のいずれかのメニューに渡された値が含まれています:

解説

オーナー描画コントロールまたはメニュー項目のオーナーウィンドウは WM_DRAWITEM のメッセージの lParam パラメーターとしてこの構造体へのポインターを受け取ります。

Share via

DRAWITEMSTRUCT 構造体

パラメーター

解説

必要条件

参照

関連項目

その他の技術情報

その他のリソース