Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

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);

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

ctl

Control

untuk Control memulai pencarian.

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

Boolean

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.

• Label

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• 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:

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

CausesValidation Jika properti diatur ke false, Validating peristiwa dan Validated ditekan.

Lihat juga

• Select()
• Focus()