Estructura OLEUICONVERTA (oledlg.h)

  • Artículo

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 descarta el cuadro de diálogo.

Sintaxis

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

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.

Valor Significado
CF_SHOWHELPBUTTON
 El cuadro de diálogo mostrará un botón Ayuda . Esta marca se establece en la entrada.
CF_SETCONVERTDEFAULT
 La clase cuyo CLSID se especifica mediante clsidConvertDefault se usará como selección predeterminada. Esta selección aparece en el cuadro de lista de clases cuando se selecciona el botón de radio Convertir a. Esta marca se establece en la entrada.
CF_SETACTIVATEDEFAULT
 La clase cuyo CLSID se especifica mediante clsidActivateDefault se usará como selección predeterminada. Esta selección aparece en el cuadro de lista de clases cuando se selecciona el botón de radio Activar como . Esta marca se establece en la entrada.
CF_SELECTCONVERTTO
 En la entrada, esta marca especifica que convertir en se seleccionará inicialmente (comportamiento predeterminado). Esta marca se establece en la salida si se seleccionó Convertir en cuando el usuario despidió el cuadro de diálogo.
CF_SELECTACTIVATEAS
 En la entrada, esta marca especifica que activar como se seleccionará inicialmente. Esta marca se establece en la salida si se seleccionó Activar como cuando el usuario despidió el cuadro de diálogo.
CF_DISABLEDISPLAYASICON
 El botón Mostrar como icono se deshabilitará al inicializar.
CF_DISABLEACTIVATEAS
 El botón de radio Activar como se deshabilitará al inicializar.
CF_HIDECHANGEICON
 El botón Cambiar icono se ocultará en el cuadro de diálogo Convertir .
CF_CONVERTONLY
 El botón de radio Activar como se deshabilitará en el cuadro de diálogo Convertir .

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 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 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 emblemático. 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 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

OleUIChangeIcon

OleUIConvert