GetTextAlign 함수(wingdi.h)

GetTextAlign 함수는 지정된 디바이스 컨텍스트에 대한 텍스트 맞춤 설정을 검색합니다.

구문

UINT GetTextAlign(
  [in] HDC hdc
);

[in] hdc

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

함수가 성공하면 반환 값은 텍스트 맞춤 플래그의 상태. 반환 값에 대한 자세한 내용은 주의 섹션을 참조하세요. 반환 값은 다음 값의 조합입니다.

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

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

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

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

경계 사각형은 텍스트 문자열의 모든 문자 셀을 경계하는 사각형입니다. GetTextExtentPoint32 함수를 호출하여 해당 차원을 가져올 수 있습니다.

텍스트 맞춤 플래그는 TextOut 및 ExtTextOut 함수가 TextOut 또는 ExtTextOut에 제공된 문자열의 참조 지점과 관련하여 텍스트 문자열을 정렬하는 방법을 결정합니다.

텍스트 맞춤 플래그는 반드시 단일 비트 플래그가 아니며 0과 같을 수 있습니다. 다음 목록에 표시된 대로 관련 플래그 그룹에서 플래그를 검사해야 합니다.

현재 글꼴에 세로 기본 줄이 있는 경우 관련 플래그는 다음 목록에 나와 있습니다.

특정 플래그가 이 함수의 반환 값에 설정되어 있는지 확인하려면 다음을 수행합니다.

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