VisualBrush.Visual VisualBrush.Visual VisualBrush.Visual VisualBrush.Visual Property

정의

브러시의 내용을 가져오거나 설정합니다.Gets or sets the brush's content.

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

속성 값

브러시의 내용입니다.The brush's content. 기본값은 null입니다.The default is null.

설명

두 가지 방법으로 지정할 수는 Visual 의 콘텐츠는 VisualBrush합니다.There are two ways to specify the Visual content of a VisualBrush.

  • Visual 를 설정 하는 데 사용 합니다 Visual 의 속성을 VisualBrush합니다.Create a new Visual and use it to set the Visual property of the VisualBrush.

  • 기존 항목 사용 Visual, 대상의 중복 이미지를 만드는 Visual합니다.Use an existing Visual, which creates a duplicate image of the target Visual. 사용할 수 있습니다는 VisualBrush 리플렉션 및 확대와 같은 흥미로운 효과 만들 수 있습니다.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visual 매우 큰 많은 개체를 사용 하는 시각적으로 할 수 있게 되므로 전체 WPF 클래스 계층 구조에서 상당히 높기는 VisualBrush; 전체 목록은 여기에 표시할 수 없습니다.Visual is quite high in the overall WPF class hierarchy, so a very large number of objects could possibly serve as the visual that you use for a VisualBrush; the entire list cannot be shown here. 참조 Visual; 즉시 파생된 클래스를 보여 주는 "상속 계층 구조" 섹션을 참조 하세요.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. 그런 다음 즉시 파생된 클래스를 클릭 하 고 다양 한 가능성을 살펴볼 계층을 트래버스할 수 있습니다.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. 상위 수준에서 가장 일반적인 두 가지 범주의 개체에 사용할 수는 VisualBrush 됩니다 UIElement 또는 ContainerVisual합니다.At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElement 기본적으로 WPF 애플리케이션에 대 한 UI에 참여할 수 있는 모든 UI 요소를 포함 합니다.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisual 포함 된 DrawingGroup 하나 이상 포함 하는 Drawing-파생 개체입니다.ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

정의 하는 경우 새 Visual 에 대 한는 VisualBrush 하 고 VisualUIElement (예: 패널 또는 컨트롤)에서 실행 되는 레이아웃 시스템을 UIElement 와 해당 자식 요소 때를 AutoLayoutContent 속성이 true.When you define a new Visual for a VisualBrush and that Visual is a UIElement (such as a panel or control), the layout system runs on the UIElement and its child elements when the AutoLayoutContent property is set to true. 그러나 루트 UIElement 시스템의 나머지 부분에서 기본적으로 격리 된 스타일, storyboard 및 브러시 적용 되는 부모에 따라 외부 레이아웃에이 경계 낫다는 개념 수 없습니다.However, the root UIElement is essentially isolated from the rest of the system; styles, storyboards, and external layout dictated by the parent where the brush is applied cannot permeate this boundary. 루트의 크기를 명시적으로 지정 해야 하므로 UIElement만 부모 이기 때문은 VisualBrush 하므로 해당 수 없습니다. 자동으로 크기가 조정 자체 그려지는 영역 및 합니다.Therefore, you should explicitly specify the size of the root UIElement, because its only parent is the VisualBrush and therefore it cannot automatically size itself to the area being painted. WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF)의 레이아웃에 대한 자세한 내용은 레이아웃을 참조하세요.For more information about layout in WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF), see the Layout.

시각적 트리에 대 한 업데이트를 VisualBrush 경우에 전파 되지 것입니다는 BitmapEffect 브러시의 부모 체인에.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. 하면 이러한 제한을 해결할 수 효과 상위 개체에서 장면 업데이트 적용.You can workaround this limitation by forcing an update of the scene on the object above the effect. 호출할 수 있습니다 InvalidateVisual 또는 애니메이션 장면을 업데이트를 강제 실행을 포함 합니다.You can call InvalidateVisual or include an animation to force a scene update.

참고

A VisualBrush 없습니다 수 읽기 전용 (고정) 하면 해당 Visual 속성 이외의 값으로 설정 되어 null.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

XAML 속성 요소 사용XAML Property Element Usage

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

XAML 특성 사용XAML Attribute Usage

<object Visual="{bindingExpression}"/><object Visual="{bindingExpression}"/>

또는-or-

<object Visual="{resourceExpression}"/><object Visual="{resourceExpression}"/>

XAML 값XAML Values

singleVisualRoot
브러시에 대 한 새 시각적 요소를 정의 하는 단일 개체 요소입니다.A single object element that defines a new visual element for the brush. 파생 되는 개체 여야이 Visual합니다.This must be an object that derives from Visual. 설명 부분을 참조하세요.See Remarks.

bindingExpression
기존 계산 되는 Visual 인스턴스.A that evaluates to an existing Visual instance.

resourceExpression
A StaticResourceDynamicResource 기존로 평가 되는 Visual 인스턴스.A StaticResource or DynamicResource that evaluates to an existing Visual instance. 참조 XAML 리소스See XAML Resources

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field VisualProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상