Condividi tramite

Uso delle funzioni ScriptString

  • Articolo

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:
ScriptItemize
ScriptShape
ScriptPlace
ScriptBreak
ScriptGetCMap
ScriptJustify
ScriptLayout
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.

Uso di Uniscribe