IPrintOemDriverUni::D rvXMoveTo-Methode (prcomoem.h)

Artikel
02/26/2024

Die IPrintOemDriverUni::DrvXMoveTo -Methode wird vom Unidrv-Treiber bereitgestellt, damit ein Rendering-Plug-In den Treiber über Änderungen der x-Position des Cursors benachrichtigen kann.

Syntax

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

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ-Struktur .

x

Vom Aufrufer bereitgestellter Wert, der die Anzahl der Einheiten darstellt, die der Cursor verschoben werden soll. Die Einheit wird durch die MV_GRAPHICS Flags in dwFlags definiert.

dwFlags

Mindestens eines der folgenden vom Aufrufer bereitgestellten Bitflags:

Flag	Definition
MV_GRAPHICS	Wenn festgelegt, wird der Wert des x-Parameters in Punkt ausgedrückt, basierend auf der aktuellen Auflösung des Druckers. Wenn die x-Auflösung beispielsweise 150 DPI und x 75 beträgt, ist die Bewegung ?? Zoll. Wenn dieser Wert nicht festgelegt ist, wird der Wert des x-Parameters in master Einheiten ausgedrückt. Wenn z. B. die x master Einheit 600 und x 300 ist, ist die Bewegung ?? Zoll.
MV_PHYSICAL	Wenn festgelegt, ist der Wert des x-Parameters relativ zum Cursorursprung. Wenn er nicht festgelegt ist, ist der Wert des x-Parameters relativ zum Ursprung des druckbaren Bereichs. Kann nicht festgelegt werden, wenn MV_RELATIVE festgelegt ist.
MV_RELATIVE	Wenn festgelegt, gibt an, dass der Cursor x Einheiten von seiner aktuellen Position verschoben werden soll. Wenn nicht festgelegt, gibt an, dass der Cursor x Einheiten von seinem Ursprung verschoben werden soll.
MV_UPDATE	Wenn festgelegt, gibt an, dass Unidrv seine aktuelle Berechnung der Cursorposition aktualisieren soll, ohne den Cursor tatsächlich zu verschieben. (Sollte festgelegt werden, wenn IPrintOemUni::ImageProcessing den Cursor verschoben hat.) Wenn nicht festgelegt, gibt an, dass Unidrv die aktuelle Berechnung der Cursorposition aktualisieren und den Cursor verschieben soll.

[out] piResult

Empfängt das von der Methode bereitgestellte Ergebnis des Subtrahierens der tatsächlichen neuen Cursorposition von der angeforderten neuen Cursorposition. Dieser Wert kann 0 (null) sein, aber er ist immer nicht negativ.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

Die IPrintOemDriverUni::DrvXMoveToMethoden und IPrintOemDriverUni::D rvYMoveTo ermöglichen es einem Rendering-Plug-In, Bilddaten an den Druckerspooler zu senden, ohne dass der Druckertreiber den Überblick über die Cursorposition des Druckers verliert. Wenn Sie eine IPrintOemUni::ImageProcessing-Methode bereitstellen, die Bilddaten direkt an den Druckspooler sendet, anstatt sie an den Druckertreiber zurückzugeben, sollte die -Methode und IPrintOemDriverUni::DrvYMoveToaufrufenIPrintOemDriverUni::DrvXMoveTo.

Eine der beiden Techniken kann zum Aktualisieren der Cursorposition verwendet werden:

Wenn eine IPrintOemUni::ImageProcessing-Methode die Cursorposition aktualisieren muss, kann sie oder IPrintOemDriverUni::DrvYMoveTo mit deaktiviertem MV_UPDATE-Flag aufrufenIPrintOemDriverUni::DrvXMoveTo. Dies bewirkt, dass Unidrv Cursorbefehle an den Druckspooler sendet und seine interne Berechnung der aktuellen Cursorposition aktualisiert.
Die IPrintOemUni::ImageProcessing-Methode kann den Cursor aktualisieren, indem Cursorbefehle direkt an den Druckspooler gesendet werden. Wenn die Methode ihren Spoolingvorgang abgeschlossen hat, kann sie oder aufrufen IPrintOemDriverUni::DrvXMoveTo , IPrintOemDriverUni::DrvYMoveTo wobei das flag MV_UPDATE festgelegt ist. Dies bewirkt, dass Unidrv seine interne Berechnung der aktuellen Cursorposition aktualisiert, ohne Cursorbefehle an den Druckspooler zu senden.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (include Prcomoem.h)