Udostępnij za pośrednictwem

Implementacja wzorca formantu przekształcania automatyzacji interfejsu użytkownika

  • Artykuł

Uwaga

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

W tym temacie przedstawiono wytyczne i konwencje implementacji 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 automatyzacja interfejsu użytkownika Clients (Mapowanie wzorca kontrolek dla klientów automatyzacja interfejsu użytkownika).

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.

Wymagane elementy członkowskie dla ITransformProvider

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

Wymagane elementy członkowskie Typ elementu członkowskiego Uwagi
CanMove Właściwości Brak
CanResize Właściwości Brak
CanRotate Właściwości Brak
Move Method Brak
Resize Method Brak
Rotate Method Brak

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

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

Typ wyjątku Stan
InvalidOperationException Move

- Jeśli wartość CanMoveProperty ma wartość false.
InvalidOperationException Resize

- Jeśli wartość CanResizeProperty ma wartość false.
InvalidOperationException Rotate

- Jeśli wartość CanRotateProperty ma wartość false.

Zobacz też