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 [ 진행]

유형: LPD3DXSPRITE

문자열을 포함 하는 ID3DXSprite 개체에 대 한 포인터입니다. 는 NULL 일 수 있습니다 .이 경우 Direct3D는 자체 sprite 개체를 사용 하 여 문자열을 렌더링 합니다. 효율성을 높이기 위해 행에서 DrawText 를 두 번 이상 호출 하는 경우 스프라이트 개체를 지정 해야 합니다.

Pstring [ 진행]

유형: LPCTSTR

그릴 문자열에 대 한 포인터입니다. Count 매개 변수가-1 이면 문자열이 null로 종료 되어야 합니다.

개수 [ 진행]

형식: INT

문자열에 있는 문자의 수를 지정합니다. Count가-1 이면 pString 매개 변수는 null로 끝나는 문자열에 대 한 포인터로 간주 되 고 DrawText 는 문자 수를 자동으로 계산 합니다.

pRect [ 진행]

유형: LPRECT

텍스트의 서식을 지정할 사각형 (논리적 좌표)을 포함 하는 RECT 구조체에 대 한 포인터입니다. 사각형 오른쪽 변의 좌표 값은 좌 변에 있는 사각형 보다 커야 합니다. 마찬가지로, 아래쪽의 좌표 값은 위쪽의 좌표 값 보다 커야 합니다.

형식 [ 진행]

유형: DWORD

텍스트의 서식을 지정 하는 방법을 지정 합니다. 다음 값을 임의로 조합 하 여 사용할 수 있습니다.

의미
DT _ BOTTOM
텍스트를 사각형의 아래쪽에 맞춥니다. 이 값은 DT Regexoptions.singleline와 함께 사용 해야 합니다 _ .
DT _ CALCRECT
사각형의 너비와 높이를 결정 합니다. 텍스트 줄이 여러 개인 경우 DrawText 는 pRect 매개 변수가 가리키는 사각형의 너비를 사용 하 고 사각형의 밑을 확장 하 여 텍스트의 마지막 줄을 바인딩합니다. 한 줄의 텍스트만 있는 경우 DrawText 는 줄의 마지막 문자를 경계로 사각형의 오른쪽을 수정 합니다. 두 경우 모두 DrawText 는 서식이 지정 된 텍스트의 높이를 반환 하지만 텍스트를 그리지는 않습니다.
DT _ 센터
사각형에서 텍스트를 가로로 가운데 맞춤 합니다.
DT _ EXPANDTABS
탭 문자를 확장합니다. 탭당 기본 문자 수는 8개입니다.
DT _ 왼쪽
텍스트를 왼쪽에 맞춥니다.
DT _ NOCLIP
클리핑을 사용 하지 않고 그립니다. DT _ noclip을 사용 하는 경우 DrawText는 약간 더 빠릅니다.
DT _ RIGHT
텍스트를 오른쪽에 맞춥니다.
DT _ RTLREADING
히브리어 또는 아랍어 글꼴을 선택할 때 양방향 텍스트에 대 한 오른쪽에서 왼쪽 읽기 순서로 텍스트를 표시 합니다. 모든 텍스트에 대 한 기본 읽기 순서는 왼쪽에서 오른쪽입니다.
DT _ REGEXOPTIONS.SINGLELINE
텍스트를 한 줄에만 표시 합니다. 캐리지 리턴 및 줄 바꿈 문자는 줄 바꿈 하지 않습니다.
DT _ 위쪽
텍스트를 맨 위로 정렬 합니다.
DT _ VCENTER
텍스트를 세로 방향으로 가운데에 맞춥니다 (한 줄에만 해당).
DT _ WORDBREAK
단어를 구분 합니다. PRect 매개 변수로 지정 된 사각형의 가장자리를 지나서 단어를 확장 하면 단어가 자동으로 줄 바꿈 됩니다. 캐리지 리턴/줄 바꿈 시퀀스는 줄도 중단 합니다.

[ 진행]

유형: D3DCOLOR

텍스트의 색입니다. 자세한 내용은 D3DCOLOR를 참조 하세요.

반환 값

형식: INT

함수가 성공 하면 반환 값은 텍스트의 높이 (논리 단위)입니다. DT _ VCENTER 또는 dt _ BOTTOM을 지정 하는 경우 반환 값은 그려지는 텍스트의 pRect (위쪽에서 아래쪽) 까지의 오프셋입니다. 함수가 실패하면 반환 값은 0입니다.

설명

이 메서드의 매개 변수는 GDI DrawText 함수와 매우 비슷합니다.

이 메서드는 ANSI 문자열과 유니코드 문자열을 모두 지원 합니다.

이 메서드는 Beginscene 내에서 호출 해야 합니다. Endscene 블록입니다. 유일한 예외는 응용 프로그램이 DT calcrect를 사용 하 여 DrawText 를 호출 _ 하 여 지정 된 텍스트 블록의 크기를 계산 하는 경우입니다.

DT _ noclip 형식을 사용 하지 않는 경우이 메서드는 지정 된 사각형의 외부에 표시 되지 않도록 텍스트를 클리핑 합니다. DT Regexoptions.singleline 형식을 지정 하지 않는 한 모든 서식 지정은 여러 줄로 가정 됩니다 _ .

선택한 글꼴이 사각형에 대해 너무 크면이 메서드는 더 작은 글꼴을 대체 하지 않습니다.

이 메서드는 이스케이프와 방향이 모두 0 인 글꼴만 지원 합니다.

요구 사항

요구 사항
헤더
D3dx9core
라이브러리
D3dx9

참고 항목

ID3DXFont