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

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

• Use un Visualexistente , que crea una imagen duplicada del Visualde destino. A continuación, puede usar el VisualBrush para 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 gran número de objetos podría servir posiblemente como el objeto visual que se usa para una 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 un 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 que incluye uno o varios objetos derivados de Drawing.

Al definir un nuevo Visual para un VisualBrush y que Visual es un UIElement (por ejemplo, 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, el UIElement raíz está esencialmente aislado del resto del sistema; estilos, guiones gráficos y diseño externo dictados por el elemento primario donde se aplica el pincel no puede permear este límite. Por lo tanto, debe especificar explícitamente el tamaño del UIElementraíz , ya que su único elemento primario es el VisualBrush y, por lo tanto, no se puede ajustar automáticamente el tamaño al área que se está pintando. Para obtener más información sobre el diseño en Windows Presentation Foundation (WPF), consulta ladiseño de .

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

Nota

No se puede realizar una VisualBrush de solo lectura (inmovilizado) cuando su propiedad Visual 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 Un único elemento de objeto que define un nuevo elemento visual para el pincel. Debe ser un objeto que deriva de Visual. Vea comentarios.

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

resourceExpression una StaticResource o DynamicResource que se evalúa como una instancia de Visual existente. Consulta recursos XAML.

Información de la propiedad dependency

Campo identificador	VisualProperty
Propiedades de metadatos establecidas en true	Ninguno