SCRIPT_CACHE

Définit un cache de métrique de police uniscribe.

typedef void* SCRIPT_CACHE;

Notes

Il s’agit d’une structure opaque. L’application doit allouer et conserver une variable SCRIPT_CACHE pour chaque style de caractère utilisé. La variable doit être initialisée sur NULL.

De nombreuses fonctions de script combinent un handle de contexte de périphérique matériel et une variable SCRIPT_CACHE. La première tentative de monocrire tente d’accéder aux données de police à l’aide de la variable SCRIPT_CACHE. Il inspecte uniquement le contexte de l’appareil matériel si les données requises ne sont pas déjà mises en cache.

Le handle de contexte du périphérique matériel peut être passé à Uniscribe en tant que NULL. Si les données requises par Uniscribe sont déjà mises en cache, le contexte de l’appareil n’est pas accessible et l’opération se poursuit normalement.

Si le contexte de l’appareil est passé comme NULL et que Uniscribe doit y accéder pour une raison quelconque, Uniscribe retourne le code d’erreur E_PENDING. Ce code est retourné rapidement, ce qui permet à l’application d’éviter les appels SelectObject fastidieux.

Exemples

L’exemple suivant s’applique à toutes les fonctions qui prennent une variable SCRIPT_CACHE et un handle facultatif dans un contexte d’appareil matériel.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Usp10.h

Voir aussi

Annuler l’inscription

Structures monocrites

Mise en cache