Metodo IPrintOemUni::TextOutAsBitmap (prcomoem.h)

Articolo
03/08/2023

Il IPrintOemUni::TextOutAsBitmap metodo consente a un plug-in di rendering di creare un'immagine bitmap di una stringa di testo, nel caso in cui un tipo di carattere scaricabile non sia disponibile.

Sintassi

HRESULT TextOutAsBitmap(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  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 da eseguire 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 clip tramite cui è necessario eseguire tutto il rendering. Il driver non può influire sui pixel esterni all'area di clip.

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 non 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 devono essere visualizzati pixel opachi.

pboFore

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

pboOpaque

Puntatore a una struttura BRUSHOBJ che rappresenta i pixel opachi. Si presuppone che sia le modalità di combinazione in primo piano che in background per questo pennello siano R2_COPYPEN. A meno che il driver non imposta le funzionalità GCAPS_ARBRUSHOPAQUE bit nel membro flGraphicsCaps della struttura DEVINFO, verrà sempre chiamato con un pennello a colori a tinta unita.

pptlOrg

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à mix) 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 IPrintOemUni::TextOutAsBitmap metodo viene chiamato dal metodo IPrintOemDriverUni::D rvUniTextOut di Unidrv , se tale metodo non può creare la stringa di testo usando tipi di carattere scaricabili, perché il tipo di carattere non è disponibile o viene ruotato. IPrintOemUni::TextOutAsBitmap deve creare un'immagine bitmap del testo e inviarla al dispositivo di stampa.

Il IPrintOemUni::TextOutAsBitmap metodo è facoltativo. Se un plug-in di rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod deve restituire S_OK quando riceve "TextOutAsBitmap" come input.

Requisiti

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

Vedi anche

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod