Application.RenderWithVisualStyles Property

Note: This property is new in the .NET Framework version 2.0.

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

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

public static bool RenderWithVisualStyles { get; }
/** @property */
public static boolean get_RenderWithVisualStyles ()

public static function get RenderWithVisualStyles () : boolean

Property Value

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.



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.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

Community Additions