AutomationElement.AutomationElementInformation.IsOffscreen 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取一个值，该值指示 UI 自动化元素是否在屏幕上可见。

public:
 property bool IsOffscreen { bool get(); };

public bool IsOffscreen { get; }

member this.IsOffscreen : bool

Public ReadOnly Property IsOffscreen As Boolean

Boolean

如果控件不可见，则为 true；否则为 false。

一个布尔值，指示元素是否完全滚动 (例如，列表框中的项位于容器对象的视区之外，) 或折叠 (例如树视图、菜单或最小化窗口中的项) 视图之外。

如果元素具有可单击的点，该点可能导致其聚焦，则即使元素的一部分处于屏幕外，该元素也会被视为在屏幕上。

属性的值不受其他窗口的遮挡或元素在特定监视器上是否可见的影响。

当 IsOffscreen 是 true, 滚动或折叠出视图的元素，但仍是最终用户对 UI 的感知的一部分时，可以通过简单的操作（如滚动或单击下拉控件）返回到视图中。

如果元素是最终用户根本无法察觉到的内容，或者称为“以编程方式隐藏” (例如，一个已关闭但应用程序缓存下划线对象的对话框) 则它应从元素树中删除，而不是将 IsOffscreen 的值设置为 true。

当值为 true 用于容器时，它也适用于 true 容器元素的后代。

有关详细信息，请参阅 IsOffscreenProperty。