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 di classi WPF complessiva, quindi un numero molto elevato di oggetti potrebbe fungere da 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 include 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 , VisualUIElement ad esempio un pannello o un controllo, il sistema di layout viene eseguito sugli UIElement elementi figlio e 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 elemento padre è 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 oggetto non verranno propagati se un BitmapEffect oggetto 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

Non è possibile impostare un VisualBrush valore di sola lettura (bloccato) quando la relativa Visual proprietà è impostata su un 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 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 sulle proprietà di dipendenza

Elemento	Valore
Campo Identificatore	VisualProperty
Proprietà dei metadati impostate su true	Nessuno