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Значение , falseчтобы игнорировать элементы управления с заданным falseсвойствомTabStop; в противном случае .

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 задано значение ControlStylestrue , он содержится в другом элементе управления, и все его родительские элементы управления отображаются и включены.

Элементы управления Windows Forms в следующем списке недоступны для выбора. Элементы управления, производные от элементов управления в списке, также не будут выбираться.

• Label

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• LinkLabel (если в элементе управления отсутствует ссылка)

При изменении фокуса с помощью клавиатуры (TAB, SHIFT+TAB и т. д.), вызывая Select методы или SelectNextControlContainerControl.ActiveControl вызывая свойство текущей формы, события фокуса происходят в следующем порядке:

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

CausesValidation Если для свойства задано значение false, Validating события Validated и события подавляются.

См. также раздел

• Select()
• Focus()