Metodo IPrintOemDriverUni::D rvYMoveTo (prcomoem.h)

Articolo
08/07/2023

Il IPrintOemDriverUni::DrvYMoveTo metodo viene fornito dal driver Unidrv in modo che un plug-in di rendering possa notificare al driver le modifiche della posizione y del cursore.

Sintassi

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

Parametri

pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ .

y

Valore fornito dal chiamante che rappresenta il numero di unità di misura da spostare. L'unità è definita dai flag MV_GRAPHICS in dwFlags.

dwFlags

Uno o più dei flag di bit forniti dal chiamante seguenti:

Flag	Definizione
MV_GRAPHICS	Se impostato, il valore del parametro y viene espresso in punti, in base alla risoluzione corrente della stampante. Ad esempio, se la risoluzione y è 150 DPI e y è 75, il movimento è ?? Pollici. Se non impostato, il valore del parametro y viene espresso in unità master. Ad esempio, se l'unità master y è 600 e y è 300, il movimento è ?? Pollici.
MV_PHYSICAL	Se impostato, il valore del parametro y è relativo all'origine del cursore. Se non impostato, il valore del parametro y è relativo all'origine dell'area stampabile. Impossibile impostare se è impostato MV_RELATIVE.
MV_RELATIVE	Se impostato, specifica che il cursore deve essere spostato in unità y dalla posizione corrente. Se non impostato, specifica che il cursore deve essere spostato in unità y dall'origine.
MV_UPDATE	Se impostato, specifica che Unidrv deve aggiornare il calcolo corrente della posizione del cursore senza spostare effettivamente il cursore. Deve essere impostato se IPrintOemUni::ImageProcessing ha spostato il cursore. Se non impostato, specifica che Unidrv deve aggiornare il calcolo corrente della posizione del cursore e spostare anche il cursore.

[out] piResult

Riceve il risultato fornito dal metodo per sottrarre la nuova posizione effettiva del cursore dalla nuova posizione del cursore richiesta. Questo valore potrebbe essere zero, ma è sempre non negativo.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Commenti

I metodi IPrintOemDriverUni::D rvXMoveTo e IPrintOemDriverUni::DrvYMoveTo consentono a un plug-in di rendering di inviare i dati dell'immagine allo spooler della stampante senza che il driver della stampante perda traccia della posizione del cursore della stampante. Se si specifica un metodo IPrintOemUni::ImageProcessing che invia i dati dell'immagine direttamente allo spooler di stampa anziché restituirli al driver della stampante, il metodo deve chiamare IPrintOemDriverUni::DrvXMoveTo e IPrintOemDriverUni::DrvYMoveTo.

È possibile usare una delle due tecniche per aggiornare la posizione del cursore:

Ogni volta che un metodo IPrintOemUni::ImageProcessing deve aggiornare la posizione del cursore, può chiamare IPrintOemDriverUni::DrvXMoveTo o IPrintOemDriverUni::DrvYMoveTo con il flag MV_UPDATE deselezionato. In questo modo Unidrv invia comandi cursore allo spooler di stampa e aggiorna il calcolo interno della posizione corrente del cursore.
Il metodo IPrintOemUni::ImageProcessing può aggiornare il cursore inviando comandi cursori direttamente allo spooler di stampa. Al termine dell'operazione di spooling, il metodo può chiamare IPrintOemDriverUni::DrvXMoveTo o IPrintOemDriverUni::DrvYMoveTo con il flag MV_UPDATE impostato. In questo modo Unidrv aggiorna il calcolo interno della posizione corrente del cursore senza inviare comandi cursori allo spooler di stampa.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	prcomoem.h (include Prcomoem.h)