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

TabStop プロパティが true に設定されているコントロールを無視する場合は 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、コントロールのスタイル ビットが に設定されている場合、タブ オーダーでControlStyles次のSelectableコントロールをtrueアクティブ化します。このコントロールは別のコントロールに含まれており、そのすべての親コントロールが表示され、有効になります。

次の一覧のWindows フォーム コントロールは選択できません。 リスト内のコントロールから派生したコントロールも選択できません。

キーボード (TAB、Shift + TAB など) を使用してフォーカスを変更したり、 メソッドや SelectNextControl メソッドを呼び出Selectしたり、 プロパティをContainerControl.ActiveControl現在のフォームに設定したりすると、フォーカス イベントは次の順序で発生します。

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

プロパティが CausesValidationfalse設定されている場合、 Validating イベントと Validated イベントは抑制されます。

適用対象

こちらもご覧ください