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 的淺層複本 (Shallow Copy)。 (繼承自 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()	封鎖目前的執行緒，直到控制項不再顯示在使用者介面 (UI)，或直到預設逾時過期為止。
	WaitForControlNotExist(Int32)	封鎖目前的執行緒，直到此控制項不再出現在使用者介面中，或者指定的逾時過期為止。
	WaitForControlPropertyEqual(String, Object)	封鎖目前的執行緒，直到此控制項的指定屬性等於指定的值，或者預設的逾時過期為止。
	WaitForControlPropertyEqual(String, Object, Int32)	封鎖目前的執行緒，直到此控制項的指定屬性等於指定的值，或者指定的逾時過期為止。
	WaitForControlPropertyNotEqual(String, Object)	封鎖目前的執行緒，直到此控制項的指定屬性不等於指定的值，或者預設的逾時過期為止。
	WaitForControlPropertyNotEqual(String, Object, Int32)	封鎖目前的執行緒，直到此控制項的指定屬性不等於指定的值，或者指定的逾時過期為止。
	WaitForControlReady()	封鎖目前的執行緒，直到此控制項準備接收滑鼠或按鍵輸入，或者預設的逾時過期為止。
	WaitForControlReady(Int32)	封鎖目前的執行緒，直到此控制項準備接收滑鼠或按鍵輸入，或者指定的逾時過期為止。

回頁首

運算子

	名稱	說明
	Equality	指示兩個 UITestControl 執行個體是否相等。
	Inequality	指示兩個 UITestControl 執行個體是否不相等。

回頁首

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.TestTools.UITesting 命名空間