Control.Enabled プロパティとは何？わかりやすく解説 Weblio辞書

.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

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

C++

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

/** @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

// 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 );
   }

// 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