ScriptGetFontLanguageTags-Funktion (usp10.h)
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.
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 |