このセクションには、特定のコントロールだけでなく、複数のコントロールに適用されるプログラミング要素に関する参照情報が含まれています。 ほとんどのコントロールでサポートされている関数、マクロ、メッセージ、通知、および構造体があります。 たとえば、ほとんどのコントロールでは 、NM_HOVER 通知を使用してマウス クリックを処理します。
概要
| トピック | 内容 | 
|---|---|
| 共通コントロールについて | 共通コントロールは、Windows オペレーティング システムに含まれる DLL である共通コントロール ライブラリによって実装される一連のウィンドウです。 | 
| 共通コントロールに関する FAQ | この FAQ では、一般的なコントロールに関するいくつかの一般的な質問に対する回答を提供します。 | 
Functions
| トピック | 内容 | 
|---|---|
| DoReaderMode | ウィンドウでリーダー モードを有効にします。 | 
| DPA_Clone | 動的ポインター配列 (DPA) を複製します。 | 
| DPA_Create | DPA を作成します。 | 
| DPA_CreateEx | 指定したサイズとヒープの場所を使用して DPA を作成します。 | 
| DPA_DeleteAllPtrs | DPA からすべての項目を削除し、それに応じて DPA を縮小します。 | 
| DPA_DeletePtr | DPA から項目を削除します。 削除された項目に対応するために必要に応じて、DPA が縮小されます。 | 
| DPA_Destroy | 動的ポインター配列 (DPA) を解放します。 | 
| DPA_DestroyCallback | DPA の各要素で pfnCB を呼び出し、DPA を解放します。 | 
| DPA_EnumCallback | 動的ポインター配列 (DPA) を反復処理し、各項目で pfnCB を呼び出します。 | 
| DPA_GetPtr | DPA から項目を取得します。 | 
| DPA_GetPtrIndex | DPA で見つかった一致する項目のインデックスを取得します。 | 
| DPA_GetSize | DPA のサイズを取得します。 | 
| DPA_Grow | DPA 内のポインターの数を変更します。 | 
| DPA_InsertPtr | DPA 内の指定した位置に新しい項目を挿入します。 必要に応じて、DPA は新しい項目に対応するように拡張されます。 | 
| DPA_LoadStream | 指定したコールバック関数を呼び出して各要素を読み取ることによって、ストリームから DPA を読み込みます。 | 
| DPA_Merge | 2 つの DPA の内容を結合します。 | 
| DPA_SaveStream | ヘッダーを書き出し、指定されたコールバック関数を呼び出して各要素を書き込むことで、DPA をストリームに保存します。 | 
| DPA_Search | DPA 内の項目を検索します。 | 
| DPA_SetPtr | DPA 内の項目に値を割り当てます。 | 
| DPA_Sort | 動的ポインター配列 (DPA) 内の項目を並べ替えます。 | 
| DrawShadowText | 影付きのテキストを描画します。 | 
| DrawTextExPrivWrap | 指定した四角形に書式設定されたテキストを描画します。 この関数は DrawTextEx の呼び出しをラップします。 | 
| DrawTextWrap | 指定した四角形に書式設定されたテキストを描画します。 指定した方法 (タブの展開、文字の正当化、改行など) に従ってテキストの書式を設定します。 この関数は DrawText の呼び出しをラップします。 | 
| DSA_Clone | 動的構造体配列 (DSA) を複製します。 | 
| DSA_Create | DSA を作成します。 | 
| DSA_DeleteAllItems | DSA からすべての項目を削除します。 | 
| DSA_DeleteItem | DSA から項目を削除します。 | 
| DSA_Destroy | DSA を解放します。 | 
| DSA_DestroyCallback | DSA を反復処理し、各項目で指定されたコールバック関数を呼び出します。 配列の末尾に達すると、DSA は解放されます。 | 
| DSA_EnumCallback | DSA を反復処理し、各項目で pfnCB を呼び出します。 | 
| DSA_GetItem | DSA から要素を取得します。 | 
| DSA_GetItemPtr | DSA から要素へのポインターを取得します。 | 
| DSA_GetSize | DSA のサイズを取得します。 | 
| DSA_InsertItem | DSA に新しい項目を挿入します。 必要に応じて、DSA は新しい項目に対応するように拡張されます。 | 
| DSA_SetItem | DSA 内の要素の内容を設定します。 | 
| DSA_Sort | DSA 内の項目を並べ替えます。 | 
| ExtTextOutWrap | 現在選択されているフォント、背景色、およびテキストの色を使用してテキストを描画します。 必要に応じて、クリッピング、不透明度、またはその両方に使用する寸法を指定できます。 この関数は ExtTextOut の呼び出しをラップします。 | 
| GetEffectiveClientRect | 指定したすべてのコントロールを含むクライアント領域内の四角形の寸法を計算します。 | 
| GetMUILanguage | 特定のプロセスの共通コントロールによって現在使用されている言語を取得します。 | 
| GetTextExtentPoint32Wrap | 指定した文字列の幅と高さを計算します。 この関数は 、GetTextExtentPoint の呼び出しをラップします。 | 
| InitCommonControls | 特定の共通コントロール ウィンドウ クラスを登録して初期化します。 この関数は廃止されています。 新しいアプリケーションでは、 InitCommonControlsEx 関数を使用する 必要があります。 | 
| InitCommonControlsEx | 共通コントロール DLL から特定の共通コントロール クラスを登録します。 | 
| InitMUILanguage | アプリケーションで、システム言語とは異なる共通コントロールで使用する言語を指定できるようにします。 | 
| LoadIconMetric | クライアント指定のシステム メトリックを使用して、指定したアイコン リソースを読み込みます。 | 
| LoadIconWithScaleDown | アイコンを読み込みます。 アイコンが標準サイズでない場合、この関数は、小さい画像をスケールアップするのではなく、大きな画像をスケールダウンします。 | 
| MirrorIcon | 反転 (ミラー) アイコンは、ミラー化されたデバイス コンテキストで正しく表示されるようにします。 | 
| PFNDACOMPARE | DSA_Sortによって使用される比較関数のプロトタイプを定義 します。 | 
| PFNDACOMPARECONST | 比較対象の項目が定数オブジェクトである場合に DSA_Sort によって使用される比較関数のプロトタイプを定義します。 | 
| PFNDAENUMCALLBACK | DSA および DPA 関数で使用されるコールバック関数のプロトタイプを定義します。 | 
| PFNDAENUMCALLBACKCONST | 関係する項目が定数データへのポインターである場合に DSA および DPA 関数によって使用されるコールバック関数のプロトタイプを定義します。 | 
| PFNDPACOMPARE | DPA_SortおよびDPA_Searchで使用される比較関数のプロトタイプを定義します。 | 
| PFNDPACOMPARECONST | 比較対象の項目が定数オブジェクトである場合に DPA_Sort または DPA_Search によって使用される比較関数のプロトタイプを定義します。 | 
| PFNDPAENUMCALLBACK | DPA_EnumCallbackによって使用されるコールバック関数のプロトタイプを定義 します。 | 
| PFNDPAMERGE | DPA_Mergeによって使用されるマージ関数のプロトタイプを定義 します。 | 
| PFNDPAMERGECONST | 定数値を使用して、 DPA_Mergeによって使用されるマージ関数のプロトタイプを定義します。 | 
| PFNDPASTREAM | DPA_LoadStreamおよびDPA_SaveStreamによって使用されるコールバック関数のプロトタイプを定義します。 | 
| PFNDSAENUMCALLBACK | DSA_DestroyCallbackによって使用されるコールバック関数のプロトタイプを定義 します。 | 
| ReaderScroll | アクティブなスクロール領域として宣言されているリーダー モード ウィンドウの部分内でマウス ポインターを移動するときに使用される、アプリケーション定義のコールバック関数。 | 
| ShowHideMenuCtl | 指定したメニュー項目のチェック マーク属性を設定または削除し、対応するコントロールを表示または非表示にします。 この関数は、指定したメニュー項目がない場合にチェック マークを追加し、対応するコントロールを表示します。 メニュー項目に既にチェック マークがある場合、この関数はチェック マークを削除し、対応するコントロールを非表示にします。 | 
| Str_GetPtr | あるバッファーから別のバッファーに文字列をコピーします。 | 
| Str_SetPtrW | ppszCurrent を pszNew のコピーに設定し、必要に応じて前の値を解放します。 | 
| TranslateDispatch | DoReaderMode 関数のクライアントが、リーダー モード ウィンドウのスクロール領域を対象とするすべてのウィンドウ メッセージをインターセプトして明示的に処理するために使用されます。 これは、アプリケーション定義のコールバック関数です。 | 
Macros
| トピック | 内容 | 
|---|---|
| DPA_AppendPtr | DPA の末尾に新しい項目を挿入します。 | 
| DPA_FastDeleteLastPtr | DPA から最後のポインターを削除します。 | 
| DPA_FastGetPtr | DPA 内の指定したポインターの値を取得します。 | 
| DPA_GetPtrCount | DPA 内のポインターの数を取得します。 | 
| DPA_GetPtrPtr | DPA の内部ポインター配列へのポインターを取得します。 | 
| DPA_SetPtrCount | DPA 内のポインターの数を設定します。 | 
| DPA_SortedInsertPtr | 指定した既存の項目の前または後に新しい項目を挿入します。 | 
| DSA_AppendItem | DSA の末尾に新しい項目を追加します。 | 
| DSA_GetItemCount | DSA 内の項目の数を取得します。 | 
| FORWARD_WM_NOTIFY | WM_NOTIFY メッセージを送信または投稿します。 | 
| HANDLE_WM_NOTIFY | WM_NOTIFY メッセージを処理する関数 を 呼び出します。 | 
| INDEXTOSTATEIMAGEMASK | ツリー ビュー コントロールまたはリスト ビュー コントロールがインデックスを使用して項目の状態イメージを取得できるように、状態イメージのインデックスを準備します。 | 
Messages
| トピック | 内容 | 
|---|---|
| CCM_DPISCALE | Tree-View コントロール、List-View コントロール、ComboBoxEx コントロール、ヘッダー コントロール、ボタン、ツール バー コントロール、アニメーション コントロール、およびイメージ リストで、1 インチあたりの高ドット数 (dpi) の自動スケーリングを有効にします。 | 
| CCM_GETUNICODEFORMAT | コントロールの Unicode 文字形式フラグを取得します。 | 
| CCM_GETVERSION | 最新のCCM_SETVERSION メッセージによって設定されたコントロールのバージョン番号 を 取得します。 | 
| CCM_SETUNICODEFORMAT | コントロールの Unicode 文字書式フラグを設定します。 このメッセージを使用すると、コントロールを再作成する必要なく、実行時にコントロールで使用される文字セットを変更できます。 | 
| CCM_SETVERSION | このメッセージは、特定のバージョンに関連付けられている動作を期待していることをコントロールに通知するために使用されます。 | 
| CCM_SETWINDOWTHEME | コントロールの表示スタイルを設定します。 | 
| WM_NOTIFY | イベントが発生したとき、またはコントロールに何らかの情報が必要な場合に、共通コントロールによって親ウィンドウに送信されます。 | 
| WM_NOTIFYFORMAT | ウィンドウが 、WM_NOTIFY 通知メッセージで ANSI または Unicode の構造体を受け入れるかどうかを判断します。 
              
              WM_NOTIFYFORMAT メッセージは、共通コントロールから親ウィンドウに送信され、親ウィンドウから共通コントロールに送信されます。 | 
Notifications
| トピック | 内容 | 
|---|---|
| NM_CHAR | NM_CHAR通知コードは、文字キーが処理されるときにコントロールによって送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_CUSTOMDRAW | カスタム描画操作についてコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_CUSTOMTEXT | カスタム テキスト操作についてコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_FONTCHANGED | コントロールがフォントを変更したときに、リスト ビュー コントロールによって送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_GETCUSTOMSPLITRECT | 分割ボタンを構成する 2 つの四角形の測定値を取得するために、ボタン コントロールによって親に送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_HOVER | マウスが項目の上に置いたときにコントロールによって送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_KEYDOWN | コントロールにキーボード フォーカスがあり、ユーザーがキーを押したときに、コントロールによって送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_KILLFOCUS | コントロールの親ウィンドウに、コントロールが入力フォーカスを失っていることを通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_LDOWN | マウスの左ボタンが押されたことをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_NCHITTEST | コントロールが WM_NCHITTEST メッセージを受信したときに、鉄筋コントロールによって送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_OUTOFMEMORY | 使用可能なメモリが不足していたため、コントロールが操作を完了できなかったことをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_RDOWN | 現在サポートされていません。 | 
| NM_RELEASEDCAPTURE | コントロールがマウス キャプチャを解放していることをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_RETURN | コントロールの親ウィンドウに、コントロールに入力フォーカスがあり、ユーザーが Enter キーを押したことを通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_SETCURSOR | NM_SETCURSOR メッセージに 応答して、コントロールがカーソルを設定していることをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_SETFOCUS | コントロールが入力フォーカスを受け取っていることをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_THEMECHANGED | テーマが変更されたことをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_TOOLTIPSCREATED | コントロールがツールヒント コントロールを作成したことをコントロールの親ウィンドウに通知します。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
| NM_TVSTATEIMAGECHANGING | 状態イメージが変更されているツリー ビュー コントロールによって親ウィンドウに送信されます。 この通知コードは、 WM_NOTIFY メッセージの形式で送信されます。 | 
構造体
| トピック | 内容 | 
|---|---|
| COLORSCHEME | ツールバーまたは鉄筋のボタンの描画に関する情報が含まれます。 | 
| DPASTREAMINFO | PFNDPASTREAM コールバック関数によって使用されるストリーム項目を格納します。 | 
| INITCOMMONCONTROLSEX | ダイナミック リンク ライブラリ (DLL) から共通のコントロール クラスを読み込むのに使用される情報を格納します。 この構造体は InitCommonControlsEx 関数と共に使用されます。 | 
| NMCHAR | 文字通知メッセージで使用される情報が含まれます。 | 
| NMCUSTOMSPLITRECTINFO | 分割ボタンの 2 つの四角形に関する情報を格納します。 NM_GETCUSTOMSPLITRECT通知と共 に 送信されます。 | 
| NMCUSTOMTEXT | カスタム テキスト通知で使用される情報が含まれています。 | 
| NMHDR | 通知メッセージに関する情報を格納します。 | 
| NMKEY | キー通知メッセージで使用される情報が含まれます。 | 
| NMMOUSE | マウス通知メッセージで使用される情報が含まれます。 | 
| NMOBJECTNOTIFY | TBN_GETOBJECT、TCN_GETOBJECT、およびPSN_GETOBJECT通知コードで使用される情報が含まれます。 | 
| NMTOOLTIPSCREATED | NM_TOOLTIPSCREATED通知コードで使用される情報 が 含まれます。 | 
| READERMODEINFO | DoReaderMode 関数を初期化するために必要な情報が含まれています。 | 
Constants
| トピック | 内容 | 
|---|---|
| CDRF 定数 | これらの定数は、 NM_CUSTOMDRAW 通知コードに応答してコントロールによって戻り値として使用されます。 | 
| スタイル | このセクションでは、一般的なコントロール スタイルの一覧を示します。 記載されている場合を除き、これらのスタイルはヘッダー コントロール、ツール バー コントロール、およびステータス ウィンドウに適用されます。 | 
| ウィンドウ クラス | このセクションでは、共通コントロール ライブラリによって提供されるウィンドウ クラス名の一覧を示します。 |