Compartir a través de


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

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

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)