IPrintOemUni ::TTDownloadMethod, méthode (prcomoem.h)
La méthode IPrintOemUni::TTDownloadMethod permet à un plug-in de rendu d’indiquer le format que Unidrv doit utiliser pour une police réversible 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 suivantes :
| 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 des 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 sous forme de contours. Pour plus d’informations, consultez la section Remarques suivante. |
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
L’objectif de la méthode IPrintOemUni::TTDownloadMethod est d’autoriser un plug-in de rendu à spécifier le format préféré d’une imprimante pour une police réversible TrueType spécifiée.
Si un plug-in de rendu implémente la méthode IPrintOemUni::TTDownloadMethod, 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 méthode IPrintOemUni::TTDownloadMethod doit spécifier le format préféré de l’imprimante dans l’emplacement vers lequel pointe pdwResult.
La méthode ne doit pas retourner TTDOWNLOAD_TTOUTLINE sauf si l’imprimante peut ratériser les polices TrueType. Le plug-in de rendu est responsable de la lecture et de l’analyse des fichiers de police TrueType. Les pointeurs vers les fichiers de police TrueType peuvent être obtenus en appelant FONTOBJ_pvTrueTypeFontFile.
La méthode IPrintOemUni::TTDownloadMethod 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 « TTDownLoadMethod » comme entrée.
Pour plus d’informations, consultez Personnalisation de la gestion des polices.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |