VisualStyleState 列挙体

.NET Framework クラス ライブラリ リファレンス

VisualStyleState 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

現在のアプリケーションに visual スタイルをどのように適用するかを指定します。

名前空間: System.Windows.Forms.VisualStyles
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Enumeration VisualStyleState

Visual Basic (使用法)

Dim instance As VisualStyleState

C#

public enum VisualStyleState

C++

public enum class VisualStyleState

J#

public enum VisualStyleState

JScript

public enum VisualStyleState

メンバ

	メンバ名	説明
	ClientAndNonClientAreasEnabled	クライアント領域と非クライアント領域に visual スタイルが適用されます。
	ClientAreaEnabled	クライアント領域だけに visual スタイルが適用されます。
	NonClientAreaEnabled	非クライアント領域だけに visual スタイルが適用されます。
	NoneEnabled	アプリケーションに visual スタイルは適用されません。

解説

この列挙体を Application.VisualStyleState プロパティで使用して、visual スタイルをアプリケーション ウィンドウのクライアント領域や非クライアント領域に適用するかどうかを指定します。

使用例

VisualStyleState 値で指定された 4 つの領域それぞれに visual スタイルを適用する簡単なプログラムのコード例を次に示します。特定の領域で visual スタイルを有効にするには、有効にする領域を表すオプション ボタンをクリックし、[Update VisualStyleState] ボタンをクリックしてウィンドウ表示が変わるのを確認します。

Visual Basic

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

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using System.Windows.Forms.VisualStyles;

namespace VisualStyleStateSample
{
    class Form1 : Form
    {
        Button button1 = new Button();
        RadioButton radioButton1 = new RadioButton();
        RadioButton radioButton2 = new RadioButton();
        RadioButton radioButton3 = new RadioButton();
        RadioButton radioButton4 = new RadioButton();

        public Form1()
        {
            button1.AutoSize = true;
            button1.Location = new Point(10, 10);
            button1.Text = "Update VisualStyleState";
            button1.Click += new EventHandler(button1_Click);

            radioButton1.Location = new Point(10, 50);
            radioButton1.AutoSize = true;
            radioButton1.Text = "Apply styles to client area only";

            radioButton2.Location = new Point(10, 70);
            radioButton2.AutoSize = true;
            radioButton2.Text = "Apply styles to nonclient area only";

            radioButton3.Location = new Point(10, 90);
            radioButton3.AutoSize = true;
            radioButton3.Text = "Apply styles to client and nonclient areas";

            radioButton4.Location = new Point(10, 110);
            radioButton4.AutoSize = true;
            radioButton4.Text = "Disable styles in all areas";

            this.Text = "VisualStyleState Test";
            this.Controls.AddRange(new Control[]
 { button1,  
                radioButton1, radioButton2, radioButton3, radioButton4});
        }

        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        void button1_Click(object sender, EventArgs e)
        {
            if (radioButton1.Checked)
            {
                Application.VisualStyleState =
                    VisualStyleState.ClientAreaEnabled;
            }
            else if (radioButton2.Checked)
            {
                Application.VisualStyleState =
                    VisualStyleState.NonClientAreaEnabled;
            }
            else if (radioButton3.Checked)
            {
                Application.VisualStyleState =
                    VisualStyleState.ClientAndNonClientAreasEnabled;
            }
            else if (radioButton4.Checked)
            {
                Application.VisualStyleState =
                    VisualStyleState.NoneEnabled;
            }

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

C++

#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());
}

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Windows.Forms.VisualStyles 名前空間