Wizard控件
与MultiView控件类似,Wizard包含一个WizardStep对象集合,它从View类继承。
Wizard控件能实现导航效果,包括线性导航(从一步转到下一步或上一步)和非线性导航(从一步转到任意其他步)。
Wizard控件的所有外观特征几乎都可以通过样式和模板来自定义,包括各种各样的按钮和链接、标题和页脚、工具条和WizardStep。
<asp:Wizard ID="Wizard1"runat="server">
<WizardSteps>
<asp:WizardStep runat="server" Title="Step 1">第一步
</asp:WizardStep>
<asp:WizardStep runat="server" Title="Step 2">第二步
</asp:WizardStep>
</WizardSteps>
</asp:Wizard>
WizardStep的内容区域,可以输入文本或插入控件。
Wizard主要属性
名称 | 说明 |
ActiveStepIndex | WizardsSteps集合中当前显示的从0开始的步骤 |
CancelDestinationPageUrl | 当用户单击取消按钮时要链接到的URL |
DisplayCancelButton | 如果为true,则显示一个取消按钮。默认值为false |
DisplaySideBar | 如果为true,则显示一个工具条。默认值为false |
FinishDestinationPageUrl | 当用户单击完成按钮时要链接到的URL |
FinishNavigationTemplate | 用于指定完成步骤的导航区域的样式和内容的模板 |
HeaderStyle | 标题区域的样式属性 |
HeaderTemplate | 用于指定标题区域的内容和样式的模板,标题区域位于每个步骤的顶部 |
HeaderText | 在标题区域显示的文本 |
NavigationButtonStyle | 导航区域按钮的样式属性 |
NavigationStyle | 导航区域的样式属性 |
SideBarButtonStyle | 用于指定侧栏上按钮外观的样式属性 |
SideBarStyle | 侧栏区域的样式 |
SideBarTemplate | 用于指定侧栏区域内容和样式的模板 |
SkipLinkText | 为不可见图像呈现替换文本 |
StartNavigationTemplate | 用于指定Start步骤的导航区域的内容和样式的模板。 |
StepNavigationTemplate | 用于指定一般步骤中导航区域内容和样式的模板 |
StepStyle | WizardStep对象的样式属性 |
WizardSteps | WizardStep对象的集合 |
按钮类型
CancelButtonType
FinishStepButtonType
FinishStepPreviousButtonType
NextStepButtonType
PreviousStepButtonType
StartStepNextButtonType
指定按钮外观的样式属性
CancelButtonStyle
FinishStepButtonStyle
FinishStepPreviousButtonStyle
NextStepButtonStyle
PreviousStepButtonStyle
StartStepNextButtonStyle
StepType属性
值是一个WizardStepType枚举值
成员 | 说明 |
Auto | 声明步骤时的顺序决定了导航的界面,这是默认值 |
Complete | 要显示的最后步骤,它不呈现导航按钮 |
Finish | 最后的数据采集步骤,它只呈现被动完成和上一步两个按钮 |
Start | 第一步,只呈现一个下一步按钮 |
Step | 呈现上一步和下一步按钮 |
AllowReturn属性
该属性可以强制线性导航
设置一个步骤的AllowReturn属性为false后,则只能导航到该步骤一次。
Wizard主要事件
事件 事件参数 说明
ActiveStepChanged EventArgs 显示新步骤时触发
CancelButtonClick EventArgs 单击取消按钮时触发
FinishButtonClick WizardNavigationEventArgs 单击完成按钮时触发
NextButtonClick WizardNavigationEventArgs 单击下一步按钮时触发
PreviousButtonClick WizardNavigationEventArgs 单击上一步时触发
SideBarButtonClick WizardNavigationEventArgs当单击侧栏区域中的按钮时触发
WizardNavigationEventArgs的属性
Cancel 如果取消链接到下一步,则该值为true。默认值为false。
CurrentStepIndex 以0开始的WizardSteps集合中当前步骤的索引值。
NextStepIndex 以0开始的将要显示的步骤的索引值,当前为0。
Wizard控件的方法
方法名称 返回类型 说明
GetHistory ICollection
返回一个按被访问的顺序排列的WizardStepBase 对象的集合,索引0为最近访问的步骤
GetStepType WizardStepType 步骤的类型
MoveTo void 移动到参数中指定的WizardStep对象