SCRIPT _ CACHE

Definiert einen Uniscribe-Schriftartmetrikcache.

typedef void* SCRIPT_CACHE;

Bemerkungen

Dies ist eine nicht transparente Struktur. Die Anwendung muss für jeden verwendeten Zeichenstil eine SCRIPT CACHE-Variable zuordnen und _ beibehalten. Die Variable muss mit NULL initialisiert werden.

Viele Skriptfunktionen verwenden eine Kombination aus einem Hardwaregerätekontexthandle und einer SCRIPT _ CACHE-Variablen. Uniscribe versucht zunächst, mithilfe der VARIABLE SCRIPT CACHE auf Schriftartdaten _ zuzugreifen. Der Hardwaregerätekontext wird nur überprüft, wenn die erforderlichen Daten nicht bereits zwischengespeichert wurden.

Das Hardwaregerätekontexthandle kann als NULL an Uniscribe übergeben werden. Wenn die für Uniscribe erforderlichen Daten bereits zwischengespeichert sind, wird nicht auf den Gerätekontext zugegriffen, und der Vorgang wird normal fortgesetzt.

Wenn der Gerätekontext als NULL übergeben wird und Uniscribe aus irgendeinem Grund darauf zugreifen muss, gibt Uniscribe den Fehlercode E _ PENDING zurück. Dieser Code wird schnell zurückgegeben, sodass die Anwendung zeitaufwändige SelectObject-Aufrufe vermeiden kann.

Beispiele

Das folgende Beispiel gilt für alle Funktionen, die eine SCRIPT _ CACHE-Variable und ein optionales Handle für einen Hardwaregerätekontext verwenden.

hr = ScriptShape(NULL, &sc,
                 pwcChars, cChars, cMaxGlyphs, psa, pwOutGlyphs, pwLogClust, psva, pcGlyphs);
if (hr == E_PENDING)
{
    // ... select font into hdc ...
    hr = ScriptShape(hdc, &sc,
                 pwcChars, cChars, cMaxGlyphs, psa, pwOutGlyphs, pwLogClust, psva, pcGlyphs);
}

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Usp10.h

Weitere Informationen

Uniscribe

Uniscribe-Strukturen

Zwischenspeichern