次の方法で共有

IPrintOemUI::D ocumentPropertySheets メソッド (prcomoem.h)

  • [アーティクル]

IPrintOemUI::DocumentPropertySheets メソッドを使用すると、ユーザー インターフェイス プラグインは、プリンター デバイスのドキュメント プロパティ シートに新しいページを追加できます。

構文

HRESULT DocumentPropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

パラメーター

pPSUIInfo

呼び出し元が指定した PROPSHEETUI_INFO 構造体へのポインター。

lParam

pPSUIInfoの理由値に依存する呼び出し元が指定した値 -- 理由>。 理由の値には、compstui.h で定義されている次の定数のいずれかを指定できます。 これらの定数の詳細については、PFNPROPSHEETUI 関数型の lParam パラメーターの説明を 解説セクションを参照してください。

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

戻り値

戻り値は、PROPSHEETUI_INFO構造体の Reason メンバーの内容によって異なります。 詳細については、DrvDocumentPropertySheetsの説明を参照してください。

備考

ユーザー インターフェイス プラグインの IPrintOemUI::DocumentPropertySheets メソッドは、ユーザー モード プリンター インターフェイス DLL によってエクスポートされる DrvDocumentPropertySheets 関数と同じ種類の操作を実行します。 どちらの関数も同じ入力パラメーターを持ちます。

ユーザー インターフェイス プラグインを指定すると、ドライバーの DrvDocumentPropertySheets 関数が呼び出された後、IPrintOemUI::DocumentPropertySheets メソッドが呼び出されます。

IPrintOemUI::DocumentPropertySheets が呼び出されると、PROPSHEETUI_INFO 構造体の lParamInit メンバーには、OEMUIPSPARAM 構造体のアドレスが含まれます。

このメソッドを実装する場合は、通常、ユーザーの変更を処理する _CPSUICALLBACK型指定されたコールバック関数も指定します。 このコールバック関数は、IPrintOemDriverUI::D rvUpdateUISetting を呼び出して、ユーザー インターフェイス設定に関連付けられた値が変更されたときにドライバーに通知する必要があります。値がドライバーの DEVMODEW 構造体 (プラグインのプライベート DEVMODEW メンバーではなく) またはレジストリ キーに格納されている場合。

IPrintOemUI::DocumentPropertySheets メソッドが複数のユーザー インターフェイス プラグインによってエクスポートされる場合、そのメソッドは、インストール用にプラグインが指定された順序で呼び出されます。

1 つのユーザー インターフェイス プラグインで複数のプリンター モデルがサポートされていて、それらのモデルの一部に対して新しいページのみを表示する場合、IPrintOemUI::DocumentPropertySheets メソッドは、ページを必要としないモデルに対して、ページを実際に追加せずに成功の戻り値を提供する必要があります。

ユーザー インターフェイス プラグインの作成とインストールの詳細については、「Microsoft のプリンター ドライバーのカスタマイズ」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー prcomoem.h (Prcomoem.h、Compstui.h を含む)

関連項目

DrvDocumentPropertySheets

IPrintOemUI の

IPrintOemUI::D evicePropertySheets

PFNPROPSHEETUI の