GetLocationForNextDialog Method
Syntax
Engine.GetLocationForNextDialog ( locationLookupString, elementAtLocation, selectionStart, selectionLength, clearLoc = True)
Purpose
This method is typically used by a dialog box to get the information needed to select and highlight the control associated with the location previously specified by SetLocationForNextDialog.
Parameters
locationLookupString As String
[Out] Returns a lookup string that indicates the subproperty of the object whose corresponding control should be highlighted in the dialog box.
elementAtLocation As long
[Out] Returns one of the following SearchElements constants to indicate which part of the property to highlight in the dialog box: SearchElement_Name, SearchElement_Comment, SearchElement_StringValue, SearchElement_NumericValue, or SearchElement_BooleanValue.
selectionStart As long
[Out] If the control that the locationLookupString and elementAtLocation parameters indicate is an Edit control, use this parameter to determine a particular section of the text within the control that the dialog box should select. Returns the index of the character within the string where the selection should start.
selectionLength As long
[Out] If the control that the locationLookupString and elementAtLocation parameters indicates is an Edit control, use this parameter to determine a particular section of the text within the control that the dialog box should select. Returns the number of characters, starting from the selStartIndex character, that the dialog box should select in the Edit control.
clearLoc As Boolean
[In] Typically, calling this method clears the internal data in the engine for the location of the dialog box so that the next time this method is called, no location information is returned. To override this behavior, pass False for this parameter.
This parameter has a default value of True.