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

Définition

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);
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 commencer la recherche.

forward
Boolean

true pour se déplacer vers le bas dans l'ordre de tabulation ; false pour se déplacer vers le haut dans l'ordre de tabulation.

tabStopOnly
Boolean

true pour ignorer les contrôles dont la propriété TabStop a la valeur false ; sinon, false.

nested
Boolean

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

wrap
Boolean

true pour poursuivre la recherche à partir du premier contrôle dans l'ordre de tabulation après que le dernier contrôle a été atteint ; sinon, false.

Retours

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 comporte certains contrôles. Chaque fois que vous cliquez sur le formulaire, le contrôle suivant est activé. La ActiveControl propriété obtient le contrôle actuellement 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 , Buttonle contrôle suivant après l’activation de Button est activé. Notez que vous devez obtenir le parent du Button contrôle. Étant donné que Button n’est pas un conteneur, appeler SelectNextControl directement sur ne Button modifierait pas l’activation.

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 true sur dans ControlStyles, qu’il est contenu dans un autre contrôle et que tous ses contrôles parent 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 des contrôles de la liste ne sont pas non plus sélectionnables.

Lorsque vous modifiez le focus à l’aide du clavier (TAB, MAJ+TAB, et ainsi de suite), en appelant les Select méthodes ou SelectNextControl ou en définissant la ContainerControl.ActiveControl propriété sur le formulaire actuel, 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é a la falsevaleur , les Validating événements et Validated sont supprimés.

S’applique à

Voir aussi