GETINFO_GLYPHSTRING-Struktur (printoem.h)
Die GETINFO_GLYPHSTRING-Struktur wird als Eingabe für die UNIFONTOBJ_GetInfo Rückruffunktion verwendet.
Syntax
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
Member
dwSize
Gibt die Größe der GETINFO_GLYPHSTRING-Struktur in Bytes an. Dieser Wert wird vom UNIFONTOBJ_GetInfo-Aufrufer bereitgestellt.
dwCount
Gibt die Anzahl der Elemente in den Arrays an, auf die von pGlyphIn und pGlyphOut verwiesen wird. Dieser Wert wird vom UNIFONTOBJ_GetInfo-Aufrufer bereitgestellt.
dwTypeIn
Gibt den Typ des Glyphenspezifiziererarrays an, auf das von pGlyphIn verwiesen wird. Gültige Werte sind:
| Wert | Definition |
|---|---|
| TYPE_GLYPHHANDLE | TpGlyphIn-Arrayelemente sind vom Typ HGLYPH oder handle für eine Glyphe einer Geräteschrift. Für diesen Wert von dwTypeIn sind gültige Werte für dwTypeOut entweder TYPE_UNICODE oder TYPE_TRANSDATA. |
| TYPE_GLYPHID | Die pGlyphIn-Arrayelemente sind vom Typ DWORD und enthalten Glyphenbezeichner für heruntergeladene TrueType-Schriftarten. Für diesen Wert von dwTypeIn sind gültige Werte für dwTypeOut entweder TYPE_UNICODE oder TYPE_GLYPHHANDLE. |
Wird vom UNIFONTOBJ_GetInfo-Aufrufer bereitgestellt.
pGlyphIn
Zeiger auf ein Array von Glyphenspezifizierern. Der Arrayelementtyp wird durch dwTypeIn angegeben. Dieser Wert wird vom UNIFONTOBJ_GetInfo-Aufrufer bereitgestellt.
dwTypeOut
Gibt den Typ des Glyphenspezifiziererarrays an, auf das pGlyphOut verweist. Gültige Werte sind:
| Wert | Definition |
|---|---|
| TYPE_GLYPHHANDLE | Die pGlyphOut-Arrayelemente sind vom Typ HGLYPH oder handle für eine Glyphe der Geräteschrift. Dieser Wert ist nur gültig, wenn dwTypeIn auf TYPE_GLYPHID festgelegt wurde. |
| TYPE_TRANSDATA | Die pGlyphOut-Arrayelemente sind vom Typ TRANSDATA. Dieser Wert ist nur gültig, wenn dwTypeIn auf TYPE_GLYPHHANDLE festgelegt wurde. |
| TYPE_UNICODE | Die pGlyphen-Arrayelemente sind vom Typ WCHAR. Dieser Wert ist gültig, wenn dwTypeIn auf TYPE_GLYPHHANDLE oder TYPE_GLYPHID festgelegt wurde. |
Wird vom UNIFONTOBJ_GetInfo-Aufrufer bereitgestellt.
pGlyphOut
Vom Aufrufer bereitgestellter Zeiger auf ein leeres Array von Glyphenspezifizierern. Das Array wird von der UNIFONTOBJ_GetInfo-Rückruffunktion von Unidrv ausgefüllt. Der Arrayelementtyp wird durch dwTypeOut angegeben. Dieser Zeiger wird vom UNIFONTOBJ_GetInfo-Aufrufer bereitgestellt.
dwGlyphOutSize
Gibt die Größe des Puffers in Bytes an, auf den pGlyphOut verweist. Dieser Member wird nur verwendet, wenn dwTypeIn auf TYPE_GLYPHHANDLE und dwTypeOut auf TYPE_TRANSDATA festgelegt wurde. Weitere Informationen finden Sie im abschnitt "Hinweise".
Hinweise
Um ein Array von Glyphenspezifizierern von einem Typ in einen anderen zu konvertieren, kann ein Rendering-Plug-In beim Aufrufen der UNIFONTOBJ_GetInfo-Rückruffunktion von Unidrv die Adresse einer GETINFO_GLYPHSTRING-Struktur angeben.
Wenn die Konvertierung von TYPE_GLYPHHANDLE in TYPE_TRANSDATA erfolgt, muss UNIFONTOBJ_GetInfo zweimal aufgerufen werden.
Vor dem ersten Aufruf von UNIFONTOBJ_GetInfo füllt das Rendering-Plug-In die Member dwSize, dwCount, dwTypeIn und pGlyphIn aus und legt dwGlyphOutSize-Member auf Null fest.
Nachdem UNIFONTOBJ_GetInfo zurückgegeben wurde, enthält das dwGlyphOutSize-Element die Größe des Puffers in Bytes, der zum Speichern der konvertierten Zeichenfolge erforderlich ist.
Das Plug-In ordnet einen Speicherblock der im dwGlyphOutSize-Member empfangenen Größe zu, legt fest, dass der pGlyphOut-Member auf diesen Speicherblock verweist, und ruft UNIFONTOBJ_GetInfo erneut auf. UNIDRV konvertiert dann die Zeichenfolge von TYPE_GLYPHHANDLE in TYPE_TRANSDATA.
Die Werte, die ein Rendering-Plug-In für die Elemente dwTypeInund pGlyphIn angibt, sind in der Regel diejenigen, die zuvor als dwType- und pGlyph-Parameter für die IPrintOemUni::OutputCharStr-Methode empfangen wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | printoem.h (include Printoem.h) |