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

Artigo
08/25/2010

Este tópico apresenta diretrizes e convenções para a implementação ITransformProviderIncluindo informações sobre propriedades, métodos e eventos.Links para referências adicionais são listadas ao final do tópico.

O TransformPattern Controle padrão é usada para oferecer suporte Controles que pode ser movidas, redimensionadas ou giradas em um espaço bidimensional.Para obter exemplos de controles que implementam esse padrão de controle, consulte Mapeamento de Padrão de Controles para Clientes de Automação de IU.

Este tópico contém as seguintes seções.

Orientações e Convenções de Implementação
Membros Requeridos por ITransformProvider
Exceções
Tópicos relacionados

Orientações e Convenções de Implementação

Ao implementar o padrão de controle Transform, observe as seguintes orientações e convenções:

Suporte para esse padrão de controle não está limitado a objetos no desktop.Esse padrão de controle também deve ser suportado pelos filhos de um objeto contêiner se os filhos puderem ser movidos, redimensionados ou rotacionados livremente dentro das fronteiras do contêiner.
Um objeto não pode ser movido, redimensionado ou rotacionado de forma que sua posição resultante na tela esteja completamente fora das coordenadas do seu contêiner e portanto inacessíveis ao teclado ou mouse (por exemplo, quando uma janela de nível de topo é movida para fora da tela ou um objeto filho é movido para fora das fronteiras do viewport do seu contêiner).Nesses casos, o objeto é posicionado tão próxim das coordenadas de tela solicitadas com as coordenadas de topo ou esquerda sobrepostas por coordenadas dentro das fronteiras do contêiner.
Para sistemas multi-monitor, se um objeto é movido, redimensionado ou rotacionado completamente fora das coordenadas de tela de desktop combinado, o objeto é posicionado no monitor primário, tão próximo das coordenadas solicitadas quanto possível.
Todos os parâmetros e valores de propriedade são absolutos e independentes de localidade.

Membros Requeridos por ITransformProvider

O seguintes propriedades e métodos estão necessários para implementação ITransformProvider.

Membros Requeridos	Tipo do membro	Anotações
CanMove()	Propriedade	Nenhum
CanResize	Propriedade	Nenhum
CanRotate	Propriedade	Nenhum
Move(Duplo, Duplo)	Método	Nenhum
Redimensionar(Double, Double)	Método	Nenhum
Girar(Double)	Método	Nenhum

Esse padrão de controle não possui eventos associados.

Exceções

Provedores precisam lançar as seguintes exceções.

Tipo de exceção	Condição
InvalidOperationException	Move(Duplo, Duplo) Se a CanMoveProperty é false.
InvalidOperationException	Redimensionar(Double, Double) Se a CanResizeProperty é false.
InvalidOperationException	Girar(Double) Se a CanRotateProperty é false.

InvalidOperationException

Move(Duplo, Duplo)