Breaking changes

• Removed support for .NET Standard, .NET Core 3.1, .NET 5

Enhancements

• Added support for .NET 8
• Updated Dependencies
• Add screenshot to testresult for XML report (thanks @igorrecioh)
• Add delay after pressing keyboard modifiers (thanks @louislefevre)
• Added new flag to define usage of screenshots (thanks Igor Recio)
• Added nullable annotations (thanks @jonasdoerr)

Bug fixes

• Fixed very large combo boxes (thanks @tomersalem)

Breaking changes

• Removed support for .NET Framework below 4.8

Enhancements

• Added Support for .NET 5.0 and 6.0
• Allow to skip logging missing frames info
• Added support for some more properties in XPath
• Added MixedAttributeValue
• Made TryGetClickablePoint more resilend and added a Fallback to BoundingRectangle.Center
• Extended ConditionFactory (thanks @bence-nagy)

Bug fixes

• Fix mistype in RightDoubleClick mouse method (thanks @kungfux)
• Fixed Bug Alt+Tab in OverlayForm (thanks @erimeurer)

Breaking changes

• None

Enhancements

• Add params on Process.Start (thanks @brunofmeurer)
• Added .NET Core 3.1 Target Framework (thanks @torepaulsson)

Bug fixes

• Fixed GID Handle leak (thanks @ChrisZhang95)
• Fixed .NET Core issue were the MainWindowHandle is not refreshed (thanks @torepaulsson)

Breaking changes

• None

Enhancements

• Added ByFrameworkType condition
• Allow xpath to find unknown types by mapping them to custom
• Added support for Qt framework type
• Added support for WinForms spinner (thanks @ddeltasolutions)
• Added Capture.ScreensWithElement
• Added customization of InfoOverlay font (thanks @petrsapak)
• Added calendar support (thanks @ddeltasolutions)
• Added date time picker support (thanks @ddeltasolutions)
• Added support for large lists (thanks @ddeltasolutions)
• Added application CloseTimeout and killIfCloseFails flag
• Made the mouse movement speeds settable

Bug fixes

• Fixed null error in FrameworkId
• Fix moving the mouse by 0 distance
• Fixed search by AccessibilityRole

Introduction

This release combines all changes from the 2.x pre-release versions and also new features.
The main feature is the .NET Core/.NET Standard compatibility for FlaUI.Core and FlaUI.UIA3.

Breaking changes

• Renamed BasicAutomationElementBase to FrameworkAutomationElementBase
• Consistent naming for the *Id interfaces/classes (eg. IDockPatternProperties to IDockPatternPropertyIds)
• Reworked events
• The Find... methods not do not use Retry anymore, the developer himself needs to decide if he wants to use a retry or not.
• Moved DrawHighlight to extension methods so that they are fluent and can be made null-safe.
• Reworked Retry
  • New flag: throwOnTimeout - Defines if Retry should throw when the timeout is reached.
  • New flag: ignoreException - Defines if Retry should continue in case of an exception.
  • New flag: lastValueOnTimeout - Defines if Retry should return the last successful value when it gets to a timeout.
  • New flag: defaultOnTimeout - Defines if Retry should return the default value on a timeout.
  • New Property: timeoutMessage - Allows adding a custom message when a timeout occurs when retrying.
  • Renamed Retry.While to Retry.WhileTrue
  • Added new Retry methods: WhileNull, WhileNotNull, WhileEmpty, Retry.WhileFalse
  • Added a RetryResult object that is returned on the Retry methods which contains information about the execution of the current Retry
  • Added tests
• Moved AutomationElement one up in the namespace tree
• Made the As methods extension methods again
• Removed custom Point/Rectangle and use the one from System.Drawing
• Moved Capture into the Capturing namespace
• All FindIndexed are consistently renamed to FindAt
• Renamed Retry.Interval to Retry.DefaultInterval
• Renamed Retry.Timeout to Retry.DefaultTimeout

Enhancements

• .NET Core and Standard compatibility
• Added capture overlays (mouse and info bar)
• Added a video recorder (see Capturing)
• Updated the interop dlls
• Added missing features from .NET 4.7.1 in UIA2
• Added missing features from newer interop in UIA3
  • Transaction- and ConnectionTimeout
  • Selection2 pattern
  • New text attributes
  • New automation properties (CenterPoint, FillColor, ... see f2b444e for more)
  • FindWithOptions
  • New events
  • UIA3TextRange3
  • ConnectionRecoveryBehaviorOptions and CoalesceEventsOptions
  • MatchSubstring for property searching
• Code cleanups
• Added generic AsType
• Use UtcNow instead of Now for Retry
• Wait.UntilInputIsProcessed now has an optional timespan parameter
• Reworked OperationSystems a bit
• Retry, WaitWhileBusy, WaitWhilemainHandleIsMissing return a bool now to indicate success or failure
• Capture does not focus the element anymore before capturing as this could have side effects
• Added missing events
• Added TextRange3
• Made log levels configurable, added a logger where you can notify for logging events, added an NUnitProgressLogger which logs in real time to the nunit console
• Added WaitUntilClickable and WaitUntilEnabled
• Default value for ControlType (thanks to @lukasvogel)
• Implemented mouse drag from point to point
• Added a condition to search by a Framework Id (thanks to @SSHenninger)
• Added AnimationDuration to ComboBox
• Added a timeout message to Retry
• Added TextAttributeLibrary
• Added Retry.Search methods
• Added IsAvailable property
• Added .As<T> method
• Enhanced DataGrid support for WPF (thanks @sparerd)
• More documentation
• Added various fallbacks to Win32 methods when UIA fails (thanks @ddeltasolutions)
• Added Touch input support
• Exposed MovePixelsPerMillisecond and MovePixelsPerStep in Mouse
• Added IsChecked property for menu item (thanks @ddeltasolutions)

Bug fixes

• Added some sleeps to the mouse drag
• Made xpath searching more robust (thanks to @lukasvogel)
• Correctly use collapse in the expand pattern
• Fixed LabeledBy property
• Fixed null exception when getting the mouse cursor
• Fixed an issue that the mouse cursor was not set correctly on multi-monitor environments

Breaking changes

• All FindIndexed are consitently renamed to FindAt
• Renamed Retry.Interval to Retry.DefaultInterval
• Renamed Retry.Timeout to Retry.DefaultTimeout

Enhancements

• .NET Core and Standard compatibility
• Implemented the new UIA3 features
• Implemented mouse drag from point to point
• Added a condition to search by a Framework Id (thanks to @SSHenninger)
• Added tons of documentation
• Added AnimationDuration to ComboBox
• Added a timeout message to Retry
• Added TextAttributeLibrary
• Added Retry.Search methods
• Added IsAvailable property
• Added .As<T> method
• Enhanced DataGrid support for WPF (thanks @sparerd)

Bug fixes

• Correctly use collapse in the expand pattern
• Fixed LabeledBy property
• Fixed null exception when getting the mouse cursor
• Fixed an issue that the mouse cursor was not set correctly on multi-monitor environments

Breaking changes

• Added a RetryResult object that is returned on the Retry methods which contains information about the execution of the current Retry

Enhancements

• Added Capture.MainScreen
• Default value for ControlType (thanks to @lukasvogel)

Bug fixes

• Fixed capturing the mouse when scaling is used

Enhancements

• Updated VideoRecorder (separate settings, added xvid encoding)

Breaking changes

• Removed custom Point/Rectangle and use the one from System.Drawing
• Moved Capture into the Capturing namespace

Enhancements

• Added capture overlays (mouse and info bar)
• Added a video recorder (see Capturing)

Breaking changes

• Reworked events
• The find methods not do not use Retry anymore, the developer himself needs to decide if he wants to use the retry or not.
• Moved DrawHighlight to extension methods so that they are fluent and can be made null-safe.
• Renamed Retry.While to Retry.WhileTrue
• Moved AutomationElement one part below in its namespace
• Made the As methods extension methods again

Enhancements

• Added missing events
• Added TextRange3
• Made log levels configurable, added a logger where you can notify for logging events, added an NUnitProgressLogger which logs in real time to the nunit console
• Cleaned Retry, added tests for Retry
• Added new Retry methods WhileNull, WhileNotNull, WhileEmpty
• Added Retry.WhileFalse
• Added WaitUntilClickable and WaitUntilEnabled
• Added lastValueOnTimeout and defaultOnTimeout to Retry

Bug fixes

• Added some sleeps to the mouse drag