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
.gif "Bb983759.collapse_all(es-es,VS.110).gif")
Constructores públicos
Name |
Descripción |
|---|---|
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.) |
Llamado por el marco para modificar la selección o para mover el foco de teclado del objeto especificado.(Reemplaza CWnd::accSelect.) |
|
agrega una nueva propiedad a un control de cuadrícula de propiedades. |
|
|
|
Cierre el cuadro de diálogo de selección de color. |
|
Crea un control de cuadrícula de propiedades y lo asocia al objeto de control de cuadrícula de propiedades. |
|
Elimina la propiedad especificada del control de cuadrícula de propiedades. |
|
|
|
Habilita o deshabilita el área de descripción que se muestra bajo la lista de propiedades. |
|
Habilita o deshabilita el control de encabezado en la parte superior del control de cuadrícula de propiedades. |
|
Desplaza un control de cuadrícula de propiedades y expanda los elementos de propiedad hasta que la propiedad especificada sea visible. |
|
Expande o contrae todos los nodos del control de cuadrícula de propiedades. |
|
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.) |
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.) |
Llamado por el marco para recuperar el objeto que tiene el foco de teclado.(Reemplaza CWnd::get_accFocus.) |
|
Llamado por el marco para recuperar la cadena de la propiedad de Help de un objeto.(Reemplaza CWnd::get_accHelp.) |
|
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.) |
|
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.) |
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.) |
Recupera el color de fondo del control de cuadrícula de propiedades actual. |
|
Recuperar la fuente de Windows que de texto en el control de cuadrícula de propiedades actual en estilo negrita. |
|
recupera la propiedad actualmente seleccionado. |
|
recupera los colores personalizados que son actualmente definido para los elementos de control de cuadrícula de propiedades. |
|
Recupera el alto de la descripción situada en la parte inferior del control de cuadrícula de propiedades. |
|
Recupera el número de filas en el área de la descripción del control de cuadrícula de propiedades actual. |
|
Recupera el objeto interno de CMFCHeaderCtrl que el marco de trabajo usa para mostrar el control de cuadrícula de propiedades actual. |
|
Recupera el alto del encabezado del control de cuadrícula de propiedades. |
|
Recupera el ancho de la columna izquierda del control de cuadrícula de propiedades actual, que contiene el nombre de cada propiedad. |
|
Recupera el rectángulo delimitador del control de cuadrícula de propiedades. |
|
Recupera un puntero al objeto de propiedad correspondiente al índice especificado de un elemento del control de cuadrícula de propiedades. |
|
recupera el ancho actual de la columna que contiene valores de propiedad. |
|
recupera el número de propiedades en un control de cuadrícula de propiedades. |
|
recupera el alto de una fila en el control de cuadrícula de propiedades. |
|
Recupera un puntero al control de barra de desplazamiento en el control de cuadrícula de propiedades.(Reemplaza CWnd::GetScrollBarCtrl.) |
|
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. |
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. |
|
Inicializa el objeto interno de CMFCHeaderCtrl que el marco de trabajo usa para mostrar el control de cuadrícula de propiedades actual. |
|
indica si un control de cuadrícula de propiedades está en modo alfabético. |
|
|
|
Indica si el área de la descripción del control de cuadrícula de propiedades se muestra. |
|
Indica si cada nombre de grupo de propiedades se muestra mediante el ancho del control de cuadrícula de propiedades actual. |
|
Indica si el control de encabezado se muestra. |
|
Indica cómo el control de cuadrícula de propiedades muestra las propiedades modificadas. |
|
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. |
|
Indica si el aspecto del control de cuadrícula de propiedades está en el estilo que usa VS .NET. |
|
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.) |
Quita todos los objetos de propiedad de un control de cuadrícula de propiedades. |
|
restablece el valor original de todas las propiedades. |
|
Obtiene o modo alfabético de los reinicios. |
|
Especifica el texto de etiquetas boolean. |
|
Seleccione una propiedad en un control de cuadrícula de propiedades. |
|
Especifica los colores personalizados para los distintos elementos de control de cuadrícula de propiedades. |
|
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. |
|
Especifica si mostrar el ancho del nombre de categoría para un grupo de propiedades en el control de cuadrícula de propiedades actual. |
|
Define un carácter que se utilice como delimitador en una lista de valores de propiedad. |
|
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. |
|
Establece la apariencia del control de cuadrícula de propiedades de estilo que se utiliza en VS .NET. |
|
Establece el valor de color de la propiedad color seleccionado actualmente. |
Métodos protegidos
Name |
Descripción |
|---|---|
Dibuja de nuevo el control de cuadrícula de propiedades y sus propiedades. |
|
Llamado por el control de cuadrícula de propiedades para ordenar propiedades. |
|
Llamado por el marco cuando el usuario inicia para modificar una propiedad. |
|
Llamado por el marco cuando el usuario detiene el modificar de una propiedad. |
|
Llamado por el marco para inicializar un control de cuadrícula de propiedades. |
|
Llamado por el marco cuando cambia la selección actual. |
|
Llamado por el marco cuando se hace clic en un botón de la propiedad. |
|
Llamado por el marco para dibujar un borde alrededor de un control de cuadrícula de propiedades. |
|
Llamado por el marco para dibujar el área de descripción y mostrar el texto de la descripción. |
|
Llamado por el marco para mostrar la lista de propiedades del control de cuadrícula de propiedades. |
|
Llamado por el marco para mostrar una propiedad. |
|
Llamado por el marco cuando el valor de una propiedad cambia. |
|
Llamado por el marco cuando una propiedad que contiene un control combobox está seleccionado. |
|
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 |
|---|---|
Una propiedad de uso general que se utiliza para especificar el valor de cadenas, valores booleanos, fechas y así sucesivamente. |
|
Una propiedad que se utiliza para seleccionar un valor de color. |
|
Una propiedad que se utiliza para seleccionar un archivo. |
|
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.
.png "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
Requisitos
encabezado: afxpropertygridctrl.h