Estructura OLEUICONVERTW (oledlg.h)
Contiene información que usa la biblioteca de interfaz de usuario OLE para inicializar el cuadro de diálogo Convertir y espacio para que la biblioteca devuelva información cuando se descarte el cuadro de diálogo.
Sintaxis
typedef struct tagOLEUICONVERTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPWSTR lpszUserType;
BOOL fObjectsIconChanged;
LPWSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;
Miembros
cbStruct
El tamaño de la estructura en bytes. Este miembro debe rellenarse en la entrada.
dwFlags
En la entrada, este campo 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.
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 Convert.
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 en el 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 a los que pasa la biblioteca a la función de enlace a la que apunta el miembro lpfnHook . La biblioteca pasa un puntero a la estructura OLEUICONVERT 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 lpszTemplate . Este miembro se omite si el miembro lpszTemplate es NULL o no es válido.
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 Convertir de la biblioteca.
hResource
Identificador de recursos para un cuadro de diálogo personalizado. Si este miembro es NULL, la biblioteca usa la plantilla de cuadro de diálogo Convertir estándar o, si es válida, la plantilla denominada por el miembro lpszTemplate .
clsid
CLSID del objeto que se va a convertir o activar. Este miembro se establece en la entrada.
clsidConvertDefault
CLSID que se va a usar como clase predeterminada cuando se selecciona Convertir en . Este miembro se omite si el miembro dwFlags no incluye CF_SETCONVERTDEFAULT. Este miembro se establece en la entrada.
clsidActivateDefault
CLSID que se va a usar como clase predeterminada cuando se selecciona Activar como . Este miembro se omite si el miembro dwFlags no incluye CF_SETACTIVATEDEFAULT. Este miembro se establece en la entrada.
clsidNew
CLSID de la clase seleccionada. Este miembro se establece en la salida.
dvAspect
Aspecto del objeto . Debe ser DVASPECT_CONTENT o DVASPECT_ICON. Si dvAspect está DVASPECT_ICON en la entrada, se activa la casilla Mostrar como icono y se muestra el icono del objeto. Este miembro se establece en la entrada y salida. Para obtener más información, consulte DVASPECT.
wFormat
Formato de datos del objeto que se va a convertir o activar.
fIsLinkedObject
TRUE si el objeto está vinculado. Este miembro se establece en la entrada.
hMetaPict
MetaFILEPICT que contiene el aspecto icónico. Este miembro se establece en la entrada y salida.
lpszUserType
Puntero al nombre de tipo de usuario del objeto que se va a convertir o activar. Si este valor es NULL, el cuadro de diálogo recuperará el nombre de tipo de usuario del Registro. Esta cadena se libera al salir.
fObjectsIconChanged
TRUE si ha cambiado el icono del objeto. (es decir, si se llamó a OleUIChangeIcon y no se canceló). Este miembro se establece en la salida.
lpszDefLabel
Puntero a la etiqueta predeterminada que se va a usar para el icono. Si es NULL, se usará el nombre de tipo de usuario corto. Si el objeto es un vínculo, el autor de la llamada debe pasar el nombre para mostrar del origen del vínculo. Esto se libera al salir.
cClsidExclude
Número de CLSID en lpClsidExclude.
lpClsidExclude
Puntero a la lista de CLSID que se van a excluir de la lista.
Comentarios
Nota
El encabezado oledlg.h define OLEUICONVERT 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 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 |