Visual 클래스

정의

적중 테스트, 좌표 변환, 경계 상자 계산 등을 포함한 WPF의 렌더링 지원을 제공합니다.

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

설명

클래스는 Visual 모든 FrameworkElement 개체가 파생되는 기본 추상화입니다. 또한 WPF에서 새 컨트롤을 작성하기 위한 진입점 역할을 하며, 여러 가지 면에서 Win32 애플리케이션 모델에서 HWND(창 핸들)와 동등한 것으로 간주할 수 있습니다.

개체는 Visual 핵심 WPF 개체이며, 주된 역할은 렌더링 지원을 제공하는 것입니다. 사용자 인터페이스 컨트롤(예: ButtonTextBox)은 클래스에서 Visual 파생되며 정의된 속성을 사용하여 Visual 렌더링 데이터를 유지합니다. 개체는 Visual 다음을 지원합니다.

  • 출력 표시: 시각적 개체의 serialize된 지속형 그리기 콘텐츠 렌더링

  • 변환: 시각적 개체에 대해 변환 수행

  • 클리핑: 시각적 개체에 대해 클리핑 영역 지원 제공

  • 적중 횟수 테스트: 지정된 좌표(점) 또는 기하 도형이 시각적 개체의 범위 내에 포함되어 있는지 여부를 결정합니다.

  • 경계 상자 계산: 시각적 개체의 경계 사각형 결정

아키텍처적으로 Visual 개체는 다음과 같이 렌더링과 즉시 관련되지 않은 다른 애플리케이션 개발 요구 사항/WPF 기능에 대한 지원을 포함하지 않습니다.

  • 이벤트 처리

  • Layout

  • 스타일

  • 데이터 바인딩

  • 전역화

Visual 는 추가 클래스를 파생시킬 수 있는 공용 추상 클래스로 제공됩니다. 다음 그림에서는 WPF 아키텍처에 정의된 기존 시각적 개체의 계층 구조를 보여 줍니다.

시각적 개체에서 파생된 클래스의 다이어그램
시각적 개체 클래스 계층 구조

경우에 따라 보호된 것으로 정의된 멤버는 파생 클래스에서 Visual 비슷한 이름을 가진 보다 쉽게 액세스할 수 있는 멤버로 노출됩니다 UIElement .

자세한 내용은 WPF 그래픽 렌더링 개요를 참조하세요.

A Visual 에는 제한된 수의 수준이 있습니다. 이전 버전의 .NET Framework 최대 깊이는 255개였습니다. 이 제한은 시각적 트리에 많은 수준이 있는 일부 레이아웃에 적합하지 않습니다.

.NET Framework 4에서는 최대 깊이 Visual 가 2047이므로 시각적 트리가 훨씬 더 깊어질 수 있습니다. 대부분의 애플리케이션에서 많은 수준을 이동할 스택 공간이 않으며 결과 StackOverflowException 레이아웃 중입니다. 기본 스택 크기의 경우 이 예외는 일반적으로 트리 깊이가 약 800인 경우 throw되며 이는 약 190개의 중첩된 TreeViewItem 개체에 해당합니다.

애플리케이션에서이 예외가 throw 됩니다. 자세히 시각적 트리에 있어야를 애플리케이션의 스택 크기를 늘릴 수 있습니다. 컴파일 시 /STACK 옵션을 사용하거나 EDITBIN 유틸리티를 사용하여 스택 크기를 늘릴 수 있습니다. 스택 크기를 늘리면 애플리케이션의 성능에 영향을 줄 수 있습니다. 자세한 내용은 스택 할당 및 EDITBIN 옵션을 참조하세요.

생성자

Visual()

Visual 클래스에서 파생된 개체의 기본 초기화를 제공합니다.

속성

DependencyObjectType

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

(다음에서 상속됨 DependencyObject)
Dispatcher

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

(다음에서 상속됨 DispatcherObject)
IsSealed

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

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

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

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

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

VisualBitmapScalingMode

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

VisualCacheMode

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

VisualChildrenCount

Visual의 자식 요소 수를 가져옵니다.

VisualClearTypeHint

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

VisualClip

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

VisualEdgeMode

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

VisualEffect

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

VisualOffset

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

VisualOpacity

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

VisualOpacityMask

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

VisualParent

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

VisualScrollableAreaClip

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

VisualTextHintingMode

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

VisualTextRenderingMode

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

VisualTransform

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

VisualXSnappingGuidelines

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

VisualYSnappingGuidelines

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

메서드

AddVisualChild(Visual)

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

CheckAccess()

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

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

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

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

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

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

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

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

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

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

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

GetHashCode()

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

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

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

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

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

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

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

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

부모 Visual에 있는 지정한 VisualCollection을 반환합니다.

HitTestCore(GeometryHitTestParameters)

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

HitTestCore(PointHitTestParameters)

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

InvalidateProperty(DependencyProperty)

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

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

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

IsDescendantOf(DependencyObject)

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

MemberwiseClone()

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

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

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

OnPropertyChanged(DependencyPropertyChangedEventArgs)

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

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

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

OnVisualParentChanged(DependencyObject)

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

PointFromScreen(Point)

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

PointToScreen(Point)

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

ReadLocalValue(DependencyProperty)

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

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

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

SetCurrentValue(DependencyProperty, Object)

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

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

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

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

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

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

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

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

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

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

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

TransformToAncestor(Visual3D)

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

TransformToDescendant(Visual)

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

TransformToVisual(Visual)

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

VerifyAccess()

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

(다음에서 상속됨 DispatcherObject)

적용 대상

추가 정보