CPSUICBPARAM-Struktur (compstui.h)

Die CPSUICBPARAM-Struktur wird als Eingabeparameter verwendet, um Rückruffunktionen vom Typ "-typed" zu _CPSUICALLBACK.

Syntax

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;

Angehörige

cbSize

CPSUI-bereitgestellte Größe in Bytes der CPSUICBPARAM-Struktur.

Reason

CPSUI-bereitgestellter Wert, der angibt, warum sie die Rückruffunktion aufruft. Dies kann einer der folgenden Werte sein:

CPSUICB_REASON_ABOUT

Der Benutzer hat auf die Schaltfläche "Info" der Seite geklickt, und die Anwendung hat zuvor das CPSUIF_ABOUT_CALLBACK Flag in einer COMPROPSHEETUI- Struktur festgelegt. CPSUI legt pCurItem- auf den Wert fest, der in pOptItem-enthalten ist, und legt fest, dass pOldSel auf die COMPROPSHEETUI- Struktur verweist.

CPSUICB_REASON_APPLYNOW

Der Benutzer hat auf die Schaltfläche " anwenden" der Seite geklickt oder Schaltfläche "OK", und CPSUI hat eine PSN_APPLY Benachrichtigung erhalten. CPSUI legt pCurItem- auf die Option zu verweisen, auf die pOptItem Punkte verweist. Außerdem wird OldSel- auf Minus 1 festgelegt, um anzugeben, dass jetzt alle gültigen geänderten Optionswerte angewendet werden sollen.

CPSUICB_REASON_DLGPROC

Die durch pCurItem- identifizierte Option ist eine Schaltfläche (TVOT_PUSHBUTTON Optionstyp), und der Benutzer hat auf die Schaltfläche geklickt.

Das OPTPARAM--Feld der Schaltfläche "OPTPARAM" ist auf PUSHBUTTON_TYPE_DLGPROC festgelegt.

CPSUICB_REASON_ECB_CHANGED

Die durch pCurItem- identifizierte Option ist ein erweitertes Kontrollkästchen, und der Benutzer hat den Status des Kontrollkästchens geändert.

CPSUICB_REASON_EXTPUSH

Die durch pCurItem- identifizierte Option ist eine erweiterte Schaltfläche, und der Benutzer hat auf die Schaltfläche geklickt.

CPSUICB_REASON_ITEMS_REVERTED

Der Benutzer hat auf die Schaltfläche Rückgängig der Seite geklickt, und CPSUI hat alle Auswahlen auf die ursprünglichen Werte zurückgesetzt.

CPSUICB_REASON_KILLACTIVE

Die Eigenschaftenblattseite ist dabei, die Aktivierung zu verlieren, und CPSUI hat eine PSN_KILLACTIVE Benachrichtigung erhalten. CPSUI legt pCurItem- auf den Wert fest, der in pOptItem-enthalten ist, und legt fest, dass pOldSel- auf die COMPROPSHEETUI- Struktur verweist.

CPSUICB_REASON_OPTITEM_SETFOCUS

Die von pCurItem- identifizierte Option hat den Eingabefokus erhalten.

CPSUICB_REASON_PUSHBUTTON

Die durch pCurItem- identifizierte Option ist eine Schaltfläche (TVOT_PUSHBUTTON Optionstyp), und der Benutzer hat auf die Schaltfläche geklickt.

Das OPTPARAM-elementFeld "Style" des Knopfdruckelements wird auf PUSHBUTTON_TYPE_CALLBACK festgelegt.

CPSUICB_REASON_SEL_CHANGED

Der Benutzer hat den ausgewählten Wert für die Option geändert, auf die durch pCurItem-verwiesen wurde.

CPSUICB_REASON_SETACTIVE

Die Eigenschaftenblattseite wird aktiv, und CPSUI hat eine PSN_SETACTIVE Benachrichtigung erhalten. CPSUI legt pCurItem- auf den Wert fest, der in pOptItem-enthalten ist, und legt fest, dass pOldSel- auf die COMPROPSHEETUI- Struktur verweist.

hDlg

CPSUI-bereitgestellter Handle für das derzeit aktive Dialogfeld.

pOptItem

CPSUI-bereitgestellter Zeiger auf ein Array von OPTITEM Strukturen. Dies ist derselbe Zeiger, den die Anwendung zuvor in einer COMPROPSHEETUI- Struktur bereitgestellt hat.

cOptItem

CPSUI-bereitgestellte Anzahl von OPTITEM-Strukturen im Array, auf die durch pOptItemverwiesen wird. Dies ist die gleiche Zahl, die die Anwendung zuvor in einer COMPROPSHEETUI- Struktur bereitgestellt hat.

Flags

CPSUI-bereitgestellte Flags. Dies ist derselbe Satz von Flags, die die Anwendung zuvor in einer COMPROPSHEETUI- Struktur bereitgestellt hat.

pCurItem

CPSUI-bereitgestellter Zeiger auf ein Element des OPTITEM-Arrays, auf das durch pOptItemverweist. Dieses Arrayelement stellt die Option "current" dar, bei der es sich um die Option handelt, für die die Rückruffunktion aufgerufen wurde.

DUMMYUNIONNAME

Definiert die DUMMYUNIONNAME Union.

DUMMYUNIONNAME.OldSel

Wenn das Reason Member CPSUICB_REASON_SEL_CHANGED enthält, legt CPSUI diese Vereinigung auf den vorherigen Inhalt der OldSel/pOldSel Member der OPTITEM- Struktur fest, auf die pCurItem-verweist.

Für alle anderen Grund Werte sollte der Inhalt dieser Vereinigung ignoriert werden.

DUMMYUNIONNAME.pOldSel

Wenn das Reason Member CPSUICB_REASON_SEL_CHANGED enthält, legt CPSUI diese Vereinigung auf den vorherigen Inhalt der OldSel/pOldSel Member der OPTITEM- Struktur fest, auf die pCurItem-verweist.

Für alle anderen Grund Werte sollte der Inhalt dieser Vereinigung ignoriert werden.

UserData

VON CPSUI bereitgestellte Benutzerdaten. Dies ist derselbe Wert, den die Anwendung zuvor in einer COMPROPSHEETUI- Struktur bereitgestellt hat.

Result

Ergebniswert, der von der _CPSUICALLBACK-typed callback function bereitgestellt wird. Standardmäßig legt CPSUI diesen Wert auf CPSUI_OK fest. Nachdem die Rückruffunktion zurückgegeben wurde, ruft CPSUI seine ComPropSheet--Funktion mit einem Funktionscode von CPSFUNC_SET_RESULTauf, wobei der Reason Memberinhalt als Ergebniswert bereitgestellt wird.

Dieses Element wird nur verwendet, wenn das Reason Member CPSUICB_REASON_APPLYNOW ist und die Rückruffunktion keine CPSUI_ACTION_NO_APPLY_EXIT zurückgibt.

Anforderungen