IPrintOemUni ::TextOutAsBitmap, méthode (prcomoem.h)
La méthode IPrintOemUni::TextOutAsBitmap permet à un plug-in de rendu de créer une image bitmap d’une chaîne de texte, dans le 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 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.
pptlOrg
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 |
|---|---|
|
L’opération a réussi. |
|
L’opération a échoué. |
|
La méthode n’est pas implémentée. |
Remarques
La méthode IPrintOemUni::TextOutAsBitmap est appelée à partir de la méthode IPrintOemDriverUni ::D rvUniTextOut, 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 est pivotée.
IPrintOemUni::TextOutAsBitmap devez créer une image bitmap du texte et l’envoyer à l’appareil d’impression.
La méthode IPrintOemUni::TextOutAsBitmap est facultative. Si un plug-in de rendu implémente cette méthode, la méthode IPrintOemUni ::GetImplementedMethod doit retourner S_OK lorsqu’elle reçoit « TextOutAsBitmap » comme entrée.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |