SetLocationForNextDialog Method
Syntax
Engine.SetLocationForNextDialog ( locationLookupString, elementAtLocation, selectionStart, selectionLength)
Purpose
Sets the location of the control in a dialog box that edits the property you specify. When you launch the dialog box again, the control associated with the location is selected and highlighted. The following methods launch dialog boxes that support this feature: PropertyObject.DisplayPropertiesDialog, Step.SpecifyModule, StepType.SpecifyModule, DisplayEditUserDialog, DisplayStepPropDialog, DisplaySequencePropDialog, DisplaySeqFilePropDialog, DisplayPreconditionDialog.
Parameters
locationLookupString As String
[In] Specifies the subproperty of the object whose corresponding control is highlighted in the dialog box the next time it is launched.
elementAtLocation As long
[In] Pass one of the following SearchElements constants to indicate which part of the property you want to highlight in the dialog box while editing: SearchElement_Name, SearchElement_Comment, SearchElement_StringValue, SearchElement_NumericValue, or SearchElement_BooleanValue. For example, to highlight a portion of a local variable comment, pass an empty string for the locationLookupString parameter and SearchElement_Comment for this parameter, then call PropertyObject.DisplayPropertiesDialog on the variable property.
selectionStart As long
[In] If the control that the locationLookupString and elementAtLocation parameters indicate is an Edit control, you can use this parameter to select a particular section of the text within the control when TestStand launches the dialog box. Pass the index of the character within the string where you want the selection to start.
selectionLength As long
[In] If the control that the locationLookupString and elementAtLocation parameters is an Edit control, you can use this parameter to select a particular section of the text within the control when TestStand launches the dialog box. Pass the numbers of characters, starting from the selStartIndex character, that you want the dialog box to select in the Edit control.