Compartir a través de

Función DrawThemeTextEx (uxtheme.h)

  • Artículo

Dibuja texto con el color y la fuente definidos por el estilo visual. Extiende DrawThemeText al permitir opciones de formato de texto adicionales.

Sintaxis

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

Controle los datos de tema especificados de una ventana. Use OpenThemeData para crear un HTHEME.

[in] hdc

Tipo: HDC

HDC que se va a usar para dibujar.

[in] iPartId

Tipo: int

Elemento del control que tiene la apariencia del texto deseado. Vea Partes y estados. Si este valor es 0, el texto se dibuja en la fuente predeterminada o en una fuente seleccionada en el contexto del dispositivo.

[in] iStateId

Tipo: int

Estado del control que tiene la apariencia del texto deseado. Vea Partes y estados.

[in] pszText

Tipo: LPCWSTR

Puntero a una cadena que contiene el texto que se va a dibujar.

[in] cchText

Tipo: int

Valor de tipo int que contiene el número de caracteres que se van a dibujar. Si el parámetro se establece en -1, se dibujan todos los caracteres de la cadena.

[in] dwTextFlags

Tipo: DWORD

DWORD que contiene uno o más valores que especifican el formato de la cadena. Consulte Valores de formato para conocer los valores de parámetro posibles.

[in, out] pRect

Tipo: LPRECT

Puntero a una estructura RECT que contiene el rectángulo, en coordenadas lógicas, en la que se va a dibujar el texto.

[in] pOptions

Tipo: const DTTOPTS*

Estructura DTTOPTS que define opciones de formato adicionales que se aplicarán al texto que se va a dibujar.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La función siempre usa la fuente temática para la parte y el estado especificados si se define una. De lo contrario, usa la fuente seleccionada actualmente en el contexto del dispositivo. Para averiguar si se define una fuente temática, puede llamar a GetThemeFont o GetThemePropertyOrigin con TMT_FONT como identificador de propiedad.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uxtheme.h
Library UxTheme.lib
Archivo DLL UxTheme.dll