다음을 통해 공유


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 하는 방법에는 두 가지가 있습니다 VisualBrush.

  • 새로 Visual 만들고 이 속성을 VisualVisualBrush사용하여 .

  • 대상Visual의 중복 이미지를 만드는 기존 Visual이미지를 사용합니다. 그런 다음 리 VisualBrush 플렉션 및 배율과 같은 흥미로운 효과를 만드는 데 사용할 수 있습니다.

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

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

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

메모

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

XAML 속성 요소 사용

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

XAML 특성 사용

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

-또는-

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

XAML 값

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

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

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

종속성 속성 정보

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

적용 대상