DrawTextWrap 함수

[DrawTextWrap은 Windows XP 서비스 팩 2(SP2)를 통해 사용할 수 있습니다. 후속 버전에서 변경되거나 사용하지 못할 수 있습니다. 대신 DrawText를 직접 사용하는 것이 좋습니다.]

지정된 사각형에 서식 있는 텍스트를 그립니다. 지정된 방법(탭 확장, 문자 정렬, 줄 바꿈 등)에 따라 텍스트 서식을 지정합니다. 이 함수는 DrawText에 대한 호출을 래핑합니다.

구문

int WINAPI DrawTextWrap(
  _In_    HDC              hdc,
  _Inout_ LPCTSTR          lpString,
  _In_    int              nCount,
  _Inout_ LPRECT           lpRect,
  _In_    UINT             uFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

매개 변수

hdc[in]

형식: HDC

디바이스 컨텍스트에 대한 핸들입니다.

lpString [in, out]

형식: LPCTSTR

그리려는 텍스트가 포함된 버퍼에 대한 포인터입니다. nCount 매개 변수가 -1이면 문자열은 null로 끝나야 합니다.

uFormat에 DT_MODIFYSTRING이 포함된 경우 함수는 이 문자열에 최대 4개의 추가 문자를 추가할 수 있습니다. 문자열을 포함하는 버퍼는 이러한 추가 문자를 수용할 수 있을 만큼 충분히 커야 합니다.

nCount [in]

형식: int

lpString이 가리키는 문자열의 길이입니다. nCount가 -1이면 lpString 매개 변수는 null로 끝나는 문자열에 대한 포인터로 간주되며 DrawText는 문자 수를 자동으로 계산합니다.

lpRect [in, out]

형식: LPRECT

텍스트 서식을 지정할 논리적 좌표의 사각형을 포함하는 RECT 구조체에 대한 포인터입니다.

uFormat [in]

형식: UINT

서식 지정 옵션입니다. 전체 옵션 목록은 DrawText 설명서를 참조하세요.

lpDTParams [in]

형식: LPDRAWTEXTPARAMS

추가 서식 지정 옵션을 지정하는 DRAWTEXTPARAMS 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: int

함수가 성공하면 반환 값은 논리적 단위의 텍스트 높이입니다. DT_VCENTER 또는 DT_BOTTOM이 지정된 경우 반환 값은 lprc의 top 멤버에서 그려진 텍스트의 하단까지의 오프셋입니다. 함수가 실패하면 반환 값은 0입니다.

함수가 실패하면 반환 값은 0입니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

DrawTextWrap은 이름으로 내보내거나 공용 헤더에서 선언되지 않습니다. 이를 사용하려면 GetProcAddress를 사용하고 ComCtl32.dll에서 서수 415를 요청하여 함수 포인터를 얻어야 합니다.

추가 설명은 DrawText를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
DLL	Comctl32.dll(버전 6.0 이상)