값 서식 지정
이 섹션은 DrawThemeText 및 GetThemeTextExtent 함수의 dwTextFlags 매개 변수와 함께 사용되는 값을 나열합니다. 이러한 값 중 하나 이상이 텍스트 문자열의 형식을 지정하는 방법을 지정하는 데 사용됩니다. DrawThemeText 함수는 pRect 매개 변수로 지정된 표시 사각형 안에 텍스트 문자열을 그립니다. GetThemeTextExtent 함수를 사용하여 지정된 길이와 형식의 텍스트에 필요한 경계 사각형을 확인하는 데 사용할 수 있습니다.
값 서식 지정
다음 표에는 형식 값을 나열합니다.
| 값 | 설명 |
|---|---|
| DT_BOTTOM | 표시 사각형의 아래쪽에 있는 텍스트 문자열을 렌더링합니다. 이 값은 DT_SINGLELINE 값에만 사용됩니다. |
| DT_CALCRECT | 표시 사각형의 너비와 높이를 결정합니다. |
| DT_CENTER | 표시 사각형에서 텍스트를 가로로 가운데에 맞춥니다. |
| DT_EDITCONTROL | 여러 줄 편집 컨트롤의 텍스트 표시 특성을 복제합니다. 특히, 평균 문자 너비는 편집 컨트롤과 동일한 방식으로 계산되며 함수는 부분적으로 보이는 마지막 줄을 표시하지 않습니다. |
| DT_END_ELLIPSIS | 표시 사각형보다 넓은 텍스트 문자열을 잘라내고 잘림을 나타내는 줄임표를 추가합니다. DT_MODIFYSTRING 플래그를 지정하지 않으면 문자열이 수정되지 않습니다. |
| DT_EXPANDTABS | 탭 문자를 확장합니다. 탭당 기본 문자 수는 8개입니다. DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS 및 DT_END_ELLIPSIS 값은 DT_EXPANDTABS 값과 함께 사용할 수 없습니다. |
| DT_EXTERNALLEADING | 선 높이에 글꼴의 외부 선행 값을 포함합니다. 일반적으로 추가 세로 공간은 텍스트 줄의 높이에 포함되지 않습니다. |
| DT_HIDEPREFIX | 텍스트의 접두사 문자 &는 무시합니다. 뒤에 오는 문자에 밑줄이 그어지지 않습니다, 하지만 다른 접두사 문자는 계속 처리 합니다. 예시: 입력 문자열: "A&bc&&d" 기본: "Abc&d" DT_HIDEPREFIX: "Abc&d" |
| DT_LEFT | 텍스트를 왼쪽으로 정렬합니다. |
| DT_MODIFYSTRING | 표시된 텍스트와 일치하도록 문자열을 수정합니다. 이 값은 DT_END_ELLIPSIS 또는 DT_PATH_ELLIPSIS를 지정하지 않으면 적용되지 않습니다. |
| DT_NOCLIP | 표시 사각형을 잘라 내지 않고 텍스트 문자열을 그립니다. |
| DT_NOFULLWIDTHCHARBREAK | 줄 바꿈 규칙은 SBCS(싱글바이트 문자 집합)와 동일하도록 DBCS(더블바이트 문자 세트)에서 줄 바꿈을 방지 합니다. 예를 들어 한국어 텍스트로 작성된 아이콘 레이블을 더 읽기 쉽게 만드는 데 사용할 수 있습니다. 이 값은 DT_WORDBREAK를 지정하지 않으면 적용되지 않습니다. |
| DT_NOPREFIX | 접두사 처리를 해제합니다. 일반적으로 DrawThemeText는 접두사 문자 &를 뒤따르는 문자를 밑줄로 표시하는 지시어로 해석하고 접두사 문자 &&를 단일 &를 인쇄하라는 지시어로 해석합니다. DT_NOPREFIX를 지정하면 이 처리가 비활성화됩니다. 예시: 입력 문자열: "A&bc&&d" 기본: "Abc&d" DT_NOPREFIX: "A&bc&&d" |
| DT_PATH_ELLIPSIS | 결과가 표시 사각형에 맞도록 텍스트 중간에 있는 문자를 줄임표로 바꿉니다. 문자열에 백슬래시(\) 문자가 포함된 경우 DT_PATH_ELLIPSIS 마지막 백슬래시 이후의 텍스트를 최대한 많이 보존합니다. DT_MODIFYSTRING 플래그를 지정하지 않으면 문자열이 수정되지 않습니다. |
| DT_PREFIXONLY | 접두사 문자 & 다음의 위치에만 밑줄을 긋습니다. 일반적으로 DrawThemeText는 &를 뒤따르는 문자를 밑줄로 표시하는 지시어로 해석하고 접두사 문자 &&를 단일 &를 인쇄하라는 지시어로 해석합니다. DT_PREFIXONLY를 지정하면 문자가 그려지지 않고 밑줄만 그어집니다. 공백은 문자가 일반적으로 표시되는 위치에 배치됩니다. 예: 입력 문자열: "A&bc&&d" normal: "Abc&d DT_PREFIXONLY: " " |
| DT_RIGHT | 텍스트를 오른쪽으로 정렬합니다. |
| DT_RTLREADING | 양방향 텍스트(예: 히브리어 또는 아랍어 글꼴의 텍스트)에 대해 오른쪽에서 왼쪽 순서로 텍스트를 배치합니다. 텍스트의 기본 방향은 왼쪽에서 오른쪽입니다. |
| DT_SINGLELINE | 텍스트를 한 줄에 표시합니다. 캐리지 리턴 및 줄 바꿈은 줄을 끊지 않습니다. |
| DT_TABSTOP | 탭 정지를 설정합니다. |
| DT_TOP | 표시 사각형의 맨 위에 있는 텍스트를 렌더링합니다. |
| DT_VCENTER | 텍스트를 세로로 가운데에 맞춥니다. 이 값은 DT_SINGLELINE 값에만 사용됩니다. |
| DT_WORDBREAK | 단어가 표시 사각형의 가장자리를 지나 확장되는 경우 단어 사이의 선을 끊습니다. CR/LF(캐리지 리턴/줄 바꿈) 시퀀스도 선을 끊습니다. |
| DT_WORD_ELLIPSIS | 표시 사각형에 맞지 않는 단어를 잘라내고 줄임표를 추가합니다. |