SetTextJustification 함수(wingdi.h)

아티클
08/27/2023

SetTextJustification 함수는 시스템에서 텍스트 문자열의 나누기 문자에 추가해야 하는 공간의 크기를 지정합니다. 이 공간은 애플리케이션이 TextOut 또는 ExtTextOut 함수를 호출할 때 추가됩니다.

구문

BOOL SetTextJustification(
  [in] HDC hdc,
  [in] int extra,
  [in] int count
);

매개 변수

[in] hdc

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

[in] extra

텍스트 줄에 추가할 총 추가 공간(논리 단위)입니다. 현재 매핑 모드가 MM_TEXT 않으면 nBreakExtra 매개 변수로 식별되는 값이 변환되고 가장 가까운 픽셀로 반올림됩니다.

[in] count

줄에 있는 나누기 문자의 수입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

나누기 문자는 일반적으로 공백 문자(ASCII 32)이지만 글꼴로 다른 문자로 정의할 수 있습니다. GetTextMetrics 함수를 사용하여 글꼴의 중단 문자를 검색할 수 있습니다.

TextOut 함수는 줄의 중단 문자 간에 지정된 추가 공간을 균등하게 분산합니다.

GetTextExtentPoint32 함수는 항상 SetTextJustification 함수와 함께 사용됩니다. 경우에 따라 GetTextExtentPoint32 함수는 정당화하기 전에 지정된 줄의 너비를 계산할 때 근거를 고려하며, 그렇지 않은 경우도 있습니다. 이에 대한 자세한 내용은 GetTextExtentPoint32를 참조하세요. 적절한 nBreakExtra 값을 계산하려면 먼저 이 너비를 알고 있어야 합니다.

SetTextJustification 을 사용하여 여러 글꼴에 여러 문자열이 포함된 줄을 정당화할 수 있습니다. 이 경우 각 문자열은 별도로 양쪽 맞춤해야 합니다.

반올림 오류는 근거 중에 발생할 수 있으므로 시스템은 현재 오류 값을 정의하는 실행 중인 오류 용어를 유지합니다. 여러 실행이 포함된 줄을 정당화할 때 GetTextExtentPoint 는 다음 실행의 범위를 계산할 때 이 오류 용어를 자동으로 사용하므로 TextOut 에서 오류를 새 실행에 혼합할 수 있습니다. 각 줄이 정당화되면 다음 줄에 통합되지 않도록 이 오류 용어를 지워야 합니다. nBreakExtra가 0으로 설정된 SetTextJustification을 호출하여 용어를 지울 수 있습니다.

요구 사항


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