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

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 donde va a comenzar la búsqueda.The Control at which to start the search.

forward
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

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

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

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 ejemplo el método SelectNextControl 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 propiedad ActiveControl 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 se muestra el método SelectNextControl que se usa en un formulario que tiene Button 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 el Button, se activa el siguiente control después de la Button.When you click the Button, the next control after the Button is activated. Tenga en cuenta que tiene que obtener el elemento primario del control Button.Notice that you have to get the parent of the Button control. Como Button no es un contenedor, llamar 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 método SelectNextControl activa el siguiente control en el orden de tabulación si el bit de estilo Selectable del control se establece en true en ControlStyles, 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 métodos Select o SelectNextControl, o estableciendo la propiedad ContainerControl.ActiveControl 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 propiedad CausesValidation está establecida en false, se suprimen los eventos Validating y Validated.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

Se aplica a

Consulte también: