Metodo IPrintOemDriverUni::D rvUniTextOut (prcomoem.h)

Il IPrintOemDriverUni::DrvUniTextOut metodo viene fornito dal driver Unidrv in modo che un plug-in di rendering usando un'area di disegno gestita dal dispositivo possa generare facilmente stringhe di testo.

Sintassi

HRESULT DrvUniTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlBrushOrg,
  MIX      mix
);

Parametri

pso

Puntatore a una struttura SURFOBJ che descrive la superficie su cui scrivere.

pstro

Puntatore a una struttura STROBJ che definisce i glifi di cui eseguire il rendering e le posizioni in cui posizionarle.

pfo

Puntatore a una struttura FONTOBJ da cui recuperare informazioni sul tipo di carattere e sui relativi glifi.

pco

Puntatore a una struttura CLIPOBJ che definisce l'area di ritaglio tramite cui deve essere eseguito tutto il rendering. Il driver non può influire su alcun pixel all'esterno dell'area di ritaglio.

prclExtra

Puntatore a una struttura RECTL. GDI imposta sempre questo parametro su NULL nelle chiamate a questa funzione. Deve essere ignorato dal driver.

prclOpaque

Puntatore a una struttura RECTL che rappresenta un singolo rettangolo opaco. Questo rettangolo è esclusivo in basso a destra. I pixel all'interno di questo rettangolo (quelli che non sono in primo piano e non ritagliati) devono essere sottoposti a rendering con il pennello opaco. Questo rettangolo delimita sempre il testo da disegnare. Se questo parametro è NULL, non verrà eseguito il rendering di pixel opachi.

pboFore

Puntatore a una struttura BRUSHOBJ che rappresenta l'oggetto pennello da utilizzare per i pixel di primo piano. Questo pennello sarà sempre un pennello a tinta unita.

pboOpaque

Puntatore a una struttura BRUSHOBJ che rappresenta i pixel opachi. Entrambe le modalità di combinazione di primo piano e di sfondo per questo pennello vengono considerate R2_COPYPEN. A meno che il driver non imposti il bit delle funzionalità GCAPS_ARBRUSHOPAQUE nel membro flGraphicsCaps della struttura DEVINFO, verrà sempre chiamato con un pennello a tinta unita.

pptlBrushOrg

Puntatore a una struttura POINTL che definisce l'origine del pennello per entrambi i pennelli.

mix

Operazioni raster in primo piano e in background (modalità di combinazione) per pboFore.

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

Il IPrintOemDriverUni::DrvUniTextOut metodo viene fornito da Unidrv per l'uso tramite plug-in di rendering che supportano una superficie di disegno gestita dal dispositivo. Tali plug-in di rendering devono associare la funzione DrvTextOut di Unidrv e il IPrintOemDriverUni::DrvUniTextOut metodo deve essere chiamato da tale funzione di hooking. La funzione di associazione deve eseguire operazioni di ritaglio dell'area di testo e rotazione del testo. Può quindi chiamare IPrintOemDriverUni::DrvUniTextOut per richiedere a Unidrv di creare la stringa di testo usando tipi di carattere scaricabili (e per eseguire ritaglio basato su glifi).

Se IPrintOemDriverUni::DrvUniTextOut non è possibile creare la stringa di testo perché il tipo di carattere non è disponibile o è ruotato, chiama il metodo IPrintOemUni::TextOutAsBitmap del plug-in di rendering, che disegna la stringa di testo come bitmap.

Per altre informazioni, vedere Gestione delle superfici Device-Managed.

Requisiti

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