CMFCPropertyGridFontProperty 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 CMFCPropertyGridFontProperty Class.

The CMFCPropertyGridFileProperty class supports a property list control item that opens a font selection dialog box.

class CMFCPropertyGridFontProperty : public CMFCPropertyGridProperty  

Public Constructors

NameDescription
CMFCPropertyGridFontProperty::CMFCPropertyGridFontPropertyConstructs a CMFCPropertyGridFontProperty object.
CMFCPropertyGridFontProperty::~CMFCPropertyGridFontPropertyDestructor.

Public Methods

NameDescription
CMFCPropertyGridFontProperty::FormatPropertyFormats the text representation of a property value. (Overrides CMFCPropertyGridProperty::FormatProperty.)
CMFCPropertyGridFontProperty::GetColorRetrieves the font color that the user selects from the font dialog box.
CMFCPropertyGridFontProperty::GetLogFontRetrieves the font that the user selects from the font dialog box.
CMFCPropertyGridFontProperty::GetThisClassUsed by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type.
CMFCPropertyGridFontProperty::OnClickButtonCalled by the framework when the user clicks a button that is contained in a property. (Overrides CMFCPropertyGridProperty::OnClickButton.)

CObject

CMFCPropertyGridProperty

CMFCPropertyGridFontProperty

Header: afxpropertygridctrl.h

Constructs a CMFCPropertyGridFontProperty object.

CMFCPropertyGridFontProperty(
    const CString& strName,  
    LOGFONT& lf,  
    DWORD dwFontDialogFlags = CF_EFFECTS | CF_SCREENFONTS,  
    LPCTSTR lpszDescr = NULL,  
    DWORD_PTR dwData = 0,  
    COLORREF color = (COLORREF)-1);

Parameters

[in] strName
The name of the property.

[in] lf
A logical font structure that specifies the attributes of the font.

[in] dwFontDialogFlags
Styles that are applied to the font dialog box that is displayed when you click the property value drop-down button. The default value is the bitwise combination (OR) of CF_EFFECTS and CF_SCREENFONTS. For more information, see the Flags parameter of the CHOOSEFONT Structure.

[in] lpszDescr
Description of the font property. The default value is NULL.

[in] dwData
Application-specific data, such as an integer or a pointer to other data that is associated with the property. The default value is 0.

[in] color
The color of the font. The default value is the default color.

Remarks

A CMFCPropertyGridFontProperty object represents a font property in a property grid font control.

Example

The following example demonstrates how construct an object of the CMFCPropertyGridFontProperty class. This example is part of the New Controls sample.

	// LOGFONT lf
	// CMFCPropertyGridProperty* pGroupFont
	pGroupFont->AddSubItem(new CMFCPropertyGridFontProperty(_T("Font"), lf, CF_EFFECTS | CF_SCREENFONTS, _T("Specifies the default font for the dialog")));

Retrieves the font color that the user selects from the font dialog box.

COLORREF GetColor() const;  

Return Value

An RGB color value that represents the selected font color.

Remarks

Retrieves the font that the user selects from the font dialog box.

LPLOGFONT GetLogFont();

Return Value

A pointer to a LOGFONT structure that describes the selected font.

Remarks

Hierarchy Chart
Classes
CMFCPropertyGridCtrl Class
CMFCPropertyGridProperty Class

Show: