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 매크로를 사용하여 반환 값을 테스트 할 수 있습니다.

설명

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

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

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

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

Level	의미
0	왼쪽에서 오른쪽 단락에서 왼쪽에서 오른쪽으로 실행됩니다.
1	왼쪽에서 오른쪽 단락의 왼쪽에서 오른쪽 실행에 포함된 오른쪽에서 왼쪽으로 실행합니다. 또는 오른쪽에서 왼쪽 단락의 다른 실행에 포함되지 않은 오른쪽에서 왼쪽으로 실행합니다.
2	형식 1의 오른쪽에서 왼쪽 실행에 포함된 왼쪽에서 오른쪽 실행입니다.
3	형식 2의 왼쪽에서 오른쪽 실행에 포함된 오른쪽에서 왼쪽 실행입니다.

 

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

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

중요 Windows 8 시작: Windows 7에서 실행하는 기능을 유지하려면 Uniscribe를 사용하는 모듈이 라이브러리 목록에서 gdi32.lib 전에 Usp10.lib를 지정해야 합니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	usp10.h
라이브러리	Usp10.lib
DLL	Usp10.dll
재배포 가능 파일	Windows Me/98/95의 인터넷 Explorer 5 이상

추가 정보

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

Uniscribe

Uniscribe 함수