Clase de CMFCPropertyGridCtrl

Artículo
02/19/2013

Este tema se incluye a efectos de integridad. Para obtener información más detallada, vea el código fuente ubicado en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Admite un control de cuadrícula de propiedades editables que puede mostrar propiedades en orden alfabético o jerárquico.

class CMFCPropertyGridCtrl : public CWnd

Members

Constructores públicos

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

Métodos públicos

Name	Descripción
CMFCPropertyGridCtrl::accHitTest	Llamado por el marco para recuperar el elemento secundario o el objeto secundario en un punto determinado de la pantalla.(Reemplaza CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Llamado por el marco para recuperar la ubicación actual de la pantalla del objeto especificado.(Reemplaza CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Llamado por el marco para modificar la selección o para mover el foco de teclado del objeto especificado.(Reemplaza CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	agrega una nueva propiedad a un control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Cierre el cuadro de diálogo de selección de color.
CMFCPropertyGridCtrl::Create	Crea un control de cuadrícula de propiedades y lo asocia al objeto de control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::DeleteProperty	Elimina la propiedad especificada del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Habilita o deshabilita el área de descripción que se muestra bajo la lista de propiedades.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Habilita o deshabilita el control de encabezado en la parte superior del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::EnsureVisible	Desplaza un control de cuadrícula de propiedades y expanda los elementos de propiedad hasta que la propiedad especificada sea visible.
CMFCPropertyGridCtrl::ExpandAll	Expande o contrae todos los nodos del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::FindItemByData	Recupera la propiedad que está asociado a un valor definido por el usuario de DWORD .
CMFCPropertyGridCtrl::get_accChild	Llamado por el marco para recuperar la dirección de una interfaz de IDispatch para el elemento secundario especificado.(Reemplaza CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Llamado por el marco para recuperar el número de elementos secundarios que pertenecen a este objeto.(Reemplaza CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Llamado por el marco para recuperar una cadena que describe la acción predeterminada del objeto.(Reemplaza CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Llamado por el marco para recuperar una cadena que describe la apariencia visual del objeto especificado.(Reemplaza CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Llamado por el marco para recuperar el objeto que tiene el foco de teclado.(Reemplaza CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Llamado por el marco para recuperar la cadena de la propiedad de Help de un objeto.(Reemplaza CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Llamado por el marco para recuperar la ruta de acceso completa del archivo de WinHelpasociado al objeto especificado y el identificador del tema correspondiente dentro de ese archivo.(Reemplaza CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Llamado por el marco para recuperar la tecla de método abreviado o la tecla de acceso del objeto especificado.(Reemplaza CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Llamado por el marco para recuperar el nombre del objeto especificado.(Reemplaza CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Llamado por el marco para recuperar la información que describe el rol del objeto especificado.(Reemplaza CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Llamado por el marco para recuperar los elementos secundarios de este objeto.(Reemplaza CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Llamado por el marco para recuperar el estado actual del objeto especificado.(Reemplaza CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Llamado por el marco para recuperar el valor del objeto especificado.(Reemplaza CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Recupera el color de fondo del control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::GetBoldFont	Recuperar la fuente de Windows que de texto en el control de cuadrícula de propiedades actual en estilo negrita.
CMFCPropertyGridCtrl::GetCurSel	recupera la propiedad actualmente seleccionado.
CMFCPropertyGridCtrl::GetCustomColors	recupera los colores personalizados que son actualmente definido para los elementos de control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetDescriptionHeight	Recupera el alto de la descripción situada en la parte inferior del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetDescriptionRows	Recupera el número de filas en el área de la descripción del control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::GetHeaderCtrl	Recupera el objeto interno de CMFCHeaderCtrl que el marco de trabajo usa para mostrar el control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::GetHeaderHeight	Recupera el alto del encabezado del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Recupera el ancho de la columna izquierda del control de cuadrícula de propiedades actual, que contiene el nombre de cada propiedad.
CMFCPropertyGridCtrl::GetListRect	Recupera el rectángulo delimitador del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetProperty	Recupera un puntero al objeto de propiedad correspondiente al índice especificado de un elemento del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	recupera el ancho actual de la columna que contiene valores de propiedad.
CMFCPropertyGridCtrl::GetPropertyCount	recupera el número de propiedades en un control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetRowHeight	recupera el alto de una fila en el control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Recupera un puntero al control de barra de desplazamiento en el control de cuadrícula de propiedades.(Reemplaza CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Recupera el color del texto de los elementos de propiedad en el control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::GetThisClass	Utiliza el marco para obtener un puntero al objeto de Recursos que está asociado a este tipo de clase.
CMFCPropertyGridCtrl::HitTest	Recupera un puntero al objeto de la propiedad que corresponde a un elemento del control de cuadrícula de propiedades si un punto especificado está en el elemento.este método también indica el área en el control de cuadrícula de propiedades que contiene el punto.
CMFCPropertyGridCtrl::InitHeader	Inicializa el objeto interno de CMFCHeaderCtrl que el marco de trabajo usa para mostrar el control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::IsAlphabeticMode	indica si un control de cuadrícula de propiedades está en modo alfabético.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Indica si el área de la descripción del control de cuadrícula de propiedades se muestra.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Indica si cada nombre de grupo de propiedades se muestra mediante el ancho del control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::IsHeaderCtrl	Indica si el control de encabezado se muestra.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Indica cómo el control de cuadrícula de propiedades muestra las propiedades modificadas.
CMFCPropertyGridCtrl::IsShowDragContext	Indica si el marco dibuja de nuevo el nombre y columnas valor del control de cuadrícula de propiedades actual cuando un usuario cambia el tamaño de las columnas.
CMFCPropertyGridCtrl::IsVSDotNetLook	Indica si el aspecto del control de cuadrícula de propiedades está en el estilo que usa VS .NET.
CMFCPropertyGridCtrl::MarkModifiedProperties	Especifica cómo mostrar propiedades modificadas.
CMFCPropertyGridCtrl::PreTranslateMessage	Utiliza la clase CWinApp para traducir mensajes de ventana antes de que se envíen a las funciones de TranslateMessage y de DispatchMessage Windows.(Reemplaza CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Quita todos los objetos de propiedad de un control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::ResetOriginalValues	restablece el valor original de todas las propiedades.
CMFCPropertyGridCtrl::SetAlphabeticMode	Obtiene o modo alfabético de los reinicios.
CMFCPropertyGridCtrl::SetBoolLabels	Especifica el texto de etiquetas boolean.
CMFCPropertyGridCtrl::SetCurSel	Seleccione una propiedad en un control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::SetCustomColors	Especifica los colores personalizados para los distintos elementos de control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::SetDescriptionRows	Especifica el número de filas que se mostrarán en la sección de la descripción del control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Especifica si mostrar el ancho del nombre de categoría para un grupo de propiedades en el control de cuadrícula de propiedades actual.
CMFCPropertyGridCtrl::SetListDelimiter	Define un carácter que se utilice como delimitador en una lista de valores de propiedad.
CMFCPropertyGridCtrl::SetShowDragContext	Especifica si el marco dibuja de nuevo el nombre y columnas valor del control de cuadrícula de propiedades actual cuando un usuario cambia el tamaño de las columnas.
CMFCPropertyGridCtrl::SetVSDotNetLook	Establece la apariencia del control de cuadrícula de propiedades de estilo que se utiliza en VS .NET.
CMFCPropertyGridCtrl::UpdateColor	Establece el valor de color de la propiedad color seleccionado actualmente.

Métodos protegidos

Name	Descripción
CMFCPropertyGridCtrl::AdjustLayout	Dibuja de nuevo el control de cuadrícula de propiedades y sus propiedades.
CMFCPropertyGridCtrl::CompareProps	Llamado por el control de cuadrícula de propiedades para ordenar propiedades.
CMFCPropertyGridCtrl::EditItem	Llamado por el marco cuando el usuario inicia para modificar una propiedad.
CMFCPropertyGridCtrl::EndEditItem	Llamado por el marco cuando el usuario detiene el modificar de una propiedad.
CMFCPropertyGridCtrl::Init	Llamado por el marco para inicializar un control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::OnChangeSelection	Llamado por el marco cuando cambia la selección actual.
CMFCPropertyGridCtrl::OnClickButton	Llamado por el marco cuando se hace clic en un botón de la propiedad.
CMFCPropertyGridCtrl::OnDrawBorder	Llamado por el marco para dibujar un borde alrededor de un control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::OnDrawDescription	Llamado por el marco para dibujar el área de descripción y mostrar el texto de la descripción.
CMFCPropertyGridCtrl::OnDrawList	Llamado por el marco para mostrar la lista de propiedades del control de cuadrícula de propiedades.
CMFCPropertyGridCtrl::OnDrawProperty	Llamado por el marco para mostrar una propiedad.
CMFCPropertyGridCtrl::OnPropertyChanged	Llamado por el marco cuando el valor de una propiedad cambia.
CMFCPropertyGridCtrl::OnSelectCombo	Llamado por el marco cuando una propiedad que contiene un control combobox está seleccionado.
CMFCPropertyGridCtrl::ValidateItemData	Llamado por el marco para validar datos de propiedad.

Comentarios

Muestra de clase de CMFCPropertyGridCtrl un control de cuadrícula de propiedades con las propiedades modificables derivadas de la clase de CMFCPropertyGridProperty .cada propiedad puede representar un tipo y puede contener subelementos.El control de cuadrícula de propiedades admite un área de tamaño variable en la parte inferior que puede mostrar la descripción de una propiedad seleccionada.

Para utilizar un control de cuadrícula de propiedades, cree un objeto de CMFCPropertyGridCtrl y llame al método de CMFCPropertyGridCtrl::Create .utilice el método de CMFCPropertyGridCtrl::AddProperty para agregar propiedades a la lista.

Propiedades de selección

En lugar de representar un valor, un elemento de propiedad puede iniciar un cuadro de diálogo que permite al usuario seleccionar color, un archivo, o a una fuente.

La tabla siguiente se muestran cuatro tipos de propiedad de selección:

Clase	Descripción
Clase de CMFCPropertyGridProperty	Una propiedad de uso general que se utiliza para especificar el valor de cadenas, valores booleanos, fechas y así sucesivamente.
Clase de CMFCPropertyGridColorProperty	Una propiedad que se utiliza para seleccionar un valor de color.
Clase de CMFCPropertyGridFileProperty	Una propiedad que se utiliza para seleccionar un archivo.
Clase de CMFCPropertyGridFontProperty	Una propiedad que se utiliza para seleccionar una fuente.

Ilustraciones

Las ilustraciones siguientes describen un control de cuadrícula de propiedades que muestre propiedades de dos maneras.La primera ilustración muestra propiedades jerárquico y la segunda muestra propiedades alfabéticamente.

Lista de propiedades PropertySheet

Ejemplo

El ejemplo siguiente muestra cómo configurar un objeto de control de cuadrícula de propiedades mediante varios métodos en la clase de CMFCPropertyGridCtrl .El ejemplo muestra cómo habilitar el control de encabezado, permite el área de descripción, y establece la apariencia del control de cuadrícula de propiedades.El ejemplo también se muestra cómo establecer el modo alfabético para el control por el que el control ordenar todas las propiedades que contiene el nombre de propiedad, y cómo establecer los colores personalizados para los diferentes elementos del control de cuadrícula de propiedades.Este ejemplo forma parte de nuevo ejemplo de Controles.

    CMFCPropertyGridCtrl m_wndPropList;


...


    m_wndPropList.EnableHeaderCtrl();
    m_wndPropList.EnableDescriptionArea();
    m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
    // BOOL m_bMarkChanged
    m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
    // BOOL m_bPropListCategorized
    m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
    // BOOL m_bShowDragContext
    m_wndPropList.SetShowDragContext(m_bShowDragContext);


...


    // BOOL m_bMarkSortedColumn
    m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);


...


    // BOOL m_bPropListCustomColors
    // set custom colors for various elements of the property grid control
    if (m_bPropListCustomColors)
    {
        m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
    }
    else
    {
        COLORREF c = (COLORREF)-1;
        m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
    }

    m_wndPropList.RedrawWindow();


...


    // restore original values of the properties
    m_wndPropList.ResetOriginalValues();