Uso delle funzioni ScriptString
Per un'applicazione che si occupa di testo non formattato, Uniscribe fornisce le funzioni ScriptString* . Queste funzioni sono simili a ExtTextOut, DrawText e GetTextExtent, ma forniscono supporto di script complessi completi, incluso il posizionamento dei caratteri di caret. Queste funzioni sono simili alle altre funzioni Uniscribe, ma sono personalizzate per i requisiti più semplici dell'elaborazione di testo normale.
La tabella seguente illustra in dettaglio le funzioni ScriptString* e tutte le controparti nelle altre funzioni Uniscribe.
| Funzione | Descrizione |
|---|---|
| ScriptStringAnalyse | Analizza il testo normale. Questa funzione corrisponde alle funzioni seguenti: |
| ScriptStringCPtoX | Recupera la coordinata x per una posizione di carattere. Questa funzione corrisponde a ScriptCPtoX. |
| ScriptStringFree | Libera una struttura SCRIPT_STRING_ANALYSIS . |
| ScriptStringGetLogicalWidths | Converte le larghezze visive in larghezze logiche. Questa funzione corrisponde a ScriptGetLogicalWidths. |
| ScriptStringGetOrder | Esegue il mapping delle posizioni del glifo dei caratteri in modo analogo a GetCharacterPlacement, solo per l'uso legacy. Questa funzione non funziona correttamente con gli script che generano più di un glifo per ogni punto di codice. |
| ScriptStringOut | Visualizza testo normale. Questa funzione corrisponde a ScriptTextOut. |
| ScriptString_pcOutChars | Restituisce un puntatore alla lunghezza di una stringa di testo normale ritagliata. |
| ScriptString_pLogAttr | Restituisce un puntatore al buffer degli attributi logici per una stringa di testo normale analizzata. |
| ScriptString_pSize | Restituisce un puntatore alle dimensioni (larghezza e altezza) per una stringa di testo normale analizzata. |
| ScriptStringValidate | Identifica le sequenze di punti di codice non valide nello script specificato. Questa funzione è diversa da ScriptGetCMap, che identifica i punti di codice non presenti in un tipo di carattere. |
| ScriptStringXtoCP | Converte una coordinata x in una posizione di carattere. Questa funzione corrisponde a ScriptXtoCP. |
Per visualizzare solo testo normale senza modifiche, un'applicazione deve chiamare ScriptStringAnalyse, ScriptStringOut e quindi ScriptStringFree. Le altre funzioni vengono usate per modificare il testo normale prima della visualizzazione.
Argomenti correlati