Estructura OLEUIINSERTOBJECTA (oledlg.h)

Artículo
11/20/2024

Contiene información que usa la biblioteca de interfaz de usuario OLE 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

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 activará inicialmente. No se puede usar con IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE	El botón de radio Crear desde archivo se activará inicialmente. No se puede usar con IOF_SELECTCREATENEW.
IOF_CHECKLINK	La casilla Vínculo se activará inicialmente.
IOF_CHECKDISPLAYASICON	Inicialmente, se activará la casilla Mostrar como icono, se mostrará el icono actual y se habilitará el botón Cambiar icono.
IOF_CREATENEWOBJECT	Se debe crear un nuevo objeto cuando el usuario selecciona 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 seleccione Aceptar para descartar el cuadro de diálogo y el usuario active la casilla Vínculo.
IOF_DISABLELINK	La casilla vínculo 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 NULL , la biblioteca usa Insertar objeto.

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 haya procesado.

lCustData

Datos definidos por la aplicación a los que la biblioteca pasa a la función de enlace a la que apunta el miembro de lpfnHook. La biblioteca pasa un puntero a la estructura de OLEUIINSERTOBJECT en el parámetro lParam del mensaje de 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 de cuadro de diálogo insertar objeto de la biblioteca plantilla de cuadro de diálogo.

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 de lpszFile; no superará MAX_PATH.

cClsidExclude

Número de CLSID incluidos en la lista de lpClsidExclude . Rellenado en 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 ha colocado en la memoria caché del objeto.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	oledlg.h

Consulte también

OleUIInsertObject

Compartir a través de