struttura SCRIPT_ANALYSIS (usp10.h)

Articolo
03/13/2024

Contiene una parte di una stringa Unicode, ovvero un "elemento".

Sintassi

typedef struct tag_SCRIPT_ANALYSIS {
  WORD         eScript : 10;
  WORD         fRTL : 1;
  WORD         fLayoutRTL : 1;
  WORD         fLinkBefore : 1;
  WORD         fLinkAfter : 1;
  WORD         fLogicalOrder : 1;
  WORD         fNoGlyphIndex : 1;
  SCRIPT_STATE s;
} SCRIPT_ANALYSIS;

Members

eScript

Valore opaco che identifica il motore usato da Uniscribe quando si chiamano le funzioni ScriptShape, ScriptPlace e ScriptTextOut per l'elemento. Il valore di questo membro non è definito e le applicazioni non devono basarsi sul relativo valore che corrisponde da una versione alla successiva. Un'applicazione può ottenere gli attributi di eScript chiamando ScriptGetProperties.

Per disabilitare il data shaping, l'applicazione deve impostare questo membro su SCRIPT_UNDEFINED.

fRTL

Valore che indica la direzione di rendering. I valori possibili sono definiti nella tabella seguente. Questo membro è impostato su TRUE per un numero in una sequenza da sinistra a destra, perché le cifre vengono sempre visualizzate da sinistra a destra o FALSE per un numero in un'esecuzione da destra a sinistra. Il valore di questo membro è in genere identico alla parità del livello di incorporamento Unicode, ma può essere diverso se sottoposto a override dal supporto legacy getCharacterPlacement .

Valore	Significato
VERO	Usare una direzione di rendering da destra a sinistra.
FALSE	Usare una direzione di rendering da sinistra a destra.

fLayoutRTL

Valore che indica la direzione del layout per un numero. I valori possibili sono definiti nella tabella seguente. Questo membro è in genere uguale al valore assegnato a fRTL per un numero in un'esecuzione da destra a sinistra.

Valore	Significato
VERO	Disporre il numero in un'esecuzione da destra a sinistra, perché viene letto come parte della sequenza da destra a sinistra.
FALSE	Disporre il numero in una sequenza da sinistra a destra, perché viene letto come parte della sequenza da sinistra a destra.

fLinkBefore

Valore che indica se il motore di data shaping forma il primo carattere dell'elemento come se unisse con un carattere precedente. I valori possibili sono definiti nella tabella seguente. Questo membro viene impostato da ScriptItemize. L'applicazione può eseguire l'override del valore prima di chiamare ScriptShape.

Valore	Significato
VERO	Modellare il primo carattere collegando un carattere precedente.
FALSE	Non modellare il primo carattere collegando un carattere precedente.

fLinkAfter

Valore che indica se il motore di data shaping forma l'ultimo carattere dell'elemento come se si unisse a un carattere successivo. I valori possibili sono definiti nella tabella seguente. Questo membro viene impostato da ScriptItemize. L'applicazione può eseguire l'override del valore prima di chiamare ScriptItemize.

Valore	Significato
VERO	Modellare l'ultimo carattere collegando un carattere successivo.
FALSE	Non modellare l'ultimo carattere collegando un carattere successivo.

fLogicalOrder

Valore che indica se il motore di modellazione genera tutte le matrici correlate al glifo in ordine logico. I valori possibili sono definiti nella tabella seguente. Questo membro è impostato su FALSE da ScriptItemize. L'applicazione può eseguire l'override del valore prima di chiamare ScriptShape.

Valore	Significato
VERO	Generare tutte le matrici correlate al glifo in ordine logico.
FALSE	Generare tutte le matrici correlate al glifo in ordine visivo, con la prima voce di matrice corrispondente al glifo più a sinistra. Questo è il valore predefinito.

fNoGlyphIndex

Valore che indica l'uso di glifi per l'elemento. I valori possibili sono definiti nella tabella seguente. L'applicazione può impostare questo membro su TRUE per l'input su ScriptShape per disabilitare l'uso dei glifi per l'elemento. Inoltre , ScriptShape lo imposta su TRUE per un contesto hardware contenente tipi di carattere simbolici, non riconosciuti e del dispositivo.

La disabilitazione dell'uso di glifi disabilita anche la definizione di script complessi. L'impostazione di questo membro su TRUE implementa la forma e l'inserimento direttamente tramite chiamate a GetTextExtentExPoint e ExtTextOut.

Valore	Significato
VERO	Disabilitare l'uso dei glifi per l'elemento. Questo valore viene usato per i tipi di carattere bitmap, vector e device.
FALSE	Abilitare l'uso di glifi per l'elemento. Questo è il valore predefinito.

s

Struttura SCRIPT_STATE contenente una copia dello stato dell'algoritmo Unicode.

Commenti

Questa struttura viene compilata da ScriptItemize o ScriptItemizeOpenType, ognuna delle quali suddivide una stringa Unicode in elementi formabili singolarmente. Nessuna delle due funzioni accede direttamente alla struttura SCRIPT_ANALYSIS . Ogni funzione gestisce una matrice di strutture SCRIPT_ITEM , ognuna delle quali ha un membro che definisce una struttura SCRIPT_ANALYSIS .

Le applicazioni che usano ScriptItemizeOpenType anziché ScriptItemize devono usare anche ScriptShapeOpenType e ScriptPlaceOpenType anziché ScriptShape e ScriptPlace. Per altre informazioni, vedere Visualizzazione di testo con Uniscribe.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	usp10.h
Componente ridistribuibile	Internet Explorer 5 o versione successiva suWindows Me/98/95