TVOT_PUSHBUTTON
Wichtig
Die Modern Print-Plattform ist die von Windows bevorzugte Methode zur Kommunikation mit Druckern. Wir empfehlen die Verwendung des Microsoft IPP-Treibers für die Posteingangsklasse zusammen mit Print Support Apps (PSA), um das Druckverhalten in Windows 10 und 11 für die Entwicklung von Druckergeräten anzupassen.
Weitere Informationen finden Sie unter Modern Print-Plattform und der Anleitung zum Design der Print-Support-App.
Der TVOT_PUSHBUTTON-Optionstyp besteht aus einer Knopfdruck-Taste innerhalb eines Gruppenfelds.
OPTITEM-Struktur
Sel/pSel
Hängt vom Style-Element der OPTPARAM-Struktur wie folgt ab.
| Knopfdruck-Stil | Sel/pSel-Verwendung |
|---|---|
| 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 Halftoning-Vorgangs. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI speichert den Rückgabewert des Halftoning-Vorgangs. |
OPTPARAM-Strukturarray (pOptParam-Element von OPTTYPE)
pData
Hängt vom Style-Element wie folgt ab.
| Knopfdruck-Stil | pData-Verwendung |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Zeiger auf eine _CPSUICALLBACK-Typ-Funktion. |
| PUSHBUTTON_TYPE_DLGPROC | DLGPROC-typierter Zeiger auf eine Dialogfeldprozedur (siehe Microsoft Windows SDK-Dokumentation). |
| PUSHBUTTON_TYPE_HTCLRADJ | Zeiger auf COLORADJUSTMENT-Struktur (in der Windows SDK-Dokumentation beschrieben). |
| PUSHBUTTON_TYPE_HTSETUP | Zeiger auf eine DEVHTADJDATA-Struktur. |
IconID
Identifiziert ein Symbol, das der Drucktaste zugeordnet werden soll.
lParam Hängt wie folgt vom Style-Element wie Folgt ab.
| Knopfdruck-Stil | lParam-Verwendung |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Wird nicht verwendet. |
| PUSHBUTTON_TYPE_DLGPROC | Ressourcenbezeichner für eine DIALOG-Ressource oder Handle für eine DLGTEMPLATE-Struktur (siehe Windows SDK-Dokumentation). Hängt vom DPF_USE_HDLGTEMPLATE Flag im Flags-Element der OPTPARAM-Struktur ab. |
| PUSHBUTTON_TYPE_HTCLRADJ | Wird nicht verwendet. |
| PUSHBUTTON_TYPE_HTSETUP | Wird nicht verwendet. |
| Begriff | Beschreibung |
|---|---|
| Stil | Gibt den Vorgang an, der von CPSUI ausgeführt werden soll, wenn ein Benutzer auf den Druckknopf klickt. Folgenden Werte sind möglich: |
| PUSHBUTTON_TYPE_CALLBACK | CPSUI ruft die Rückruffunktion vom Typ _CPSUICALLBACK der Anwendung auf, um Schaltflächenereignisse zu verarbeiten, wobei das Element Reason der Struktur CPSUICBPARAM auf CPSUICB_REASON_PUSHBUTTON gesetzt ist. (CPSUI ignoriert den Rückgabewert der Rückruffunktion.) |
| PUSHBUTTON_TYPE_DLGPROC | Die Dialogfeldprozedur der Anwendung behandelt Schaltflächenereignisse. (Weitere Informationen finden Sie Im Abschnitt Bemerkungen für DLGPAGE.) Wenn die Funktion eine WM_INITDIALOG -Nachricht empfängt, zeigt die lParam Argumentation auf eine CPSUICBPARAM Struktur mit dem Grund-Element auf CPSUICB_REASON_DLGPROC festgelegt. |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI zeigt ein Dialogfeld zur Farbanpassung in Halbton an. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI zeigt ein Dialogfeld zum Einrichten von Halbtongeräten an. |
OPTTYPE-Struktur
Typ TVOT_PUSHBUTTON
Count 1
Style Die folgenden optionalen Bitkennzeichnungen können angegeben werden.
| Flag | Beschreibung |
|---|---|
| OTS_PUSH_ENABLE_ALWAYS | Wenn festgelegt, ist die Knopfdrucktaste immer aktiviert, auch wenn der Benutzer die Eigenschaftenblattseite nicht ändern kann (d. a. auch wenn CPSUIF_UPDATE_PERMISSION nicht in einer COMPROPSHEETUI-Struktur festgelegt ist). Die Rückruffunktion der Schaltfläche muss das Dialogfeld anzeigen, darf jedoch keine Benutzeränderungen zulassen. Beachten Sie, dass Sie dieses Kennzeichen auch im Flags-Element 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 BegCtrlID den ersten Steuerelementbezeichner einer sequenziell nummerierten Gruppe von Steuerelementbezeichnern enthalten. Steuerelementbezeichner müssen die folgenden Windows-Steuerelemente identifizieren:
| Steuerelementbezeichner | Windows-Steuerelement |
|---|---|
| BegCtrlID-Inhalte | Gruppenfeld |
| BegCtrlID-Inhalte +1 | Titeltext |
| BegCtrlID-Inhalte +2 | Druckknopffeld |
| BegCtrlID-Inhalte +3 | Druckknopfsymbol |
| BegCtrlID-Inhalte +4 | Erweitertes Kontrollkästchen oder erweiterte Knopfdruck (optional) |
| BegCtrlID-Inhalte +5 | Erweitertes Kontrollkästchen oder erweitertes Druckknopfsymbol (optional) |
Weitere Informationen finden Sie unter Anpassen von CPSUI-unterstützten Fenstersteuerelementen.
Anforderungen
Kopfzeile: compstui.h (include Compstui.h)