Estructura OLEUICHANGEICONW (oledlg.h)

Contiene información que usa la biblioteca de interfaz de usuario OLE para inicializar el cuadro de diálogo Cambiar icono y contiene espacio para que la biblioteca devuelva información cuando se descarte el cuadro de diálogo.

Sintaxis

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

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
CIF_SHOWHELP	El cuadro de diálogo mostrará un botón Ayuda .
CIF_SELECTCURRENT	En la entrada, selecciona el botón de radio Actual al inicializar. Al salir, especifica que el usuario seleccionó Actual.
CIF_SELECTDEFAULT	En la entrada, selecciona el botón de radio Predeterminado en la inicialización. Al salir, especifica que el usuario seleccionó Predeterminado.
CIF_SELECTFROMFILE	En la entrada, selecciona el botón de radio From File (Desde archivo ) al inicializar. Al salir, especifica que el usuario seleccionó Desde archivo.
CIF_USEICONEXE	Solo entrada. Extrae el icono del archivo ejecutable especificado en el miembro szIconExe , en lugar de recuperarlo de la clase . Esto es útil para insertar OLE o vincular a archivos que no son OLE.

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 Cambiar icono.

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 OLEUICHANGEICON 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 de la plantilla de cuadro de diálogo que se va a sustituir por la plantilla del cuadro de diálogo Cambiar icono de la biblioteca.

hResource

Identificador de plantilla personalizado.

hMetaPict

Imagen actual y final. El origen del icono se incrusta en el propio metarchivo.

clsid

Solo entrada. Clase que se va a usar para obtener el icono Predeterminado .

szIconExe[MAX_PATH]

Solo entrada. Puntero al archivo ejecutable del que se va a extraer el icono predeterminado. Este miembro se omite a menos que CIF_USEICONEXE se incluya en el miembro dwFlags y se produzca un error al intentar recuperar el icono de clase del CLSID especificado.

cchIconExe

Solo entrada. Número de caracteres de szIconExe. Este miembro se omite a menos que se incluya CIF_USEICONEXE en el miembro dwFlags .

Comentarios

Nota

El encabezado oledlg.h define OLEUICHANGEICON 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	compilación 20348 de Windows 10
Servidor mínimo compatible	compilación 20348 de Windows 10
Encabezado	oledlg.h