RenderWithVisualStyles Property

Application.RenderWithVisualStyles Property

 

Gets a value specifying whether the current application is drawing controls with visual styles.

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

public static bool RenderWithVisualStyles { get; }

Property Value

Type: System.Boolean

true if visual styles are enabled for controls in the client area of application windows; otherwise, false.

If you are drawing a custom control, use this property to decide whether to draw the control with or without visual styles, so that its appearance is consistent with other controls in the application.

The following table shows the four conditions that must exist for RenderWithVisualStyles to return true.

Condition

Description

The operating system supports visual styles

To verify this condition separately, use the IsSupportedByOS property of the VisualStyleInformation class.

The user has enabled visual styles in the operating system

To verify this condition separately, use the IsEnabledByUser property of the VisualStyleInformation class.

Visual styles are enabled in the application

Visual styles can be enabled in an application by calling the EnableVisualStyles() method or by using an application manifest that specifies that ComCtl32.dll version 6 or later will be used to draw controls.

Visual styles are being used to draw the client area of application windows

To verify this condition separately, use the VisualStyleState property of the Application class and verify that it has the value VisualStyleState.ClientAreaEnabled or VisualStyleState.ClientAndNonClientAreasEnabled.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft