Metode IPrintOemDriverUni::D rvYMoveTo (prcomoem.h)

  • Artikel

Metode IPrintOemDriverUni::DrvYMoveTo ini disediakan oleh driver Unidrv sehingga plug-in penyajian dapat memberi tahu driver tentang perubahan kursor posisi y.

Sintaks

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

Parameter

pdevobj

Penunjuk yang disediakan penelepon ke struktur DEVOBJ .

y

Nilai yang disediakan penelepon yang mewakili jumlah unit kursor harus dipindahkan. Unit didefinisikan oleh bendera MV_GRAPHICS di dwFlags.

dwFlags

Satu atau beberapa bendera bit yang disediakan pemanggil berikut:

Bendera Definisi
MV_GRAPHICS Jika diatur, nilai parameter y dinyatakan dalam titik-titik, berdasarkan resolusi printer saat ini. Misalnya, jika resolusi y adalah 150 DPI dan y adalah 75, gerakannya adalah ?? Inci.

Jika tidak diatur, nilai parameter y dinyatakan dalam unit master. Misalnya, jika unit master y adalah 600 dan y adalah 300, gerakannya adalah ?? Inci.
MV_PHYSICAL Jika diatur, nilai parameter y relatif terhadap asal kursor.

Jika tidak diatur, nilai parameter y relatif terhadap asal area yang dapat dicetak.

Tidak dapat diatur jika MV_RELATIVE diatur.
MV_RELATIVE Jika diatur, menentukan bahwa kursor harus dipindahkan unit y dari posisinya saat ini.

Jika tidak diatur, menentukan bahwa kursor harus dipindahkan unit y dari asalnya.
MV_UPDATE Jika diatur, menentukan bahwa Unidrv harus memperbarui perhitungan posisi kursor saat ini tanpa benar-benar memindahkan kursor. (Harus diatur jika IPrintOemUni::ImageProcessing telah memindahkan kursor.)

Jika tidak diatur, menentukan bahwa Unidrv harus memperbarui perhitungan posisi kursor saat ini dan juga memindahkan kursor.

[out] piResult

Menerima hasil yang disediakan metode untuk mengurangi posisi kursor baru aktual dari posisi kursor baru yang diminta. Nilai ini mungkin nol, tetapi selalu nonnegatif.

Nilai kembali

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Operasi berhasil.
E_FAIL
 Operasi gagal.
E_NOTIMPL
 Metode ini tidak diterapkan.

Keterangan

Metode dan IPrintOemDriverUni::D rvXMoveTo memungkinkan plug-in penyajian untuk mengirim data gambar ke penampung printer tanpa menyebabkan driver printer kehilangan jejak posisi kursor printer.IPrintOemDriverUni::DrvYMoveTo Jika Anda menyediakan metode IPrintOemUni::ImageProcessing yang mengirim data gambar langsung ke penampung cetak alih-alih mengembalikannya ke driver printer, metode harus memanggil IPrintOemDriverUni::DrvXMoveTo dan IPrintOemDriverUni::DrvYMoveTo.

Salah satu dari dua teknik dapat digunakan untuk memperbarui posisi kursor:

  • Setiap kali metode IPrintOemUni::ImageProcessing perlu memperbarui posisi kursor, metode tersebut dapat memanggil IPrintOemDriverUni::DrvXMoveTo atau IPrintOemDriverUni::DrvYMoveTo dengan bendera MV_UPDATE dihapus. Ini menyebabkan Unidrv mengirim perintah kursor ke penampung cetak dan memperbarui perhitungan internal posisi kursor saat ini.
  • Metode IPrintOemUni::ImageProcessing dapat memperbarui kursor dengan mengirim perintah kursor langsung ke penampung cetak. Ketika metode telah menyelesaikan operasi penampungannya, metode dapat memanggil IPrintOemDriverUni::DrvXMoveTo atau IPrintOemDriverUni::DrvYMoveTo dengan bendera MV_UPDATE diatur. Hal ini menyebabkan Unidrv memperbarui perhitungan internal posisi kursor saat ini tanpa mengirim perintah kursor ke penampung cetak.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header prcomoem.h (termasuk Prcomoem.h)