TabbedTextOutA 함수(winuser.h)
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 1이면 탭 정지는 lpnTabStopPositions 배열의 첫 번째 값으로 지정된 거리로 구분됩니다.
lpnTabStopPositions 배열에 둘 이상의 값이 포함된 경우 nTabPositions지정된 수까지 배열의 각 값에 대해 탭 정지가 설정됩니다.
nTabOrigin 매개 변수를 사용하면 애플리케이션이 한 줄에 대해 TabbedTextOut 함수를 여러 번 호출할 수 있습니다. 애플리케이션이 nTabOrigin 매번 동일한 값으로 설정된 TabbedTextOut 두 번 이상 호출하는 경우 함수는 nTabOrigin지정된 위치를 기준으로 모든 탭을 확장합니다.
기본적으로 현재 위치는 TabbedTextOut 함수에서 사용되거나 업데이트되지 않습니다. 애플리케이션이 TabbedTextOut호출할 때 현재 위치를 업데이트해야 하는 경우 애플리케이션은 TA_UPDATECP 설정된 wFlags 매개 변수를 사용하여 SetTextAlign 함수를 호출할 수 있습니다. 이 플래그가 설정되면 시스템은 현재 위치를 대신 사용하여 TabbedTextOut 함수에 대한 후속 호출에서 X 무시하고 Y 매개 변수를 무시합니다.
메모
winuser.h 헤더는 TABbedTextOut을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 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에서 도입됨) |
참고 항목
drawText
GetTabbedTextExtent
SelectObject
SetBkColor
SetTextAlign
SetTextColor
TextOut