OneStreamAutoLibrary.WindowsUIHelpers 2026.1.16.1

WindowsUIHelpers

A cross-platform library for Windows desktop application automation using WinAppDriver and Appium, targeting .NET Framework 4.8, .NET Standard 2.0, and .NET 8. This library provides reusable page objects, components, and helpers for building maintainable desktop automation tests for Windows applications.

Integration

WindowsUIHelpers is designed to be used by:

• Windows Desktop Test Projects - For WinAppDriver-based desktop automation
• Hybrid Test Projects - Combining web and desktop automation

WindowsUIHelpers depends on:

• SeleniumHelpers - Selenium/Appium WebDriver infrastructure and automation base classes
• CommonHelpers - Shared utilities, logging interfaces (ITestLogger), reporting, and common infrastructure

This library provides Windows desktop UI page objects and components that can be integrated with any .NET test framework (xUnit, NUnit, MSTest).

Features

• Page Object Model (POM):
  Structured, maintainable page objects for Windows desktop UI automation

• Rich Component Library:
  Pre-built components for common Windows UI elements:

  • ButtonComponent - Button interactions
  • TextBoxComponent - Text input operations
  • ComboBoxComponent - Dropdown/combo box operations
  • TreeViewComponent - Tree navigation and selection
  • PropertyGridComponent - Property grid interactions
  • WindowComponent - Window-level operations
  • BaseComponent - Base class for custom components

• Common Page Objects:
  Ready-to-use page objects for common scenarios:

  • LoginPage - Login page automation
  • FileExplorerPage - Windows File Explorer interactions
  • NavigationPanePage - Application navigation
  • SaveAsDialogHelper - Save file dialog automation
  • OpenFileDialogHelper - Open file dialog automation

• Domain-Specific Pages:
  Specialized page objects for business applications:

  • DimensionLibraryPage - Dimension management
  • LoadExtractPage - Data load/extract operations

• ITestLogger Integration:
  Built-in logging support for page-level actions and diagnostics

• Telerik Test Framework Support:
  For desktop automation

Prerequisites

• .NET Framework 4.8, .NET Standard 2.0, or .NET 8
• SeleniumHelpers - Selenium/Appium WebDriver infrastructure
• CommonHelpers - Shared utilities and logging
• Telerik Test Framework(https://www.telerik.com/teststudio/testing-framework/download)

Installation

Add the library to your project:

dotnet add package WindowsUIHelpers

Usage Examples

using ArtOfTest.WebAii.Wpf; using WindowsUIHelpers.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");

Project Structure

WindowsUIHelpers/ ├── Components/ │ ├── BaseComponent.cs # Base class for all components │ ├── ButtonComponent.cs # Button interactions │ └── ComboBoxComponent.cs # Dropdown operations │ ├── PageObjects/ │ └── CommonWindows/ │ └── LoginPage.cs # Login page object └── README.md

Dependencies

This library depends on:

• SeleniumHelpers - Provides:

  • Selenium/Appium WebDriver infrastructure
  • Browser and application driver management
  • Screenshot functionality
  • WebDriver extensions and utilities

• CommonHelpers - Provides:

  • ITestLogger - Logging interface for page objects
  • Shared utilities and infrastructure
  • File system helpers
  • Reporting helpers

• Telerik Test Framework Provides:

• Windows Automation