이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

FrameworkElement 클래스

2013-03-11

Windows Phone 레이아웃에 참여하는 개체에 대한 공용 API 프레임워크를 제공합니다. FrameworkElement는 또한 Windows Phone의 데이터 바인딩, 개체 트리 및 개체 수명 기능 영역과 관련된 API를 제공합니다.

상속 계층 구조

System.Object
  System.Windows.DependencyObject
    System.Windows.UIElement
      System.Windows.FrameworkElement
        자세히...

Namespace: System.Windows
어셈블리: System.Windows(System.Windows.dll)

구문

public abstract class FrameworkElement : UIElement

FrameworkElement 형식에서는 다음과 같은 멤버를 노출합니다.

생성자

	이름	Description
	FrameworkElement	FrameworkElement 클래스의 새 인스턴스를 초기화합니다.

맨 위

속성

	이름	Description
	ActualHeight	FrameworkElement의 렌더링된 높이를 가져옵니다.
	ActualWidth	FrameworkElement의 렌더링된 너비를 가져옵니다.
	AllowDrop	이 UIElement가 끌어서 놓기 작업 용도의 놓기 대상이 될 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (UIElement에서 상속됨)
	CacheMode	가능한 경우 렌더링된 내용을 캐시해야 함을 나타내는 값을 가져오거나 설정합니다. (UIElement에서 상속됨)
	Clip	UIElement의 콘텐츠 윤곽선을 정의하는 데 사용되는 Geometry를 가져오거나 설정합니다. (UIElement에서 상속됨)
	Cursor	인프라입니다. 마우스 포인터가 FrameworkElement 위에 있을 때 표시되는 커서 이미지를 가져오거나 설정합니다.
	DataContext	FrameworkElement가 데이터 바인딩에 참여하는 경우 해당 데이터 컨텍스트를 가져오거나 설정합니다.
	DesiredSize	레이아웃 프로세스의 측정 처리 단계에서 이 UIElement가 계산한 크기를 가져옵니다. (UIElement에서 상속됨)
	Dispatcher	이 개체와 관련된 Dispatcher를 가져옵니다. (DependencyObject에서 상속됨)
	FlowDirection	텍스트 및 기타 사용자 인터페이스 요소가 해당 레이아웃을 제어하는 모든 부모 요소 내에서 흐르는 방향을 가져오거나 설정합니다.
	Height	FrameworkElement의 제안된 높이를 가져오거나 설정합니다.
	HorizontalAlignment	FrameworkElement를 패널 또는 항목 컨트롤 등의 레이아웃 부모에서 작성하는 경우 요소에 적용되는 가로 맞춤 특성을 가져오거나 설정합니다.
	IsHitTestVisible	이 UIElement의 포함된 영역이 적중 테스트에 대해 true 값을 반환할 수 있는지 여부를 가져오거나 설정합니다. (UIElement에서 상속됨)
	Language	FrameworkElement에 적용되는 지역화/전역화 언어 정보를 가져오거나 설정합니다.
	Margin	FrameworkElement의 바깥쪽 여백을 가져오거나 설정합니다.
	MaxHeight	FrameworkElement의 최대 높이 제약 조건을 가져오거나 설정합니다.
	MaxWidth	FrameworkElement의 최대 너비 제약 조건을 가져오거나 설정합니다.
	MinHeight	FrameworkElement의 최소 높이 제약 조건을 가져오거나 설정합니다.
	MinWidth	FrameworkElement의 최소 너비 제약 조건을 가져오거나 설정합니다.
	Name	개체의 이름을 가져오거나 설정합니다. XAML 프로세서가 XAML 태그에서 개체 트리를 만든 경우 런타임 코드에서 이 이름으로 XAML 선언 개체를 참조할 수 있습니다.
	Opacity	개체의 불투명도 수준을 가져오거나 설정합니다. (UIElement에서 상속됨)
	OpacityMask	이 개체의 영역에 대한 불투명도를 변경하는 데 사용된 브러시를 가져오거나 설정합니다. (UIElement에서 상속됨)
	Parent	개체 트리에서 이 FrameworkElement의 부모 개체를 가져옵니다.
	Projection	이 UIElement를 렌더링할 때 적용할 원근감 프로젝션(3차원 효과)을 가져오거나 설정합니다. (UIElement에서 상속됨)
	RenderSize	UIElement의 마지막으로 렌더링된 크기를 가져옵니다. (UIElement에서 상속됨)
	RenderTransform	UIElement의 렌더링 위치에 영향을 주는 변환 정보를 가져오거나 설정합니다. (UIElement에서 상속됨)
	RenderTransformOrigin	UIElement의 영역을 기준으로 RenderTransform에서 선언하는 가능한 렌더링 변환의 원점을 가져오거나 설정합니다. (UIElement에서 상속됨)
	Resources	로컬로 정의된 리소스 사전을 가져옵니다. XAML에서 XAML 암시적 컬렉션 구문을 통해 frameworkElement.Resources 속성 요소의 자식 개체 요소로 리소스 항목을 설정할 수 있습니다.
	Style	렌더링 중 이 개체에 적용되는 인스턴스 Style을 가져오거나 설정합니다.
	Tag	이 개체에 대한 사용자 지정 정보를 저장하는 데 사용할 수 있는 임의의 개체 값을 가져오거나 설정합니다.
	Triggers	FrameworkElement에 대해 정의된 애니메이션의 트리거 컬렉션을 가져옵니다.
	UseLayoutRounding	개체 및 해당 시각적 하위 트리를 렌더링할 때 전체 픽셀에 맞게 렌더링하는 반올림 동작을 사용할지 여부를 결정하는 값을 가져오거나 설정합니다. (UIElement에서 상속됨)
	UseOptimizedManipulationRouting	시스템이 입력 이벤트를 처리할지 아니면 FrameworkElement가 입력 이벤트를 처리할지 여부를 나타내는 값을 가져오거나 설정합니다.
	VerticalAlignment	FrameworkElement를 패널 또는 항목 컨트롤 등의 부모 개체에서 작성하는 경우 요소에 적용되는 세로 맞춤 특성을 가져오거나 설정합니다.
	Visibility	UIElement의 표시 유형을 가져오거나 설정합니다. 표시되지 않는 UIElement는 렌더링되지 않으며 필요한 크기를 레이아웃에 알려 주지 않습니다. (UIElement에서 상속됨)
	Width	FrameworkElement의 너비를 가져오거나 설정합니다.

맨 위

메서드

	이름	Description
	AddHandler	지정된 라우트된 이벤트에 대한 라우트된 이벤트 처리기를 현재 요소의 처리기 컬렉션에 추가하는 방식으로 추가합니다. handledEventsToo를 true로 지정하여 이벤트 경로를 따라 다른 요소에 의해 이미 처리된 것으로 표시된 라우트된 이벤트에 대해 제공된 처리기를 호출합니다. (UIElement에서 상속됨)
	Arrange	자식 개체 요소를 배치하고 UIElement의 크기를 결정합니다. 자식 요소에 대한 사용자 지정 레이아웃을 구현하는 부모 개체는 이 메서드를 자체 레이아웃 재정의 구현에서 호출하여 재귀적 레이아웃 업데이트를 형성합니다. (UIElement에서 상속됨)
	ArrangeOverride	Windows Phone 레이아웃의 정렬 처리 단계에 대한 동작을 제공합니다. 클래스는 이 메서드를 재정의하여 자체 정렬 처리 단계 동작을 정의할 수 있습니다.
	CaptureMouse	터치 캡처를 UIElement로 설정합니다. (UIElement에서 상속됨)
	CheckAccess	호출 스레드에서 이 개체에 액세스할 수 있는지 여부를 확인합니다. (DependencyObject에서 상속됨)
	ClearValue	종속성 속성의 로컬 값을 지웁니다. (DependencyObject에서 상속됨)
	Equals(Object)	지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
	Finalize	가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	FindName	지정된 식별자 이름이 있는 개체를 검색합니다.
	GetAnimationBaseValue	Windows Phone 종속성 속성에 대해 설정되어 있고 애니메이션이 활성 상태가 아닐 때 적용되는 기준 값을 반환합니다. (DependencyObject에서 상속됨)
	GetBindingExpression	바인딩이 설정된 종속성 속성에 대한 BindingExpression을 검색합니다.
	GetHashCode	특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
	GetType	현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
	GetValue	DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨)
	InvalidateArrange	UIElement의 정렬 상태(레이아웃)를 무효화합니다. 무효화된 후에는 UIElement의 레이아웃이 업데이트됩니다. 이 업데이트 작업은 비동기적으로 수행됩니다. (UIElement에서 상속됨)
	InvalidateMeasure	UIElement의 측정 상태(레이아웃)를 무효화합니다. (UIElement에서 상속됨)
	Measure	UIElement의 DesiredSize를 업데이트합니다. 일반적으로 레이아웃 자식에 대해 사용자 지정 레이아웃을 구현하는 개체는 자체 MeasureOverride 구현에서 이 메서드를 호출하여 재귀적 레이아웃 업데이트를 형성합니다. (UIElement에서 상속됨)
	MeasureOverride	Windows Phone 레이아웃의 측정 처리 단계에 대한 동작을 제공합니다. 클래스는 이 메서드를 재정의하여 자체 측정 처리 단계 동작을 정의할 수 있습니다.
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	OnApplyTemplate	파생 클래스에서 재정의되는 경우 이 메서드는 다시 빌드 레이아웃 과정과 같은 내부 프로세스 또는 응용프로그램 코드에서 ApplyTemplate을 호출할 때마다 호출됩니다. 즉, 응용프로그램에서 UI 요소가 표시되기 직전에 메서드가 호출됩니다. 자세한 내용은 설명 부분을 참조하세요.
	OnCreateAutomationPeer	파생 클래스에서 구현되는 경우 Windows Phone 자동화 인프라에 대한 클래스 고유 AutomationPeer 구현을 반환합니다. (UIElement에서 상속됨)
	ReadLocalValue	로컬 값이 설정된 경우, 종속성 속성의 로컬 값을 반환합니다. (DependencyObject에서 상속됨)
	ReleaseMouseCapture	터치 캡처를 UIElement에서 제거합니다. 이 메서드를 호출한 후에는 일반적으로 어떤 개체도 터치 캡처를 보유하지 않습니다. (UIElement에서 상속됨)
	RemoveHandler	이 UIElement에서 지정한 라우트된 이벤트 처리기를 제거합니다. (UIElement에서 상속됨)
	SetBinding	제공된 바인딩 개체를 사용하여 FrameworkElement에 바인딩을 연결하고 나중에 사용할 수 있도록 BindingExpressionBase를 반환합니다.
	SetValue	DependencyObject에 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
	ToString	현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
	TransformToVisual	좌표를 UIElement에서 지정된 개체로 변환하는 데 사용할 수 있는 변환 개체를 반환합니다. (UIElement에서 상속됨)
	UpdateLayout	모든 UIElement 자식 개체의 위치가 레이아웃에 맞게 적절하게 업데이트되도록 합니다. (UIElement에서 상속됨)

맨 위

이벤트

	이름	Description
	BindingValidationError	바인딩 소스에서 데이터 유효성 검사 오류를 보고할 때 발생합니다.
	DoubleTap	이 UIElement 위에 있는 동안 DoubleTap 제스처가 커밋되면 발생합니다. (UIElement에서 상속됨)
	GotFocus	UIElement가 포커스를 받을 때 발생합니다. (UIElement에서 상속됨)
	Hold	UIElement 위에 있는 동안 Hold 제스처가 커밋되면 발생합니다. (UIElement에서 상속됨)
	KeyDown	UIElement에 포커스가 있을 때 키보드 키를 누르면 발생합니다. (UIElement에서 상속됨)
	KeyUp	UIElement에 포커스가 있을 때 키보드 키를 놓으면 발생합니다. (UIElement에서 상속됨)
	LayoutUpdated	Windows Phone 시각적 트리의 레이아웃이 변경될 때 발생합니다.
	Loaded	FrameworkElement가 생성되어 개체 트리에 추가되면 이 이벤트가 발생합니다.
	LostFocus	UIElement가 포커스를 잃을 때 발생합니다. (UIElement에서 상속됨)
	LostMouseCapture	UIElement가 터치 캡처를 잃을 때 발생합니다. (UIElement에서 상속됨)
	ManipulationCompleted	UIElement에서 조작이 완료되고 활동이 없게 될 때 발생합니다. (UIElement에서 상속됨)
	ManipulationDelta	입력 장치에서 조작 중에 위치를 변경하면 발생합니다. (UIElement에서 상속됨)
	ManipulationStarted	입력 장치가 UIElement에서 조작을 시작할 때 발생합니다. (UIElement에서 상속됨)
	MouseEnter	화면 누르기가 UIElement의 경계 영역 내에서 발생할 때 발생합니다. (UIElement에서 상속됨)
	MouseLeave	터치 이벤트가 UIElement의 경계 영역 밖에서 발생할 때 발생합니다. (UIElement에서 상속됨)
	MouseLeftButtonDown	UIElement를 누르면 발생합니다. (UIElement에서 상속됨)
	MouseLeftButtonUp	UIElement에서 손가락을 올릴 때(또는 UIElement에서 터치 캡처를 보류하는 동안) 발생합니다. (UIElement에서 상속됨)
	MouseMove	화면의 손가락 좌표 위치가 UIElement를 터치하는 동안(또는 UIElement가 터치 캡처를 보류하는 동안) 발생합니다. (UIElement에서 상속됨)
	MouseWheel	인프라입니다. 마우스 포인터가 UIElement 위에 있거나 UIElement에 포커스가 있는 동안 사용자가 마우스 휠을 돌리면 이 이벤트가 발생합니다. (UIElement에서 상속됨)
	SizeChanged	FrameworkElement의 ActualHeight 또는 ActualWidth 속성 값이 변경될 때 발생합니다.
	Tap	이 UIElement 위에 있는 동안 Tap 제스처가 커밋되면 발생합니다. (UIElement에서 상속됨)
	TextInput	UI 요소가 장치 독립적인 방식으로 텍스트를 가져올 때 발생합니다. (UIElement에서 상속됨)
	TextInputStart	UI 요소가 장치 독립적인 방식으로 텍스트를 처음 가져올 때 발생합니다. (UIElement에서 상속됨)
	TextInputUpdate	IME(입력기)를 통해 텍스트가 계속 작성될 때 발생합니다. (UIElement에서 상속됨)
	Unloaded	이 개체가 기본 개체 트리에 더 이상 연결되지 않을 때 발생합니다.

맨 위

필드

	이름	Description
	ActualHeightProperty	ActualHeight 종속성 속성을 식별합니다.
	ActualWidthProperty	ActualWidth 종속성 속성을 식별합니다.
	CursorProperty	Cursor 종속성 속성을 식별합니다.
	DataContextProperty	DataContext 종속성 속성을 식별합니다.
	FlowDirectionProperty	FlowDirection 종속성 속성을 식별합니다.
	HeightProperty	Height 종속성 속성을 식별합니다.
	HorizontalAlignmentProperty	HorizontalAlignment 종속성 속성을 식별합니다.
	LanguageProperty	Language 종속성 속성을 식별합니다.
	LoadedEvent	Loaded 라우트된 이벤트를 식별합니다.
	MarginProperty	Margin 종속성 속성을 식별합니다.
	MaxHeightProperty	MaxHeight 종속성 속성을 식별합니다.
	MaxWidthProperty	MaxWidth 종속성 속성을 식별합니다.
	MinHeightProperty	MinHeight 종속성 속성을 식별합니다.
	MinWidthProperty	MinWidth 종속성 속성을 식별합니다.
	NameProperty	Name 종속성 속성을 식별합니다.
	StyleProperty	Style 종속성 속성을 식별합니다.
	TagProperty	Tag 종속성 속성을 식별합니다.
	UseOptimizedManipulationRoutingProperty	UseOptimizedManipulationRouting 종속성 속성을 식별합니다.
	VerticalAlignmentProperty	VerticalAlignment 종속성 속성을 식별합니다.
	WidthProperty	Width 종속성 속성을 식별합니다.

맨 위

설명

FrameworkElement는 UIElement를 확장하며 다음과 같은 기능을 추가합니다.

레이아웃: Windows Phone은 FrameworkElement에서 파생되는 개체를 인식할 수 있도록 레이아웃 시스템을 구현합니다. 레이아웃 시스템은 MinWidth를 비롯하여 FrameworkElement 수준에서 정의된 다양한 속성을 읽고 해당 클래스 구현에서 콘텐츠가 있는 패널과 컨트롤이 재정의할 수 있는 특수화된 레이아웃 동작에 대한 확장 가능한 메서드를 제공합니다.
개체 수명 이벤트: 개체가 처음 로드된 시기를 알면 유용할 때가 있습니다. 개체가 로드된 시점은 Windows Phone RootVisual에 연결하는 개체 트리에 개체가 연결되는 시점으로 정의됩니다. FrameworkElement는 개체 수명과 관련된 이벤트를 정의하며, 이러한 이벤트는 컬렉션에 자식 개체를 추가하거나 자식 개체를 사용하기 직전에 자식 개체의 속성을 설정하는 것과 같은 코드 숨김 작업에 유용한 후크를 제공합니다. 이때 개체 트리의 필요한 개체는 태그에서 인스턴스화됩니다.
데이터 바인딩의 데이터 컨텍스트 지원: 데이터 바인딩 및 리소스에 대한 속성 수준 지원은 DependencyProperty 클래스를 통해 구현되며, 모든 DependencyObject에 DependencyProperty가 있을 수 있습니다. 단, 상속된 데이터 컨텍스트의 값을 설정하는 기능은 FrameworkElement를 통해 구현됩니다.

대부분의 일반적인 Windows Phone 클래스는 FrameworkElement에서 직접 또는 Panel이나 Control 등의 중간 기본 클래스를 통해 파생됩니다.

UI 표시용 클래스의 경우 클래스에 필요한 특정 서비스(예: 템플릿 지원)가 이 수준에서 완전하게 구현되지 않기 때문에 대개는 FrameworkElement에서 직접 파생되지 않습니다. 파생된 사용자 지정 클래스에 일반적으로 사용되는 기본 클래스는 다음과 같습니다.

특정 컨트롤(예: TextBox)
컨트롤 기본 클래스(Control, ContentControl, UserControl)
Panel 클래스(기본 클래스인 Panel 또는 Grid와 같은 특정 패널 구현)

FrameworkElement에서는 다양한 기본 시나리오를 지원하지만 XAML에서 UI를 만드는 데 사용하는 빌딩 블록 개념의 "UI 요소"에 필요한 다양한 기능은 제공하지 않습니다. 대신 이러한 기능 대부분은 Control에서 구현되거나 FrameworkElement 바로 아래에 있는 다른 서브클래스에서 구현됩니다.

버전 정보