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

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

Control.cs

啟動下一個控制。

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 在 Tab 鍵順序中向後移動。

tabStopOnly

Boolean

true忽略將TabStop屬性設為 false的控制項;否則，。 false

nested

Boolean

true納入巢狀（兒童控制的子女）兒童控制;否則，。 false

wrap

Boolean

true在到達最後一個控制項後，從制表序列中的第一個控制項繼續搜尋;否則，。 false

傳回

Boolean

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 以包含 a Button 及其他一些控制項的形式所使用的方法。 當你點擊 Button，接著 Button 啟動的下一個控制項。 注意你必須取得控制的父 Button 。 由於 Button 不是容器，直接呼叫 SelectNextControl 不會 Button 改變啟動。

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 表單控制項無法選擇。 由清單中控制項衍生的控制項也無法被選擇。

• Label

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• LinkLabel （當控制中沒有連結時）

當你用鍵盤（TAB、SHIFT+TAB 等）、呼叫 Select or SelectNextControl 方法，或將屬性設 ContainerControl.ActiveControl 為當前形式來更改焦點時，焦點事件會依以下順序發生：

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

若 CausesValidation 屬性設為 false，則 Validating 與 Validated 事件會被抑制。

另請參閱

• Select()
• Focus()