Método IPrintOemDriverUni::D rvUniTextOut (prcomoem.h)

El IPrintOemDriverUni::DrvUniTextOut controlador Unidrv proporciona el método para que un complemento de representación mediante una superficie de dibujo administrada por el dispositivo pueda generar fácilmente cadenas de texto.

Sintaxis

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

Parámetros

pso

Puntero a una estructura SURFOBJ que describe la superficie en la que se va a escribir.

pstro

Puntero a una estructura STROBJ que define los glifos que se van a representar y las posiciones en las que colocarlos.

pfo

Puntero a una estructura FONTOBJ desde la que se va a recuperar información sobre la fuente y sus glifos.

pco

Puntero a una estructura CLIPOBJ que define la región del clip a través de la cual se debe realizar toda la representación. El controlador no puede afectar a ningún píxel fuera de la región del clip.

prclExtra

Puntero a una estructura RECTL. GDI siempre establece este parámetro en NULL en llamadas a esta función. El controlador debe omitirlo.

prclOpaque

Puntero a una estructura RECTL que representa un único rectángulo opaco. Este rectángulo es exclusivo de la parte inferior derecha. Los píxeles dentro de este rectángulo (los que no están en primer plano y no recortados) se representarán con el pincel opaco. Este rectángulo siempre enlaza el texto que se va a dibujar. Si este parámetro es NULL, no se van a representar píxeles opacos.

pboFore

Puntero a una estructura BRUSHOBJ que representa el objeto brush que se va a usar para los píxeles de primer plano. Este pincel siempre será un pincel de color sólido.

pboOpaque

Puntero a una estructura BRUSHOBJ que representa los píxeles opacos. Se supone que los modos de combinación de primer y segundo plano para este pincel son R2_COPYPEN. A menos que el controlador establezca el bit de funcionalidades de GCAPS_ARBRUSHOPAQUE en el miembro flGraphicsCaps de la estructura DEVINFO, siempre se llamará con un pincel de color sólido.

pptlBrushOrg

Puntero a una estructura POINTL que define el origen del pincel para ambos pinceles.

mix

Operaciones de trama en primer plano y en segundo plano (modos de combinación) para pboFore.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no está implementado.

Comentarios

Unidrv proporciona el IPrintOemDriverUni::DrvUniTextOut método para su uso mediante complementos de representación que admiten una superficie de dibujo administrada por el dispositivo. Estos complementos de representación deben enlazar la función DrvTextOut de Unidrv y el IPrintOemDriverUni::DrvUniTextOut método está pensado para llamarse desde esa función de enlace. La función de enlace debe realizar operaciones de recorte de región de texto y rotación de texto. Después, puede llamar IPrintOemDriverUni::DrvUniTextOut a para solicitar Unidrv para crear la cadena de texto mediante fuentes descargables (y para realizar el recorte basado en glifo).

Si IPrintOemDriverUni::DrvUniTextOut no puede crear la cadena de texto, ya sea porque la fuente no está disponible o se gira, llama al método IPrintOemUni::TextOutAsBitmap del complemento de representación, que dibuja la cadena de texto como un mapa de bits.

Para obtener más información, consulta Controlar Device-Managed Superficies.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)