다음을 통해 공유


Element 클래스

정의

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

public ref class Element abstract : Microsoft::Maui::Controls::BindableObject, Microsoft::Maui::Controls::IEffectControlProvider, Microsoft::Maui::Controls::IElementController, Microsoft::Maui::Controls::Internals::INameScope, Microsoft::Maui::IContextFlyoutElement, Microsoft::Maui::IElement, Microsoft::Maui::IToolTipElement, Microsoft::Maui::IVisualTreeElement
public abstract class Element : Microsoft.Maui.Controls.BindableObject, Microsoft.Maui.Controls.IEffectControlProvider, Microsoft.Maui.Controls.IElementController, Microsoft.Maui.Controls.Internals.INameScope, Microsoft.Maui.IContextFlyoutElement, Microsoft.Maui.IElement, Microsoft.Maui.IToolTipElement, Microsoft.Maui.IVisualTreeElement
type Element = class
    inherit BindableObject
    interface INameScope
    interface IElementController
    interface IVisualTreeElement
    interface IElement
    interface IEffectControlProvider
    interface IToolTipElement
    interface IContextFlyoutElement
Public MustInherit Class Element
Inherits BindableObject
Implements IContextFlyoutElement, IEffectControlProvider, IElement, IElementController, INameScope, IToolTipElement, IVisualTreeElement
상속
파생
구현

설명

시각적 요소의 중요한 범주는 다음 표에 나와 있습니다.

수업 설명
VisualElement Element 화면의 영역을 차지하고 시각적으로 표시되며 터치 입력을 가져올 수 있습니다.
Cell 셀은 ListView 또는 TableView에 추가될 요소입니다.
Page VisualElement 화면의 대부분 또는 전체를 차지하고 단일 자식이 포함된 A입니다.
Layout Layout 형식 View의 단일 자식이 있는 반면 하위 클래스 Layout 에는 다른 레이아웃을 포함하여 여러 자식 뷰의 컬렉션이 있습니다.
컨트롤 및 특수화 View다이어그램의 아래쪽 부분에는 다음과 같이 Button TableView범용으로 사용할 수 있는 컨트롤에 대한 Microsoft.Maui.Controls 클래스가 표시됩니다.

생성자

Element()

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

필드

AutomationIdProperty

에 대한 바인딩 가능한 속성입니다 AutomationId.

ClassIdProperty

에 대한 바인딩 가능한 속성입니다 ClassId.

ControlsElementMapper
사용되지 않음.

접근성 서비스에 대한 플랫폼별 구현에 UI 정보 매핑

transientNamescope

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

속성

AutomationId

자동화 프레임워크가 이 요소를 찾고 상호 작용할 수 있는 값을 가져오거나 설정합니다.

BindingContext

BindableObject속성에 속하는 바인딩된 속성의 대상이 되는 속성을 포함하는 개체를 가져오거나 설정합니다. 이는 바인딩 가능한 속성입니다.

(다음에서 상속됨 BindableObject)
ClassId

의미상 유사한 요소의 컬렉션을 식별하는 데 사용되는 값을 가져오거나 설정합니다.

Dispatcher

이 바인딩 가능한 개체를 만들 때 사용할 수 있었던 디스패처를 가져오고, 그렇지 않으면 사용 가능한 가장 가까운 디스패처(창/앱)를 찾으려고 시도합니다.

(다음에서 상속됨 BindableObject)
EffectControlProvider

.NET MAUI에서 내부적으로 사용합니다.

Effects

런타임 동안 요소에 적용할 스타일 및 속성을 가져오거나 설정합니다.

Handler

이 요소에 연결된 처리기를 가져오거나 설정합니다.

Id

애플리케이션을 실행하는 동안 요소를 고유하게 식별하는 데 사용할 수 있는 값을 가져옵니다.

LogicalChildren
사용되지 않음.

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

Parent

이 요소의 부모를 Element 가져오거나 설정합니다.

RealParent

.NET MAUI에서 내부적으로 사용합니다.

StyleId

요소를 고유하게 식별하는 사용자 정의 값을 가져오거나 설정합니다.

메서드

AddLogicalChild(Element)

논리 자식에 추가 Element 합니다.

ApplyBindings()

현재 바인딩을 모두 적용합니다 BindingContext.

(다음에서 상속됨 BindableObject)
ClearLogicalChildren()

모든 자식 ElementS를 제거합니다.

ClearValue(BindableProperty)

바인딩 가능한 속성에 대해 이전에 설정된 값을 지웁니다.

(다음에서 상속됨 BindableObject)
ClearValue(BindablePropertyKey)

키로 식별된 바인딩 가능한 속성에 대해 이전에 설정된 값을 지웁니다.

(다음에서 상속됨 BindableObject)
CoerceValue(BindableProperty)

지정된 바인딩 가능 속성의 값을 강제 변환합니다. 이 작업은 지정된 바인딩 가능한 속성을 호출하여 BindableProperty.CoerceValueDelegate 수행됩니다.

(다음에서 상속됨 BindableObject)
CoerceValue(BindablePropertyKey)

지정된 바인딩 가능 속성의 값을 강제 변환합니다. 이 작업은 지정된 바인딩 가능한 속성을 호출하여 BindableProperty.CoerceValueDelegate 수행됩니다.

(다음에서 상속됨 BindableObject)
EffectIsAttached(String)

.NET MAUI에서 내부적으로 사용합니다.

FindByName(String)

지정된 이름을 갖는 요소를 반환합니다.

GetValue(BindableProperty)

지정된 바인딩 가능한 속성에 포함된 값을 반환합니다.

(다음에서 상속됨 BindableObject)
InsertLogicalChild(Int32, Element)

지정된 인 Element 덱스에 논리 자식에 삽입합니다.

IsSet(BindableProperty)

바인딩 가능한 속성이 있고 값 집합이 있는지 여부를 확인합니다.

(다음에서 상속됨 BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)

추상 ExcludedWithChildrenProperty 속성을 플랫폼별 구현에 매핑합니다.

MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)

추상 IsInAccessibleTreeProperty 속성을 플랫폼별 구현에 매핑합니다.

OnBindingContextChanged()

요소의 바인딩 컨텍스트가 변경될 때마다 호출됩니다. 이 이벤트에 대한 클래스 처리를 추가하려면 이 메서드를 구현합니다.

OnChildAdded(Element)

ChildAdded 이벤트를 발생시킵니다. 이 이벤트에 대한 클래스 처리를 추가하려면 이 메서드를 구현합니다.

OnChildRemoved(Element, Int32)

ChildRemoved 이벤트를 발생시킵니다. 이 이벤트에 대한 클래스 처리를 추가하려면 이 메서드를 구현합니다.

OnHandlerChanged()

파생 클래스에서 재정의되는 경우 이벤트를 발생 HandlerChanged 시켜야 합니다.

OnHandlerChanging(HandlerChangingEventArgs)

파생 클래스에서 재정의되는 경우 이벤트를 발생 HandlerChanging 시켜야 합니다.

OnParentChanged()

파생 클래스에서 재정의되는 경우 이벤트를 발생 ParentChanged 시켜야 합니다.

OnParentChanging(ParentChangingEventArgs)

파생 클래스에서 재정의되는 경우 이벤트를 발생 ParentChanging 시켜야 합니다.

OnParentSet()

(내부) ParentSet 이벤트를 발생합니다. 요소가 부모에 추가될 때 동작을 추가하려면 이 메서드를 구현합니다.

OnPropertyChanged(String)

바인딩된 속성이 변경될 때 호출되는 메서드입니다.

OnPropertyChanging(String)

PropertyChanging 이벤트를 발생시킵니다.

(다음에서 상속됨 BindableObject)
RemoveBinding(BindableProperty)

바인딩 가능한 속성에서 이전에 설정된 바인딩을 제거합니다.

(다음에서 상속됨 BindableObject)
RemoveDynamicResource(BindableProperty)

이전에 설정한 동적 리소스를 제거합니다.

RemoveLogicalChild(Element)

논리적 자식에서 특정 Element 항목의 첫 번째 항목을 제거합니다.

SetBinding(BindableProperty, BindingBase)

바인딩 가능한 속성에 바인딩을 할당합니다.

(다음에서 상속됨 BindableObject)
SetDynamicResource(BindableProperty, String)

제공된 BindableProperty 키를 사용하여 DynamicResource를 통해 업데이트할 이 요소의 속성을 설정합니다.

SetValue(BindableProperty, Object)

지정된 바인딩 가능 속성의 값을 설정합니다.

(다음에서 상속됨 BindableObject)
SetValue(BindablePropertyKey, Object)

지정된 바인딩 가능 속성의 값을 설정합니다.

(다음에서 상속됨 BindableObject)
SetValueFromRenderer(BindableProperty, Object)

.NET MAUI에서 내부적으로 사용합니다.

SetValueFromRenderer(BindablePropertyKey, Object)

.NET MAUI에서 내부적으로 사용합니다.

UnapplyBindings()

현재 컨텍스트에서 모든 현재 바인딩을 제거합니다.

(다음에서 상속됨 BindableObject)

이벤트

BindingContextChanged

BindingContext 속성 값이 변경되면 발생합니다.

(다음에서 상속됨 BindableObject)
ChildAdded

자식 요소가 요소에 추가될 때마다 발생합니다.

ChildRemoved

자식 요소가 요소에서 제거될 때마다 발생합니다.

DescendantAdded

자식 요소가 요소의 하위 트리에 추가될 때마다 발생합니다.

DescendantRemoved

자식 요소가 요소 하위 트리에서 제거될 때마다 발생합니다.

HandlerChanged

요소의 처리기가 변경될 때마다 발생합니다.

HandlerChanging

요소의 처리기가 변경되기 시작할 때마다 발생합니다.

ParentChanged

요소의 부모가 변경될 때마다 발생합니다.

ParentChanging

요소의 변경이 시작될 때마다 발생합니다.

PropertyChanged

속성 값이 변경되면 발생합니다.

(다음에서 상속됨 BindableObject)
PropertyChanging

속성 값이 변경되면 발생합니다.

(다음에서 상속됨 BindableObject)

명시적 인터페이스 구현

IContextFlyoutElement.ContextFlyout

뷰에 ContextFlyout 대한 값을 가져옵니다. 메뉴 플라이아웃, 메뉴 플라이아웃 하위 항목 및 메뉴 플라이아웃 구분 기호를 컨텍스트 플라이아웃에 추가할 수 있습니다.

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

(다음에서 상속됨 BindableObject)
IEffectControlProvider.RegisterEffect(Effect)

지정된 요소를 이 요소에 등록합니다 effect .

IElement.Parent

요소의 부모를 가져옵니다.

IElementController.Descendants()

.NET MAUI에서 내부적으로 사용합니다.

IElementController.LogicalChildren

.NET MAUI에서 내부적으로 사용합니다.

IElementController.SetValueFromRenderer(BindableProperty, Object)

.NET MAUI에서 내부적으로 사용합니다.

INameScope.RegisterName(String, Object)

.NET MAUI에서 내부적으로 사용합니다.

INameScope.UnregisterName(String)

.NET MAUI에서 내부적으로 사용합니다.

IToolTipElement.ToolTip

사용자가 뷰에 포인터를 놓을 때 보기의 용도에 대한 간략한 설명을 표시하는 작은 사각형 팝업 창을 나타냅니다.

IVisualTreeElement.GetVisualChildren()

요소의 시각적 자식에 대한 읽기 전용 목록을 가져옵니다.

IVisualTreeElement.GetVisualParent()

요소의 시각적 부모를 가져옵니다.

확장 메서드

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

SetAppTheme<T>(BindableObject, BindableProperty, T, T)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

속성에 바인딩을 만들고 적용합니다.

SetBinding<TSource,TProperty>(BindableObject, BindableProperty, Func<TSource,TProperty>, BindingMode, IValueConverter, Object, String, Object, Object, Object)

원본 개체의 속성과 대상 개체의 속성 간에 바인딩을 만듭니다.

FindByName<T>(Element, String)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

ToHandler(IElement, IMauiContext)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

ToPlatform(IElement, IMauiContext)

모든 Microsoft.Maui.Controls 계층 요소에 대한 기본 클래스를 제공합니다. 이 클래스에는 Microsoft.Maui.Controls 계층 구조의 요소를 나타내는 데 필요한 모든 메서드와 속성이 포함됩니다.

GetVisualElementWindow(IVisualTreeElement)

요소가 하나 안에 포함된 경우 Visual Tree 요소가 포함된 창을 가져옵니다.

GetVisualTreeDescendants(IVisualTreeElement)

하위 항목의 전체 계층을 지정된 Visual Tree 요소에 대한 자식 목록으로 가져옵니다.

GetVisualTreeElements(IVisualTreeElement, Point)

지정된 점을 기반으로 하는 Visual Tree 요소의 자식 목록을 가져옵니다.

GetVisualTreeElements(IVisualTreeElement, Rect)

사각형을 기반으로 하는 시각적 트리 요소 자식 목록을 가져옵니다.

GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)

픽셀이 아닌 플랫폼 단위로 지정된 좌표로 정의된 사각형을 기반으로 하는 Visual Tree Elements 자식 목록을 가져옵니다.

GetVisualTreeElements(IVisualTreeElement, Double, Double)

지정된 x, y 점을 기반으로 하는 Visual Tree Elements 자식 목록을 가져옵니다.

적용 대상