Control.Enabled Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Control.cs

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

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.

Примеры

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

   // 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 не отключает контрольный прямоугольник приложения или предотвращает получение фокуса в окне приложения.

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

Замечание

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

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

• ScrollableControl