Implementando o padrão de controle de transformação de automação da interface do usuário

Observação

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 namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico apresenta diretrizes e convenções para implementar 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 Control Pattern Mapping for UI Automation Clients.

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	Observações
CanMove	Propriedade	Nenhum
CanResize	Propriedade	Nenhum
CanRotate	Propriedade	Nenhum
Move	Método	Nenhum
Resize	Método	Nenhum
Rotate	Método	Nenhum

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 considerado falso.
InvalidOperationException	Resize - Se o CanResizeProperty for considerado falso.
InvalidOperationException	Rotate - Se o CanRotateProperty for considerado falso.

Ver também

• Visão geral dos padrões de controle de automação da interface do usuário
• Suportar 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
• Use o armazenamento em cache na automação da interface do utilizador