CPSUICBPARAM-Struktur (compstui.h)

Artikel
02/26/2024

Die CPSUICBPARAM-Struktur wird als Eingabeparameter für _CPSUICALLBACK typisierte Rückruffunktionen verwendet.

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;

Member

cbSize

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

Reason

Von CPSUI bereitgestellter Wert, der den Grund angibt, warum die Rückruffunktion aufgerufen wird. Mögliche Werte:

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 in pOptItem und pOldSel so fest, dass er auf die COMPROPSHEETUI-Struktur verweist.

CPSUICB_REASON_APPLYNOW

Der Benutzer hat auf die Schaltfläche Anwenden oder OK der Seite geklickt, und CPSUI hat eine PSN_APPLY Benachrichtigung erhalten. CPSUI legt pCurItem fest, um auf die Option zu verweisen, auf die pOptItem 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 Druckschaltfläche (TVOT_PUSHBUTTON Optionstyp), und der Benutzer hat auf die Schaltfläche geklickt.

Das Feld OPTPARAM-Format der Schaltflächenoption 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 verliert die Aktivierung, und CPSUI hat eine PSN_KILLACTIVE Benachrichtigung erhalten. CPSUI legt pCurItem auf den wert in pOptItem und pOldSel so fest, dass er auf die COMPROPSHEETUI-Struktur verweist.

CPSUICB_REASON_OPTITEM_SETFOCUS

Die durch pCurItem identifizierte Option hat den Eingabefokus erhalten.

CPSUICB_REASON_PUSHBUTTON

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

Das Feld OPTPARAM-Format des Drucktastenelements ist auf PUSHBUTTON_TYPE_CALLBACK festgelegt.

CPSUICB_REASON_SEL_CHANGED

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

CPSUICB_REASON_SETACTIVE

Die Eigenschaftenblattseite wird aktiv, und CPSUI hat eine PSN_SETACTIVE Benachrichtigung erhalten. CPSUI legt pCurItem auf den wert in pOptItem und pOldSel so fest, dass er auf die COMPROPSHEETUI-Struktur verweist.

hDlg

Von CPSUI bereitgestelltes Handle für das derzeit aktive Dialogfeld.

pOptItem

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

cOptItem

Von CPSUI bereitgestellte Anzahl von OPTITEM-Strukturen im Array, auf das pOptItem verweist. Dies ist die gleiche Zahl, die die Anwendung zuvor in einer COMPROPSHEETUI-Struktur bereitgestellt hat.

Flags

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

pCurItem

VON CPSUI bereitgestellter Zeiger auf einen Member des OPTITEM-Arrays, auf das von pOptItem verwiesen wird. Dieses Arraymember stellt die Option "current" dar. Dies ist die Option, für die die Rückruffunktion aufgerufen wurde.

DUMMYUNIONNAME

Definiert die DUMMYUNIONNAME-Union .

DUMMYUNIONNAME.OldSel

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

Bei allen anderen Reason-Werten sollte der Inhalt dieser Union ignoriert werden.

DUMMYUNIONNAME.pOldSel

Bei allen anderen Reason-Werten sollte der Inhalt dieser Union 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-typisierten Rückruffunktion 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 dem Funktionscode CPSFUNC_SET_RESULT auf, wobei der Inhalt des Reason-Elements als Ergebniswert angegeben wird.

Dieser Member wird nur verwendet, wenn der Reason-Member CPSUICB_REASON_APPLYNOW ist und die Rückruffunktion keine CPSUI_ACTION_NO_APPLY_EXIT zurückgibt.

Anforderungen

Anforderung	Wert
Header	compstui.h (include Compstui.h)

Share via