Compartir a través de

Clase COleInsertDialog

  • Artículo

Se utiliza para el cuadro de diálogo Insertar objeto OLE.

Sintaxis

class COleInsertDialog : public COleDialog

Miembros

Constructores públicos

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

Métodos públicos

Nombre Descripción
COleInsertDialog::CreateItem Crea el elemento seleccionado en el cuadro de diálogo.
COleInsertDialog::DoModal Muestra el cuadro de diálogo Insertar objeto OLE.
COleInsertDialog::GetClassID Obtiene el CLSID asociado al elemento elegido.
COleInsertDialog::GetDrawAspect Indica si se debe dibujar el elemento como un icono.
COleInsertDialog::GetIconicMetafile Obtiene un identificador del metarchivo asociado a la forma de icono de este elemento.
COleInsertDialog::GetPathName Obtiene la ruta de acceso completa al archivo elegido en el cuadro de diálogo.
COleInsertDialog::GetSelectionType Obtiene el tipo del objeto seleccionado.

Miembros de datos públicos

Nombre Descripción
COleInsertDialog::m_io Una estructura de tipo OLEUIINSERTOBJECT que controla el comportamiento del cuadro de diálogo.

Comentarios

Cree un objeto de clase COleInsertDialog cuando quiera llamar a este cuadro de diálogo. Una vez construido un objeto COleInsertDialog, puede usar la estructura m_io para inicializar los valores o estados de los controles en el cuadro de diálogo. La estructura m_io es de tipo OLEUIINSERTOBJECT. Para más información sobre el uso de esta clase de diálogo, consulte la función miembro DoModal.

Nota:

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

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

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

COleInsertDialog

Requisitos

Encabezado: afxodlgs.h

COleInsertDialog::COleInsertDialog

Esta función solo construye un objeto COleInsertDialog.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Parámetros

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

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

  • IOF_SELECTCREATENEW Especifica que el botón de radio Crear nuevo en se seleccionará inicialmente cuando se llame al cuadro de diálogo. Este es el valor predeterminado y no se puede usar con IOF_SELECTCREATEFROMFILE.

  • IOF_SELECTCREATENEW Especifica que el botón de radio Crear desde archivo se seleccionará inicialmente cuando se llame al cuadro de diálogo. No se puede usar con IOF_SELECTCREATENEW.

  • IOF_CHECKLINK Especifica que la casilla Vincular se activará inicialmente cuando se llame al cuadro de diálogo.

  • IOF_DISABLELINK Especifica que la casilla Vincular se deshabilitará cuando se llame al cuadro de diálogo.

  • IOF_CHECKDISPLAYASICON Especifica que la casilla Mostrar como icono se activará inicialmente, se mostrará el icono actual y se habilitará el botón Cambiar icono cuando se llame al cuadro de diálogo.

  • IOF_VERIFYSERVERSEXIST Especifica que el cuadro de diálogo debe validar las clases que agrega al cuadro de lista al asegurarse de que los servidores especificados en la base de datos de registro existen antes de que se muestre el cuadro de diálogo. Establecer esta marca puede afectar significativamente al rendimiento.

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 objeto de 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.

COleInsertDialog::CreateItem

Llame a esta función para crear un objeto de tipo COleClientItem solo si DoModal devuelve IDOK.

BOOL CreateItem(COleClientItem* pItem);

Parámetros

pItem
Apunta al elemento que se creará.

Valor devuelto

Distinto de cero si se creó el elemento; de lo contrario, 0.

Comentarios

Debe asignar el objeto COleClientItem para poder llamar a esta función.

COleInsertDialog::DoModal

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

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parámetros

dwFlags
Uno de los siguientes valores:

COleInsertDialog::DocObjectsOnly inserta solo DocObjects.

COleInsertDialog::ControlsOnly inserta solo controles ActiveX.

Cero no inserta un DocObject ni un control ActiveX. Este valor da como resultado la misma implementación que el primer prototipo mencionado anteriormente.

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 OleUIInsertObject en Windows SDK.

Comentarios

Si quiere inicializar los distintos controles de cuadro de diálogo estableciendo miembros de la estructura m_io, 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 entrada de información que especificó el usuario en el cuadro de diálogo.

COleInsertDialog::GetClassID

Llame a esta función para obtener el CLSID asociado con el elemento seleccionado solo si DoModal devuelve IDOK y el tipo de selección es COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Valor devuelto

Devuelve el CLSID asociado con el elemento seleccionado.

Comentarios

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

COleInsertDialog::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 si DoModal devuelve IDOK.

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

COleInsertDialog::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.

COleInsertDialog::GetPathName

Llame a esta función para obtener la ruta de acceso completa del archivo seleccionado solo si DoModal devuelve IDOK y el tipo de selección no es COleInsertDialog::createNewItem.

CString GetPathName() const;

Valor devuelto

La ruta de acceso completa al archivo seleccionado en el cuadro de diálogo. Si el tipo de selección es createNewItem, esta función devuelve un CString sin sentido en modo de versión o provoca una aserción en modo de depuración.

COleInsertDialog::GetSelectionType

Llame a esta función para obtener el tipo de selección elegido cuando se descartó el cuadro de diálogo Insertar objeto; para ello, elija Aceptar.

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 COleInsertDialog.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

A continuación, se describen brevemente estos valores:

  • COleInsertDialog::createNewItem Se ha seleccionado el botón de radio Crear nuevo.

  • COleInsertDialog::insertFromFile Se ha seleccionado el botón de radio Crear desde archivo y no se activó la casilla Vincular.

  • COleInsertDialog::linkToFile Se ha seleccionado el botón de radio Crear desde archivo y se activó la casilla Vincular.

COleInsertDialog::m_io

Estructura de tipo OLEUIINSERTOBJECT utilizada para controlar el comportamiento del cuadro de diálogo Insertar objeto.

OLEUIINSERTOBJECT m_io;

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 OLEUIINSERTOBJECT en Windows SDK.

Consulte también

Ejemplo MFC de OCLIENT
COleDialog (clase)
Gráfico de jerarquías
COleDialog (clase)