COlePropertiesDialog (clase)
Encapsula el cuadro de diálogo Propiedades de objeto de OLE común de Windows.
Sintaxis
class COlePropertiesDialog : public COleDialog
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | Construye un objeto COlePropertiesDialog. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| COlePropertiesDialog::DoModal | Muestra el cuadro de diálogo y permite al usuario realizar selecciones. |
| COlePropertiesDialog::OnApplyScale | Lo llama el marco cuando ha cambiado el escalado del elemento de documento. |
Miembros de datos públicos
| Nombre | Descripción |
|---|---|
| COlePropertiesDialog::m_gp | Estructura utilizada para inicializar la página "General" de un objeto COlePropertiesDialog. |
| COlePropertiesDialog::m_lp | Estructura utilizada para inicializar la página "Vincular" de un objeto COlePropertiesDialog. |
| COlePropertiesDialog::m_op | Estructura usada para inicializar el objeto COlePropertiesDialog. |
| COlePropertiesDialog::m_psh | Estructura utilizada para agregar páginas de propiedades personalizadas adicionales. |
| COlePropertiesDialog::m_vp | Estructura utilizada para personalizar la página "Ver" de un objeto COlePropertiesDialog. |
Comentarios
Los cuadros de diálogo Propiedades de objeto OLE comunes proporcionan una manera fácil de mostrar y modificar las propiedades de un elemento de documento OLE de forma coherente con los estándares de Windows. Estas propiedades incluyen, entre otros, información sobre el archivo representado por el elemento de documento, opciones para mostrar el icono y el escalado de imágenes, e información sobre el vínculo del elemento (si el elemento está vinculado).
Para usar un objeto COlePropertiesDialog, cree primero el objeto mediante el constructor COlePropertiesDialog. Una vez construido el cuadro de diálogo, llame a la función miembro DoModal para mostrar el cuadro de diálogo y permita al usuario modificar las propiedades del elemento. DoModal devuelve tanto si el usuario seleccionó el botón Aceptar (IDOK) como el botón Cancelar (IDCANCEL). Además de los botones Aceptar y Cancelar, existe también el botón Aplicar. Cuando el usuario selecciona Aplicar, los cambios realizados en las propiedades del elemento de documento se aplican al elemento y su imagen se actualiza automáticamente, pero permanece activa.
El miembro de datos m_psh es un puntero a una estructura PROPSHEETHEADER y, en la mayoría de los casos, no tendrá que acceder a él explícitamente. Una excepción es cuando se necesitan páginas de propiedades adicionales más allá de las páginas General, Vista y Vincular predeterminadas. En este caso, puede modificar el miembro de datos m_psh para incluir las páginas personalizadas antes de llamar a la función miembro DoModal.
Para más información sobre los cuadros de diálogo de OLE, consulte el artículo Cuadros de diálogo en OLE.
Jerarquía de herencia
COlePropertiesDialog
Requisitos
Encabezado: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
Crea un objeto COlePropertiesDialog.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Parámetros
pItem
Puntero al elemento de documento cuyas propiedades se acceden.
nScaleMin
Porcentaje de escalado mínimo para la imagen del elemento de documento.
nScaleMax
Porcentaje de escalado máximo para la imagen del elemento de documento.
pParentWnd
Puntero al elemento primario o propietario del cuadro de diálogo.
Comentarios
Derive la clase de diálogo propiedades de objeto OLE común de COlePropertiesDialog para implementar el escalado de los elementos de documento. Los cuadros de diálogo implementados por una instancia de esta clase no admitirán el escalado del elemento de documento.
De forma predeterminada, el cuadro de diálogo Propiedades comunes del objeto OLE tiene tres páginas predeterminadas:
General
Esta página contiene información del sistema para el archivo representado por el elemento de documento seleccionado. En esta página, el usuario puede convertir el elemento seleccionado a otro tipo.
Ver
Esta página contiene opciones para mostrar el elemento, cambiar el icono y cambiar el escalado de la imagen.
Vínculo
Esta página contiene opciones para cambiar la ubicación del elemento vinculado y actualizar el elemento vinculado. En esta página, el usuario puede interrumpir el vínculo del elemento seleccionado.
Para agregar páginas más allá de las proporcionadas de forma predeterminada, modifique la variable miembro m_psh antes de salir del constructor de la clase derivada de COlePropertiesDialog. Se trata de una implementación avanzada del constructor COlePropertiesDialog.
COlePropertiesDialog::DoModal
Llame a esta función miembro para mostrar el cuadro de diálogo Propiedades comunes del objeto OLE de Windows y permitir al usuario ver o cambiar las distintas propiedades del elemento de documento.
virtual INT_PTR DoModal();
Valor devuelto
IDOK o IDCANCEL si se realiza correctamente; de lo contrario, 0. IDOK y IDCANCEL son constantes que indican si el usuario seleccionó el botón Aceptar o Cancelar.
Si se devuelve IDCANCEL, puede llamar a la función CommDlgExtendedError de Windows para determinar si se ha producido un error.
COlePropertiesDialog::m_gp
Estructura de tipo OLEUIGNRLPROPS, utilizada para inicializar la página General del cuadro de diálogo Propiedades del objeto OLE.
OLEUIGNRLPROPS m_gp;
Comentarios
Esta página muestra el tipo y el tamaño de una inserción y permite al usuario acceder al cuadro de diálogo Convertir. Esta página también muestra el destino del vínculo si el objeto es un vínculo.
Para más información sobre la estructura OLEUIGNRLPROPS, consulte Windows SDK.
COlePropertiesDialog::m_lp
Estructura de tipo OLEUILINKPROPS, utilizada para inicializar la página Vincular del cuadro de diálogo Propiedades del objeto OLE.
OLEUILINKPROPS m_lp;
Comentarios
Esta página muestra la ubicación del elemento vinculado y permite al usuario actualizar o interrumpir el vínculo al elemento.
Para más información sobre la estructura OLEUILINKPROPS, consulte Windows SDK.
COlePropertiesDialog::m_op
Estructura de tipo OLEUIOBJECTPROPS, utilizada para inicializar el cuadro de diálogo Propiedades comunes del objeto OLE.
OLEUIOBJECTPROPS m_op;
Comentarios
Esta estructura contiene miembros usados para inicializar las páginas General, Vincular y Vista.
Para obtener más información, vea las estructuras OLEUIOBJECTPROPS y OLEUILINKPROPS en Windows SDK.
COlePropertiesDialog::m_psh
Estructura de tipo PROPSHEETHEADER, cuyos miembros almacenan las características del objeto de cuadro de diálogo.
PROPSHEETHEADER m_psh;
Comentarios
Después de construir un objeto COlePropertiesDialog, puede usar m_psh para establecer varios aspectos del cuadro de diálogo antes de llamar a la función miembro DoModal.
Si modifica el miembro de datos m_psh directamente, invalidará cualquier comportamiento predeterminado.
Para más información sobre la estructura PROPSHEETHEADER, consulte Windows SDK.
COlePropertiesDialog::m_vp
Estructura de tipo OLEUIVIEWPROPS, utilizada para inicializar la página Vista del cuadro de diálogo Propiedades del objeto OLE.
OLEUIVIEWPROPS m_vp;
Comentarios
Esta página permite al usuario alternar entre las vistas "content" y "iconic" del objeto y cambiar su escalado dentro del contenedor. También permite al usuario acceder al cuadro de diálogo Cambiar icono cuando el objeto se muestra como un icono.
Para más información sobre la estructura OLEUIVIEWPROPS, consulte Windows SDK.
COlePropertiesDialog::OnApplyScale
Lo llama el marco cuando el valor de escalado ha cambiado y se ha seleccionado Aceptar o Aplicar.
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
Parámetros
pItem
Puntero al elemento de documento cuyas propiedades se acceden.
nCurrentScale
Valor numérico de la escala del cuadro de diálogo.
bRelativeToOrig
Indica si el escalado se aplica al tamaño original del elemento de documento.
Valor devuelto
Valor distinto de cero si se controla; de lo contrario, 0.
Comentarios
La implementación predeterminada no hace nada. Debe invalidar esta función para habilitar los controles de escalado.
Nota:
Antes de que se muestre el cuadro de diálogo Propiedades comunes del objeto OLE, el marco llama a esta función con un valor NULL para pItem y - 1 para nCurrentScale. Esto se hace para determinar si se deben habilitar los controles de escalado.
Consulte también
MFC Sample CIRC
COleDialog (clase)
Gráfico de jerarquías
COleDialog (clase)
CPropertyPage (clase)