Méthode IPrintOemUni ::TextOutAsBitmap (prcomoem.h)

Article
03/01/2024

La IPrintOemUni::TextOutAsBitmap méthode permet à un plug-in de rendu de créer une image bitmap d’une chaîne de texte, au cas où une police téléchargeable n’est pas disponible.

Syntaxe

HRESULT TextOutAsBitmap(
  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 à 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 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 clippés) doivent être rendus 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 mixage de premier plan et d’arrière-plan pour ce pinceau sont supposés être R2_COPYPEN. À moins que le pilote ne définisse le bit de fonctionnalités GCAPS_ARBRUSHOPAQUE dans le membre flGraphicsCaps de la structure DEVINFO, il sera 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

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

Valeur retournée

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

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L'opération a échoué.
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

La IPrintOemUni::TextOutAsBitmap méthode est appelée à partir de la méthode IPrintOemDriverUni ::D rvUniTextOut d’Unidrv , si cette méthode ne peut pas créer la chaîne de texte à l’aide de polices téléchargeables, soit parce que la police n’est pas disponible ou fait l’objet d’une rotation. IPrintOemUni::TextOutAsBitmap doit créer une image bitmap du texte et l’envoyer à l’appareil d’impression.

La IPrintOemUni::TextOutAsBitmap méthode est facultative. Si un plug-in de rendu implémente cette méthode, la méthode IPrintOemUni ::GetImplementedMethod du plug-in doit retourner S_OK lorsqu’elle reçoit « TextOutAsBitmap » comme entrée.