EazyE2E Configuration

EazyE2E provides the ability to configure various ways that the framework will function. Any of the values below can be placed in the application's app.config file in the <appSettings> section. Note that these values all act as overrides. If any of these values are not set, the default will be applied instead.

Example:

        <configuration>
            <appSettings>
                <add key="TimeBetweenMouseEvents" value="1000" />
            </appSettings>
        </configuration>

DoubleClickGap

Determines the gap (in milliseconds) inbetween double click events. Used in EzMouseFunctions class.

Type	Example	Default
int	<add key="DoubleClickGap" value="250"/>	500

FindElementTimeout

Note that this value is not currently being used.

Type	Example	Default
int	<add key="DoubleClickGap" value="250"/>	10000

ProcessWaitForExitTimeout

Tells the framework how long to wait (in milliseconds) for the process to exit before terminating it forcibly.

Type	Example	Default
int	<add key="ProcessWaitForExitTimeout" value="250"/>	1000

DefaultWindowStyle

Determines the state of the main window once the application is launched. Note that the value that this particular configuration item takes in is an enum based on System.Process.WindowStyle. See that page for the full list of values that can be accepted by this config value.

Type	Example	Default
System.Process.WindowStyle	<add key="DefaultWindowStyle" value="Maximized"/>	Normal

MaximumMemoryProfileTime

The maximum allowable time (in milliseconds) that EzPerformanceMonitor can profile for. If the time set when using EzPerformanceMonitor is greater than the config time, an exception will be thrown.

Type	Example	Default
int	<add key="MaximumMemoryProfileTime" value="600000"/>	int.MaxValue

TimeBetweenMouseEvents

The time in between mouse events (in milliseconds); used by EzMouseFunctions. This value is used to determine how much time inbetween various mouse events. For example, if you perform a left click followed by a scroll and TimeBetweenMouseEvents is 500, EazyE2E will wait 500 milliseconds (or half a second) in between the left click and the scroll. This is to help simulate an actual user using a mouse and to mimick how that user might actually use the mouse.

Type	Example	Default
int	<add key="TimeBetweenMouseEvents" value="1000"/>	100

AllowSearchingForDescendants

Determines whether or not to allow various methods in the EzElement class to search by descendant. The primary use case for disallowing searching by descendants is because searching for descendants is very inefficient and is generally not good practice.

Type	Example	Default
bool	<add key="AllowSearchingForDescendants" value="false"/>	true

ExposeBackingWindowsPatterns

Various EazyE2E classes use a backing automation pattern which can be exposed. Allowing exposure of the patterns allows for extension of the framework. If this value is set to false, the backing patterns will be null. See Microsoft documents on automation patterns

Type	Example	Default
bool	<add key="ExposeBackingWindowsPatterns" value="true"/>	false

AlwaysResetEzText

If this value is set to true, every time an EzText property is accessed, the values will be re-checked every time any of the properties on EzText are accessed. If this value is set to false, the values when the class is first instantiated will remain until the class is disposed.

Type	Example	Default
bool	<add key="AlwaysResetEzText" value="true"/>	false

TerminateExistingInstance

If this value is set to true, any existing instances of the application under test (when EzProcess is instantiated) will be terminated. If this value is set to false, any existing instances of the application under test will be left alone.

Type	Example	Default
bool	<add key="TerminateExistingInstance" value="true"/>	false