TVOT_PUSHBUTTON

Artikel
03/08/2023

Wichtig

Es wird empfohlen, den IPP-Posteingangsklassentreiber von Microsoft zusammen mit Druckunterstützungs-Apps (PSA) zu verwenden, um die Druckoberfläche in Windows 10 und 11 für die Druckergeräteentwicklung anzupassen.

Weitere Informationen finden Sie im Designhandbuch für Druckunterstützungs-Apps.

Der optionstyp TVOT_PUSHBUTTON besteht aus einer Drucktaste in einem Gruppenfeld.

OPTITEM-Struktur

Sel/pSel
Hängt wie folgt vom Style-Element der OPTPARAM-Struktur ab.

Schaltflächenformat	Sel/pSel-Nutzung
PUSHBUTTON_TYPE_CALLBACK	Wird nicht verwendet.
PUSHBUTTON_TYPE_DLGPROC	CPSUI speichert den Rückgabewert der Dialogfeldprozedur.
PUSHBUTTON_TYPE_HTCLRADJ	CPSUI speichert den Rückgabewert des Halftoningvorgangs.
PUSHBUTTON_TYPE_HTSETUP	CPSUI speichert den Rückgabewert des Halftoningvorgangs.

OPTPARAM-Strukturarray (pOptParam-Member von OPTTYPE)

Pdata
Hängt wie folgt vom Style-Element ab.

Schaltflächenformat	pData-Nutzung
PUSHBUTTON_TYPE_CALLBACK	Zeiger auf eine _CPSUICALLBACK-typisierte Funktion.
PUSHBUTTON_TYPE_DLGPROC	DLGPROC-typisierter Zeiger auf eine Dialogfeldprozedur (siehe Microsoft Windows SDK Dokumentation).
PUSHBUTTON_TYPE_HTCLRADJ	Zeiger auf die COLORADJUSTMENT-Struktur (in der Windows SDK-Dokumentation beschrieben).
PUSHBUTTON_TYPE_HTSETUP	Zeiger auf eine DEVHTADJDATA-Struktur .

IconID
Gibt ein Symbol an, das der Drucktaste zugeordnet werden soll.

Lparam Hängt wie folgt vom Style-Element ab.

Schaltflächenformat	lParam-Verwendung
PUSHBUTTON_TYPE_CALLBACK	Wird nicht verwendet.
PUSHBUTTON_TYPE_DLGPROC	Ressourcenbezeichner für eine DIALOG-Ressource oder handle mit einer DLGTEMPLATE-Struktur (siehe Windows SDK-Dokumentation). Hängt vom DPF_USE_HDLGTEMPLATE Flags im Flags-Element der OPTPARAM-Struktur ab.
PUSHBUTTON_TYPE_HTCLRADJ	Wird nicht verwendet.
PUSHBUTTON_TYPE_HTSETUP	Wird nicht verwendet.

Begriff	BESCHREIBUNG
Style	Gibt den Vorgang an, der von CPSUI ausgeführt werden soll, wenn ein Benutzer auf die Schaltfläche klickt. Folgenden Werte sind möglich:
PUSHBUTTON_TYPE_CALLBACK	CPSUI ruft die _CPSUICALLBACK-typisierte Rückruffunktion der Anwendung auf, um Schaltflächenereignisse zu behandeln, wobei das Reason-Element der CPSUICBPARAM-Struktur auf CPSUICB_REASON_PUSHBUTTON festgelegt ist. (CPSUI ignoriert den Rückgabewert der Rückruffunktion.)
PUSHBUTTON_TYPE_DLGPROC	Die Dialogfeldprozedur der Anwendung verarbeitet Schaltflächenereignisse. (Weitere Informationen finden Sie im Abschnitt Hinweise zu DLGPAGE.) Wenn die Funktion eine WM_INITDIALOG Nachricht empfängt, verweist ihr lParam-Argument auf eine CPSUICBPARAM-Struktur , wobei das Reason-Element auf CPSUICB_REASON_DLGPROC festgelegt ist.
PUSHBUTTON_TYPE_HTCLRADJ	CPSUI zeigt ein Dialogfeld zur Anpassung der Halbtonfarbe an.
PUSHBUTTON_TYPE_HTSETUP	CPSUI zeigt ein Dialogfeld zum Einrichten von Halbton des Geräts an.

OPTTYPE-Struktur

Typ TVOT_PUSHBUTTON

Anzahl 1

Stil Die folgenden optionalen Bitflags können angegeben werden.

Flag	Beschreibung
OTS_PUSH_ENABLE_ALWAYS	Wenn festgelegt, ist die Schaltfläche immer aktiviert, auch wenn der Benutzer die Eigenschaftenblattseite nicht ändern kann (selbst wenn CPSUIF_UPDATE_PERMISSION in einer COMPROPSHEETUI-Struktur nicht festgelegt ist). Die Rückruffunktion der Schaltfläche muss das Dialogfeld anzeigen, darf jedoch keine Benutzeränderungen zulassen. Beachten Sie, dass Sie dieses Flag auch im Flags-Member der OPTTYPE-Struktur festlegen müssen.
OTS_PUSH_INCL_SETUP_TITLE	Wenn festgelegt, enthält CPSUI das Wort "Setup" nach der Namenszeichenfolge der Schaltfläche (pName in OPTITEM).
OTS_PUSH_NO_DOT_DOT_DOT	Wenn festgelegt, enthält CPSUI drei Punkte (...) nach der Namenszeichenfolge der Schaltfläche (pName in OPTITEM).

BegCtrlID
Wenn pDlgPage in COMPROPSHEETUI eine von CPSUI bereitgestellte Seite identifiziert oder wenn DlgTemplateID in DLGPAGE eine von CPSUI bereitgestellte Vorlage identifiziert, wird BegCtrlID nicht verwendet. Andernfalls muss Die BegCtrlID den ersten Steuerelementbezeichner eines sequenziell nummerierten Satz von Steuerelementbezeichnern enthalten. Steuerelementbezeichner müssen die folgenden Windows-Steuerelemente identifizieren:

Steuerelementbezeichner	Windows-Steuerelement
Inhalt von BegCtrlID	Gruppenfeld
Inhalt der BegCtrlID +1	Titeltext
Inhalt der BegCtrlID +2	Schaltflächenfeld
Inhalt der BegCtrlID +3	Schaltflächensymbol
Inhalt der BegCtrlID +4	Erweitertes Kontrollkästchen oder erweiterte Drucktaste (optional)
Inhalt der BegCtrlID +5	Erweitertes Kontrollkästchen oder erweitertes Schaltflächensymbol (optional)