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

Article
02/29/2024

La IPrintOemUni::TTDownloadMethod méthode permet à un plug-in de rendu d’indiquer le format que Unidrv doit utiliser pour une police logicielle TrueType spécifiée.

Syntaxe

HRESULT TTDownloadMethod(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [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 .

[out] pdwResult

Reçoit l’une des valeurs constantes fournies par la méthode suivante :

Valeur	Définition
TTDOWNLOAD_BITMAP	Unidrv doit télécharger la police spécifiée en tant que bitmaps.
TTDOWNLOAD_DONTCARE	Unidrv peut sélectionner le format de police.
TTDOWNLOAD_GRAPHICS	Unidrv doit imprimer les polices TrueType en tant que graphiques, au lieu de télécharger la police.
TTDOWNLOAD_TTOUTLINE	Unidrv doit télécharger la police spécifiée en tant que contours. Pour plus d'informations, consultez la section Notes qui suit.

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

L’objectif IPrintOemUni::TTDownloadMethod de la méthode est de permettre à un plug-in de rendu de spécifier le format préféré d’une imprimante pour une police logicielle TrueType spécifiée.

Si un plug-in de rendu implémente la IPrintOemUni::TTDownloadMethod méthode, Unidrv appelle la méthode chaque fois qu’elle est prête à envoyer une police TrueType au spouleur d’impression. Unidrv spécifie le type de police et la IPrintOemUni::TTDownloadMethod méthode doit spécifier le format préféré de l’imprimante à l’emplacement désigné par pdwResult.

La méthode ne doit pas retourner TTDOWNLOAD_TTOUTLINE sauf si l’imprimante peut rastériser les polices TrueType. Le plug-in de rendu est responsable de la lecture et de l’analyse des fichiers de police TrueType. Vous pouvez obtenir des pointeurs vers des fichiers de police TrueType en appelant FONTOBJ_pvTrueTypeFontFile.

La IPrintOemUni::TTDownloadMethod 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’il reçoit « TTDownLoadMethod » comme entrée.

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