처리기

.NET 다중 플랫폼 앱 UI(.NET MAUI)는 데이터를 표시하고, 작업을 시작하고, 활동을 나타내고, 컬렉션을 표시하고, 데이터를 선택하는 데 사용할 수 있는 플랫폼 간 컨트롤 컬렉션을 제공합니다. 각 컨트롤에는 컨트롤을 추상화하는 인터페이스 표현이 있습니다. 이러한 인터페이스를 구현하는 플랫폼 간 컨트롤은 가상 보기로 알려져 있습니다. 처리기는 이러한 가상 보기를 각 플랫폼의 컨트롤에 매핑할 있습니다. 이 컨트롤은 네이티브 뷰. 또한 처리기는 기본 네이티브 뷰를 인스턴스화하고 플랫폼 간 제어 API를 네이티브 뷰 API에 매핑합니다. 예를 들어, iOS에서 처리기가 .NET MAUI Button을 iOS UIButton로 매핑합니다. Android에서는 Button가 MaterialButton로 매핑됩니다.

.NET MAUI 핸들러는 Button에 대한 IButton과 같은 컨트롤별 인터페이스를 통해 액세스됩니다. 이것은 플랫폼 간 컨트롤이 처리기를 참조해야 하는 상황과 처리기가 플랫폼 간 컨트롤을 참조해야 하는 상황을 피할 수 있게 해줍니다.

각 처리기 클래스는 PlatformView 속성을 통해 플랫폼 간 컨트롤에 대한 네이티브 뷰를 노출합니다. 이 속성에 액세스하여 네이티브 뷰 속성을 설정하고, 네이티브 뷰 메서드를 호출하고, 네이티브 뷰 이벤트를 구독할 수 있습니다. 또한 처리기에 의해 구현된 플랫폼 간 컨트롤은 해당 VirtualView 속성을 통해 노출됩니다.

네이티브 뷰를 통해 각 플랫폼에서 구현이 제공되는 플랫폼 간 컨트롤을 만들 때 플랫폼 간 컨트롤 API를 네이티브 뷰 API에 매핑하는 처리기를 구현해야 합니다. 자세한 내용은 처리기를 사용하여 사용자 지정 컨트롤 만들기를 참조하세요.

처리기를 사용자 지정하여 컨트롤의 API를 통해 가능한 사용자 지정 외에 기존 플랫폼 간 컨트롤의 모양과 동작을 보강할 수도 있습니다. 이 처리기 사용자 지정은 플랫폼 간 컨트롤에 대한 네이티브 보기를 수정합니다. 처리기는 전역적이며, 컨트롤에 대한 처리기를 사용자 지정하면 앱에서 동일한 형식의 모든 컨트롤이 모두 사용자 지정됩니다. 자세한 내용은처리기를 사용하여 .NET MAUI 컨트롤 사용자 지정 참조하세요.

매퍼

.NET MAUI 처리기의 핵심 개념은 매퍼들입니다. 각 처리기는 일반적으로 플랫폼 간 컨트롤의 API를 네이티브 뷰의 API에 매핑하는 속성 매퍼를 제공하고, 때로는 명령 매퍼도 제공합니다.

속성 매퍼 플랫폼 간 컨트롤에서 속성 변경이 발생할 때 수행할 작업을 정의합니다. 'Dictionary'은/는 플랫폼 간 컨트롤의 속성을 관련 작업에 매핑하는 것입니다. 그런 다음 각 플랫폼 처리기는 네이티브 뷰 API를 조작하는 Actions의 구현을 제공합니다. 이렇게 하면 플랫폼 간 컨트롤에 속성이 설정되면 기본 네이티브 뷰가 필요에 따라 업데이트됩니다.

명령 매퍼 플랫폼 간 컨트롤이 네이티브 뷰에 명령을 보낼 때 수행할 작업을 정의합니다. 속성 매퍼와 비슷하지만 추가 데이터를 전달할 수 있는 기능을 제공합니다. 이 컨텍스트의 명령은 ICommand 구현을 의미하지 않습니다. 대신에 명령은 단순히 지시 사항이며, 선택적으로 기본 보기로 전송되는 데이터입니다. 명령 매퍼는 플랫폼 간 컨트롤의 명령을 해당 작업과 연결하는 Dictionary입니다. 그런 다음 각 처리기는 네이티브 뷰 API를 조작하는 Actions의 구현을 제공합니다. 이렇게 하면 플랫폼 간 컨트롤이 명령을 네이티브 보기로 보낼 때 필요에 따라 네이티브 뷰가 업데이트됩니다. 예를 들어 ScrollView 스크롤되면 ScrollViewHandler 명령 매퍼를 사용하여 스크롤 위치 인수를 허용하는 작업을 호출합니다. 그런 다음 작업은 기본 네이티브 뷰에 해당 위치로 스크롤하도록 명령합니다.

네이티브 뷰를 업데이트하기 위해 매퍼를 사용하면 네이티브 뷰를 플랫폼 간 컨트롤에서 분리할 수 있다는 장점이 있습니다. 이렇게 하면 네이티브 뷰가 플랫폼 간 제어 이벤트를 구독하고 구독을 취소할 필요가 없습니다. 또한 서브클래싱 없이 매퍼를 수정할 수 있으므로 쉽게 사용자 지정할 수 있습니다.

처리기 수명 주기

모든 처리기 기반 .NET MAUI 컨트롤은 두 개의 처리기 수명 주기 이벤트를 지원합니다.

• HandlerChanging 플랫폼 간 컨트롤에 대해 새 처리기를 만들려는 경우와 플랫폼 간 컨트롤에서 기존 처리기를 제거하려고 할 때 발생합니다. 이 이벤트와 함께하는 HandlerChangingEventArgs 개체는 IElementHandler형식의 NewHandler과 OldHandler 속성을 가지고 있습니다. NewHandler 속성이 null않으면 이벤트는 플랫폼 간 컨트롤에 대한 새 처리기를 만들 예정임을 나타냅니다. OldHandler 속성이 null이 아니면, 이벤트는 기존 네이티브 컨트롤이 플랫폼 간 컨트롤에서 제거될 것임을 나타내므로, 모든 네이티브 이벤트 연결을 해제하고 추가 정리를 수행해야 합니다.
• 플랫폼 간 컨트롤을 위한 처리기가 생성된 후, HandlerChanged 이벤트가 발생합니다. 이 이벤트는 플랫폼 간 컨트롤을 구현하는 네이티브 컨트롤을 사용할 수 있으며 플랫폼 간 컨트롤에 설정된 모든 속성 값이 네이티브 컨트롤에 적용되었음을 나타냅니다.

메모

HandlerChanging 이벤트는 HandlerChanged 이벤트 전에 플랫폼 간 컨트롤에서 발생합니다.

이러한 이벤트 외에도 각 플랫폼 간 컨트롤에는 HandlerChanging 이벤트가 발생할 때 호출되는 재정의 가능한 OnHandlerChanging 메서드와 HandlerChanged 이벤트가 발생할 때 호출되는 OnHandlerChanged 메서드도 있습니다.

처리기 보기

다음 표에서는 .NET MAUI에서 뷰를 구현하는 형식을 나열합니다.

보기	인터페이스	처리기	속성 맵퍼	명령 매핑 도구
ActivityIndicator	IActivityIndicator	ActivityIndicatorHandler	Mapper	CommandMapper
BlazorWebView	IBlazorWebView	BlazorWebViewHandler	BlazorWebViewMapper
Border	IBorderView	BorderHandler	Mapper	CommandMapper
BoxView	IShapeView, IShape	ShapeViewHandler	Mapper	CommandMapper
Button	IButton	ButtonHandler	ImageButtonMapper, TextButtonMapper, Mapper	CommandMapper
CarouselView		CarouselViewHandler	Mapper
Cell		CellRenderer	Mapper	CommandMapper
CheckBox	ICheckBox	CheckBoxHandler	Mapper	CommandMapper
CollectionView		CollectionViewHandler	<Mapper
ContentView	IContentView	ContentViewHandler	Mapper	CommandMapper
DatePicker	IDatePicker	DatePickerHandler	Mapper	CommandMapper
Editor	IEditor	EditorHandler	Mapper	CommandMapper
Ellipse	IShape	ShapeViewHandler	Mapper	CommandMapper
Entry	IEntry	EntryHandler	Mapper	CommandMapper
EntryCell		EntryCellRenderer	Mapper	CommandMapper
Frame		FrameRenderer	Mapper	CommandMapper
GraphicsView	IGraphicsView	GraphicsViewHandler	Mapper	CommandMapper
Image	IImage	ImageHandler	Mapper	CommandMapper
ImageButton	IImageButton	ImageButtonHandler	ImageMapper, Mapper
ImageCell		ImageCellRenderer	Mapper	CommandMapper
IndicatorView	IIndicatorView	IndicatorViewHandler	Mapper	CommandMapper
Label	ILabel	LabelHandler	Mapper	CommandMapper
Line	IShape	LineHandler	Mapper	CommandMapper
ListView		ListViewRenderer	Mapper	CommandMapper
Map	IMap	MapHandler	Mapper	CommandMapper
Path	IShape	PathHandler	Mapper	CommandMapper
Picker	IPicker	PickerHandler	Mapper	CommandMapper
Polygon	IShape	PolygonHandler	Mapper	CommandMapper
Polyline	IShape	PolylineHandler	Mapper	CommandMapper
ProgressBar	IProgress	ProgressBarHandler	Mapper	CommandMapper
RadioButton	IRadioButton	RadioButtonHandler	Mapper	CommandMapper
Rectangle	IShape	RectangleHandler	Mapper	CommandMapper
RefreshView	IRefreshView	RefreshViewHandler	Mapper	CommandMapper
RoundRectangle	IShape	RoundRectangleHandler	Mapper	CommandMapper
ScrollView	IScrollView	ScrollViewHandler	Mapper	CommandMapper
SearchBar	ISearchBar	SearchBarHandler	Mapper	CommandMapper
Slider	ISlider	SliderHandler	Mapper	CommandMapper
Stepper	IStepper	StepperHandler	Mapper	CommandMapper
SwipeView	ISwipeView	SwipeViewHandler	Mapper	CommandMapper
Switch	ISwitch	SwitchHandler	Mapper	CommandMapper
SwitchCell		SwitchCellRenderer	Mapper	CommandMapper
TableView		TableViewRenderer	Mapper	CommandMapper
TextCell		TextCellRenderer	Mapper	CommandMapper
TimePicker	ITimePicker	TimePickerHandler	Mapper	CommandMapper
ViewCell		ViewCellRenderer	Mapper	CommandMapper
WebView	IWebView	WebViewHandler	Mapper	CommandMapper

페이지 처리기

다음 표에서는 .NET MAUI에서 페이지를 구현하는 형식을 나열합니다.

페이지	Android 핸들러	iOS/Mac Catalyst 핸들러	Windows 핸들러	속성 매핑 도구	명령 매핑 도구
ContentPage	PageHandler	PageHandler	PageHandler	Mapper	CommandMapper
FlyoutPage	FlyoutViewHandler	PhoneFlyoutPageRenderer	FlyoutViewHandler	Mapper	CommandMapper
NavigationPage	NavigationViewHandler	NavigationRenderer	NavigationViewHandler	Mapper	CommandMapper
TabbedPage	TabbedViewHandler	태브드렌더러	TabbedViewHandler	Mapper	CommandMapper
Shell	ShellHandler	ShellRenderer	ShellRenderer	Mapper	CommandMapper