SetTextCharacterExtra 함수(wingdi.h)

SetTextCharacterExtra 함수는 문자 간 간격을 설정합니다. 시스템에서 텍스트 줄을 작성할 때 구분 문자를 포함하여 각 문자에 문자 간 간격이 추가됩니다.

구문

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] extra

각 문자에 추가할 추가 공간(논리 단위)입니다. 현재 매핑 모드가 MM_TEXT 않으면 nCharExtra 매개 변수가 변환되고 가장 가까운 픽셀로 반올림됩니다.

함수가 성공하면 반환 값은 이전 문자 간 간격입니다.

함수가 실패하면 반환 값이 0x80000000.

이 함수는 주로 기존 애플리케이션과의 호환성을 위해 지원됩니다. 새 애플리케이션은 일반적으로 복잡한 스크립트(텍스트 셰이핑이 필요한 스크립트)와 호환되지 않으므로 이 함수를 호출하지 않아야 합니다. 아랍어 스크립트는 이 예제입니다.)

권장되는 방법은 이 함수와 TextOut을 호출하는 대신 애플리케이션이 ExtTextOut 를 호출하고 lpDx 매개 변수를 사용하여 너비를 제공해야 한다는 것입니다.

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