Property Identifiers (Windows Controls)
This topic contains information about defined values that are used to retrieve properties of visual styles. The definitions are found in Vssym32.h.
Property Types
The following table lists the primitive property types. The values in the first column are not normally used by applications but provide a means of classifying property identifiers.
| Data Type | Description | Returned Type | Retrieval Function |
|---|---|---|---|
| TMT_BOOL | TRUE or FALSE | Boolean | GetThemeBool, GetThemeSysBool |
| TMT_COLOR | RGB color value | COLORREF structure | GetThemeColor, GetThemeSysColor |
| TMT_DISKSTREAM | Disk stream | HINSTANCE | GetThemeStream |
| TMT_ENUM | Enumerated value | Enumeration | GetThemeEnumValue. |
| TMT_FILENAME | Filename relative to the theme directory | WCHAR array | GetThemeFilename |
| TMT_FONT | Font description | LOGFONT structure | GetThemeFont, GetThemeSysFont |
| TMT_HBITMAP | Bitmap | HBITMAP handle | GetThemeBitmap |
| TMT_INT | Signed number | Integer | GetThemeInt, GetThemeSysInt, GetThemeMetric |
| TMT_INTLIST | List of integers | INTLIST structure | GetThemeIntList |
| TMT_MARGINS | Margins: left, top, right, and bottom | MARGINS structure | GetThemeMargins |
| TMT_POSITION | Location of an item | POINT structure | GetThemePosition |
| TMT_RECT | Size and location of a rectangle | RECT structure | GetThemeRect |
| TMT_SIZE | Size of an item | SIZE structure | GetThemePartSize |
| TMT_STRING | Unicode string | WCHAR array | GetThemeString, GetThemeSysString |
Property IDs
The following are the defined values for theme properties, grouped by data type.
TMT_BOOL
| ID | Notes |
|---|---|
| TMT_ALWAYSSHOWSIZINGBAR | TRUE if the sizing bar associated with the part and state should always be shown. |
| TMT_AUTOSIZE | TRUE if the nonclient caption area associated with the part and state vary with text width. |
| TMT_BGFILL | TRUE if true-sized images associated with the part and state are to be drawn on the background fill. |
| TMT_BORDERONLY | TRUE if the image associated with the part and state should only have its border drawn. |
| TMT_COMPOSITED | TRUE if the control associated with the part and state will handle its own compositing of images. |
| TMT_COMPOSITEDOPAQUE | |
| TMT_DRAWBORDERS | |
| TMT_FLATMENUS | See GetThemeSysBool. |
| TMT_GLYPHONLY | TRUE if the glyph associated with the part and state should be drawn without a background. |
| TMT_GLYPHTRANSPARENT | TRUE if the glyph associated with the part and state have transparent areas. See GetThemeColor for the definition of the TMT_GLYPHCOLOR value that defines the transparent color. |
| TMT_INTEGRALSIZING | TRUE if the truesize image or border associated with the part and state must be sized to a factor of 2. |
| TMT_LOCALIZEDMIRRORIMAGE | |
| TMT_MIRRORIMAGE | TRUE if the image associated with the part and state should be flipped if the window is being viewed in right-to-left reading mode. |
| TMT_NOETCHEDEFFECT | |
| TMT_SCALEDBACKGROUND | |
| TMT_SOURCEGROW | TRUE if the image associated with the part and state will scale larger in size if necessary. |
| TMT_SOURCESHRINK | TRUE if the image associated with the part and state will scale smaller in size if necessary. |
| TMT_TEXTAPPLYOVERLAY | |
| TMT_TEXTGLOW | |
| TMT_TEXTITALIC | |
| TMT_TRANSPARENT | |
| TMT_UNIFORMSIZING | TRUE if the image associated with the part and state must have equal height and width. |
| TMT_USERPICTURE | TRUE if the image associated with the part and state is based on the current user. |
TMT_COLOR
| ID | Notes |
|---|---|
| TMT_ACCENTCOLORHINT | The color used as an accent color hint for custom controls. |
| TMT_ACTIVEBORDER | |
| TMT_ACTIVECAPTION | |
| TMT_APPWORKSPACE | |
| TMT_BACKGROUND | |
| TMT_BLENDCOLOR | The color used as a blend color. |
| TMT_BODYTEXTCOLOR | |
| TMT_BORDERCOLOR | The color of the border associated with the part and state. |
| TMT_BORDERCOLORHINT | The color used as a border color hint for custom controls. |
| TMT_BTNFACE | |
| TMT_BTNHIGHLIGHT | |
| TMT_BTNSHADOW | |
| TMT_BTNTEXT | |
| TMT_BUTTONALTERNATEFACE | |
| TMT_CAPTIONTEXT | |
| TMT_DKSHADOW3D | |
| TMT_EDGEDKSHADOWCOLOR | The dark shadow color of the edge associated with this part and state. |
| TMT_EDGEFILLCOLOR | The fill color of the edge associated with this part and state. |
| TMT_EDGEHIGHLIGHTCOLOR | The highlight color of the edge associated with this part and state. |
| TMT_EDGELIGHTCOLOR | The light color of the edge associated with this part and state. |
| TMT_EDGESHADOWCOLOR | The shadow color of the edge associated with this part and state. |
| TMT_FILLCOLOR | The color of the background fill associated with the part and state. |
| TMT_FILLCOLORHINT | The color used as a fill color hint for custom controls. |
| TMT_FROMCOLOR1 | |
| TMT_FROMCOLOR2 | |
| TMT_FROMCOLOR3 | |
| TMT_FROMCOLOR4 | |
| TMT_FROMCOLOR5 | |
| TMT_GLOWCOLOR | The color of the glow produced by calling DrawThemeIcon using this part and state. |
| TMT_GLYPHTEXTCOLOR | The color that the font-based glyph associated with this part and state will use. |
| TMT_GLYPHTRANSPARENTCOLOR | The transparent glyph color associated with this part and state. If the TMT_GLYPHTRANSPARENT value for this part and state is TRUE, parts of the glyph that use this color are not drawn. |
| TMT_GRADIENTACTIVECAPTION | |
| TMT_GRADIENTCOLOR1 | The first color of the gradient associated with this part and state. |
| TMT_GRADIENTCOLOR2 | The second color of the gradient. |
| TMT_GRADIENTCOLOR3 | The third color of the gradient. |
| TMT_GRADIENTCOLOR4 | The fourth color of the gradient. |
| TMT_GRADIENTCOLOR5 | The fifth color of the gradient. |
| TMT_GRADIENTINACTIVECAPTION | |
| TMT_GRAYTEXT | |
| TMT_HEADING1TEXTCOLOR | |
| TMT_HEADING2TEXTCOLOR | |
| TMT_HIGHLIGHT | |
| TMT_HIGHLIGHTTEXT | |
| TMT_HOTTRACKING | |
| TMT_INACTIVEBORDER | |
| TMT_INACTIVECAPTION | |
| TMT_INACTIVECAPTIONTEXT | |
| TMT_INFOBK | |
| TMT_INFOTEXT | |
| TMT_LIGHT3D | |
| TMT_MENU | |
| TMT_MENUBAR | |
| TMT_MENUHILIGHT | |
| TMT_MENUTEXT | |
| TMT_SCROLLBAR | |
| TMT_SHADOWCOLOR | The color of the shadow drawn underneath text associated with this part and state. |
| TMT_TEXTBORDERCOLOR | The color of the text border associated with this part and state. |
| TMT_TEXTCOLOR | The color of the text associated with this part and state. |
| TMT_TEXTCOLORHINT | |
| TMT_TEXTSHADOWCOLOR | The color of the text shadow associated with this part and state. |
| TMT_TRANSPARENTCOLOR | The transparent color associated with this part and state. If the TMT_TRANSPARENT value for this part and state is TRUE, parts of the graphic that use this color are not drawn. |
| TMT_WINDOW | |
| TMT_WINDOWFRAME | |
| TMT_WINDOWTEXT |
TMT_DISKSTREAM
| ID | Notes |
|---|---|
| TMT_ATLASIMAGE |
TMT_ENUM
| Enumeration | Property Values | Notes |
|---|---|---|
| BGTYPE | BT_IMAGEFILE, BT_BORDERFILL | The basic drawing type for this part. |
| BORDERTYPE | BT_RECT, BT_ROUNDRECT, BT_ELLIPSE | The type of border drawn if this part is a border fill. |
| CONTENTALIGNMENT | CA_LEFT, CA_CENTER, CA_RIGHT | The alignment of text in the caption associated with this part. |
| FILLTYPE | FT_SOLID, FT_VERTGRADIENT, FT_HORZGRADIENT, FT_RADIALGRADIENT, FT_TILEIMAGE | The type of fill shape drawn if this part is a border fill. |
| GLYPHTYPE | GT_NONE, GT_IMAGEGLYPH, GT_FONTGLYPH | The type of glyph drawn on this part. |
| GLYPHFONTSIZINGTYPE | GFST_NONE, GFST_SIZE, GFST_DPI | The type of method used to select between different-sized glyphs. |
| HALIGN | HA_LEFT, HA_CENTER, HA_RIGHT | The horizontal alignment if this part uses a true-size image. |
| ICONEFFECT | ICE_NONE, ICE_GLOW, ICE_SHADOW, ICE_PULSE, ICE_ALPHA | The type of effect to be displayed when this part is drawn using DrawThemeIcon. |
| IMAGELAYOUT | IL_VERTICAL, IL_HORIZONTAL | The type of alignment used when multiple images are drawn. |
| IMAGESELECTTYPE | IST_NONE, IST_SIZE, IST_DPI | The type of method used to select between sized images for this part. See the TMT_IMAGEFILE1 value of GetThemeFilename. |
| OFFSETTYPE | OT_TOPLEFT, OT_TOPRIGHT, OT_TOPMIDDLE, OT_BOTTOMLEFT, OT_BOTTOMRIGHT, OT_BOTTOMMIDDLE, OT_MIDDLELEFT, OT_MIDDLERIGHT, OT_LEFTOFCAPTION, OT_RIGHTOFCAPTION, OT_LEFTOFLASTBUTTON, OT_RIGHTOFLASTBUTTON, OT_ABOVELASTBUTTON, OT_BELOWLASTBUTTON | The alignment of this part on the window. |
| SIZINGTYPE | ST_TRUESIZE, ST_STRETCH, ST_TILE, ST_TILEHORZ, ST_TILEVERT, ST_TILECENTER | The method used to size an image if this part uses an image file. |
| TEXTSHADOWTYPE | TST_NONE, TST_SINGLE, TST_CONTINUOUS | The type of shadow effect to draw behind text associated with this part. |
| TRUESIZESCALINGTYPE | TSST_NONE, TSST_SIZE, TSST_DPI | The type of scaling used if this part uses a true-sized image. |
| VALIGN | VA_TOP, VA_CENTER, VA_BOTTOM | The vertical alignment if this part uses a true-size image. |
TMT_FILENAME
| ID | Notes |
|---|---|
| TMT_GLYPHIMAGEFILE | The filename for the glyph image associated with this part and state. |
| TMT_IMAGEFILE | The filename of the image associated with this part and state, or the base filename for multiple images associated with this part and state. |
| TMT_IMAGEFILE1 | The filename of the first scaled image associated with this part and state, for support of different resolutions. |
| TMT_IMAGEFILE2 | The filename of the second scaled image. |
| TMT_IMAGEFILE3 | The filename of the third scaled image. |
| TMT_IMAGEFILE4 | The filename of the fourth scaled image. |
| TMT_IMAGEFILE5 | The filename of the fifth scaled image. |
TMT_FONT
| ID | Notes |
|---|---|
| TMT_BODYFONT | |
| TMT_CAPTIONFONT | |
| TMT_GLYPHFONT | The font that the glyph associated with this part will be drawn with, if font-based glyphs are used. |
| TMT_HEADING1FONT | |
| TMT_HEADING2FONT | |
| TMT_ICONTITLEFONT | |
| TMT_MENUFONT | |
| TMT_MSGBOXFONT | |
| TMT_SMALLCAPTIONFONT | |
| TMT_STATUSFONT |
TMT_INT
| ID | Notes |
|---|---|
| TMT_ALPHALEVEL | The alpha value (0-255) used for DrawThemeIcon. |
| TMT_ALPHATHRESHOLD | The minimum alpha value (0-255) that a pixel must have to be considered opaque. |
| TMT_ANIMATIONDELAY | |
| TMT_ANIMATIONDURATION | |
| TMT_BORDERSIZE | The thickness of the border drawn if this part uses a border fill. |
| TMT_CHARSET | |
| TMT_COLORIZATIONCOLOR | |
| TMT_COLORIZATIONOPACITY | |
| TMT_FRAMESPERSECOND | |
| TMT_FROMHUE1 | |
| TMT_FROMHUE2 | |
| TMT_FROMHUE3 | |
| TMT_FROMHUE4 | |
| TMT_FROMHUE5 | |
| TMT_GLOWINTENSITY | |
| TMT_GLYPHINDEX | The character index into the selected font that will be used for the glyph, if the part uses a font-based glyph. |
| TMT_GRADIENTRATIO1 | The amount of the first gradient color (TMT_GRADIENTCOLOR1) to use in drawing the part. This value can be from 0 to 255, but this value plus the values of each of the GRADIENTRATIO values must add up to 255. |
| TMT_GRADIENTRATIO2 | The amount of the second gradient color (TMT_GRADIENTCOLOR2) to use in drawing the part. |
| TMT_GRADIENTRATIO3 | The amount of the third gradient color (TMT_GRADIENTCOLOR3) to use in drawing the part. |
| TMT_GRADIENTRATIO4 | The amount of the fourth gradient color (TMT_GRADIENTCOLOR4) to use in drawing the part. |
| TMT_GRADIENTRATIO5 | The amount of the fifth gradient color (TMT_GRADIENTCOLOR5) to use in drawing the part. |
| TMT_HEIGHT | The height of the part. |
| TMT_IMAGECOUNT | The number of state images present in an image file. |
| TMT_MINCOLORDEPTH | |
| TMT_MINDPI1 | The minimum dots per inch (dpi) that the first image file was designed for. |
| TMT_MINDPI2 | The minimum dpi that the second image file was designed for. |
| TMT_MINDPI3 | The minimum dpi that the third image file was designed for. |
| TMT_MINDPI4 | The minimum dpi that the fourth image file was designed for. |
| TMT_MINDPI5 | The minimum dpi that the fifth image file was designed for. |
| TMT_OPACITY | |
| TMT_PIXELSPERFRAME | |
| TMT_PROGRESSCHUNKSIZE | The size of the progress control "chunk" shapes that define how far an operation has progressed. |
| TMT_PROGRESSSPACESIZE | The total size of all of the progress control "chunks". |
| TMT_ROUNDCORNERHEIGHT | The roundness (0 to 100 percent) of the part's corners. |
| TMT_ROUNDCORNERWIDTH | The roundness (0 to 100 percent) of the part's corners. |
| TMT_SATURATION | The amount of saturation (0-255) to apply to an icon drawn using DrawThemeIcon. |
| TMT_TEXTBORDERSIZE | The thickness of the border drawn around text characters. |
| TMT_TEXTGLOWSIZE | |
| TMT_TOCOLOR1 | |
| TMT_TOCOLOR2 | |
| TMT_TOCOLOR3 | |
| TMT_TOCOLOR4 | |
| TMT_TOCOLOR5 | |
| TMT_TOHUE1 | |
| TMT_TOHUE2 | |
| TMT_TOHUE3 | |
| TMT_TOHUE4 | |
| TMT_TOHUE5 | |
| TMT_TRUESIZESTRETCHMARK | The percentage of a true-size image's original size at which the image will be stretched. |
| TMT_WIDTH | The width of the part. |
TMT_INTLIST
| ID | Notes |
|---|---|
| TMT_TRANSITIONDURATIONS |
TMT_MARGINS
| ID | Notes |
|---|---|
| TMT_CAPTIONMARGINS | The margins that define where caption text may be placed within a part. |
| TMT_CONTENTMARGINS | The margins that define where content may be placed within a part. |
| TMT_SIZINGMARGINS | The margins used for sizing a non-true-size image. |
TMT_POSITION
| ID | Notes |
|---|---|
| TMT_MINSIZE | The minimum size that the normal image file can be used for before moving to the next smallest image file. |
| TMT_MINSIZE1 | The minimum size that the first small image file can be used for. |
| TMT_MINSIZE2 | The minimum size that the second small image file can be used for. |
| TMT_MINSIZE3 | The minimum size that the third small image file can be used for. |
| TMT_MINSIZE4 | The minimum size that the fourth small image file can be used for. |
| TMT_MINSIZE5 | The minimum size that the fifth small image file can be used for. |
| TMT_NORMALSIZE | The size of the normal image associated with this part. |
| TMT_OFFSET | The position offset from the alignment for this part. The alignment is defined by the TMT_OFFSETTYPE value. |
| TMT_TEXTSHADOWOFFSET | The offset from the text at which text shadows are drawn. |
TMT_RECT
| ID | Notes |
|---|---|
| TMT_ANIMATIONBUTTONRECT | |
| TMT_ATLASRECT | |
| TMT_CUSTOMSPLITRECT | |
| TMT_DEFAULTPANESIZE | The default size of the part. |
TMT_SIZE
| ID | Notes |
|---|---|
| TMT_CAPTIONBARHEIGHT | Caption bar height. |
| TMT_CAPTIONBARWIDTH | Caption bar width. |
| TMT_MENUBARHEIGHT | Menu bar height. |
| TMT_MENUBARWIDTH | Menu bar width. |
| TMT_PADDEDBORDERWIDTH | Padded border width. |
| TMT_SCROLLBARHEIGHT | Scroll bar height. |
| TMT_SCROLLBARWIDTH | Scroll bar width. |
| TMT_SIZINGBORDERWIDTH | Width of a sizing border. |
| TMT_SMCAPTIONBARHEIGHT | Caption bar height. |
| TMT_SMCAPTIONBARWIDTH | Caption bar width. |
TMT_STRING
| ID | Notes |
|---|---|
| TMT_ALIAS | |
| TMT_ATLASINPUTIMAGE | |
| TMT_AUTHOR | |
| TMT_CLASSICVALUE | |
| TMT_COLORSCHEMES | |
| TMT_COMPANY | |
| TMT_COPYRIGHT | |
| TMT_CSSNAME | See GetThemeSysString. |
| TMT_DESCRIPTION | |
| TMT_DISPLAYNAME | |
| TMT_LASTUPDATED | |
| TMT_SIZES | |
| TMT_TEXT | The text displayed by the part. |
| TMT_TOOLTIP | |
| TMT_URL | |
| TMT_VERSION | |
| TMT_XMLNAME | See GetThemeSysString. |
| TMT_NAME |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for