CMFCToolBarComboBoxButton Class
A toolbar button that contains a combo box control ( CComboBox Class).
Syntax
class CMFCToolBarComboBoxButton : public CMFCToolBarButton
Members
Public Constructors
| Name | Description |
|---|---|
| CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton | Constructs a CMFCToolBarComboBoxButton. |
Public Methods
| Name | Description |
|---|---|
| CMFCToolBarComboBoxButton::AddItem | Adds an item to the end of the combo box list. |
| CMFCToolBarComboBoxButton::AddSortedItem | Adds an item to the combo box list. The order of items in the list is specified by Compare. |
| CMFCToolBarComboBoxButton::Compare | Compares two items. Called to sort items that AddSortedItems adds to the combo box list. |
| CMFCToolBarComboBoxButton::CreateEdit | Creates a new edit control for the combo box button. |
| CMFCToolBarComboBoxButton::DeleteItem | Deletes an item from the combo box list. |
| CMFCToolBarComboBoxButton::FindItem | Returns the index of the item that contains a specified string. |
| CMFCToolBarComboBoxButton::GetByCmd | Returns a pointer to the combo box button with a specified command ID. |
| CMFCToolBarComboBoxButton::GetComboBox | Returns a pointer to the combo box control that is embedded in the combo box button. |
| CMFCToolBarComboBoxButton::GetCount | Returns the number of items in the combo box list. |
| CMFCToolBarComboBoxButton::GetCountAll | Finds the combo box button that has a specified command ID. Returns the number of items in the combo box list of that button. |
| CMFCToolBarComboBoxButton::GetCurSel | Returns the index of the selected item in the combo box list. |
| CMFCToolBarComboBoxButton::GetCurSelAll | Finds the combo box button that has a specified command ID, and returns the index of the selected item in the combo box list of that button. |
| CMFCToolBarComboBoxButton::GetEditCtrl | Returns a pointer to the edit control that is embedded in the combo box button. |
| CMFCToolBarComboBoxButton::GetItem | Returns the string that is associated with a specified index in the combo box list. |
| CMFCToolBarComboBoxButton::GetItemAll | Finds the combo box button that has a specified command ID, and returns the string that is associated with an index in the combo box list of that button. |
| CMFCToolBarComboBoxButton::GetItemData | Returns the 32-bit value that is associated with a specified index in the combo box list. |
| CMFCToolBarComboBoxButton::GetItemDataAll | Finds the combo box button that has a specified command ID, and returns the 32-bit value that is associated with an index in the combo box list of that button. |
| CMFCToolBarComboBoxButton::GetItemDataPtrAll | Finds the combo box button that has a specified command ID. Retrieves the 32-bit value that is associated an index in the combo box list of that button, and returns the 32-bit value as a pointer. |
| CMFCToolBarComboBoxButton::GetText | Returns the text from the edit control of the combo box. |
| CMFCToolBarComboBoxButton::GetTextAll | Finds the combo box button that has a specified command ID, and returns the text from edit control of that button. |
| CMFCToolBarComboBoxButton::IsCenterVert | Determines whether combo box buttons in the application are centered or aligned with the top of the toolbar. |
| CMFCToolBarComboBoxButton::IsFlatMode | Determines whether combo box buttons in the application have a flat appearance. |
| CMFCToolBarComboBoxButton::RemoveAllItems | Removes all items from the list box and edit control of the combo box. |
| CMFCToolBarComboBoxButton::SelectItem | Selects an item in the combo box according to its index, 32-bit value, or string, and notifies the combo box control about the selection. |
| CMFCToolBarComboBoxButton::SelectItemAll | Finds the combo box button that has a specified command ID. Calls SelectItem to select an item in the combo box of that button according to its string, index, or 32-bit value. |
| CMFCToolBarComboBoxButton::SetCenterVert | Specifies whether combo box buttons in the application are centered vertically or aligned with the top of the toolbar. |
| CMFCToolBarComboBoxButton::SetDropDownHeight | Sets the height of the drop-down list box. |
| CMFCToolBarComboBoxButton::SetFlatMode | Specifies whether combo box buttons in the application have a flat appearance. |
Remarks
To add a combo box button to a toolbar, follow these steps:
Reserve a dummy resource ID for the button in the parent toolbar resource.
Construct a
CMFCToolBarComboBoxButtonobject.In the message handler that processes the AFX_WM_RESETTOOLBAR message, replace the dummy button with the new combo box button by using CMFCToolBar::ReplaceButton.
For more information, see Walkthrough: Putting Controls On Toolbars. For an example of a combo box toolbar button, see the example project VisualStudioDemo.
Example
The following example demonstrates how to use various methods in the CMFCToolBarComboBoxButton class. The example shows how to enable the edit and combo boxes, set the vertical position of combo box buttons in the application, set the height of the list box when it is dropped down, set the flat style appearance of combo box buttons in the application, and set the text in the edit box of the combo box button. This code snippet is part of the Visual Studio Demo sample.
// 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"));
Inheritance Hierarchy
Requirements
Header: afxtoolbarcomboboxbutton.h
CMFCToolBarComboBoxButton::AddItem
Appends a unique item to the list box.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parameters
lpszItem
[in] The text of the item to add to the list box.
dwData
[in] The data associated with the item to add to the list box.
Return Value
The index of the last item in the list box.
Remarks
Do not use this method when the list box style is sorted.
If the item text is already in the list box, the new data is stored with the existing item. The search for the item is case sensitive.
CMFCToolBarComboBoxButton::AddSortedItem
Adds an item to the list box in the order that is defined by the Compare method.
virtual INT_PTR AddSortedItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parameters
lpszItem
[in] The text of the item to add to the list box.
dwData
[in] The data associated with the item to add to the list box.
Return Value
Index of the item that was added to the list box.
Remarks
Use this function to add items to the list box in a specific order.
CMFCToolBarComboBoxButton::CanBeStretched
Indicates whether the combo box button size can change.
virtual BOOL CanBeStretched() const;
Return Value
Returns TRUE.
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton
Constructs a CMFCToolBarComboBoxButton object.
CMFCToolBarComboBoxButton(
UINT uiID,
int iImage,
DWORD dwStyle=CBS_DROPDOWNLIST,
int iWidth=0);
Parameters
uiID
[in] The command ID of the new button.
iImage
[in] The image index of the image associated with the new button.
dwStyle
[in] The style of the new button.
iWidth
[in] The width, in pixels, of the new button.
Remarks
The default width is 150 pixels.
For a list of toolbar button styles see ToolBar Control Styles
CMFCToolBarComboBoxButton::ClearData
Deletes user-defined data.
virtual void ClearData();
Remarks
By default this method does nothing. Override this method in a derived class if you want to delete any user-defined data.
CMFCToolBarComboBoxButton::Compare
Compares two strings.
virtual int Compare(
LPCTSTR lpszItem1,
LPCTSTR lpszItem2);
Parameters
lpszItem1
[in] The first string to compare.
lpszItem2
[in] The second string to compare.
Return Value
A value that indicates the case-sensitive lexicographic relationship between the strings. The following table lists the possible values:
| Value | Description |
|---|---|
| <0 | The first string is less than the second. |
| 0 | The first string equals the second. |
| >0 | The first string is greater than the second. |
Remarks
Override this method to change how items are sorted in the list box.
The comparison is case-sensitive.
This method is called only from the AddSortedItem method.
CMFCToolBarComboBoxButton::CopyFrom
Copies the state of the specified CMFCToolBarComboBoxButton to the current object.
virtual void CopyFrom(const CMFCToolBarButton& src);
Parameters
src
[in] The source CMFCToolBarComboBoxButton object.
CMFCToolBarComboBoxButton::CreateCombo
Creates a new combo box for the combo box button.
virtual CComboBox* CreateCombo(
CWnd* pWndParent,
const CRect& rect);
Parameters
pWndParent
[in] A pointer to the parent window of the button.
rect
[in] Bounding rectangle of the combo box.
Return Value
A pointer to the new combo box if the method was successful; otherwise, NULL.
CMFCToolBarComboBoxButton::CreateEdit
Creates a new edit box for the combo box button.
virtual CMFCToolBarComboBoxEdit* CreateEdit(
CWnd* pWndParent,
const CRect& rect,
DWORD dwEditStyle);
Parameters
pWndParent
[in] A pointer to the parent window of the button.
rect
[in] Bounding rectangle of the new edit box.
dwEditStyle
[in] Control style of the new edit box.
Return Value
A pointer to the new edit box if the method was successful; otherwise, NULL.
Remarks
The framework calls this method when it creates a new edit box for a combo box button. Override this method to change how CMFCToolBarComboBoxEdit is created.
CMFCToolBarComboBoxButton::DeleteItem
Deletes a specified item from the list box.
BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);
Parameters
iIndex
[in] The zero-based index of the item to be deleted.
dwData
[in] The data associated with the item to be deleted.
lpszText
[in] The text of the item to be deleted. If there are multiple items with the same text, the first item is deleted.
Return Value
TRUE if the item was located and successfully deleted; otherwise, FALSE.
Remarks
CMFCToolBarComboBoxButton::DuplicateData
Duplicates user-defined data.
virtual void DuplicateData();
Remarks
By default this method does nothing. Override this method in a derived class if you want to copy any user-defined data.
CMFCToolBarComboBoxButton::EnableWindow
Enables or disables the edit and combo boxes.
virtual void EnableWindow(BOOL bEnable = TRUE);
Parameters
bEnable
[in] TRUE to enable the edit and combo boxes; FALSE to disable the edit and combo boxes.
Remarks
When disabled, the controls cannot become active and cannot accept user input.
CMFCToolBarComboBoxButton::ExportToMenuButton
Copies a string from the application string table to the specified menu using the combo box button command ID.
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
Parameters
menuButton
[out] Reference to a menu button.
Return Value
Always TRUE.
CMFCToolBarComboBoxButton::FindItem
Returns the index of the first item in the list box that contains a specified string.
int FindItem(LPCTSTR lpszText) const;
Parameters
lpszText
[in] The text for which to search in the list box.
Return Value
The index of the item; or CB_ERR if the item is not found.
Remarks
CMFCToolBarComboBoxButton::GetByCmd
Gets a pointer to the combo box button that has a specified command ID.
static CMFCToolBarComboBoxButton* GetByCmd(
UINT uiCmd,
BOOL bIsFocus=FALSE);
Parameters
uiCmd
[in] The command ID of a combo box button.
bIsFocus
[in] TRUE to search only focused buttons; FALSE to search all buttons.
Return Value
A pointer to a combo box button; or NULL if the button is not found.
Remarks
CMFCToolBarComboBoxButton::GetComboBox
Returns a pointer to the combo box in the combo box button.
CComboBox* GetComboBox() const;
Return Value
A pointer to the CComboBox Class object if the method was successful; otherwise NULL.
Remarks
CMFCToolBarComboBoxButton::GetContextMenuID
Gets the shortcut menu resource ID for the combo box button.
UINT GetContextMenuID();
Return Value
The shortcut menu resource ID.
CMFCToolBarComboBoxButton::GetCount
Returns the number of items in the list box.
INT_PTR GetCount() const;
Return Value
The number of items in the list box.
Remarks
CMFCToolBarComboBoxButton::GetCountAll
Gets the number of items in the list box of a combo box button that has a specified command ID.
static int GetCountAll(UINT uiCmd);
Parameters
uiCmd
[in] The command ID of a combo box button.
Return Value
The number of items in the list box; otherwise, CB_ERR if the combo box button is not found.
Remarks
CMFCToolBarComboBoxButton::GetCurSel
Gets the index of the currently selected item in the list box.
int GetCurSel() const;
Return Value
The index of the currently selected item in the list box; or CB_ERR if no item is selected.
Remarks
The list box index is zero-based.
CMFCToolBarComboBoxButton::GetCurSelAll
Returns the index of the currently selected item in the list box of a combo box button that has a specified command ID.
static int GetCurSelAll(UINT uiCmd);
Parameters
uiCmd
[in] The command ID of a combo box button.
Return Value
The index of the currently selected item in the list box; otherwise, CB_ERR if no item is selected or a combo box button is not found.
Remarks
The list box index is zero-based.
CMFCToolBarComboBoxButton::GetEditCtrl
Returns a pointer to the edit box in the combo box button.
virtual CEdit* GetEditCtrl();
Return Value
A pointer to the edit box if the method was successful; otherwise, NULL.
Remarks
CMFCToolBarComboBoxButton::GetHwnd
Returns the window handle for the combo box.
virtual HWND GetHwnd();
Return Value
The window handle, or NULL if the combo box is not associated with a window object.
CMFCToolBarComboBoxButton::GetItem
Returns the string associated with an item at a specified index in the list box.
LPCTSTR GetItem(int iIndex=-1) const;
Parameters
iIndex
[in] Zero-based index of an item in the list box.
Return Value
A pointer to the string that is associated with the item; otherwise, NULL if the index parameter is invalid, or if the index parameter is -1 and there is no selected item in the combo box.
Remarks
An index parameter of -1 returns the string of the item that is currently selected.
CMFCToolBarComboBoxButton::GetItemAll
Returns the string associated with an item at a specified index in the list box of a combo box button that has a specified command ID.
static LPCTSTR GetItemAll(
UINT uiCmd,
int iIndex=-1);
Parameters
uiCmd
[in] The command ID of a combo box button.
iIndex
[in] The zero-based index of an item in the list box.
Return Value
A pointer to the item's string if the method was successful; otherwise, NULL if the index is invalid, a combo box button is not found, or if index is -1 and there is no selected item in the combo box.
Remarks
An index value of -1 returns the string of the item that is currently selected.
CMFCToolBarComboBoxButton::GetItemData
Returns the data associated with an item at a specific index in the list box.
DWORD_PTR GetItemData(int iIndex=-1) const;
Parameters
iIndex
[in] The zero-based index of an item in the list box.
Return Value
The data associated with the item; or 0 if the item does not exist.
Remarks
An index parameter of -1 returns the data associated with the currently selected item.
CMFCToolBarComboBoxButton::GetItemDataAll
Returns the data associated with an item at a specific index in the list box of a combo box button that has a specific command ID.
static DWORD_PTR GetItemDataAll(
UINT uiCmd,
int iIndex=-1);
Parameters
uiCmd
[in] The command ID of a combo box button.
iIndex
[in] The zero-based index of an item in the list box.
Return Value
The data associated with the item if the method was successful; otherwise, 0 if the specified index is not valid, or CB_ERR if the combo box button is not found.
Remarks
An index parameter of -1 returns the data associated with the currently selected item.
CMFCToolBarComboBoxButton::GetItemDataPtrAll
Returns the data associated with an item at a specific index in the list box of a combo box button that has a specific command ID. This data is returned as a pointer.
static void* GetItemDataPtrAll(
UINT uiCmd,
int iIndex=-1);
Parameters
uiCmd
[in] The command ID of the combo box button.
iIndex
[in] The zero-based index of an item in the list box.
Return Value
A pointer associated with the item if the method was successful; otherwise, -1 if an error occurs, or NULL if the combo box button is not found.
Remarks
CMFCToolBarComboBoxButton::GetPrompt
Returns the prompt string for the combo box button.
virtual CString GetPrompt() const;
Return Value
The prompt string.
Remarks
This method is currently not implemented.
CMFCToolBarComboBoxButton::GetText
Gets the text in the edit box.
LPCTSTR GetText() const;
Return Value
The text in the edit box.
Remarks
CMFCToolBarComboBoxButton::GetTextAll
Gets the text in the edit box of a combo box button that has a specified command ID.
static LPCTSTR GetTextAll(UINT uiCmd);
Parameters
uiCmd
[in] The command ID of a specific combo box button.
Return Value
The text in the edit box if the method was successful; otherwise, NULL.
Remarks
CMFCToolBarComboBoxButton::HasFocus
Indicates whether the combo box currently has the focus.
virtual BOOL HasFocus() const;
Return Value
TRUE if the combo box currently has the focus; otherwise, FALSE.
Remarks
This method also returns TRUE if any child window of the combo box currently has the focus.
CMFCToolBarComboBoxButton::IsCenterVert
Returns the vertical position of combo box buttons in the application.
static BOOL IsCenterVert();
Return Value
TRUE if the buttons are centered; FALSE if the buttons are aligned at the top.
Remarks
CMFCToolBarComboBoxButton::IsFlatMode
Returns the flat style appearance of combo box buttons in the application.
static BOOL IsFlatMode();
Return Value
TRUE if the buttons have a flat style; otherwise, FALSE.
Remarks
The default flat style for combo box buttons is FALSE.
CMFCToolBarComboBoxButton::IsOwnerOf
Indicates whether the specified handle is associated with the combo box button, or one of its children.
virtual BOOL IsOwnerOf(HWND hwnd);
Parameters
hwnd
[in] A window handle.
Return Value
TRUE if the handle is assocated with the combo box button, or one of its children; otherwise, FALSE.
CMFCToolBarComboBoxButton::IsRibbonButton
Indicates whether the combo box button resides on a ribbon panel.
BOOL IsRibbonButton() const;
Return Value
Always FALSE.
Remarks
By default, this method always returns FALSE, which means the combo box button is never displayed on a ribbon panel.
CMFCToolBarComboBoxButton::IsWindowVisible
Returns the visibility state of the combo box button.
virtual BOOL IsWindowVisible();
Return Value
The visibility state of the combo box button.
CMFCToolBarComboBoxButton::NotifyCommand
Indicates whether the combo box button processes the message.
virtual BOOL NotifyCommand(int iNotifyCode);
Parameters
iNotifyCode
[in] The notification message that is associated with the command.
Return Value
Whether the combo box button processes the message.
CMFCToolBarComboBoxButton::OnAddToCustomizePage
Called by the framework when the button is added to the Customize dialog box.
virtual void OnAddToCustomizePage();
CMFCToolBarComboBoxButton::OnCalculateSize
Called by the framework to calculate the size of the button.
virtual SIZE OnCalculateSize(
CDC* pDC,
const CSize& sizeDefault,
BOOL bHorz);
Parameters
pDC
[in] The device context that displays the combo box button.
sizeDefault
[in] The default size of the combo box button.
bHorz
[in] The dock state of the parent toolbar. TRUE when the toolbar is docked horizontally and FALSE when the toolbar is docked vertically.
Return Value
A SIZE structure that contains the dimensions of the combo box button, in pixels.
CMFCToolBarComboBoxButton::OnChangeParentWnd
Called by the framework when the combo box button is inserted into a new toolbar.
virtual void OnChangeParentWnd(CWnd* pWndParent);
Parameters
pWndParent
[in] Pointer to the new parent toolbar.
CMFCToolBarComboBoxButton::OnClick
Called by the framework when the user clicks the combo box button.
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay = TRUE);
Parameters
pWnd
[in] Pointer to the parent window of the combo box button.
bDelay
[in] Reserved for use in a derived class.
Return Value
TRUE if the method handles the event; otherwise, FALSE.
CMFCToolBarComboBoxButton::OnCtlColor
Called by the framework when the user changes the parent toolbar color to set the combo box button color.
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
Parameters
pDC
[in] The device context that displays the combo box button.
nCtlColor
[in] Unused.
Return Value
Handle to the brush that the framework uses to paint the background of the combo box button.
Remarks
This method also sets the combo box button text color.
CMFCToolBarComboBoxButton::OnDraw
Called by the framework to draw the combo box button by using the specified styles and options.
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);
Parameters
Pdc
[in] The device context that displays the button.
rect
[in] The bounding rectangle of the button.
pImages
[in] The collection of images that is associated with the button.
bHorz
[in] The dock state of the parent toolbar. TRUE when the toolbar is docked horizontally and FALSE when the toolbar is docked vertically.
bCustomizeMode
[in] Whether the application is in customization mode.
bHighlight
[in] Whether to draw the combo box button highlighted.
bDrawBorder
[in] Whether to draw the combo box button with a border.
bGrayDisabledButtons
[in] TRUE to draw shaded disabled buttons; FALSE to use the disabled images collection.
CMFCToolBarComboBoxButton::OnDrawOnCustomizeList
Called by the framework to draw the combo box button in the Commands pane of the Customize dialog box.
virtual int OnDrawOnCustomizeList(
CDC* pDC,
const CRect& rect,
BOOL bSelected);
Parameters
pDC
[in] The device context that displays the combo box button.
rect
[in] The bounding rectangle of the combo box button.
bSelected
[in] TRUE if the combo box button is selected; otherwise, FALSE.
Return Value
The width, in pixels, of the combo box button.
CMFCToolBarComboBoxButton::OnGlobalFontsChanged
Called by the framework to set the combo box button font when the application font changes.
virtual void OnGlobalFontsChanged();
CMFCToolBarComboBoxButton::OnMove
Called by the framework to change the location of the combo box button when the parent toolbar moves.
virtual void OnMove();
CMFCToolBarComboBoxButton::OnShow
Called by the framework when the combo box button is hidden or displayed.
virtual void OnShow(BOOL bShow);
Parameters
bShow
[in] Whether to hide or display the combo box button.
CMFCToolBarComboBoxButton::OnSize
Called by the framework to change the size of the combo box button when the parent toolbar changes size.
virtual void OnSize(int iSize);
Parameters
iSize
[in] The new width of the combo box button.
CMFCToolBarComboBoxButton::OnUpdateToolTip
Called by the framework when the user changes the tool tip for the combo box button.
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
Parameters
pWndParent
[in] Pointer to the parent window for the combo box button.
iButtonIndex
[in] ID of the combo box button.
wndToolTip
[in] The tool tip to associate with the combo box button.
str
[in] The tool tip text.
Return Value
TRUE if the method handles the event; otherwise, FALSE.
CMFCToolBarComboBoxButton::RemoveAllItems
Deletes all items from the list and edit boxes.
void RemoveAllItems();
Remarks
Removes all items from the list box and edit control of a combo box.
CMFCToolBarComboBoxButton::SelectItem
Selects an item in the list box.
BOOL SelectItem(
int iIndex,
BOOL bNotify=TRUE);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Parameters
iIndex
[in] The zero-based index of an item in the list box.
bNotify
[in] TRUE to notify the combo box button of the selection; otherwise FALSE.
dwData
[in] The data associated with an item in the list box.
lpszText
[in] The text of an item in the list box.
Return Value
TRUE if the method was successful; otherwise FALSE.
Remarks
CMFCToolBarComboBoxButton::SelectItemAll
Selects an item in the list box of a combo box button that has a specified command ID.
static BOOL SelectItemAll(
UINT uiCmd,
int iIndex);
static BOOL SelectItemAll(
UINT uiCmd,
DWORD_PTR dwData);
static BOOL SelectItemAll(
UINT uiCmd,
LPCTSTR lpszText);
Parameters
uiCmd
[in] The command ID of the combo box button that contains the list box.
iIndex
[in] The zero-based index of the item in the list box. A value of -1 removes any current selection in the list box and clears the edit box.
dwData
[in] The data of an item in the list box.
lpszText
[in] The text of an item in the list box.
Return Value
TRUE if the method was successful; otherwise FALSE.
Remarks
CMFCToolBarComboBoxButton::Serialize
Reads this object from an archive or writes it to an archive.
virtual void Serialize(CArchive& ar);
Parameters
ar
[in, out] The CArchive object to serialize.
Remarks
Settings in the CArchive object determine whether this method reads or writes to the archive.
CMFCToolBarComboBoxButton::SetACCData
Populates the specified CAccessibilityData object by using accessibility data from the combo box button.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parameters
pParent
[in] The parent window of the combo box button.
data
[out] A CAccessibilityData object that receives the accessibility data from the combo box button.
Return Value
TRUE if the method was successful; otherwise FALSE.
CMFCToolBarComboBoxButton::SetCenterVert
Sets the vertical position of combo box buttons in the application.
static void SetCenterVert(BOOL bCenterVert=TRUE);
Parameters
bCenterVert
[in] TRUE to center the combo box button in the toolbar; FALSE to align the combo box button to the top of the toolbar.
Remarks
By default, combo box buttons are aligned to the top.
CMFCToolBarComboBoxButton::SetContextMenuID
Sets the shortcut menu resource ID for the combo box button.
void SetContextMenuID(UINT uiResID);
Parameters
uiResID
[in] The shortcut menu resource ID.
CMFCToolBarComboBoxButton::SetDropDownHeight
Sets the height of the list box when it is dropped down.
void SetDropDownHeight(int nHeight);
Parameters
nHeight
[in] The height, in pixels, of the list box.
Remarks
The default height is 150 pixels.
CMFCToolBarComboBoxButton::SetFlatMode
Sets the flat style appearance of combo box buttons in the application.
static void SetFlatMode(BOOL bFlat=TRUE);
Parameters
bFlat
[in] TRUE for a flat style appearance; otherwise FALSE.
Remarks
The default flat style for combo box buttons is FALSE.
CMFCToolBarComboBoxButton::SetStyle
Sets the specified style for the combo box button and redraws the control if it is not disabled.
virtual void SetStyle(UINT nStyle);
Parameters
nStyle
[in] A bitwise combination (OR) of toolbar styles.
Remarks
For a list of toolbar button styles see ToolBar Control Styles
CMFCToolBarComboBoxButton::SetText
Sets the text in the edit box of the combo box button.
void SetText(LPCTSTR lpszText);
Parameters
lpszText
[in] Pointer to a string that contains the text for the edit box.
See also
Hierarchy Chart
Classes
CMFCToolBarButton Class
CComboBox Class
CMFCToolBar::ReplaceButton
Walkthrough: Putting Controls On Toolbars
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for