GPALAutomationElement.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.
// =============================================================================
 
//extern alias mUIA;
//extern alias mUIAtypes;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Automation;
 
namespace GenerallyPositive.Application
{
    public class GPALAutomationElement : IGPALAutomationElement
    {
        public Application Application { get; internal set; }
        public Selector Selector { get; internal set; }
 
        //        public mUIA.System.Windows.Automation.AutomationElement Mae { get; set; }
        public AutomationElement Ae { get; set; }
        public IGPALElement Gae { get; set; }
        internal GPALAutomationElement ImageMatch { get; set; }
        public bool Selected
        {
            get
            {
                bool retVal = false;
                object pattern;
 
                if (null != Ae && true == Ae.TryGetCurrentPattern(SelectionItemPattern.Pattern, out pattern))
                    retVal = ((SelectionItemPattern)pattern).Current.IsSelected;
                else if (null != Ae && true == Ae.TryGetCurrentPattern(TogglePattern.Pattern, out pattern))
                    retVal = ToggleState.On == ((TogglePattern)pattern).Current.ToggleState;
                else
                    retVal = ContainerSaysSelected(Ae) || true == MsaaHelper.Selected(Application, Ae);
 
                return retVal;
            }
        }

        private static bool ContainerSaysSelected(AutomationElement element)
        {
            bool retVal = false;
            AutomationElement above = null == element ? null : TreeWalker.ControlViewWalker.GetParent(element);
 
            for (int level = 0; level < ContainerLevels && false == retVal && null != above; level++)
            {
                if (true == above.TryGetCurrentPattern(SelectionPattern.Pattern, out object pattern))
                    foreach (AutomationElement selected in ((SelectionPattern)pattern).Current.GetSelection())
                        if (true == element.Equals(selected))
                            retVal = true;
 
                above = ControlType.Window == above.Current.ControlType ? null : TreeWalker.ControlViewWalker.GetParent(above);
            }
 
            return retVal;
        }
 
        // how many parents up a selection container is looked for. The Explorer ribbon puts two elements
        // between a tab and the element holding the tabs, and nothing legitimately sits further away than this
        private const int ContainerLevels = 5;

        public bool? Checked
        {
            get
            {
                bool? retVal = null;
                object pattern;
 
                if (null != Ae && true == Ae.TryGetCurrentPattern(TogglePattern.Pattern, out pattern))
                {
                    ToggleState state = ((TogglePattern)pattern).Current.ToggleState;
 
                    if (ToggleState.On == state)
                        retVal = true;
                    else if (ToggleState.Off == state)
                        retVal = false;
                }
 
                return retVal;
            }
        }

        public bool Enabled => null != Ae && true == Ae.Current.IsEnabled;

        public bool Displayed => null != Ae && false == Ae.Current.IsOffscreen;

        public string Text => null == Ae ? string.Empty : (Ae.GetText() ?? string.Empty);

        public string TagName => null == Ae
            ? string.Empty
            : (Ae.Current.ControlType?.ProgrammaticName ?? string.Empty).Replace("ControlType.", "");

        public string Name => null == Ae ? string.Empty : (Ae.Current.Name ?? string.Empty);

        public System.Drawing.Point Location => null == Ae
            ? new System.Drawing.Point(0, 0)
            : new System.Drawing.Point((int)Ae.Current.BoundingRectangle.Left, (int)Ae.Current.BoundingRectangle.Top);

        public System.Drawing.Size Size => null == Ae
            ? new System.Drawing.Size(0, 0)
            : new System.Drawing.Size((int)Ae.Current.BoundingRectangle.Width, (int)Ae.Current.BoundingRectangle.Height);

        internal int MenuCommand { get; set; } = 0;
        internal IntPtr MenuWindow { get; set; } = IntPtr.Zero;
        internal GPALAutomationElement()
        {
 
        }
        internal GPALAutomationElement(AutomationElement automationElement = null, IGPALElement gPALElement = null/*, mUIA.System.Windows.Automation.AutomationElement managedAutomationElement = null*/)
        {
            Ae = automationElement;
            Gae = gPALElement;
//            Mae = managedAutomationElement;
        }
    }
}