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 Visual contenido de .VisualBrush

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

• Use un existente Visual, que crea una imagen duplicada del destino Visual. A continuación, puede usar para VisualBrush crear efectos interesantes, como la reflexión y la 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 se define un nuevo Visual para y que Visual es (UIElementpor ejemplo, un panel o control), el sistema de diseño se ejecuta en y UIElement sus elementos secundarios cuando la AutoLayoutContent propiedad se establece trueen .VisualBrush 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.

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-

< 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 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	Importancia
Campo identificador	VisualProperty
Propiedades de metadatos establecidas en true	Ninguno