CMFCToolBarFontSizeComboBox Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CMFCToolBarFontSizeComboBox Class.

A toolbar button that contains a combo box control that enables the user to select a font size.

class CMFCToolBarFontSizeComboBox : public CMFCToolBarComboBoxButton  

Protected Constructors

NameDescription
CMFCToolBarFontSizeComboBox::CMFCToolBarFontSizeComboBoxConstructs a CMFCToolBarFontSizeComboBox object.

Public Methods

NameDescription
CMFCToolBarFontSizeComboBox::GetTwipSizeReturns the selected font size in twips.
CMFCToolBarFontSizeComboBox::RebuildFontSizesFills the combo box list with all supported font sizes for a specified font.
CMFCToolBarFontSizeComboBox::SetTwipSizeSets the font size in twips.

You can use a CMFCToolBarFontSizeComboBox object together with a CMFCToolBarFontComboBox Class object to enable a user to select a font and font size.

You can add a font size combo box button to a toolbar just as you add a font combo box button. For more information, see CMFCToolBarFontComboBox Class.

When the user selects a new font in a CMFCToolBarFontComboBox object, you can fill the font size combo box with the supported sizes for that font by using the CMFCToolBarFontSizeComboBox::RebuildFontSizes method.

The following example demonstrates how to use various methods in the CMFCToolBarFontSizeComboBox class to configure a CMFCToolBarFontSizeComboBox object. The example illustrates how to retrieve the font size, in twips, from the text box, fill the font size combo box with all valid sizes of the given font, and specify the font size in twips. This code snippet is part of the Word Pad sample.

	CMFCToolBarFontSizeComboBox* pSizeCombo =
		DYNAMIC_DOWNCAST (CMFCToolBarFontSizeComboBox, CMFCToolBarFontSizeComboBox::GetByCmd (IDC_FONTSIZE));
	if (pSizeCombo != NULL)
	{
		int nSize = pSizeCombo->GetTwipSize();
		// CMFCFontInfo* pDesc
		pSizeCombo->RebuildFontSizes (pDesc->m_strName);
		pSizeCombo->SetTwipSize (nSize);
	}

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

CMFCToolBarFontSizeComboBox

Header: afxtoolbarfontcombobox.h

Constructs a CMFCToolBarFontSizeComboBox object.

CMFCToolBarFontSizeComboBox();

Retrieves the font size, in twips, from the text box of a font size combo box.

int GetTwipSize() const;  

Return Value

If the return value is positive, it is the font size in twips. It is -1 if the text box of the combo box is empty. It is -2 if an error occurs.

Fills a font size combo box with all valid sizes of the given font.

void RebuildFontSizes(const CString& strFontName);

Parameters

[in] strFontName
Specifies a font name.

Remarks

Call this function when you want to synchronize between selection in a font combo box and a font size combo box, such as a CMFCToolBarFontComboBox Class.

Rounds the specified size (in twips) to the nearest size in points, and then sets the selected size in the combo box to that value.

void SetTwipSize(int nSize);

Parameters

[in] nSize
Specifies the font size (in twips) to set.

Remarks

You can retrieve the previous valid font size later by calling the CMFCToolBarFontSizeComboBox::GetTwipSize method.

Hierarchy Chart
Classes
CMFCToolBar Class
CMFCToolBarButton Class
CMFCToolBarComboBoxButton Class
CMFCFontInfo Class
CMFCToolBar::ReplaceButton
Walkthrough: Putting Controls On Toolbars

Show: