CDC::DrawText

아티클
06/10/2015

지정 된 사각형 텍스트 서식을 지정 하려면이 멤버 함수를 호출 합니다. 추가 서식 옵션을 지정 하려면 CDC::DrawTextEx.

virtual int DrawText( 
   LPCTSTR lpszString, 
   int nCount, 
   LPRECT lpRect, 
   UINT nFormat  
); 
int DrawText( 
   const CString& str, 
   LPRECT lpRect, 
   UINT nFormat  
);

매개 변수

lpszString
그릴 문자열을 가리킵니다. 경우 nCount – 1에는 null로 끝나는 문자열 이어야 합니다.
nCount
문자열에서 문자 수를 지정합니다. 경우 nCount 다음 – 1 이며 lpszString 긴 포인터를 null로 끝나는 문자열로 간주 됩니다 및 DrawText 문자 수가 자동으로 계산 합니다.
lpRect
가리키는 있는 RECT 구조 또는 CRect 사각형 텍스트는 서식을 지정할 논리 좌표로 포함 하는 개체입니다.
str
A CString 그릴의 지정 된 문자를 포함 하는 개체입니다.
nFormat
텍스트 서식 지정 방법을 지정 합니다. 그 조합에 대해 설명 하는 값의 수는 uFormat 매개 변수에 DrawText 에 Windows SDK. (비트 OR 연산자를 사용 하 여 결합):

참고

일부 uFormat 플래그 조합을 전달 된 문자열을 수정할 수 발생할 수 있습니다.사용 하 여 DT_MODIFYSTRING 을 DT_END_ELLIPSIS 또는 DT_PATH_ELLIPSIS 수정할 문자열에서 어설션을 인해 발생할 수 있습니다는 CString 무시 합니다.The values DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, and DT_NOPREFIX cannot be used with the DT_TABSTOP value.

반환 값

함수가 성공 하면 텍스트의 높이입니다.

설명

텍스트를 지정 하 여 적절 한 공백 맞춤 텍스트를 왼쪽, 오른쪽, 또는 지정 된 사각형의 가운데에 탭을 확장 하 고 텍스트를 지정한 사각형 내에 줄 바꿈 합니다. 서식의 형식으로 지정 된 nFormat.

이 멤버 함수 텍스트를 그릴 디바이스 컨텍스트의 선택한 글꼴, 텍스트 색 및 배경색을 사용 합니다. 하지 않으면는 DT_NOCLIP 형식을 사용 하 고 DrawText 텍스트는 지정 된 사각형 밖에 나타나지 않도록 텍스트를 클립 합니다. 모든 서식을 여러 줄 하지 않는 것으로 가정 된 DT_SINGLELINE 형식을 지정 합니다.

선택한 글꼴의 지정 된 사각형을 너무 큰 경우는 DrawText 멤버 함수 더 작은 글꼴로 시도 하지 않습니다.

경우는 DT_CALCRECT 플래그가 지정 된 사각형을 지정 하 여 lpRect 너비 및 텍스트를 그리는 데 필요한 높이 반영 하도록 업데이트 됩니다.

경우는 TA_UPDATECP 텍스트 맞춤 플래그 설정 되었습니다 (참조 CDC::SetTextAlign), DrawText 지정 된 사각형의 왼쪽이 아닌 현재 위치에서 시작 하는 텍스트가 표시 됩니다. DrawText텍스트가 줄 바꿈되지 때의 TA_UPDATECP 플래그가 설정 되었습니다 (즉,는 DT_WORDBREAK 플래그는 효과가 없습니다).

텍스트 색 설정 수 CDC::SetTextColor.