Функция 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
Header uxtheme.h
Библиотека UxTheme.lib
DLL UxTheme.dll

См. также раздел

Идентификаторы свойств