SCRIPT_CACHE

Definisce una cache delle metriche dei tipi di carattere Uniscribe.

typedef void* SCRIPT_CACHE;

Commenti

Si tratta di una struttura opaca. L'applicazione deve allocare e conservare una variabile SCRIPT_CACHE per ogni stile di carattere usato. La variabile deve essere inizializzata su NULL.

Molte funzioni script accettano una combinazione di handle del contesto di dispositivo hardware e una variabile SCRIPT_CACHE. Uniscribe tenta prima di tutto di accedere ai dati dei tipi di carattere usando la variabile SCRIPT_CACHE. Controlla solo il contesto del dispositivo hardware se i dati necessari non sono già memorizzati nella cache.

L'handle del contesto di dispositivo hardware può essere passato a Uniscribe come NULL. Se i dati richiesti da Uniscribe sono già memorizzati nella cache, il contesto di dispositivo non è accessibile e l'operazione continua normalmente.

Se il contesto del dispositivo viene passato come NULL e Uniscribe deve accedervi per qualsiasi motivo, Uniscribe restituisce il codice di errore E_PENDING. Questo codice viene restituito rapidamente, consentendo all'applicazione di evitare chiamate SelectObject dispendiose in termini di tempo.

Esempio

L'esempio seguente si applica a tutte le funzioni che accettano una variabile SCRIPT_CACHE e un handle facoltativo in un contesto di dispositivo hardware.

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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Usp10.h

Vedi anche

Uniscribe

Strutture uniscrivibili

Memorizzazione nella cache