Struttura CPSUICBPARAM (compstui.h)

La struttura CPSUICBPARAM viene usata come parametro di input per _CPSUICALLBACKfunzioni di callback tipizzato.

Sintassi

typedef struct _CPSUICBPARAM {
  WORD      cbSize;
  WORD      Reason;
  HWND      hDlg;
  POPTITEM  pOptItem;
  WORD      cOptItem;
  WORD      Flags;
  POPTITEM  pCurItem;
  union {
    LONG   OldSel;
    LPTSTR pOldSel;
  } DUMMYUNIONNAME;
  ULONG_PTR UserData;
  ULONG_PTR Result;
} CPSUICBPARAM, *PCPSUICBPARAM;

Membri

cbSize

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

Reason

Valore fornito da CPSUI che indica il motivo per cui sta chiamando la funzione di callback. Può trattarsi di uno dei valori seguenti:

CPSUICB_REASON_ABOUT

L'utente ha fatto clic sul pulsante Informazioni sull' della pagina e l'applicazione ha impostato in precedenza il flag CPSUIF_ABOUT_CALLBACK in una struttura COMPROPSHEETUI. CPSUI imposta pCurItem sul valore contenuto in pOptIteme imposta pOldSel in modo che punti alla struttura COMPROPSHEETUI.

CPSUICB_REASON_APPLYNOW

L'utente ha fatto clic sul pulsante Applica o OK della pagina e CPSUI ha ricevuto un messaggio di notifica PSN_APPLY. CPSUI imposta pCurItem in modo da puntare all'opzione a cui punti pOptItem. Imposta anche OldSel su meno uno per indicare che tutti i valori di opzione modificati validi devono essere applicati ora.

CPSUICB_REASON_DLGPROC

L'opzione identificata da pCurItem è un pulsante di scelta rapida (TVOT_PUSHBUTTON tipo di opzione) e l'utente ha fatto clic sul pulsante.

Il campo Stile OPTPARAM dell'opzione del pulsante di scelta è impostato su PUSHBUTTON_TYPE_DLGPROC.

CPSUICB_REASON_ECB_CHANGED

L'opzione identificata da pCurItem è una casella di controllo estesa e l'utente ha modificato lo stato della casella.

CPSUICB_REASON_EXTPUSH

L'opzione identificata da pCurItem è un pulsante di pressione esteso e l'utente ha fatto clic sul pulsante.

CPSUICB_REASON_ITEMS_REVERTED

L'utente ha fatto clic sul pulsante Annulla della pagina e CPSUI ha ripristinato tutti i valori originali.

CPSUICB_REASON_KILLACTIVE

La pagina della finestra delle proprietà sta per perdere l'attivazione e CPSUI ha ricevuto un messaggio di notifica PSN_KILLACTIVE. CPSUI imposta pCurItem sul valore contenuto in pOptIteme imposta pOldSel in modo che punti alla struttura COMPROPSHEETUI .

CPSUICB_REASON_OPTITEM_SETFOCUS

L'opzione identificata da pCurItem ha ricevuto lo stato attivo per l'input.

CPSUICB_REASON_PUSHBUTTON

L'opzione identificata da pCurItem è un pulsante di scelta rapida (TVOT_PUSHBUTTON tipo di opzione) e l'utente ha fatto clic sul pulsante.

Il campo stile OPTPARAM del pulsante di scelta è impostato su PUSHBUTTON_TYPE_CALLBACK.

CPSUICB_REASON_SEL_CHANGED

L'utente ha modificato il valore selezionato per l'opzione a cui punta pCurItem.

CPSUICB_REASON_SETACTIVE

La pagina della finestra delle proprietà sta per diventare attiva e CPSUI ha ricevuto un messaggio di notifica PSN_SETACTIVE. CPSUI imposta pCurItem sul valore contenuto in pOptIteme imposta pOldSel in modo che punti alla struttura COMPROPSHEETUI .

hDlg

Handle fornito da CPSUI nella finestra di dialogo attualmente attiva.

pOptItem

Puntatore fornito da CPSUI a una matrice di strutture OPTITEM. Si tratta dello stesso puntatore fornito in precedenza dall'applicazione in una struttura COMPROPSHEETUI .

cOptItem

Numero fornito da CPSUI di strutture OPTITEM nella matrice a cui punta pOptItem. Si tratta dello stesso numero fornito in precedenza dall'applicazione in una struttura COMPROPSHEETUI .

Flags

Flag forniti da CPSUI. Si tratta dello stesso set di flag forniti in precedenza dall'applicazione in una struttura COMPROPSHEETUI .

pCurItem

Puntatore fornito da CPSUI a un membro della matrice OPTITEM a cui punta pOptItem. Questo membro della matrice rappresenta l'opzione "corrente", ovvero quella per cui è stata chiamata la funzione di callback.

DUMMYUNIONNAME

Definisce l'unione DUMMYUNIONNAME.

DUMMYUNIONNAME.OldSel

Se il membro Reason contiene CPSUICB_REASON_SEL_CHANGED, CPSUI imposta questa unione sul contenuto precedente del OldSelpOldSel membro della struttura OPTITEM a cui punta pCurItem.

Per tutti gli altri valori Motivo, il contenuto di questa unione deve essere ignorato.

DUMMYUNIONNAME.pOldSel

Se il membro Reason contiene CPSUICB_REASON_SEL_CHANGED, CPSUI imposta questa unione sul contenuto precedente del OldSelpOldSel membro della struttura OPTITEM a cui punta pCurItem.

Per tutti gli altri valori Motivo, il contenuto di questa unione deve essere ignorato.

UserData

Dati utente forniti da CPSUI. Si tratta dello stesso valore fornito in precedenza dall'applicazione in una struttura COMPROPSHEETUI.

Result

Valore del risultato fornito dalla funzione di callback _CPSUICALLBACKtipizzata. Per impostazione predefinita, CPSUI imposta questo valore su CPSUI_OK. Al termine della funzione di callback, CPSUI chiama la funzione ComPropSheet con un codice di funzione di CPSFUNC_SET_RESULT, specificando il contenuto del membro Motivo come valore del risultato.

Questo membro viene utilizzato solo se il membro motivo è CPSUICB_REASON_APPLYNOW e la funzione di callback non restituisce CPSUI_ACTION_NO_APPLY_EXIT.

Fabbisogno