UWP API とライブラリの Windows App SDK へのマッピング
このトピックでは、UWP API とそれに対応する Windows App SDK とのマッピングについて説明します。 場合によっては、マッピングが 1 対 1 ではないことがあります。名前空間またはクラスについては、どちらのプラットフォームもほぼ同等の機能が用意されています。
2 つのプラットフォーム間で、名前空間とクラス (UI コントロールを含む) の名前に違いがあります。 多くの場合、名前空間名を簡単に変更するだけでコードはコンパイルします。 名前空間名に加えて、クラス名または API 名も変更される場合があります。 マッピングに若干の追加作業が必要になり、まれにアプローチの変更が必要になることもあります。
テーブルの使用方法。 まず、使用するクラス メンバーの名前を検索します。 メンバーは、単純なクラス名または名前空間名の変更よりもマッピングが複雑になるたびに一覧表示されます。 お使いのメンバーが一覧に表示されない場合、使用するクラスの名前を検索します。 クラスは、単なる名前空間名の変更よりもマッピングが複雑になる場合は常に表示されます (これに関する特有のガイダンスについては、「機能領域ガイド」を参照してください)。 クラスが一覧に表示されない場合、マッピングは名前空間の変更のみです。 したがって、クラスの名前空間名を探すことで、対応する Windows App SDK の名前空間名が見つかります。 目的のクラスはその名前空間に含まれています。 名前空間が一覧に表示されない場合、その名前は変更されていません。
UWP | Windows App SDK |
---|---|
(Windows.ApplicationModel.Activation) LaunchActivatedEventArgs クラス | (Microsoft.UI.Xaml) LaunchActivatedEventArgs クラス。たとえば、App.OnLaunched内。 |
(Windows.ApplicationModel.Core) CoreApplication.CreateNewView メソッド | (Microsoft.UI.Windowing) AppWindow.Create メソッド |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar クラス | (Microsoft.UI.Windowing) AppWindowTitleBar クラス |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar プロパティ | (Microsoft.UI.Windowing) AppWindowTitleBar.ExtendsContentIntoTitleBar プロパティ。 プラットフォームでは、[最小化]/[最大化]/[閉じる] ボタンが自動的に表示され、閉鎖情報が報告されます。 |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height プロパティ | (Microsoft.UI.Windowing) AppWindowTitleBar.Height プロパティ |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset プロパティ | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset プロパティ |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset プロパティ | (Microsoft.UI.Windowing) AppWindowTitleBar.RightInset プロパティ |
Windows.ApplicationModel.Resources.Core 名前空間 | Microsoft.Windows.ApplicationModel.Resources。 「MRT から MRT Core への移行」を参照してください。 |
(Windows.ApplicationModel.Resources.Core) ResourceContext.GetForCurrentView メソッド | (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext メソッド。 「ResourceContext.GetForCurrentView、ResourceContext.GetForViewIndependentUse」を参照してください。 |
(Windows.ApplicationModel.Resources.Core) ResourceContext.GetForViewIndependentUse メソッド | (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext メソッド。 「ResourceContext.GetForCurrentView、ResourceContext.GetForViewIndependentUse」を参照してください。 |
(Windows.ApplicationModel.Resources.Core) ResourceManager.Current プロパティ | Create a new (Microsoft.Windows.ApplicationModel.Resources) ResourceManager オブジェクト。 「ResourceManager クラス」を参照してください。 |
(Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged イベント | 環境の変更は自分で検出します。 「リソース修飾子の値の変更」を参照してください。 |
(Windows.Graphics.Printing) PrintManager クラス | Windows App SDK 1.0 ではサポートされていません。 |
(Windows.Media.Capture) CameraCaptureUI クラス | Windows App SDK 1.0 ではサポートされていません。 |
(Windows.Security.Authentication.Web) WebAuthenticationBroker クラス | Windows App SDK 1.0 ではサポートされていません。 |
(Windows.Storage.Pickers) FileOpenPicker, FileSavePickerおよび FolderPicker クラス | サポートされていますが、IInitializeWithWindow インターフェイスを使用する必要があります。 「MessageDialog、およびピッカー」を参照してください。 |
(Windows.System.Display) DisplayRequest クラス | Windows App SDK 1.0 ではサポートされていません。 |
Windows.UI.Composition 名前空間 | Microsoft.UI.Composition 名前空間 |
(Windows.UI.Core) CoreDispatcher クラス | (Microsoft.UI.Dispatching) DispatcherQueue クラス。 「CoreDispatcher を DispatcherQueue に変更する」を参照してください。 |
(Windows.UI.Core) CoreDispatcher.RunAsync メソッド | (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue メソッド。 「RunAsync を DispatcherQueue.TryEnqueue に変更する」を参照してください。 |
(Windows.UI.Core) CoreWindow クラス | (Microsoft.UI.Windowing) AppWindow クラス。 「ウィンドウ機能の移行」を参照してください。 |
(Windows.UI.Core) CoreWindow.Bounds プロパティ (C# では、一般的に、CoreWindow.GetForCurrentThread.Bounds として表示されます) |
(Microsoft.UI.Windowing) AppWindow.Size プロパティ |
(Windows.UI.Core) CoreWindow.GetForCurrentThread メソッド | Windows アプリ SDK API への直接 1 対 1 のマッピングはありません。 XAML を使用する場合は、Window.AppWindow を取得して XAML Window に関連付けられた AppWindow を取得できますが、アプリがアクセスできない場所からアクセスする場合は、Window または AppWindow をキャッシュする必要があります。 App オブジェクトで Window をキャッシュして公開することをお勧めします。 |
(Windows.UI.Core) CoreWindow.Activate メソッド | (Microsoft.UI.Windowing) AppWindow.Show メソッド |
(Windows.UI.Core) CoreWindow.Dispatcher プロパティ | (Microsoft.UI.Xaml) Window.DispatcherQueue プロパティ。 「CoreWindow.Dispatcher を Window.DispatcherQueue に変更する」を参照してください。 |
(Windows.UI.Core) CoreWindow.SizeChanged イベント | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange メソッド |
(Windows.UI.Core) SystemNavigationManager クラス (グローバル戻るボタン) | サポートされていません。 独自の UI 内に [戻る] ボタンを実装します。 「UWP PhotoLab サンプルアプリの Windows App SDK の移行 (C#)」を参照してください。 |
(Windows.UI.Core) WindowSizeChangedEventArgs クラス | (Microsoft.UI.Xaml) WindowSizeChangedEventArgs クラス。たとえば、Window.SizeChanged 用のハンドラー (Microsoft.UI.Xaml) 内。 |
(Windows.UI.Popups) MessageDialog クラス | サポートされていますが、IInitializeWithWindow インターフェイスを使用する必要があります。 「MessageDialog、およびピッカー」を参照してください。 |
(Windows.UI.Text.Core) CoreTextServicesManager クラス | Windows 11 でのみサポートされています。 |
(Windows.UI.ViewManagement) ApplicationView クラス | (Microsoft.UI.Windowing) AppWindow クラス |
(Windows.UI.ViewManagement) ApplicationView.Title プロパティ | (Microsoft.UI.Windowing) AppWindow.Title プロパティ |
(Windows.UI.ViewManagement) ApplicationView.TryConsolidateAsync メソッド | (Microsoft.UI.Windowing) AppWindow.Destroy メソッド |
(Windows.UI.ViewManagement) ApplicationView.TryEnterFullScreenMode メソッド | (Microsoft.UI.Windowing) AppWindow.SetPresenter メソッドと AppWindowPresenterKind.FullScreen |
(Windows.UI.ViewManagement) ApplicationView.TryEnterViewModeAsync メソッドと ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) AppWindow.SetPresenter メソッドと AppWindowPresenterKind.CompactOverlay |
(Windows.UI.ViewManagement) ApplicationView.TryResizeView メソッド | (Microsoft.UI.Windowing) AppWindow.Resize メソッド |
(Windows.UI.ViewManagement) ApplicationViewMode.CompactOverlay フィールド | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay フィールド |
(Windows.UI.ViewManagement) ApplicationViewTitleBar クラス | (Microsoft.UI.Windowing) AppWindowTitleBar クラス |
(Windows.UI.ViewManagement) ApplicationViewWindowingMode.FullScreen フィールド | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen フィールド |
(Windows.UI.WindowManagement) AppWindow クラス | (Microsoft.UI.Windowing) AppWindow クラス |
(Windows.UI.WindowManagement) AppWindow.Changed イベント | (Microsoft.UI.Windowing) Microsoft.UI.Windowing.AppWindow.Changed イベント |
(Windows.UI.WindowManagement) AppWindow.CloseAsync メソッド | (Microsoft.UI.Windowing) AppWindow.Destroy メソッド |
(Windows.UI.WindowManagement) AppWindow.GetPlacement メソッド | (Microsoft.UI.Windowing) AppWindow.Position プロパティ |
(Windows.UI.WindowManagement) Appwindow.RequestMoveXxx メソッド | (Microsoft.UI.Windowing) AppWindow.Move メソッド |
(Windows.UI.WindowManagement) AppWindow.RequestSize メソッド | (Microsoft.UI.Windowing) AppWindow.Resize メソッド |
(Windows.UI.WindowManagement) AppWindow.Title プロパティ | (Microsoft.UI.Windowing) AppWindow.Title プロパティ |
(Windows.UI.WindowManagement) AppWindow.TryCreateAsync メソッド | (Microsoft.UI.Windowing) AppWindow.Create メソッド |
(Windows.UI.WindowManagement) AppWindow.TryShowAsync メソッド | (Microsoft.UI.Windowing) AppWindow.Show メソッド |
(Windows.UI.WindowManagement) AppWindowChangedEventArgs.DidSizeChange メソッド | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange メソッド |
(Windows.UI.WindowManagement) AppWindowPlacement.Size プロパティ | (Microsoft.UI.Windowing) AppWindow.Size プロパティ |
(Windows.UI.WindowManagement) AppWindowPresentationKind.CompactOverlay フィールド | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay フィールド |
(Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen フィールド | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen フィールド |
(Windows.UI.WindowManagement) AppWindowPresenter.RequestPresentation メソッド | (Microsoft.UI.Windowing) AppWindow.SetPresenter メソッド |
(Windows.UI.WindowManagement) AppWindowTitleBar クラス | (Microsoft.UI.Windowing) AppWindowTitleBar クラス |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Windows App SDK API への 1:1 の直接マッピングはありません |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset および RightInset を Height と組み合わせると、同じ情報が提供されます。 |
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Windows App SDK API への 1:1 の直接マッピングはありません |
(Windows.UI.WindowManagement) AppWindowTitleBarOcclusion プロパティ | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset および RightInset を Height と組み合わせると、同じ情報が提供されます。 |
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Windows App SDK API への 1:1 の直接マッピングはありません |
Windows.UI.Xaml 名前空間 | Microsoft.UI.Xaml 名前空間 |
(Windows.UI.Xaml) Application.OnActivated メソッド (C# では、一般的に、App.OnActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnBackgroundActivated メソッド (C# では、一般的に、App.OnBackgroundActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated method (C# では、一般的に、App.OnCachedFileUpdaterActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnFileActivated method (C# では、一般的に、App.OnFileActivated として表示されます) |
「ファイルの種類の関連付け」および「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnFileOpenPickerActivated メソッド (C# では、一般的に、App.OnFileOpenPickerActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnFileSavePickerActivated メソッド (C# では、一般的に、App.OnFileSavePickerActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnSearchActivated メソッド (C# では、一般的に、App.OnSearchActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Application.OnShareTargetActivated メソッド (C# では、一般的に、App.OnShareTargetActivated として表示されます) |
「OnActivated、OnBackgroundActivated、その他のアクティブ化処理メソッド」を参照してください。 |
(Windows.UI.Xaml) Window.Current プロパティ | 非推奨。null を返します。 代替の方法については、「Window.Current を App.Window に変更する」を参照してください。 |
(Windows.UI.Xaml) Window.Dispatcher プロパティ (C# では、一般的に、Window.Current.Dispatcher として表示されます) |
(Microsoft.UI.Xaml) Window.DispatcherQueue プロパティ |
(Windows.UI.Xaml.Controls) ContentDialog クラス | (Microsoft.UI.Xaml.Controls) ContentDialog はサポートされていますが、その XamlRoot プロパティを設定する必要があります。 「ContentDialog および Popup」を参照してください。 |
(Windows.UI.Xaml.Controls) InkCanvas クラス | Windows App SDK 1.0 ではサポートされていません。 |
(Windows.UI.Xaml.Controls) MediaElement クラス | Windows App SDK 1.0 ではサポートされていません。 |
(Windows.UI.Xaml.Controls.Maps) MapControl クラス | (Microsoft.UI.Xaml.Controls) MapControl クラス |
(Windows.UI.Xaml.Controls.Primitives) Popup クラス | (Microsoft.UI.Xaml.Controls.Primitives) Popup はサポートされていますが、その XamlRoot プロパティを設定する必要があります。 「ContentDialog および Popup」を参照してください。 |
(Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource プロパティ | IWindows App SDK 内では、(Microsoft.UI.Xaml.Media) AcrylicBrush は常にアプリ コンテンツからサンプルを収集します。 「AcrylicBrush.BackgroundSource プロパティ」を参照してください。 |
C++/WinRT。 co_await winrt.resume_foreground(this->Dispatcher()); |
「winrt.resume_foreground の移行」を参照してください |
サードパーティ製ライブラリ
このセクションでは、UWP でサポートされており、WinUI 3 を使用する場合に変更する必要があるさまざまなライブラリについて説明します。
UWP | Windows App SDK |
---|---|
OneDrive SDK | Microsoft Graph SDK |
参照
Windows developer