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

El controlador Unidrv proporciona el método IPrintOemDriverUni::DrvUniTextOut 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 de STROBJ que define los glifos que se van a representar y las posiciones en las que colocarlos.

pfo

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

pco

Puntero a una estructura de 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 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 representarán 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 las funcionalidades de GCAPS_ARBRUSHOPAQUE bit en el flGraphicsCaps miembro 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

Las 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 se implementa.

Observaciones

Unidrv proporciona el método IPrintOemDriverUni::DrvUniTextOut 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 método IPrintOemDriverUni::DrvUniTextOut está diseñado para llamarse desde esa función de enlace. La función de enlace debe realizar operaciones de recorte de regiones de texto y rotación de texto. A continuación, puede llamar a IPrintOemDriverUni::DrvUniTextOut 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 IPrintOemUni::TextOutAsBitmap método de representación, que dibuja la cadena de texto como mapa de bits.

Para obtener más información, consulta Control de superficies Device-Managed.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)