TabbedTextOutA 함수(winuser.h)

아티클
03/04/2024

TabbedTextOut 함수는 지정된 위치에 문자 문자열을 쓰고 탭을 탭 중지 위치 배열에 지정된 값으로 확장합니다. 텍스트는 현재 선택한 글꼴, 배경색 및 텍스트 색으로 작성됩니다.

구문

LONG TabbedTextOutA(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

매개 변수

[in] hdc

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

[in] x

문자열 시작점의 x 좌표(논리 단위)입니다.

[in] y

문자열 시작점의 y 좌표(논리 단위)입니다.

[in] lpString

그릴 문자열에 대한 포인터입니다. nCount는 문자열의 길이를 지정하므로 문자열을 0으로 종료할 필요가 없습니다.

[in] chCount

lpString에서 가리키는 문자열의 길이입니다.

[in] nTabPositions

탭 중지 위치 배열의 값 수입니다.

[in] lpnTabStopPositions

논리 단위로 탭 중지 위치를 포함하는 배열에 대한 포인터입니다. 탭 정지를 순서대로 정렬해야 합니다. 가장 작은 x-값은 배열의 첫 번째 항목이어야 합니다.

[in] nTabOrigin

탭이 확장되는 시작 위치의 x 좌표(논리 단위)입니다.

반환 값

함수가 성공하면 반환 값은 문자열의 차원(논리 단위)입니다. 높이가 높은 단어에 있고 너비가 낮은 단어에 있습니다.

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

설명

nTabPositions 매개 변수가 0이고 lpnTabStopPositions 매개 변수가 NULL이면 탭이 평균 문자 너비의 8배로 확장됩니다.

nTabPositions가 1이면 탭 정지는 lpnTabStopPositions 배열의 첫 번째 값으로 지정된 거리로 구분됩니다.

lpnTabStopPositions 배열에 둘 이상의 값이 포함된 경우 nTabPositions에 지정된 수까지 배열의 각 값에 대해 탭 중지가 설정됩니다.

nTabOrigin 매개 변수를 사용하면 애플리케이션이 한 줄에 대해 TabbedTextOut 함수를 여러 번 호출할 수 있습니다. 애플리케이션이 매번 nTabOrigin을 동일한 값으로 설정하여 TabbedTextOut을 두 번 이상 호출하는 경우 함수는 nTabOrigin에 지정된 위치를 기준으로 모든 탭을 확장합니다.

기본적으로 현재 위치는 TabbedTextOut 함수에서 사용되거나 업데이트되지 않습니다. 애플리케이션이 TabbedTextOut을 호출할 때 현재 위치를 업데이트해야 하는 경우 애플리케이션은 wFlags 매개 변수가 TA_UPDATECP 설정된 SetTextAlign 함수를 호출할 수 있습니다. 이 플래그가 설정되면 시스템은 현재 위치를 대신 사용하여 TabbedTextOut 함수에 대한 후속 호출에서 X 및 Y 매개 변수를 무시합니다.

참고 Windows Vista 이상에서는 TabbedTextOut 이 텍스트를 그릴 때 텍스트 맞춤을 무시합니다.

참고

winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 TabbedTextOut을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-5-1(Windows 10 버전 10.0.14393에 도입됨)