VisualBrush.Visual Proprietà

Definizione

Ottiene o imposta il contenuto del pennello.

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à

Contenuto del pennello. Il valore predefinito è null.

Commenti

Esistono due modi per specificare il contenuto Visual di un VisualBrush.

  • Creare un nuovo Visual e usarlo per impostare la proprietà Visual del VisualBrush.

  • Usare un Visualesistente che crea un'immagine duplicata del Visualdi destinazione. È quindi possibile usare il VisualBrush per creare effetti interessanti, ad esempio reflection e ingrandimento.

Visual è piuttosto elevato nella gerarchia complessiva della classe WPF, quindi un numero molto elevato di oggetti potrebbe fungere da oggetto visivo usato per un VisualBrush; L'intero elenco non può essere visualizzato qui. Vedere Visual; fare riferimento alla sezione "Gerarchia di ereditarietà", che mostrerà le classi derivate immediatamente. È quindi possibile fare clic sulle classi derivate immediatamente e attraversare le gerarchie per ottenere un'idea dell'intera gamma di possibilità. A livello generale, le due categorie più comuni di oggetti che è possibile usare per un VisualBrush sono UIElement o ContainerVisual. UIElement include fondamentalmente qualsiasi elemento dell'interfaccia utente che può altrimenti partecipare all'interfaccia utente per un'applicazione WPF. ContainerVisual contiene una DrawingGroup che include uno o più oggetti derivati da Drawing.

Quando si definisce un nuovo Visual per un VisualBrush e tale Visual è un UIElement (ad esempio un pannello o un controllo), il sistema di layout viene eseguito sul UIElement e sui relativi elementi figlio quando la proprietà AutoLayoutContent è impostata su true. Tuttavia, il UIElement radice è essenzialmente isolato dal resto del sistema; stili, storyboard e layout esterno dettati dall'elemento padre in cui il pennello viene applicato non può permeare questo limite. Pertanto, è consigliabile specificare in modo esplicito le dimensioni della radice UIElement, perché l'unico elemento padre è il VisualBrush e pertanto non può ridimensionare automaticamente l'area da disegnare. Per altre informazioni sul layout in Windows Presentation Foundation (WPF), vedere layout .

Gli aggiornamenti alla struttura ad albero visuale di un VisualBrush non verranno propagati se un BitmapEffect si trova nella catena padre del pennello. È possibile ovviare a questa limitazione forzando un aggiornamento della scena sull'oggetto sopra l'effetto. Puoi chiamare InvalidateVisual o includere un'animazione per forzare un aggiornamento della scena.

Nota

Un VisualBrush non può essere reso di sola lettura (bloccato) quando la relativa proprietà Visual è impostata su qualsiasi valore diverso da null.

Utilizzo dell'elemento della proprietà XAML

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

Utilizzo degli attributi XAML

< oggettoVisual="{bindingExpression}"/>

-o-

< oggettoVisual="{resourceExpression}"/>

Valori XAML

singleVisualRoot Un singolo elemento oggetto che definisce un nuovo elemento visivo per il pennello. Deve essere un oggetto che deriva da Visual. Vedere la sezione Osservazioni.

bindingExpression Espressione che restituisce un'istanza di Visual esistente.

resourceExpression Un StaticResource o DynamicResource che restituisce un'istanza di Visual esistente. Vedere risorse XAML.

Informazioni sulle proprietà di dipendenza

Campo Identificatore VisualProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a