GETINFO_GLYPHSTRING structure (printoem.h)

  • Article

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)

Voir aussi

IPrintOemUni ::OutputCharStr

UNIFONTOBJ_GetInfo