VisualBrush.Visual Propiedad

Definición

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. De manera predeterminada, es null.

Comentarios

Hay dos maneras de especificar el contenido Visual de VisualBrush.

  • Cree una clase Visual nueva y úsela para establecer la propiedad Visual de VisualBrush.

  • Use una clase Visual ya existente, lo que crea una imagen duplicada de la clase Visual de destino. Después puede usar VisualBrush para crear efectos interesantes, como reflejo y aumento.

Visual es bastante alto en la jerarquía general de clases de WPF, por lo que un gran número de objetos podría servir posiblemente 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 más comunes de objetos que puede usar para son VisualBrushUIElement 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 se define una propiedad Visual nueva para VisualBrush y ese Visual es UIElement (como un panel o control), el sistema de diseño se ejecuta en UIElement y en 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 del elemento raíz UIElement, porque su único elemento principal es VisualBrush y, por tanto, no se puede ajustar automáticamente al área que se está pintando. Para más información sobre diseño en Windows Presentation Foundation (WPF), vea Diseño.

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

Nota:

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 deriva de Visual. Vea la sección Comentarios.

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

resourceExpression
o StaticResourceDynamicResource que se evalúa como una instancia existente Visual . Consulta Recursos XAML.

Información sobre propiedades de dependencia

Campo identificador VisualProperty
Propiedades de metadatos establecidas en true Ninguno

Se aplica a