ID3DXFont::D rawText 메서드
서식이 지정된 텍스트를 그립니다. 이 메서드는 ANSI 및 유니코드 문자열을 지원합니다.
구문
INT DrawText(
[in] LPD3DXSPRITE pSprite,
[in] LPCTSTR pString,
[in] INT Count,
[in] LPRECT pRect,
[in] DWORD Format,
[in] D3DCOLOR Color
);
매개 변수
-
pSprite [in]
-
형식: LPD3DXSPRITE
문자열을 포함하는 ID3DXSprite 개체에 대한 포인터입니다. NULL일 수 있습니다. 이 경우 Direct3D는 자체 스프라이트 개체를 사용하여 문자열을 렌더링합니다. 효율성을 높이기 위해 DrawText 를 한 행에 두 번 이상 호출하는 경우 스프라이트 개체를 지정해야 합니다.
-
pString [in]
-
형식: LPCTSTR
그릴 문자열에 대한 포인터입니다. Count 매개 변수가 -1이면 문자열이 null로 종료되어야 합니다.
-
개수 [in]
-
형식: INT
문자열에 있는 문자의 수를 지정합니다. Count가 -1이면 pString 매개 변수는 null로 끝나는 문자열에 대한 포인터로 간주되고 DrawText 는 문자 수를 자동으로 계산합니다.
-
pRect [in]
-
형식: LPRECT
텍스트의 서식을 지정할 논리 좌표의 사각형을 포함하는 RECT 구조체에 대한 포인터입니다. 사각형 오른쪽의 좌표 값은 왼쪽보다 커야 합니다. 마찬가지로 아래쪽의 좌표 값은 위쪽의 좌표 값보다 커야 합니다.
-
형식 [in]
-
형식: DWORD
텍스트 서식 지정 방법을 지정합니다. 다음 값의 조합일 수 있습니다.
값 의미 - DT_BOTTOM
텍스트를 사각형 아래쪽으로 맞춥니다. 이 값은 DT_SINGLELINE 함께 사용해야 합니다. - DT_CALCRECT
사각형의 너비와 높이를 결정합니다. 여러 줄의 텍스트가 있는 경우 DrawText 는 pRect 매개 변수가 가리키는 사각형의 너비를 사용하고 사각형의 밑을 확장하여 텍스트의 마지막 줄을 바인딩합니다. 텍스트 줄이 하나만 있는 경우 DrawText 는 사각형의 오른쪽을 수정하여 줄의 마지막 문자를 경계로 합니다. 두 경우 모두 DrawText 는 서식이 지정된 텍스트의 높이를 반환하지만 텍스트를 그리지는 않습니다. - DT_CENTER
직사각형에서 텍스트를 가로로 가운데에 맞춥다. - DT_EXPANDTABS
탭 문자를 확장합니다. 탭당 기본 문자 수는 8개입니다. - DT_LEFT
텍스트를 왼쪽으로 정렬합니다. - DT_NOCLIP
클리핑하지 않고 그립니다. DrawText 는 DT_NOCLIP 사용할 때 다소 빠릅니다. - DT_RIGHT
텍스트를 오른쪽으로 정렬합니다. - DT_RTLREADING
히브리어 또는 아랍어 글꼴을 선택하면 양방향 텍스트의 텍스트를 오른쪽에서 왼쪽으로 읽는 순서로 표시합니다. 모든 텍스트의 기본 읽기 순서는 왼쪽에서 오른쪽입니다. - DT_SINGLELINE
한 줄에만 텍스트를 표시합니다. 캐리지 리턴 및 줄 바꿈은 줄을 끊지 않습니다. - DT_TOP
텍스트를 위쪽으로 정렬합니다. - DT_VCENTER
텍스트를 세로로 가운데에 옵니다(한 줄에만 해당). - DT_WORDBREAK
단어를 중단합니다. 단어가 pRect 매개 변수로 지정된 사각형의 가장자리를 지나 확장하면 단어 사이에 줄이 자동으로 끊어집니다. 캐리지 리턴/줄 바꿈 시퀀스도 선을 끊습니다. -
색 [in]
-
형식: D3DCOLOR
텍스트의 색입니다. 자세한 내용은 D3DCOLOR를 참조하세요.
반환 값
형식: INT
함수가 성공하면 반환 값은 논리 단위의 텍스트 높이입니다. DT_VCENTER 또는 DT_BOTTOM 지정한 경우 반환 값은 그려진 텍스트의 pRect(위쪽에서 아래쪽)의 오프셋입니다. 함수가 실패하면 반환 값은 0입니다.
설명
이 메서드의 매개 변수는 GDI DrawText 함수의 매개 변수와 매우 유사합니다.
이 메서드는 ANSI 및 유니코드 문자열을 모두 지원합니다.
이 메서드는 BeginScene 내에서 호출해야 합니다. EndScene 블록. 유일한 예외는 애플리케이션이 DT_CALCRECT 있는 DrawText 를 호출하여 지정된 텍스트 블록의 크기를 계산하는 경우입니다.
DT_NOCLIP 형식을 사용하지 않는 한 이 메서드는 지정된 사각형 외부에 표시되지 않도록 텍스트를 잘라냅니다. DT_SINGLELINE 형식을 지정하지 않으면 모든 서식에 여러 줄이 있는 것으로 간주됩니다.
선택한 글꼴이 사각형에 비해 너무 큰 경우 이 메서드는 더 작은 글꼴을 대체하려고 시도하지 않습니다.
이 메서드는 이스케이프와 방향이 모두 0인 글꼴만 지원합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보