Visual Visual Visual Visual Class

정의

적중 테스트, 좌표 변환, 경계 상자 계산 등을 포함한 WPF의 렌더링 지원을 제공합니다.Provides rendering support in WPF, which includes hit testing, coordinate transformation, and bounding box calculations.

public ref class Visual abstract : System::Windows::DependencyObject
public abstract class Visual : System.Windows.DependencyObject
type Visual = class
    inherit DependencyObject
    interface DUCE.IResource
Public MustInherit Class Visual
Inherits DependencyObject
상속
파생

설명

합니다 Visual 클래스는 기본 추상화는 모든 FrameworkElement 개체에서 파생 됩니다.The Visual class is the basic abstraction from which every FrameworkElement object derives. 새 컨트롤을 작성 하기 위한 진입점으로도 사용 됩니다 WPFWPF, 여러 가지 방법으로 간주할 수의 창 핸들 (HWND)를 동등 개체로 및를 Win32Win32 애플리케이션 모델입니다.It also serves as the entry point for writing new controls in WPFWPF, and in many ways can be thought of as an equivalent of a window handle (HWND) in the Win32Win32 application model.

합니다 Visual 개체는 핵심 WPFWPF 개체를 렌더링 지원을 제공 하는 역할입니다.The Visual object is a core WPFWPF object, whose primary role is to provide rendering support. 와 같은 사용자 인터페이스 컨트롤 ButtonTextBox에서 파생 되는 Visual 클래스를 사용 하 여는 Visual 렌더링 데이터를 유지 하는 것에 대 한 속성을 정의 합니다.User interface controls, such as Button and TextBox, derive from the Visual class, and use the Visual defined properties for persisting their rendering data. Visual 개체 다음에 대 한 지원을 제공 합니다.The Visual object provides support for the following:

  • 출력 표시: 시각적 개체의 serialize된 지속형 그리기 콘텐츠 렌더링Output display: Rendering the persisted, serialized drawing content of a visual.

  • 변환: 시각적 개체에 대해 변환 수행Transformations: Performing transformations on a visual.

  • 클리핑: 시각적 개체에 대해 클리핑 영역 지원 제공Clipping: Providing clipping region support for a visual.

  • 적중 횟수 테스트: 지정 된 좌표 (점) 또는 기 하 도형이 시각적 개체의 범위 내에 포함 되어 있는지 여부를 확인 합니다.Hit testing: Determining whether a specified coordinate (point) or geometry is contained within the bounds of a visual.

  • 경계 상자 계산: 시각적 개체의 경계 사각형 결정Bounding box calculations: Determining the bounding rectangle of a visual.

아키텍처 측면에서 Visual 개체에 다른 애플리케이션 개발 요구 사항에 대 한 지원이 포함 되어 있지 않습니다 / WPFWPF 즉시 렌더링과 같은 관련 되지 않은 기능:Architecturally, the Visual object does not include support for other application development requirements / WPFWPF features that are not immediately related to its rendering, such as the following:

  • 이벤트 처리Event handling

  • 레이아웃Layout

  • 스타일Styles

  • 데이터 바인딩Data binding

  • 전역화Globalization

Visual 추가 클래스 파생 될 수 공용 추상 클래스로 제공 됩니다.Visual is provided as a public abstract class from which further classes can be derived. 다음 그림에 정의 된 기존 시각적 개체의 계층 구조는 WPFWPF 아키텍처입니다.The following illustration shows the hierarchy of the existing visual objects that are defined in the WPFWPF architecture.

시각적 개체에서 파생 된 클래스의 다이어그램Diagram of classes derived from the Visual object
시각적 개체 클래스 계층 구조Visual class hierarchy

보호 구성원으로 정의 된 경우에 따라 Visual 파생에서 유사한 이름 사용 하 여 쉽게 액세스할 수 있는 멤버로 노출 되 UIElement 클래스입니다.In some cases, members that are defined as protected in Visual are exposed as more readily accessible members with similar names in the derived UIElement class.

자세한 내용은 WPF 그래픽 렌더링 개요를 참조하세요.For more information, see WPF Graphics Rendering Overview.

Visual 수준의 횟수에 제한이 있습니다.A Visual has a limited number of levels. .NET Framework의 이전 버전에서는이 최대 깊이 255 였습니다.In previous versions of the .NET Framework, this maximum depth was 255. 이 한도 시각적 트리에 여러 수준이 있는 일부 레이아웃에 적합 하지 않습니다.This limit is inadequate for some layouts that have many levels in the visual tree.

.NET Framework 4.NET Framework 4의 최대 깊이 Visual 은 시각적 트리를 더욱 심층적으로 수 있도록 하는 합니다.In .NET Framework 4.NET Framework 4, the maximum depth of a Visual is 2047, which enables much deeper visual trees. 대부분의 애플리케이션에서 많은 수준을 이동할 스택 공간이 않으며 결과 StackOverflowException 레이아웃 중입니다.In most applications, there is not enough stack space to traverse so many levels, and the result is a StackOverflowException during layout. 기본 스택 크기에 대 한이 일반적으로 예외가 트리 깊이 약 800 중첩 190 정도에 해당 하는 경우 TreeViewItem 개체입니다.For the default stack size, this exception is usually thrown when the tree depth is approximately 800, which corresponds to about 190 nested TreeViewItem objects.

애플리케이션에서이 예외가 throw 됩니다. 자세히 시각적 트리에 있어야를 애플리케이션의 스택 크기를 늘릴 수 있습니다.If this exception is thrown by your application and you need to have a deeper visual tree, you can increase the application's stack size. 컴파일 시 /STACK 옵션을 사용 하 여 또는 EDITBIN 유틸리티를 사용 하 여 스택의 크기를 늘릴 수 있습니다.You can increase the size of the stack by using the /STACK option at compile time or by using the EDITBIN utility. 스택 크기를 늘리면 애플리케이션의 성능에 영향을 줄 수 있습니다.Increasing the stack size may affect your application's performance. 자세한 내용은 스택 할당 하 고 EDITBIN 옵션합니다.For more information, see Stack Allocations and EDITBIN Options.

생성자

Visual() Visual() Visual() Visual()

Visual 클래스에서 파생된 개체의 기본 초기화를 제공합니다.Provides the base initialization for objects derived from the Visual class.

속성

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

이 인스턴스의 CLRCLR 형식을 래핑하는 DependencyObjectType을 가져옵니다.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Dispatcher와 연결된 DispatcherObject를 가져옵니다.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
IsSealed IsSealed IsSealed IsSealed

이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect

BitmapEffect에 대한 Visual 값을 가져오거나 설정합니다.Gets or sets the BitmapEffect value for the Visual.

VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput

BitmapEffectInput에 대한 Visual 값을 가져오거나 설정합니다.Gets or sets the BitmapEffectInput value for the Visual.

VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode

BitmapScalingModeVisual를 가져오거나 설정합니다.Gets or sets the BitmapScalingMode for the Visual.

VisualCacheMode VisualCacheMode VisualCacheMode VisualCacheMode

Visual의 캐시된 표현을 가져오거나 설정합니다.Gets or sets a cached representation of the Visual.

VisualChildrenCount VisualChildrenCount VisualChildrenCount VisualChildrenCount

Visual의 자식 요소 수를 가져옵니다.Gets the number of child elements for the Visual.

VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint

ClearType이 ClearTypeHint에서 렌더링되는 방법을 결정하는 Visual를 가져오거나 설정합니다.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

VisualClip VisualClip VisualClip VisualClip

Visual의 클립 영역을 Geometry 값으로 가져오거나 설정합니다.Gets or sets the clip region of the Visual as a Geometry value.

VisualEdgeMode VisualEdgeMode VisualEdgeMode VisualEdgeMode

Visual의 가장자리 모드를 EdgeMode 값으로 가져오거나 설정합니다.Gets or sets the edge mode of the Visual as an EdgeMode value.

VisualEffect VisualEffect VisualEffect VisualEffect

Visual에 적용할 비트맵 효과를 가져오거나 설정합니다.Gets or sets the bitmap effect to apply to the Visual.

VisualOffset VisualOffset VisualOffset VisualOffset

시각적 개체의 오프셋 값을 가져오거나 설정합니다.Gets or sets the offset value of the visual object.

VisualOpacity VisualOpacity VisualOpacity VisualOpacity

Visual의 불투명도를 가져오거나 설정합니다.Gets or sets the opacity of the Visual.

VisualOpacityMask VisualOpacityMask VisualOpacityMask VisualOpacityMask

Brush의 불투명 마스크를 나타내는 Visual 값을 가져오거나 설정합니다.Gets or sets the Brush value that represents the opacity mask of the Visual.

VisualParent VisualParent VisualParent VisualParent

시각적 개체의 시각적 트리 부모를 가져옵니다.Gets the visual tree parent of the visual object.

VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip

Visual의 스크롤할 수 있는 클리핑된 영역을 가져오거나 설정합니다.Gets or sets a clipped scrollable area for the Visual.

VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode

VisualTextHintingMode를 가져오거나 설정합니다.Gets or sets the TextHintingMode of the Visual.

VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode

VisualTextRenderingMode를 가져오거나 설정합니다.Gets or sets the TextRenderingMode of the Visual.

VisualTransform VisualTransform VisualTransform VisualTransform

Transform에 대한 Visual 값을 가져오거나 설정합니다.Gets or sets the Transform value for the Visual.

VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines

X 좌표(세로) 안내선 컬렉션을 가져오거나 설정합니다.Gets or sets the x-coordinate (vertical) guideline collection.

VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines

Y 좌표(가로) 안내선 컬렉션을 가져오거나 설정합니다.Gets or sets the y-coordinate (horizontal) guideline collection.

메서드

AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual)

두 시각적 개체 사이의 부모/자식 관계를 정의합니다.Defines the parent-child relationship between two visuals.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

속성의 로컬 값을 지웁니다.Clears the local value of a property. 지울 속성이 DependencyProperty 식별자에서 지정됩니다.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

읽기 전용 속성의 로컬 값을 지웁니다.Clears the local value of a read-only property. 선언할 속성이 DependencyPropertyKey에서 지정됩니다.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

지정된 종속성 속성의 값을 강제 변환합니다.Coerces the value of the specified dependency property. 호출하는 DependencyObject에 있으므로 이 작업은 종속성 속성의 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행합니다.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject)

두 시각적 개체의 공통 상위 항목을 반환합니다.Returns the common ancestor of two visual objects.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

DependencyObject의 해시 코드를 가져옵니다.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

DependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

DependencyObject의 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32)

부모 Visual에 있는 지정한 VisualCollection을 반환합니다.Returns the specified Visual in the parent VisualCollection.

HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters)

기하 도형 값이 시각적 개체의 경계 내에 있는지 확인합니다.Determines whether a geometry value is within the bounds of the visual object.

HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters)

점 좌표 값이 시각적 개체의 경계 내에 있는지 확인합니다.Determines whether a point coordinate value is within the bounds of the visual object.

InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

지정된 종속성 속성의 유효 값을 다시 계산합니다.Re-evaluates the effective value for the specified dependency property.

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject)

시각적 개체가 하위 시각적 개체의 상위 항목인지 여부를 확인합니다.Determines whether the visual object is an ancestor of the descendant visual object.

IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

시각적 개체가 상위 시각적 개체의 하위 항목인지 여부를 확인합니다.Determines whether the visual object is a descendant of the ancestor visual object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale)

이 뷰가 렌더링되는 DPI가 변경될 때 호출됩니다.Called when the DPI at which this View is rendered changes.

OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

DependencyObject에서 종속성 속성의 유효 값이 업데이트될 때마다 호출됩니다.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 변경된 특정 종속성 속성은 이벤트 데이터에서 보고됩니다.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject)

시각적 개체의 VisualCollection이 수정될 때 호출됩니다.Called when the VisualCollection of the visual object is modified.

OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

시각적 개체의 부모를 변경할 때 호출됩니다.Called when the parent of the visual object is changed.

PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point)

화면 좌표에 있는 PointPoint의 현재 좌표계를 나타내는 Visual로 변환합니다.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

PointToScreen(Point) PointToScreen(Point) PointToScreen(Point) PointToScreen(Point)

Point의 현재 좌표계를 나타내는 Visual를 화면 좌표에 있는 Point로 변환합니다.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

종속성 속성의 로컬 값을 반환합니다(있는 경우).Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual)

두 시각적 개체 사이의 부모/자식 관계를 제거합니다.Removes the parent-child relationship between two visuals.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

해당 값 소스를 변경하지 않고 종속성 속성의 값을 설정합니다.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

serialization 프로세스에서 지정된 종속성 속성의 값을 직렬화해야 하는지 여부를 나타내는 값을 반환합니다.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual)

좌표를 Visual에서 시각적 개체의 지정된 Visual 상위 항목으로 변환하는 데 사용할 수 있는 변환을 반환합니다.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D)

좌표를 Visual에서 시각적 개체의 지정된 Visual3D 상위 항목으로 변환하는 데 사용할 수 있는 변환을 반환합니다.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual)

좌표를 Visual에서 지정된 시각적 개체 하위 항목으로 변환하는 데 사용할 수 있는 변환을 반환합니다.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual)

좌표를 Visual에서 지정된 시각적 개체로 변환하는 데 사용할 수 있는 변환을 반환합니다.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

적용 대상

추가 정보