VisualBrush.Visual Proprietà

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

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à

Visual

Contenuto del pennello. Il valore predefinito è null.

Commenti

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

• Creare un nuovo Visual oggetto e usarlo per impostare la Visual proprietà dell'oggetto VisualBrush.

• Usare un oggetto esistente Visualche crea un'immagine duplicata della destinazione Visual. È quindi possibile utilizzare per VisualBrush creare effetti interessanti, ad esempio reflection e ingrandimento.

Visual è piuttosto elevato nella gerarchia generale delle classi WPF, quindi un numero molto elevato di oggetti potrebbe essere usato come oggetto visivo usato per un VisualBrushoggetto . 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 superiore, le due categorie più comuni di oggetti che è possibile usare per un VisualBrush oggetto sono UIElement o ContainerVisual. UIElement comprende fondamentalmente qualsiasi elemento dell'interfaccia utente che può altrimenti partecipare all'interfaccia utente per un'applicazione WPF. ContainerVisual contiene un DrawingGroup oggetto che include uno o più Drawingoggetti derivati da .

Quando si definisce un nuovo Visual oggetto per e VisualBrush , Visual ad esempio un UIElement pannello o un controllo, il sistema di layout viene eseguito su e sui UIElement relativi elementi figlio quando la AutoLayoutContent proprietà è impostata su 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 può permeare questo limite. Pertanto, è necessario specificare in modo esplicito le dimensioni della radice UIElement, perché l'unico VisualBrush elemento padre è e pertanto non può ridimensionarsi automaticamente nell'area da disegnare. Per altre informazioni sul layout in Windows Presentation Foundation (WPF), vedere Layout.

Aggiornamenti all'albero visivo di un VisualBrush oggetto non si propaga se un BitmapEffect oggetto si trova nella catena padre del pennello. È possibile aggirare 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

Non è possibile impostare un VisualBrush oggetto di sola lettura (bloccato) quando la relativa Visual proprietà è impostata su un valore diverso da null.

Utilizzo della sintassi XAML per elementi proprietà

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

Uso della sintassi XAML per gli attributi

<OggettoVisual ="{bindingExpression}"/>

-oppure-

<OggettoVisual ="{resourceExpression}"/>

Valori XAML

singleVisualRoot
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 esistente Visual .

resourceExpression
Oggetto StaticResource o DynamicResource che restituisce un'istanza esistente Visual . Vedi Risorse XAML.

Informazioni proprietà di dipendenza

Campo Identificatore	VisualProperty
Proprietà dei metadati impostate su true	Nessuno