Implementazione del pattern di controllo Transform di automazione interfaccia utente

  • Articolo

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono presentate le linee guida e le convenzioni per l'implementazione di ITransformProvider, incluse le informazioni relative a proprietà, metodi ed eventi. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il pattern di controllo TransformPattern viene usato per supportare i controlli che possono essere spostati, ridimensionati o ruotati in uno spazio bidimensionale. Per esempi di controlli che implementano questo pattern di controllo, vedere Control Pattern Mapping for UI Automation Clients.

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo Transform, tenere presenti le linee guida e le convenzioni seguenti:

  • Il supporto per questo pattern di controllo non è limitato agli oggetti sul desktop. Questo pattern di controllo deve essere supportato dagli elementi figlio di un oggetto contenitore se gli elementi figlio possono essere spostati, ridimensionati o ruotati all'interno dei limiti del contenitore.

  • Un oggetto non può essere spostato, ridimensionato o ruotato in modo che la posizione risultante sullo schermo potrebbe essere completamente esterna alle coordinate del relativo contenitore e pertanto inaccessibile per la tastiera o il mouse (ad esempio, quando una finestra di primo livello viene spostata fuori schermo o un oggetto figlio viene spostato fuori dai limiti del riquadro di visualizzazione del contenitore). In questi casi, l'oggetto viene posizionato il più vicino possibile alle coordinate richieste dello schermo rispetto alle coordinate in alto e a sinistra entro i limiti del contenitore.

  • Per sistemi con più monitor, se un oggetto viene spostato, ridimensionato o ruotato completamente al di fuori delle coordinate combinate dello schermo desktop, l'oggetto viene posizionato sul monitor principale il più vicino possibile alle coordinate richieste.

  • Tutti i parametri e i valori delle proprietà sono assoluti e indipendenti dalle impostazioni locali.

Membri obbligatori per ITransformProvider

Le proprietà e i metodi seguenti sono obbligatori per l'implementazione di ITransformProvider.

Membri obbligatori Tipo di membro Note
CanMove Proprietà None
CanResize Proprietà None
CanRotate Proprietà None
Move metodo None
Resize metodo None
Rotate metodo None

Questo pattern di controllo non è associato a eventi.

Eccezioni

I provider devono generare le eccezioni seguenti.

Tipo di eccezione Condizione
InvalidOperationException Move

- Se CanMoveProperty è false.
InvalidOperationException Resize

- Se CanResizeProperty è false.
InvalidOperationException Rotate

- Se CanRotateProperty è false.

Vedi anche