Property Identifiers

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