Estructura OLEUICONVERTW (oledlg.h)

Contiene información que usa la biblioteca de interfaz de usuario OLE para inicializar el cuadro de diálogo Convertir de y espacio para que la biblioteca devuelva información cuando se descarta 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

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 NULL , la biblioteca usa Convertir.

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 OLEUICONVERT 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 de lpszTemplate. Este miembro se omite si el miembro de 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 del cuadro de diálogo que se va a sustituir por la plantilla del cuadro de diálogo convertir 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 dwFlags miembro 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, vea 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

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

Observaciones

Requisitos

Consulte también

oleUIChangeIcon

oleUIConvert