VisualBrush.Visual Proprietà

Definizione

Ottiene o imposta il contenuto del pennello.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

Valore della proprietà

Visual

Contenuto del pennello.The brush's content. Il valore predefinito è null.The default is null.

Commenti

Esistono due modi per specificare il Visual contenuto di un oggetto VisualBrush .There are two ways to specify the Visual content of a VisualBrush.

  • Creare un nuovo oggetto Visual e usarlo per impostare la Visual proprietà dell'oggetto VisualBrush .Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Usare un oggetto esistente Visual , che crea un'immagine duplicata della destinazione Visual .Use an existing Visual, which creates a duplicate image of the target Visual. È quindi possibile usare VisualBrush per creare effetti interessanti, ad esempio la reflection e l'ingrandimento.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visual è piuttosto elevato nella gerarchia di classi WPF complessiva, quindi un numero molto elevato di oggetti può fungere da oggetto visivo usato per un oggetto VisualBrush ; l'intero elenco non può essere visualizzato qui.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. Vedere Visual la sezione "gerarchia di ereditarietà", che mostrerà le classi derivate immediatamente.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. È quindi possibile fare clic sulle classi derivate immediatamente e attraversare le gerarchie per ottenere un'idea dell'intera gamma di possibilità.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. A un livello superiore, le due categorie più comuni di oggetti che è possibile utilizzare per un oggetto VisualBrush sono UIElement o ContainerVisual .At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElement include fondamentalmente qualsiasi elemento dell'interfaccia utente che altrimenti possa partecipare all'interfaccia utente per un'applicazione WPF.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisual contiene un oggetto DrawingGroup che include uno o più Drawing oggetti derivati da.ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Quando si definisce un nuovo oggetto Visual per un oggetto VisualBrush e che Visual è un oggetto UIElement (ad esempio un pannello o un controllo), il sistema di layout viene eseguito in UIElement e nei relativi elementi figlio quando la AutoLayoutContent proprietà è impostata su 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. Tuttavia, la radice UIElement è essenzialmente isolata dal resto del sistema, gli stili, gli storyboard e il layout esterno dettati dall'elemento padre in cui il pennello viene applicato non possono permeare questo 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. Pertanto, è necessario specificare in modo esplicito le dimensioni della radice UIElement , poiché l'unico elemento padre è VisualBrush e pertanto non può ridimensionarsi automaticamente nell'area da disegnare.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. Per altre informazioni sul layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), vedere Layout.For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

Gli aggiornamenti alla struttura ad albero visuale di un oggetto VisualBrush non vengono propagati se un oggetto BitmapEffect si trova nella catena padre del pennello.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. È possibile aggirare questa limitazione forzando un aggiornamento della scena sull'oggetto sopra l'effetto.You can workaround this limitation by forcing an update of the scene on the object above the effect. È possibile chiamare InvalidateVisual o includere un'animazione per forzare un aggiornamento della scena.You can call InvalidateVisual or include an animation to force a scene update.

Nota

Un oggetto VisualBrush non può essere reso di sola lettura (bloccato) quando la relativa Visual proprietà è impostata su un valore diverso da null.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

Utilizzo della sintassi XAML per elementi proprietàXAML Property Element Usage

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

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<oggetto Visual di = "{BindingExpression}"/><object Visual="{bindingExpression}"/>

-oppure--or-

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

Valori XAMLXAML Values

singleVisualRoot
Singolo elemento oggetto che definisce un nuovo elemento visivo per il pennello.A single object element that defines a new visual element for the brush. Deve essere un oggetto che deriva da Visual .This must be an object that derives from Visual. Vedere la sezione Osservazioni.See Remarks.

bindingExpression
Oggetto che restituisce un' Visual istanza esistente.A that evaluates to an existing Visual instance.

resourceExpression
Oggetto StaticResource o DynamicResource che restituisce un' Visual istanza esistente.A StaticResource or DynamicResource that evaluates to an existing Visual instance. Vedere risorse XAMLSee XAML Resources

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field VisualProperty
Proprietà dei metadati impostate su trueMetadata properties set to true NessunoNone

Si applica a