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

Definición

Activa el siguiente control.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

Parámetros

ctl
Control Control Control Control

Control donde va a comenzar la búsqueda.The Control at which to start the search.

forward
Boolean Boolean Boolean Boolean

Es true para moverse hacia delante en el orden de tabulación; es false para moverse hacia atrás en el orden de tabulación.true to move forward in the tab order; false to move backward in the tab order.

tabStopOnly
Boolean Boolean Boolean Boolean

Es true para pasar por alto los controles cuya propiedad TabStop está establecida en false; en caso contrario, es false.true to ignore the controls with the TabStop property set to false; otherwise, false.

nested
Boolean Boolean Boolean Boolean

Es true para incluir controles secundarios anidados (es decir, controles secundarios de controles secundarios); en caso contrario, es false.true to include nested (children of child controls) child controls; otherwise, false.

wrap
Boolean Boolean Boolean Boolean

Es true para continuar la búsqueda a partir del primer control en el orden de tabulación después de haber llegado hasta el último; en caso contrario, es false.true to continue searching from the first control in the tab order after the last control has been reached; otherwise, false.

Devoluciones

true si se activó un control; en caso contrario, false.true if a control was activated; otherwise, false.

Ejemplos

El siguiente código EjemploMuestra el SelectNextControl método que se utiliza en un formulario con algunos controles.The following code exampleshows the SelectNextControl method being used in a form that has some controls. Cada vez que haga clic en el formulario, se activa el siguiente control.Each time that you click the form, the next control is activated. El ActiveControl propiedad obtiene el control activo en el control contenedor.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

El siguiente ejemplo de código muestra la SelectNextControl método que se va a utilizar en un formulario que tiene un Button y algunos otros controles.The following code example shows the SelectNextControl method being used in a form that has a Button and some other controls. Al hacer clic en el Button, el siguiente control después de la Button está activado.When you click the Button, the next control after the Button is activated. Tenga en cuenta que tendrá que obtener el elemento primario de la Button control.Notice that you have to get the parent of the Button control. Puesto que Button no es un contenedor, una llamada a SelectNextControl directamente en el Button no cambiaría la activación.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

Comentarios

El SelectNextControl método activa el siguiente control en el orden de tabulación, si el control Selectable bit de estilo se establece en true en ControlStyles, que está contenida en otro control y todos sus controles principales son visibles y están habilitados.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.

Los controles de Windows Forms en la lista siguiente no son seleccionables.The Windows Forms controls in the following list are not selectable. Controles derivados de controles en la lista también se pueden seleccionables no.Controls derived from controls in the list will also not be selectable.

Al cambiar el foco mediante el teclado (ficha, MAYÚS+TAB etc.), mediante una llamada a la Select o SelectNextControl métodos, o estableciendo la ContainerControl.ActiveControl propiedad al formulario actual, se producen eventos de foco en el orden siguiente: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

Si el CausesValidation propiedad está establecida en false, Validating y Validated se suprimen eventos.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Se aplica a

Consulte también: