DrawThemeTextEx 함수(uxtheme.h)

시각적 스타일에서 정의한 색과 글꼴을 사용하여 텍스트를 그립니다. 추가 텍스트 형식 옵션을 허용하여 DrawThemeText를 확장합니다.

구문

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

매개 변수

[in] hTheme

형식: HTHEME

창의 지정된 테마 데이터에 대한 핸들입니다. OpenThemeData를 사용하여 HTHEME를 만듭니다.

[in] hdc

형식: HDC

그리기에 사용할 HDC입니다.

[in] iPartId

형식: int

원하는 텍스트 모양이 있는 컨트롤 파트입니다. 부품 및 상태를 참조하세요. 이 값이 0이면 텍스트가 기본 글꼴로 그려지거나 디바이스 컨텍스트로 선택된 글꼴로 그려집니다.

[in] iStateId

형식: int

원하는 텍스트 모양이 있는 컨트롤 상태입니다. 부품 및 상태를 참조하세요.

[in] pszText

형식: LPCWSTR

그릴 텍스트가 포함된 문자열에 대한 포인터입니다.

[in] cchText

형식: int

그릴 문자 수를 포함하는 int 형식의 값입니다. 매개 변수가 -1로 설정되면 문자열의 모든 문자가 그려집니다.

[in] dwTextFlags

형식: DWORD

문자열의 서식을 지정하는 하나 이상의 값이 포함된 DWORD입니다. 가능한 매개 변수 값은 값 서식 을 참조하세요.

[in, out] pRect

형식: LPRECT

텍스트를 그릴 논리 좌표의 사각형을 포함하는 RECT 구조체에 대한 포인터입니다.

[in] pOptions

형식: const DTTOPTS*

그리는 텍스트에 적용할 추가 서식 옵션을 정의하는 DTTOPTS 구조체입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

함수는 지정된 부분에 대해 테마 글꼴을 항상 사용하고, 정의된 경우 상태를 사용합니다. 그렇지 않으면 디바이스 컨텍스트에 현재 선택된 글꼴을 사용합니다. 테마 글꼴이 정의되어 있는지 확인하려면 속성 식별자로 TMT_FONT 사용하여 GetThemeFont 또는 GetThemePropertyOrigin 을 호출할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uxtheme.h
라이브러리	UxTheme.lib
DLL	UxTheme.dll