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 de Propriedade

O pincel está contente. A predefinição é null.

Observações

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 está bastante alto na hierarquia geral de classes de WPF, por isso um número muito grande de objetos poderia servir como visual que usas para um VisualBrush; a lista completa não pode ser mostrada aqui. Ver Visual; consulte a secção "Hierarquia de Herança", que mostrará as classes imediatamente derivadas. Pode então clicar nas classes imediatamente derivadas e percorrer as hierarquias para ter uma noção de toda a gama de possibilidades. A um nível superior, as duas categorias mais comuns de objetos que pode usar para um VisualBrush são UIElement ou ContainerVisual. UIElement engloba basicamente qualquer elemento da interface que possa participar na interface para uma aplicação WPF. ContainerVisual contém um DrawingGroup que inclui um ou mais Drawingobjetos derivados em .

Quando define um novo Visual para um VisualBrushVisual e que UIElement é um UIElement (como um painel ou controle), o sistema de layout é executado nele e nos seus elementos-filhos quando a propriedade AutoLayoutContent é definida como true. No entanto, a raiz UIElement está essencialmente isolada do resto do sistema; estilos, storyboards e layout externo ditados pelo pai onde o pincel é aplicado não podem atravessar este limite. Portanto, você deve especificar explicitamente o tamanho da raiz UIElement, porque 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 layout no Windows Presentation Foundation (WPF), consulte o Layout.

As atualizações da árvore visual de a VisualBrush não se propagam se a BitmapEffect estiver na cadeia mãe do pincel. Podes contornar esta limitação forçando uma atualização da cena no objeto acima do efeito. Podes chamar InvalidateVisual ou incluir uma animação para forçar uma atualização de cena.

Uso do elemento de propriedade XAML

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

Uso de atributos XAML

< ObjetoVisual="{bindingExpression}"/>

-ou-

< ObjetoVisual="{resourceExpression}"/>

Valores XAML

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

bindingExpression Uma expressão que avalia para uma instância existente Visual .

resourceExpression A StaticResource ou DynamicResource que avalia para uma instância existente Visual . Consulte Recursos XAML.

Informação de Propriedade de Dependência