CMFCToolBarComboBoxButton クラス

[アーティクル]
10/12/2023

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

構文

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

メンバー

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

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

パブリックメソッド

名前	説明
CMFCToolBarComboBoxButton::AddItem	コンボボックスリストの末尾に項目を追加します。
CMFCToolBarComboBoxButton::AddSortedItem	コンボボックスリストに項目を追加します。リスト内の項目の順序は、 `Compare`によって指定されます。
CMFCToolBarComboBoxButton::Compare	2 つの項目を比較します。コンボボックスリストに追加 `AddSortedItems` 項目を並べ替えるために呼び出されます。
CMFCToolBarComboBoxButton::CreateEdit	コンボボックスボタンの新しい編集コントロールを作成します。
CMFCToolBarComboBoxButton::D eleteItem	コンボボックスリストから項目を削除します。
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 を持つコンボボックスボタンを検索します。 `SelectItem`呼び出して、文字列、インデックス、または 32 ビット値に従って、そのボタンのコンボボックス内の項目を選択します。
CMFCToolBarComboBoxButton::SetCenterVert	アプリケーションのコンボボックスボタンを垂直方向の中央に配置するか、ツールバーの上部に揃えるかを指定します。
CMFCToolBarComboBoxButton::SetDropDownHeight	ドロップダウンリストボックスの高さを設定します。
CMFCToolBarComboBoxButton::SetFlatMode	アプリケーションのコンボボックスボタンの外観をフラットにするかどうかを指定します。

解説

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

親ツールバーリソースでボタンのダミーリソース ID を予約します。
CMFCToolBarComboBoxButton オブジェクトを構築します。
AFX_WM_RESETTOOLBAR メッセージを処理するメッセージハンドラーで、 CMFCToolBar::ReplaceButton を使用して、ダミーボタンを新しいコンボボックスボタンに置き換えます。

詳細については、「 Walkthrough: Putting Controls on Toolbars」を参照してください。コンボボックスのツールバーボタンの例については、VisualStudioDemo プロジェクトの例を参照してください。

例

CMFCToolBarComboBoxButton クラスのさまざまなメソッドの使用方法を次の例に示します。この例では、編集ボックスとコンボボックスを有効にする方法、アプリケーション内のコンボボックスボタンの垂直方向の位置を設定する方法、ドロップダウン時のリストボックスの高さを設定する方法、アプリケーション内のコンボボックスボタンのフラットスタイルの外観を設定する方法、コンボボックスボタンの編集ボックスにテキストを設定する方法を示します。このコードスニペットは、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"));

継承階層

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

要件

Header: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

リストボックスに一意の項目を追加します。

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

パラメーター

lpszItem
[in]リストボックスに追加するアイテムのテキスト。

dwData
[in]リストボックスに追加する項目に関連付けられているデータ。

戻り値

リストボックス内の最後の項目のインデックス。

解説

リストボックスのスタイルを並べ替える場合は、このメソッドを使用しないでください。

項目テキストがリストボックスに既に存在する場合、新しいデータは既存の項目と共に格納されます。アイテムの検索では、大文字と小文字が区別されます。

CMFCToolBarComboBoxButton::AddSortedItem

Compare メソッドで定義されている順序でリストボックスに項目を追加します。

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

パラメーター

lpszItem
[in]リストボックスに追加するアイテムのテキスト。

dwData
[in]リストボックスに追加する項目に関連付けられているデータ。

戻り値

リストボックスに追加されたアイテムのインデックス。

解説

この関数を使用して、特定の順序でリストボックスに項目を追加します。

CMFCToolBarComboBoxButton::CanBeStretched

コンボボックスボタンのサイズを変更できるかどうかを示します。

virtual BOOL CanBeStretched() const;

戻り値

TRUE を返します。

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

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

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

パラメーター

uiID
[in]新しいボタンのコマンド ID。

iImage
[in]新しいボタンに関連付けられているイメージのイメージインデックス。

dwStyle
[in]新しいボタンのスタイル。

iWidth
[in]新しいボタンの幅 (ピクセル単位)。

解説

既定の幅は 150 ピクセルです。

ツールバーボタンのスタイルの一覧については、「 ToolBar コントロールのスタイル」を参照してください。

CMFCToolBarComboBoxButton::ClearData

ユーザー定義データを削除します。

virtual void ClearData();

解説

既定では、このメソッドは何も行いません。ユーザー定義データを削除する場合は、派生クラスでこのメソッドをオーバーライドします。

CMFCToolBarComboBoxButton::Compare

2 つの文字列を比較します。

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

パラメーター

lpszItem1
[in]比較する最初の文字列。

lpszItem2
[in]比較する 2 番目の文字列。

戻り値

文字列間の構文の大文字と小文字を区別する関係を示す値。可能な値を次の表に示します。

値	説明
<0	最初の文字列が 2 番目の文字列より小さい。
0	最初の文字列は 2 番目の文字列と等しくなります。
>0	最初の文字列が 2 番目の文字列より大きい。

解説

リストボックスでの項目の並べ替え方法を変更するには、このメソッドをオーバーライドします。

比較では、大文字と小文字を区別します。

このメソッドは、 AddSortedItem メソッドからのみ呼び出されます。

CMFCToolBarComboBoxButton::CopyFrom

指定した CMFCToolBarComboBoxButton の状態を現在のオブジェクトにコピーします。

virtual void CopyFrom(const CMFCToolBarButton& src);

パラメーター

src
[in]ソース CMFCToolBarComboBoxButton オブジェクト。

CMFCToolBarComboBoxButton::CreateCombo

コンボボックスボタンの新しいコンボボックスを作成します。

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

パラメーター

pWndParent
[in]ボタンの親ウィンドウへのポインター。

rect
[in]コンボボックスの外接する四角形。

戻り値

メソッドが成功した場合の新しいコンボボックスへのポインター。それ以外の場合は NULL。

CMFCToolBarComboBoxButton::CreateEdit

コンボボックスボタンの新しい編集ボックスを作成します。

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

パラメーター

pWndParent
[in]ボタンの親ウィンドウへのポインター。

rect
[in]新しい編集ボックスの外接する四角形。

dwEditStyle
[in]新しい編集ボックスのコントロールスタイル。

戻り値

メソッドが成功した場合の新しい編集ボックスへのポインター。それ以外の場合は NULL。

解説

フレームワークは、コンボボックスボタンの新しい編集ボックスを作成するときに、このメソッドを呼び出します。このメソッドをオーバーライドして、CMFCToolBarComboBoxEdit の作成方法を変更します。

CMFCToolBarComboBoxButton::D eleteItem

リストボックスから指定した項目を削除します。

BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);

パラメーター

iIndex
[in]削除する項目の 0 から始まるインデックス。

dwData
[in]削除するアイテムに関連付けられているデータ。

lpszText
[in]削除するアイテムのテキスト。同じテキストを持つ複数の項目がある場合、最初の項目は削除されます。

戻り値

アイテムが見つから、正常に削除された場合は TRUE。それ以外の場合は FALSE。

解説

CMFCToolBarComboBoxButton::D uplicateData

ユーザー定義データを複製します。

virtual void DuplicateData();

解説

既定では、このメソッドは何も行いません。ユーザー定義データをコピーする場合は、派生クラスでこのメソッドをオーバーライドします。

CMFCToolBarComboBoxButton::EnableWindow

編集ボックスとコンボボックスを有効または無効にします。

virtual void EnableWindow(BOOL bEnable = TRUE);

パラメーター

bEnable
[in]編集ボックスとコンボボックスを有効にする場合は TRUE。編集ボックスとコンボボックスを無効にする場合は FALSE。

解説

無効にすると、コントロールをアクティブにできず、ユーザー入力を受け入れることができません。

CMFCToolBarComboBoxButton::ExportToMenuButton

コンボボックスボタンのコマンド ID を使用して、アプリケーション文字列テーブルから指定したメニューに文字列をコピーします。

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

パラメーター

menuButton
[out]メニューボタンへの参照。

戻り値

常に TRUE。

CMFCToolBarComboBoxButton::FindItem

指定した文字列を含むリストボックスの最初の項目のインデックスを返します。

int FindItem(LPCTSTR lpszText) const;

パラメーター

lpszText
[in]リストボックスで検索するテキスト。

戻り値

項目のインデックス。または、アイテムが見つからない場合にCB_ERRします。

解説

CMFCToolBarComboBoxButton::GetByCmd

指定したコマンド ID を持つコンボボックスボタンへのポインターを取得します。

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

パラメーター

uiCmd
[in]コンボボックスボタンのコマンド ID。

bIsFocus
[in]フォーカスされたボタンのみを検索する場合は TRUE。すべてのボタンを検索する場合は FALSE。

戻り値

コンボボックスボタンへのポインター。ボタンが見つからない場合は NULL。

解説

CMFCToolBarComboBoxButton::GetComboBox

コンボボックスボタン内のコンボボックスへのポインターを返します。

CComboBox* GetComboBox() const;

戻り値

メソッドが成功した場合は CComboBox クラスオブジェクトへのポインター。それ以外の場合は NULL。

解説

CMFCToolBarComboBoxButton::GetContextMenuID

コンボボックスボタンのショートカットメニューリソース ID を取得します。

UINT GetContextMenuID();

戻り値

ショートカットメニューのリソース ID。

CMFCToolBarComboBoxButton::GetCount

リストボックス内の項目の数を返します

INT_PTR GetCount() const;

戻り値

リストボックス内の項目の数。

解説

CMFCToolBarComboBoxButton::GetCountAll

指定したコマンド ID を持つコンボボックスボタンのリストボックス内の項目の数を取得します。

static int GetCountAll(UINT uiCmd);

パラメーター

uiCmd
[in]コンボボックスボタンのコマンド ID。

戻り値

リストボックス内の項目の数。それ以外の場合は、コンボボックスボタンが見つからない場合にCB_ERRします。

解説

CMFCToolBarComboBoxButton::GetCurSel

リストボックスで現在選択されている項目のインデックスを取得します。

int GetCurSel() const;

戻り値

リストボックスで現在選択されている項目のインデックス。または、項目が選択されていない場合はCB_ERRします。

解説

リストボックスのインデックスは 0 から始まります。

CMFCToolBarComboBoxButton::GetCurSelAll

指定したコマンド ID を持つコンボボックスボタンのリストボックスで現在選択されている項目のインデックスを返します。

static int GetCurSelAll(UINT uiCmd);

パラメーター

uiCmd
[in]コンボボックスボタンのコマンド ID。

戻り値

リストボックスで現在選択されている項目のインデックス。それ以外の場合は、項目が選択されていないか、コンボボックスボタンが見つからない場合にCB_ERRします。

解説

リストボックスのインデックスは 0 から始まります。

CMFCToolBarComboBoxButton::GetEditCtrl

コンボボックスボタンの編集ボックスへのポインターを返します。

virtual CEdit* GetEditCtrl();

戻り値

メソッドが成功した場合の編集ボックスへのポインター。それ以外の場合は NULL。

解説

CMFCToolBarComboBoxButton::GetHwnd

コンボボックスのウィンドウハンドルを返します。

virtual HWND GetHwnd();

戻り値

ウィンドウハンドル。コンボボックスがウィンドウオブジェクトに関連付けられていない場合は NULL。

CMFCToolBarComboBoxButton::GetItem

リストボックス内の指定したインデックス位置にある項目に関連付けられた文字列を返します。

LPCTSTR GetItem(int iIndex=-1) const;

パラメーター

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。

戻り値

項目に関連付けられている文字列へのポインター。それ以外の場合は NULL。インデックスパラメーターが無効な場合、またはインデックスパラメーターが -1 で、コンボボックスに選択された項目がない場合は NULL。

解説

インデックスパラメーター -1 は、現在選択されている項目の文字列を返します。

CMFCToolBarComboBoxButton::GetItemAll

指定したコマンド ID を持つコンボボックスボタンのリストボックス内の指定したインデックス位置にある項目に関連付けられた文字列を返します。

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

パラメーター

uiCmd
[in]コンボボックスボタンのコマンド ID。

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。

戻り値

メソッドが成功した場合の項目の文字列へのポインター。それ以外の場合、インデックスが無効な場合、コンボボックスボタンが見つからない場合、またはインデックスが -1 で、コンボボックスに選択された項目がない場合は NULL。

解説

インデックス値 -1 は、現在選択されている項目の文字列を返します。

CMFCToolBarComboBoxButton::GetItemData

リストボックス内の特定のインデックスにある項目に関連付けられたデータを返します。

DWORD_PTR GetItemData(int iIndex=-1) const;

パラメーター

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。

戻り値

アイテムに関連付けられているデータ。または、項目が存在しない場合は 0。

解説

インデックスパラメーター -1 は、現在選択されている項目に関連付けられているデータを返します。

CMFCToolBarComboBoxButton::GetItemDataAll

特定のコマンド ID を持つコンボボックスボタンのリストボックス内の特定のインデックスにある項目に関連付けられたデータを返します。

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

パラメーター

uiCmd
[in]コンボボックスボタンのコマンド ID。

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。

戻り値

メソッドが成功した場合にアイテムに関連付けられたデータ。それ以外の場合は、指定したインデックスが無効な場合は 0、コンボボックスボタンが見つからない場合はCB_ERR。

解説

インデックスパラメーター -1 は、現在選択されている項目に関連付けられているデータを返します。

CMFCToolBarComboBoxButton::GetItemDataPtrAll

特定のコマンド ID を持つコンボボックスボタンのリストボックス内の特定のインデックスにある項目に関連付けられたデータを返します。このデータはポインターとして返されます。

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

パラメーター

uiCmd
[in]コンボボックスボタンのコマンド ID。

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。

戻り値

メソッドが成功した場合に項目に関連付けられたポインター。それ以外の場合は -1、エラーが発生した場合は -1、コンボボックスボタンが見つからない場合は NULL。

解説

CMFCToolBarComboBoxButton::GetPrompt

コンボボックスボタンのプロンプト文字列を返します。

virtual CString GetPrompt() const;

戻り値

プロンプト文字列。

解説

このメソッドは現在実装されていません。

CMFCToolBarComboBoxButton::GetText

編集ボックス内のテキストを取得します。

LPCTSTR GetText() const;

戻り値

編集ボックス内のテキスト。

解説

CMFCToolBarComboBoxButton::GetTextAll

指定したコマンド ID を持つコンボボックスボタンの編集ボックス内のテキストを取得します。

static LPCTSTR GetTextAll(UINT uiCmd);

パラメーター

uiCmd
[in]特定のコンボボックスボタンのコマンド ID。

戻り値

メソッドが成功した場合の編集ボックス内のテキスト。それ以外の場合は NULL。

解説

CMFCToolBarComboBoxButton::HasFocus

コンボボックスに現在フォーカスがあるかどうかを示します。

virtual BOOL HasFocus() const;

戻り値

コンボボックスに現在フォーカスがある場合は TRUE。それ以外の場合は FALSE。

解説

このメソッドは、コンボボックスの子ウィンドウに現在フォーカスがある場合にも TRUE を返します。

CMFCToolBarComboBoxButton::IsCenterVert

アプリケーション内のコンボボックスボタンの垂直方向の位置を返します。

static BOOL IsCenterVert();

戻り値

ボタンが中央揃えの場合は TRUE。ボタンが上部に配置されている場合は FALSE。

解説

CMFCToolBarComboBoxButton::IsFlatMode

アプリケーション内のコンボボックスボタンのフラットスタイルの外観を返します。

static BOOL IsFlatMode();

戻り値

ボタンにフラットスタイルがある場合は TRUE。それ以外の場合は FALSE。

解説

コンボボックスボタンの既定のフラットスタイルは FALSE です。

CMFCToolBarComboBoxButton::IsOwnerOf

指定したハンドルがコンボボックスボタンに関連付けられているか、またはその子のいずれかに関連付けられているかを示します。

virtual BOOL IsOwnerOf(HWND hwnd);

パラメーター

hwnd
[in]ウィンドウハンドル。

戻り値

ハンドルがコンボボックスボタンまたはその子の 1 つで割り当て済みの場合は TRUE。それ以外の場合は FALSE。

CMFCToolBarComboBoxButton::IsRibbonButton

コンボボックスボタンがリボンパネルに存在するかどうかを示します。

BOOL IsRibbonButton() const;

戻り値

常に FALSE です。

解説

既定では、このメソッドは常に FALSE を返します。つまり、コンボボックスボタンがリボンパネルに表示されることはありません。

CMFCToolBarComboBoxButton::IsWindowVisible

コンボボックスボタンの表示状態を返します。

virtual BOOL IsWindowVisible();

戻り値

コンボボックスボタンの表示状態。

CMFCToolBarComboBoxButton::NotifyCommand

コンボボックスボタンがメッセージを処理するかどうかを示します。

virtual BOOL NotifyCommand(int iNotifyCode);

パラメーター

iNotifyCode
[in]コマンドに関連付けられている通知メッセージ。

戻り値

コンボボックスボタンがメッセージを処理するかどうかを指定します。

CMFCToolBarComboBoxButton::OnAddToCustomizePage

ボタンが Customize ダイアログボックスに追加されたときにフレームワークによって呼び出されます。

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

ボタンのサイズを計算するためにフレームワークによって呼び出されます。

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

パラメーター

pDC
[in]コンボボックスボタンを表示するデバイスコンテキスト。

sizeDefault
[in]コンボボックスボタンの既定のサイズ。

bHorz
[in]親ツールバーのドッキング状態。ツールバーが水平方向にドッキングされている場合は TRUE、ツールバーが垂直方向にドッキングされている場合は FALSE。

戻り値

コンボボックスボタンの寸法をピクセル単位で格納する SIZE 構造体。

CMFCToolBarComboBoxButton::OnChangeParentWnd

コンボボックスボタンが新しいツールバーに挿入されたときにフレームワークによって呼び出されます。

virtual void OnChangeParentWnd(CWnd* pWndParent);

パラメーター

pWndParent
[in]新しい親ツールバーへのポインター。

CMFCToolBarComboBoxButton::OnClick

ユーザーがコンボボックスボタンをクリックすると、フレームワークによって呼び出されます。

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

パラメーター

pWnd
[in]コンボボックスボタンの親ウィンドウへのポインター。

bDelay
[in]派生クラスで使用するために予約されています。

戻り値

メソッドがイベントを処理する場合は TRUE。それ以外の場合は FALSE。

CMFCToolBarComboBoxButton::OnCtlColor

ユーザーが親ツールバーの色を変更してコンボボックスボタンの色を設定するときに、フレームワークによって呼び出されます。

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

パラメーター

pDC
[in]コンボボックスボタンを表示するデバイスコンテキスト。

nCtlColor
[入力] 使用されていません。

戻り値

フレームワークがコンボボックスボタンの背景を描画するために使用するブラシを処理します。

解説

このメソッドは、コンボボックスボタンのテキストの色も設定します。

CMFCToolBarComboBoxButton::OnDraw

指定したスタイルとオプションを使用してコンボボックスボタンを描画するために、フレームワークによって呼び出されます。

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

パラメーター

Pdc
[in]ボタンを表示するデバイスコンテキスト。

rect
[in]ボタンの外接する四角形。

pImages
[in]ボタンに関連付けられているイメージのコレクション。

bCustomizeMode
[in]アプリケーションがカスタマイズモードかどうか。

bHighlight
[in]コンボボックスボタンを強調表示して描画するかどうかを指定します。

bDrawBorder
[in]コンボボックスボタンを境界線で描画するかどうかを指定します。

bGrayDisabledButtons
[in]TRUE の場合は、影付きの無効なボタンを描画します。無効なイメージコレクションを使用する場合は FALSE。

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

Customize ダイアログボックスの Commands ウィンドウにコンボボックスボタンを描画するためにフレームワークによって呼び出されます。

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

パラメーター

pDC
[in]コンボボックスボタンを表示するデバイスコンテキスト。

rect
[in]コンボボックスボタンの外接する四角形。

bSelected
[in]コンボボックスボタンが選択されている場合は TRUE。それ以外の場合は FALSE。

戻り値

コンボボックスボタンの幅 (ピクセル単位)。

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

アプリケーションのフォントが変更されたときにコンボボックスボタンのフォントを設定するためにフレームワークによって呼び出されます。

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

親ツールバーが移動したときにコンボボックスボタンの位置を変更するためにフレームワークによって呼び出されます。

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

コンボボックスボタンが非表示または表示されるときにフレームワークによって呼び出されます。

virtual void OnShow(BOOL bShow);

パラメーター

bShow
[in]コンボボックスボタンを非表示または表示するかどうかを指定します。

CMFCToolBarComboBoxButton::OnSize

親ツールバーのサイズが変更されたときにコンボボックスボタンのサイズを変更するためにフレームワークによって呼び出されます。

virtual void OnSize(int iSize);

パラメーター

iSize
[in]コンボボックスボタンの新しい幅。

CMFCToolBarComboBoxButton::OnUpdateToolTip

ユーザーがコンボボックスボタンのツールヒントを変更したときにフレームワークによって呼び出されます。

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

パラメーター

pWndParent
[in]コンボボックスボタンの親ウィンドウへのポインター。

iButtonIndex
[in]コンボボックスボタンの ID。

wndToolTip
[in]コンボボックスボタンに関連付けるツールヒント。

str
[in]ツールヒントのテキスト。

戻り値

メソッドがイベントを処理する場合は TRUE。それ以外の場合は FALSE。

CMFCToolBarComboBoxButton::RemoveAllItems

リストおよび編集ボックスからすべてのアイテムを削除します。

void RemoveAllItems();

解説

コンボボックスのリストボックスと編集コントロールからすべての項目を削除します。

CMFCToolBarComboBoxButton::SelectItem

リストボックス内の項目を選択します。

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

パラメーター

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。

bNotify
[in]選択のコンボボックスボタンを通知する場合は TRUE。それ以外の場合は FALSE。

dwData
[in]リストボックス内のアイテムに関連付けられているデータ。

lpszText
[in]リストボックス内のアイテムのテキスト。

戻り値

メソッドが成功した場合は TRUE。それ以外の場合は FALSE。

解説

CMFCToolBarComboBoxButton::SelectItemAll

指定したコマンド ID を持つコンボボックスボタンのリストボックス内の項目を選択します。

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

パラメーター

uiCmd
[in]リストボックスを含むコンボボックスボタンのコマンド ID。

iIndex
[in]リストボックス内の項目の 0 から始まるインデックス。値 -1 を指定すると、リストボックス内の現在の選択範囲が削除され、編集ボックスがクリアされます。

dwData
[in]リストボックス内のアイテムのデータ。

lpszText
[in]リストボックス内のアイテムのテキスト。

戻り値

メソッドが成功した場合は TRUE。それ以外の場合は FALSE。

解説

CMFCToolBarComboBoxButton::Serialize

このオブジェクトをアーカイブから読み取るか、アーカイブに書き込みます。

virtual void Serialize(CArchive& ar);

パラメーター

ar
[入力、出力]シリアル化する CArchive オブジェクト。

解説

CArchive オブジェクトの設定によって、このメソッドがアーカイブの読み取りまたは書き込みを行うかどうかが決まります。

CMFCToolBarComboBoxButton::SetACCData

コンボボックスボタンのアクセシビリティデータを使用して、指定した CAccessibilityData オブジェクトを設定します。

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

パラメーター

pParent
[in]コンボボックスボタンの親ウィンドウ。

data
[out]コンボボックスボタンからアクセシビリティデータを受け取る CAccessibilityData オブジェクト。

戻り値

メソッドが成功した場合は TRUE。それ以外の場合は FALSE。

CMFCToolBarComboBoxButton::SetCenterVert

アプリケーション内のコンボボックスボタンの垂直方向の位置を設定します。

static void SetCenterVert(BOOL bCenterVert=TRUE);

パラメーター

bCenterVert
[in]ツールバーのコンボボックスボタンを中央に配置する場合は TRUE。コンボボックスボタンをツールバーの上部に配置する場合は FALSE。

解説

既定では、コンボボックスボタンは上部に配置されます。

CMFCToolBarComboBoxButton::SetContextMenuID

コンボボックスボタンのショートカットメニューリソース ID を設定します。

void SetContextMenuID(UINT uiResID);

パラメーター

uiResID
[in]ショートカットメニューのリソース ID。

CMFCToolBarComboBoxButton::SetDropDownHeight

ドロップダウン時のリストボックスの高さを設定します。

void SetDropDownHeight(int nHeight);

パラメーター

nHeight
[in]リストボックスの高さ (ピクセル単位)。

解説

既定の高さは 150 ピクセルです。

CMFCToolBarComboBoxButton::SetFlatMode

アプリケーションのコンボボックスボタンのフラットスタイルの外観を設定します。

static void SetFlatMode(BOOL bFlat=TRUE);

パラメーター

bFlat
[in]フラットスタイルの外観の場合は TRUE。それ以外の場合は FALSE。

解説

コンボボックスボタンの既定のフラットスタイルは FALSE です。

CMFCToolBarComboBoxButton::SetStyle

コンボボックスボタンの指定したスタイルを設定し、無効でない場合はコントロールを再描画します。

virtual void SetStyle(UINT nStyle);

パラメーター

nStyle
[in]ツールバースタイルのビットごとの組み合わせ (OR)。

解説

ツールバーボタンのスタイルの一覧については、「 ToolBar コントロールのスタイル」を参照してください。

CMFCToolBarComboBoxButton::SetText

コンボボックスボタンの編集ボックスのテキストを設定します。

void SetText(LPCTSTR lpszText);

パラメーター

lpszText
[in]編集ボックスのテキストを含む文字列へのポインター。

次の方法で共有

CMFCToolBarComboBoxButton クラス

構文

メンバー

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

パブリック メソッド

解説

例

継承階層

要件

CMFCToolBarComboBoxButton::AddItem

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::AddSortedItem

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::CanBeStretched

戻り値

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

パラメーター

解説

CMFCToolBarComboBoxButton::ClearData

解説

CMFCToolBarComboBoxButton::Compare

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::CopyFrom

パラメーター

CMFCToolBarComboBoxButton::CreateCombo

パラメーター

戻り値

CMFCToolBarComboBoxButton::CreateEdit

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::D eleteItem

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::D uplicateData

解説

CMFCToolBarComboBoxButton::EnableWindow

パラメーター

解説

CMFCToolBarComboBoxButton::ExportToMenuButton

パラメーター

戻り値

CMFCToolBarComboBoxButton::FindItem

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::GetByCmd

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::GetComboBox

戻り値

解説

CMFCToolBarComboBoxButton::GetContextMenuID

戻り値

CMFCToolBarComboBoxButton::GetCount

戻り値

解説

CMFCToolBarComboBoxButton::GetCountAll

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::GetCurSel

戻り値

解説

CMFCToolBarComboBoxButton::GetCurSelAll

パラメーター

戻り値

解説

CMFCToolBarComboBoxButton::GetEditCtrl

戻り値

解説

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

パブリックメソッド