ApplicationSettings.cs

// =============================================================================
// GPAL - Generally Positive Automation Library
// Copyright © 2026 Software Decisions, Inc. All rights reserved.
//
// This file is part of GPAL.
// Licensed under the Business Source License 1.1
//
// Primary development, architecture, and vision by Michael B. Vederman,
// CEO of Software Decisions, Inc., Texas.
//
// Internal development maintained privately.
// Public releases appear on GitHub: https://github.com/SoftwareDecisionsInc/GPAL.
//
// See LICENSE for full terms, including Additional Use Grant.
// =============================================================================
 
using System;
using System.Collections;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Automation;
using System.Windows.Forms;
using OpenQA.Selenium;
using static GenerallyPositive.Enums;
 
namespace GenerallyPositive.Application
{
    internal class ApplicationSettings
    {
        internal Application Application { get; set; }
        internal string ApplicationPath { get; set; }
        // name of this application instance, set by GPAL factory
        internal string Name { get; set;  }  = null;
 
        internal Process Process { get; set; } = null;
        // load images on a web page?
        internal bool LoadImages { get; set; } = false;
 
        // open pdf documents in external program?
        internal bool OpenPDFExternally { get; set; } = true;
        
        // open file save dialog
        internal bool PromptForDownload { get; set; } = true;
 
        internal string PlatformName { get; set; } = "Windows 10";
 
        internal bool Maximize { get; set; } = false;
 
        internal bool Minimize { get; set; } = false;
 
        internal Selector MySelector { get; set; } = null;
 
        internal AutomationElement RootAutomationElement { get; set; } = null;
        internal object ManagedRootAutomationElement { get; set; } = null;
 
        internal System.Windows.Forms.Form CurrentForm { get; set; } = null;
        internal int WaitForWindowTimeout { get; set; } = 10; // seconds
        internal bool UseHardware { get; set; } = false;    // instead of uiautomation, use hardware emulation
        internal bool NewInstance { get; set; } = false;    // launch rather than attach to a running copy
 
        // set by WithHiddenDesktop: the program runs on a Win32 desktop object of its own, which has its own
        // window set and its own input queue, so nothing it does reaches the screen the user is working on
        internal bool HiddenDesktop { get; set; } = false;
 
        // the desktop's name. Applications naming the same one share it, and one asking without a name gets
        // one of its own
        internal string HiddenDesktopName { get; set; } = GenerallyPositive.Browser.HiddenDesktop.DefaultName;
 
        // said once, when the program is opened there
        internal bool HiddenDesktopReported { get; set; } = false;
 
        // said once per application rather than on every action it turns down
        internal bool HiddenDesktopHardwareReported { get; set; } = false;
 
        // whether anything ever arrived on the desktop, checked once after the program is opened
        internal bool HiddenDesktopChecked { get; set; } = false;
        internal IntPtr LastWindowHandle { get; set; } = IntPtr.Zero;
 
        internal bool DeleteFileBeforeDownload { get; set; } = false;
 
        internal ArrayList Parameters 
        { 
            get; 
            set; 
        }
 
        internal ApplicationSettings(Application application)
        {
            Application = application;
            Parameters = new ArrayList();
        }
    }
}