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.
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 |