ScriptLayout-Funktion (usp10.h)

Konvertiert ein Array von Ausführungseinbettungsebenen in eine Zuordnung von visueller zu logischer Position und/oder logisch-zu-visueller Position.

Syntax

HRESULT ScriptLayout(
  [in]            int        cRuns,
  [in]            const BYTE *pbLevel,
  [out, optional] int        *piVisualToLogical,
  [out, optional] int        *piLogicalToVisual
);

Parameter

[in] cRuns

Anzahl der zu verarbeitenden Ausführungen.

[in] pbLevel

Zeiger auf ein Array mit der durch cRuns angegebenen Länge, die Ausführungseinbettungsebenen enthält. Einbettungsebenen für alle Ausführungen in der Zeile müssen enthalten und logisch sortiert werden. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[out, optional] piVisualToLogical

Zeiger auf ein Array mit der durch cRuns angegebenen Länge, in der diese Funktion die Ausführungseinbettungsebenen abruft, die in visuelle Reihenfolge neu angeordnet sind. Das erste Arrayelement stellt die Ausführung dar, die ganz links angezeigt wird, und nachfolgende Einträge sollten von links nach rechts angezeigt werden. Die Funktion legt diesen Parameter auf NULL fest, wenn keine Ausgabe vorhanden ist.

[out, optional] piLogicalToVisual

Zeiger auf ein Array, dessen Länge durch cRuns angegeben wird, in dem diese Funktion die visuellen Ausführungspositionen abruft. Das erste Arrayelement ist die relative visuelle Position, an der die erste logische Ausführung angezeigt werden soll, wobei die äußerste linke Anzeigeposition 0 ist. Die Funktion legt diesen Parameter auf NULL fest, wenn keine Ausgabe vorhanden ist.

Rückgabewert

Gibt bei Erfolg 0 zurück. Die Funktion gibt einen HRESULT-Wert ungleich null zurück, wenn sie nicht erfolgreich ist. Die Anwendung kann den Rückgabewert mit den Makros SUCCEEDED und FAILED testen.

Hinweise

Eine Erläuterung des Kontexts, in dem diese Funktion normalerweise aufgerufen wird, finden Sie unter Anzeigen von Text mit Uniscribe .

Diese Funktion verarbeitet nur Daten, die sich auf eine einzelne Textzeile beziehen.

Die Ausführungseinbettungsebenen werden im bidirektionalen Unicode-Algorithmus definiert. Sie beschreiben die Richtung einer Ausführung, die Richtung aller Ausführungen, in die sie eingebettet ist, und die Richtung des Absatzes. Für den Aufruf dieser Funktion ist keine weitere Eingabe erforderlich. Weitere Informationen finden Sie unter Unicode.

In der folgenden Tabelle sind die vordefinierten Einbettungsebenen aufgeführt. Die Anwendung kann bei Bedarf Ebenen hinzufügen.

Ebene	Bedeutung
0	Eine Von links nach rechts ausgeführte Ausführung in einem Absatz von links nach rechts.
1	Eine von rechts nach links eingebettete Ausführung in einem Links-nach-Rechts-Lauf in einem Absatz von links nach rechts. Alternativ kann eine Rechts-nach-Links-Ausführung, die nicht in eine andere Ausführung eingebettet ist, in einem Absatz von rechts nach links ausgeführt werden.
2	Eine von links nach rechts eingebettete Ausführung in eine Rechts-nach-Links-Ausführung vom Typ 1.
3	Eine in eine Von links nach links eingebettete Ausführung vom Typ 2.

 

Eine "logische Position" bezieht sich auf die Platzierung einer Ausführung relativ zu anderen Ausführungen. Dies ist die Position in einem Sicherungsspeicher und entspricht der Reihenfolge, in der der Benutzer den Text laut vorliest. Die "visuelle Position" einer Ausführung bezieht sich auf die visuelle Darstellung der Ausführung in der Linie, wobei die möglichen Richtungen berücksichtigt werden, die der Lauf haben kann.

Die Anwendung kann diese Funktionseinstellung entweder piLogicalToVisual oder piVisualToLogical oder beides aufrufen.

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in der Bibliotheksliste angeben.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll
Verteilbare Komponente	Internet Explorer 5 oder höher unter Windows Me/98/95

Weitere Informationen

Anzeigen von Text mit Uniscribe

Uniscribe

Uniscribe-Funktionen