Control.SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

次のコントロールをアクティブにします。

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 含むフォームで使用されているメソッドを示します。 フォームをクリックするたびに、次のコントロールがアクティブになります。 プロパティは 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 フォーム コントロールは選択できません。 リスト内のコントロールから派生したコントロールも選択できません。

• Label

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• LinkLabel (コントロールにリンクがない場合)

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

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

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

こちらもご覧ください

• Select()
• Focus()