AutomationElement.GetClickablePoint Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Automation
Zestaw:
UIAutomationClient.dll

Pobiera punkt na AutomationElement obiekcie, który można kliknąć.

public:
 System::Windows::Point GetClickablePoint();
public System.Windows.Point GetClickablePoint ();
member this.GetClickablePoint : unit -> System.Windows.Point
Public Function GetClickablePoint () As Point

Zwraca

Point

Fizyczne współrzędne ekranu punktu, który może być używany przez klienta do kliknięcia tego elementu.

Wyjątki

NoClickablePointException

Nie ma punktu umożliwiającego klikanie.

ElementNotAvailableException

Interfejs użytkownika dla obiektu AutomationElement już nie istnieje.

Przykłady

Poniższy kod pobiera klikalny punkt dla kontrolki i przenosi kursor systemowy do tego punktu.

// 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))

Uwagi

Element AutomationElement nie jest klikalny, jeśli jest całkowicie zasłonięty przez inne okno.

Element AutomationElement jest klikalny, gdy spełnia wszystkie następujące warunki:

  • Jest on widoczny programowo i dostępny w drzewie automatyzacja interfejsu użytkownika.

  • Jest w pełni przewijany do widoku w kontenerze nadrzędnym, jeśli istnieje. Jeśli element jest przycięty, nie ma gwarancji, że można go kliknąć.

  • Element nie jest zasłonięty przez żaden inny element interfejsu użytkownika. Jeśli element jest częściowo zasłonięty przez jakiś element interfejsu użytkownika inny niż jego elementy nadrzędne, może nie być klikalny.

  • Okno zawierające element musi być możliwe do kliknięcia. Na przykład okno nie jest klikalne, jeśli okno zawierające jest całkowicie przezroczyste. Kliknięcie myszą spowoduje kliknięcie do okna poniżej, więc wszystkie kontrolki w oknie przezroczystym nie będą zwracać punktów klikalnych.

  • Jeśli element jest kontenerem (takim jak lista lub widok drzewa), musi mieć punkt, który po kliknięciu spowoduje fokus tła kontrolki. Jeśli każda część kontrolki kontenera jest zajęta przez element podrzędny, nie można jej klikać.

Nie ma gwarancji, że kontrolka zrobi wszystko po kliknięciu punktu zdefiniowanego jako możliwego do kliknięcia przez dostawcę automatyzacja interfejsu użytkownika. Rozważ użycie wzorców kontrolek zamiast tego do wykonywania akcji na kontrolkach.

Dotyczy

Zobacz też