다음을 통해 공유


ContainerVisual 클래스

정의

Visual 개체의 컬렉션을 관리합니다.

public ref class ContainerVisual : System::Windows::Media::Visual
public class ContainerVisual : System.Windows.Media.Visual
type ContainerVisual = class
    inherit Visual
Public Class ContainerVisual
Inherits Visual
상속
파생

예제

다음 예제에서는 두 DrawingVisual 개체에 대 한 ContainerVisual 부모로 사용 되는 개체를 만드는 방법을 보여 집니다. 개체에 ContainerVisual 추가된 개체는 올바른 그리기 순서로 렌더링되도록 역방향 z 순서(아래쪽에서 위쪽)로 추가해야 합니다. 시각적 트리를 올바르게 열거하기 위해 예제에서는 메서드 및 VisualChildrenCount 속성의 재정의된 구현을 GetVisualChild 제공합니다.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}
' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyContainerVisualHost
    Inherits FrameworkElement
    Private _containerVisual As ContainerVisual

    Public Sub New(ByVal border As DrawingVisual, ByVal text As DrawingVisual)
        ' Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = New ContainerVisual()

        ' Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border)
        _containerVisual.Children.Add(text)

        ' Create parent-child relationship with host visual and ContainerVisual.
        Me.AddVisualChild(_containerVisual)
    End Sub

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_containerVisual Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _containerVisual Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _containerVisual
    End Function
End Class

설명

클래스 ContainerVisual 는 개체 컬렉션 Visual 의 컨테이너로 사용됩니다. 클래스는 DrawingVisual 클래스에서 ContainerVisual 파생되어 클래스에 DrawingVisual 시각적 개체 컬렉션도 포함될 수 있습니다.

생성자

ContainerVisual()

ContainerVisual 클래스의 새 인스턴스를 만듭니다.

속성

BitmapEffect
사용되지 않습니다.
사용되지 않습니다.

BitmapEffect에 대한 ContainerVisual 값을 가져오거나 설정합니다.

BitmapEffectInput
사용되지 않습니다.
사용되지 않습니다.

BitmapEffectInput에 대한 ContainerVisual 값을 가져오거나 설정합니다.

CacheMode

ContainerVisual의 캐시된 표현을 가져오거나 설정합니다.

Children

ContainerVisual의 자식 컬렉션을 가져옵니다.

Clip

ContainerVisual의 클리핑 영역을 가져오거나 설정합니다.

ContentBounds

ContainerVisual의 콘텐츠에 대한 경계 상자를 가져옵니다.

DependencyObjectType

이 인스턴스의 DependencyObjectType CLR 형식을 래핑하는 값을 가져옵니다.

(다음에서 상속됨 DependencyObject)
DescendantBounds

ContainerVisual의 내용을 제외한 ContainerVisual의 모든 하위 항목에 대한 모든 내용 경계 상자의 합집합을 가져옵니다.

Dispatcher

Dispatcher와 연결된 DispatcherObject를 가져옵니다.

(다음에서 상속됨 DispatcherObject)
Effect

ContainerVisual에 적용할 비트맵 효과를 가져오거나 설정합니다.

IsSealed

이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DependencyObject)
Offset

참조 지점에서 ContainerVisual의 오프셋 값을 가져오거나 설정합니다.

Opacity

ContainerVisual의 불투명도를 가져오거나 설정하며, 0은 투명을 나타내고 1은 불투명을 나타냅니다.

OpacityMask

ContainerVisual에 사용 가능한 불투명 마스크를 지정하는 브러시를 가져오거나 설정합니다.

Parent

Visual에 대한 부모 ContainerVisual을 가져옵니다.

Transform

ContainerVisual에 적용되는 변환을 가져오거나 설정합니다.

VisualBitmapEffect
사용되지 않습니다.
사용되지 않습니다.

BitmapEffect에 대한 Visual 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualBitmapEffectInput
사용되지 않습니다.
사용되지 않습니다.

BitmapEffectInput에 대한 Visual 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualBitmapScalingMode

BitmapScalingModeVisual를 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualCacheMode

Visual의 캐시된 표현을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualChildrenCount

ContainerVisual에 대한 자식 수를 가져옵니다.

VisualClearTypeHint

ClearType이 ClearTypeHint에서 렌더링되는 방법을 결정하는 Visual를 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualClip

Visual의 클립 영역을 Geometry 값으로 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualEdgeMode

Visual의 가장자리 모드를 EdgeMode 값으로 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualEffect

Visual에 적용할 비트맵 효과를 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualOffset

시각적 개체의 오프셋 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualOpacity

Visual의 불투명도를 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualOpacityMask

Brush의 불투명 마스크를 나타내는 Visual 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualParent

시각적 개체의 시각적 트리 부모를 가져옵니다.

(다음에서 상속됨 Visual)
VisualScrollableAreaClip

Visual의 스크롤할 수 있는 클리핑된 영역을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualTextHintingMode

VisualTextHintingMode를 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualTextRenderingMode

VisualTextRenderingMode를 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualTransform

Transform에 대한 Visual 값을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualXSnappingGuidelines

X 좌표(세로) 안내선 컬렉션을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
VisualYSnappingGuidelines

y-좌표(가로) 안내선 컬렉션을 가져오거나 설정합니다.

(다음에서 상속됨 Visual)
XSnappingGuidelines

ContainerVisual의 X(가로) 안내선을 가져오거나 설정합니다.

YSnappingGuidelines

ContainerVisual의 Y(세로) 안내선을 가져오거나 설정합니다.

메서드

AddVisualChild(Visual)

두 시각적 개체 사이의 부모/자식 관계를 정의합니다.

(다음에서 상속됨 Visual)
CheckAccess()

호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다.

(다음에서 상속됨 DispatcherObject)
ClearValue(DependencyProperty)

속성의 로컬 값을 지웁니다. 지울 속성이 DependencyProperty 식별자에서 지정됩니다.

(다음에서 상속됨 DependencyObject)
ClearValue(DependencyPropertyKey)

읽기 전용 속성의 로컬 값을 지웁니다. 선언할 속성이 DependencyPropertyKey에서 지정됩니다.

(다음에서 상속됨 DependencyObject)
CoerceValue(DependencyProperty)

지정된 종속성 속성의 값을 강제 변환합니다. 호출하는 DependencyObject에 있으므로 이 작업은 종속성 속성의 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행합니다.

(다음에서 상속됨 DependencyObject)
Equals(Object)

제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다.

(다음에서 상속됨 DependencyObject)
FindCommonVisualAncestor(DependencyObject)

두 시각적 개체의 공통 상위 항목을 반환합니다.

(다음에서 상속됨 Visual)
GetHashCode()

DependencyObject의 해시 코드를 가져옵니다.

(다음에서 상속됨 DependencyObject)
GetLocalValueEnumerator()

DependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다.

(다음에서 상속됨 DependencyObject)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
GetValue(DependencyProperty)

DependencyObject의 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
GetVisualChild(Int32)

부모 Visual 의 지정된 자식 ContainerVisual을 반환합니다.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

HitTestFilterCallbackHitTestResultCallback 개체를 사용하여 ContainerVisual에서 적중 횟수 테스트를 시작합니다.

HitTest(Point)

Point를 지정하여 적중 횟수 테스트의 최상위 시각적 개체를 반환합니다.

HitTestCore(GeometryHitTestParameters)

기하 도형 값이 시각적 개체의 경계 내에 있는지 확인합니다.

(다음에서 상속됨 Visual)
HitTestCore(PointHitTestParameters)

점 좌표 값이 시각적 개체의 경계 내에 있는지 확인합니다.

(다음에서 상속됨 Visual)
InvalidateProperty(DependencyProperty)

지정된 종속성 속성의 유효 값을 다시 계산합니다.

(다음에서 상속됨 DependencyObject)
IsAncestorOf(DependencyObject)

시각적 개체가 하위 시각적 개체의 상위 항목인지 여부를 확인합니다.

(다음에서 상속됨 Visual)
IsDescendantOf(DependencyObject)

시각적 개체가 상위 시각적 개체의 하위 항목인지 여부를 확인합니다.

(다음에서 상속됨 Visual)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OnDpiChanged(DpiScale, DpiScale)

이 뷰가 렌더링되는 DPI가 변경될 때 호출됩니다.

(다음에서 상속됨 Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

DependencyObject에서 종속성 속성의 유효 값이 업데이트될 때마다 호출됩니다. 변경된 특정 종속성 속성이 이벤트 데이터에서 보고됩니다.

(다음에서 상속됨 DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

시각적 개체의 VisualCollection이 수정될 때 호출됩니다.

(다음에서 상속됨 Visual)
OnVisualParentChanged(DependencyObject)

시각적 개체의 부모를 변경할 때 호출됩니다.

(다음에서 상속됨 Visual)
PointFromScreen(Point)

화면 좌표에 있는 PointPoint의 현재 좌표계를 나타내는 Visual로 변환합니다.

(다음에서 상속됨 Visual)
PointToScreen(Point)

Point의 현재 좌표계를 나타내는 Visual를 화면 좌표에 있는 Point로 변환합니다.

(다음에서 상속됨 Visual)
ReadLocalValue(DependencyProperty)

종속성 속성의 로컬 값을 반환합니다(있는 경우).

(다음에서 상속됨 DependencyObject)
RemoveVisualChild(Visual)

두 시각적 개체 사이의 부모/자식 관계를 제거합니다.

(다음에서 상속됨 Visual)
SetCurrentValue(DependencyProperty, Object)

해당 값 소스를 변경하지 않고 종속성 속성의 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
ShouldSerializeProperty(DependencyProperty)

serialization 프로세스에서 지정된 종속성 속성의 값을 직렬화해야 하는지 여부를 나타내는 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)
TransformToAncestor(Visual)

좌표를 Visual에서 시각적 개체의 지정된 Visual 상위 항목으로 변환하는 데 사용할 수 있는 변환을 반환합니다.

(다음에서 상속됨 Visual)
TransformToAncestor(Visual3D)

좌표를 Visual에서 시각적 개체의 지정된 Visual3D 상위 항목으로 변환하는 데 사용할 수 있는 변환을 반환합니다.

(다음에서 상속됨 Visual)
TransformToDescendant(Visual)

좌표를 Visual에서 지정된 시각적 개체 하위 항목으로 변환하는 데 사용할 수 있는 변환을 반환합니다.

(다음에서 상속됨 Visual)
TransformToVisual(Visual)

좌표를 Visual에서 지정된 시각적 개체로 변환하는 데 사용할 수 있는 변환을 반환합니다.

(다음에서 상속됨 Visual)
VerifyAccess()

호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다.

(다음에서 상속됨 DispatcherObject)

적용 대상