Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Metode
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.
Mengaktifkan kontrol berikutnya.
public:
bool SelectNextControl(System::Windows::Forms::Control ^ ctl, bool forward, bool tabStopOnly, bool nested, bool wrap);
public bool SelectNextControl (System.Windows.Forms.Control ctl, bool forward, bool tabStopOnly, bool nested, bool wrap);
public bool SelectNextControl (System.Windows.Forms.Control? ctl, bool forward, bool tabStopOnly, bool nested, bool wrap);
member this.SelectNextControl : System.Windows.Forms.Control * bool * bool * bool * bool -> bool
Public Function SelectNextControl (ctl As Control, forward As Boolean, tabStopOnly As Boolean, nested As Boolean, wrap As Boolean) As Boolean
Parameter
- forward
- Boolean
true
untuk maju dalam urutan tab; false
untuk bergerak mundur dalam urutan tab.
- tabStopOnly
- Boolean
true
untuk mengabaikan kontrol dengan properti yang TabStop diatur ke false
; jika tidak, false
.
- nested
- Boolean
true
untuk menyertakan kontrol anak berlapis (anak kontrol anak) ; jika tidak, false
.
- wrap
- Boolean
true
untuk melanjutkan pencarian dari kontrol pertama dalam urutan tab setelah kontrol terakhir tercapai; jika tidak, false
.
Mengembalikan
true
jika kontrol diaktifkan; jika tidak, false
.
Contoh
Contoh kode berikut menampilkan metode yang SelectNextControl digunakan dalam formulir yang memiliki beberapa kontrol. Setiap kali Anda mengklik formulir, kontrol berikutnya diaktifkan. Properti ActiveControl mendapatkan kontrol aktif saat ini dalam kontrol kontainer.
private void Form1_Click(object sender, EventArgs e)
{
Control ctl;
ctl = (Control)sender;
ctl.SelectNextControl(ActiveControl, true, true, true, true);
}
Private Sub Form1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles MyBase.Click
Dim ctl As Control
ctl = CType(sender, Control)
ctl.SelectNextControl(ActiveControl, True, True, True, True)
End Sub
Contoh kode berikut menunjukkan metode yang SelectNextControl digunakan dalam formulir yang memiliki Button dan beberapa kontrol lainnya. Saat Anda mengklik Button, kontrol berikutnya setelah Button diaktifkan. Perhatikan bahwa Anda harus mendapatkan induk Button kontrol. Karena Button bukan kontainer, memanggil SelectNextControl langsung pada Button tidak akan mengubah aktivasi.
private void button1_Click(object sender, EventArgs e)
{
Control p;
p = ((Button) sender).Parent;
p.SelectNextControl(ActiveControl, true, true, true, true);
}
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
Dim p As Control
p = CType(sender, Button).Parent
p.SelectNextControl(ActiveControl, True, True, True, True)
End Sub
Keterangan
Metode SelectNextControl mengaktifkan kontrol berikutnya dalam urutan tab jika bit gaya kontrol Selectable
diatur ke true
dalam ControlStyles, itu terkandung dalam kontrol lain, dan semua kontrol induknya terlihat dan diaktifkan.
Kontrol Formulir Windows dalam daftar berikut ini tidak dapat dipilih. Kontrol yang berasal dari kontrol dalam daftar juga tidak akan dapat dipilih.
LinkLabel (ketika tidak ada tautan yang ada dalam kontrol)
Saat Anda mengubah fokus dengan menggunakan keyboard (TAB, SHIFT+TAB, dan sebagainya), dengan memanggil Select metode atau SelectNextControl , atau dengan mengatur ContainerControl.ActiveControl properti ke formulir saat ini, peristiwa fokus terjadi dalam urutan berikut:
CausesValidation Jika properti diatur ke false
, Validating peristiwa dan Validated ditekan.