structure GETINFO_GLYPHSTRING (printoem.h)
La structure GETINFO_GLYPHSTRING est utilisée comme entrée dans la fonction de rappel UNIFONTOBJ_GetInfo.
Syntaxe
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
Membres
dwSize
Spécifie la taille, en octets, de la structure GETINFO_GLYPHSTRING. Cette valeur est fournie par l’appelant UNIFONTOBJ_GetInfo.
dwCount
Spécifie le nombre d’éléments dans les tableaux pointés par pGlyphIn et pGlyphOut. Cette valeur est fournie par l’appelant UNIFONTOBJ_GetInfo.
dwTypeIn
Spécifie le type de tableau de spécificateur de glyphe vers lequel pointe pGlypheIn. Les valeurs valides sont les suivantes :
| Valeur | Définition |
|---|---|
| TYPE_GLYPHHANDLE | TpGlyphIn éléments de tableau sont de type HGLYPH ou de handle vers un glyphe de police d’appareil. Pour cette valeur de dwTypeIn, les valeurs valides pour dwTypeOut sont TYPE_UNICODE ou TYPE_TRANSDATA. |
| TYPE_GLYPHID | Les éléments de tableau pGlyphIn sont de type DWORD et contiennent des identificateurs de glyphe pour les glyphes de police TrueType téléchargés. Pour cette valeur de dwTypeIn, les valeurs valides pour dwTypeOut sont TYPE_UNICODE ou TYPE_GLYPHHANDLE. |
Fourni par l’appelant UNIFONTOBJ_GetInfo.
pGlyphIn
Pointeur vers un tableau de spécificateurs de glyphes. Le type d’élément de tableau est indiqué par dwTypeIn. Cette valeur est fournie par l’appelant UNIFONTOBJ_GetInfo.
dwTypeOut
Spécifie le type de tableau de spécificateur de glyphe pointé par pGlyphOut. Les valeurs valides sont les suivantes :
| Valeur | Définition |
|---|---|
| TYPE_GLYPHHANDLE | Les éléments de tableau pGlyphOut sont de type HGLYPH, ou gèrent un glyphe de police d’appareil. Cette valeur est valide uniquement lorsque dwTypeIn a été défini sur TYPE_GLYPHID. |
| TYPE_TRANSDATA | Les éléments de tableau pGlyphOut sont de type transdata. Cette valeur est valide uniquement lorsque dwTypeIn a été défini sur TYPE_GLYPHHANDLE. |
| TYPE_UNICODE | Les éléments de tableau pGlyphe sont de type WCHAR. Cette valeur est valide lorsque dwTypeIn a été défini sur TYPE_GLYPHHANDLE ou TYPE_GLYPHID. |
Fourni par l’appelant UNIFONTOBJ_GetInfo.
pGlyphOut
Pointeur fourni par l’appelant vers un tableau vide de spécificateurs de glyphes. Le tableau est renseigné par la fonction de rappel UNIFONTOBJ_GetInfo d’Unidrv. Le type d’élément de tableau est indiqué par dwTypeOut. Ce pointeur est fourni par l’appelant UNIFONTOBJ_GetInfo.
dwGlyphOutSize
Spécifie la taille, en octets, de la mémoire tampon pointée par pGlyphOut. Ce membre est utilisé uniquement lorsque dwTypeIn a été défini sur TYPE_GLYPHHANDLE et dwTypeOut a été défini sur TYPE_TRANSDATA. Pour plus d’informations, consultez la section Remarques suivantes.
Remarques
Pour convertir un tableau de spécificateurs de glyphes d’un type à un autre, un plug-in de rendu peut fournir l’adresse d’une structure GETINFO_GLYPHSTRING lors de l’appel de la fonction de rappel UNIFONTOBJ_GetInfo unidrv.
Si la conversion est de TYPE_GLYPHHANDLE à TYPE_TRANSDATA, UNIFONTOBJ_GetInfo doit être appelée deux fois.
Avant le premier appel à UNIFONTOBJ_GetInfo, le plug-in de rendu remplit les membres dwSize, dwCount, dwTypeInet pGlyphIn membres et définit membre dwGlyphOutSize à zéro.
Une fois UNIFONTOBJ_GetInfo retourné, le dwGlyphOutSize membre contient la taille, en octets, de la mémoire tampon nécessaire pour stocker la chaîne convertie.
Le plug-in alloue un bloc de mémoire de la taille reçue dans le membre dwGlyphOutSize, définit le membre pGlyphOut à pointer vers ce bloc de mémoire et appelle UNIFONTOBJ_GetInfo une fois de plus. UNIDRV convertit ensuite la chaîne de TYPE_GLYPHHANDLE en TYPE_TRANSDATA.
Les valeurs spécifiées par un plug-in de rendu pour les membres dwTypeInet pGlyphIn sont généralement celles qui ont été précédemment reçues en tant que dwTypeet paramètres pGlyph à la méthode IPrintOemUni ::OutputCharStr.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | printoem.h (include Printoem.h) |