Funzione ScriptBreak (usp10.h)

Articolo
08/26/2023

Recupera informazioni per determinare le interruzioni di riga.

Sintassi

HRESULT ScriptBreak(
  [in]  const WCHAR           *pwcChars,
  [in]  int                   cChars,
  [in]  const SCRIPT_ANALYSIS *psa,
  [out] SCRIPT_LOGATTR        *psla
);

Parametri

[in] pwcChars

Puntatore ai caratteri Unicode da elaborare.

[in] cChars

Numero di caratteri Unicode da elaborare.

[in] psa

Puntatore alla struttura SCRIPT_ANALYSIS ottenuta da una chiamata precedente a ScriptItemize.

[out] psla

Puntatore a un buffer in cui questa funzione recupera gli attributi di carattere come struttura SCRIPT_LOGATTR .

Valore restituito

Restituisce 0 in caso di esito positivo. La funzione restituisce un valore HRESULT diverso da zero se non riesce. L'applicazione può testare il valore restituito con le macro SUCCESSED e FAILED .

Commenti

Per una discussione sul contesto in cui viene normalmente chiamata questa funzione, vedere Visualizzazione del testo con Uniscrivimento .

Questa funzione non richiede un contesto del dispositivo e non esegue la forma del glifo.

Questa funzione recupera lo spostamento del cursore e la formattazione delle posizioni di interruzione per un elemento in una matrice di strutture SCRIPT_LOGATTR . Per supportare correttamente la formattazione mista all'interno di una singola parola, la chiamata a ScriptBreak deve passare interi elementi recuperati da ScriptItemize e non la formattazione più corretta.

La struttura SCRIPT_LOGATTR identifica posizioni e interruzioni di riga valide. Il membro fCharStop specifica un flag che contrassegna i limiti del cluster per gli script che sono convenzionalmente limitati dallo spostamento all'interno di cluster. È anche possibile dedurre gli stessi limiti controllando le informazioni del cluster logico recuperate da ScriptShape. ScriptBreak, tuttavia, è notevolmente più veloce nell'implementazione e non richiede la preparazione di un contesto del dispositivo.

I flag designati dai membri fWordStop, fSoftBreak e fWhiteSpace di SCRIPT_LOGATTR sono disponibili solo tramite ScriptBreak.

La maggior parte dei motori di modellazione che identificano sequenze non valide impostano il flag indicato dal membro fInvalid di SCRIPT_LOGATTR in ScriptBreak. Il membro fInvalidLogAttr di SCRIPT_PROPERTIES identifica gli script applicabili.

Importante A partire da Windows 8: per mantenere la possibilità di eseguire in Windows 7, un modulo che usa Uniscribe deve specificare Usp10.lib prima di gdi32.lib nell'elenco delle librerie.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	usp10.h
Libreria	Usp10.lib
DLL	Usp10.dll
Componente ridistribuibile	Internet Explorer 5 o versione successiva in Windows Me/98/95