CMFCToolBarComboBoxButton クラス

[アーティクル]
08/09/2011

コンボボックスコントロール (CComboBox クラス) を含むツールバーボタンです。

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

メンバー

パブリックコンストラクター

[名前]	説明
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton	CMFCToolBarComboBoxButton を構築します。

パブリックメソッド

[名前]	説明
CMFCToolBarComboBoxButton::AddItem	項目をコンボボックスリストの最後に追加します。
CMFCToolBarComboBoxButton::AddSortedItem	項目をコンボボックスリストに追加します。リスト内の項目の順序は、Compare で指定します。
CMFCToolBarComboBoxButton::Compare	2 つの項目を比較します。 AddSortedItems によってコンボボックスリストに追加された項目を並べ替えるために呼び出されます。
CMFCToolBarComboBoxButton::CreateEdit	コンボボックスボタンに新しいエディットコントロールを作成します。
CMFCToolBarComboBoxButton::DeleteItem	コンボボックスリストから項目を削除します。
CMFCToolBarComboBoxButton::FindItem	指定した文字列を含む項目のインデックスを返します。
CMFCToolBarComboBoxButton::GetByCmd	指定したコマンド ID を持つコンボボックスボタンへのポインターを返します。
CMFCToolBarComboBoxButton::GetComboBox	コンボボックスボタンに埋め込まれているコンボボックスコントロールへのポインターを返します。
CMFCToolBarComboBoxButton::GetCount	コンボボックスリストの項目数を返します。
CMFCToolBarComboBoxButton::GetCountAll	指定したコマンド ID を持つコンボボックスボタンを検索します。そのボタンのコンボボックスリストの項目数を返します。
CMFCToolBarComboBoxButton::GetCurSel	コンボボックスリストで選択されている項目のインデックスを返します。
CMFCToolBarComboBoxButton::GetCurSelAll	指定したコマンド ID を持つコンボボックスボタンを検索し、そのボタンのコンボボックスリストで選択されている項目のインデックスを返します。
CMFCToolBarComboBoxButton::GetEditCtrl	コンボボックスボタンに埋め込まれているエディットコントロールへのポインターを返します。
CMFCToolBarComboBoxButton::GetItem	コンボボックスリスト内の、指定したインデックスに関連付けられた文字列を返します。
CMFCToolBarComboBoxButton::GetItemAll	指定したコマンド ID を持つコンボボックスボタンを検索し、そのボタンのコンボボックスリスト内のインデックスに関連付けられた文字列を返します。
CMFCToolBarComboBoxButton::GetItemData	コンボボックスリスト内の、指定したインデックスに関連付けられた 32 ビット値を返します。
CMFCToolBarComboBoxButton::GetItemDataAll	指定したコマンド ID を持つコンボボックスボタンを検索し、そのボタンのコンボボックスリスト内のインデックスに関連付けられた 32 ビット値を返します。
CMFCToolBarComboBoxButton::GetItemDataPtrAll	指定したコマンド ID を持つコンボボックスボタンを検索します。そのボタンのコンボボックスリスト内のインデックスに関連付けられた 32 ビット値を取得し、32 ビット値をポインターとして返します。
CMFCToolBarComboBoxButton::GetText	コンボボックスのエディットコントロールからテキストを返します。
CMFCToolBarComboBoxButton::GetTextAll	指定したコマンド ID を持つコンボボックスボタンを検索し、そのボタンのエディットコントロールからテキストを返します。
CMFCToolBarComboBoxButton::IsCenterVert	アプリケーションのコンボボックスボタンがツールバーの中央に配置されているか、ツールバーの上部に配置されているかどうかを確認します。
CMFCToolBarComboBoxButton::IsFlatMode	アプリケーションのコンボボックスボタンがフラットな外観であるかどうかを確認します。
CMFCToolBarComboBoxButton::RemoveAllItems	コンボボックスのリストボックスとエディットコントロールからすべての項目を削除します。
CMFCToolBarComboBoxButton::SelectItem	インデックス、32 ビット値、または文字列に従ってコンボボックス内の項目を選択し、その選択についてコンボボックスコントロールに通知します。
CMFCToolBarComboBoxButton::SelectItemAll	指定したコマンド ID を持つコンボボックスボタンを検索します。そのボタンのコンボボックス内の項目を文字列、インデックス、または 32 ビット値に従って選択するには、SelectItem を呼び出します。
CMFCToolBarComboBoxButton::SetCenterVert	アプリケーションのコンボボックスボタンがツールバーの垂直方向の中央に配置されているか、ツールバーの上部に配置されているかどうかを指定します。
CMFCToolBarComboBoxButton::SetDropDownHeight	ドロップダウンリストボックスの高さを設定します。
CMFCToolBarComboBoxButton::SetFlatMode	アプリケーションのコンボボックスボタンをフラットな外観であるかどうかを指定します。

解説

ツールバーにコンボボックスボタンを追加するには、次の手順を実行します。

1. 親ツールバーリソースでボタンのダミーリソース ID を予約します。

2. CMFCToolBarComboBoxButton オブジェクトを構築します。

3. AFX_WM_RESETTOOLBAR メッセージを処理するメッセージハンドラーで、CMFCToolBar::ReplaceButton を使用してダミーボタンを新しいコンボボックスボタンに置き換えます。

詳細については、「チュートリアル: ツールバーへのコントロールの追加」を参照してください。コンボボックスツールバーボタンの例については、サンプルプロジェクト VisualStudioDemo を参照してください。

使用例

CMFCToolBarComboBoxButton クラスのさまざまなメソッドの使用方法を次の例に示します。この例では、エディットボックスとコンボボックスを有効にする方法、アプリケーションのコンボボックスボタンの垂直位置を設定する方法、リストボックスがドロップダウンされたときの高さを設定する方法、アプリケーションのコンボボックスボタンの外観をフラットスタイルに設定する方法、およびコンボボックスボタンのエディットボックスのテキストを設定する方法を示します。このコードスニペットは、「VisualStudioDemo サンプル:MFC Visual Studio アプリケーション」の一部です。

            // CObList listButtons
            // POSITION posCombo
            CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));


...


                pCombo->EnableWindow(true);
                pCombo->SetCenterVert();
                pCombo->SetDropDownHeight(25);
                pCombo->SetFlatMode();
                pCombo->SetText(_T("this is a combo box"));