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 でもかまいませんが、常に負の値ではありません。
戻り値
このメソッドは、次のいずれかの値を返す必要があります。
リターン コード | 形容 |
---|---|
|
操作は成功しました。 |
|
操作が失敗しました。 |
|
メソッドは実装されていません。 |
備考
IPrintOemDriverUni::DrvXMoveTo
および IPrintOemDriverUni::D rvYMoveTo メソッドを使用すると、レンダリング プラグインは、プリンター ドライバーがプリンターのカーソル位置を見失うことなく、プリンター スプーラーに画像データを送信できます。
IPrintOemUni::ImageProcessing メソッドを指定して、プリンター ドライバーに返す代わりに、イメージ データを印刷スプーラーに直接送信する場合、メソッドは IPrintOemDriverUni::DrvXMoveTo
と IPrintOemDriverUni::DrvYMoveTo
を呼び出す必要があります。
カーソル位置を更新するには、次の 2 つの手法のいずれかを使用できます。
-
IPrintOemUni::ImageProcessing メソッドがカーソル位置を更新する必要がある場合は常に、MV_UPDATE フラグをクリアして
IPrintOemDriverUni::DrvXMoveTo
またはIPrintOemDriverUni::DrvYMoveTo
を呼び出すことができます。 これにより、Unidrv は、印刷スプーラーにカーソル コマンドを送信し、現在のカーソル位置の内部計算を更新します。 -
IPrintOemUni::ImageProcessing メソッドは、カーソル コマンドを印刷スプーラーに直接送信することで、カーソルを更新できます。 メソッドは、スプール操作を完了すると、MV_UPDATE フラグを設定して
IPrintOemDriverUni::DrvXMoveTo
またはIPrintOemDriverUni::DrvYMoveTo
を呼び出すことができます。 これにより、Unidrv は、印刷スプーラーにカーソル コマンドを送信せずに、現在のカーソル位置の内部計算を更新します。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | prcomoem.h (Prcomoem.h を含む) |