Estructura OLEUIINSERTOBJECTA (oledlg.h)

  • Artículo

Contiene información que la biblioteca de interfaz de usuario OLE usa para inicializar el cuadro de diálogo Insertar objeto y espacio para que la biblioteca devuelva información cuando se descarta el cuadro de diálogo.

Sintaxis

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

Miembros

cbStruct

El tamaño de la estructura en bytes. Este campo debe rellenarse en la entrada.

dwFlags

En la entrada, especifica las marcas de inicialización y creación. Al salir, especifica las opciones del usuario. Puede ser una combinación de las marcas siguientes.

Valor Significado
IOF_SHOWHELP
 El cuadro de diálogo mostrará un botón Ayuda .
IOF_SELECTCREATENEW
 El botón de radio Crear nuevo se comprobará inicialmente. No se puede usar con IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE
 El botón de radio Crear desde archivo se comprobará inicialmente. No se puede usar con IOF_SELECTCREATENEW.
IOF_CHECKLINK
 La casilla Vincular se activará inicialmente.
IOF_CHECKDISPLAYASICON
 La casilla Mostrar como icono se activará inicialmente, se mostrará el icono actual y se habilitará el botón Cambiar icono .
IOF_CREATENEWOBJECT
 Se debe crear un nuevo objeto cuando el usuario seleccione Aceptar para descartar el cuadro de diálogo y se ha seleccionado el botón de radio Crear nuevo .
IOF_CREATEFILEOBJECT
 Se debe crear un nuevo objeto a partir del archivo especificado cuando el usuario selecciona Aceptar para descartar el cuadro de diálogo y se seleccionó el botón de radio Crear desde archivo .
IOF_CREATELINKOBJECT
 Se debe crear un nuevo objeto vinculado cuando el usuario activa Aceptar para descartar el cuadro de diálogo y el usuario activa la casilla Vincular .
IOF_DISABLELINK
 La casilla Vincular se deshabilitará al inicializar.
IOF_VERIFYSERVERSEXIST
 El cuadro de diálogo debe validar las clases que agrega al cuadro de lista asegurándose de que el servidor especificado en la base de datos de registro existe. Se trata de un factor de rendimiento significativo.
IOF_DISABLEDISPLAYASICON
 La casilla Mostrar como icono se deshabilitará al inicializar.
IOF_HIDECHANGEICON
 El botón Cambiar icono se ocultará en el cuadro de diálogo Insertar objeto .
IOF_SHOWINSERTCONTROL
 Muestra el botón de radio Insertar control .
IOF_SELECTCREATECONTROL
 Muestra el botón de radio Crear control .

hWndOwner

Ventana propietaria del cuadro de diálogo. Este miembro no debe ser NULL.

lpszCaption

Puntero a una cadena que se va a usar como título del cuadro de diálogo. Si es NULL, la biblioteca usa Insert Object.

lpfnHook

Puntero a una función de enlace que procesa los mensajes destinados al cuadro de diálogo. La función de enlace debe devolver cero para pasar un mensaje que no se procesó de nuevo al procedimiento del cuadro de diálogo de la biblioteca. La función de enlace debe devolver un valor distinto de cero para evitar que el procedimiento del cuadro de diálogo de la biblioteca procese un mensaje que ya ha procesado.

lCustData

Datos definidos por la aplicación que la biblioteca pasa a la función de enlace a la que apunta el miembro lpfnHook . La biblioteca pasa un puntero a la estructura OLEUIINSERTOBJECT en el parámetro lParam del mensaje WM_INITDIALOG; este puntero se puede usar para recuperar el miembro lCustData .

hInstance

Instancia que contiene una plantilla de cuadro de diálogo especificada por el miembro lpTemplateName .

lpszTemplate

Puntero a una cadena terminada en null que especifica el nombre del archivo de recursos para la plantilla de cuadro de diálogo que se va a sustituir por la plantilla del cuadro de diálogo Insertar objeto de la biblioteca.

hResource

Identificador de plantilla personalizado.

clsid

CLSID para la clase del objeto que se va a insertar. Rellenado en la salida.

lpszFile

Puntero al nombre del archivo que se va a vincular o incrustar. Rellenado en la salida.

cchFile

Tamaño del búfer lpszFile ; no superará MAX_PATH.

cClsidExclude

Número de CLSID incluidos en la lista lpClsidExclude . Rellenado sobre la entrada.

lpClsidExclude

Puntero a una lista de CLSID que se van a excluir de la lista.

iid

Identificador de la interfaz solicitada. Si OleUIInsertObject crea el objeto, devolverá un puntero a esta interfaz. Este parámetro se omite si OleUIInsertObject no crea el objeto .

oleRender

Opción de representación. Si OleUIInsertObject crea el objeto, selecciona la opción de representación cuando crea el objeto. Este parámetro se omite si OleUIInsertObject no crea el objeto .

lpFormatEtc

Formato deseado. Si OleUIInsertObject crea el objeto, selecciona el formato cuando crea el objeto. Este parámetro se omite si OleUIInsertObject no crea el objeto .

lpIOleClientSite

Puntero al sitio cliente que se va a usar para el objeto . Este parámetro se omite si OleUIInsertObject no crea el objeto .

lpIStorage

Puntero al almacenamiento que se va a usar para el objeto . Este parámetro se omite si OleUIInsertObject no crea el objeto .

ppvObj

Dirección de la variable de puntero de salida que contiene el puntero de interfaz para el objeto que se va a insertar. Este parámetro se omite si OleUIInsertObject no crea el objeto .

sc

Resultado de las llamadas de creación. Este parámetro se omite si OleUIInsertObject no crea el objeto .

hMetaPict

Estructura MetafilePict que contiene el aspecto emblemático, si no se colocó en la memoria caché del objeto.

Comentarios

Nota

El encabezado oledlg.h define OLEUIINSERTOBJECT como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado oledlg.h

Consulte también

OleUIInsertObject