GETINFO_GLYPHSTRING structure (printoem.h)
La structure GETINFO_GLYPHSTRING est utilisée comme entrée de 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 glyphes pointé par pGlyphIn. Les valeurs valides sont les suivantes :
| Valeur | Définition |
|---|---|
| TYPE_GLYPHHANDLE | Les éléments de tableau TpGlyphIn sont de type HGLYPH, ou sont gérés par 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 du tableau pGlyphIn sont de type DWORD et contiennent des identificateurs de glyphes 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 array est indiqué par dwTypeIn. Cette valeur est fournie par l’appelant UNIFONTOBJ_GetInfo .
dwTypeOut
Spécifie le type de tableau de spécificateurs de glyphes pointé par pGlyphOut. Les valeurs valides sont les suivantes :
| Valeur | Définition |
|---|---|
| TYPE_GLYPHHANDLE | Les éléments du tableau pGlyphOut sont de type HGLYPH, ou sont gérés dans 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 du 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 rempli par la fonction de rappel UNIFONTOBJ_GetInfo d’Unidrv. Le type d’élément array 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 que dwTypeOut a été défini sur TYPE_TRANSDATA. Pour plus d’informations, consultez la section Remarques suivante.
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 d’Unidrv.
Si la conversion est de TYPE_GLYPHHANDLE en 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, dwTypeIn et pGlyphIn et définit le membre dwGlyphOutSize sur zéro.
Une fois UNIFONTOBJ_GetInfo retourné, le membre dwGlyphOutSize 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 pour qu’il pointe vers ce bloc de mémoire et appelle à nouveau UNIFONTOBJ_GetInfo . UNIDRV convertit ensuite la chaîne de TYPE_GLYPHHANDLE en TYPE_TRANSDATA.
Les valeurs qu’un plug-in de rendu spécifie pour les membres dwTypeInet pGlyphIn sont généralement celles qui ont été précédemment reçues en tant que paramètres dwTypeet pGlyph pour la méthode IPrintOemUni ::OutputCharStr .
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | printoem.h (inclure Printoem.h) |