SetTextAlign 함수(wingdi.h)

아티클
08/27/2023

SetTextAlign 함수는 지정된 디바이스 컨텍스트에 대한 텍스트 맞춤 플래그를 설정합니다.

구문

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

매개 변수

[in] hdc

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

[in] align

다음 목록에 있는 값의 마스크를 사용하여 텍스트 맞춤입니다. 가로 및 세로 맞춤에 영향을 주는 플래그는 하나만 선택할 수 있습니다. 또한 현재 위치를 변경하는 두 플래그 중 하나만 선택할 수 있습니다.

값	의미
TA_BASELINE	참조 지점은 텍스트의 기본 줄에 있습니다.
TA_BOTTOM	참조 지점은 경계 사각형의 아래쪽 가장자리에 있습니다.
TA_TOP	참조 지점은 경계 사각형의 위쪽 가장자리에 있습니다.
TA_CENTER	참조 지점은 경계 사각형의 가운데에 가로로 정렬됩니다.
TA_LEFT	참조 지점은 경계 사각형의 왼쪽 가장자리에 있습니다.
TA_RIGHT	참조 지점은 경계 사각형의 오른쪽 가장자리에 있습니다.
TA_NOUPDATECP	현재 위치는 각 텍스트 출력 호출 후에 업데이트되지 않습니다. 참조 지점은 텍스트 출력 함수에 전달됩니다.
TA_RTLREADING	Windows의 중동 언어 버전: 텍스트는 기본 왼쪽에서 오른쪽 순서가 아닌 오른쪽에서 왼쪽 읽기 순서로 배치됩니다. 이는 디바이스 컨텍스트에 선택된 글꼴이 히브리어 또는 아랍어인 경우에만 적용됩니다.
TA_UPDATECP	현재 위치는 각 텍스트 출력 호출 후에 업데이트됩니다. 현재 위치는 참조 지점으로 사용됩니다.

현재 글꼴에 세로 기본 줄이 있는 경우 간지와 마찬가지로 TA_BASELINE 및 TA_CENTER 대신 다음 값을 사용해야 합니다.

값	의미
VTA_BASELINE	참조 지점은 텍스트의 기본 줄에 있습니다.
VTA_CENTER	참조 지점은 경계 사각형의 가운데에 세로로 정렬됩니다.

기본값은 TA_LEFT, TA_TOP 및 TA_NOUPDATECP.

반환 값

함수가 성공하면 반환 값은 이전 텍스트 맞춤 설정입니다.

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

설명

TextOut 및 ExtTextOut 함수는 텍스트 맞춤 플래그를 사용하여 디스플레이 또는 다른 디바이스에 텍스트 문자열을 배치합니다. 플래그는 참조 지점과 텍스트를 경계로 하는 사각형 간의 관계를 지정합니다. 참조 지점은 현재 위치 또는 텍스트 출력 함수에 전달된 점입니다.

텍스트를 경계하는 사각형은 텍스트 문자열의 문자 셀에 의해 형성됩니다.

왼쪽 맞춤 텍스트를 가져오는 가장 좋은 방법은 중 하나를 사용하는 것입니다.


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

또는


SetTextAlign (hdc,TA_LEFT | <other flags>)

이 목적을 위해 SetTextAlign (hdc, TA_LEFT)을 사용할 수도 있지만 세로 또는 오른쪽에서 왼쪽으로 설정이 손실됩니다.

참고 선택한 텍스트가 올바르게 렌더링되지 않으므로 ScriptStringOut을 사용하는 경우 TA_UPDATECP SetTextAlign을 사용하면 안 됩니다. 이 플래그를 사용해야 하는 경우 문제를 방지하기 위해 필요에 따라 설정을 해제하고 다시 설정할 수 있습니다.

예제

예제는 텍스트 맞춤 설정을 참조하세요.

요구 사항


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