Condividi tramite

struttura PROPSHEETUI_INFO (compstui.h)

  • Articolo

La struttura PROPSHEETUI_INFO viene utilizzata come parametro di input per funzioni PFNPROPSHEETUI-typed.

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;

Membri

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. Viene definito il flag seguente:

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

Reason

Costante fornita da CPSUI che specifica l'azione da eseguire nella finestra delle proprietà dal PFNPROPSHEETUIfunzione tipizzata a cui è stata passata la struttura PROPSHEETUI_INFO. Verrà fornita 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 PFNPROPSHEETUI descrizione.

hComPropSheet

Handle fornito da CPSUI in una finestra delle proprietà gruppo padre. Questo handle può essere passato alla funzione di ComPropSheet CPSUI.

pfnComPropSheet

Indirizzo della funzione ComPropSheet CPSUI.

lParamInit

Valore ricevuto come parametro lParam per la funzione tipizzata PFNPROPSHEETUI associata, quando la funzione è stata chiamata per la prima volta con un Reason 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

Valore facoltativo, privato o puntatore fornito dal PFNPROPSHEETUIfunzione tipizzata, inizialmente impostata su zero da CPSUI. Se la funzione archivia un valore in UserData, per le chiamate successive alla funzione, il valore o il puntatore archiviato non viene modificato a meno che non venga modificato dalla funzione.

Result

Valore del risultato fornito dall'PFNPROPSHEETUIfunzione tipizzata inizialmente impostata su zero da CPSUI. Se la funzione archivia un valore del risultato in Result, per le chiamate successive alla funzione, il valore archiviato viene modificato a meno che non venga modificato dalla funzione.

Se l'indirizzo della funzione tipizzata PFNPROPSHEETUI è stato specificato come argomento per CommonPropertySheetUI, l'ultimo valore archiviato in Result viene restituito a CommonPropertySheetUI nel percorso a cui punta il relativo argomento pResult.

Fabbisogno

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