Condividi tramite

Implementazione del modello di controllo di trasformazione dell'automazione dell'interfaccia utente

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

Questo argomento presenta linee guida e convenzioni per l'implementazione di ITransformProvider, incluse informazioni su proprietà, metodi ed eventi. I collegamenti a riferimenti aggiuntivi sono elencati alla fine dell'argomento.

Il TransformPattern pattern di controllo viene usato per supportare controlli che possono essere spostati, ridimensionati o ruotati all'interno di uno spazio bidimensionale. Per esempi di controlli che implementano questo pattern di controllo, vedere Mapping dei criteri di controllo per i client di automazione interfaccia utente.

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 anche dagli elementi figlio di un oggetto contenitore se gli elementi figlio possono essere spostati, ridimensionati o ruotati liberamente entro i limiti del contenitore.

  • Un oggetto non può essere spostato, ridimensionato o ruotato in modo che la posizione dello schermo risultante sia completamente esterna alle coordinate del contenitore e quindi non accessibile alla tastiera o al mouse (ad esempio, quando una finestra di primo livello viene spostata fuori dallo schermo o un oggetto figlio viene spostato al di fuori dei limiti del riquadro di visualizzazione del contenitore). In questi casi, l'oggetto viene posizionato il più vicino possibile alle coordinate dello schermo richieste con le coordinate superiore o sinistra sottoposte a override all'interno dei limiti del contenitore.

  • Per i sistemi multi-monitor, se un oggetto viene spostato, ridimensionato o ruotato completamente all'esterno delle coordinate combinate dello schermo del desktop, l'oggetto viene posizionato sul monitor primario 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

Per l'implementazione ITransformProviderdi sono necessari i metodi e le proprietà seguenti.

Membri obbligatori Tipo di membro Note
CanMove Proprietà Nessuno
CanResize Proprietà Nessuno
CanRotate Proprietà Nessuno
Move Metodo Nessuno
Resize Metodo Nessuno
Rotate Metodo Nessuno

Questo pattern di controllo non ha eventi associati.

Eccezioni

I provider devono sollevare le eccezioni seguenti.

Tipo di eccezione Condizione
InvalidOperationException Move

- Se CanMoveProperty è falso.
InvalidOperationException Resize

- Se CanResizeProperty è falso.
InvalidOperationException Rotate

- Se CanRotateProperty è falso.

Vedere anche

  • Last updated on