IPrintOemDriverUni ::D rvYMoveTo, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemDriverUni::DrvYMoveTo est fournie par le pilote Unidrv afin qu’un plug-in de rendu puisse avertir le pilote des modifications de position du curseur y.

Syntaxe

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

Paramètres

pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ.

y

La valeur fournie par l’appelant représentant le nombre d’unités que le curseur doit être déplacée. L’unité est définie par les indicateurs de MV_GRAPHICS dans dwFlags.

dwFlags

Un ou plusieurs des indicateurs de bits fournis par l’appelant suivants :

Drapeau	Définition
MV_GRAPHICS	Si elle est définie, la valeur du paramètre y est exprimée en points, en fonction de la résolution actuelle de l’imprimante. Par exemple, si la résolution y est de 150 PPP et y est 75, le mouvement est ?? pouce. S’il n’est pas défini, la valeur du paramètre y est exprimée en unités maîtres. Par exemple, si l’unité principale y est de 600 et y est 300, le mouvement est ?? pouce.
MV_PHYSICAL	Si elle est définie, la valeur du paramètre y est relative à l’origine du curseur. S’il n’est pas défini, la valeur du paramètre y est relative à l’origine de la zone imprimable. Impossible de définir si MV_RELATIVE est défini.
MV_RELATIVE	Si elle est définie, spécifie que le curseur doit être déplacé y unités de sa position actuelle. S’il n’est pas défini, spécifie que le curseur doit être déplacé y unités de son origine.
MV_UPDATE	Si elle est définie, spécifie qu’Unidrv doit mettre à jour son calcul actuel de la position du curseur sans réellement déplacer le curseur. (Doit être défini si IPrintOemUni ::ImageProcessing a déplacé le curseur.) S’il n’est pas défini, spécifie que Unidrv doit mettre à jour son calcul actuel de la position du curseur et déplacer également le curseur.

[out] piResult

Reçoit le résultat fourni par la méthode de soustraction de la nouvelle position de curseur réelle de la nouvelle position de curseur demandée. Cette valeur peut être égale à zéro, mais elle est toujours non négative.

Valeur de retour

La méthode doit retourner l’une des valeurs suivantes.

Retourner le code	Description
S_OK	L’opération a réussi.
E_FAIL	L’opération a échoué.
E_NOTIMPL	La méthode n’est pas implémentée.

Remarques

Les méthodes IPrintOemDriverUni ::D rvXMoveTo et IPrintOemDriverUni::DrvYMoveTo permettent à un plug-in de rendu d’envoyer des données d’image au spouleur d’imprimante sans entraîner la perte de la position du curseur de l’imprimante. Si vous fournissez une méthode IPrintOemUni ::ImageProcessing qui envoie des données d’image directement au spouleur d’impression au lieu de le renvoyer au pilote d’imprimante, la méthode doit appeler IPrintOemDriverUni::DrvXMoveTo et IPrintOemDriverUni::DrvYMoveTo.

L’une des deux techniques peut être utilisée pour mettre à jour la position du curseur :

Chaque fois qu’une méthode IPrintOemUni ::ImageProcess ing doit mettre à jour la position du curseur, elle peut appeler IPrintOemDriverUni::DrvXMoveTo ou IPrintOemDriverUni::DrvYMoveTo avec l’indicateur de MV_UPDATE effacé. Cela entraîne l’envoi de commandes de curseur au spouleur d’impression et la mise à jour de son calcul interne de la position actuelle du curseur.
La méthode IPrintOemUni ::ImageProcessing peut mettre à jour le curseur en envoyant des commandes de curseur directement au spouleur d’impression. Lorsque la méthode a terminé son opération de spoulage, elle peut appeler IPrintOemDriverUni::DrvXMoveTo ou IPrintOemDriverUni::DrvYMoveTo avec l’indicateur de MV_UPDATE défini. Cela entraîne la mise à jour de son calcul interne de la position actuelle du curseur sans envoyer de commandes de curseur au spouleur d’impression.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	prcomoem.h (include Prcomoem.h)

Partager via