Compartir a través de

Método IPrintOemDriverUni::D rvYMoveTo (prcomoem.h)

  • Artículo

El IPrintOemDriverUni::DrvYMoveTo controlador Unidrv proporciona el método para que un complemento de representación pueda notificar al controlador los cambios de posición y del cursor.

Sintaxis

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

Parámetros

pdevobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ .

y

Valor proporcionado por el autor de la llamada que representa el número de unidades que debe mover el cursor. La unidad se define mediante las marcas de MV_GRAPHICS en dwFlags.

dwFlags

Una o varias de las marcas de bits proporcionadas por el autor de la llamada siguientes:

Marca Definición
MV_GRAPHICS Si se establece, el valor del parámetro y se expresa en puntos, en función de la resolución actual de la impresora. Por ejemplo, si la resolución y es de 150 PPP e y es 75, el movimiento es ?? pulgada.

Si no se establece, el valor del parámetro y se expresa en unidades maestras. Por ejemplo, si la unidad maestra y es 600 e y es 300, el movimiento es ?? pulgada.
MV_PHYSICAL Si se establece, el valor del parámetro y es relativo al origen del cursor.

Si no se establece, el valor del parámetro y es relativo al origen del área imprimible.

No se puede establecer si se establece MV_RELATIVE.
MV_RELATIVE Si se establece, especifica que el cursor se debe mover y unidades de su posición actual.

Si no se establece, especifica que el cursor se debe mover unidades y desde su origen.
MV_UPDATE Si se establece, especifica que Unidrv debe actualizar su cálculo actual de la posición del cursor sin mover realmente el cursor. (Debe establecerse si IPrintOemUni::ImageProcessing ha movido el cursor).

Si no se establece, especifica que Unidrv debe actualizar su cálculo actual de la posición del cursor y también mover el cursor.

[out] piResult

Recibe el resultado proporcionado por el método de restar la posición real del nuevo cursor de la nueva posición de cursor solicitada. Este valor puede ser cero, pero siempre no es negativo.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto Descripción
S_OK
 La operación se realizó correctamente.
E_FAIL
 Error en la operación.
E_NOTIMPL
 El método no está implementado.

Comentarios

Los métodos IPrintOemDriverUni::D rvXMoveTo y IPrintOemDriverUni::DrvYMoveTo permiten que un complemento de representación envíe datos de imagen al colador de impresoras sin hacer que el controlador de impresora pierda el seguimiento de la posición del cursor de la impresora. Si proporciona un método IPrintOemUni::ImageProcessing que envía datos de imagen directamente al administrador de trabajos de impresión en lugar de devolverlos al controlador de impresora, el método debe llamar a IPrintOemDriverUni::DrvXMoveTo y IPrintOemDriverUni::DrvYMoveTo.

Cualquiera de las dos técnicas se puede usar para actualizar la posición del cursor:

  • Siempre que un método IPrintOemUni::ImageProcessing necesite actualizar la posición del cursor, puede llamar a IPrintOemDriverUni::DrvXMoveTo o IPrintOemDriverUni::DrvYMoveTo con la marca MV_UPDATE desactivada. Esto hace que Unidrv envíe comandos de cursor al administrador de trabajos de impresión y actualice su cálculo interno de la posición actual del cursor.
  • El método IPrintOemUni::ImageProcessing puede actualizar el cursor enviando comandos de cursor directamente al administrador de trabajos de impresión. Cuando el método ha finalizado su operación de cola, puede llamar a IPrintOemDriverUni::DrvXMoveTo o IPrintOemDriverUni::DrvYMoveTo con la marca MV_UPDATE establecida. Esto hace que Unidrv actualice su cálculo interno de la posición actual del cursor sin enviar comandos de cursor al administrador de trabajos de impresión.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado prcomoem.h (incluya Prcomoem.h)