GetThemeTextExtent 함수(uxtheme.h)

시각적 스타일 글꼴로 렌더링될 때 지정된 텍스트의 크기와 위치를 계산합니다.

구문

HRESULT GetThemeTextExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCWSTR pszText,
  [in]  int     cchCharCount,
  [in]  DWORD   dwTextFlags,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pExtentRect
);

매개 변수

[in] hTheme

형식: HTHEME

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

[in] hdc

형식: HDC

글꼴을 선택할 HDC입니다.

[in] iPartId

형식: int

텍스트를 그릴 부분을 지정하는 int 형식의 값입니다. 파트 및 상태를 참조하세요.

[in] iStateId

형식: int

파트의 상태를 지정하는 int 형식의 값입니다. 파트 및 상태를 참조하세요.

[in] pszText

형식: LPCWSTR

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

[in] cchCharCount

형식: int

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

[in] dwTextFlags

형식: DWORD

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

[in] pBoundingRect

형식: LPCRECT

텍스트 레이아웃을 제어하는 데 사용되는 사각형이 포함된 RECT 구조체에 대한 포인터입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[out] pExtentRect

형식: LPRECT

논리적 좌표에서 렌더링된 텍스트에 맞는 데 필요한 사각형을 포함하는 RECT 구조체에 대한 포인터입니다.

반환 값

형식: HRESULT

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

요구 사항

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

추가 정보

속성 식별자