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을 반환합니다. 함수가 성공하지 못하면 0이 아닌 HRESULT 값을 반환합니다. 애플리케이션은 SUCCEEDED 및 FAILED 매크로를 사용하여 반환 값을 테스트 할 수 있습니다.

설명

이 함수가 일반적으로 호출되는 컨텍스트에 대한 설명은 유니스크립을 사용하여 텍스트 표시 를 참조하세요.

이 함수는 한 줄의 텍스트와 관련된 데이터만 처리합니다.

실행 포함 수준은 유니코드 양방향 알고리즘에 정의됩니다. 실행 방향, 실행이 포함된 실행의 방향 및 단락의 방향을 설명합니다. 이 함수에 대한 호출에는 다른 입력이 필요하지 않습니다. 자세한 내용은 유니코드를 참조하세요.

다음 표에서는 미리 정의된 포함 수준을 나열합니다. 애플리케이션은 필요에 따라 수준을 추가할 수 있습니다.

"논리적 위치"는 다른 실행을 기준으로 실행의 배치를 나타냅니다. 백업 저장소의 위치이며 사용자가 텍스트를 소리 내어 읽는 순서에 해당합니다. 실행의 "시각적 위치"는 실행이 줄에 시각적으로 표시되는 방식을 나타내며 실행이 가질 수 있는 가능한 방향을 고려합니다.

애플리케이션은 piLogicalToVisual 또는 piVisualToLogical 또는 둘 다에서 이 함수 설정을 호출 할 수 있습니다.

요구 사항

추가 정보

유니스크립팅을 사용하여 텍스트 표시

Uniscribe

Uniscribe 함수