VisualStyleState Enumeration

 

Specifies how visual styles are applied to the current application.

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

public enum class VisualStyleState

Member nameDescription
ClientAndNonClientAreasEnabled

Visual styles are applied to client and nonclient areas.

ClientAreaEnabled

Visual styles are applied only to the client area.

NonClientAreaEnabled

Visual styles are applied only to the nonclient area.

NoneEnabled

Visual 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.

#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
#using <System.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
using namespace System::Windows::Forms::VisualStyles;

namespace VisualStyleStateSample
{
    public ref class VisualStyleStateForm : public Form
    {
        Button^ updateButton;
        RadioButton^ applyToClient;
        RadioButton^ applyToNonClient;
        RadioButton^ applyToAll;
        RadioButton^ disableStyles;

    public:
        VisualStyleStateForm()
        {
            updateButton = gcnew Button();
            applyToClient = gcnew RadioButton();
            applyToNonClient = gcnew RadioButton();
            applyToAll = gcnew RadioButton();
            disableStyles = gcnew RadioButton();

            updateButton->AutoSize = true;
            updateButton->Location = Point(10, 10);
            updateButton->Text = "Update VisualStyleState";
            updateButton->Click += gcnew EventHandler(this, 
                &VisualStyleStateForm::UpdateButton_Click);

            applyToClient->Location = Point(10, 50);
            applyToClient->AutoSize = true;
            applyToClient->Text = "Apply styles to client area only";

            applyToNonClient->Location = Point(10, 70);
            applyToNonClient->AutoSize = true;
            applyToNonClient->Text = "Apply styles to nonclient area only";

            applyToAll->Location = Point(10, 90);
            applyToAll->AutoSize = true;
            applyToAll->Text = "Apply styles to client and nonclient areas";

            disableStyles->Location = Point(10, 110);
            disableStyles->AutoSize = true;
            disableStyles->Text = "Disable styles in all areas";

            this->Text = "VisualStyleState Test";
            this->Controls->AddRange(gcnew array<Control^>{updateButton,
                applyToClient, applyToNonClient, applyToAll, disableStyles});
        }

    private:
        void UpdateButton_Click(Object^ sender, EventArgs^ e)
        {
            if (applyToClient->Checked)
            {
                Application::VisualStyleState =
                    VisualStyleState::ClientAreaEnabled;
            }
            else if (applyToNonClient->Checked)
            {
                Application::VisualStyleState =
                    VisualStyleState::NonClientAreaEnabled;
            }
            else if (applyToAll->Checked)
            {
                Application::VisualStyleState =
                    VisualStyleState::ClientAndNonClientAreasEnabled;
            }
            else if (disableStyles->Checked)
            {
                Application::VisualStyleState =
                    VisualStyleState::NoneEnabled;
            }

            // Repaint the form and all child controls.
            this->Invalidate(true);
        }
    };
}

[STAThread]
int main()
{
    Application::EnableVisualStyles();
    Application::Run(gcnew VisualStyleStateSample::VisualStyleStateForm());
}

.NET Framework
Available since 2.0
Return to top
Show: