このトピックでは、UWP API と同等のWindows アプリ SDKに対応する UWP API のマッピングについて説明します。 場合によっては、マッピングが 1 対 1 ではないことがあります。名前空間またはクラスについては、どちらのプラットフォームもほぼ同等の機能が用意されています。
2 つのプラットフォーム間で、名前空間とクラス (UI コントロールを含む) の名前に違いがあります。 多くの場合、名前空間名を簡単に変更するだけでコードはコンパイルします。 名前空間名に加えて、クラス名または API 名も変更される場合があります。 マッピングに若干の追加作業が必要になり、まれにアプローチの変更が必要になることもあります。
テーブルの使用方法。 まず、使用するクラス メンバーの名前を検索します。 メンバーは、単純なクラス名または名前空間名の変更よりもマッピングが複雑になるたびに一覧表示されます。 お使いのメンバーが一覧に表示されない場合、使用するクラスの名前を検索します。 マッピングが単純に名前空間名を変更するよりも複雑な場合は常にクラスが一覧表示されます (具体的なガイダンスについては、Feature 領域guidesを参照してください)。 クラスが一覧に表示されない場合、マッピングは名前空間の変更のみです。 そのため、クラスの名前空間の名前を見つけて、同等のWindows アプリ SDKの名前空間の名前を見つけます。 目的のクラスはその名前空間に含まれています。 名前空間が一覧に表示されない場合、その名前は変更されていません。
| UWP | Windows アプリ SDK |
|---|---|
| (Windows.ApplicationModel.Activation) LaunchActivatedEventArgs クラス | (Microsoft.UI.Xaml) LaunchActivatedEventArgs クラス;たとえば、 App.OnLaunched などです。 |
| (Windows.ApplicationModel.Background) BackgroundTaskBuilder クラス | (Microsoft.Windows.ApplicationModel.Background) BackgroundTaskBuilder クラス。 「Windows アプリでのバックグラウンド タスクの使用」を参照してください。 |
| (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 プロパティ。 プラットフォームは引き続き 最小化/Maximize/Close ボタンを描画し、オクルージョン情報を報告します。 |
| (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 プロパティ | 新しい (Microsoft.Windows.ApplicationModel.Resources) ResourceManager オブジェクトを作成します。 「ResourceManager クラスを参照してください。 |
| (Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged イベント | 環境の変更は自分で検出します。 「Resource 修飾子値の変更を参照してください。 |
| (Windows.Graphics.Printing) PrintManager クラス | Windows アプリ SDK 1.0 ではサポートされていません。 |
| (Windows.Media.Capture) CameraCaptureUI クラス | (Microsoft.Windows.Media.Capture) CameraCaptureUI クラス |
| (Windows.Security.Authentication.Web) WebAuthenticationBroker クラス | (Microsoft.Security.Authentication.OAuth) OAuth2Manager クラス (Windows アプリ SDK 1.7 以降でサポート)。 OAuth 2.0 認証を実行するための OAuth2Manager および関連 API の使用の詳細については、Windows アプリでの OAuth 機能の実装に関する説明を参照してください。 完全なサンプル アプリケーションについては、GitHub を参照してください。 |
| (Windows.Storage.Pickers) FileOpenPicker、FileSavePicker、および FolderPicker クラス | サポートされていますが、 IInitializeWithWindow インターフェイスを使用する必要があります。 「MessageDialog」および「ピッカー」を参照してください。 |
| (Windows.System.Display) DisplayRequest クラス | Windows アプリ SDK 1.0 ではサポートされていません。 |
| Windows.UI.Composition 名前空間 | Microsoft.UI.Composition 名前空間 |
| (Windows.UI.Core) CoreDispatcher クラス | (Microsoft.UI.Dispatching) DispatcherQueue クラス。 Change CoreDispatcher to DispatcherQueue を参照。 |
| (Windows.UI.Core) CoreDispatcher.RunAsync メソッド | (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue メソッド。 「Change RunAsync to TryEnqueue」を参照>。 |
| (Windows.UI.Core) CoreWindow クラス | (Microsoft.UI.Windowing) AppWindow クラス。 「Windowing 機能の移行を参照してください。 |
(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 プロパティ。 「Change CoreWindow.Dispatcher to Window.DispatcherQueue を参照してください。 |
| (Windows.UI.Core) CoreWindow.SizeChanged イベント | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange メソッド |
| (Windows.UI.Core) SystemNavigationManager クラス (グローバル 戻るボタン) | サポートされていません。 独自の UI 内に [戻る] ボタンを実装します。 「A Windows アプリ SDK UWP PhotoLab サンプル アプリ (C#)の移行に関するページを参照してください。 |
| (Windows.UI.Core) WindowSizeChangedEventArgs クラス | (Microsoft.UI.Xaml) WindowSizeChangedEventArgs クラス;たとえば、(Microsoft.UI.Xaml) Window.SizeChanged のハンドラーで使用します。 |
| (Windows.UI.Popups) MessageDialog クラス | サポートされていますが、 IInitializeWithWindow インターフェイスを使用する必要があります。 「MessageDialog」および「ピッカー」を参照してください。 |
| (Windows.UI.Text.Core) CoreTextServicesManager クラス | Windows 11でのみサポートされます。 |
| (Windows.UI.ViewManagement) AccessibilitySettings.HighContrastChanged イベント | (Microsoft.UI.System) ThemeSettings.Changed イベント |
| (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 アプリ SDK API に直接 1 対 1 のマッピングがない |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset と RightInset を Height と組み合わせて、同じ情報を提供します。 |
| (Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Windows アプリ SDK API に直接 1 対 1 のマッピングがない |
| (Windows.UI.WindowManagement) AppWindowTitleBarOcclusion プロパティ | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset と RightInset を Height と組み合わせて、同じ情報を提供します。 |
| (Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Windows アプリ 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 メソッド (C# では通常、 App.OnCachedFileUpdaterActivatedとして表示されます) |
「OnActivated、OnBackgroundActivated、およびその他のアクティブ化処理メソッドを参照してください。 |
(Windows.UI.Xaml) Application.OnFileActivated メソッド (C# では通常、 App.OnFileActivatedとして表示されます) |
「File 型の関連付けおよび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 プロパティ (通常、 Window.Current.Dispatcherとして C# で記述) |
(Microsoft.UI.Xaml) Window.DispatcherQueue プロパティ |
| (Windows.UI.Xaml.Controls) ContentDialog クラス | (Microsoft.UI.Xaml.Controls) ContentDialog はサポートされていますが、 XamlRoot プロパティを設定する必要があります。 「ContentDialog」および「Popup」を参照してください。 |
| (Windows.UI.Xaml.Controls) InkCanvas クラス | Windows アプリ SDK 1.0 ではサポートされていません。 |
| (Windows.UI.Xaml.Controls) MediaElement クラス | Windows アプリ 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 プロパティ | Windows アプリ SDKでは、(Microsoft.UI.Xaml.Media) AcrylicBrushは常にアプリコンテンツからサンプリングします。 「AcrylicBrush.BackgroundSource プロパティ」を参照>。 |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Migrate winrt.resume_foregroundを参照してください |
サードパーティ製ライブラリ
このセクションでは、UWP でサポートされており、WinUI 3 を使用する場合に変更する必要があるさまざまなライブラリについて説明します。
| UWP | Windows アプリ SDK |
|---|---|
| OneDrive SDK | Microsoft Graph SDK |
こちらもご覧ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Windows developer