UITestControl-Klasse

Diese Klasse bietet die Möglichkeit, Steuerelemente auf einer Benutzeroberfläche zu suchen.Sie stellt für die Steuerelemente verschiedener Technologien generische Eigenschaften und Methoden bereit.

Vererbungshierarchie

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

Namespace:  Microsoft.VisualStudio.TestTools.UITesting
Assembly:  Microsoft.VisualStudio.TestTools.UITesting (in Microsoft.VisualStudio.TestTools.UITesting.dll)

Syntax

'Declaration
<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

Der UITestControl-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	UITestControl()	Initialisiert eine neue Instanz der UITestControl-Klasse.
	UITestControl(UITestControl)	Initialisiert eine neue Instanz der UITestControl-Klasse und gibt den Container zum Suchen von Steuerelementen an.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	BoundingRectangle	Ruft das umgebende Rechteck für dieses Steuerelement ab.
	ClassName	Ruft den Klassennamen für dieses Steuerelement ab.
	Container	Ruft den Container dieses UITestControl-Elements ab oder legt ihn fest.
	ControlType	Ruft den Typ des Benutzeroberflächen-Steuerelements ab.
	Desktop	Ruft das Benutzeroberflächen-Steuerelement für den Desktop ab.
	Enabled	Ruft einen Wert ab, der angibt, ob dieses Steuerelement aktiviert ist.
	Exists	Ruft einen Wert ab, der angibt, ob dieses Steuerelement in der Benutzeroberfläche vorhanden ist.
	FilterProperties	Ruft die Auflistung von Eigenschaft-Wert-Paaren ab, die für die eindeutige Bestimmung eines Steuerelements verwendet wird.
	FriendlyName	Ruft den Namen dieses Steuerelements ab, das in der Benutzeroberfläche verwendet werden soll.
	HasFocus	Ruft einen Wert ab, der angibt, ob dieses Steuerelement gegenwärtig in der Benutzeroberfläche den Fokus besitzt.
	Height	Ruft die Höhe des Steuerelements ab.
	IsTopParent	Ruft einen Wert ab, der angibt, ob dieses Steuerelement das Element der obersten Ebene ist.
	Left	Ruft die x-Koordinate für den linken Rand des Steuerelements ab.
	Name	Ruft den Namen dieses Steuerelements ab.
	NativeElement	Ruft das systemeigene Technologieelement ab, das diesem Steuerelement entspricht.
	SearchConfigurations	Ruft die Suchkonfigurationen ab oder legt sie fest.
	SearchProperties	Ruft die Auflistung von Eigenschaft-Wert-Paaren ab, die zur Identifizierung eines Steuerelements verwendet wird.
	SearchPropertiesSetExplicitly	Ruft einen Wert ab, der angibt, ob die Sucheigenschaften für dieses Steuerelement vom Benutzer in der Benutzeroberfläche festgelegt wurden.
	State	Ruft den Zustand des Steuerelements ab.
	TechnologyName	Ruft das Technologieframework für die Implementierung dieses Steuerelements ab, oder legt es fest.
	Top	Ruft die X-Koordinate des oberen Rands des Steuerelements ab.
	TopParent	Ruft das übergeordnete Element dieses Steuerelements auf der obersten Ebene ab.
	Width	Ruft die Breite des Steuerelements ab.
	WindowHandle	Ruft das Fensterhandle für dieses Steuerelement ab.
	WindowTitles	Ruft eine Auflistung mit den Fenstertiteln des Fensters der obersten Ebene ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CaptureImage	Zeichnet das Bild des UITestControl-Elements auf.Das UITestControl-Element muss auf dem Bildschirm vorhanden sein.
	CopyFrom	Erstellt ein UITestControl-Objekt, das auf das gleiche Element der Benutzeroberfläche wie das ursprüngliche UITestControl-Objekt verweist.
	DrawHighlight	Hebt das Steuerelement hervor.
	EnsureClickable()	Führt in der Benutzeroberfläche einen Bildlauf durch, um sicherzustellen, dass das Steuerelement durch Klicken aktivierbar ist.
	EnsureClickable(Point)	Führt in der Benutzeroberfläche einen Bildlauf bis zu einem bestimmten Punkt durch, um sicherzustellen, dass das Steuerelement durch Klicken aktivierbar ist.
	Equals	Bestimmt, ob die angegebene UITestControl und die aktuelle UITestControl gleich sind. (Überschreibt Object.Equals(Object).)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	Find	Sucht das UITestControl.
	FindMatchingControls	Gibt eine Auflistung aller UITestControl-Elemente zurück, die den angegebenen SearchProperties und FilterProperties entsprechen.
	GetChildren	Gibt eine Auflistung aller untergeordneten Elemente der ersten Ebene des aktuellen UITestControl zurück.
	GetClickablePoint	Gibt auf dem Steuerelement einen durch Klicken aktivierbaren Punkt zurück.
	GetHashCode	Gibt einen eindeutigen Wert zurück, der die aktuelle UITestControl-Instanz darstellt. (Überschreibt Object.GetHashCode().)
	GetParent	Gibt das übergeordnete Element des aktuellen UITestControl-Elements zurück.
	GetProperty	Ruft den Wert der angegebenen Eigenschaft ab.
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetUITestControlsForSearch	Gibt ein Array von UITestControl-Objekten zurück, die für die Suche verwendet werden.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	SetFocus	Legt den Tastaturfokus auf das UITestControl-Element fest.
	SetProperty	Legt den Wert einer angegebenen Eigenschaft fest.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle UITestControl-Element darstellt. (Überschreibt Object.ToString().)
	TryFind	Versucht, das Steuerelement auf der Benutzeroberfläche suchen.
	TryGetClickablePoint	Gibt einen durch Klicken aktivierbaren Punkt im UITestControl zurück.Wenn das Steuerelement nicht durch Klicken aktivierbar ist, gibt diese Methode false zurück.
	WaitForCondition<T>(T, Predicate<T>)	Blockiert den aktuellen Thread, bis die angegebene Bedingung erfüllt ist oder bis das Standardtimeout abläuft.
	WaitForCondition<T>(T, Predicate<T>, Int32)	Blockiert den aktuellen Thread, bis die angegebene Bedingung erfüllt ist oder bis das angegebene Timeout abläuft.
	WaitForControlCondition(Predicate<UITestControl>)	Blockiert den aktuellen Thread, bis dieses Steuerelement die angegebene Bedingung erfüllt oder bis das Standardtimeout abläuft.
	WaitForControlCondition(Predicate<UITestControl>, Int32)	Blockiert den aktuellen Thread, bis dieses Steuerelement die angegebene Bedingung erfüllt oder bis das angegebene Timeout abläuft.
	WaitForControlEnabled()	Blockiert den aktuellen Thread, bis dieses Steuerelement aktiviert ist oder bis das Standardtimeout abläuft.
	WaitForControlEnabled(Int32)	Blockiert den aktuellen Thread, bis dieses Steuerelement aktiviert ist oder bis das angegebene Timeout abläuft.
	WaitForControlExist()	Blockiert den aktuellen Thread, bis dieses Steuerelement in der Benutzeroberfläche vorhanden ist oder bis das Standardtimeout abläuft.
	WaitForControlExist(Int32)	Blockiert den aktuellen Thread, bis dieses Steuerelement in der Benutzeroberfläche vorhanden ist oder bis das angegebene Timeout abläuft.
	WaitForControlNotExist()	Blockiert den aktuellen Thread, bis dieses Steuerelement nicht mehr in der Benutzeroberfläche ist, oder bis das standardmäßige Timeout läuft ab.
	WaitForControlNotExist(Int32)	Blockiert den aktuellen Thread, bis dieses Steuerelement nicht mehr in der Benutzeroberfläche vorhanden ist oder bis das angegebene Timeout abläuft.
	WaitForControlPropertyEqual(String, Object)	Blockiert den aktuellen Thread, bis die angegebene Eigenschaft dieses Steuerelements dem angegebenen Wert entspricht oder bis das Standardtimeout abläuft.
	WaitForControlPropertyEqual(String, Object, Int32)	Blockiert den aktuellen Thread, bis die angegebene Eigenschaft dieses Steuerelements dem angegebenen Wert entspricht oder bis das angegebene Timeout abläuft.
	WaitForControlPropertyNotEqual(String, Object)	Blockiert den aktuellen Thread, bis die angegebene Eigenschaft dieses Steuerelements nicht dem angegebenen Wert entspricht oder bis das Standardtimeout abläuft.
	WaitForControlPropertyNotEqual(String, Object, Int32)	Blockiert den aktuellen Thread, bis die angegebene Eigenschaft dieses Steuerelements nicht dem angegebenen Wert entspricht oder bis das angegebene Timeout abläuft.
	WaitForControlReady()	Blockiert den aktuellen Thread, bis für dieses Steuerelement Maus- oder Tastatureingaben vorgenommen werden können oder bis das Standardtimeout abläuft.
	WaitForControlReady(Int32)	Blockiert den aktuellen Thread, bis für dieses Steuerelement Maus- oder Tastatureingaben vorgenommen werden können oder bis das angegebene Timeout abläuft.

Zum Seitenanfang

Operatoren

	Name	Beschreibung
	Equality	Gibt an, ob zwei UITestControl-Instanzen gleich sind.
	Inequality	Gibt an, ob zwei UITestControl-Instanzen ungleich sind.

Zum Seitenanfang

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.VisualStudio.TestTools.UITesting-Namespace