Class TourStep
- All Implemented Interfaces:
- HasHandlers
Tour. As each step is executed, it
 will show  a TourWindow to the user (the automatically generated targetView).  At a minimum tourSteps will typically have a
 title and/or  description. Without a target the window will be shown in the center of the screen. 
 To
 relate the step to a component provide a target value. An
 actionType value determines what action, if any, is
 expected with the target. Some actionTypes like "none" and "any" just highlight the target for
 review and the user must click the next button to complete the step. Others like "click" or "change" expect the user to
 interact with the target component in a certain way. Many of these will advance to the next step when the required
 action is completed. See action types for  details. 
 In most cases
 the actionType can be left unset because a default is applied based on the other step properties and the
 Tour.mode. However, actions like doubleClick,
 rightClick and mouseOver must be provided. 
 To explicitly suppress automatic completion of
 a step on user interaction, devlopers may set autoComplete to false.
- 
Field SummaryFields inherited from class com.smartgwt.client.core.BaseClassconfig, configOnly, factoryCreated, factoryProperties, id, scClassName
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptioncreate()Applied directly totargetView.Indicates the type of action that is expected with thetarget component.Target component which must clicked to processexpectedValueentered intotargetwithactionTypeof "change".ForactionType:"drag"tourSteps with adropTarget, should we allow the drop to complete and the tour to proceed if the user drops on a descendant of the drop target.booleanIf this step has a target that prompts a user for a specific action, should the step be automatically completed and have the tour move forward to the next step when the user takes this action?When set on a step with anactionTypeof "change", the entered or selected value will be automatically bound to the specified value in thetour state.Applied directly totargetView.Target component on which atargetmust be dropped to complete step.The expected value foractionType:"change".The expected value foractionType:"change".The expected value foractionType:"change".The expected value foractionType:"change".Should theexpectedValuebe matched as case-sensitive?How should theexpectedValuebe validated and notified to the user?The time between keypresses that is used duringinputValidationbefore showing the expected text notification.Message to be displayed byTour.notifyValidationMessage().Text to show in body of window.static TourStepgetOrCreateRef(JavaScriptObject jsObj) Applied directly totargetViewpointerSettings.Should thetargetViewaction buttonbe shown for this step?For a step with anactiona large arrow shows to indicate the target or direction of required action.Should thetargetViewcancel buttonbe shown for this step?ShouldinputValidationNotifyMessagebe shown as detailed inTourInputValidationMode? Defaults fromTour.showInputValidationMessageif not set.Should the target(s) be outlined? Defaults totrueinTour.mode:"tutorial".Component that is the target of this step.Automatically generated view (typically a TourWindow) to show for tour step.The name of the widget class (as a string) to use for the target view.Defaults for thetargetViewautoChild.getTitle()Title for the Window.Defaults for thetargetViewautoChild.setActionButtonTitle(String actionButtonTitle) Applied directly totargetView.setActionType(TourActionType actionType) Indicates the type of action that is expected with thetarget component.setAfterInputTarget(String afterInputTarget) Target component which must clicked to processexpectedValueentered intotargetwithactionTypeof "change".setAllowDropOnDescendants(Boolean allowDropOnDescendants) ForactionType:"drag"tourSteps with adropTarget, should we allow the drop to complete and the tour to proceed if the user drops on a descendant of the drop target.setAutoComplete(boolean autoComplete) If this step has a target that prompts a user for a specific action, should the step be automatically completed and have the tour move forward to the next step when the user takes this action?setBindEnteredText(String bindEnteredText) When set on a step with anactionTypeof "change", the entered or selected value will be automatically bound to the specified value in thetour state.setCancelButtonTitle(String cancelButtonTitle) Applied directly totargetView.setDropTarget(String dropTarget) Target component on which atargetmust be dropped to complete step.setExpectedValue(Boolean expectedValue) The expected value foractionType:"change".setExpectedValue(Integer expectedValue) The expected value foractionType:"change".setExpectedValue(String expectedValue) The expected value foractionType:"change".setExpectedValue(Date expectedValue) The expected value foractionType:"change".setExpectedValueCaseSensitive(Boolean expectedValueCaseSensitive) Should theexpectedValuebe matched as case-sensitive?setInputValidation(TourInputValidationMode inputValidation) How should theexpectedValuebe validated and notified to the user?setInputValidationNotifyDelay(Integer inputValidationNotifyDelay) The time between keypresses that is used duringinputValidationbefore showing the expected text notification.setInputValidationNotifyMessage(String inputValidationNotifyMessage) Message to be displayed byTour.notifyValidationMessage().setInstructions(String instructions) Text to show in body of window.setPointerSnapTo(String pointerSnapTo) Applied directly totargetViewpointerSettings.setShowActionButton(Boolean showActionButton) Should thetargetViewaction buttonbe shown for this step?setShowArrow(Boolean showArrow) For a step with anactiona large arrow shows to indicate the target or direction of required action.setShowCancelButton(Boolean showCancelButton) Should thetargetViewcancel buttonbe shown for this step?setShowInputValidationMessage(Boolean showInputValidationMessage) ShouldinputValidationNotifyMessagebe shown as detailed inTourInputValidationMode? Defaults fromTour.showInputValidationMessageif not set.setShowOutline(Boolean showOutline) Should the target(s) be outlined? Defaults totrueinTour.mode:"tutorial".setShowPointer(Boolean showPointer) Component that is the target of this step.setTargetViewConstructor(String targetViewConstructor) The name of the widget class (as a string) to use for the target view.setTargetViewDefaults(Canvas targetViewDefaults) Defaults for thetargetViewautoChild.Title for the Window.setWindowDefaults(Canvas windowDefaults) Defaults for thetargetViewautoChild.Methods inherited from class com.smartgwt.client.util.workflow.UserTaskcancelEditing, completeEditing, getCancelElement, getInlineView, getPassThruOutput, getPreviousElement, getSaveToServer, getTargetForm, getTargetFormAsString, getTargetVM, getWizard, goToPrevious, setCancelElement, setInlineView, setPassThruOutput, setPreviousElement, setSaveToServer, setTargetForm, setTargetForm, setTargetView, setTargetView, setTargetVM, setTargetVM, setWizardMethods inherited from class com.smartgwt.client.util.workflow.TaskgetExpressionValue, getInputFieldList, getInputRecord, getInputs, getInputsAsString, getInputsAsStringArray, getOutputExpression, getOutputField, getOutputFieldList, getState, getStrictPaths, setInputFieldList, setInputs, setInputs, setInputs, setOutput, setOutputExpression, setOutputField, setOutputFieldList, setState, setStrictPathsMethods inherited from class com.smartgwt.client.util.workflow.ProcessElementcompleteElement, convertToJavaScriptArray, executeElement, getBindOutput, getClassDescription, getComponentReferences, getCurrentProcess, getDescription, getDynamicValue, getEditorType, getElementDescription, getForceSingle, getID, getInvalidTaskMessage, getJsObj, getMockMode, getNextElement, getOrCreateJsObj, getProcessElements, getSupportsMultipleInputRecords, getTextFormulaValue, getTypeTitle, getUndefinedComponentMessage, getUnresolvedComponentMessage, getWaitDuration, getWaitFor, getWaitLocator, isCreated, isValid, objectReferencesLastTaskOutput, onInit, reset, setAttribute, setBindOutput, setClassDescription, setCurrentProcess, setDescription, setEditorType, setForceSingle, setID, setJavaScriptObject, setMockMode, setNextElement, setSupportsMultipleInputRecords, setTypeTitle, setUndefinedComponentMessage, setUnresolvedComponentMessage, setWaitDuration, setWaitFor, setWaitLocator, updateGlobalIDInCriteria, updateGlobalIDInTextFormula, updateGlobalIDInValueProperty, updateGlobalIDInValues, updateGlobalIDReferences, updateLastElementBindingReferences, updateLastElementInCriteria, updateLastElementInValueProperty, updateLastElementInValuesMethods inherited from class com.smartgwt.client.core.BaseClassaddDynamicProperty, addDynamicProperty, addDynamicProperty, addDynamicProperty, applyFactoryProperties, asSGWTComponent, clearDynamicProperty, createJsObj, destroy, doAddHandler, doInit, error, error, errorIfNotCreated, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsString, getAttributeAsStringArray, getClassName, getConfig, getHandlerCount, getRef, getRuleScope, getScClassName, getTestInstance, hasAutoAssignedID, hasDynamicProperty, internalSetID, internalSetID, isConfigOnly, isFactoryCreated, onBind, registerID, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setConfig, setConfigOnly, setFactoryCreated, setProperty, setProperty, setProperty, setProperty, setRuleScope, setScClassName
- 
Constructor Details- 
TourSteppublic TourStep()
- 
TourStep
 
- 
- 
Method Details- 
getOrCreateRef
- 
create
- 
setActionButtonTitleApplied directly totargetView. Defaults fromTour.stepActionButtonTitle.- Parameters:
- actionButtonTitle- New actionButtonTitle value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getActionButtonTitleApplied directly totargetView. Defaults fromTour.stepActionButtonTitle.- Returns:
- Current actionButtonTitle value. Default value is null
- See Also:
 
- 
setActionTypeIndicates the type of action that is expected with thetarget component.If not specified a default type is determined by the Tour.modesetting, the target and other tourStep properties.Details: when tourModeis "tour"- then actionType = "none"
 when tourModeis "tutorial"- and expectedValueorafterInputTargetare set- then actionType = "change"
 
- and dropTargetis set- then actionType = "drag"
 
- otherwise         - actionType = "click"
 
 - Parameters:
- actionType- New actionType value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getActionTypeIndicates the type of action that is expected with thetarget component.If not specified a default type is determined by the Tour.modesetting, the target and other tourStep properties.Details: when tourModeis "tour"- then actionType = "none"
 when tourModeis "tutorial"- and expectedValueorafterInputTargetare set- then actionType = "change"
 
- and dropTargetis set- then actionType = "drag"
 
- otherwise         - actionType = "click"
 
 - Returns:
- Current actionType value. Default value is null
 
- 
setAfterInputTargetTarget component which must clicked to processexpectedValueentered intotargetwithactionTypeof "change".This is commonly used for a dialog where the must select a value and then click a submit button. Target may be specified as a GlobalIdfor a Component or FormItem, or as aAutoTestLocatorfor an element.- Parameters:
- afterInputTarget- New afterInputTarget value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getAfterInputTargetTarget component which must clicked to processexpectedValueentered intotargetwithactionTypeof "change".This is commonly used for a dialog where the must select a value and then click a submit button. Target may be specified as a GlobalIdfor a Component or FormItem, or as aAutoTestLocatorfor an element.- Returns:
- Current afterInputTarget value. Default value is null
 
- 
setAllowDropOnDescendantspublic TourStep setAllowDropOnDescendants(Boolean allowDropOnDescendants) throws IllegalStateException ForactionType:"drag"tourSteps with adropTarget, should we allow the drop to complete and the tour to proceed if the user drops on a descendant of the drop target.For example - if a user has been prompted to drag a component into a Layout, but the layout already contains a nested child layout, should the user be able to drop into that child layout and continue the tour? If unset this will be derived from Tour.allowDropOnDescendants- Parameters:
- allowDropOnDescendants- New allowDropOnDescendants value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getAllowDropOnDescendantsForactionType:"drag"tourSteps with adropTarget, should we allow the drop to complete and the tour to proceed if the user drops on a descendant of the drop target.For example - if a user has been prompted to drag a component into a Layout, but the layout already contains a nested child layout, should the user be able to drop into that child layout and continue the tour? If unset this will be derived from Tour.allowDropOnDescendants- Returns:
- Current allowDropOnDescendants value. Default value is null
 
- 
setAutoCompleteIf this step has a target that prompts a user for a specific action, should the step be automatically completed and have the tour move forward to the next step when the user takes this action?Has no effect except on action typesthat can auto-complete.If autoComplete is falsethe action button is shown but is disabled until the expected action is completed at which time the button is enabled so the user can continue.- Parameters:
- autoComplete- New autoComplete value. Default value is true
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getAutoCompletepublic boolean getAutoComplete()If this step has a target that prompts a user for a specific action, should the step be automatically completed and have the tour move forward to the next step when the user takes this action?Has no effect except on action typesthat can auto-complete.If autoComplete is falsethe action button is shown but is disabled until the expected action is completed at which time the button is enabled so the user can continue.- Returns:
- Current autoComplete value. Default value is true
 
- 
setBindEnteredTextWhen set on a step with anactionTypeof "change", the entered or selected value will be automatically bound to the specified value in thetour state.- Parameters:
- bindEnteredText- New bindEnteredText value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getBindEnteredTextWhen set on a step with anactionTypeof "change", the entered or selected value will be automatically bound to the specified value in thetour state.- Returns:
- Current bindEnteredText value. Default value is null
 
- 
setCancelButtonTitleApplied directly totargetView. Defaults fromTour.stepCancelButtonTitle.- Parameters:
- cancelButtonTitle- New cancelButtonTitle value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getCancelButtonTitleApplied directly totargetView. Defaults fromTour.stepCancelButtonTitle.- Returns:
- Current cancelButtonTitle value. Default value is null
- See Also:
 
- 
setDropTargetTarget component on which atargetmust be dropped to complete step. IfactionTypeis not specified and this property is provided,actionTypedefaults to "drag".Target may be specified as a GlobalIdfor a Component or FormItem, or as aAutoTestLocatorfor an element.- Parameters:
- dropTarget- New dropTarget value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getDropTargetTarget component on which atargetmust be dropped to complete step. IfactionTypeis not specified and this property is provided,actionTypedefaults to "drag".Target may be specified as a GlobalIdfor a Component or FormItem, or as aAutoTestLocatorfor an element.- Returns:
- Current dropTarget value. Default value is null
 
- 
setExpectedValueThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Parameters:
- expectedValue- New expectedValue value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getExpectedValueThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Returns:
- Current expectedValue value. Default value is null
- See Also:
 
- 
setExpectedValueThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Parameters:
- expectedValue- New expectedValue value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getExpectedValueAsBooleanThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Returns:
- Current expectedValue value. Default value is null
- See Also:
 
- 
setExpectedValueThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Parameters:
- expectedValue- New expectedValue value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getExpectedValueAsIntThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Returns:
- Current expectedValue value. Default value is null
- See Also:
 
- 
setExpectedValueThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Parameters:
- expectedValue- New expectedValue value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getExpectedValueAsDateThe expected value foractionType:"change". The value must be matched exactly ignoring case for string values. A string value can also be matched case-sensitive by settingexpectedValueCaseSensitivetotrue.A regular expression can be used to match the entered value by providing the expected value as a string with leading and trailing slashes (ex. "/get.*/"). - Returns:
- Current expectedValue value. Default value is null
- See Also:
 
- 
setExpectedValueCaseSensitivepublic TourStep setExpectedValueCaseSensitive(Boolean expectedValueCaseSensitive) throws IllegalStateException Should theexpectedValuebe matched as case-sensitive?- Parameters:
- expectedValueCaseSensitive- New expectedValueCaseSensitive value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getExpectedValueCaseSensitiveShould theexpectedValuebe matched as case-sensitive?- Returns:
- Current expectedValueCaseSensitive value. Default value is null
 
- 
setInputValidationpublic TourStep setInputValidation(TourInputValidationMode inputValidation) throws IllegalStateException How should theexpectedValuebe validated and notified to the user?Defaults to "onExit" if afterInputTargetis specified. Otherwise the default is "notify".- Parameters:
- inputValidation- New inputValidation value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getInputValidationHow should theexpectedValuebe validated and notified to the user?Defaults to "onExit" if afterInputTargetis specified. Otherwise the default is "notify".- Returns:
- Current inputValidation value. Default value is null
 
- 
setInputValidationNotifyDelaypublic TourStep setInputValidationNotifyDelay(Integer inputValidationNotifyDelay) throws IllegalStateException The time between keypresses that is used duringinputValidationbefore showing the expected text notification. Does not apply toinputValidation="onExit".- Parameters:
- inputValidationNotifyDelay- New inputValidationNotifyDelay value. Default value is 500
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getInputValidationNotifyDelayThe time between keypresses that is used duringinputValidationbefore showing the expected text notification. Does not apply toinputValidation="onExit".- Returns:
- Current inputValidationNotifyDelay value. Default value is 500
 
- 
setInputValidationNotifyMessagepublic TourStep setInputValidationNotifyMessage(String inputValidationNotifyMessage) throws IllegalStateException Message to be displayed byTour.notifyValidationMessage().This is a dynamic string - text within ${...}are dynamic variables and will be evaluated as JS code when the message is displayed.Only two dynamic variables, value and expectedValue, are available and represent the currently entered and expected values. - Parameters:
- inputValidationNotifyMessage- New inputValidationNotifyMessage value. Default value is "Please enter '${expectedValue}'"
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getInputValidationNotifyMessageMessage to be displayed byTour.notifyValidationMessage().This is a dynamic string - text within ${...}are dynamic variables and will be evaluated as JS code when the message is displayed.Only two dynamic variables, value and expectedValue, are available and represent the currently entered and expected values. - Returns:
- Current inputValidationNotifyMessage value. Default value is "Please enter '${expectedValue}'"
 
- 
setInstructionsText to show in body of window.- Parameters:
- instructions- New instructions value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getInstructionsText to show in body of window.- Returns:
- Current instructions value. Default value is null
- See Also:
 
- 
setPointerSnapToApplied directly totargetViewpointerSettings.- Parameters:
- pointerSnapTo- New pointerSnapTo value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getPointerSnapToApplied directly totargetViewpointerSettings.- Returns:
- Current pointerSnapTo value. Default value is null
- See Also:
 
- 
setShowActionButtonShould thetargetViewaction buttonbe shown for this step?If no value is provided it will be defaulted to truewhenautoCompleteisnot falseand any of the following are true:- actionTypeis "click"
- actionType is "mouseDown"
- actionType is "doubleClick"
- actionType is "rightClick"
- actionType is "menuItemOpen"
- actionType is "menuItemSelect"
- actionType is "change" and an expectedValueis provided
- a dropTargetis provided
 If no value is provided and autoComplete is falsebut auto completion would normally occur (i.e. actionType "click", "change" with expectedValue, etc.) then the action button is shown but is disabled until the expected action is completed at which time the button is enabled so the user can continue.- Parameters:
- showActionButton- New showActionButton value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getShowActionButtonShould thetargetViewaction buttonbe shown for this step?If no value is provided it will be defaulted to truewhenautoCompleteisnot falseand any of the following are true:- actionTypeis "click"
- actionType is "mouseDown"
- actionType is "doubleClick"
- actionType is "rightClick"
- actionType is "menuItemOpen"
- actionType is "menuItemSelect"
- actionType is "change" and an expectedValueis provided
- a dropTargetis provided
 If no value is provided and autoComplete is falsebut auto completion would normally occur (i.e. actionType "click", "change" with expectedValue, etc.) then the action button is shown but is disabled until the expected action is completed at which time the button is enabled so the user can continue.- Returns:
- Current showActionButton value. Default value is null
 
- 
setShowArrowFor a step with anactiona large arrow shows to indicate the target or direction of required action. SettingshowArrowtofalsesuppresses the display of the arrow. Note that the tour window is shown as if the arrow were there.ShowPointertakes precedence overshowArrow:true.- Parameters:
- showArrow- New showArrow value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getShowArrowFor a step with anactiona large arrow shows to indicate the target or direction of required action. SettingshowArrowtofalsesuppresses the display of the arrow. Note that the tour window is shown as if the arrow were there.ShowPointertakes precedence overshowArrow:true.- Returns:
- Current showArrow value. Default value is null
- See Also:
 
- 
setShowCancelButtonShould thetargetViewcancel buttonbe shown for this step?If no value is provided it will be defaulted to trueunless this step is the last step in the tour.- Parameters:
- showCancelButton- New showCancelButton value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getShowCancelButtonShould thetargetViewcancel buttonbe shown for this step?If no value is provided it will be defaulted to trueunless this step is the last step in the tour.- Returns:
- Current showCancelButton value. Default value is null
 
- 
setShowInputValidationMessagepublic TourStep setShowInputValidationMessage(Boolean showInputValidationMessage) throws IllegalStateException ShouldinputValidationNotifyMessagebe shown as detailed inTourInputValidationMode? Defaults fromTour.showInputValidationMessageif not set.If set to falsereporting messages to the user are suppressed and thereforeTour.notifyValidationMessage()will not be called.- Parameters:
- showInputValidationMessage- New showInputValidationMessage value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getShowInputValidationMessageShouldinputValidationNotifyMessagebe shown as detailed inTourInputValidationMode? Defaults fromTour.showInputValidationMessageif not set.If set to falsereporting messages to the user are suppressed and thereforeTour.notifyValidationMessage()will not be called.- Returns:
- Current showInputValidationMessage value. Default value is null
 
- 
setShowOutlineShould the target(s) be outlined? Defaults totrueinTour.mode:"tutorial".- Parameters:
- showOutline- New showOutline value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getShowOutlineShould the target(s) be outlined? Defaults totrueinTour.mode:"tutorial".- Returns:
- Current showOutline value. Default value is null
- See Also:
 
- 
setShowPointer- Parameters:
- showPointer- New showPointer value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getShowPointer- Returns:
- Current showPointer value. Default value is null
- See Also:
 
- 
setTargetComponent that is the target of this step. The interaction for this step is indicated inactionType. For actions that need multiple targets, this target is the primary one.Target may be specified as a GlobalIdfor a Component or FormItem, or as aAutoTestLocatorfor an element.- Parameters:
- target- New target value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getTargetComponent that is the target of this step. The interaction for this step is indicated inactionType. For actions that need multiple targets, this target is the primary one.Target may be specified as a GlobalIdfor a Component or FormItem, or as aAutoTestLocatorfor an element.- Returns:
- Current target value. Default value is null
 
- 
getTargetViewAutomatically generated view (typically a TourWindow) to show for tour step.The following passthroughsapply:- pointerSnapTofor the- Canvas.pointerSettings
- showCancelButtonfor the- TourWindow.showCancelButton
- cancelButtonTitlefor the- TourWindow.cancelButtonTitle
- actionButtonTitlefor the- TourWindow.actionButtonTitle
 This component is an AutoChild named "targetView". For an overview of how to use and configure AutoChildren, see Using AutoChildren.- Overrides:
- getTargetViewin class- UserTask
- Returns:
- Current targetView value. Default value is null
- Throws:
- IllegalStateException- if the underlying component has not yet been created.
 
- 
setTargetViewConstructorThe name of the widget class (as a string) to use for the target view.- Parameters:
- targetViewConstructor- New targetViewConstructor value. Default value is "TourWindow"
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
 
- 
getTargetViewConstructorThe name of the widget class (as a string) to use for the target view.- Returns:
- Current targetViewConstructor value. Default value is "TourWindow"
 
- 
setTargetViewDefaultsDefaults for thetargetViewautoChild.- Parameters:
- targetViewDefaults- New targetViewDefaults value. Default value is {...}
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getTargetViewDefaultsDefaults for thetargetViewautoChild.- Returns:
- Current targetViewDefaults value. Default value is {...}
 
- 
setTitleTitle for the Window.- Parameters:
- title- New title value. Default value is null
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getTitleTitle for the Window.- Returns:
- Current title value. Default value is null
- See Also:
 
- 
setWindowDefaultsDefaults for thetargetViewautoChild. These defaults are applied afterTour.windowDefaultsif any.- Parameters:
- windowDefaults- New windowDefaults value. Default value is {...}
- Returns:
- TourStepinstance, for chaining setter calls
- Throws:
- IllegalStateException- this property cannot be changed after the underlying component has been created
- See Also:
 
- 
getWindowDefaultsDefaults for thetargetViewautoChild. These defaults are applied afterTour.windowDefaultsif any.- Returns:
- Current windowDefaults value. Default value is {...}
 
 
-