Control.Enabled Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol dapat merespons interaksi pengguna.
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
Nilai Properti
true jika kontrol dapat merespons interaksi pengguna; jika tidak, false. Defaultnya adalah true.
Contoh
Contoh kode berikut membuat GroupBox dan mengatur beberapa properti umumnya. Contoh membuat TextBox dan mengaturnya Location dalam kotak grup. Selanjutnya, ini mengatur Text properti kotak grup, dan menambungkan kotak grup ke bagian atas formulir. Terakhir, ini menonaktifkan kotak grup dengan mengatur Enabled properti ke false, yang menyebabkan semua kontrol yang terkandung dalam kotak grup dinonaktifkan.
// 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
Keterangan
Enabled Dengan properti , Anda dapat mengaktifkan atau menonaktifkan kontrol pada waktu proses. Misalnya, Anda dapat menonaktifkan kontrol yang tidak berlaku untuk status aplikasi saat ini. Anda juga dapat menonaktifkan kontrol untuk membatasi penggunaannya. Misalnya, tombol dapat dinonaktifkan untuk mencegah pengguna mengkliknya. Jika kontrol dinonaktifkan, kontrol tidak dapat dipilih.
Penting
Enabled Mengatur properti ke false tidak menonaktifkan kotak kontrol aplikasi atau mencegah jendela aplikasi menerima fokus.
Ketika kontrol kontainer memiliki properti yang diaktifkan diatur ke false, semua kontrol yang terkandung dinonaktifkan juga. Misalnya, jika pengguna mengklik salah satu kontrol yang terkandung dalam kontrol yang dinonaktifkan GroupBox , tidak ada peristiwa yang dinaikkan.
Nota
Saat kontrol yang dapat digulir dinonaktifkan, bilah gulir juga dinonaktifkan. Misalnya, kotak teks multibaris yang dinonaktifkan tidak dapat menggulir untuk menampilkan semua baris teks.