AutomationElement.GetClickablePoint Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает точку объекта AutomationElement, по которой можно щелкнуть указателем.
public:
System::Windows::Point GetClickablePoint();public System.Windows.Point GetClickablePoint ();member this.GetClickablePoint : unit -> System.Windows.PointPublic Function GetClickablePoint () As PointВозвращаемое значение
Физические координаты экрана точки, которые может использовать клиент, чтобы щелкнуть по данному элементу.
Исключения
Нет точки, на которую можно нажимать.
Пользовательский интерфейс для AutomationElement больше не существует.
Примеры
Следующий код извлекает нажатую точку для элемента управления и перемещает системный курсор на этот момент.
// 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))
Комментарии
Недоступен AutomationElement , если он полностью скрыт другим окном.
Элемент AutomationElement доступен для щелчка при выполнении всех следующих условий:
Она является программно видимой и доступной в дереве модель автоматизации пользовательского интерфейса.
Он полностью прокручивается в представление в родительском контейнере, если таковой имеется. Если элемент обрезается, нет никакой гарантии, что он доступен для щелчка.
Элемент не скрывается другими элементами пользовательского интерфейса. Если элемент частично скрыт некоторым элементом пользовательского интерфейса, кроме его предков, он может быть недоступен для щелчка.
Окно, содержащее элемент, должно быть доступны для щелчка. Например, окно невозможно щелкнуть, если содержащее окно полностью прозрачно. Щелчки мыши будут переходить к окну под ним, поэтому все элементы управления в прозрачном окне не будут возвращать точки, доступные для щелчка.
Если элемент является контейнером (например, представлением списка или дерева), он должен иметь точку, которая при щелчке приведет к тому, что фон элемента управления будет сосредоточен. Если каждая часть элемента управления контейнером занята дочерним элементом, он недоступен для щелчка.
При щелчке точки, определенной поставщиком модель автоматизации пользовательского интерфейса, не гарантируется, что элемент управления будет выполнять все действия. Вместо этого рекомендуется использовать шаблоны элементов управления для выполнения действий с элементами управления.