VisualBrush.Visual Propiedad

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Obtiene o establece el contenido del pincel.

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 de propiedad

Visual

Contenido del pincel. El valor predeterminado es null.

Comentarios

Hay dos maneras de especificar el contenido de un Visual. VisualBrush

• Cree un nuevo Visual y úselo para establecer la propiedad Visual de VisualBrush.

• Use un existente Visual, que crea una imagen duplicada del destino Visual. A continuación, puede usar el VisualBrush para crear efectos interesantes, como reflexión y ampliación.

Visual es bastante alto en la jerarquía general de clases de WPF, por lo que un número muy grande de objetos podría servir como el objeto visual que se usa para un VisualBrush; no se puede mostrar aquí toda la lista. Vea Visual; consulte la sección "Jerarquía de herencia", que mostrará las clases derivadas inmediatamente. A continuación, puede hacer clic en las clases derivadas inmediatamente y recorrer las jerarquías para obtener una idea de la gama completa de posibilidades. En un nivel superior, las dos categorías de objetos más comunes que puede usar para VisualBrush son UIElement o ContainerVisual. UIElement abarca básicamente cualquier elemento de interfaz de usuario que pueda participar en la interfaz de usuario para una aplicación WPF. ContainerVisual contiene un DrawingGroup objeto que incluye uno o varios Drawingobjetos derivados de .

Cuando defines un nuevo Visual para un VisualBrush y ese Visual es un UIElement (como un panel o control), el sistema de diseño se ejecuta en el UIElement y sus elementos secundarios cuando la propiedad AutoLayoutContent se establece en true. Sin embargo, la raíz UIElement está esencialmente aislada del resto del sistema; los estilos, los guiones gráficos y el diseño externo dictados por el elemento primario donde se aplica el pincel no pueden impregnar este límite. Por lo tanto, debe especificar explícitamente el tamaño de la raíz UIElement, ya que su único elemento primario es VisualBrush y, por lo tanto, no se puede ajustar automáticamente al área que se está pintando. Para obtener más información sobre el diseño en Windows Presentation Foundation (WPF), consulte Diseño.

Las actualizaciones en el árbol visual de un VisualBrush no se propagarán si se BitmapEffect encuentra en la cadena primaria del pincel. Puede solucionar esta limitación forzando una actualización de la escena en el objeto encima del efecto. Puede llamar a InvalidateVisual o incluir una animación para forzar una actualización de escena.

Note

No VisualBrush se puede hacer de solo lectura (inmovilizado) cuando su Visual propiedad está establecida en cualquier valor distinto de null.

Uso de elementos de propiedad XAML

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

Uso de atributos XAML

< objetoVisual="{bindingExpression}"/>

O bien

< objetoVisual="{resourceExpression}"/>

Valores XAML

singleVisualRoot Elemento de objeto único que define un nuevo elemento visual para el pincel. Debe ser un objeto que derive de Visual. Vea la sección Comentarios.

bindingExpression Expresión que se evalúa como una instancia existente Visual .

resourceExpression StaticResource O DynamicResource que se evalúa como una instancia existenteVisual. Consulta Recursos XAML.

Información de la propiedad dependency

Elemento	Value
Campo identificador	VisualProperty
Propiedades de metadatos establecidas en true	Ninguno