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.

Syntax

class CMFCToolBarFontSizeComboBox : public CMFCToolBarComboBoxButton  

Members

Protected Constructors

Name	Description
CMFCToolBarFontSizeComboBox::CMFCToolBarFontSizeComboBox	Constructs a CMFCToolBarFontSizeComboBox object.

Public Methods

Name	Description
CMFCToolBarFontSizeComboBox::GetTwipSize	Returns the selected font size in twips.
CMFCToolBarFontSizeComboBox::RebuildFontSizes	Fills the combo box list with all supported font sizes for a specified font.
CMFCToolBarFontSizeComboBox::SetTwipSize	Sets the font size in twips.

Remarks

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.

Example

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);
    }

Inheritance Hierarchy

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

CMFCToolBarFontSizeComboBox

Requirements

Header: afxtoolbarfontcombobox.h

CMFCToolBarFontSizeComboBox::CMFCToolBarFontSizeComboBox

Constructs a CMFCToolBarFontSizeComboBox object.

CMFCToolBarFontSizeComboBox();

CMFCToolBarFontSizeComboBox::GetTwipSize

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.

CMFCToolBarFontSizeComboBox::RebuildFontSizes

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.

CMFCToolBarFontSizeComboBox::SetTwipSize

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.

See Also

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