Méthode IPrintOemUni ::D ownloadCharGlyph (prcomoem.h)

  • Article

La IPrintOemUni::DownloadCharGlyph méthode permet à un plug-in de rendu pour Unidrv d’envoyer un glyphe de caractères pour une police réversible spécifiée à l’imprimante.

Syntaxe

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

Paramètres

pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ .

pUFObj

Pointeur fourni par l’appelant vers une structure UNIFONTOBJ .

hGlyph

Handle de glyphe fourni par l’appelant.

pdwWidth

Pointeur fourni par l’appelant pour recevoir la largeur fournie par la méthode du caractère.

[out] pdwResult

Reçoit une valeur fournie par la méthode représentant la quantité de mémoire de l’imprimante, en octets, requise pour stocker le glyphe de caractères. Si l’opération échoue, la valeur retournée doit être égale à zéro.

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::DownloadCharGlyph méthode est utilisée pour prendre en charge les polices logicielles sur les imprimantes qui n’acceptent pas les commandes PCL . Son objectif est d’activer un plug-in de rendu pour envoyer un glyphe de caractères à l’imprimante.

Si un plug-in de rendu implémente la IPrintOemUni::DownloadCharGlyph méthode, Unidrv appelle la méthode immédiatement après l’envoi de la chaîne de commande spécifiée par l’entrée de commande CmdSetCharCode, qui se trouve dans le fichier GPD de l’imprimante. (Les fichiers GPD sont décrits dans Microsoft Universal Printer Driver.) La méthode doit effectuer les opérations suivantes :

  • Appelez la fonction UNIFONTOBJ_GetInfo pour obtenir l’image de glyphe spécifiée par hGlyphe.
  • Appelez IPrintOemDriverUni ::D rvWriteSpoolBuf pour envoyer le glyphe à l’imprimante.
  • Appelez à nouveau la fonction UNIFONTOBJ_GetInfo pour obtenir la largeur du glyphe, puis stockez la largeur dans l’adresse pointée par pdwWidth.
  • Retournez la quantité de mémoire d’imprimante nécessaire pour stocker le glyphe en le plaçant à l’emplacement spécifié par pdwResult.
La IPrintOemUni::DownloadCharGlyph 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 « DownloadCharGlyph » comme entrée.

Si vous implémentez la IPrintOemUni::DownloadCharGlyph méthode, vous devez également implémenter la méthode IPrintOemUni ::D ownloadFontHeader .

Pour plus d’informations, consultez Gestion personnalisée des polices.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête prcomoem.h (inclure Prcomoem.h)