WindowsComponentsHelper 2025.12.18.1

WindowsComponentsHelper

Overview

WindowsComponentsHelper is a C# library designed to simplify and standardize UI automation for Windows desktop applications, including WPF and Silverlight, using the Telerik Test Studio (ArtOfTest) framework. It provides reusable component classes and page objects to interact with and validate Windows UI elements in a maintainable and extensible way.

Features

• Component Abstractions:
  Encapsulates common UI elements (Window, Button, TextBox, ComboBox, TreeView, PropertyGrid, etc.) as reusable components.
• Page Object Support:
  Encourages the Page Object Model for robust and maintainable test automation.
• Logging Integration:
  Built-in support for ITestLogger to enable detailed logging of actions and assertions.
• Timeouts and Waits:
  Consistent handling of timeouts and waits for UI element visibility, existence, and state.
• Assertion Helpers:
  Methods to assert the presence and visibility of windows and controls.
• Extensible Base Classes:
  All components inherit from a common BaseComponent for shared functionality.

Getting Started

Prerequisites

• .NET Framework 4.8
• Telerik Test Studio / ArtOfTest.WebAii
• Reference to CommonHelpers.Logging for logging support

Installation

-Add the WindowsComponentsHelper project to your solution and reference it from your test projects.

-ArtOfTest DLL Requirement Important: This package depends on ArtOfTest.WebAii and related Telerik Test Studio assemblies, which are not distributed via NuGet. You must obtain these DLLs from your licensed Test Studio installation and add them as references to your project. How to add ArtOfTest DLLs:

1. Install Telerik Test Studio or obtain the required DLLs (e.g., ArtOfTest.WebAii.dll, Telerik.WebAii.Controls.Xaml.dll) from your licensed installation.
2. In your Visual Studio project, right-click the project > Add Reference... > Browse to the DLL location and add them.
3. Ensure these DLLs are available on your build and test machines.

Example: This package requires manual references to ArtOfTest.WebAii and related DLLs from Telerik Test Studio. These are not included in the NuGet package and must be added to your project references manually.

Example Usage

using ArtOfTest.WebAii.Wpf; using WindowsComponentsHelper.Components; using CommonHelpers.Logging;

// Initialize logger and VisualFind (from your test setup) ITestLogger logger = new MyTestLogger();

VisualFind find = new VisualFind();

// Create a WindowComponent var windowComponent = new WindowComponent(find, logger);

// Find a window by header var mainWindow = windowComponent.GetWindowByHeader("Main Window Title");

// Assert window is visible windowComponent.AssertWindowExist(() ⇒ mainWindow, "Main window should be visible");

Components

• WindowComponent:
  Methods to find windows by header or caption, check visibility, and assert existence.
• ButtonComponent:
  Encapsulates button interactions (click, double-click, etc.).
• TextBoxComponent:
  Methods for setting and getting text in text boxes.
• ComboBoxComponent, TreeViewComponent, PropertyGridComponent, etc.:
  Specialized components for other common controls.

Logging

All components accept an ITestLogger implementation for action and assertion logging.
You can implement your own logger or use one from CommonHelpers.Logging.

Extending

To add new components:

1. Inherit from BaseComponent.
2. Implement control-specific methods.
3. Use the provided logging and wait utilities.

License

MIT License. See LICENSE for details.