Implementera UI Automation Transform Control Pattern
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller riktlinjer och konventioner för att implementera ITransformProvider, inklusive information om egenskaper, metoder och händelser. Länkar till ytterligare referenser visas i slutet av ämnet.
Kontrollmönstret TransformPattern används för att stödja kontroller som kan flyttas, ändras eller roteras inom ett tvådimensionellt utrymme. Exempel på kontroller som implementerar det här kontrollmönstret finns i Kontrollmönstermappning för UI Automation-klienter.
Riktlinjer och konventioner för implementering
Observera följande riktlinjer och konventioner när du implementerar transformeringskontrollmönstret:
Stöd för det här kontrollmönstret är inte begränsat till objekt på skrivbordet. Det här kontrollmönstret måste också stödjas av underordnade objekt i ett containerobjekt om underordnade objekt kan flyttas, ändras eller roteras fritt inom containerns gränser.
Ett objekt kan inte flyttas, storleksändras eller roteras så att dess resulterande skärmplats skulle vara helt utanför koordinaterna för containern och därför inte tillgänglig för tangentbordet eller musen (till exempel när ett fönster på den översta nivån flyttas utanför skärmen eller ett underordnat objekt flyttas utanför gränserna för containerns visningsområde). I dessa fall placeras objektet så nära de begärda skärmkoordinaterna som möjligt med de övre eller vänstra koordinaterna åsidosatta för att ligga inom containergränserna.
Om ett objekt flyttas, storleksändras eller roteras helt utanför de kombinerade datorskärmkoordinaterna för system med flera bildskärmar placeras objektet på den primära övervakaren så nära de begärda koordinaterna som möjligt.
Alla parametrar och egenskapsvärden är absoluta och oberoende av nationella inställningar.
Nödvändiga medlemmar för ITransformProvider
Följande egenskaper och metoder krävs för att implementera ITransformProvider.
| Obligatoriska medlemmar | Medlemstyp | Kommentar |
|---|---|---|
| CanMove | Property | Ingen |
| CanResize | Property | Ingen |
| CanRotate | Property | Ingen |
| Move | Metod | Ingen |
| Resize | Metod | Ingen |
| Rotate | Metod | Ingen |
Det här kontrollmönstret har inga associerade händelser.
Undantag
Leverantörer måste utlösa följande undantag.
| Undantagstyp | Villkor |
|---|---|
| InvalidOperationException | Move - Om är CanMoveProperty falskt. |
| InvalidOperationException | Resize - Om är CanResizeProperty falskt. |
| InvalidOperationException | Rotate - Om är CanRotateProperty falskt. |