Función DrvTextOut (winddi.h)

Artículo
08/27/2023

La función DrvTextOut es el punto de entrada de GDI que llama al controlador para representar un conjunto de glifos en las posiciones especificadas.

Sintaxis

BOOL DrvTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  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 (aquellos 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 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.

mix

Modo de combinación que define las operaciones de trama en primer plano y en segundo plano que se van a usar para el pincel al que apunta pboFore . Para obtener más información sobre el modo de combinación, vea Comentarios.

Valor devuelto

El valor devuelto es TRUE si la función es correcta; de lo contrario, es FALSE.

Comentarios

Los parámetros de entrada para DrvTextOut 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 donde 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.

Los píxeles en primer plano y opaco 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 para DrvTextOut definen el conjunto de píxeles de glifo, el conjunto de rectángulos adicionales, el rectángulo opaco y la región de recorte. Es responsabilidad del controlador calcular y, a continuación, representar el conjunto de píxeles en primer plano y opaco.

GDI garantiza que DrvTextOut y DrvDestroyFont nunca se superpongan; por lo tanto, el controlador puede basarse en la información almacenada en caché mientras se procesa una llamada DrvTextOut .

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 de operación de ráster binario (ROP2) empaquetados en un único ULONG. El byte de orden más bajo define la operación de trama en primer plano; el byte siguiente 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.

Se trata de una función requerida condicionalmente.