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);
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

戻り値

Boolean

コントロールがアクティブにされた場合は true。それ以外の場合は false

次のコードは、 SelectNextControl いくつかのコントロールを含むフォームで使用されているメソッドを exampleshows しています。 フォームをクリックするたびに、次のコントロールがアクティブになります。 プロパティは、 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はコンテナーではないため、 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 スタイルビットが in に設定されていて、別の true ControlStyles コントロールに含まれており、すべての親コントロールが表示され、有効になっている場合に、タブオーダー内の次のコントロールをアクティブにします。

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

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

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

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

適用対象

こちらもご覧ください