Control.Enabled Control.Enabled Control.Enabled Control.Enabled Property

定義

コントロールがユーザーとの対話に応答できるかどうかを示す値を取得または設定します。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.

コンテナー コントロールが、有効なプロパティに設定を持っている場合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.

適用対象

こちらもご覧ください