TVOT_PUSHBUTTON

  • [アーティクル]

重要

プリンターデバイス開発における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 使用しません。
用語 説明
スタイル ユーザーが押しボタンをクリックしたときに 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 を含む)

関連項目

OPTITEM

OPTPARAM

OPTTYPE