デスクトップ アプリでのWindows ランタイム API のサポート

ほとんどの Windows ランタイム (WinRT) API (Windows ランタイム (WinRT) 名前空間) は C# または C++ デスクトップ アプリで使用できますが、デスクトップ アプリではサポートされていない、または制限がある WinRT API の主なセットが 2 つあります。

  • ユニバーサル Windows プラットフォーム (UWP) アプリでのみ使用できるように設計されたユーザー インターフェイス (UI) 機能に依存する API。
  • パッケージ ID を必要とする API (パッケージ ID を必要とする機能に関するページを参照)。 このような API は、MSIX を使用してパッケージ化されたデスクトップ アプリでのみサポートされています。

この記事では、WinRT API のこれらの両方のセットについて詳しく説明します。 可能な場合、この記事では、デスクトップ アプリでサポートされていない API と同じ機能を実現するための別の API を提案しています。 代替 API のほとんどは、 WinUI 3 または Windows SDK で使用できる WinRT COM インターフェイスを介して利用できます。

注

.NETを使用するアプリでは、この記事に記載されている一部の WinRT COM インターフェイスに対して提供されているクラス実装を利用できます。 これらのクラスは、WinRT COM インターフェイスを直接使用するよりも簡単に使用できます。 使用可能なクラス実装の詳細については、「.NET アプリから相互運用機能 API を呼び出す」を参照してください。 これらのクラスには、.NET 6 SDK 以降が必要であることに注意してください。

UWP 専用 UI 機能に依存する API

一部の WinRT API は UWP アプリでの UI シナリオ専用に設計されました。 これらの API は、スレッド モデルやその他のプラットフォームの違いにより、デスクトップ アプリでは適切に動作しません。 これらの API および、これらに依存関係のあるその他の WinRT API は、デスクトップ アプリでの使用がサポートされていません。

サポートされていないコア クラス

次の WinRT クラスは、デスクトップ アプリではサポートされていません。

クラス 代替の API
ApplicationView None
CoreApplicationView 代わりに、WinUI によって提供される Window クラスを使用してください。
CoreApplicationViewTitleBar ExtendViewIntoTitleBar プロパティの代わりに、WinUI によって提供される Window.ExtendsContentIntoTitleBar プロパティを使用します。
CoreDispatcher 代わりに、WinUI によって提供される Microsoft.UI.Xaml.Window.DispatcherQueue プロパティを使用してください。

Windows.UI.Xaml.Window.Dispatcher および Windows.UI.Xaml.DependencyObject.Dispatcher プロパティは、デスクトップ アプリで null を返すことに注意してください。
CoreWindow さらに以下の「IInitializeWithWindow を実装するクラス」セクションを参照してください。

GetKeyState メソッドの代わりに、WinUI によって提供される InputKeyboardSource.GetKeyStateForCurrentThread メソッドを使用します。

PointerCursor プロパティの代わりに、WinUI によって提供される UIElement.ProtectedCursor プロパティを使用します。 このプロパティにアクセスするには、UIElement のサブクラスが必要です。
UserActivity 代わりに IUserActivitySourceHostInterop COM インターフェイス (useractivityinterop.h 内) を使用します。

デスクトップ アプリでサポートされていないその他の WinRT API については、このトピックの後半にある「サポートされていないメンバー」を参照してください。

XxxForCurrentView メソッドによるクラス

多くの WinRT クラスには、UIViewSettings.GetForCurrentView など、静的な GetForCurrentView または CreateForCurrentView メソッドがあります。 これらの XxxForCurrentView メソッドは、デスクトップ アプリでサポートされていない ApplicationView 型に暗黙的に依存しています。 ApplicationView がデスクトップ アプリではサポートされていないため、XxxForCurrentView のすべてのメソッドもサポートされていません。 一部のサポートされていない XxxForCurrentView メソッドでは、null が返されるだけでなく、例外もスローされる場合があります。

注

CoreInputView.GetForCurrentView はデスクトップ アプリでサポートされており、CoreWindow がなくとも使用できます。 このメソッドは、任意のスレッドで CoreInputView オブジェクトを取得するために使用できます。また、そのスレッドに前面のウィンドウがある場合は、そのオブジェクトによってイベントが生成されます。

次のクラスは、デスクトップ アプリでサポートされて "います"。ただし、デスクトップ アプリでそのインスタンスを取得するには、GetForCurrentView または CreateForCurrentView メソッドとは異なるメカニズムを使います。 代替 API として COM インターフェイスが一覧表示されている以下のクラスについては、C# 開発者はこれらの WinRT COM インターフェイスを使用することもできます (.NET アプリからの相互運用 API の呼び出しを参照)。 この一覧は包括的でない場合があります。

クラス 代替の API
AccountsSettingsPane 代わりに IAccountsSettingsPaneInterop COM インターフェイス (accountssettingspaneinterop.h 内) を使用してください。
CoreDragDropManager 代わりに IDragDropManagerInterop COM インターフェイス (dragdropinterop.h 内) を使用します。
CoreTextServicesManager 現在、このクラスは Windows Insider Preview ビルドのデスクトップ アプリでのみサポートされています。
DataTransferManager 代わりに IDataTransferManagerInterop COM インターフェイス (shobjidl_core.h 内) を使用します。
DisplayInformation DisplayInformation のインスタンスを取得するには、IDisplayInformationStaticsInterop インターフェイスを使います。

または、 LogicalDpi プロパティではなく、 XamlRoot.RasterizationScale プロパティを使用し、 XamlRoot.Changed イベントを介して変更をリッスンすることもできます ( XamlRoot.RasterizationScale プロパティは WinUI で提供されます)。

また、 RawPixelsPerViewPixel プロパティの代わりに、WinUI によって提供される XamlRoot.RasterizationScale プロパティを使用するオプションがあります。
InputPane 代わりに IInputPaneInterop COM インターフェイス (inputpaneinterop.h 内) を使用します。
PlayToManager 代わりに IPlayToManagerInterop COM インターフェイス (playtomanagerinterop.h 内) を使用します。
Print3DManager 代わりに IPrinting3DManagerInterop COM インターフェイス (print3dmanagerinterop.h 内) を使用します。
PrintManager 代わりに IPrintManagerInterop COM インターフェイス (printmanagerinterop.h 内) を使用します。
RadialController 代わりに IRadialControllerInterop COM インターフェイス (radialcontrollerinterop.h 内) を使用します。
RadialControllerConfiguration 代わりに IRadialControllerConfigurationInterop COM インターフェイス (radialcontrollerinterop.h 内) を使用します。
ResourceContext 「MRT から MRT Core への移行」を参照してください。
ResourceLoader 「MRT から MRT Core への移行」を参照してください。
SpatialInteractionManager 代わりに ISpatialInteractionManagerInterop COM インターフェイス (spatialinteractionmanagerinterop.h 内) を使用します。
SystemMediaTransportControls 代わりに ISystemMediaTransportControlsInterop COM インターフェイス (systemmediatransportcontrolsinterop.h 内) を使用します。
UserActivityRequestManager 代わりに IUserActivityRequestManagerInterop COM インターフェイス (useractivityinterop.h 内) を使用します。
UIViewSettings 代わりに IUIViewSettingsInterop COM インターフェイス (uiviewsettingsinterop.h 内) を使用します。

次のクラスはデスクトップ アプリではサポートされて "いません"。これらの API は、GetForCurrentView または CreateForCurrentView メソッドの代替を提供していないためです。 この一覧は包括的でない場合があります。

クラス 代替の API
AppCapture None
BrightnessOverride None
ConnectedAnimationService None
CoreInputView None
CoreWindowResizeManager None
DisplayEnhancementOverride None
EdgeGesture None
GazeInputSourcePreview None
HdmiDisplayInformation None
HolographicKeyboardPlacementOverridePreview None
KeyboardDeliveryInterceptor None
LockApplicationHost None
MouseDevice None
PointerVisualizationSettings None
ProtectionPolicyManager None
SearchPane None
SettingsPane None
SystemNavigationManager None
SystemNavigationManagerPreview None
WebAuthenticationBroker なし。 詳細については、WebAuthenticationBroker.AuthenticateAsync が COMException を発生させる GitHubイシューを参照してください。

IInitializeWithWindow を実装するクラス

特定のピッカー、ポップアップ、ダイアログ、およびその他の Windows ランタイム (WinRT) オブジェクトは、一般的に UI を表示するために CoreWindow に依存します。 CoreWindow はデスクトップ アプリではサポートされていませんが (前述の「コアでサポートされていないクラス」を参照してください)、わずかな相互運用コードを追加することで、デスクトップ アプリでそれらの WinRT クラスの多くを使用できます。

詳細情報 (影響を受ける型の一覧を含む) とコード例については、「CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

サポートされていないメンバー

このセクションでは、デスクトップ アプリでの使用がサポートされていない WinRT クラスの特定のメンバーを一覧表示 (包括的な一覧がない場合は説明) します。 特に明記されていない限り、これらのメンバーとは別の、クラスの残りはデスクトップ アプリでサポートされます。

Events

次のクラスは、示されたイベントを除き、デスクトップ アプリでサポートされています。

クラス サポートされていないイベント
UISettings 色の値が変更されました
アクセシビリティ設定 ハイコントラスト変更

メソッド

次のクラスは、示されたメソッドを除き、デスクトップ アプリでサポートされています。

クラス サポートされていないメソッド
DeviceInformationPairing PairAsync

Request 名前付けパターンを使用するメソッド

リクエスト命名パターンに従うほとんどのメソッド（AppCapability.RequestAccessAsyncやStoreContext.RequestPurchaseAsyncなど）は、デスクトップアプリではサポートされていません。 内部的には、これらのメソッドは、Windows.UI.Popups クラスを使用します。 このクラスではスレッドに CoreWindow オブジェクトが必要ですが、これはデスクトップ アプリではサポートされていません。

Request 名前付けパターンに従うメソッドの完全な一覧は非常に長いため、この記事ではこれらのメソッドの包括的な一覧は提供していません。

パッケージ ID が必要な API

次の WinRT クラスでは、パッケージ ID が必要です (「パッケージ ID が必要な機能」を参照してください)。 これらの API は、パッケージ化されているデスクトップ アプリ (つまり、実行時にパッケージ ID を持つもの) でのみサポートされます。 この一覧は包括的でない場合があります。

Windows。ApplicationModel...

Windows.Data...

Windows。デバイス。。。

Windows。財団。。。

Windows。グローバリゼーション。。。

Windows。グラフィック。。。

Windows。管理。。。

Windows。メディア。。。

Windows。ネットワーク。。。

Windows.Services.Maps...

Important

Windows マップ プラットフォーム API (Windows。Services.Maps.*) は非推奨となり、今後のバージョンのWindowsでは使用できない可能性があります。 詳細については、「 非推奨の機能のリソース」を参照してください。

Windows.Services.Store

Windows。ストレージ。。。

Windows。システム。。。

Windows.UI...

さらに、パッケージ ID を持たないデスクトップ アプリから呼び出された場合、AdaptiveMediaSource.CreateFromUriAsync メソッドは ms-appx と ms-resource の URI 形式をサポートしません。

  • Last updated on