Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) Metodo

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

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

forward
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

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

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

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

Il codice seguente esempio il metodo SelectNextControl usato in un form 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. La proprietà ActiveControl 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 metodo SelectNextControl utilizzato in un form che dispone di un Button e di 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 sul Button, viene attivato il controllo successivo dopo l'Button.When you click the Button, the next control after the Button is activated. Si noti che è necessario ottenere l'elemento padre del controllo Button.Notice that you have to get the parent of the Button control. Poiché Button non è un contenitore, la chiamata di SelectNextControl direttamente in Button non comporta la modifica dell'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 metodo SelectNextControl attiva il controllo successivo nell'ordine di tabulazione se il bit di stile Selectable del controllo è impostato su true in ControlStyles, è contenuto 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 Forms nell'elenco seguente non sono selezionabili.The Windows Forms controls in the following list are not selectable. Anche i controlli derivati dai controlli nell'elenco non saranno 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 i metodi Select o SelectNextControl oppure impostando la proprietà ContainerControl.ActiveControl sul form corrente, gli eventi di attivazione 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 la proprietà CausesValidation è impostata su false, gli eventi Validating e Validated vengono eliminati.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Si applica a

Vedi anche