コンボ ボックス (Windows コントロール)

ここでは、コンボ ボックスで使用されるプログラミング要素について説明します。 コンボ ボックスは、COMBOBOX クラスによって定義される独自の種類のコントロールであり、リスト ボックスと編集コントロールの機能の多くが組み合わされています。

概要

トピック	内容
コンボ ボックスについて	このセクションでは、さまざまな種類のコンボ ボックスについて説明します。
コンボ ボックスの機能	このドキュメントでは、コンボ ボックスの機能について説明します。
コンボ ボックスの使用	このセクションのコード例では、コンボ ボックスに関連付けられているタスクを実行する方法を示します。

関数

トピック	内容
DlgDirListComboBox	コンボ ボックスの内容を、指定されたディレクトリ内のサブディレクトリとファイルの名前に置き換えます。 ファイル属性のセットを指定することで、名前のリストをフィルター処理できます。 名前のリストには、マップされたドライブ文字を含めることができます。
DlgDirSelectComboBoxEx	DlgDirListComboBox 関数を使用して、入力されたコンボ ボックスから現在の選択を取得します。 選択は、ドライブ文字、ファイル、またはディレクトリ名として解釈されます。
GetComboBoxInfo	指定されたコンボ ボックスの情報を取得します。

マクロ

トピック	内容
ComboBox_AddItemData	コンボ ボックス内にあるリストの指定された位置に、項目データを追加します。 このマクロを使用するか、CB_ADDSTRING メッセージを明示的に送信します。
ComboBox_AddString	コンボ ボックス内にあるリストに文字列を追加します。 コンボ ボックスに CBS_SORT スタイルが設定されていない場合、文字列はリストの末尾に追加されます。 そうでない場合は、文字列がリストに挿入されてから、リストが並べ替えられます。 このマクロを使用するか、CB_ADDSTRING メッセージを明示的に送信します。
ComboBox_DeleteString	コンボ ボックス内にあるリストから、指定された位置にあるアイテムを削除します。 このマクロを使用するか、CB_DELETESTRING メッセージを明示的に送信します。
ComboBox_Dir	コンボ ボックスによって表示されるリストに名前を追加します。 このマクロは、指定された文字列およびファイル属性のセットに一致する、ディレクトリとファイルの名前を追加します。 また、マップされたドライブ文字を、コンボ ボックス内にあるリストに追加することもできます。 このマクロを使用するか、CB_DIR メッセージを明示的に送信します。
ComboBox_Enable	コンボ ボックス コントロールを有効または無効にします。
ComboBox_FindItemData	コンボ ボックス リスト内で、指定された項目データを含む最初の項目を検索します。 このマクロを使用するか、CB_FINDSTRING メッセージを明示的に送信します。
ComboBox_FindString	コンボ ボックス リスト内で、指定した文字列で始まる最初の文字列を検索します。 このマクロを使用するか、CB_FINDSTRING メッセージを明示的に送信します。
ComboBox_FindStringExact	コンボ ボックス リスト内で、指定された文字列と完全に一致する最初の文字列を検索します。ただし、この検索では大文字と小文字が区別されません。 このマクロを使用するか、CB_FINDSTRINGEXACT メッセージを明示的に送信します。
ComboBox_GetCount	コンボ ボックス内のリスト ボックスに含まれる項目の数を取得します。 このマクロを使用するか、CB_GETCOUNT メッセージを明示的に送信します。
ComboBox_GetCueBannerText	コンボ ボックスの編集コントロールに表示されるキュー バナー テキストを取得します。 このマクロを使用するか、 CB_GETCUEBANNER メッセージを明示的に送信します。
ComboBox_GetCurSel	コンボ ボックスで現在選択されている項目のインデックスを取得します。 このマクロを使用するか、CB_GETCURSEL メッセージを明示的に送信します。
ComboBox_GetDroppedControlRect	コンボ ボックスがドロップダウン状態であるときの画面座標を取得します。 このマクロを使用するか、CB_GETDROPPEDCONTROLRECT メッセージを明示的に送信します。
ComboBox_GetDroppedState	コンボ ボックス コントロールのドロップ リストが表示されているかどうかを確認します。 このマクロを使用するか、CB_GETDROPPEDSTATE メッセージを明示的に送信します。
ComboBox_GetExtendedUI	コンボ ボックスで、既定のユーザー インターフェイス (UI) を使用しているのか、または拡張 UI を使用しているのかを確認します。 このマクロを使用するか、CB_GETEXTENDEDUI メッセージを明示的に送信します。
ComboBox_GetItemData	コンボ ボックス内の指定されたリスト アイテムに関連付けられているアプリケーション定義の値を取得します。 このマクロを使用するか、CB_GETITEMDATA メッセージを明示的に送信します。
ComboBox_GetItemHeight	コンボ ボックス内にあるリスト アイテムの高さを取得します。 このマクロを使用するか、CB_GETITEMHEIGHT メッセージを明示的に送信します。
ComboBox_GetLBText	コンボ ボックス内にあるリストから文字列を取得します。 このマクロを使用するか、CB_GETLBTEXT メッセージを明示的に送信します。
ComboBox_GetLBTextLen	コンボ ボックス内にあるリスト内の文字列の長さを取得します。 このマクロを使用するか、CB_GETLBTEXTLEN メッセージを明示的に送信します。
ComboBox_GetMinVisible	コンボ ボックスのドロップダウン リスト内に表示されている項目の最小数を取得します。
ComboBox_GetText	コンボ ボックス コントロールからテキストを取得します。
ComboBox_GetTextLength	コンボ ボックスのテキストに含まれる文字数を取得します。
ComboBox_InsertItemData	コンボ ボックス内にあるリストの指定された位置に項目データを挿入します。 このマクロを使用するか、CB_INSERTSTRING メッセージを明示的に送信します。
ComboBox_InsertString	コンボ ボックス内にあるリストの指定された位置に文字列を追加します。 このマクロを使用するか、CB_INSERTSTRING メッセージを明示的に送信します。
ComboBox_LimitText	コンボ ボックスの編集コントロールにユーザーが入力できるテキストの長さを制限します。 このマクロを使用するか、CB_LIMITTEXT メッセージを明示的に送信します。
ComboBox_ResetContent	コンボ ボックスのリスト ボックスと編集コントロールからすべての項目を削除します。 このマクロを使用するか、CB_RESETCONTENT メッセージを明示的に送信します。
ComboBox_SelectItemData	コンボ ボックス内のリストで、指定された項目データを含む項目を検索します。 一致する項目が見つかった場合は、その項目が選択されます。 このマクロを使用するか、CB_SELECTSTRING メッセージを明示的に送信します。
ComboBox_SelectString	コンボ ボックス内のリストで、指定された文字列に含まれる文字で始まる項目を検索します。 一致する項目が見つかった場合は、その項目が選択されます。 このマクロを使用するか、CB_SELECTSTRING メッセージを明示的に送信します。
ComboBox_SetCueBannerText	コンボ ボックスの編集コントロールに表示されるキュー バナー テキストを設定します。
ComboBox_SetCurSel	コンボ ボックスで現在選択されている項目を設定します。 このマクロを使用するか、CB_SETCURSEL メッセージを明示的に送信します。
ComboBox_SetExtendedUI	CBS_DROPDOWN スタイルまたは CBS_DROPDOWNLIST スタイルが設定されているコンボ ボックスに対して、既定のユーザー インターフェイスまたは拡張 UI を選択します。 このマクロを使用するか、CB_SETEXTENDEDUI メッセージを明示的に送信します。
ComboBox_SetItemData	コンボ ボックス内の指定されたリスト アイテムに関連付けられているアプリケーション定義の値を設定します。 このマクロを使用するか、CB_SETITEMDATA メッセージを明示的に送信します。
ComboBox_SetItemHeight	コンボ ボックス内のリスト アイテムまたは選択フィールドの高さを設定します。 このマクロを使用するか、CB_SETITEMHEIGHT メッセージを明示的に送信します。
ComboBox_SetMinVisible	コンボ ボックスのドロップダウン リスト内に表示されている項目の最小数を設定します。
ComboBox_SetText	コンボ ボックスのテキストを設定します。
ComboBox_ShowDropdown	コンボ ボックス内にあるリストを表示または非表示にします。 このマクロを使用するか、CB_SHOWDROPDOWN メッセージを明示的に送信します。

[メッセージ]

トピック	内容
CB_ADDSTRING	コンボ ボックスのリスト ボックスに文字列を追加します。 コンボ ボックスに CBS_SORT スタイルが設定されていない場合、文字列はリストの末尾に追加されます。 そうでない場合は、文字列がリストに挿入されてから、リストが並べ替えられます。
CB_DELETESTRING	コンボ ボックスのリスト ボックスから文字列を挿入します。
CB_DIR	コンボ ボックスによって表示されるリストに名前を追加します。 このメッセージは、指定された文字列およびファイル属性のセットに一致する、ディレクトリとファイルの名前を追加します。 CB_DIR では、マップされたドライブ文字をリストに追加することもできます。
CB_FINDSTRING	コンボ ボックスのリスト ボックスで、指定された文字列に含まれる文字で始まる項目を検索します。
CB_FINDSTRINGEXACT	コンボ ボックス内の最初のリスト ボックス文字列で、lParam パラメーターで指定された文字列と一致するものを検索します。
CB_GETCOMBOBOXINFO	指定されたコンボ ボックスの情報を取得します。
CB_GETCOUNT	コンボ ボックス内のリスト ボックスに含まれる項目の数を取得します。
CB_GETCUEBANNER	コンボ ボックスの編集コントロールに表示されるキュー バナー テキストを取得します。 このメッセージを明示的に送信するか、ComboBox_GetCueBannerText マクロを使用します。
CB_GETCURSEL	アプリケーションが CB_GETCURSEL メッセージを送信して、コンボ ボックスのリスト ボックスで現在選択されている項目があれば、その項目のインデックスを取得します。
CB_GETDROPPEDCONTROLRECT	アプリケーションが CB_GETDROPPEDCONTROLRECT メッセージを送信して、ドロップダウン状態のコンボ ボックスの画面座標を取得します。
CB_GETDROPPEDSTATE	コンボ ボックスのリスト ボックスがドロップダウン状態であるかどうかを判別します。
CB_GETDROPPEDWIDTH	CBS_DROPDOWN スタイルまたは CBS_DROPDOWNLIST スタイルが設定されたコンボ ボックスのリスト ボックスについて、最小許容幅 (ピクセル単位) を取得します。
CB_GETEDITSEL	コンボ ボックスのエディット コントロール内の現在の選択範囲の先頭と最後の文字の位置を取得します。
CB_GETEXTENDEDUI	コンボ ボックスで既定のユーザー インターフェイスを使用しているのか、または拡張ユーザー インターフェイスを使用しているのかを判別します。
CB_GETHORIZONTALEXTENT	リスト ボックスを水平方向にスクロールできる幅 (スクロール可能な幅) をピクセル単位で取得します。 これは、リスト ボックスに水平スクロール バーがある場合にのみ該当します。
CB_GETITEMDATA	アプリケーションがコンボ ボックスに CB_GETITEMDATA メッセージを送信して、コンボ ボックス内の指定された項目に関連付けられている、アプリケーションによって入力される値を取得します。
CB_GETITEMHEIGHT	コンボ ボックス内のリスト アイテムまたは選択フィールドの高さを判別します。
CB_GETLBTEXT	コンボ ボックスのリストから文字列を取得します。
CB_GETLBTEXTLEN	コンボ ボックスのリスト内にある文字列の長さ (文字数) を取得します。
CB_GETLOCALE	コンボ ボックスの現在のロケールを取得します。 ロケールは、CBS_SORT スタイルのコンボ ボックスの表示テキストと、CB_ADDSTRING メッセージを使用して追加されたテキストの正しい並べ替え順序を決定するのに使用されます。
CB_GETMINVISIBLE	コンボ ボックスのドロップダウン リスト内に表示されている項目の最小数を取得します。
CB_GETTOPINDEX	アプリケーションが CB_GETTOPINDEX メッセージを送信して、コンボ ボックスのリスト ボックス部分に最初に表示される項目の、ゼロから始まるインデックスを取得します。 最初は、インデックスが 0 の項目はリスト ボックスの一番上にありますが、リスト ボックスの内容がスクロールされている場合は、別の項目が一番上にある可能性があります。
CB_INITSTORAGE	コンボ ボックスのリスト ボックス部分に多数の項目を追加する前に、アプリケーションが CB_INITSTORAGE メッセージを送信します。 このメッセージにより、リスト ボックス項目を格納するためのメモリが割り当てられます。
CB_INSERTSTRING	コンボ ボックスのリストに文字列または項目データを挿入します。 CB_ADDSTRING メッセージとは異なり、CB_INSERTSTRING メッセージでは、CBS_SORT スタイルが設定されたリストの並べ替えは行われません。
CB_LIMITTEXT	コンボ ボックスの編集コントロールにユーザーが入力できるテキストの長さを制限します。
CB_RESETCONTENT	コンボ ボックスのリスト ボックスと編集コントロールからすべての項目を削除します。
CB_SELECTSTRING	コンボ ボックスのリストで、指定された文字列に含まれる文字で始まる項目を検索します。 一致する項目が見つかった場合は、その項目が選択され、編集コントロールにコピーされます。
CB_SETCUEBANNER	コンボ ボックスの編集コントロールに表示されるキュー バナー テキストを設定します。
CB_SETCURSEL	アプリケーションが CB_SETCURSEL メッセージを送信して、コンボ ボックスのリスト内にある文字列を選択します。 必要に応じて、リストがスクロールして文字列が表示されます。 コンボ ボックスの編集コントロール内のテキストが変更されて新しい選択範囲が反映され、リスト内でそれ以前に選択されていた場合は選択が解除されます。
CB_SETDROPPEDWIDTH	アプリケーションが CB_SETDROPPEDWIDTH メッセージを送信して、CBS_DROPDOWN スタイルまたは CBS_DROPDOWNLIST スタイルが設定されているコンボ ボックスのリスト ボックスに最大許容幅 (ピクセル単位) を設定します。
CB_SETEDITSEL	アプリケーションによって CB_SETEDITSEL メッセージが送信され、コンボ ボックスの編集コントロールで文字が選択されます。
CB_SETEXTENDEDUI	アプリケーションが CB_SETEXTENDEDUI メッセージを送信して、CBS_DROPDOWN スタイルまたは CBS_DROPDOWNLIST スタイルが設定されているコンボ ボックスに対して既定の UI または拡張 UI を選択します。
CB_SETHORIZONTALEXTENT	アプリケーションが CB_SETHORIZONTALEXTENT メッセージを送信して、リスト ボックスを水平方向にスクロールできる幅 (スクロール可能な幅) をピクセル単位で設定します。 リスト ボックスの幅がこの値より小さい場合、水平スクロール バーはリスト ボックス内の項目を水平方向にスクロールします。 リスト ボックスの幅がこの値以上である場合は、水平スクロール バーは非表示になります。または、コンボ ボックスに CBS_DISABLENOSCROLL スタイルが設定されている場合には、水平スクロール バーは無効になります。
CB_SETITEMDATA	アプリケーションが CB_SETITEMDATA メッセージを送信して、コンボ ボックス内の指定された項目に関連付けられている値を設定します。
CB_SETITEMHEIGHT	アプリケーションが CB_SETITEMHEIGHT メッセージを送信して、コンボ ボックス内のリスト アイテムまたは選択フィールドの高さを設定します。
CB_SETLOCALE	アプリケーションが CB_SETLOCALE メッセージを送信して、コンボ ボックスの現在のロケールを設定します。 コンボ ボックスに CBS_SORT スタイルが設定されており、CB_ADDSTRING を使用して文字列が追加される場合は、リスト アイテムの並べ替え方法にコンボ ボックスのロケールが影響します。
CB_SETMINVISIBLE	アプリケーションが CB_SETMINVISIBLE メッセージを送信して、コンボ ボックスのドロップダウン リストに表示される項目の最小数を設定します。
CB_SETTOPINDEX	アプリケーションが CB_SETTOPINDEX メッセージを送信して、コンボ ボックスのリスト ボックスに特定の項目が確実に表示されるようにします。 指定した項目がリスト ボックスの一番上に表示されるか、最大スクロール範囲に達するまで、リスト ボックスの内容がシステムによってスクロールされます。
CB_SHOWDROPDOWN	アプリケーションが CB_SHOWDROPDOWN メッセージを送信して、CBS_DROPDOWN スタイルまたは CBS_DROPDOWNLIST スタイルが設定されたコンボ ボックスのリスト ボックスを表示または非表示にします。

通知

トピック	内容
CBN_CLOSEUP	コンボ ボックスのリスト ボックスが閉じられると、CBN_CLOSEUP 通知コードが送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
CBN_DBLCLK	コンボ ボックスのリスト ボックス内の文字列をユーザーがダブルクリックすると、CBN_DBLCLK 通知コードが送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
CBN_DROPDOWN	コンボ ボックスのリスト ボックスが表示される直前に、CBN_DROPDOWN 通知コードが送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
CBN_EDITCHANGE	コンボ ボックスの編集コントロール部分でテキストが変更される可能性があるアクションをユーザーが実行した後に、CBN_EDITCHANGE 通知コードが送信されます。 CBN_EDITUPDATE 通知コードとは異なり、この通知コードは、システムが画面を更新した後に送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを通してこの通知コードを受信します。
CBN_EDITUPDATE	変更されたテキストが、コンボ ボックスの編集コントロール部分で表示される直前に、 CBN_EDITUPDATE 通知コードが送信されます。 この通知コードは、コントロールでテキストを書式設定した後、テキストを表示する前に送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
CBN_ERRSPACE	特定の要求を満たせるだけのに十分なメモリをコンボ ボックスで割り当てられない場合に、CBN_ERRSPACE 通知コードが送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
CBN_KILLFOCUS	コンボ ボックスがキーボード フォーカスを失うと、CBN_KILLFOCUS 通知コードが送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
CBN_SELCHANGE	コンボ ボックスのリスト ボックスで現在の選択をユーザーが変更すると、CBN_SELCHANGE 通知コードが送信されます。 ユーザーは、リスト ボックスをクリックするか、矢印キーを使用すると、選択を変更できます。 コンボ ボックスの親ウィンドウは、この通知を WM_COMMAND メッセージの形式で受信します。CBN_SELCHANGE は wParam パラメーターの上位ワードに格納されます。
CBN_SELENDCANCEL	ユーザーが項目を選択した後で別のコントロールを選択したりダイアログ ボックスを閉じたりすると、CBN_SELENDCANCEL 通知コードがに送信されます。 これは、ユーザーの最初の選択が無視されることを示します。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを通してこの通知コードを受け取ります。
CBN_SELENDOK	ユーザーがリスト アイテムを選択するか項目を選択した後にリストを閉じると、CBN_SELENDOK 通知コードが送信されます。 これは、ユーザーの選択が処理されることを示します。 コンボ ボックスの親ウィンドウに WM_COMMAND メッセージを介してこの通知コードが表示されます。
CBN_SETFOCUS	コンボ ボックスがキーボード フォーカスを取得すると、CBN_SETFOCUS 通知コードが送信されます。 コンボ ボックスの親ウィンドウは WM_COMMAND メッセージを介してこの通知コードを受信します。
WM_COMPAREITEM	システムが WM_COMPAREITEM メッセージを送信して、所有者描画のコンボ ボックスまたはリスト ボックスで、並べ替えられたリスト内の新しい項目の相対位置を判別します。 アプリケーションが新しい項目を追加するときは常に、CBS_SORT スタイルまたは LBS_SORT スタイルを指定して作成されたコンボ ボックスまたはリスト ボックスのオーナーに、システムからこのメッセージが送信されます。
WM_DRAWITEM	所有者描画のボタン、コンボ ボックス、リスト ボックス、またはメニューの視覚的要素が変更されたときに、そのボタン、コンボ ボックス、リスト ボックス、メニューの親ウィンドウに WM_DRAWITEM メッセージが送信されます。
WM_MEASUREITEM	コントロールまたはメニューが作成されたときに、コンボ ボックス、リスト ボックス、リストビュー コントロール、またはメニュー項目のオーナー ウィンドウに WM_MEASUREITEM メッセージが送信されます。

構造体

トピック	内容
COMBOBOXINFO	コンボ ボックスの状態情報が含まれます。
COMPAREITEMSTRUCT	並べ替えられた所有者描画のリスト ボックスまたはコンボ ボックス内にある 2 つの項目について、識別子と、アプリケーションによって提供されるデータを提供します。
DRAWITEMSTRUCT	所有者描画コントロールまたはメニュー項目の描画方法を決定するのに必要な情報をオーナー ウィンドウに提供します。 所有者描画コントロールまたはメニュー項目の所有者ウィンドウは、この構造体へのポインターを、WM_DRAWITEM メッセージの lParam パラメーターとして受け取ります。
MEASUREITEMSTRUCT	所有者描画コントロールまたはメニュー項目の寸法をシステムに通知します。 これにより、システムはコントロールに対するユーザー操作を正しく処理できます。

定数

トピック	内容
コンボ ボックス スタイル	CreateWindow 関数または CreateWindowEx 関数を使用してコンボ ボックスを作成するには、COMBOBOX クラス、適切なウィンドウ スタイル定数、および以下のコンボ ボックス スタイルの組み合わせを指定します。