VisualBrush.Visual Propriedade

Definição

Obtém ou define o conteúdo do pincel.Gets or sets the brush's content.

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.The brush's content. O padrão é null.The default is null.

Comentários

Há duas maneiras de especificar o Visual conteúdo de um. VisualBrushThere are two ways to specify the Visual content of a VisualBrush.

  • Crie um novo Visual e use-o para definir Visual a propriedade do VisualBrush.Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Use um existente Visual, que cria uma imagem duplicada do destino Visual.Use an existing Visual, which creates a duplicate image of the target Visual. Você pode usar o VisualBrush para criar efeitos interessantes, como reflexão e ampliação.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visualé bem alto na hierarquia geral de classes do WPF, de modo que um número muito grande de objetos pode, possivelmente, servir como o Visual VisualBrushque você usa para um; a lista inteira não pode ser mostrada aqui.Visual is quite high in the overall WPF class hierarchy, so a very large number of objects could possibly serve as the visual that you use for a VisualBrush; the entire list cannot be shown here. Consulte Visual; consulte a seção "hierarquia de herança", que mostrará as classes derivadas imediatamente.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. Em seguida, você pode clicar nas classes derivadas imediatamente e percorrer as hierarquias para ter uma noção da gama completa de possibilidades.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. Em um nível superior, as duas categorias mais comuns de objetos que você pode usar para VisualBrush o UIElement são ContainerVisualou.At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElementabrange basicamente qualquer elemento de interface do usuário que, de outra forma, pode participar da interface do usuário para um aplicativo do WPF.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisualcontém um DrawingGroup que inclui um ou mais Drawingobjetos derivados.ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Quando você define um novo Visual para um VisualBrush e que Visual é um UIElement (como um UIElement painel ou controle), o sistema de layout é executado no e seus elementos filho quando a AutoLayoutContent propriedade é definida como true.When you define a new Visual for a VisualBrush and that Visual is a UIElement (such as a panel or control), the layout system runs on the UIElement and its child elements when the AutoLayoutContent property is set to true. No entanto, UIElement a raiz é essencialmente isolada do restante do sistema; estilos, storyboards e layout externo ditado pelo pai em que o pincel é aplicado não pode percarner esse limite.However, the root UIElement is essentially isolated from the rest of the system; styles, storyboards, and external layout dictated by the parent where the brush is applied cannot permeate this boundary. Portanto, você deve especificar explicitamente o tamanho da raiz UIElement, pois seu único pai é o VisualBrush e, portanto, não pode se dimensionar automaticamente para a área que está sendo pintada.Therefore, you should explicitly specify the size of the root UIElement, because its only parent is the VisualBrush and therefore it cannot automatically size itself to the area being painted. Para mais informações sobre o layout em Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), consulte Layout.For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

As atualizações na árvore visual de um VisualBrush não serão propagadas se BitmapEffect um estiver na cadeia pai do pincel.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. Você pode solucionar essa limitação forçando uma atualização da cena no objeto acima do efeito.You can workaround this limitation by forcing an update of the scene on the object above the effect. Você pode chamar InvalidateVisual ou incluir uma animação para forçar uma atualização de cena.You can call InvalidateVisual or include an animation to force a scene update.

Observação

Um VisualBrush não pode ser tornado somente leitura (congelado) quando sua Visual Propriedade está definida com qualquer valor diferente denull.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

Uso do elemento propriedade XAMLXAML Property Element Usage

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

Uso do Atributo XAMLXAML Attribute Usage

<object Visual="{bindingExpression}"/><object Visual="{bindingExpression}"/>

- ou --or-

<object Visual="{resourceExpression}"/><object Visual="{resourceExpression}"/>

Valores XAMLXAML Values

singleVisualRoot
Um elemento de objeto único que define um novo elemento visual para o pincel.A single object element that defines a new visual element for the brush. Deve ser um objeto derivado de Visual.This must be an object that derives from Visual. Consulte Observações.See Remarks.

bindingExpression
Um que é avaliado como uma instância Visual existente.A that evaluates to an existing Visual instance.

resourceExpression
Uma StaticResource Visual ou DynamicResource que é avaliada como uma instância existente.A StaticResource or DynamicResource that evaluates to an existing Visual instance. Consulte recursos XAMLSee XAML Resources

Informações da propriedade de dependênciaDependency Property Information

Campo de identificadorIdentifier field VisualProperty
Propriedades de metadados definidas comotrueMetadata properties set to true NenhumNone

Aplica-se a