Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) 方法

定義

啟動下一個控制項。

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

參數

ctl
Control

要從其開始搜尋的 Control

forward
Boolean

true 會在定位順序中向前移動。false 會在定位順序中向後移動。

tabStopOnly
Boolean

true 會忽略 TabStop 屬性設定為 false 的控制項,否則為 false

nested
Boolean

true 會包含巢狀 (子控制項的子系) 子控制項,否則為 false

wrap
Boolean

true 會在到達最後一個控制項後,從定位順序中的第一個控制項繼續搜尋,否則為 false

傳回

如果已啟動控制項,則為 true,否則為 false

範例

下列程式碼範例示範 SelectNextControl 在具有某些控制項的表單中使用的 方法。 每次您按一下表單時,就會啟動下一個控制項。 屬性 ActiveControl 會取得容器控制項中目前作用中的控制項。

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

下列程式碼範例示範 SelectNextControl 在具有 Button 和一些其他控制項的表單中使用的 方法。 當您按一下 時 Button ,啟動 後的 Button 下一個控制項。 請注意,您必須取得 控制項的 Button 父系。 由於 Button 不是容器,因此直接在 上 Button 呼叫 SelectNextControl 並不會變更啟用。

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

備註

SelectNextControl如果控制項的 Selectable 樣式位設定 true 為 ,則方法會啟動定位順序中的 ControlStyles 下一個控制項,該控制項會包含在另一個控制項中,而且其所有父控制項都是可見且啟用的。

下列清單中的Windows Forms控制項無法選取。 從清單中的控制項衍生的控制項也無法選取。

當您使用鍵盤 (TAB、SHIFT+TAB 等) 、呼叫 SelectSelectNextControl 方法,或將 屬性設定 ContainerControl.ActiveControl 為目前表單來變更焦點時,焦點事件會依下列順序發生:

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

CausesValidation如果 屬性設定為 false ,則會 Validating 隱藏 和 Validated 事件。

適用於

另請參閱