Implementando o padrão de controle de transformação de automação da interface do usuário
Nota
Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.
Este tópico apresenta diretrizes e convenções para implementação ITransformProvider, incluindo informações sobre propriedades, métodos e eventos. Links para referências adicionais estão listados no final do tópico.
O TransformPattern padrão de controle é usado para suportar controles que podem ser movidos, redimensionados ou girados dentro de um espaço bidimensional. Para obter exemplos de controles que implementam esse padrão de controle, consulte Mapeamento de padrão de controle para clientes de automação da interface do usuário.
Orientações e convenções de aplicação
Ao implementar o padrão de controle Transform, observe as seguintes diretrizes e convenções:
O suporte para esse padrão de controle não está limitado a objetos na área de trabalho. Esse padrão de controle também deve ser suportado pelos filhos de um objeto de contêiner se os filhos puderem ser movidos, redimensionados ou girados livremente dentro dos limites do contêiner.
Um objeto não pode ser movido, redimensionado ou girado de forma que seu local de tela resultante fique completamente fora das coordenadas de seu contêiner e, portanto, inacessível ao teclado ou mouse (por exemplo, quando uma janela de nível superior é movida para fora da tela ou um objeto filho é movido para fora dos limites do visor do contêiner). Nesses casos, o objeto é colocado o mais próximo possível das coordenadas de tela solicitadas com as coordenadas superior ou esquerda substituídas para estar dentro dos limites do contêiner.
Para sistemas com vários monitores, se um objeto for movido, redimensionado ou girado completamente fora das coordenadas combinadas da tela da área de trabalho, o objeto será colocado no monitor primário o mais próximo possível das coordenadas solicitadas.
Todos os parâmetros e valores de propriedade são absolutos e independentes da localidade.
Membros necessários para ITransformProvider
As seguintes propriedades e métodos são necessários para a implementação do ITransformProvider.
| Membros obrigatórios | Tipo de membro | Notas |
|---|---|---|
| CanMove | Property | Nenhuma |
| CanResize | Property | Nenhuma |
| CanRotate | Property | Nenhuma |
| Move | Método | Nenhuma |
| Resize | Método | Nenhuma |
| Rotate | Método | Nenhuma |
Esse padrão de controle não tem eventos associados.
Exceções
Os provedores devem lançar as seguintes exceções.
| Tipo de Exceção | Condição |
|---|---|
| InvalidOperationException | Move - Se o CanMoveProperty for falso. |
| InvalidOperationException | Resize - Se o CanResizeProperty for falso. |
| InvalidOperationException | Rotate - Se o CanRotateProperty for falso. |
Consulte também
- Visão geral dos padrões de controle de automação da interface do usuário
- Suporte a padrões de controle em um provedor de automação de interface do usuário
- Padrões de controle de automação da interface do usuário para clientes
- Visão geral da árvore de automação da interface do usuário
- Usar cache na automação da interface do usuário