Control.Enabled Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość wskazującą, czy kontrolka może reagować na interakcję użytkownika.

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

Wartość właściwości

Boolean

true jeśli kontrolka może reagować na interakcję użytkownika; w przeciwnym razie , false. Wartość domyślna to true.

Przykłady

Poniższy przykład kodu tworzy obiekt GroupBox i ustawia niektóre z jego typowych właściwości. W przykładzie tworzony jest obiekt TextBox i ustawia go Location w polu grupy. Następnie ustawia Text właściwość pola grupy i dokuje pole grupy do góry formularza. Na koniec wyłącza pole grupy, ustawiając Enabled właściwość na false, co powoduje wyłączenie wszystkich kontrolek zawartych w polu grupy.

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

Uwagi

Enabled Za pomocą właściwości można włączać lub wyłączać kontrolki w czasie wykonywania. Na przykład można wyłączyć kontrolki, które nie mają zastosowania do bieżącego stanu aplikacji. Możesz również wyłączyć kontrolkę, aby ograniczyć jej użycie. Na przykład przycisk można wyłączyć, aby uniemożliwić użytkownikowi jego kliknięcie. Jeśli kontrolka jest wyłączona, nie można jej wybrać.

Ważne

Enabled Ustawienie właściwości false na wartość nie powoduje wyłączenia pola sterowania aplikacji lub uniemożliwienia odbierania fokusu w oknie aplikacji.

Gdy kontrolka kontenera ma jej właściwość włączoną na falsewartość , wszystkie zawarte w niej kontrolki również są wyłączone. Jeśli na przykład użytkownik kliknie dowolną kontrolkę znajdującą się w wyłączonej GroupBox kontrolce, żadne zdarzenia nie są wywoływane.

Uwaga

Gdy kontrolka z możliwością przewijania jest wyłączona, paski przewijania są również wyłączone. Na przykład wyłączone wielowierszowe pole tekstowe nie może przewinąć, aby wyświetlić wszystkie wiersze tekstu.

Zobacz też

• ScrollableControl