TestResults.io
  • What is TestResults.io
  • System Architecture
  • Regulated Markets
    • Health Care Industry
    • Financial Services Industry
  • What's new?
    • Update Instruction
      • Update of the Designer extension in Visual Studio
      • Update the Execution Engine
      • Update the Base- and Environment Models
    • Migration to new project file
  • Designer
    • Overview
    • First Steps
    • Installation
    • TestResults.io solution
    • The development environment
      • Tool Window Overview
        • Test Environments
          • Steps to configure a SUT VM
          • How to access files on the system under test
        • Remote Viewer
          • Control Mode
          • Capture Mode
          • Screen Editor
          • Capture Single Image
        • Screen Explorer
        • Test Case Designer
        • Image Explorer
        • API Testing
        • TestResults.io options
          • Engines
          • Servers
    • Test Cases
      • Adding Test Cases
      • Test Case structure
      • Simple Test Case (Example)
      • Executing your Test Case
      • Generating Test Containers
      • Publishing Test Cases
      • Execution Variables
    • Software Models
      • Adding SW Models
      • Referencing the Model in the Test Case
      • Generating Test Containers
      • Publishing SW Models
      • Screens and Screen Elements
        • Tables
        • Visual Sense
        • Custom Screen Elements
    • Installers
      • Adding Installers
      • Generating Test Containers
      • Publishing Installers
    • Automation Framework Reference
      • Attributes
      • Enumerations
      • Filters
        • IImageFilter Interface
        • Select
        • Resize
      • GlobalEngineParameters
      • ImageDetectionParameters
      • ImageReference
      • Interfaces
        • ITester Interface
          • ITester Methods
          • ITester Properties
        • ITestee Interface
          • ITestee Methods
        • IConnections Interface
          • IConnections Methods
          • IConnections Properties
        • IDebug Interface
        • IEngineResult
        • IHelpers Interface
        • IImageHelper Interface
          • IImageHelper Methods
        • IKeyboard Interface
          • IKeyboard Methods
        • IMouse Interface
          • IMouse Methods
          • IMouse Properties
        • IReport Interface
          • IReport Methods
        • ISUTConnection Interface
      • OcrEngineParameters
        • Best practise
        • IronOcrEngineParameters
        • LEADOcrEngineParameters
        • OcrEngineRelatedCharacters
        • OcrPreprocessingParameters
      • ResultRectangle
      • SutNotReadyException
      • TestStepAbortedException
    • FAQ
      • Two-factor authentication (2FA) and One Time Passwords (OTP)
      • Receive and verify Emails
      • Using Excel as test data source
      • Verify PDF Content
  • Portal
    • Overview
    • First Steps
    • User's Guide
      • Login
      • Projects
      • Dashboard
      • Test Cases
      • Software & Environments
      • Test Sets
      • Job Queue
      • Management
      • Notifications Summary
    • Automation Engineer's Guide
      • Test Automation Workflow
      • Automating a test case
      • Enabling Software & Environments
    • REST API Reference
      • Authentication
      • Projects
      • Test Sets
      • Test Cases
      • Test Plans
      • Test Reports
      • Files
      • Software
      • Environments
      • Untitled
      • Executions
      • Favorites
      • Statistics
      • User Management
      • Customer Management
      • Notifications
      • Configurations
      • Invoicing
  • Models
    • Overview
    • Base Model
      • BaseScreen
        • BaseScreen Properties
        • BaseScreen Methods
      • OnScreenElement
        • OnScreenElement Methods
        • OnScreenElement Properties
      • Primitives
        • Button
          • Button Methods
          • Button Properties
        • Checkbox
          • Checkbox Methods
        • ContextMenu
          • ContextMenu Methods
          • ContextMenu Properties
        • Dropdown
          • Dropdown Methods
          • Dropdown Properties
        • DropdownMenu
          • DropdownMenu Methods
          • DropdownMenu Properties
        • GenericScroller
          • GenericScroller Methods
          • GenericScroller Properties
        • HorizontalScroller
        • IconButton
          • IconButton Properties
        • Label
        • LabelWithButton
          • LabelWithButton Properties
        • LabelWithCheckbox
          • LabelWithCheckbox Properties
        • LabelWithValue
          • LabelWithValue Methods
          • LabelWithValue Properties
        • PwTextBox
          • PwTextBox Methods
        • TextBox
          • TextBox Methods
          • TextBox Properties
        • Tables and lists
          • Column
            • Column Methods
            • Column Properties
          • ItemList
            • ItemList Methods
            • ItemList Properties
          • Row
            • Row Methods
            • Row Properties
          • TableBase
            • TableBase Methods
            • TableBase Properties
        • LabelWithElementBase
          • LabelWithElementBase Properties
      • Enumerations
      • Extensions
        • EngineResultExtensions Methods
        • EnumExtensions Methods
        • ReportExtensions Methods
        • StringExtensions Methods
        • TesterConnectionExtensions Methods
        • TesterDebugExtensions Methods
        • TesterHelperExtensions Methods
        • TesterMouseExtensions Methods
        • TesterOnScreenElementExtensions
        • TesterSelectExtensions Methods
      • Helper Classes
        • BaseModelHelpers
          • BaseModelHelpers Methods
          • BaseModelHelpers Properties
        • Attributes for Designer
        • ListHelpers
      • Exceptions
        • ElementNotFoundException
        • InteractionFailedException
        • ScreenNotFoundException
      • Interfaces
        • IAppBasics Interface
          • IAppBasics Methods
          • IAppBasics Properties
        • IBrowser
        • ICommandLineWindow
        • IScroller Interface
          • IScroller Methods
          • IScroller Properties
        • ISutLocale Interface
          • ISutLocale Methods
          • ISutLocale Properties
        • ISystemHelpers
        • ISystemInteractions
        • IWindow
    • Environment Model
      • Windows
        • Screens
          • CmdWindow
            • CmdWindow Methods
            • CmdWindow Properties
          • FileDialog
            • FileDialog Methods
            • FileDialog Properties
          • FileExplorer
            • FileExplorer Properties
          • RunWindow
            • RunWindow Methods
            • RunWindow Properties
          • Window
            • Window Methods
            • Window Properties
        • SutLocale
          • SutLocale Methods
          • SutLocale Properties
        • SystemHelpers
          • SystemHelpers Methods
          • SystemHelpers Properties
        • SystemInteractions
        • WebBrowser
          • Browser
            • Browser Methods
            • Browser Properties
          • BrowserScroller
            • BrowserScroller Methods
            • BrowserScroller Properties
          • AuthenticationDialog
            • AuthenticationDialog Methods
            • AuthenticationDialog Properties
          • DownloadDialog
            • DownloadDialog Methods
            • DownloadDialog Properties
        • EnvironmentModel Enumerations
        • Interfaces
          • IWebAppBasics
            • IWebAppBasics Property
Powered by GitBook
On this page
  • Description
  • Dropdown Class
  • Constructors
  • Methods
  • Properties
  • Protected properties

Was this helpful?

  1. Models
  2. Base Model
  3. Primitives

Dropdown

PreviousContextMenu PropertiesNextDropdown Methods

Last updated 1 year ago

Was this helpful?

Description

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 .

Dropdown Class

Namespace: Progile.TRIO.BaseModel Assembly: Progile.TRIO.BaseModel (in Progile.TRIO.BaseModel.dll)

Inheritance Hierarchy:

Progile.TRIO.BaseModel.Dropdown

Constructors

Dropdown(IAppBasics, string, string, IImageFilter[ ])

Creates a new Dropdown instance, that can be found with a text search for dropdownLabelText within the provided filters.

Syntax:

public Dropdown(
	IAppBasics appBasics, 
	string displayName, 
	string dropdownLabelText, 
	params IImageFilter[] filters
)

Parameter

Description

appBasics

displayName

dropdownLabelText

[filters]

Dropdown(IAppBasics, string, ImageReference, bool, IImageFilter[ ])

Syntax:

public Dropdown(
	IAppBasics appBasics, 
	string displayName, 
	ImageReference imageReference, 
	bool useVisualSense, 
	params IImageFilter[] filters
)

Parameter

Description

appBasics

displayName

imageReference

useVisualSense

[filters]

Dropdown(IAppBasics, string, ImageReference, ImageReference, bool, IImageFilter[ ])

Syntax:

public Dropdown(
	IAppBasics appBasics,
	string displayName,
	ImageReference imageReference,
	ImageReference buttonImage, 
	bool useVisualSense,
	params IImageFilter[] filters
)

Parameter

Description

appBasics

displayName

imageReference

buttonImage

useVisualSense

[filters]

Methods

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.

Properties

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

Protected properties

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.

Progile.TRIO.BaseModel.IAppBasics
AppBasics
BaseScreen
testerinterface
String
String
IImageFilter
Select
Progile.TRIO.BaseModel.IAppBasics
AppBasics
BaseScreen
testerinterface
String
Boolean
IImageFilter
Select
Progile.TRIO.BaseModel.IAppBasics
AppBasics
BaseScreen
testerinterface
String
ImageReference
Boolean
IImageFilter
Select
TestStepAbortedException
TestStepAbortedException
TestStepAbortedException
TextBox
TextBox
TextBox
Button
ItemList
Scroller
Object
Progile.TRIO.BaseModel.OnScreenElement
Textbox
Textbox
ImageReference
ImageReference
Hotspot
Hotspot
Hotspot
Hotspot
Hotspot
Hotspot
BlurKernelForDetectChanges
DropdownListImageParas
DropdownListOcrParas
ListBorder
MoveMouseListAfterOpen
SearchRectangleForList
TextBox
ToleranceForDetectChanges
DropdownButton
TextBox.TextBoxOcrParas
AppBasic.Window
OpenDropdownList
SelectImage
SelectOnScreenElement
SelectValue
VerifySelectedValue
VerifyValueInList