Control.Enabled プロパティ

定義

コントロールがユーザーとの対話に応答できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the control can respond to user interaction.

public:
 property bool Enabled { bool get(); void set(bool value); };
public bool Enabled { get; set; }
member this.Enabled : bool with get, set
Public Property Enabled As Boolean

プロパティ値

コントロールがユーザーとの対話に応答できる場合は true。それ以外の場合は falsetrue if the control can respond to user interaction; otherwise, false. 既定値は、true です。The default is true.

次のコード例では、GroupBox を作成し、その共通プロパティのいくつかを設定します。The following code example creates a GroupBox and sets some of its common properties. この例では、TextBox を作成し、その Location をグループボックス内に設定します。The example creates a TextBox and sets its Location within the group box. 次に、グループボックスの Text プロパティを設定し、グループボックスをフォームの上部にドッキングします。Next, it sets the Text property of the group box, and docks the group box to the top of the form. 最後に、Enabled プロパティを false に設定してグループボックスを無効にします。これにより、グループボックス内に含まれるすべてのコントロールが無効になります。Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

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

注釈

Enabled プロパティを使用すると、実行時にコントロールを有効または無効にすることができます。With the Enabled property, you can enable or disable controls at run time. たとえば、アプリケーションの現在の状態には適用されないコントロールを無効にすることができます。For example, you can disable controls that do not apply to the current state of the application. コントロールを無効にして使用を制限することもできます。You can also disable a control to restrict its use. たとえば、ボタンを無効にして、ユーザーがクリックできないようにすることができます。For example, a button can be disabled to prevent the user from clicking it. コントロールが無効になっている場合は、選択できません。If a control is disabled, it cannot be selected.

重要

Enabled プロパティを false に設定しても、アプリケーションのコントロールボックスを無効にしたり、アプリケーションウィンドウがフォーカスを受け取らないようにしたりすることはできません。Setting the Enabled property to false does not disable the application's control box or prevent the application window from receiving the focus.

コンテナーコントロールの enabled プロパティが false に設定されている場合、それに含まれるすべてのコントロールも無効になります。When a container control has its enabled property set to false, all its contained controls are disabled, as well. たとえば、ユーザーが無効な GroupBox コントロールに含まれるコントロールのいずれかをクリックすると、イベントは発生しません。For example, if the user clicks on any of the controls contained in a disabled GroupBox control, no events are raised.

注意

スクロール可能なコントロールが無効になっている場合は、スクロールバーも無効になります。When a scrollable control is disabled, the scroll bars are also disabled. たとえば、無効な複数行テキストボックスをスクロールして、テキストのすべての行を表示することはできません。For example, a disabled multiline textbox is unable to scroll to display all the lines of text.

適用対象

こちらもご覧ください