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

En el código siguiente se SelectNextControl ejemplo el método que se usa en un formulario que tiene 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 activará el control siguiente.Each time that you click the form, the next control is activated. La ActiveControl propiedad obtiene el control activo actualmente 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

En el ejemplo de código siguiente SelectNextControl se muestra el método que se utiliza en un Button formulario que tiene y 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 Button, el control siguiente después de Button que se active.When you click the Button, the next control after the Button is activated. Tenga en cuenta que tiene que obtener el elemento primario Button del control.Notice that you have to get the parent of the Button control. Puesto Button que no es un contenedor, SelectNextControl llamar directamente a 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 bit Selectable de true estilo del control se establece ControlStylesen en, está contenido en otro control y todos sus controles primarios 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 Windows Forms de la lista siguiente no se pueden seleccionar.The Windows Forms controls in the following list are not selectable. Los controles que se derivan de los controles de la lista tampoco se podrán seleccionar.Controls derived from controls in the list will also not be selectable.

Al cambiar el foco mediante el teclado (Tab, Mayús + Tab, etc.), llamando a los Select métodos o SelectNextControl , o estableciendo la ContainerControl.ActiveControl propiedad en el formulario actual, los eventos de foco se producen 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 la CausesValidation propiedad se establece en false, se Validating suprimen los eventos y Validated .If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Se aplica a

Consulte también: