【Pywinauto库】12.4 pywinauto.uia_element_info后端内部实施模块

于处理UI元素的类的实现（基于UI自动化API）

class pywinauto.uia_element_info.UIAElementInfo(handle_or_elem=None, cache_enable=False)
功能：基于IUIAutomation API的UI元素包装器，用于处理现代Windows应用程序的UI自动化

构造函数参数：

• handle_or_elem：可选参数，可以是窗口句柄或现有的AutomationElement对象
• cache_enable：是否启用缓存，默认为False

主要属性和方法：

• automation_id
  功能：返回元素的AutomationId，这是UI自动化中元素的唯一标识符

• children(**kwargs)
  功能：返回元素的直接子元素列表
  参数kwargs：支持按进程、class_name、control_type、content_only或title等条件过滤列表

• class_name
  功能：返回元素的类名

• control_id
  功能：如果元素有句柄，返回元素的ControlId

• control_type
  功能：返回元素的控件类型

• descendants(**kwargs)
  功能：返回元素的所有后代子元素列表
  参数kwargs：支持按进程、class_name、control_type、content_only和/或title等条件过滤

• dump_window()
  功能：将窗口属性转储为一组属性值

• element
  功能：返回AutomationElement实例

• enabled
  功能：检查元素是否启用

• framework_id
  功能：返回元素的FrameworkId

• classmethod from_point(x, y)
  功能：类方法，根据屏幕坐标(x, y)获取该位置的UI元素

• handle
  功能：返回元素的句柄

• iter_children(**kwargs)
  功能：返回元素直接子元素的生成器
  参数kwargs：支持按进程、class_name、control_type、content_only或title等条件过滤

• name
  功能：返回元素的名称

• parent
  功能：返回元素的父元素

• process_id
  功能：返回元素的进程ID

• rectangle
  功能：返回元素的矩形区域

• rich_text
  功能：返回元素的富文本内容

• runtime_id
  功能：返回运行时ID（可哈希值，但每次运行可能不同）

• set_cache_strategy(cached=None)
  功能：为常用属性设置缓存策略

• classmethod top_from_point(x, y)
  功能：类方法，获取指定屏幕坐标处的顶层UI元素

• visible
  功能：检查元素是否可见

模块函数：
pywinauto.uia_element_info.elements_from_uia_array(ptrs, cache_enable=False)
功能：从IUIAutomationElementArray构建UIAElementInfo元素列表
参数：

• ptrs：IUIAutomationElementArray指针
• cache_enable：是否启用缓存，默认为False

这个类专门用于处理基于Microsoft UI Automation API的现代UI元素，特别适用于WPF、WinForms、Store Apps等现代Windows应用程序的自动化测试。