/*========================================================================= Library: CTK Copyright (c) Kitware Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.commontk.org/LICENSE Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. =========================================================================*/ // QT includes #include #include // CTK includes #include "ctkWorkflow.h" #include "ctkWorkflowTabWidget.h" #include "ctkWorkflowGroupBox.h" #include "ctkExampleDerivedWorkflowWidgetStep.h" // STD includes #include #include /// /// Simple example of how to setup a workflow using custom steps that /// were created by deriving ctkWorkflowWidgetStep. /// See: ctkExampleDerivedWorkflowWidgetStep for an example of how to /// setup the custom steps. //----------------------------------------------------------------------------- int ctkExampleUseOfWorkflowWidgetUsingDerivedSteps ( int argc, char * argv [] ) { QApplication app(argc, argv); // this boolean is used in setHideWidgetsOfNonCurrentSteps() below // false: when a widget does not belong to the current step, it is // hidden // true: when a widget does not belong to the current step, it is // shown, but disabled bool hideWidgets = false; // create the workflow ctkWorkflow* workflow = new ctkWorkflow; // create the workflow's UI component ctkWorkflowTabWidget* workflowWidget = new ctkWorkflowTabWidget; workflowWidget->setWorkflow(workflow); ctkWorkflowGroupBox* groupBox = workflowWidget->workflowGroupBox(); groupBox->setPreText("I am some pre-text"); groupBox->setPostText("I am some post-text"); groupBox->setHideWidgetsOfNonCurrentSteps(hideWidgets); // create and add the first workflow step ctkExampleDerivedWorkflowWidgetStep* testStep1 = new ctkExampleDerivedWorkflowWidgetStep(workflow, "Step 1"); testStep1->setName("Step 1"); testStep1->setDescription("I am in step 1"); // can specify the name of the tab workflowWidget->associateStepWithLabel(testStep1, "name 1"); // create and add the second workflow step ctkExampleDerivedWorkflowWidgetStep* testStep2 = new ctkExampleDerivedWorkflowWidgetStep(workflow, "Step 2"); testStep2->setName("Step 2"); testStep2->setDescription("I am in step 2"); // a new tab is automatically created workflowWidget->associateStepWithLabel(testStep2, "name 2"); // create and add a third workflow step ctkExampleDerivedWorkflowWidgetStep* testStep3 = new ctkExampleDerivedWorkflowWidgetStep(workflow, "Step 3"); testStep3->setName("Step 3"); testStep3->setDescription("I am in step 3"); // can place a step on a tab that was previously created by // specifying its index workflowWidget->associateStepWithPage(testStep3, 1, "name 3"); // add the steps to the workflow workflow->addTransition(testStep1, testStep2); workflow->addTransition(testStep2, testStep3); // testStep1 is the initial step workflow->setInitialStep(testStep1); // testStep3 will be a finish step, since it is the last step in the workflow // - will perform the processing associated with entering and // leaving each step, using the default values supplied // - if successful: brings you back to the step where you requested // to go to the finish step, so that you can begin customization // using user inputs if desired // - if unsuccessful: leaves you in the step of failure, so that you // can attempt to recify things from there; prints an error message // at the bottom of the widget. To see this behavior: // 1) "Next" to step 2 // 2) change step 2's value to something invalid (ex. 0) // 3) "Back" to step 1 // 4) "finish" - attempts to go to step 3, but leaves you in step 2 // start the workflow workflow->start(); workflowWidget->show(); // change this value (500) to increase the time that the widget is // shown QTimer::singleShot(500, &app, SLOT(quit())); app.exec(); // stop the workflow workflow->stop(); QTimer::singleShot(100, &app, SLOT(quit())); app.exec(); // handles deletion of the workflowWidget, workflow, steps, states // and transitions delete workflowWidget; return EXIT_SUCCESS; }