Compartir a través de


Clase de CMFCPropertyGridCtrl

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

Bb983759.collapse_all(es-es,VS.110).gifConstructores públicos

Name

Descripción

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Crea un objeto CMFCPropertyGridCtrl.

CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl

Un destructor.

Bb983759.collapse_all(es-es,VS.110).gifMé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.

Bb983759.collapse_all(es-es,VS.110).gifMé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();

Jerarquía de herencia

CObject

   CCmdTarget

      CWnd

         CMFCPropertyGridCtrl

Requisitos

encabezado: afxpropertygridctrl.h

Vea también

Referencia

Gráfico de jerarquía

Otros recursos

Clases de MFC