![\"Wizard](\"http:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2012\/10\/Wizard-Template.png\" "\\"Wizard")
<\/a><\/p>\nThis template simulates an application wizard by utilizing a TabControl to represent the various pages of the wizard. The template also includes navigation buttons that enable and disable depending on the current position and if the controls validate.<\/p>\n
<\/p>\n
Each tab page has a sample input that must either be entered or checked in order to proceed. <\/p>\n For example, tab page \u201cStep 1\u201d has a textbox that must have information entered before proceeding:<\/p>\n Before Entering Text:<\/p>\n The Next button is disabled.<\/p>\n <\/p>\n After Entering Text:<\/p>\n The Next button is enabled because the text box has passed validation.<\/p>\n <\/p>\n The same applies to the other tab pages until the final page, which enables the Finish button once all the other pages are validated:<\/p>\n <\/p>\n Wizard Template Functions:<\/strong><\/p>\n The template includes functions to handle navigation and provide a place to insert your custom validation script. This validation script is called whenever the user tries to navigate to the next page in the wizard.<\/p>\n Validate-WizardPage<\/font><\/p>\n This function is called whenever the Wizard needs to validate a TabPage. Place your custom validation code here. Return True<\/i> if the page is valid otherwise False<\/i> if validation fails. The Wizard calls this function when the user is navigating to another tab page. If the function returns a value of False<\/i> it will prevent the user from proceeding. The result of this function also influences whether the Next and Finish buttons are enabled or disabled.<\/p>\n \u2026<\/p>\n <\/p>\n Update-NavButtons<\/font><\/p>\n Call this function when you wish to validate the current page and update the states of the navigation buttons.<\/p>\n This function should be called when the state of a control changes and has influence on whether the user can continue or not. For example, in the \u201cStep 1\u201c tab page, the Text Box must have text before proceeding; as a result, Update-NavButton<\/font> is called whenever the TextBox\u2019s text changes.<\/p>\n In addition to validation, the Next, Back and Finish buttons are enabled or disabled depending on the current tab\u2019s position.<\/p>\n <\/p>\n Finish Button<\/strong><\/p>\n Once all the tabs have been validated, the user can press the Finish Button. Place your custom script in the Finish button\u2019s Click event to handle any finalization.<\/p>\n Note: The Finish button has its DialogResult property set to OK; therefore, it will close the form once the user clicks on the button.<\/p>\n <\/p>\n For more details on the TabControl, please refer to the Spotlight on the TabControl<\/a> blog article. In the (v3.1.9) service release we introduced a new form template called: Wizard Template. This template simulates an application wizard by utilizing a TabControl to represent the various pages of the wizard. The template also includes navigation buttons that enable and disable depending on the current position and if the controls validate. Each tab […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[456,25],"tags":[665,28,1016,81,425],"class_list":["post-5428","post","type-post","status-publish","format-standard","hentry","category-primalscript-studio","category-windows-powershell","tag-form","tag-powershell","tag-powershell-studio","tag-templates","tag-wizard"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/5428","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=5428"}],"version-history":[{"count":5,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/5428\/revisions"}],"predecessor-version":[{"id":5497,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/5428\/revisions\/5497"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=5428"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=5428"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=5428"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\nfunction<\/span> <\/span>Validate-WizardPage<\/span>\n{\n<\/span><#\n Add TabPages and place the validation code in this function\n#><\/span>\n [OutputType([boolean])]\n <\/span>param<\/span>([System.Windows.Forms.TabPage]<\/span>$tabPage<\/span>)\n \n <\/span>if<\/span>(<\/span>$tabPage<\/span> <\/span>-eq<\/span> <\/span>$tabpageStep1<\/span>)\n {\n <\/span>#TODO: Enter Validation Code here for Step 1<\/span>\n <\/span>if<\/span>(<\/span>-not<\/span> <\/span>$textboxName<\/span>.Text)\n {\n <\/span>return<\/span> <\/span>$false<\/span> \n }\n \n <\/span>return<\/span> <\/span>$true<\/span>\n }\n <\/span>elseif<\/span> (<\/span>$tabPage<\/span> <\/span>-eq<\/span> <\/span>$tabpageStep2<\/span>)\n {\n <\/span>#TODO: Enter Validation Code here for Step 2<\/span>\n <\/span>if<\/span>(<\/span>$checkboxCheckToContinue<\/span>.Checked)\n {\n <\/span>return<\/span> <\/span>$true<\/span>\n }\n \n <\/span>return<\/span> <\/span>$false<\/span>\n }<\/span><\/pre>\n$textboxName_TextChanged<\/span>=<\/span>{\n <\/span>Update-NavButtons<\/span>\n}<\/span><\/pre>\n$buttonFinish_Click<\/span>=<\/span>{\n <\/span>#-------------------------------------------------------<\/span>\n <\/span># TODO: Place finalization script here<\/span>\n <\/span>#-------------------------------------------------------<\/span>\n \n}\n<\/span><\/pre>\n
For more details on the Button control, please refer to the Spotlight on the Button Control<\/a> blog article.<\/p>\n","protected":false},"excerpt":{"rendered":"