Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Active le contrôle suivant.

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ètres

ctl

Control

Control À partir duquel démarrer la recherche.

forward

Boolean

true pour avancer dans l’ordre de tabulation ; false pour revenir en arrière dans l’ordre de tabulation.

tabStopOnly

Boolean

true pour ignorer les contrôles avec la TabStop propriété définie falsesur ; sinon, false.

nested

Boolean

true pour inclure les contrôles enfants imbriqués (enfants des contrôles enfants) ; sinon, false.

wrap

Boolean

true pour poursuivre la recherche à partir du premier contrôle dans l’ordre de tabulation une fois le dernier contrôle atteint ; sinon, false.

Retours

Boolean

true si un contrôle a été activé ; sinon, false.

Exemples

Les exemples de code suivants montrent la SelectNextControl méthode utilisée dans un formulaire qui a des contrôles. Chaque fois que vous cliquez sur le formulaire, le contrôle suivant est activé. La ActiveControl propriété obtient le contrôle actif dans le contrôle conteneur.

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

L’exemple de code suivant montre la SelectNextControl méthode utilisée dans un formulaire qui a un Button et d’autres contrôles. Lorsque vous cliquez sur le Buttoncontrôle suivant après l’activation Button . Notez que vous devez obtenir le parent du Button contrôle. Étant Button donné qu’il ne s’agit pas d’un conteneur, l’appel SelectNextControl directement sur l’activation Button ne change pas.

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

Remarques

La SelectNextControl méthode active le contrôle suivant dans l’ordre de tabulation si le bit de style du Selectable contrôle est défini ControlStylestrue sur , il est contenu dans un autre contrôle et tous ses contrôles parents sont visibles et activés.

Les contrôles Windows Forms de la liste suivante ne sont pas sélectionnables. Les contrôles dérivés de contrôles de la liste ne peuvent pas non plus être sélectionnés.

• Label

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• LinkLabel (lorsqu’aucun lien n’est présent dans le contrôle)

Lorsque vous modifiez le focus à l’aide du clavier (TAB, Maj+Tab, et ainsi de suite), en appelant ou SelectSelectNextControl en définissant la ContainerControl.ActiveControl propriété sur le formulaire actif, les événements de focus se produisent dans l’ordre suivant :

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

Si la CausesValidation propriété est définie falsesur , les Validating événements et Validated les événements sont supprimés.

Voir aussi

• Select()
• Focus()