Control.Enabled Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает значение, указывающее, может ли элемент управления отвечать на действия пользователя.

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

Значение свойства

Boolean

Значение true, если элемент управления может отвечать на действия пользователя; в противном случае — значение false. Значение по умолчанию — true.

Примеры

В следующем примере кода создается GroupBox и задаются некоторые из его общих свойств. В примере создается TextBox и задается в Location поле группы. Затем он задает Text свойство поля группы и закрепляет поле группы в верхней части формы. Наконец, он отключает поле группы, задав свойству Enabledfalseзначение , что приводит к отключению всех элементов управления, содержащихся в поле группы.

   // 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 С помощью свойства можно включать или отключать элементы управления во время выполнения. Например, можно отключить элементы управления, которые не применяются к текущему состоянию приложения. Вы также можете отключить элемент управления, чтобы ограничить его использование. Например, можно отключить кнопку, чтобы запретить пользователю щелкать ее. Если элемент управления отключен, его нельзя выбрать.

Важно!

Задание свойству Enabled значения false не отключает окно управления приложения и не запрещает окну приложения получать фокус.

Если свойство enabled элемента управления контейнера имеет значение false, все содержащиеся в нем элементы управления также отключаются. Например, если пользователь щелкает любой из элементов управления, содержащихся в отключенном GroupBox элементе управления, события не создаются.

Примечание

Если прокручиваемый элемент управления отключен, полосы прокрутки также отключаются. Например, отключенное многостроочное текстовое поле не может прокручиваться для отображения всех строк текста.

См. также раздел

• ScrollableControl