Funzione DrawThemeTextEx (uxtheme.h)

Disegna il testo utilizzando il colore e il tipo di carattere definiti dallo stile di visualizzazione. Estende DrawThemeText consentendo opzioni di formato di testo aggiuntive.

Sintassi

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

Parametri

[in] hTheme

Tipo: HTHEME

Handle per i dati del tema specificati di una finestra. Usare OpenThemeData per creare un HTHEME.

[in] hdc

Tipo: HDC

HDC da usare per il disegno.

[in] iPartId

Tipo: int

La parte del controllo che presenta l'aspetto desiderato per il testo. Vedere Parti e stati. Se questo valore è 0, il testo viene disegnato nel tipo di carattere predefinito o in un tipo di carattere selezionato nel contesto di dispositivo.

[in] iStateId

Tipo: int

Lo stato del controllo che presenta l'aspetto desiderato per il testo. Vedere Parti e stati.

[in] pszText

Tipo: LPCWSTR

Puntatore a una stringa contenente il testo da disegnare.

[in] cchText

Tipo: int

Valore di tipo int che contiene il numero di caratteri da disegnare. Se il parametro è impostato su -1, vengono disegnati tutti i caratteri nella stringa.

[in] dwTextFlags

Tipo: DWORD

DWORD contenente uno o più valori che specificano la formattazione della stringa. Vedere Format Values (Valori di formato ) per i possibili valori dei parametri.

[in, out] pRect

Tipo: LPRECT

Puntatore a una struttura RECT che contiene il rettangolo, in coordinate logiche, in cui deve essere disegnato il testo.

[in] pOptions

Tipo: const DTTOPTS*

Struttura DTTOPTS che definisce opzioni di formattazione aggiuntive che verranno applicate al testo da disegnare.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La funzione usa sempre il tipo di carattere a tema per la parte e lo stato specificati, se definito. In caso contrario, usa il tipo di carattere attualmente selezionato nel contesto del dispositivo. Per scoprire se è definito un tipo di carattere a tema, è possibile chiamare GetThemeFont o GetThemePropertyOrigin con TMT_FONT come identificatore di proprietà.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
Libreria	UxTheme.lib
DLL	UxTheme.dll