ScriptGetFontLanguageTags-Funktion (usp10.h)

Artikel
08/26/2023

Ruft eine Liste von Sprachtags ab, die für das angegebene Element verfügbar sind und von einem angegebenen Skripttag für die OpenType-Verarbeitung unterstützt werden. Die Tags, die die Liste enthalten, werden aus der Schriftart im angegebenen Gerätekontext oder Cache abgerufen.

Syntax

HRESULT ScriptGetFontLanguageTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pLangsysTags,
  [out]          int             *pcTags
);

Parameter

[in, optional] hdc

Handle für den Gerätekontext. Weitere Informationen finden Sie unter Zwischenspeichern.

[in, out] psc

Zeiger auf eine SCRIPT_CACHE Struktur, die den Skriptcache identifiziert.

[in, optional] psa

Zeiger auf eine SCRIPT_ANALYSIS-Struktur, die aus einem vorherigen Aufruf von ScriptItemizeOpenType abgerufen wurde. Dieser Parameter identifiziert die Gestaltungs-Engine, sodass die Schriftartsprachtags für die entsprechende Schriftart und Skripts abgerufen werden können.

Alternativ kann die Anwendung diesen Parameter auf NULL festlegen, um ungefilterte Ergebnisse abzurufen.

[in] tagScript

Eine OPENTYPE_TAG Struktur, die das Skripttag definiert, für das die Liste der zugeordneten Sprachtags angefordert wird.

[in] cMaxTags

Die Länge des arrays, das von pLangSysTags angegeben wird.

[out] pLangsysTags

Zeiger auf einen Puffer, in dem diese Funktion ein Array von OPENTYPE_TAG Strukturen abruft, die die Sprachtags identifizieren, die Eingabekriterien erfüllen.

[out] pcTags

Zeiger auf die Anzahl der Elemente im Sprachtagarray.

Rückgabewert

Gibt bei Erfolg 0 zurück. Die Funktion gibt einen HRESULT-Wert ungleich null zurück, wenn sie nicht erfolgreich ist. Die Anwendung kann den Rückgabewert mit den Makros SUCCEEDED und FAILED testen.

Wenn die Anzahl der übereinstimmenden Tags cMaxTags überschreitet, schlägt die Funktion mit E_OUTOFMEMORY fehl. Die Anwendung kann versuchen, mit größeren Puffern erneut aufzurufen.

Hinweise

Die OPENTYPE_TAG-Struktur wird zwar formal als ULONG-Typ deklariert, enthält aber ein 4-Byte-Array, das vier 8-Bit-ASCII-Werte des Leerzeichens A-Z oder a-z enthält. Beispielsweise sind die Sprachtags für Rumänisch, Urdu und Persisch "ROM", "URD" bzw. "FAR". Beachten Sie, dass jedes Tag mit einem Leerzeichen endet.

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in der Bibliotheksliste angeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll
Verteilbare Komponente	Usp10.dll Version 1.600 oder höher unter Windows XP