Export (0) Print
Expand All

VisualStyleRenderer Class

Provides methods for drawing and getting information about a VisualStyleElement. This class cannot be inherited.

System.Object
  System.Windows.Forms.VisualStyles.VisualStyleRenderer

Namespace:  System.Windows.Forms.VisualStyles
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[<Sealed>]
type VisualStyleRenderer =  class end

The VisualStyleRenderer type exposes the following members.

  NameDescription
Public methodVisualStyleRenderer(VisualStyleElement)Initializes a new instance of the VisualStyleRenderer class using the given VisualStyleElement.
Public methodVisualStyleRenderer(String, Int32, Int32)Initializes a new instance of the VisualStyleRenderer class using the given class, part, and state values.
Top

  NameDescription
Public propertyClassGets the class name of the current visual style element.
Public propertyHandleGets a unique identifier for the current class of visual style elements.
Public propertyStatic memberIsSupportedGets a value specifying whether the operating system is using visual styles to draw controls.
Public propertyLastHResultGets the last error code returned by the native visual styles (UxTheme) API methods encapsulated by the VisualStyleRenderer class.
Public propertyPartGets the part of the current visual style element.
Public propertyStateGets the state of the current visual style element.
Top

  NameDescription
Public methodDrawBackground(IDeviceContext, Rectangle)Draws the background image of the current visual style element within the specified bounding rectangle.
Public methodDrawBackground(IDeviceContext, Rectangle, Rectangle)Draws the background image of the current visual style element within the specified bounding rectangle and clipped to the specified clipping rectangle.
Public methodDrawEdgeDraws one or more edges of the specified bounding rectangle.
Public methodDrawImage(Graphics, Rectangle, Image)Draws the specified image within the specified bounds.
Public methodDrawImage(Graphics, Rectangle, ImageList, Int32)Draws the image from the specified ImageList within the specified bounds.
Public methodDrawParentBackgroundDraws the background of a control's parent in the specified area.
Public methodDrawText(IDeviceContext, Rectangle, String)Draws text in the specified bounds using default formatting.
Public methodDrawText(IDeviceContext, Rectangle, String, Boolean)Draws text in the specified bounds with the option of displaying disabled text.
Public methodDrawText(IDeviceContext, Rectangle, String, Boolean, TextFormatFlags)Draws text in the specified bounding rectangle with the option of displaying disabled text and applying other text formatting.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodGetBackgroundContentRectangleReturns the content area for the background of the current visual style element.
Public methodGetBackgroundExtentReturns the entire background area for the current visual style element.
Public methodGetBackgroundRegionReturns the region for the background of the current visual style element.
Public methodGetBooleanReturns the value of the specified Boolean property for the current visual style element.
Public methodGetColorReturns the value of the specified color property for the current visual style element.
Public methodGetEnumValueReturns the value of the specified enumerated type property for the current visual style element.
Public methodGetFilenameReturns the value of the specified file name property for the current visual style element.
Public methodGetFontReturns the value of the specified font property for the current visual style element.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetIntegerReturns the value of the specified integer property for the current visual style element.
Public methodGetMarginsReturns the value of the specified margins property for the current visual style element.
Public methodGetPartSize(IDeviceContext, ThemeSizeType)Returns the value of the specified size property of the current visual style part.
Public methodGetPartSize(IDeviceContext, Rectangle, ThemeSizeType)Returns the value of the specified size property of the current visual style part using the specified drawing bounds.
Public methodGetPointReturns the value of the specified point property for the current visual style element.
Public methodGetStringReturns the value of the specified string property for the current visual style element.
Public methodGetTextExtent(IDeviceContext, String, TextFormatFlags)Returns the size and location of the specified string when drawn with the font of the current visual style element.
Public methodGetTextExtent(IDeviceContext, Rectangle, String, TextFormatFlags)Returns the size and location of the specified string when drawn with the font of the current visual style element within the specified initial bounding rectangle.
Public methodGetTextMetricsRetrieves information about the font specified by the current visual style element.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodHitTestBackground(IDeviceContext, Rectangle, Point, HitTestOptions)Returns a hit test code indicating whether a point is contained in the background of the current visual style element.
Public methodHitTestBackground(Graphics, Rectangle, Region, Point, HitTestOptions)Returns a hit test code indicating whether the point is contained in the background of the current visual style element and within the specified bounds.
Public methodHitTestBackground(IDeviceContext, Rectangle, IntPtr, Point, HitTestOptions)Returns a hit test code indicating whether the point is contained in the background of the current visual style element and within the specified region.
Public methodIsBackgroundPartiallyTransparentIndicates whether the background of the current visual style element has any semitransparent or alpha-blended pieces.
Public methodStatic memberIsElementDefinedDetermines whether the specified visual style element is defined by the current visual style.
Public methodSetParameters(VisualStyleElement)Sets this VisualStyleRenderer to the visual style element represented by the specified VisualStyleElement.
Public methodSetParameters(String, Int32, Int32)Sets this VisualStyleRenderer to the visual style element represented by the specified class, part, and state values.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

The System.Windows.Forms.VisualStyles namespace exposes VisualStyleElement objects that represent all of the controls and user interface (UI) elements that are supported by visual styles. To draw or get information about a particular element, you must set a VisualStyleRenderer to the element you are interested in. A VisualStyleRenderer is automatically set to a specified VisualStyleElement in the VisualStyleRenderer constructor, but you can also set an existing VisualStyleRenderer to a different element by calling the SetParameters method.

To draw an element, use the DrawBackground method. The VisualStyleRenderer class also includes methods, such as GetColor and GetEnumValue, that provide information about how an element is defined by the current visual style.

The VisualStyleRenderer constructor and many of the VisualStyleRenderer methods throw exceptions unless visual styles are enabled in the operating system and visual styles are applied to the client area of application windows. To check for these conditions, use the static IsSupported property.

The VisualStyleRenderer class wraps the functionality of the visual styles (UxTheme) API from the Windows Shell portion of the Windows Platform SDK. For more information about visual styles, see "Using Windows XP Visual Styles" in the Platform SDK portion of the MSDN Library at http://msdn.microsoft.com/library.

Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003 Platform Note: Visual styles are supported only on these platforms.

The following code example uses the VisualStyleRenderer class to implement a custom control that simulates some of the basic UI of a window, including dragging with the title bar, resizing with the sizing handle, and closing. This example uses several VisualStyleElement objects that represent standard parts of a window, including the elements exposed by the VisualStyleElement.Window.Caption, VisualStyleElement.Window.CloseButton, and VisualStyleElement.Status.Gripper classes.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft