Implementowanie wzorca kontrolki przekształcania automatyzacji interfejsu użytkownika

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

W tym temacie przedstawiono wytyczne i konwencje implementowania ITransformProvider, w tym informacje o właściwościach, metodach i zdarzeniach. Linki do dodatkowych odwołań znajdują się na końcu tematu.

Wzorzec kontrolki TransformPattern służy do obsługi kontrolek, które można przenosić, zmieniać rozmiary lub obracać w przestrzeni dwuwymiarowej. Przykłady kontrolek implementujących ten wzorzec kontrolki można znaleźć w temacie Control Pattern Mapping for UI Automation Clients.

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolki Przekształć należy pamiętać o następujących wytycznych i konwencjach:

• Obsługa tego wzorca kontrolki nie jest ograniczona do obiektów na pulpicie. Ten wzorzec kontrolki musi być również obsługiwany przez elementy podrzędne obiektu kontenera, jeśli elementy podrzędne mogą być przenoszone, zmieniane lub obracane swobodnie w granicach kontenera.

• Nie można przenieść, zmienić rozmiaru lub obrócenia obiektu, tak aby jego wynikowa lokalizacja ekranu byłaby całkowicie poza współrzędnymi kontenera i w związku z tym niedostępna dla klawiatury lub myszy (na przykład gdy okno najwyższego poziomu zostanie przeniesione poza ekran lub obiekt podrzędny jest przenoszony poza granice widoku kontenera). W takich przypadkach obiekt jest umieszczany tak blisko żądanych współrzędnych ekranu, jak to możliwe, ze współrzędnymi u góry lub lewej przesłoniętą, aby mieścić się w granicach kontenera.

• W przypadku systemów z wieloma monitorami, jeśli obiekt jest przenoszony, zmieniany lub obracany całkowicie poza współrzędnymi połączonego ekranu pulpitu, obiekt jest umieszczany na monitorze podstawowym tak blisko żądanych współrzędnych, jak to możliwe.

• Wszystkie parametry i wartości właściwości są bezwzględne i niezależne od ustawień regionalnych.

Wymagani członkowie w przypadku ITransformProvider

Następujące właściwości i metody są wymagane do zaimplementowania ITransformProvider.

Wymagani członkowie	Typ członkostwa	Notatki
CanMove	Majątek	Żaden
CanResize	Majątek	Żaden
CanRotate	Majątek	Żaden
Move	Metoda	Żaden
Resize	Metoda	Żaden
Rotate	Metoda	Żaden

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

Dostawcy muszą zgłaszać następujące wyjątki.

Typ wyjątku	Warunek
InvalidOperationException	Move - Jeśli CanMoveProperty jest fałszywy.
InvalidOperationException	Resize - Jeśli CanResizeProperty jest fałszywy.
InvalidOperationException	Rotate - Jeśli CanRotateProperty jest fałszywy.

Zobacz także

• Omówienie wzorców automatyzacji kontrolek interfejsu użytkownika
• obsługują wzorce kontrolek w dostawcy automatyzacji interfejsu użytkownika
• Wzorce kontrolek automatyzacji interfejsu użytkownika dla klientów
• Omówienie drzewa automatyzacji interfejsu użytkownika
• Użyj buforowania w automatyzacji interfejsu użytkownika