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

[アーティクル]
02/26/2024

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

構文

HRESULT DocumentPropertySheets(
  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

戻り値

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

注釈

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

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

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

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

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

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

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