次の方法で共有


IPrintOemDriverUni::D rvXMoveTo メソッド (prcomoem.h)

IPrintOemDriverUni::DrvXMoveTo メソッドは、レンダリング プラグイン がカーソルの x 位置の変更をドライバーに通知できるように、Unidrv ドライバーによって提供されます。

構文

HRESULT DrvXMoveTo(
        PDEVOBJ pdevobj,
        INT     x,
        DWORD   dwFlags,
  [out] OUT INT *piResult
);

パラメーター

pdevobj

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

x

カーソルを移動する必要がある単位数を表す呼び出し元指定の値。 単位は、dwFlags のMV_GRAPHICS フラグ定義されます。

dwFlags

次の呼び出し元が指定したビット フラグの 1 つ以上。

定義
MV_GRAPHICS 設定すると、x パラメーターの値は、プリンターの現在の解像度に基づいてドットで表されます。 たとえば、x 解像度が 150 DPI で、x が 75 の場合、移動は ?? インチ。

設定しない場合、x パラメーターの値はマスター 単位で表されます。 たとえば、x マスター ユニットが 600 で、x が 300 の場合、移動は ?? になります。 インチ。

MV_PHYSICAL 設定した場合、x パラメーターの値はカーソルの原点を基準とします。

設定しない場合、x パラメーターの値は、印刷可能領域の原点を基準とします。

MV_RELATIVEが設定されている場合は設定できません。

MV_RELATIVE 設定した場合は、カーソルを現在の位置から x 単位 移動することを指定します。

設定しない場合は、カーソルを原点から x 単位 移動することを指定します。

MV_UPDATE 設定されている場合は、実際にカーソルを移動せずに、Unidrv がカーソル位置の現在の計算を更新する必要があることを指定します。 (IPrintOemUni::ImageProcessing がカーソルを移動した場合に設定する必要があります)。

設定されていない場合は、Unidrv がカーソル位置の現在の計算を更新し、カーソルを移動する必要があることを指定します。

[out] piResult

要求された新しいカーソル位置から実際の新しいカーソル位置を減算したメソッド指定の結果を受け取ります。 この値は 0 でもかまいませんが、常に負の値ではありません。

戻り値

このメソッドは、次のいずれかの値を返す必要があります。

リターン コード 形容
S_OK
操作は成功しました。
E_FAIL
操作が失敗しました。
E_NOTIMPL
メソッドは実装されていません。

備考

IPrintOemDriverUni::DrvXMoveTo および IPrintOemDriverUni::D rvYMoveTo メソッドを使用すると、レンダリング プラグインは、プリンター ドライバーがプリンターのカーソル位置を見失うことなく、プリンター スプーラーに画像データを送信できます。 IPrintOemUni::ImageProcessing メソッドを指定して、プリンター ドライバーに返す代わりに、イメージ データを印刷スプーラーに直接送信する場合、メソッドは IPrintOemDriverUni::DrvXMoveToIPrintOemDriverUni::DrvYMoveToを呼び出す必要があります。

カーソル位置を更新するには、次の 2 つの手法のいずれかを使用できます。

  • IPrintOemUni::ImageProcessing メソッドがカーソル位置を更新する必要がある場合は常に、MV_UPDATE フラグをクリアして IPrintOemDriverUni::DrvXMoveTo または IPrintOemDriverUni::DrvYMoveTo を呼び出すことができます。 これにより、Unidrv は、印刷スプーラーにカーソル コマンドを送信し、現在のカーソル位置の内部計算を更新します。
  • IPrintOemUni::ImageProcessing メソッドは、カーソル コマンドを印刷スプーラーに直接送信することで、カーソルを更新できます。 メソッドは、スプール操作を完了すると、MV_UPDATE フラグを設定して IPrintOemDriverUni::DrvXMoveTo または IPrintOemDriverUni::DrvYMoveTo を呼び出すことができます。 これにより、Unidrv は、印刷スプーラーにカーソル コマンドを送信せずに、現在のカーソル位置の内部計算を更新します。

必要条件

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