OPTPARAM 構造体 (compstui.h)

[アーティクル]
02/06/2025

OPTPARAM 構造体の配列は、CPSUI アプリケーション (プリンターインターフェイス DLL を含む) によって、プロパティシートオプションに関連付けられているすべてのパラメーター値を記述するために使用されます。配列のアドレスは、OPTTYPE 構造体に含まれています。

構文

typedef struct _OPTPARAM {
  WORD      cbSize;
  BYTE      Flags;
  BYTE      Style;
  LPTSTR    pData;
  ULONG_PTR IconID;
  LPARAM    lParam;
  ULONG_PTR dwReserved[2];
} OPTPARAM, *POPTPARAM;

メンバーズ

cbSize

OPTPARAM 構造体のサイズ (バイト単位)。

Flags

パラメーターの特性を変更する省略可能なビットフラグ。次のフラグは任意の組み合わせで設定できます。

OPTPF_DISABLED

設定した場合、パラメーターはユーザーが選択できません。次のオプションの種類で使用できます。

OPTPF_HIDE

設定した場合、パラメーターはツリービューに表示されません。次のオプションの種類で使用できます。

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_ICONID_AS_HICON

設定すると、IconID メンバーにアイコンハンドルが含まれます。

設定されていない場合、IconID メンバーにはアイコンリソース識別子が含まれます。

OPTPF_OVERLAY_NO_ICON

設定した場合、CPSUI は、IconID メンバーによって識別されるアイコンにIDI_CPSUI_NO アイコンをオーバーレイします。

OPTPF_OVERLAY_STOP_ICON

設定した場合、CPSUI はIDI_CPSUI_STOP アイコンを、IconID メンバーによって識別されるアイコンにオーバーレイします。

OPTPF_OVERLAY_WARNING_ICON

設定した場合、CPSUI は、IconID メンバーによって識別されるアイコンにIDI_CPSUI_WARNING アイコンをオーバーレイします。

OPTPF_USE_HDLGTEMPLATE

設定 場合、lParam にはテンプレートハンドルが含まれます。

設定されていない場合、lParam にはテンプレートリソース識別子が含まれます。

(スタイルがPUSHBUTTON_TYPE_DLGPROCされている場合にのみ使用されます)。

Style

TVOT_PUSHBUTTON オプションの種類にのみ使用されるプッシュボタンスタイル。

pData

パラメーターの値へのポインター。このメンバーの使用は、CPSUI オプション・タイプによって異なります。

IconID

通常、オプションパラメーターに関連付けるアイコンを識別しますが、他の目的で使用される場合があります。このメンバーの使用は、CPSUI オプション・タイプによって異なります。

lParam

このメンバーの使用は、CPSUI オプション・タイプによって異なります。

dwReserved[2]

予約済み。0 に初期化する必要があります。

備考

オプションに関連付けられているすべての OPTPARAM 構造体でOPTPF_HIDEフラグが設定されている場合、CPSUI はオプション全体を非表示にします。

必要条件

要件	価値
ヘッダー	compstui.h (Compstui.h を含む)

次の方法で共有