VisualStyleState Enumeration

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

Specifies how visual styles are applied to the current application.

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

'Declaration
Public Enumeration VisualStyleState
'Usage
Dim instance As VisualStyleState

public enum VisualStyleState
public enum VisualStyleState

 Member nameDescription
ClientAndNonClientAreasEnabledVisual styles are applied to client and nonclient areas. 
ClientAreaEnabledVisual styles are applied only to the client area. 
NonClientAreaEnabledVisual styles are applied only to the nonclient area. 
NoneEnabledVisual styles are not applied to the application. 

This enumeration is used by the Application.VisualStyleState property to specify whether visual styles are applied to client or nonclient areas of application windows.

The following code example is a simple program that applies visual styles in each of the four areas specified by the VisualStyleState values. To enable visual styles in a certain area, click the option button (also known as a radio button) that represents the area you want to enable, and click the Update VisualStyleState button to observe the changes in the window.

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports System.Windows.Forms.VisualStyles

Namespace VisualStyleStateSample

    Class Form1
        Inherits Form
        Private WithEvents button1 As New Button()
        Private radioButton1 As New RadioButton()
        Private radioButton2 As New RadioButton()
        Private radioButton3 As New RadioButton()
        Private radioButton4 As New RadioButton()

        Public Sub New()
            With button1
                .AutoSize = True
                .Location = New Point(10, 10)
                .Text = "Update VisualStyleState"
            End With

            With radioButton1
                .Location = New Point(10, 50)
                .AutoSize = True
                .Text = "Apply styles to client area only"
            End With

            With radioButton2
                .Location = New Point(10, 70)
                .AutoSize = True
                .Text = "Apply styles to nonclient area only"
            End With

            With radioButton3
                .Location = New Point(10, 90)
                .AutoSize = True
                .Text = "Apply styles to client and nonclient areas"
            End With

            With radioButton4
                .Location = New Point(10, 110)
                .AutoSize = True
                .Text = "Disable styles in all areas"
            End With

            Me.Text = "VisualStyleState Test"
            Me.Controls.AddRange(New Control() {button1, radioButton1, _
                radioButton2, radioButton3, radioButton4})
        End Sub

        <STAThread()> _
        Shared Sub Main()
            Application.EnableVisualStyles()
            Application.Run(New Form1())
        End Sub

        Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
            Handles button1.Click

            If radioButton1.Checked Then
                Application.VisualStyleState = _
                    VisualStyleState.ClientAreaEnabled
            ElseIf radioButton2.Checked Then
                Application.VisualStyleState = _
                    VisualStyleState.NonClientAreaEnabled
            ElseIf radioButton3.Checked Then
                Application.VisualStyleState = _
                    VisualStyleState.ClientAndNonClientAreasEnabled
            ElseIf radioButton4.Checked Then
                Application.VisualStyleState = _
                    VisualStyleState.NoneEnabled
            End If

            ' Repaint the form and all child controls.
            Me.Invalidate(True)
        End Sub

    End Class
End Namespace

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

ADD
Show: