estructura PROPSHEETUI_INFO_HEADER (compstui.h)

La estructura PROPSHEETUI_INFO_HEADER se usa como parámetro de entrada para la función con tipo PFNPROPSHEETUI de una aplicación, cuando se llama a la función con un valor de motivo de PROPSHEETUI_REASON_GET_INFO_HEADER.

Sintaxis

typedef struct _PROPSHEETUI_INFO_HEADER {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  HWND      hWndParent;
  HINSTANCE hInst;
  union {
    HICON     hIcon;
    ULONG_PTR IconID;
  } DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;

Miembros

cbSize

Tamaño proporcionado por CPSUI, en bytes, de la estructura PROPSHEETUI_INFO_HEADER .

Flags

Marcas de bits especificadas por la aplicación opcionales que modifican la apariencia de la página de la hoja de propiedades. Las marcas enumeradas en la tabla siguiente se pueden usar en cualquier combinación.

Marca Descripción
PSUIHDRF_DEFTITLE Si se establece, CPSUI debe incluir "Default" en la cadena de barra de título. CPSUI agrega "Default" después de la cadena pTitle y, si se establece PSUIHDRF_PROPTITLE, antes de "Properties".
PSUIHDRF_EXACT_PTITLE Si se establece, CPSUI usa el texto especificado por pTitle sin modificaciones. Esta marca invalida PSUIHDRF_DEFTITLE y PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW Si se establece, CPSUI no debe incluir un botón Aplicar ahora .
PSUIHDRF_PROPTITLE Si se establece, CPSUI debe anexar "Propiedades" a la cadena de barra de título. (De forma predeterminada, CPSUI establece esta marca antes de llamar a la aplicación).
PSUIHDRF_USEHICON Si se establece, la unióniconIDde hIcon/ contiene un identificador de icono. Si no se establece, la unión contiene un identificador de recurso de icono.

pTitle

Identificador de cadena, que representa el texto que se va a mostrar en la barra de título de la hoja de propiedades. Puede ser un puntero de 32 bits a una cadena terminada en NULL o puede ser un identificador de recurso de cadena de 16 bits con HIWORD establecido en cero. En el caso de los archivos DLL de interfaz de impresora, la cadena normalmente contiene el nombre de la impresora.

hWndParent

Identificador de la ventana que se va a usar como elemento primario de la hoja de propiedades. De forma predeterminada, CPSUI proporciona el identificador de ventana que recibió para el parámetro hWndOwner a CommonPropertySheetUI, pero la aplicación puede sobrescribir ese identificador con otro.

hInst

Identificador de instancia proporcionado por la aplicación, que CPSUI usa al cargar recursos de aplicación.

DUMMYUNIONNAME

Esta unión identifica el icono que se va a mostrar en la barra de título de la hoja de propiedades.

DUMMYUNIONNAME.hIcon

Define el hIcon miembro HICON.

DUMMYUNIONNAME.IconID

Define el ULONG_PTR miembro IconID. El miembro de unión está seleccionado por PSUIHDRF_USEICON en Marcas.

Requisitos

Requisito Valor
Header compstui.h (incluya Compstui.h)