VisualBrush.Visual Propriedade

public:
 property System::Windows::Media::Visual ^ Visual { System::Windows::Media::Visual ^ get(); void set(System::Windows::Media::Visual ^ value); };

public System.Windows.Media.Visual Visual { get; set; }

member this.Visual : System.Windows.Media.Visual with get, set

Public Property Visual As Visual

Valor da propriedade

O conteúdo do pincel. O padrão é null.

Comentários

Há duas maneiras de especificar o Visual conteúdo de um VisualBrush.

• Crie um novo Visual e use-o para definir a Visual propriedade do VisualBrush.

• Use um existente Visual, que cria uma imagem duplicada do destino Visual. Em seguida, você pode usar o VisualBrush para criar efeitos interessantes, como reflexão e ampliação.

Visual é bastante alto na hierarquia de classe geral do WPF, portanto, um número muito grande de objetos poderia possivelmente servir como o visual que você usa para um VisualBrush; a lista inteira não pode ser mostrada aqui. Consulte Visual; consulte a seção "Hierarquia de Herança", que mostrará as classes derivadas imediatamente. Em seguida, você pode clicar nas classes derivadas imediatamente e percorrer as hierarquias para ter uma noção de toda a gama de possibilidades. Em um nível superior, as duas categorias mais comuns de objetos que você pode usar para um VisualBrush são UIElement ou ContainerVisual. UIElement abrange basicamente qualquer elemento de interface do usuário que, de outra forma, pode participar da interface do usuário de um aplicativo WPF. ContainerVisual contém um DrawingGroup que inclui um ou mais Drawingobjetos derivados de .

Quando você define um novo Visual para um VisualBrush e que Visual é um UIElement (como um painel ou controle), o sistema de layout é executado nos UIElement elementos filho e quando a AutoLayoutContent propriedade é definida truecomo . No entanto, a raiz UIElement é essencialmente isolada do restante do sistema; estilos, storyboards e layout externo ditados pelo pai em que o pincel é aplicado não podem permear esse limite. Portanto, você deve especificar explicitamente o tamanho da raiz UIElement, pois seu único pai é o VisualBrush e, portanto, ele não pode se dimensionar automaticamente para a área que está sendo pintada. Para obter mais informações sobre o layout no WPF (Windows Presentation Foundation), consulte o Layout.

Atualizações para a árvore visual de um VisualBrush não será propagado se um BitmapEffect estiver na cadeia pai do pincel. Você pode contornar essa limitação forçando uma atualização da cena no objeto acima do efeito. Você pode chamar InvalidateVisual ou incluir uma animação para forçar uma atualização de cena.

Uso do elemento propriedade XAML

<object>  
  <object.Visual>  
    singleVisualRoot  
  </object.Visual>  
</object>  

Uso do Atributo XAML

<ObjetoVisual ="{bindingExpression}"/>

- ou -

<ObjetoVisual ="{resourceExpression}"/>

Valores XAML

singleVisualRoot
Um único elemento de objeto que define um novo elemento visual para o pincel. Esse deve ser um objeto que deriva de Visual. Consulte Observações.

bindingExpression
Uma expressão que é avaliada como uma instância existente Visual .

resourceExpression
Um StaticResource ou DynamicResource que é avaliado como uma instância existente Visual . Consulte Recursos XAML.

Informações da propriedade de dependência

Aplica-se a