TVOT_PUSHBUTTON
重要
新式列印平臺是 Windows 與印表機通訊的慣用方法。 我們建議您使用Microsoft的 IPP 收件匣類別驅動程式，以及列印支援應用程式 （PSA），自定義 Windows 10 和 11 中的列印體驗，以進行印表機裝置開發。
如需詳細資訊，請參閱 新式列印平臺 和 列印支援應用程式設計指南。
TVOT_PUSHBUTTON選項類型是由群組方塊內的按鈕所組成。
OPTITEM 結構
Sel/pSel
視 OPTPARAM 結構的 Style 成員而定，如下所示。
| 按鈕樣式 | Sel/pSel 使用量 |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | 未使用。 |
| PUSHBUTTON_TYPE_DLGPROC | CPSUI 會儲存對話框程序的傳回值。 |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI 會儲存半場運算的傳回值。 |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI 會儲存半場運算的傳回值。 |
OPTPARAM 結構陣列 （OPTTYPE 的 pOptParam 成員）
pData
視 Style 成員而定，如下所示。
| 按鈕樣式 | pData 使用量 |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | _CPSUICALLBACK型別函式的指標。 |
| PUSHBUTTON_TYPE_DLGPROC | 對話框程式的 DLGPROC 型別指標（請參閱Microsoft Windows SDK 檔）。 |
| PUSHBUTTON_TYPE_HTCLRADJ | COLORADJUSTMENT 結構的指標（如 Windows SDK 檔所述）。 |
| PUSHBUTTON_TYPE_HTSETUP | DEVHTADJDATA 結構的指標。 |
IconID
識別要與按鈕相關聯的圖示。
lParam 相依於 Style 成員，如下所示。
| 按鈕樣式 | lParam 使用方式 |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | 未使用。 |
| PUSHBUTTON_TYPE_DLGPROC | DIALOG 資源的資源標識碼，或 DLGTEMPLATE 結構的句柄（請參閱 Windows SDK 檔案）。 取決於OPTPARAM結構的 Flags 成員中的DPF_USE_HDLGTEMPLATE旗標 。 |
| PUSHBUTTON_TYPE_HTCLRADJ | 未使用。 |
| PUSHBUTTON_TYPE_HTSETUP | 未使用。 |
| 詞彙 | 描述 |
|---|---|
| 樣式 | 指定當使用者按鍵時，CPSUI 所要執行的作業。 可以是下列值之一： |
| PUSHBUTTON_TYPE_CALLBACK | CPSUI 會呼叫應用程式的 _CPSUICALLBACK型回呼函式來處理按鈕事件，而 CPSUICBPARAM 結構的 Reason 成員設定為 CPSUICB_REASON_PUSHBUTTON。 （CPSUI 會忽略回呼函式的傳回值。 |
| PUSHBUTTON_TYPE_DLGPROC | 應用程式的對話框程式會處理按鈕事件。 （如需詳細資訊，請參閱DLGPAGE 的備註區段。當函式收到WM_INITDIALOG訊息時，其 lParam 自變數會指向 CPSUICBPARAM 結構，並將 Reason 成員設定為 CPSUICB_REASON_DLGPROC。 |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI 會顯示半色調色彩調整對話框。 |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI 會顯示裝置半色調設定對話框。 |
OPTTYPE 結構
類型 TVOT_PUSHBUTTON
計數 1
樣式 您可以指定下列選擇性位旗標。
| 旗標 | 描述 |
|---|---|
| OTS_PUSH_ENABLE_ALWAYS | 如果設定，則一律會啟用按鈕，即使使用者無法修改屬性表頁面（也就是說，即使未在 COMPROPSHEETUI 結構中設定CPSUIF_UPDATE_PERMISSION也一樣）。 按鈕的回呼函式必須顯示其對話方塊，但不得允許使用者修改。 請注意，您也必須在OPTTYPE結構的 Flags 成員中設定此旗標。 |
| OTS_PUSH_INCL_SETUP_TITLE | 如果設定，CPSUI 會在按鈕的名稱字串後面包含 「Setup」 一詞（OPTITEM 中的 pName ）。 |
| OTS_PUSH_NO_DOT_DOT_DOT | 如果設定，CPSUI 會在按鈕的名稱字串後面包含三個點 （...） （OPTITEM 中的 pName ）。 |
BegCtrlID
如果 COMPROPSHEETUI 中的 pDlgPage 識別 CPSUI 提供的頁面，或 DLGPAGE 中的 DlgTemplateID 識別 CPSUI 提供的範本，則不會使用 BegCtrlID。 否則， BegCtrlID 必須包含一組循序編號控制標識碼的第一個控件識別碼。 控件識別碼必須識別下列 Windows 控制項：
| 控制標識碼 | Windows 控件 |
|---|---|
| BegCtrlID 內容 | 群組方塊 |
| BegCtrlID 內容+1 | 標題文字 |
| BegCtrlID 內容+2 | 按鈕方塊 |
| BegCtrlID 內容+3 | 按鈕圖示 |
| BegCtrlID 內容+4 | [擴充] 複選框或 [擴充] 按鈕 （選擇性） |
| BegCtrlID 內容+5 | 延伸複選框或延伸按鈕圖示 （選擇性） |
如需詳細資訊，請參閱 自定義 CPSUI 支援的視窗控制件。
需求
標頭： compstui.h （包括 Compstui.h）