Control.Enabled プロパティ

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

Control.Enabled プロパティ

コントロールがユーザーとの対話に応答できるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property Enabled As
 Boolean

Visual Basic (使用法)

Dim instance As Control
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

C#

[LocalizableAttribute(true)] 
public bool Enabled { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_Enabled ()

/** @property */
public void set_Enabled (boolean value)

JScript

public function get Enabled
 () : boolean

public function set Enabled
 (value : boolean)

プロパティ値
コントロールがユーザーとの対話に応答できる場合は true。それ以外の場合は false。既定値は true です。

解説

Enabled プロパティを使用すると、実行時にコントロールを有効または無効にできます。たとえば、アプリケーションの現在の状態に適用されないコントロールは無効にすることができます。また、使用を制限するために、コントロールを無効にすることもできます。たとえば、ボタンを無効にして、ユーザーがクリックできないようにすることができます。コントロールが無効にされている場合は、選択できません。

重要 :
Enabled プロパティを false に設定したからといって、アプリケーションのコントロール ボックスが無効になったり、アプリケーション ウィンドウがフォーカスを受け取らなくなるわけではありません。

コンテナ コントロールの有効にされたプロパティが false に設定されているときは、そのコンテナ内のすべてコントロールも無効です。たとえば、無効にされている GroupBox コントロール内のどのコントロールをユーザーがクリックしても、イベントは発生しません。

メモ
スクロールできるコントロールが無効にされている場合は、スクロール バーも無効です。たとえば、複数行のテキスト ボックスが無効にされている場合は、スクロールしてテキストの全行を表示することはできません。

使用例

GroupBox を作成して、共通プロパティの一部を設定するコード例を次に示します。この例では、TextBox を作成し、グループ ボックス内での Location を設定しています。次に、グループ ボックスの Text プロパティを設定して、グループ ボックスをフォームの上部にドッキングします。最後に、Enabled プロパティを false に設定してグループを無効にします。これにより、グループ ボックスに含まれるすべてのコントロールが無効になります。

Visual Basic

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New
 GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

C#

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

C++

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }

J#

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
    // Create a GroupBox and add a TextBox to it.
    GroupBox groupBox1 = new GroupBox();
    TextBox textBox1 = new TextBox();
    textBox1.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

プラットフォーム

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

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

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
ScrollableControl