Implementando o Padrão de Controle de Transformação de Automação de IU

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de Automação de Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre Automação de Interface do Usuário, consulte API de Automação do Windows: Automação de Interface do Usuário.

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 são listados no final do tópico.

O TransformPattern padrão de controle é usado para dar suporte a controles que podem ser movidos, redimensionados ou girados em um espaço bidimensional. Para obter exemplos de controles que implementam esse padrão de controle, consulte mapeamento de padrões de controle para clientes de automação de interface do usuário.

Diretrizes e convenções de implementação

Ao implementar o padrão de controle Transformar, 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 modo que seu local de tela resultante esteja completamente fora das coordenadas de seu contêiner e, portanto, inacessível para o teclado ou mouse (por exemplo, quando uma janela de nível superior é movida 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 de 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 propriedades e os métodos a seguir são necessários para implementar ITransformProvider.

Membros necessários	Tipo de membro	Anotaçõ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 gerar as exceções a seguir.

Tipo de exceção	Condição
InvalidOperationException	Move – Se a CanMoveProperty for false.
InvalidOperationException	Resize – Se a CanResizeProperty for false.
InvalidOperationException	Rotate – Se a CanRotateProperty for false.

Consulte também

• Visão geral dos padrões de controle de automação da interface do usuário
• Padrões de controle de suporte em um provedor de automação da interface do usuário
• Padrões de Controle para Clientes de Automação de IU
• Visão geral da árvore de automação da interface do usuário
• Usar armazenamento em cache em automação de interface do usuário