ScriptStringOut 함수(usp10.h)
ScriptStringAnalyse에 대한 이전 호출에서 생성된 문자열을 표시하고 필요에 따라 강조 표시를 추가합니다.
구문
HRESULT ScriptStringOut(
[in] SCRIPT_STRING_ANALYSIS ssa,
[in] int iX,
[in] int iY,
[in] UINT uOptions,
[in, optional] const RECT *prc,
[in] int iMinSel,
[in] int iMaxSel,
[in] BOOL fDisabled
);
매개 변수
[in] ssa
문자열에 대한 SCRIPT_STRING_ANALYSIS 구조체입니다.
[in] iX
문자열을 배치하는 데 사용되는 참조 지점의 x 좌표입니다.
[in] iY
문자열을 배치하는 데 사용되는 참조 지점의 y 좌표입니다.
[in] uOptions
애플리케이션 정의 사각형의 사용을 지정하는 옵션입니다. 이 매개 변수는 0 또는 다음 값으로 설정할 수 있습니다. 값은 이진 OR과 결합할 수 있습니다.
| 값 | 의미 |
|---|---|
|
텍스트를 사각형으로 클리핑합니다. |
|
현재 배경색을 사용하여 사각형을 채웁니다. |
[in, optional] prc
사용할 사각형을 정의하는 RECT 구조체에 대한 포인터입니다. uOptions가 ETO_OPAQUE 설정되고 prc에 NULL이 제공되면 함수가 성공하고 S_OK 반환합니다. 그러나 애플리케이션이 uOptions를 ETO_CLIPPING 설정하고 prc에 NULL을 제공하는 경우 함수는 E_INVALIDARG 반환합니다. 애플리케이션은 이 매개 변수를 NULL 로 설정하여 옵션이 필요하지 않음을 나타낼 수 있습니다.
[in] iMinSel
문자열의 시작 위치를 지정하는 인덱스(0부터 시작)입니다. 선택하지 않으면 애플리케이션에서 iMinSel>= iMaxSel을 설정해야 합니다.
[in] iMaxSel
문자열의 끝 위치를 지정하는 인덱스(0부터 시작)입니다.
[in] fDisabled
TRUE 이면 선택한 모든 문자 뒤에 배경색을 COLOR_HIGHLIGHT 설정하여 운영 체제에서 비활성화 텍스트 강조 표시를 적용합니다. 운영 체제에서 배경색을 COLOR_HIGHLIGHT 설정하고 선택한 각 문자에 대해 텍스트 색을 COLOR_HIGHLIGHTTEXT 설정하여 사용 텍스트 강조 표시를 적용하는 경우 애플리케이션에서 이 매개 변수를 FALSE 로 설정할 수 있습니다.
반환 값
성공하면 S_OK 반환합니다. 함수는 성공하지 못하면 0이 아닌 HRESULT 값을 반환합니다. 애플리케이션은 SUCCEEDED 및 FAILED 매크로를 사용하여 반환 값을 테스트 할 수 없습니다.
설명
이 함수를 사용하려면 애플리케이션이 ScriptStringAnalyse에 대한 원래 호출에서 SSA_GLYPHS 지정해야 합니다.
선택한 텍스트를 올바르게 렌더링할 수 없으므로 ScriptStringOut을 사용하는 경우 애플리케이션에서 TA_UPDATECP SetTextAlign을 사용하면 안 됩니다. 애플리케이션에서 이 플래그를 사용해야 하는 경우 문제를 방지하기 위해 필요에 따라 플래그를 설정 해제하고 다시 설정할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | usp10.h |
| 라이브러리 | Usp10.lib |
| DLL | Usp10.dll |