PROPSHEETUI_INFO_HEADER 構造体 (compstui.h)

PROPSHEETUI_INFO_HEADER構造体は、アプリケーションの PFNPROPSHEETUI 型の関数の入力パラメーターとして使用されます。この関数が reason 値PROPSHEETUI_REASON_GET_INFO_HEADERで呼び出される場合です。

構文

typedef struct _PROPSHEETUI_INFO_HEADER {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  HWND      hWndParent;
  HINSTANCE hInst;
  union {
    HICON     hIcon;
    ULONG_PTR IconID;
  } DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;

メンバー

cbSize

PROPSHEETUI_INFO_HEADER構造体の CPSUI 提供のサイズ (バイト単位)。

Flags

プロパティ シート ページの外観を変更する、アプリケーション指定のビット フラグ (省略可能)。 次の表に示すフラグは、任意の組み合わせで使用できます。

フラグ	説明
PSUIHDRF_DEFTITLE	設定した場合、CPSUI はタイトル バー文字列に "Default" を含める必要があります。 CPSUI は pTitle 文字列の後に "Default" を追加し、PSUIHDRF_PROPTITLEが設定されている場合は "Properties" の前に追加します。
PSUIHDRF_EXACT_PTITLE	設定した場合、CPSUI は pTitle で指定されたテキストを変更せずに使用します。 このフラグは、PSUIHDRF_DEFTITLEとPSUIHDRF_PROPTITLEをオーバーライドします。
PSUIHDRF_NOAPPLYNOW	設定した場合、CPSUI には [ 今すぐ適用] ボタンを含めないようにする必要があります。
PSUIHDRF_PROPTITLE	設定した場合、CPSUI はタイトル バー文字列に "Properties" を追加する必要があります。 (既定では、CPSUI はアプリケーションを呼び出す前にこのフラグを設定します)。
PSUIHDRF_USEHICON	設定した場合、 hIcon/IconID 共用体にはアイコン ハンドルが含まれます。 設定されていない場合、共用体にはアイコン リソース識別子が含まれます。

pTitle

プロパティ シートのタイトル バーに表示されるテキストを表す文字列識別子。 NULL で終わる文字列への 32 ビット ポインターを指定することも、HIWORD を 0 に設定した 16 ビット文字列リソース識別子を指定することもできます。 プリンター インターフェイス DLL の場合、通常、文字列にはプリンターの名前が含まれます。

hWndParent

プロパティ シートの親として使用するウィンドウへのハンドル。 既定では、CPSUI は hWndOwner パラメーターに対して受け取ったウィンドウ ハンドルを CommonPropertySheetUI に提供しますが、アプリケーションはそのハンドルを別のハンドルで上書きできます。

hInst

アプリケーション提供のインスタンス ハンドル。CPSUI はアプリケーション リソースの読み込み時に使用します。

DUMMYUNIONNAME

この共用体は、プロパティ シートのタイトル バーに表示されるアイコンを識別します。

DUMMYUNIONNAME.hIcon

HICON メンバー hIcon を定義します。

DUMMYUNIONNAME.IconID

ULONG_PTR メンバー IconID を定義します。 共用体メンバーは、 Flags でPSUIHDRF_USEICONによって選択されます。

要件

要件	値
Header	compstui.h (Compstui.h を含む)