次の方法で共有


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

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

構文

HRESULT DevicePropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

パラメーター

pPSUIInfo

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

lParam

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

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

戻り値

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

注釈

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

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

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

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

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

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

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

要件

要件
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)

こちらもご覧ください

DrvDevicePropertySheets

IPrintOemUI

IPrintOemUI::D ocumentPropertySheets

PFNPROPSHEETUI