struttura PROPSHEETUI_INFO_HEADER (compstui.h)

  • Articolo

La struttura PROPSHEETUI_INFO_HEADER viene usata come parametro di input per la funzione tipizzata PFNPROPSHEETUI di un'applicazione, quando la funzione viene chiamata con un valore reason di PROPSHEETUI_REASON_GET_INFO_HEADER.

Sintassi

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;

Members

cbSize

Dimensioni fornite da CPSUI, in byte, della struttura PROPSHEETUI_INFO_HEADER .

Flags

Flag di bit facoltativi specificati dall'applicazione che modificano l'aspetto della pagina delle proprietà. I flag elencati nella tabella seguente possono essere usati in qualsiasi combinazione.

Flag Descrizione
PSUIHDRF_DEFTITLE Se impostato, CPSUI deve includere "Default" nella stringa della barra del titolo. CPSUI aggiunge "Default" dopo la stringa pTitle e, se PSUIHDRF_PROPTITLE è impostato, prima di "Proprietà".
PSUIHDRF_EXACT_PTITLE Se impostato, CPSUI usa il testo specificato da pTitle senza modifiche. Questo flag sostituisce PSUIHDRF_DEFTITLE e PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW Se impostato, CPSUI non deve includere un pulsante Applica ora .
PSUIHDRF_PROPTITLE Se impostato, CPSUI deve aggiungere "Proprietà" alla stringa della barra del titolo. Per impostazione predefinita, CPSUI imposta questo flag prima di chiamare l'applicazione.
PSUIHDRF_USEHICON Se impostato, l'unione hIcon/IconID contiene un handle icona. In caso contrario, l'unione contiene un identificatore di risorsa icona.

pTitle

Identificatore stringa, che rappresenta il testo da visualizzare nella barra del titolo della finestra delle proprietà. Può trattarsi di un puntatore a 32 bit a una stringa con terminazione NULL oppure può essere un identificatore di risorsa stringa a 16 bit con HIWORD impostato su zero. Per le DLL dell'interfaccia della stampante, la stringa contiene in genere il nome della stampante.

hWndParent

Handle per la finestra da utilizzare come elemento padre della finestra delle proprietà. Per impostazione predefinita, CPSUI fornisce l'handle di finestra ricevuto per il parametro hWndOwner a CommonPropertySheetUI, ma l'applicazione può sovrascrivere tale handle con un altro.

hInst

Handle di istanza fornito dall'applicazione, che CPSUI usa durante il caricamento delle risorse dell'applicazione.

DUMMYUNIONNAME

Questa unione identifica l'icona da visualizzare nella barra del titolo della finestra delle proprietà.

DUMMYUNIONNAME.hIcon

Definisce l'hIcon membro HICON.

DUMMYUNIONNAME.IconID

Definisce il ULONG_PTR membro IconID. Il membro dell'unione viene selezionato da PSUIHDRF_USEICON in Flag.

Requisiti

Requisito Valore
Intestazione compstui.h (include Compstui.h)