TVOT_PUSHBUTTON
重要
Windows でプリンターとの通信手段として推奨されるのは、最新の印刷プラットフォームです。 プリンターデバイス開発におけるWindows 10および11での印刷体験をカスタマイズするために、MicrosoftのIPPインボックスクラスドライバーとPrint Support Apps (PSA)の使用を推奨します。
詳細については、最新の印刷プラットフォームに関する記事および「印刷サポート アプリの設計ガイド」を参照してください 。
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 | 未使用。 |
| Term | 説明 |
|---|---|
| スタイル | ユーザーが押しボタンをクリックしたときに 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 にはボタンの名前文字列 (OPTITEM の pName) の後に "Setup" という単語が含まれます。 |
| OTS_PUSH_NO_DOT_DOT_DOT | 設定した場合、CPSUI にはボタンの名前文字列 (OPTITEM の pName) の後に 三点リーダー (...) が含まれます。 |
BegCtrlID
COMPROPSHEETUI の pDlgPage が CPSUI 提供のページを示す場合、または DLGPAGE の DlgTemplateID が CPSUI 提供のテンプレートを示す場合、BegCtrlID は使用されません。 それ以外の場合、BegCtrlID には、連番の最初のコントロール識別子を含める必要があります。 コントロール識別子は、次の Windows コントロールを識別する必要があります:
| コントロール ID | Windows コントロール |
|---|---|
| BegCtrlID contents | グループ ボックス |
| BegCtrlID contents+1 | タイトルのテキスト |
| BegCtrlID contents+2 | ブッシュ ボタン ボックス |
| BegCtrlID contents+3 | プッシュ ボタン アイコン |
| BegCtrlID contents+4 | 拡張チェック ボックスまたは拡張ボタン (オプション) |
| BegCtrlID contents+5 | 拡張チェック ボックスまたは拡張ボタンアイコン (オプション) |
詳細については、CPSUI でサポートされるウィンドウコントロールのカスタマイズを参照してください。
要件
ヘッダー: compstui.h (Compstui.h を含む)