Skip to content

Latest commit

 

History

History
121 lines (84 loc) · 4.27 KB

nf-uxtheme-drawthemetextex.md

File metadata and controls

121 lines (84 loc) · 4.27 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:uxtheme.DrawThemeTextEx
DrawThemeTextEx function (uxtheme.h)
Draws text using the color and font defined by the visual style. Extends DrawThemeText by allowing additional text format options.
DrawThemeTextEx
DrawThemeTextEx function [Windows Controls]
controls.DrawThemeTextEx
controls.inet_DrawThemeTextEx
inet_DrawThemeTextEx
inet_DrawThemeTextEx_cpp
uxtheme/DrawThemeTextEx
controls\DrawThemeTextEx.htm
Controls
VS|Controls|~\controls\userex\functions\drawthemetextex.htm
12/05/2018
DrawThemeTextEx, DrawThemeTextEx function [Windows Controls], controls.DrawThemeTextEx, controls.inet_DrawThemeTextEx, inet_DrawThemeTextEx, inet_DrawThemeTextEx_cpp, uxtheme/DrawThemeTextEx
uxtheme.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
UxTheme.lib
UxTheme.dll
Windows
19H1
DrawThemeTextEx
uxtheme/DrawThemeTextEx
c++
APIRef
kbSyntax
DllExport
UxTheme.dll
ext-ms-win-uxtheme-themes-l1-1-1.dll
xamlpalwp.dll
DrawThemeTextEx

DrawThemeTextEx function

-description

Draws text using the color and font defined by the visual style. Extends DrawThemeText by allowing additional text format options.

-parameters

-param hTheme [in]

Type: HTHEME

Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.

-param hdc [in]

Type: HDC

HDC to use for drawing.

-param iPartId [in]

Type: int

The control part that has the desired text appearance. See Parts and States. If this value is 0, the text is drawn in the default font, or a font selected into the device context.

-param iStateId [in]

Type: int

The control state that has the desired text appearance. See Parts and States.

-param pszText [in]

Type: LPCWSTR

Pointer to a string that contains the text to draw.

-param cchText [in]

Type: int

Value of type int that contains the number of characters to draw. If the parameter is set to -1, all the characters in the string are drawn.

-param dwTextFlags [in]

Type: DWORD

DWORD that contains one or more values that specify the string's formatting. See Format Values for possible parameter values.

-param pRect [in, out]

Type: LPRECT

Pointer to a RECT structure that contains the rectangle, in logical coordinates, in which the text is to be drawn.

-param pOptions [in]

Type: const DTTOPTS*

A DTTOPTS structure that defines additional formatting options that will be applied to the text being drawn.

-returns

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

The function always uses the themed font for the specified part and state if one is defined. Otherwise it uses the font currently selected into the device context. To find out if a themed font is defined, you can call GetThemeFont or GetThemePropertyOrigin with TMT_FONT as the property identifier.