DrawingVisual 클래스

정의

DrawingVisual 은 화면에 벡터 그래픽을 렌더링하는 데 사용할 수 있는 시각적 개체입니다.DrawingVisual is a visual object that can be used to render vector graphics on the screen. 콘텐츠는 시스템에서 유지됩니다.The content is persisted by the system.

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

설명

DrawingVisual 도형, 이미지 또는 텍스트를 렌더링 하는 데 사용 되는 경량 그리기 클래스.DrawingVisual is a lightweight drawing class that is used to render shapes, images, or text. 이 클래스 레이아웃, 입력, 포커스 또는 성능을 향상 시키는 이벤트 처리를 제공 하지 않으므로 간단한 클래스로 간주 됩니다.This class is considered lightweight because it does not provide layout, input, focus, or event handling, which improves its performance. 이러한 이유 때문에 그리기는 배경 및 클립 아트에 적합합니다.For this reason, drawings are ideal for backgrounds and clip art.

사용 하기 위해 DrawingVisual 개체를 개체에 대 한 호스트 컨테이너를 만들어야 합니다.In order to use DrawingVisual objects, you need to create a host container for the objects. 호스트 컨테이너 개체에서 파생 되어야 합니다는 FrameworkElement 레이아웃 및 이벤트 처리 지원 제공 하는 클래스는 DrawingVisual 클래스를 지원 하지 않습니다.The host container object must be derived from the FrameworkElement class, which provides the layout and event handling support that the DrawingVisual class does not support. 호스트 컨테이너 개체는 시각적 속성을 자식 개체를 포함 하는 것이 주된 목적 이므로 표시 되지 않습니다.The host container object does not display any visual properties, since its main purpose is to contain child objects. 자세한 내용은 DrawingVisual 개체 사용을 참조하세요.For more information, see Using DrawingVisual Objects.

만드는 방법을 보여주는 전체 예제 DrawingVisual 호스트 컨테이너를 사용 하 여 개체 참조를 적중 테스트를 사용 하 여 DrawingVisuals 샘플 합니다.For a complete example showing how to create DrawingVisual objects with a host container, see the Hit Test Using DrawingVisuals Sample .

생성자

DrawingVisual()

DrawingVisual 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DrawingVisual class.

속성

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

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

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

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

(다음에서 상속됨 ContainerVisual)
CacheMode

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

(다음에서 상속됨 ContainerVisual)
Children

ContainerVisual의 자식 컬렉션을 가져옵니다.Gets the child collection of the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
Clip

ContainerVisual의 클리핑 영역을 가져오거나 설정합니다.Gets or sets the clipping region of the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
ContentBounds

ContainerVisual의 콘텐츠에 대한 경계 상자를 가져옵니다.Gets the bounding box for the contents of the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
DependencyObjectType

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

(다음에서 상속됨 DependencyObject)
DescendantBounds

ContainerVisual의 내용을 제외한 ContainerVisual의 모든 하위 항목에 대한 모든 내용 경계 상자의 합집합을 가져옵니다.Gets the union of all the content bounding boxes for all of the descendants of the ContainerVisual, but not including the contents of the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
Dispatcher

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

(다음에서 상속됨 DispatcherObject)
Drawing

DrawingVisual 개체의 그리기 내용을 가져옵니다.Gets the drawing content of the DrawingVisual object.

Effect

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

(다음에서 상속됨 ContainerVisual)
IsSealed

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

(다음에서 상속됨 DependencyObject)
Offset

참조 지점에서 ContainerVisual의 오프셋 값을 가져오거나 설정합니다.Gets or sets the offset value of the ContainerVisual from its reference point.

(다음에서 상속됨 ContainerVisual)
Opacity

ContainerVisual의 불투명도를 가져오거나 설정하며, 0은 투명을 나타내고 1은 불투명을 나타냅니다.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

(다음에서 상속됨 ContainerVisual)
OpacityMask

ContainerVisual에 사용 가능한 불투명 마스크를 지정하는 브러시를 가져오거나 설정합니다.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
Parent

Visual에 대한 부모 ContainerVisual을 가져옵니다.Gets the parent Visual for the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
Transform

ContainerVisual에 적용되는 변환을 가져오거나 설정합니다.Gets or sets the transform that is applied to the ContainerVisual.

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

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

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

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

(다음에서 상속됨 Visual)
VisualBitmapScalingMode

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

(다음에서 상속됨 Visual)
VisualCacheMode

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

(다음에서 상속됨 Visual)
VisualChildrenCount

ContainerVisual에 대한 자식 수를 가져옵니다.Gets the number of children for the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
VisualClearTypeHint

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

(다음에서 상속됨 Visual)
VisualClip

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

(다음에서 상속됨 Visual)
VisualEdgeMode

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

(다음에서 상속됨 Visual)
VisualEffect

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

(다음에서 상속됨 Visual)
VisualOffset

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

(다음에서 상속됨 Visual)
VisualOpacity

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

(다음에서 상속됨 Visual)
VisualOpacityMask

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

(다음에서 상속됨 Visual)
VisualParent

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

(다음에서 상속됨 Visual)
VisualScrollableAreaClip

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

(다음에서 상속됨 Visual)
VisualTextHintingMode

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

(다음에서 상속됨 Visual)
VisualTextRenderingMode

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

(다음에서 상속됨 Visual)
VisualTransform

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

(다음에서 상속됨 Visual)
VisualXSnappingGuidelines

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

(다음에서 상속됨 Visual)
VisualYSnappingGuidelines

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

(다음에서 상속됨 Visual)
XSnappingGuidelines

ContainerVisual의 X(가로) 안내선을 가져오거나 설정합니다.Gets or sets the X (horizontal) guideline for the ContainerVisual.

(다음에서 상속됨 ContainerVisual)
YSnappingGuidelines

ContainerVisual의 Y(세로) 안내선을 가져오거나 설정합니다.Gets or sets the Y (vertical) guideline for the ContainerVisual.

(다음에서 상속됨 ContainerVisual)

메서드

AddVisualChild(Visual)

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

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

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

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

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

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

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

(다음에서 상속됨 DependencyObject)
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.

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

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

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

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

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

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

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

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

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

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

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

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

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

부모 Visual 의 지정된 자식 ContainerVisual을 반환합니다.Returns a specified child Visual for the parent ContainerVisual.

(다음에서 상속됨 ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

HitTestFilterCallbackHitTestResultCallback 개체를 사용하여 ContainerVisual에서 적중 횟수 테스트를 시작합니다.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

(다음에서 상속됨 ContainerVisual)
HitTest(Point)

Point를 지정하여 적중 횟수 테스트의 최상위 시각적 개체를 반환합니다.Returns the top-most visual object of a hit test by specifying a Point.

(다음에서 상속됨 ContainerVisual)
HitTestCore(GeometryHitTestParameters)

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

HitTestCore(PointHitTestParameters)

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

InvalidateProperty(DependencyProperty)

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

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

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

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

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

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

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

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

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

(다음에서 상속됨 Visual)
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.

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

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

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

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

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

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

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

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

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

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

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

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

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

렌더링에 사용할 DrawingVisual 개체를 엽니다.Opens the DrawingVisual object for rendering. 반환된 DrawingContext 값은 DrawingVisual로 렌더링하는 데 사용할 수 있습니다.The returned DrawingContext value can be used to render into the DrawingVisual.

SetCurrentValue(DependencyProperty, Object)

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

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

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

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

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

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

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

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

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

(다음에서 상속됨 Object)
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.

(다음에서 상속됨 Visual)
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.

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

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

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

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

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

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

(다음에서 상속됨 DispatcherObject)

적용 대상