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과 결합할 수 있습니다.

값 의미
ETO_CLIPPED
 텍스트를 사각형으로 클리핑합니다.
ETO_OPAQUE
 현재 배경색을 사용하여 사각형을 채웁니다.

[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 8 시작: Windows 7에서 실행되는 기능을 유지하려면 Uniscribe를 사용하는 모듈에서 라이브러리 목록에서 gdi32.lib 전에 Usp10.lib를 지정해야 합니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 usp10.h
라이브러리 Usp10.lib
DLL Usp10.dll

추가 정보

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Uniscribe

Uniscribe 함수