GETINFO_GLYPHSTRING-Struktur (printoem.h)

  • Artikel

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)

Weitere Informationen

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo