Język

AutomationElement.GetClickablePoint Metoda

Definicja

Pobiera punkt, AutomationElement 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

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

Wyjątki

Nie ma punktu, który można kliknąć.

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

Przykłady

Poniższy kod pobiera punkt, który można kliknąć 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 programowo widoczny 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 zaciemniany 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ć klikalne. Na przykład okno nie jest klikalne, jeśli okno zawierające jest całkowicie przezroczyste. Kliknięcia myszy będą klikane 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 dotyczących kontrolek.

Dotyczy

Zobacz też