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 descarta 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

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 en la inicialización. Al salir, especifica que el usuario seleccionado Current.
CIF_SELECTDEFAULT	En la entrada, selecciona la botón de radio Predeterminado en la inicialización. Al salir, especifica que el usuario seleccionado Valor predeterminado.
CIF_SELECTFROMFILE	En la entrada, selecciona el botón de radio Desde archivo al inicializar. Al salir, especifica que el usuario seleccionado 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 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 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 OLEUICHANGEICON 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 del cuadro de diálogo que se va a sustituir por la plantilla de cuadro de diálogo cambiar icono de la biblioteca plantilla de cuadro de diálogo.

hResource

Identificador de plantilla personalizado.

hMetaPict

Imagen actual y final. El origen del icono está incrustado en el propio metarchivo.

clsid

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

szIconExe[MAX_PATH]

Solo entrada. Puntero al archivo ejecutable para 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 de .

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compilación 20348 de Windows 10
servidor mínimo admitido	Compilación 20348 de Windows 10
encabezado de	oledlg.h