Compartilhar via


Função DrawThemeTextEx (uxtheme.h)

Desenha texto usando a cor e a fonte definidas pelo estilo visual. Estende DrawThemeText permitindo opções de formato de texto adicionais.

Sintaxe

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

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 a ser usado para desenho.

[in] iPartId

Tipo: int

A parte de controle que tem a aparência de texto desejada. Consulte Partes e Estados. Se esse valor for 0, o texto será desenhado na fonte padrão, ou uma fonte selecionada no contexto do dispositivo.

[in] iStateId

Tipo: int

O estado de controle que tem a aparência de texto desejada. Consulte Partes e Estados.

[in] pszText

Tipo: LPCWSTR

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

[in] cchText

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, out] pRect

Tipo: LPRECT

Ponteiro para uma estrutura RECT que contém o retângulo, em coordenadas lógicas, em que o texto deve ser desenhado.

[in] pOptions

Tipo: const DTTOPTS*

Uma estrutura DTTOPTS que define opções de formatação adicionais que serão aplicadas ao texto que está sendo desenhado.

Valor retornado

Tipo: HRESULT

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

Comentários

A função sempre usa a fonte com tema para a parte e o estado especificados se um for definido. Caso contrário, ele usará a fonte atualmente selecionada no contexto do dispositivo. Para descobrir se uma fonte temática está definida, você pode chamar GetThemeFont ou GetThemePropertyOrigin com TMT_FONT como o identificador de propriedade.

Requisitos

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