Application.RenderWithVisualStyles Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a value specifying whether the current application is drawing controls with visual styles.
public:
static property bool RenderWithVisualStyles { bool get(); };
public static bool RenderWithVisualStyles { get; }
static member RenderWithVisualStyles : bool
Public Shared ReadOnly Property RenderWithVisualStyles As Boolean
Property Value
true
if visual styles are enabled for controls in the client area of application windows; otherwise, false
.
Remarks
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. |