UITestControl 类

该类提供在用户界面上查找控件的功能。它提供跨多种技术的多个控件的通用属性和方法。

继承层次结构

System.Object
  Microsoft.VisualStudio.TestTools.UITesting.UITestControl
    Microsoft.VisualStudio.TestTools.UITesting.ApplicationUnderTest
    Microsoft.VisualStudio.TestTools.UITesting.HtmlControls.HtmlControl
    Microsoft.VisualStudio.TestTools.UITesting.WinControls.WinControl
    Microsoft.VisualStudio.TestTools.UITesting.WpfControls.WpfControl

命名空间：  Microsoft.VisualStudio.TestTools.UITesting
程序集：  Microsoft.VisualStudio.TestTools.UITesting（在 Microsoft.VisualStudio.TestTools.UITesting.dll 中）

语法

声明
<CLSCompliantAttribute(True)> _
Public Class UITestControl

[CLSCompliantAttribute(true)]
public class UITestControl

[CLSCompliantAttribute(true)]
public ref class UITestControl

[<CLSCompliantAttribute(true)>]
type UITestControl =  class end

public class UITestControl

UITestControl 类型公开以下成员。

构造函数

	名称	说明
	UITestControl()	初始化 UITestControl 类的新实例。
	UITestControl(UITestControl)	初始化 UITestControl 类的新实例，并指定容器以查找控件。

页首

属性

	名称	说明
	BoundingRectangle	获取此控件的边框。
	ClassName	获取此控件的类名。
	Container	获取或设置此 UITestControl 的容器。
	ControlType	获取 UI 控件的类型。
	Desktop	获取桌面 UI 控件。
	Enabled	获取一个值，该值指示是否启用此控件。
	Exists	获取一个值，该值指示此控件是否存在于用户界面中。
	FilterProperties	获取用于消除控件歧义的属性-值对集合。
	FriendlyName	获取该控件在用户接口中的名称。
	HasFocus	获取指示此控件当前是否在用户界面中有焦点的值。
	Height	获取控件的高度。
	IsTopParent	获取指示此控件是否是顶级元素的值。
	Left	获取控件的左边缘的x坐标。
	Name	获取此控件的名称。
	NativeElement	获取与此控件对应的本机技术元素。
	SearchConfigurations	获取或设置搜索配置。
	SearchProperties	获取用于标识控件的属性-值对集合。
	SearchPropertiesSetExplicitly	获取指示控件的查找属性是否在用户接口中被用户设定的值。
	State	获取控件的状态。
	TechnologyName	获取或设置实现此控件的技术框架。
	Top	获取控件上边缘的x坐标。
	TopParent	获取此控件的顶级父级。
	Width	获取控件的宽度。
	WindowHandle	获取此控件的窗口句柄。
	WindowTitles	获取顶层窗口的窗口标题的集合。

页首

方法

	名称	说明
	CaptureImage	捕获 UITestControl 的图像。 UITestControl 必须显示在屏幕上。
	CopyFrom	创建一个 UITestControl 对象，该对象与原始 UITestControl 引用相同的用户界面元素。
	DrawHighlight	突出显示控件。
	EnsureClickable()	滚动用户界面以确保控件可单击。
	EnsureClickable(Point)	将用户界面滚动到特定点，以确保控件可单击。
	Equals	确定指定的 UITestControl 是否等于当前的 UITestControl。 （重写 Object.Equals(Object)。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。）
	Find	查找 UITestControl。
	FindMatchingControls	返回与指定 SearchProperties 和 FilterProperties 匹配的所有 UITestControl 的集合。
	GetChildren	返回当前 UITestControl 的所有第一级子级的集合。
	GetClickablePoint	返回控件上可单击的点。
	GetHashCode	返回一个唯一值，表示当前 UITestControl 实例。 （重写 Object.GetHashCode()。）
	GetParent	返回当前 UITestControl 的父级。
	GetProperty	获取指定属性的值。
	GetType	获取当前实例的 Type。 （继承自 Object。）
	GetUITestControlsForSearch	返回将用于搜索的 UITestControl 对象的数组。
	MemberwiseClone	创建当前 Object 的浅表副本。 （继承自 Object。）
	SetFocus	将键盘焦点设置到 UITestControl。
	SetProperty	设置给定属性的值。
	ToString	返回表示当前 UITestControl 的字符串。 （重写 Object.ToString()。）
	TryFind	请在用户界面的控件。
	TryGetClickablePoint	返回 UITestControl 中的可单击点。如果不可单击该控件，则此方法返回 false。
	WaitForCondition<T>(T, Predicate<T>)	阻止当前线程，直到满足指定条件或直到默认超时时间已到。
	WaitForCondition<T>(T, Predicate<T>, Int32)	阻止当前线程，直到满足指定条件或直到指定的超时时间已到。
	WaitForControlCondition(Predicate<UITestControl>)	阻止当前线程，直到此控件满足指定条件或直到默认超时时间已到。
	WaitForControlCondition(Predicate<UITestControl>, Int32)	阻止当前线程，直到此控件满足指定条件或直到指定超时时间已到。
	WaitForControlEnabled()	阻止当前线程，直到启用此控件或直到默认超时时间已到。
	WaitForControlEnabled(Int32)	阻止当前线程，直到启用此控件或直到指定超时时间已到。
	WaitForControlExist()	阻止当前线程，直到用户界面中出现此控件，或直到默认超时时间已到。
	WaitForControlExist(Int32)	阻止当前线程，直到用户界面中出现此控件，或直到指定超时时间已到。
	WaitForControlNotExist()	阻止当前线程，直到此控件不再在用户界面中，或在默认超时过期。
	WaitForControlNotExist(Int32)	阻止当前线程，直到用户界面中不再存在此控件，或直到指定超时时间已到。
	WaitForControlPropertyEqual(String, Object)	阻止当前线程，直到此控件的指定属性等于指定值，或直到默认超时时间已到。
	WaitForControlPropertyEqual(String, Object, Int32)	阻止当前线程，直到此控件的指定属性等于指定值，或直到指定超时时间已到。
	WaitForControlPropertyNotEqual(String, Object)	阻止当前线程，直到此控件的指定属性不等于指定值，或直到默认超时时间已到。
	WaitForControlPropertyNotEqual(String, Object, Int32)	阻止当前线程，直到此控件的指定属性不等于指定值，或直到指定超时时间已到。
	WaitForControlReady()	阻止当前线程，直到此控件准备好接收受鼠标或键盘输入，或直到默认超时时间已到。
	WaitForControlReady(Int32)	阻止当前线程，直到此控件准备好接收受鼠标或键盘输入，或直到指定超时时间已到。

页首

运算符

	名称	说明
	Equality	指示两个 UITestControl 实例是否相等。
	Inequality	指示两个 UITestControl 实例是否不相等。

页首

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.VisualStudio.TestTools.UITesting 命名空间