VisualBrush.Visual 속성

정의

브러시의 내용을 가져오거나 설정합니다.

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

속성 값

브러시의 내용입니다. 기본값은 null입니다.

설명

Visual의 콘텐츠를 지정하는 두 가지 방법이 있습니다.

  • 새로운 Visual을 만들고 이를 VisualVisualBrush 속성을 설정하는 데 사용합니다.

  • 기존 Visual를 사용하여 대상 Visual의 중복 이미지를 생성합니다. You can use VisualBrush를 사용하여 반사 및 확대와 같은 흥미로운 효과를 만들 수 있습니다.

Visual 는 전체 WPF 클래스 계층 구조에서 매우 높으므로 매우 많은 수의 개체가 사용자가 사용하는 VisualBrush시각적 개체로 사용될 수 있습니다. 전체 목록은 여기에 표시될 수 없습니다. 참조 Visual; 즉시 파생된 클래스를 표시 하는 "상속 계층 구조" 섹션을 참조 합니다. 그런 다음 즉시 파생된 클래스를 클릭하고 계층을 트래버스하여 전체 가능성을 파악할 수 있습니다. 최상위 수준에서 사용할 수 있는 개체의 가장 일반적인 두 범주는 VisualBrush 다음과 같습니다 UIElementContainerVisual. UIElement 는 기본적으로 WPF 애플리케이션의 UI에 참여할 수 있는 모든 UI 요소를 포함합니다. ContainerVisual 에는 DrawingGroup 하나 이상의 Drawing파생 개체가 포함된 개체가 포함되어 있습니다.

새로운 VisualVisualBrush에 정의하고, 해당 Visual이(가) UIElement (예: 패널 또는 컨트롤)인 경우, UIElement 속성이 AutoLayoutContent로 설정되면 레이아웃 시스템은 true 및 해당 자식 요소에서 실행됩니다. 그러나 루트 UIElement 는 기본적으로 시스템의 나머지 부분과 격리됩니다. 브러시가 적용되는 부모가 지시하는 스타일, 스토리보드 및 외부 레이아웃은 이 경계에 스며들 수 없습니다. 루트 UIElement의 크기를 명시적으로 지정해야 합니다. 이는 루트의 유일한 부모가 VisualBrush이기 때문에, 루트가 그려지는 영역에 자동으로 맞춰 크기를 조정할 수 없기 때문입니다. Windows Presentation Foundation (WPF)의 레이아웃에 대한 자세한 내용은 레이아웃을 참조하십시오.

브러시의 부모 체인에 있는 VisualBrush 경우 BitmapEffect 시각적 트리에 대한 업데이트가 전파되지 않습니다. 효과 위의 개체에서 장면의 업데이트를 강제로 적용하여 이 제한을 해결할 수 있습니다. 장면 업데이트를 강제 적용하기 위해 애니메이션을 호출 InvalidateVisual 하거나 포함할 수 있습니다.

메모

속성이 이외의 VisualBrush값으로 설정된 경우 Visual A null 를 읽기 전용(고정)으로 만들 수 없습니다.

XAML 속성 요소 사용

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

XAML 특성 사용

< 개체Visual="{bindingExpression}"/>

-또는-

< 개체Visual="{resourceExpression}"/>

XAML 값

singleVisualRoot 브러시에 대한 새 시각적 요소를 정의하는 단일 개체 요소입니다. 이 개체는 .에서 Visual파생되는 개체여야 합니다. 비고를 참조하세요.

bindingExpression 기존 Visual 인스턴스로 계산되는 식입니다.

resourceExpression A StaticResource 또는 DynamicResource 기존 인스턴스로 평가됩니다 Visual . XAML 리소스를 참조하세요.

종속성 속성 정보

항목 가치
식별자 필드 VisualProperty
메타데이터 속성이 다음으로 설정됩니다. true None

적용 대상