Función EngTextOut (winddi.h)

Artículo
08/27/2023

La función EngTextOut hace que GDI represente un conjunto de glifos en las posiciones especificadas.

Sintaxis

ENGAPI BOOL EngTextOut(
       SURFOBJ  *pso,
       STROBJ   *pstro,
       FONTOBJ  *pfo,
       CLIPOBJ  *pco,
       RECTL    *prclExtra,
       RECTL    *prclOpaque,
       BRUSHOBJ *pboFore,
       BRUSHOBJ *pboOpaque,
       POINTL   *pptlOrg,
  [in] 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 donde se van a colocar.

pfo

Puntero a una estructura FONTOBJ que se usa para 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 la representación. No se puede ver afectado ningún píxel fuera de esta región de clip.

prclExtra

Puntero a una estructura RECTL . Este parámetro siempre debe ser NULL.

prclOpaque

Puntero a una estructura RECTL que identifica un único rectángulo opaco que es exclusivo de la esquina 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 el objeto brush para 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 miembro flGraphicsCaps de la estructura DEVINFO , siempre se llamará con un pincel de color sólido.

pptlOrg

Puntero a una estructura POINTL que define el origen del pincel para ambos pinceles. Si este parámetro se establece en 0 cuando se llama a EngTextOut , algunos controladores de impresora pueden imprimir imágenes de color incorrectamente. Para obtener más información, vea Comentarios.

[in] mix

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

Valor devuelto

El valor devuelto es TRUE si la función es correcta. De lo contrario, es FALSE y se registra un código de error.

Comentarios

El controlador debe llamar a EngTextOut cuando se ha enganchado DrvTextOut y no puede representar los glifos.

Nota El controlador no puede puntar en EngTextOut si ha enganchado DrvTextOut para una superficie administrada del dispositivo.

Los parámetros de entrada de EngTextOut definen dos conjuntos de píxeles: primer plano y opaco. El controlador debe representar la superficie para que el resultado sea idéntico a un proceso en el que los píxeles opacos se representan primero con el pincel opaco y, a continuación, los píxeles de primer plano se representan con el pincel de primer plano. Cada una de estas operaciones está limitada por el recorte.

Cuando el parámetro pptlOrg de esta función se establece en 0, algunos controladores de impresora imprimen imágenes de color incorrectamente en Microsoft Windows Server 2003 (versión japonesa). Si se establece pptlOrg en 0, se interpreta un valor de puntero NULL para indicar que no se define ningún origen del pincel. Para evitar este problema, inicialice pptlOrg con la dirección de una estructura POINTL cuyos miembros estén establecidos en (0,0), antes de la llamada a EngTextOut.

Los píxeles en primer plano y opacos se consideran una pantalla a través de la cual el color se pincela en la superficie. Los glifos de la fuente no tienen color en sí mismos.

Los parámetros de entrada de EngTextOut definen el conjunto de píxeles de glifo, el conjunto de rectángulos adicionales, el rectángulo opaco y la región del clip. El controlador debe calcular y, a continuación, representar el conjunto de píxeles en primer plano y opaco.

El modo de combinación define cómo se debe mezclar el patrón entrante con los datos que ya están en la superficie del dispositivo. El tipo de datos MIX consta de dos valores ROP2 empaquetados en un único ULONG. El byte de orden bajo define la operación de trama en primer plano; el siguiente byte define la operación de trama en segundo plano. Para obtener más información sobre los códigos de operación de trama, consulte la documentación de Microsoft Windows SDK.

Requisitos


Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys