CMFCPropertyGridProperty Class

Artículo
06/10/2015

Un objeto de CMFCPropertyGridProperty representa un elemento de un control de lista de propiedades.

class CMFCPropertyGridProperty : public CObject

Members

Constructores públicos

Name	Descripción
CMFCPropertyGridProperty::CMFCPropertyGridProperty	Crea un objeto CMFCPropertyGridProperty.
CMFCPropertyGridProperty::~CMFCPropertyGridProperty	Un destructor.

Métodos públicos

Name	Descripción
CMFCPropertyGridProperty::AddOption	Agrega un nuevo elemento de lista a un control de lista de propiedades.
CMFCPropertyGridProperty::AddSubItem	agrega un elemento secundario a una propiedad.
CMFCPropertyGridProperty::AdjustButtonRect	Llamado por el control de lista de la propiedad parent para indicar a una propiedad que cambie el tamaño del rectángulo delimitador de un botón incrustado.
CMFCPropertyGridProperty::AdjustInPlaceEditRect	Recupera los límites del cuadro de texto y el control de botón opcional de giro que se utilizan para establecer un valor de propiedad.
CMFCPropertyGridProperty::AllowEdit	Crea una propiedad modificable o de sólo lectura.
CMFCPropertyGridProperty::CreateInPlaceEdit	Llamado por el marco para crear un control modificable para una propiedad.
CMFCPropertyGridProperty::CreateSpinControl	Llamado por el marco para crear un control de botón modificable de número.
CMFCPropertyGridProperty::Enable	Habilita o deshabilita una propiedad.
CMFCPropertyGridProperty::EnableSpinControl	Habilita o deshabilita un control de botón de giro que se utiliza para modificar un valor de propiedad.
CMFCPropertyGridProperty::Expand	Expande o contrae una propiedad que contiene sub- propiedades.
CMFCPropertyGridProperty::FormatProperty	Da formato a la representación de texto de un valor de propiedad.
CMFCPropertyGridProperty::GetData	Recupera un valor de DWORD que está asociado a una propiedad.
CMFCPropertyGridProperty::GetDescription	recupera una descripción de la propiedad.
CMFCPropertyGridProperty::GetExpandedSubItems	Recupera el número de sub- elementos expandida.
CMFCPropertyGridProperty::GetHierarchyLevel	Recupera el índice de base cero del nivel de la jerarquía de la propiedad.
CMFCPropertyGridProperty::GetName	recupera el nombre de la propiedad.
CMFCPropertyGridProperty::GetNameTooltip	Llamado por el marco para mostrar el nombre de la propiedad en una información sobre herramientas.
CMFCPropertyGridProperty::GetOption	Recupera el texto de la opción especificada en un índice.
CMFCPropertyGridProperty::GetOptionCount	Recupera el número de opciones que pertenecen a una propiedad.
CMFCPropertyGridProperty::GetOriginalValue	Recupera el valor inicial de la propiedad actual.
CMFCPropertyGridProperty::GetParent	recupera un puntero a una propiedad parent.
CMFCPropertyGridProperty::GetRect	Recupera el rectángulo delimitador de una propiedad.
CMFCPropertyGridProperty::GetSubItem	Recupera una sub-propiedad identificada por un índice cero-basado.
CMFCPropertyGridProperty::GetSubItemsCount	recupera el número de sub-elementos.
CMFCPropertyGridProperty::GetThisClass	Utiliza el marco para obtener un puntero al objeto de Recursos que está asociado a este tipo de clase.
CMFCPropertyGridProperty::GetValue	recupera un valor de propiedad.
CMFCPropertyGridProperty::GetValueTooltip	Llamado por el marco para recuperar la representación de texto del valor de propiedad que se muestra en una información sobre herramientas.
CMFCPropertyGridProperty::HitTest	Señala la propiedad se oponen que corresponde al elemento de la lista de propiedades correspondiente a un punto.
CMFCPropertyGridProperty::IsAllowEdit	Indica si una propiedad se puede modificar.
CMFCPropertyGridProperty::IsEnabled	indica si una propiedad está habilitada o deshabilitada.
CMFCPropertyGridProperty::IsExpanded	Indica si una propiedad se expande o contrae.
CMFCPropertyGridProperty::IsGroup	Indica si la propiedad actual representa un grupo.
CMFCPropertyGridProperty::IsInPlaceEditing	Indica si la propiedad actual es modificable.
CMFCPropertyGridProperty::IsModified	indica si la propiedad actual está modificada.
CMFCPropertyGridProperty::IsParentExpanded	Indica si se expandieron elementos primarios de la propiedad actual.
CMFCPropertyGridProperty::IsSelected	Indica si la propiedad actual está seleccionada.
CMFCPropertyGridProperty::IsVisible	Indica si la propiedad actual está visible.
CMFCPropertyGridProperty::OnClickButton	Llamado por el marco cuando el usuario hace clic en un botón incluido en una propiedad.
CMFCPropertyGridProperty::OnClickName	Llamado por un control de lista de la propiedad parent cuando un usuario hace clic en el campo de nombre de una propiedad.
CMFCPropertyGridProperty::OnClickValue	Llamado por un control de lista de la propiedad parent cuando un usuario hace clic en el campo Valor de una propiedad.
CMFCPropertyGridProperty::OnCloseCombo	Llamado por el marco cuando se cierra un cuadro combinado de una propiedad.
CMFCPropertyGridProperty::OnDblClk	Llamado por el marco cuando hace doble clic del usuario una propiedad.
CMFCPropertyGridProperty::OnDrawButton	Llamado por el marco para dibujar un botón de una propiedad.
CMFCPropertyGridProperty::OnDrawDescription	Llamado por el marco para mostrar la descripción de la propiedad.
CMFCPropertyGridProperty::OnDrawExpandBox	Llamado por el marco para dibujar un control de cuadro de expandir cerca de una propiedad que contiene sub- propiedades.
CMFCPropertyGridProperty::OnDrawName	Llamado por el marco para mostrar el nombre de propiedad.
CMFCPropertyGridProperty::OnDrawValue	Llamado por el marco para mostrar el valor de propiedad.
CMFCPropertyGridProperty::OnEdit	Llamado por el marco cuando el usuario está a punto de modificar un valor de propiedad.
CMFCPropertyGridProperty::OnEndEdit	Llamado por el marco cuando el usuario ha finalizado que modifica un valor de propiedad.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName	Llamado por el marco cuando el usuario hace clic con el botón secundario del mouse en el área de nombre de propiedad.
CMFCPropertyGridProperty::OnRClickValue	Llamado por el marco cuando el usuario hace clic con el botón secundario del mouse en el área de valores de propiedad.
CMFCPropertyGridProperty::OnSelectCombo	Llamado por el marco cuando el usuario selecciona un elemento del cuadro combinado modificable.
CMFCPropertyGridProperty::OnSetCursor	Llamado por el marco cuando el puntero del mouse se mueve a un elemento de propiedad.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue	Llamado por el marco cuando el valor de una propiedad modificable ha cambiado.
CMFCPropertyGridProperty::PushChar	Denominado de control de la lista de propiedades cuando la propiedad está seleccionado y el usuario escribe un nuevo carácter.
CMFCPropertyGridProperty::Redraw	Redibuja la propiedad.
CMFCPropertyGridProperty::RemoveAllOptions	quita todas las opciones (elementos) de una propiedad.
CMFCPropertyGridProperty::RemoveSubItem	quita el sub-elemento especificado.
CMFCPropertyGridProperty::ResetOriginalValue	restablece el valor original de una propiedad editada.
CMFCPropertyGridProperty::SetData	Asocia un valor de DWORD a una propiedad.
CMFCPropertyGridProperty::SetDescription	especifica el texto que describe la propiedad actual.
CMFCPropertyGridProperty::SetName	Establece el nombre de una propiedad.
CMFCPropertyGridProperty::SetOriginalValue	Establece el valor original de una propiedad modificable.
CMFCPropertyGridProperty::SetValue	Establece el valor de una propiedad de la cuadrícula de propiedades.
CMFCPropertyGridProperty::Show	Muestra u oculta una propiedad.

Métodos protegidos

Name	Descripción
CMFCPropertyGridProperty::CreateCombo	Llamado por el marco para agregar un cuadro combinado en una propiedad.
CMFCPropertyGridProperty::HasButton	indica si una propiedad contiene un botón.
CMFCPropertyGridProperty::Init	Llamado por el marco para inicializar un objeto property.
CMFCPropertyGridProperty::IsSubItem	Indica si la propiedad especificada es un sub- elementos de propiedad actual.
CMFCPropertyGridProperty::IsValueChanged	indica si el valor de la propiedad actual ha cambiado.
CMFCPropertyGridProperty::OnCtlColor	Llamado por el marco cuando debe recuperar un pincel para rellenar el color de fondo de una propiedad.
CMFCPropertyGridProperty::OnDestroyWindow	Llamado por el marco cuando se destruye una propiedad o cuando edita finaliza.
CMFCPropertyGridProperty::OnKillFocus	Llamado por el marco cuando la propiedad pierde el foco de entrada.

miembros de datos

Name	Descripción
CMFCPropertyGridProperty::m_strFormatDouble	Cadena de formato para un valor de tipo double.
CMFCPropertyGridProperty::m_strFormatFloat	Cadena de formato para un valor de tipo float.
CMFCPropertyGridProperty::m_strFormatLong	Cadena de formato para un valor de tipo long.
CMFCPropertyGridProperty::m_strFormatShort	Cadena de formato para un valor de tipo short.

Comentarios

Utilice un objeto de CMFCPropertyGridProperty para representar una propiedad, que posteriormente agrega un control de lista de propiedades. Para obtener más información, vea CMFCPropertyGridCtrl Class.

Un objeto de propiedad puede representar tipos de datos como cadenas, fechas, y boolean o valores enteros. Puede contener propiedades secundarias, o puede contener un control como un cuadro combinado o un control de botón.

Ejemplo

El ejemplo siguiente muestra cómo construir un objeto de CMFCPropertyGridProperty . El ejemplo también muestra cómo utilizar varios métodos en la clase de CMFCPropertyGridProperty para agregar una opción, agregar un sub- elemento, habilita una propiedad, y se muestra una propiedad. Este ejemplo forma parte de nuevo ejemplo de Controles.

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