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

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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

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.

tabStopOnly
Boolean

Es true para pasar por alto los controles cuya propiedad TabStop está establecida en false; en caso contrario, es false.

nested
Boolean

Es true para incluir controles secundarios anidados (es decir, controles secundarios de controles secundarios); en caso contrario, es 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.

Devoluciones

Boolean

true si se activó un control; en caso contrario, false.

Ejemplos

En los ejemplos de código siguientes se muestra el SelectNextControl método que se usa en un formulario que tiene algunos controles. Cada vez que haga clic en el formulario, se activará el siguiente control. La ActiveControl propiedad obtiene el control activo actualmente en el control contenedor.

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 SelectNextControl método que se usa en un formulario que tiene y Button otros controles. Al hacer clic en , Buttonel siguiente control después Button de activar . Observe que tiene que obtener el elemento primario del Button control. Puesto Button que no es un contenedor, llamar SelectNextControl directamente a en Button no cambiaría la activación.

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 de estilo del Selectable control se establece true en en ControlStyles, está incluido en otro control y todos sus controles primarios son visibles y habilitados.

Los controles de Windows Forms de la lista siguiente no se pueden seleccionar. Los controles derivados de los controles de la lista tampoco se podrán seleccionar.

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:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

Si la CausesValidation propiedad se establece falseen , se suprimen los Validating eventos y Validated .

Se aplica a

Consulte también