Элемент управления "WizardConrol"
Элемент управления WizardControl
позволяет облегчить процесс создания стандартных мастеров (последовательность форм с возможностью навигации вперед/назад). Внешний вид элемента управления:
Свойства
-
int ButtonHeight
— высота стандартных кнопок (Back, Next, Cancel, Finish). -
int ButtonWidth
— ширина стандартных кнопок (Back, Next, Cancel, Finish). -
int HorizontalSpacing
— расстояние между кнопками по горизонтали. -
int VerticalSpacing
— расстояние между кнопками по вертикали. -
string BackButtonText
— текст кнопки Back. -
string CancelButtonText
— текст кнопки Cancel. -
string FinishButtonText
— текст кнопки Finish. -
string HelpButtonText
— текст кнопки Help. -
System.Drawing.SizeDefaultSize
— начальный размер элемента управления. -
System.Windows.Forms.FlatStyleFlatStyle
— стиль отрисовки элемента управления. -
bool HelpButtonVisible
— признак, отображать ли кнопку помощи (Help).
Набор шагов мастера задаётся при помощи коллекции WizardPages — которую можно редактировать, используя специальный визуальный редактор:
Редактор позволяет добавить произвольное количество страниц (шагов мастера), а также менять порядок их следования. Каждая страница имеет единственное значимое свойство — Text
, которое позволяет определить заголовок страницы.
После определения всех страниц, они появляются в мастере, и можно добавлять интерактивные элементы управления непосредственно на них. Переход между страницами при этом осуществляется с помощью стандартных навигационных кнопок мастера.
-
OnWizardFinished(System.EventArgs e)
— событие инициируется при нажатии на кнопку Finish, и позволяет реализовать необходимые действия по завершению его работы (сохранить результаты работы, выполнить какие-то действия, и т.д.). -
OnWizardCanceled(System.EventArgs e)
— событие инициируется при нажатии на кнопку Cancel, и позволяет реализовать необходимые действия по аварийному прерыванию его работы (закрыть форму на которой расположен мастер). -
OnSelectedIndexChanging(DocsVision.Platform.WinForms.Controls.WizardControl.SelectedIndexChangingEventArgs e)
— событие инициируется до смены вкладки (при перемещении вперед или назад), и позволяет в случае необходимости воспрепятствовать этому переходу. Это может быть полезно для реализации проверки ввода всех необходимых параметров, прежде чем разрешить переход к следующему шагу. -
OnSelectedIndexChanged(System.EventArgs e)
— это событие возникает после перехода на новый шаг (вперед или назад), и позволяет выполнить какие-то действия по инициализации элементов управления на новом шаге.