Dropdown
Last updated
Was this helpful?
Last updated
Was this helpful?
The Dropdown class represents UI elements that are consisting of a text field (which can be editable or not) and a dropdown list that can be expanded by clicking in the text field or on an optional dropdown button. The dropdown list can include a scroller to scroll through the possible selections. The dropdown is identified on the screen by the of the image given in the constructor, which should be placed within the text field. If there is no closed border around the text field, this implementation will not support this dropdown type.
The Dropdown object uses a object, a object and an with an optional .
Namespace: Progile.TRIO.BaseModel Assembly: Progile.TRIO.BaseModel (in Progile.TRIO.BaseModel.dll)
Progile.TRIO.BaseModel.Dropdown
Creates a new Dropdown instance, that can be found with a text search for dropdownLabelText within the provided filters.
Syntax:
Parameter
Description
appBasics
displayName
dropdownLabelText
[filters]
Syntax:
Parameter
Description
appBasics
displayName
imageReference
useVisualSense
[filters]
Syntax:
Parameter
Description
appBasics
displayName
imageReference
buttonImage
useVisualSense
[filters]
Name
Description
Opens the dropdown list and returns a rectangle for the list (based on rectangle with changes after expanding dropdown list)
Opens the dropdown list and verifies if the provided value is present in the dropdown list (includes scrolling). Closes the dropdown list again.
Name
Description
The size of the kernel that is used to blur the images when detecting the changes to define the list rectangle. Size 0 means no blur, a common value for moderate blurring is 8 (approx. the size of a character). Default: 0
The image detection parameters that are used to find an image entry in the dropdown list.
Width of the border of the list that will be cut away on all sides to remove a border from the image that is passed to the OCR algorithm. Default: 3
Determines whether the mouse should be moved in the middle of the dropdown list in order to focus the scroller of the list. Can cause problems with list entries that have tooltips. Default: false
The tolerance value for changes that shall be ignored when detecting the changes to define the list rectangle. Default 0.04
Name
Description
The dropdown button used to open the dropdownList. Either coming from provided buttonImage in Dropdown ctor or just the Textbox itself (works in most dropdowns).
Type:
The interface for the , that is available on every . Allows access to the and the application window.
Type: The name of the element that will be used for logging and reporting of exceptions (customer facing).
Type: The string that will be used to locate the Dropdown on the screen.
Type: [ ] Typically a filter indicating the area of interest for the text search.
Creates a new Dropdown instance. Dropdown will be defined by the visible closed border around the of the provided image. If an image for the Dropdown button is provided, it will be used to open the dropdown list, otherwise the dropdown is opened simply by clicking in the textbox.
Type:
The interface for the , that is available on every . Allows access to the and the application window.
Type: The name of the element that will be used for logging and reporting of exceptions (customer facing).
Type: The image that will be used to locate the Dropdown on the screen. The of the image must be set within the dropdown textbox.
Type: True if VisualSense should be used to find the element
Type: [ ] Typically a filter indicating the area of interest for the image search.
Creates a new Dropdown instance. Dropdown will be defined by the visible closed border around the of the provided image. If an image for the Dropdown button is provided, it will be used to open the dropdown list, otherwise the dropdown is opened simply by clicking in the textbox.
Type:
The interface for the , that is available on every . Allows access to the and the application window.
Type: The name of the element that will be used for logging and reporting of exceptions (customer facing).
Type: The image that will be used to locate the Dropdown on the screen. The of the image must be set within the dropdown textbox.
Type: The image that defines the dropdown button to expand the dropdown. For many dropdown simply clicking in the textbox expands the dropdown list, in this case the buttonImage can be left null.
Type: True if VisualSense should be used to find the element
Type: [ ] Typically a filter indicating the area of interest for the image search.
Opens the dropdown list, searches the imageReference in the list (incl. scrolling) and selects it. If the image cannot be found, throws a .
Opens the dropdown list, searches for the element in the list (incl. scrolling) and selects it. If the image cannot be found, throws a .
Opens the dropdown list, searches the text value in the list (incl. scrolling) and selects it. If the text cannot be found, throws a .
Verifies if the value that is currently set in the matches the expected value. If it doesn't, the value read from the is returned as the actualValue out parameter.
The OCR parameters that are used to find a text entry in the dropdown list. By default also this paras are used to verify a selected element, but can be set separately.
The search rectangle in which changes are detected to define the list rectangle. Default:
Textbox of the dropdown. Is also used to define the dropdown list. Rectangle of TextBox is defined when first used by visible closed border around the of the provided image.