Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Method

Definizione

Attiva il controllo successivo.Activates the next control.

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

Parametri

ctl
Control Control Control Control

Oggetto Control da cui iniziare la ricerca.The Control at which to start the search.

forward
Boolean Boolean Boolean Boolean

true per spostarsi in avanti nell'ordine di tabulazione, false per spostarsi all'indietro.true to move forward in the tab order; false to move backward in the tab order.

tabStopOnly
Boolean Boolean Boolean Boolean

true per ignorare i controlli con la proprietà TabStop impostata su false; in caso contrario, false.true to ignore the controls with the TabStop property set to false; otherwise, false.

nested
Boolean Boolean Boolean Boolean

true per includere controlli figlio annidati, ovvero controlli figlio di controlli figlio; in caso contrario, false.true to include nested (children of child controls) child controls; otherwise, false.

wrap
Boolean Boolean Boolean Boolean

true per continuare la ricerca dal primo controllo nell'ordine di tabulazione dopo avere raggiunto l'ultimo controllo; in caso contrario, false.true to continue searching from the first control in the tab order after the last control has been reached; otherwise, false.

Restituisce

true se il controllo è stato attivato; in caso contrario, false.true if a control was activated; otherwise, false.

Esempi

Nell'esempio di codice exampleshows il SelectNextControl metodo usato in un modulo con alcuni controlli.The following code exampleshows the SelectNextControl method being used in a form that has some controls. Ogni volta che si fa clic sul form, viene attivato il controllo successivo.Each time that you click the form, the next control is activated. Il ActiveControl proprietà ottiene il controllo attualmente attivo nel controllo contenitore.The ActiveControl property gets the currently active control in the container control.

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

Nell'esempio di codice riportato di seguito viene illustrato il SelectNextControl il metodo utilizzato in un form contenente un Button e alcuni altri controlli.The following code example shows the SelectNextControl method being used in a form that has a Button and some other controls. Quando si fa clic il Button, il controllo successivo dopo il Button è attivato.When you click the Button, the next control after the Button is activated. Si noti che è necessario ottenere l'elemento padre del Button controllo.Notice that you have to get the parent of the Button control. Poiché Button non è un contenitore, chiamare SelectNextControl direttamente sul Button sarebbe non modifica l'attivazione.Since Button is not a container, calling SelectNextControl directly on the Button would not change the 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

Commenti

Il SelectNextControl metodo attiva il controllo successivo nell'ordine di tabulazione se il controllo Selectable bit di stile è impostato su true in ControlStylesè inclusa in un altro controllo e tutti i relativi controlli padre sono visibili e abilitati.The SelectNextControl method activates the next control in the tab order if the control's Selectable style bit is set to true in ControlStyles, it is contained in another control, and all its parent controls are both visible and enabled.

I controlli Windows Form nell'elenco seguente non sono selezionabili.The Windows Forms controls in the following list are not selectable. I controlli derivati da controlli nell'elenco anche non sarà selezionabili.Controls derived from controls in the list will also not be selectable.

Quando si modifica lo stato attivo usando la tastiera (TAB, MAIUSC + TAB e così via), chiamando il Select oppure SelectNextControl metodi, oppure impostando il ContainerControl.ActiveControl proprietà al form corrente, gli eventi dello stato attivo si verificano nell'ordine seguente:When you change the focus by using the keyboard (TAB, SHIFT+TAB, and so on), by calling the Select or SelectNextControl methods, or by setting the ContainerControl.ActiveControl property to the current form, focus events occur in the following order:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Se il CausesValidation è impostata su false, il Validating e Validated gli eventi vengono soppressi.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Si applica a

Vedi anche