CMFCPropertyGridProperty选件类

项目
03/01/2013

CMFCPropertyGridProperty 对象表示在属性中的列表项列表控件。

class CMFCPropertyGridProperty : public CObject

成员

公共构造函数

名称	说明
CMFCPropertyGridProperty::CMFCPropertyGridProperty	构造 CMFCPropertyGridProperty 对象。
CMFCPropertyGridProperty::~CMFCPropertyGridProperty	析构函数。

公共方法

名称	说明
CMFCPropertyGridProperty::AddOption	添加新列表项的属性列表控件。
CMFCPropertyGridProperty::AddSubItem	添加子项到属性。
CMFCPropertyGridProperty::AdjustButtonRect	调用父属性列表控件将告知属性调整嵌入式按钮的边框。
CMFCPropertyGridProperty::AdjustInPlaceEditRect	检索用于设置属性值文本框和选项旋转按钮控件的边界。
CMFCPropertyGridProperty::AllowEdit	使一个属性可编辑或只读。
CMFCPropertyGridProperty::CreateInPlaceEdit	调用由框架为属性创建一个可编辑的控件。
CMFCPropertyGridProperty::CreateSpinControl	调用由框架创建一个可编辑的旋转按钮控件。
CMFCPropertyGridProperty::Enable	启用或禁用属性。
CMFCPropertyGridProperty::EnableSpinControl	启用或禁用用于修改属性值的旋转按钮控件。
CMFCPropertyGridProperty::Expand	展开或折叠包含子属性的属性。
CMFCPropertyGridProperty::FormatProperty	设置属性值的文本表示形式。
CMFCPropertyGridProperty::GetData	检索与属性的 DWORD 值。
CMFCPropertyGridProperty::GetDescription	检索属性声明。
CMFCPropertyGridProperty::GetExpandedSubItems	检索扩展的子项的数目。
CMFCPropertyGridProperty::GetHierarchyLevel	检索属性的层次结构级别的从零开始的索引。
CMFCPropertyGridProperty::GetName	检索属性的名称。
CMFCPropertyGridProperty::GetNameTooltip	调用由结构显示特性的名称在工具提示中。
CMFCPropertyGridProperty::GetOption	检索由索引指定选项的文本。
CMFCPropertyGridProperty::GetOptionCount	检索属于属性的选项卡数。
CMFCPropertyGridProperty::GetOriginalValue	检索当前属性的初始值。
CMFCPropertyGridProperty::GetParent	检索指向父属性。
CMFCPropertyGridProperty::GetRect	检索属性的边框。
CMFCPropertyGridProperty::GetSubItem	检索从零开始的索引确定的子属性。
CMFCPropertyGridProperty::GetSubItemsCount	检索子项的数目。
CMFCPropertyGridProperty::GetThisClass	用于由框架获取指向与此选件类类型的 CRuntimeClass 对象。
CMFCPropertyGridProperty::GetValue	检索属性值。
CMFCPropertyGridProperty::GetValueTooltip	调用由框架检索在工具提示并显示属性值的文本表示形式。
CMFCPropertyGridProperty::HitTest	指向该属性与属性对应的列表项对应于所指向的对象。
CMFCPropertyGridProperty::IsAllowEdit	指示属性是否可编辑。
CMFCPropertyGridProperty::IsEnabled	指示属性是否启用或禁用。
CMFCPropertyGridProperty::IsExpanded	指示属性是否展开或折叠。
CMFCPropertyGridProperty::IsGroup	指示当前属性是否表示组。
CMFCPropertyGridProperty::IsInPlaceEditing	指示当前属性是否可编辑。
CMFCPropertyGridProperty::IsModified	指示是否修改当前属性。
CMFCPropertyGridProperty::IsParentExpanded	指示当前属性的父是否展开。
CMFCPropertyGridProperty::IsSelected	指示当前属性是否已选中。
CMFCPropertyGridProperty::IsVisible	指示当前属性是否可见。
CMFCPropertyGridProperty::OnClickButton	调用由结构，当用户单击属性包含的按钮。
CMFCPropertyGridProperty::OnClickName	当用户单击属性时，的名称字段调用由父属性列表控件。
CMFCPropertyGridProperty::OnClickValue	当用户单击属性的值时，字段调用由父属性列表控件。
CMFCPropertyGridProperty::OnCloseCombo	调用由结构，在属性中包含的组合框已关闭。
CMFCPropertyGridProperty::OnDblClk	调用由结构，当用户双击属性。
CMFCPropertyGridProperty::OnDrawButton	调用由框架是在属性中包含的按钮。
CMFCPropertyGridProperty::OnDrawDescription	调用由结构显示属性声明。
CMFCPropertyGridProperty::OnDrawExpandBox	调用由框架在包含子属性的特性周围绘制展开框控件。
CMFCPropertyGridProperty::OnDrawName	调用由结构显示属性名称。
CMFCPropertyGridProperty::OnDrawValue	调用由结构显示属性值。
CMFCPropertyGridProperty::OnEdit	调用由结构，当用户将修改属性值。
CMFCPropertyGridProperty::OnEndEdit	调用由结构，当用户书写修改属性值。
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName	调用由结构，当用户在属性名称区上单击鼠标右键。
CMFCPropertyGridProperty::OnRClickValue	调用由结构，当用户在属性值区上单击鼠标右键。
CMFCPropertyGridProperty::OnSelectCombo	调用由结构，当用户选择一个项目。可编辑的组合框。
CMFCPropertyGridProperty::OnSetCursor	调用由结构，当鼠标指针移动到属性项。
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue	调用由结构，在一个可编辑属性的值已更改。
CMFCPropertyGridProperty::PushChar	调用从属性列表控件，当属性后，并且用户输入新的字符。
CMFCPropertyGridProperty::Redraw	重绘属性。
CMFCPropertyGridProperty::RemoveAllOptions	从属性中移除所有选项(项目）。
CMFCPropertyGridProperty::RemoveSubItem	移除指定的子项。
CMFCPropertyGridProperty::ResetOriginalValue	还原一个编辑属性的初始值。
CMFCPropertyGridProperty::SetData	关联 DWORD 值与属性。
CMFCPropertyGridProperty::SetDescription	指定用于描述当前属性的文本。
CMFCPropertyGridProperty::SetName	设置属性的名称。
CMFCPropertyGridProperty::SetOriginalValue	设置一个可编辑属性的初始值。
CMFCPropertyGridProperty::SetValue	设置属性网格属性的值。
CMFCPropertyGridProperty::Show	显示或隐藏属性。

受保护的方法

名称	说明
CMFCPropertyGridProperty::CreateCombo	调用由框架添加一个组合框添加到属性。
CMFCPropertyGridProperty::HasButton	指示属性是否包含一个按钮。
CMFCPropertyGridProperty::Init	调用framework初始化属性对象。
CMFCPropertyGridProperty::IsSubItem	指示指定的属性是当前属性的子项。
CMFCPropertyGridProperty::IsValueChanged	指示当前属性的值是否已更改。
CMFCPropertyGridProperty::OnCtlColor	调用由框架，则必须检索画笔填充属性的背景色。
CMFCPropertyGridProperty::OnDestroyWindow	由框架调用，当销毁时"，或者编辑完成。
CMFCPropertyGridProperty::OnKillFocus	调用由结构，当属性失去输入焦点。

数据成员

名称	说明
CMFCPropertyGridProperty::m_strFormatDouble	格式化类型双精度型值的字符串。
CMFCPropertyGridProperty::m_strFormatFloat	格式化类型浮点值的字符串。
CMFCPropertyGridProperty::m_strFormatLong	长格式类型的值的字符串。
CMFCPropertyGridProperty::m_strFormatShort	短格式类型的值的字符串。

备注

使用一 CMFCPropertyGridProperty 对象表示属性，然后添加到属性列表控件。有关更多信息，请参见 CMFCPropertyGridCtrl选件类。

属性对象可以表示数据类型(如字符串、日期和布尔值或整数值。它可以包含子属性，或者可以包含控件(如组合框或按钮控件。

示例

下面的示例演示如何构造 CMFCPropertyGridProperty 对象。示例在 CMFCPropertyGridProperty 选件类还演示如何使用各种方法添加选项卡中，将子项，启用属性并显示属性。此示例是新的控件示例的一部分。

    CMFCPropertyGridProperty* pGroup1 = new CMFCPropertyGridProperty(_T("Appearance"));

    // construct a COleVariant object. 
    COleVariant var3DLook((short)VARIANT_FALSE, VT_BOOL);

    pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("3D Look"), var3DLook, 
        _T("Specifies the dialog's font will be nonbold and controls will have a 3D border")));

    CMFCPropertyGridProperty* pProp = new CMFCPropertyGridProperty(_T("Border"),
        _T("Dialog Frame"), _T("One of: None, Thin, Resizable, or Dialog Frame"));
    pProp->AddOption(_T("None"));
    pProp->AddOption(_T("Thin"));
    pProp->AddOption(_T("Resizable"));
    pProp->AddOption(_T("Dialog Frame"));
    pProp->AllowEdit(FALSE);

    pGroup1->AddSubItem(pProp);
    pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("Caption"), (COleVariant) _T("About NewControlsDemo"), _T("Specifies the text that will be displayed in the dialog's title bar")));
    pGroup1->AdjustButtonRect();
    pGroup1->AllowEdit();
    pGroup1->Enable();
    pGroup1->Show();
    pGroup1->Redraw();