Struttura CPSUICBPARAM (compstui.h)

La struttura CPSUICBPARAM viene usata come parametro di input per _CPSUICALLBACK funzioni di callback tipizzata.

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;

Members

cbSize

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

Reason

Valore fornito da CPSUI che indica il motivo per cui chiama la funzione di callback. I valori possibili sono i seguenti:

CPSUICB_REASON_ABOUT

L'utente ha fatto clic sul pulsante About della pagina e l'applicazione in precedenza imposta il flag di CPSUIF_ABOUT_CALLBACK in una struttura COMPROPSHEETUI . CPSUI imposta pCurItem sul valore contenuto in pOptItem e imposta pOldSel per puntare 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 per puntare all'opzione a cui pOptItem punta. Imposta anche OldSel su meno uno per indicare che tutti i valori delle opzioni modificati validi devono essere applicati ora.

CPSUICB_REASON_DLGPROC

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

Il campo Stile OPTPARAM dell'opzione pulsante è 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 push 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 tutte le selezioni ai valori originali.

CPSUICB_REASON_KILLACTIVE

La pagina del foglio delle proprietà sta per perdere l'attivazione e CPSUI ha ricevuto un messaggio di notifica PSN_KILLACTIVE . CPSUI imposta pCurItem sul valore contenuto in pOptItem e imposta pOldSel per puntare alla struttura COMPROPSHEETUI .

CPSUICB_REASON_OPTITEM_SETFOCUS

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

CPSUICB_REASON_PUSHBUTTON

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

Il campo Stile OPTPARAM dell'elemento del pulsante di push è impostato su PUSHBUTTON_TYPE_CALLBACK.

CPSUICB_REASON_SEL_CHANGED

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

CPSUICB_REASON_SETACTIVE

La pagina del foglio delle proprietà sta per diventare attiva e CPSUI ha ricevuto un messaggio di notifica PSN_SETACTIVE . CPSUI imposta pCurItem sul valore contenuto in pOptItem e imposta pOldSel per puntare 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 fa riferimento pOptItem. Si tratta dello stesso numero fornito dall'applicazione in precedenza 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 fa riferimento 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 membro OldSel/pOldSel della struttura OPTITEM a cui fa riferimento 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 membro OldSel/pOldSel della struttura OPTITEM a cui fa riferimento 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 tipizzata _CPSUICALLBACK. Per impostazione predefinita, CPSUI imposta questo valore su CPSUI_OK. Dopo aver restituito la funzione 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 usato solo se il membro Reason è CPSUICB_REASON_APPLYNOW e la funzione di callback non restituisce CPSUI_ACTION_NO_APPLY_EXIT.

Requisiti

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