Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.cs

Aktiválja a következő vezérlőt.

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

Paraméterek

ctl

Control

A Control keresés indításának célja.

forward

Boolean

true a tabulátorsorrendben előrehaladni; false a tabulátor sorrendben történő hátralépéshez.

tabStopOnly

Boolean

true a vezérlők figyelmen kívül hagyása a TabStop következő tulajdonsággal false: ; egyébként false.

nested

Boolean

truebeágyazott (gyermekvezérlők gyermekei) gyermekvezérlők belefoglalása; egyéb esetben. false

wrap

Boolean

truea tabulátorsor első vezérlőjének keresésének folytatása az utolsó vezérlőelem elérése után; egyéb esetben. false

Válaszok

Boolean

trueha egy vezérlő aktiválva lett; egyéb esetben. false

Példák

Az alábbi példakód bemutatja, hogy a SelectNextControl metódust egy olyan űrlapon használják, amely bizonyos vezérlőkkel rendelkezik. Minden alkalommal, amikor az űrlapra kattint, a következő vezérlő aktiválódik. A ActiveControl tulajdonság az aktuálisan aktív vezérlőt kapja meg a tárolóvezérlőben.

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

Az alábbi példakód egy SelectNextControl olyan űrlapon használt metódust mutatja be, amely rendelkezik Button más vezérlőkkel. Amikor a Buttongombra kattint, a következő vezérlőt Button aktiválja. Figyelje meg, hogy be kell szereznie a vezérlő szülőját Button . Mivel Button nem tároló, a közvetlen hívás SelectNextControl nem Button változtatná meg az aktiválást.

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

Megjegyzések

A SelectNextControl metódus aktiválja a következő vezérlőelemet a tabulátorsorrendben, ha a vezérlőelem stílusbitje Selectable be van állítva trueControlStyles, egy másik vezérlőelem tartalmazza, és az összes szülővezérlője látható és engedélyezve van.

Az alábbi listában szereplő Windows Forms vezérlők nem választhatók ki. A lista vezérlőiből származó vezérlők szintén nem lesznek kiválaszthatók.

• Label

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• LinkLabel (ha nincs hivatkozás a vezérlőben)

Ha a billentyűzettel (TAB, SHIFT+TAB stb.) módosítja a fókuszt, meghívja a SelectSelectNextControl metódusokat, vagy a ContainerControl.ActiveControl tulajdonságot az aktuális űrlapra állítja, a fókuszesemények a következő sorrendben következnek be:

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

Ha a CausesValidation tulajdonság értéke a következő, falseaz események és Validating az Validated események el lesznek tiltva.

Lásd még

• Select()
• Focus()