Fonction DrvTextOut (winddi.h)

Article
08/27/2023

La fonction DrvTextOut est le point d’entrée de GDI qui appelle le pilote à restituer un ensemble de glyphes à des positions spécifiées.

Syntaxe

BOOL DrvTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  MIX      mix
);

Paramètres

pso

Pointeur vers une structure SURFOBJ qui décrit la surface sur laquelle écrire.

pstro

Pointeur vers une structure STROBJ qui définit les glyphes à afficher et les positions dans lesquelles les placer.

pfo

Pointeur vers une structure FONTOBJ à partir de laquelle récupérer des informations sur la police et ses glyphes.

pco

Pointeur vers une structure CLIPOBJ qui définit la région de clip à travers laquelle tout le rendu doit être effectué. Le pilote ne peut pas affecter les pixels en dehors de la région du clip.

prclExtra

Pointeur vers une structure RECTL. GDI définit toujours ce paramètre sur NULL dans les appels à cette fonction. Il doit être ignoré par le pilote.

prclOpaque

Pointeur vers une structure RECTL qui représente un rectangle opaque unique. Ce rectangle est exclusif en bas à droite. Les pixels de ce rectangle (ceux qui ne sont pas au premier plan et qui ne sont pas coupés) doivent être affichés avec le pinceau opaque. Ce rectangle limite toujours le texte à dessiner. Si ce paramètre a la valeur NULL, aucun pixel opaque ne doit être rendu.

pboFore

Pointeur vers une structure BRUSHOBJ qui représente l’objet brush à utiliser pour les pixels de premier plan. Ce pinceau sera toujours un pinceau de couleur unie.

pboOpaque

Pointeur vers une structure BRUSHOBJ qui représente les pixels opaques. Les modes de combinaison de premier plan et d’arrière-plan pour ce pinceau sont supposés être R2_COPYPEN. Sauf si le pilote définit le bit de fonctionnalités GCAPS_ARBRUSHOPAQUE dans le membre flGraphicsCaps de la structure DEVINFO , il est toujours appelé avec un pinceau de couleur unie.

pptlOrg

Pointeur vers une structure POINTL qui définit l’origine du pinceau pour les deux pinceaux.

mix

Mode de combinaison qui définit les opérations de trame de premier plan et d’arrière-plan à utiliser pour le pinceau vers lequel pboFore pointe. Pour plus d’informations sur le mode mix, consultez Remarques.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit ; sinon, elle est FALSE.

Remarques

Les paramètres d’entrée de DrvTextOut définissent deux ensembles de pixels : premier plan et opaque. Le pilote doit restituer la surface afin que le résultat soit identique à un processus où les pixels opaques sont d’abord rendus avec le pinceau opaque, puis les pixels de premier plan sont rendus avec le pinceau de premier plan. Chacune de ces opérations est limitée par le découpage.

Les pixels opaques et au premier plan sont considérés comme un écran à travers lequel la couleur est brossée sur la surface. Les glyphes de la police n’ont pas de couleur en eux-mêmes.

Les paramètres d’entrée de DrvTextOut définissent l’ensemble de pixels de glyphe, l’ensemble de rectangles supplémentaires, le rectangle opaque et la zone de clip. Il incombe au pilote de calculer puis de restituer l’ensemble de pixels opaques et de premier plan.

GDI garantit que DrvTextOut et DrvDestroyFont ne se chevauchent jamais ; Par conséquent, le pilote peut s’appuyer sur des informations mises en cache lors du traitement d’un appel DrvTextOut .

Le mode de combinaison définit la façon dont le modèle entrant doit être mélangé avec les données qui se trouvent déjà sur la surface de l’appareil. Le type de données MIX se compose de deux valeurs d’opération raster binaire (ROP2) regroupées dans un seul ULONG. L’octet d’ordre le plus bas définit l’opération de raster au premier plan ; l’octet suivant définit l’opération de trame d’arrière-plan. Pour plus d’informations sur les codes d’opération raster, consultez la documentation Microsoft Windows SDK.

Il s’agit d’une fonction requise de manière conditionnelle.