IPrintOemDriverUni ::D rvUniTextOut, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemDriverUni::DrvUniTextOut est fournie par le pilote Unidrv afin qu’un plug-in de rendu à l’aide d’une surface de dessin gérée par l’appareil puisse facilement générer des chaînes de texte.

Syntaxe

HRESULT DrvUniTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlBrushOrg,
  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 à restituer 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 affecter aucun pixel en dehors de la région 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 non clippés) doivent être rendus avec le pinceau opaque. Ce rectangle limite toujours le texte à dessiner. Si ce paramètre est NULL, aucun pixel opaque ne doit être rendu.

pboFore

Pointeur vers une structure BRUSHOBJ qui représente l’objet pinceau à 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 des fonctionnalités de GCAPS_ARBRUSHOPAQUE dans le flGraphicsCaps membre de la structure DEVINFO, il est toujours appelé avec un pinceau de couleur unie.

pptlBrushOrg

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

mix

Opérations de premier plan et de raster d’arrière-plan (modes de combinaison) pour pboFore.

Valeur de retour

La méthode doit retourner l’une des valeurs suivantes.

Retourner le code	Description
S_OK	L’opération a réussi.
E_FAIL	L’opération a échoué.
E_NOTIMPL	La méthode n’est pas implémentée.

Remarques

La méthode IPrintOemDriverUni::DrvUniTextOut est fournie par Unidrv pour une utilisation par les plug-ins de rendu qui prennent en charge une surface de dessin gérée par l’appareil. Ces plug-ins de rendu doivent raccorder la fonction DrvTextOut d’Unidrv, et la méthode IPrintOemDriverUni::DrvUniTextOut est destinée à être appelée à partir de cette fonction de raccordement. La fonction de raccordement doit effectuer des opérations de découpage de zone de texte et de rotation de texte. Il peut ensuite appeler IPrintOemDriverUni::DrvUniTextOut demander à Unidrv de créer la chaîne de texte à l’aide de polices téléchargeables (et d’effectuer une capture basée sur glyphe).

Si IPrintOemDriverUni::DrvUniTextOut ne peut pas créer la chaîne de texte, car la police n’est pas disponible ou est pivotée, elle appelle le iPrintOemUni ::TextOutAsBitmap méthode, qui dessine la chaîne de texte en tant que bitmap.

Pour plus d’informations, consultez Gestion Device-Managed Surfaces.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	prcomoem.h (include Prcomoem.h)

Partager via