CBCGPToolbarFontCombo

Detailed Description

The CBCGPToolbarFontCombo class provides the functionality that allows to place combo boxes with a list of fonts on toolbars, which were created using BCGControlBar Library framework.

To use font combo buttons in the application:

• Prepare a toolbar with a font selection command
• In CMainFrame::OnToolbarReset (BCGM_RESETTOOLBAR handler) construct a CBCGPToolbarFontCombo object and replace the font selection button with the new font combo button using CBCGPToolBar::ReplaceButton.
• Synchronize the font selected in the combo with the font in the document using the SetFont() member function
• Synchronize the document's font with the font selected in the combo using the GetFontDesc() member function and creating a CFont object according to the returned font attributes.

See also

CBCGPFontDesc, CBCGPToolBar, CBCGPToolbarButton, CBCGPToolbarComboBoxButton

Inheritance diagram for CBCGPToolbarFontCombo:

Public Member Functions
	CBCGPToolbarFontCombo	Constructs a CBCGPToolbarFontCombo object.
	GetFontDesc	Retrieves the font description (attributes) for the specified combo box item.
	SetFont	Selects a font in the font combo according to the font name and character set.
Public Member Functions inherited from CBCGPToolbarComboBoxButton
	CBCGPToolbarComboBoxButton	Constructs a CBCGPToolbarComboBoxButton.
	AddItem	Adds an item at the end of the list in the list box of a combo box.
	AddSortedItem	Adds a new item sorted in a specific order to the list box of combo.
	Compare	Called by the framework, when it needs to compare two items inserted by AddSortedItems().
	CreateEdit	Called by the framework when it needs to create a new edit control for combo box button.
	DeleteItem	Deletes an item for the combo box.
	DeleteItem	Deletes an item for the combo box.
	DeleteItem	Deletes an item for the combo box.
	FindItem	Looks for an item in the list box part of combo box.
	FindItemData	Looks for an item with specified data in the list box part of combo box.
	GetComboBox	Returns a pointer to the button's combo box control.
	GetCount	Retrieves the number of items in the list box of a combo box.
	GetCurSel	Retrieves the index of the currently selected item, if any, in the list box of a combo box.
	GetCustomFont	Retrieves control custom font.
	GetEditCtrl	Returns a pointer to the embedded edit control.
	GetItem	Gets the string associated with the specified item in a combo box.
	GetItemData	Retrieves the value associated with the specified item in a combo box.
	GetPrompt	Returns a prompt (displayed when the combo box text is empty).
	GetPromptColor	Retrieves the prompt color.
	GetText	Retrieves the text from the edit control of a combo box.
	RemoveAllItems	Removes all items from the list box and edit control of a combo box.
	SelectItem	Searches the list of items of a combo box button and selects one of them according to the specified index.
	SelectItem	Searches the list of items of a combo box button and selects one of them according to the specified value.
	SelectItem	Searches the list of items of a combo box button and selects one of them according to the specified string.
	SetCustomFont	Sets a custom font.
	SetDropDownHeight	Sets the new height of the dropdown list box of a combo box.
	SetPrompt	Sets a prompt displayed when the combo box text is empty.
Public Member Functions inherited from CBCGPToolbarButton
	CBCGPToolbarButton	Constructs and initializes a CBCGPToolbarButton object.
	CanBeDropped	Indicates whether a button can be dropped on a toolbar.
	GetImage	Returns a toolbar button's image.
	GetTextSize	Returns the size (in pixels) of the button text.
	HaveHotBorder	Determines whether a button displays the border in selected state or not.
	IsDrawImage	Tells whether a button's image is displayed.
	IsDrawText	Tells whether a button's text label is displayed.
	IsEditable	Tells whether a button is customizable or not.
	IsExtraSize	Determines whether the border's extra size should be taken into account.
	IsHidden	Tells whether a button is hidden or not.
	IsLocked	Returns a flag indicating whether a button belongs to the locked (non-customizable) toolbar and can't be customized (dragged, dropped or edited).
	IsOnGlass	Checks if button is located on DWM ("Glass") area of the parent toolbar.
	IsVisible	Determines whether a toolbar button is visible or not.
	OnBeforeDrag	Called by the framework before user begins to drag the button.
	OnBeforeDrop	Called by the framework before button is dropped on target.
	OnClickUp	Called by the framework when the user releases the toolbar button.
	OnContextHelp	Called by the framework when the parent toolbar processes the WM_HELPHITTEST message.
	OnDblClick	Called by the framework when the parent toolbar handles OnLButtonDblClk.
	OnGetCustomToolTipText	Called by the framework when it needs to display a tooltip for the toolbar button.
	OnToolHitTest	Called by the framework when the parent toolbar needs to determine whether a point is in the bounding rectangle of the specified tool.
	Rect	Returns a buttons' bounding rectangle.
	SetImage	Sets a button's image.
	SetRadio	Called by the framework when a button changes its check state.
	SetRect	Sets a new button's bounding rectangle.
	SetVisible	Shows or hides a toolbar button.
	Show	Makes a button visible or hidden.

Static Public Attributes
	m_nFontHeight	Specifies the height (ascent + descent) of characters of an item in the font combo box .
Static Public Attributes inherited from CBCGPToolbarButton
	m_bWrapText	If TRUE, enables multi-line text labels.

Additional Inherited Members
Static Public Member Functions inherited from CBCGPToolbarComboBoxButton
	GetByCmd	Given a command ID returns a pointer to a combo box button from the list of toolbar buttons.
	GetCountAll	Looks for a combo box button with the given command ID and retrieves the number of items in the list box of a combo box.
	GetCurSelAll	Looks for a combo box button with the given command ID and retrieves the index of the currently selected item, if any, in the list box of a combo box.
	GetItemAll	Looks for a combo box button with the given command ID and gets the string associated with the specified item a combo box.
	GetItemDataAll	Looks for a combo box button with the given command ID and retrieves the value associated with the specified item in a combo box.
	GetItemDataPtrAll	Looks for a combo box button with the given command ID and retrieves the value associated with the specified item in a combo box as a pointer.
	GetTextAll	Looks for a combo box button with the given command ID and retrieves the text from the edit control of a combo box.
	IsCenterVert	Tells whether the button is centered, or aligned at the top of toolbar.
	IsFlatMode	Tells whether the toolbar combo box buttons have the flat look.
	IsFullHeight	Tells whether the height of the combo box is the same as the height of other toolbar buttons.
	SelectItemAll	Looks for a combo box button with the given command ID and select one of a combo box items according to the specified index.
	SelectItemAll	Looks for a combo box button with the given command ID and select one of a combo box items according to the specified value.
	SelectItemAll	Looks for a combo box button with the given command ID and select one of a combo box items according to the specified string.
	SetCenterVert	Specifies whether the button should be centered vertically or aligned to the top of toolbar.
	SetFlatMode	Sets the flat look for the toolbar combo box buttons.
	SetFullHeight	Specifies whether the height of the combo box is the same as the height of other toolbar buttons.
Static Public Member Functions inherited from CBCGPToolbarButton
	GetProtectedCommands	Returns a reference to CList object, which contains a collection of commands that can't be customized by the user.
	SetProtectedCommands	Sets a list of protected commands.
Public Attributes inherited from CBCGPToolbarButton
	m_bImage	Indicates whether the image of the toolbar button is displayed or not.
	m_bText	Indicates whether the text label of the toolbar button is displayed or not.
	m_bTextBelow	Indicates whether the button's text label is displayed below the image.
	m_bUserButton	Indicates whether a button has the user-defined image (TRUE) or not (FALSE).
	m_bWholeText	Indicates whether a button displays full text label (TRUE), or clips the text and replace the rest by "..." if the text doesn't fit to the bounding rectangle.
	m_bWrap	If this flag is TRUE for a separator, the next to the separator button will be placed on the next row.
	m_nID	Contains the command ID of a button.
	m_nStyle	Contains the style of a toolbar button.
	m_strText	Contains the text label of a button.