struttura PROPSHEETUI_INFO (compstui.h)

La struttura PROPSHEETUI_INFO viene usata come parametro di input per le funzioni tipizzata PFNPROPSHEETUI.

Sintassi

typedef struct _PROPSHEETUI_INFO {
  WORD            cbSize;
  WORD            Version;
  WORD            Flags;
  WORD            Reason;
  HANDLE          hComPropSheet;
  PFNCOMPROPSHEET pfnComPropSheet;
  LPARAM          lParamInit;
  ULONG_PTR       UserData;
  ULONG_PTR       Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;

Members

cbSize

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

Version

Numero di versione fornito da CPSUI della struttura PROPSHEETUI_INFO . Il numero di versione corrente è definito da PROPSHEETUI_INFO_VERSION in compstui.h.

Flags

Flag di bit forniti da CPSUI. Il flag seguente è definito:

Flag	Descrizione
PSUIINFO_UNICODE	Se impostata, l'applicazione chiamante usa caratteri Unicode.

Reason

Costante fornita da CPSUI che specifica l'azione da eseguire nel foglio delle proprietà dalla funzione tipizzata PFNPROPSHEETUI a cui è stata passata la struttura PROPSHEETUI_INFO. Verranno fornite una delle costanti seguenti:

• PROPSHEETUI_REASON_DESTROY

• PROPSHEETUI_REASON_GET_ICON

• PROPSHEETUI_REASON_GET_INFO_HEADER

• PROPSHEETUI_REASON_INIT

• PROPSHEETUI_REASON_SET_RESULT

Per informazioni sul significato di ogni costante, vedere la sezione Osservazioni della descrizione PFNPROPSHEETUI .

hComPropSheet

Handle fornito da CPSUI a un elemento padre del gruppo di fogli di proprietà. Questo handle può essere passato alla funzione ComPropSheet del CPSUI .

pfnComPropSheet

Indirizzo della funzione ComPropSheet di CPSUI .

lParamInit

Valore ricevuto come parametro lParam per la funzione PFNPROPSHEETUI-typed associata, quando la funzione è stata chiamata per la prima volta con un motivo di PROPSHEETUI_REASON_INIT. Per informazioni su ciò che questo valore può essere, vedere la descrizione di PFNPROPSHEETUI.

Questo valore viene fornito da CPSUI ed è valido per tutti i valori Reason .

UserData

Facoltativo, valore privato o puntatore fornito dalla funzione PFNPROPSHEETUI-typed associata, inizialmente impostata su zero da CPSUI. Se la funzione archivia un valore in UserData, per le chiamate successive alla funzione, il valore archiviato o il puntatore non viene modificato a meno che non venga modificato dalla funzione.

Result

Valore risultato fornito dalla funzione PFNPROPSHEETUI-typed associata, inizialmente impostata su zero da CPSUI. Se la funzione archivia un valore di risultato in Result, per le chiamate successive alla funzione, il valore archiviato non viene modificato a meno che non venga modificato dalla funzione.

Se l'indirizzo della funzione PFNPROPSHEETUI-typed è stato specificato come argomento commonPropertySheetUI, l'ultimo valore archiviato in Result viene restituito a CommonPropertySheetUI nella posizione a cui punta il relativo argomento pResult .

Requisiti

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