Share via


Função GetThemeTextExtent (uxtheme.h)

Calcula o tamanho e o local do texto especificado quando renderizado na fonte de estilo visual.

Sintaxe

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
);

Parâmetros

[in] hTheme

Tipo: HTHEME

Manipule para os dados de tema especificados de uma janela. Use OpenThemeData para criar um HTHEME.

[in] hdc

Tipo: HDC

HDC para selecionar a fonte.

[in] iPartId

Tipo: int

Valor do tipo int que especifica a parte na qual o texto será desenhado. Consulte Partes e Estados.

[in] iStateId

Tipo: int

Valor do tipo int que especifica o estado da parte. Consulte Partes e Estados.

[in] pszText

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres que contém o texto a ser desenhado.

[in] cchCharCount

Tipo: int

Valor do tipo int que contém o número de caracteres a serem desenhados. Se o parâmetro for definido como -1, todos os caracteres na cadeia de caracteres serão desenhados.

[in] dwTextFlags

Tipo: DWORD

DWORD que contém um ou mais valores que especificam a formatação da cadeia de caracteres. Consulte Formatar valores para obter valores de parâmetro possíveis.

[in] pBoundingRect

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém o retângulo usado para controlar o layout do texto. Esse parâmetro pode ser definido como NULL.

[out] pExtentRect

Tipo: LPRECT

Ponteiro para uma estrutura RECT que contém, em coordenadas lógicas, o retângulo necessário para se ajustar ao texto renderizado.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uxtheme.h
Biblioteca UxTheme.lib
DLL UxTheme.dll

Confira também

Identificadores de propriedade