AutomationElement.GetClickablePoint Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Punkt ab, auf den AutomationElement geklickt werden kann.
public:
System::Windows::Point GetClickablePoint();public System.Windows.Point GetClickablePoint();member this.GetClickablePoint : unit -> System.Windows.PointPublic Function GetClickablePoint () As PointGibt zurück
Die physischen Bildschirmkoordinaten eines Punkts, der von einem Client verwendet werden kann, um auf dieses Element zu klicken.
Ausnahmen
Es gibt keinen klickbaren Punkt.
Die Benutzeroberfläche für die AutomationElement nicht mehr vorhanden ist.
Beispiele
Der folgende Code ruft einen klickbaren Punkt für ein Steuerelement ab und verschiebt den Systemcursor zu diesem Punkt.
// element is an AutomationElement.
System.Windows.Point clickablePoint = element.GetClickablePoint();
System.Windows.Forms.Cursor.Position =
new System.Drawing.Point((int)clickablePoint.X, (int)clickablePoint.Y);
' element is an AutomationElement.
Dim clickablePoint As System.Windows.Point = element.GetClickablePoint()
System.Windows.Forms.Cursor.Position = New System.Drawing.Point(CInt(clickablePoint.X), CInt(clickablePoint.Y))
Hinweise
Eine AutomationElement Option kann nicht geklickt werden, wenn sie von einem anderen Fenster vollständig verdeckt wird.
Ein AutomationElement Klickbar, wenn er alle folgenden Bedingungen erfüllt:
Sie ist programmgesteuert sichtbar und mit der Benutzeroberflächenautomatisierung Struktur verfügbar.
Er wird vollständig in den übergeordneten Container eingescrollt, sofern vorhanden. Wenn das Element abgeschnitten wird, besteht keine Garantie dafür, dass es klickbar ist.
Das Element wird von keinem anderen UI-Element verdeckt. Wenn das Element teilweise von einem anderen UI-Element als seinen Vorgängern verdeckt wird, ist es möglicherweise nicht klickbar.
Das Fenster, das das Element enthält, muss selbst klickbar sein. Das Fenster kann beispielsweise nicht geklickt werden, wenn das enthaltende Fenster vollständig transparent ist. Mausklicks klicken durch das Fenster darunter, sodass alle Steuerelemente im transparenten Fenster keine klickbaren Punkte zurückgeben.
Wenn es sich bei dem Element um einen Container (z. B. eine Listen- oder Strukturansicht) handelt, muss es einen Punkt aufweisen, der dazu führt, dass der Hintergrund des Steuerelements fokussiert wird. Wenn jeder Teil des Containersteuerelements von einem untergeordneten Element belegt wird, kann er nicht geklickt werden.
Es gibt keine Garantie dafür, dass ein Steuerelement etwas tut, wenn auf einen Punkt geklickt wird, der durch den anbieter Benutzeroberflächenautomatisierung geklickt werden kann. Erwägen Sie stattdessen die Verwendung von Steuerelementmustern, um Aktionen für Steuerelemente auszuführen.
