次の方法で共有


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

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

構文

HRESULT DevicePropertySheets(
  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 メンバーの内容によって異なります。 詳細については、DrvDevicePropertySheetsの説明を参照してください。

備考

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

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

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

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

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

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

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

必要条件

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

関連項目

DrvDevicePropertySheets

IPrintOemUI

IPrintOemUI::D ocumentPropertySheets

PFNPROPSHEETUI