ScriptLayout 函式 (usp10.h)

將執行 內嵌層級 的陣列轉換為視覺到邏輯位置的對應和/或邏輯到視覺位置。

語法

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

參數

[in] cRuns

要處理的執行次數。

[in] pbLevel

數位的指標，其長度由 cRuns 表示，包含執行內嵌層級。 必須包含行上所有執行的內嵌層級，並以邏輯方式排序。 如需詳細資訊，請參閱＜備註＞一節。

[out, optional] piVisualToLogical

數位的指標，其長度為 cRuns，在此陣列中，此函式會擷取重新排列為視覺順序的執行內嵌層級。 第一個陣列元素代表要顯示在最左邊的回合，後續專案應該會顯示從左至右的進度。 如果沒有任何輸出，此函式會將此參數設定為 NULL 。

[out, optional] piLogicalToVisual

數位的指標，其長度為 cRuns，在此陣列中，此函式會擷取視覺執行位置。 第一個數位元素是應該顯示第一個邏輯執行之相對視覺位置，最左邊的顯示位置是0。 如果沒有任何輸出，此函式會將此參數設定為 NULL 。

傳回值

若成功，即傳回 0。 如果函式不成功，函式會傳回非零 HRESULT 值。 應用程式可以使用 SUCCEEDED 和 FAILED 宏來測試傳回值。

備註

如需通常呼叫此函式的內容討論，請參閱 使用 Uniscribe 顯示文字 。

此函式只會處理與單行文字相關的數據。

執行內嵌層級定義於 Unicode 雙向演算法中。 它們描述執行的方向、其內嵌的任何執行方向，以及段落的方向。 呼叫此函式時不需要任何其他輸入。 如需詳細資訊，請參閱 Unicode。

下表列出預先定義的內嵌層級。 應用程式可以視需要新增層級。

「邏輯位置」是指相對於其他回合的執行位置。 它是備份儲存區中的位置，會對應到使用者大聲朗讀文字的順序。 回合的「視覺位置」是指在行上以可視化方式顯示執行的方式，並考慮執行可以擁有的可能方向。

應用程式可以呼叫此函式設定 piLogicalToVisual 或 piVisualToLogical，或兩者。

規格需求

另請參閱

使用 Uniscribe 顯示文字

Uniscribe

Uniscribe 函式