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 。

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やその他のコントロールを含むフォームで使用されている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 メソッドや SelectNextControl メソッドを呼び出したり、 ContainerControl.ActiveControl プロパティを現在のフォームに設定したりすると、フォーカス イベントは次の順序で発生します。

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

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

こちらもご覧ください

• Select()
• Focus()