Clase de COlePropertiesDialog

Artículo
03/15/2013

Encapsula el cuadro de diálogo Propiedades común del objeto OLE de Windows.

class COlePropertiesDialog : public COleDialog

Miembros

Constructores públicos

Name	Descripción
COlePropertiesDialog::COlePropertiesDialog	Crea un objeto COlePropertiesDialog.

Métodos públicos

Name	Descripción
COlePropertiesDialog::DoModal	Muestra el cuadro de diálogo y permite que el usuario realice una selección.
COlePropertiesDialog::OnApplyScale	Llamado por el marco cuando el ajuste de escala del elemento de documento ha cambiado.

Miembros de datos públicos

Name	Descripción
COlePropertiesDialog::m_gp	Una estructura utilizada para inicializar la página de “General” de un objeto de COlePropertiesDialog .
COlePropertiesDialog::m_lp	Una estructura utilizada para inicializar la página “vínculo” de un objeto de COlePropertiesDialog .
COlePropertiesDialog::m_op	Una estructura usada para inicializar el objeto de COlePropertiesDialog .
COlePropertiesDialog::m_psh	Una estructura utilizada para agregar páginas de propiedades personalizadas adicionales.
COlePropertiesDialog::m_vp	Una estructura utilizada para personalizar la página “vista” de un objeto de COlePropertiesDialog .

Comentarios

Los cuadros de diálogo de Propiedades comunes de objetos OLE proporcionan una manera fácil de mostrar y modificar las propiedades de un elemento OLE de una manera coherente con los estándares de Windows.Estas propiedades incluyen, entre otros, información del archivo representado por el elemento de documento, opciones para mostrar el ajuste de escala de icono y la imagen, y la información del vínculo del elemento (si se vincula el elemento).

Para utilizar un objeto de COlePropertiesDialog , primero cree el objeto mediante el constructor de COlePropertiesDialog .Una vez construido el cuadro de diálogo, llame a la función miembro de DoModal para mostrar el cuadro de diálogo y permite al usuario modificar cualquier propiedad del elemento.DoModal devuelve si el usuario seleccionó OK (IDOK) o el botón cancelar (IDCANCEL).Además de la ACEPTAR y de los botones Cancelar, hay un botón de aplicar.Cuando el usuario selecciona aplique, los cambios realizados en las propiedades del elemento de documento se aplica al elemento y su imagen se actualiza automáticamente, pero permanece activo.

El miembro de datos de m_psh es un puntero a una estructura de PROPSHEETHEADER y, en la mayoría de los casos no necesitará tener acceso explícitamente.Una excepción es cuando necesita las páginas de propiedades adicionales más allá del valor predeterminado General, ver, y enlaza las páginas.En este caso, puede modificar el miembro de datos de m_psh para incluir las páginas personalizadas antes de llamar a la función miembro de DoModal .

Para obtener más información sobre los cuadros de diálogo de OLE, vea el artículo Cuadros de diálogo de OLE.