Clase COleConvertDialog

  • Artículo

Para más información, consulte la estructura OLEUICONVERT en Windows SDK.

Sintaxis

class COleConvertDialog : public COleDialog

Miembros

Constructores públicos

Nombre Descripción
COleConvertDialog::COleConvertDialog Construye un objeto COleConvertDialog.

Métodos públicos

Nombre Descripción
COleConvertDialog::DoConvert Realiza la conversión especificada en el cuadro de diálogo.
COleConvertDialog::DoModal Muestra el cuadro de diálogo Cambiar elemento OLE.
COleConvertDialog::GetClassID Obtiene el CLSID asociado al elemento elegido.
COleConvertDialog::GetDrawAspect Especifica si el elemento se debe dibujar como icono.
COleConvertDialog::GetIconicMetafile Obtiene un identificador del metarchivo asociado a la forma de icono de este elemento.
COleConvertDialog::GetSelectionType Obtiene el tipo de selección elegido.

Miembros de datos públicos

Nombre Descripción
COleConvertDialog::m_cv Estructura que controla el comportamiento del cuadro de diálogo.

Comentarios

Nota:

El código de contenedor generado por el Asistente para aplicaciones usa esta clase.

Para más información sobre los cuadros de diálogo específicos de OLE, consulte el artículo Cuadros de diálogo en OLE.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Requisitos

Encabezado: afxodlgs.h

COleConvertDialog::COleConvertDialog

Construye solo un objeto COleConvertDialog.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parámetros

pItem
Apunta al elemento que se va a convertir o activar.

dwFlags
La marca de creación, que contiene cualquier número de los valores siguientes combinados mediante el operador OR bit a bit:

  • CF_SELECTCONVERTTO Especifica que el botón de radio Convertir en se seleccionará inicialmente cuando se llame al cuadro de diálogo. Este es el valor predeterminado.

  • CF_SELECTACTIVATEAS Especifica que el botón de radio Activar como se seleccionará inicialmente cuando se llame al cuadro de diálogo.

  • CF_SETCONVERTDEFAULT Especifica que la clase cuyo CLSID se especifica mediante el miembro clsidConvertDefault de la estructura m_cv se usará como la selección predeterminada en el cuadro de lista de clases cuando se seleccione el botón de radio Convertir en.

  • CF_SETACTIVATEDEFAULT Especifica que la clase cuyo CLSID se especifica mediante el miembro clsidActivateDefault de la estructura m_cv se usará como la selección predeterminada en el cuadro de lista de clases cuando se seleccione el botón de radio Activar como.

  • CF_SHOWHELPBUTTON Especifica que el botón Ayuda se mostrará cuando se llame al cuadro de diálogo.

pClassID
Apunta al CLSID del elemento que se va a convertir o activar. Si es NULL, se usará el CLSID asociado con pItem.

pParentWnd
Apunta al objeto de ventana primaria o propietaria (de tipo CWnd) al que pertenece el objeto de cuadro de diálogo. Si es NULL, la ventana primaria del cuadro de diálogo se establece en la ventana principal de la aplicación.

Comentarios

Para mostrar el cuadro de diálogo, llame a la función DoModal.

Para más información, consulte Clave CLSID y la estructura OLEUICONVERT.

COleConvertDialog::DoConvert

Después de que DoModal se devuelva correctamente, llame a esta función para convertir o activar un objeto de tipo COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parámetros

pItem
Apunta al elemento que se va a convertir o activar. No puede ser NULL.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Comentarios

El elemento se convierte o activa en función de la información que el usuario selecciona en el cuadro de diálogo Convertir.

COleConvertDialog::DoModal

Llame a esta función para mostrar el cuadro de diálogo Convertir OLE.

virtual INT_PTR DoModal();

Valor devuelto

Estado de finalización del cuadro de diálogo. Uno de los siguientes valores:

  • IDOK si el cuadro de diálogo se mostró correctamente.

  • IDCANCEL si el usuario canceló el cuadro de diálogo.

  • IDABORT si se produjo un error. Si se devuelve IDABORT, llame a la función miembro COleDialog::GetLastError para más información sobre el tipo de error que se produjo. Para una lista de posibles errores, consulte la función OleUIConvert en Windows SDK.

Comentarios

Si quiere inicializar los distintos controles de cuadro de diálogo estableciendo miembros de la estructura m_ps, debe hacerlo antes de llamar a DoModal, pero después de construir el objeto de cuadro de diálogo.

Si DoModal devuelve IDOK, puede llamar a otras funciones miembro para recuperar la configuración o la información que el usuario especificó en el cuadro de diálogo.

COleConvertDialog::GetClassID

Llame a esta función para obtener el CLSID asociado al elemento que el usuario seleccionó en el cuadro de diálogo Convertir.

REFCLSID GetClassID() const;

Valor devuelto

CLSID asociado al elemento que se seleccionó en el cuadro de diálogo Convertir.

Comentarios

Llame a esta función solo después de que DoModal devuelva IDOK.

Para más información, consulte Clave CLSID en Windows SDK.

COleConvertDialog::GetDrawAspect

Llame a esta función para determinar si el usuario eligió mostrar el elemento seleccionado como un icono.

DVASPECT GetDrawAspect() const;

Valor devuelto

Método necesario para representar el objeto.

  • DVASPECT_CONTENT Se devuelve si no se activó la casilla Mostrar como icono.

  • DVASPECT_ICON Se devuelve si se activó la casilla Mostrar como icono.

Comentarios

Llame a esta función solo después de que DoModal devuelva IDOK.

Para más información sobre el aspecto de dibujo, consulte la estructura de datos FORMATETC en Windows SDK.

COleConvertDialog::GetIconicMetafile

Llame a esta función para obtener un manipulador del metarchivo que contiene el aspecto de icono del elemento seleccionado.

HGLOBAL GetIconicMetafile() const;

Valor devuelto

El manipulador del metarchivo que contiene el aspecto de icono del elemento seleccionado, si la casilla Mostrar como icono estaba activada cuando se descartó el cuadro de diálogo mediante OK; de lo contrario, NULL.

COleConvertDialog::GetSelectionType

Llame a esta función para determinar el tipo de conversión que se seleccionó en el cuadro de diálogo Convertir.

UINT GetSelectionType() const;

Valor devuelto

Tipo de selección que se realizó.

Comentarios

Los valores de tipo de valor devuelto los especifica el tipo de enumeración Selection declarado en la clase COleConvertDialog.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

A continuación, se describen brevemente estos valores:

  • COleConvertDialog::noConversion Se devuelve si se canceló el cuadro de diálogo o si el usuario no seleccionó ninguna conversión. Si COleConvertDialog::DoModal devolvió IDOK, es posible que el usuario seleccione un icono diferente al que se seleccionó anteriormente.

  • COleConvertDialog::convertItem Se devuelve si se activó el botón de radio Convertir en, el usuario seleccionó un elemento distinto que se va a convertir y DoModal devolvió IDOK.

  • COleConvertDialog::activateAs Se devuelve si se activó el botón de radio Activar como, el usuario seleccionó un elemento distinto que se va a activar y DoModal devolvió IDOK.

COleConvertDialog::m_cv

Estructura de tipo OLEUICONVERT utilizada para controlar el comportamiento del cuadro de diálogo Convertir.

OLEUICONVERT m_cv;

Comentarios

Los miembros de esta estructura se pueden modificar directamente o a través de funciones miembro.

Para más información, consulte la estructura OLEUICONVERT en Windows SDK.

Consulte también

COleDialog (clase)
Gráfico de jerarquías
COleDialog (clase)