Mappage des API et bibliothèques UWP au Windows App SDK
Cette rubrique fournit un mappage des API UWP à leurs équivalents Windows App SDK. Dans certains cas, le mappage n’est pas un-à-un ; l’une ou l’autre plateforme peut avoir plus ou moins de fonctionnalités que l’autre pour un espace de noms ou une classe.
Il existe des différences dans les noms des espaces de noms et des classes (y compris dans les contrôles d’interface utilisateur) entre les deux plateformes. Dans de nombreux cas, pour effectuer un mappage, il suffit de modifier un nom d’espace de noms. Votre code est ensuite compilé. Parfois, un nom de classe ou d’API a changé, ainsi que le nom de l’espace de noms. D’autres fois, le mappage demande un peu plus de travail, et dans de rares cas, il nécessite un changement d’approche.
Comment utiliser la table. Tout d’abord, recherchez le nom du membre de classe que vous utilisez. Les membres sont répertoriés chaque fois que le mappage est plus complexe qu’un simple changement de nom de classe ou de nom d’espace de noms. Si votre membre n’est pas répertorié, recherchez le nom de la classe que vous utilisez. Les classes sont répertoriées chaque fois que le mappage est plus complexe que la simple modification du nom de l’espace de noms (pour obtenir des conseils spécifiques, consultez les guides de zone de fonctionnalité). Si votre classe n’est pas répertoriée, le mappage n’est qu’un changement d’espace de noms. Par conséquent, recherchez le nom de l’espace de noms de votre classe, puis vous trouverez l’équivalent Windows App SDK nom d’espace de noms. Votre classe figurera dans cet espace de noms. Si votre espace de noms n’est pas répertorié, son nom n’a pas changé.
| UWP | Kit de développement logiciel (SDK) pour application Windows |
|---|---|
| (Windows.ApplicationModel.Activation) Classe LaunchActivatedEventArgs | (Microsoft.UI.Xaml) Classe LaunchActivatedEventArgs ; par exemple, dans App.OnLaunched. |
| (Windows.ApplicationModel.Core) Méthode CoreApplication.CreateNewView | (Microsoft.UI.Windowing) AppWindow.Create , méthode |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar, classe | (Microsoft.UI.Windowing) Classe AppWindowTitleBar |
| (Windows.ApplicationModel.Core) Propriété CoreApplicationViewTitleBar.ExtendViewIntoTitleBar | (Microsoft.UI.Windowing) AppWindowTitleBar.ExtendsContentIntoTitleBar . La plateforme continue à dessiner les boutons Réduire/Agrandir/Fermer à votre place et signale les informations d’occlusion. |
| (Windows.ApplicationModel.Core) Propriété CoreApplicationViewTitleBar.Height | (Microsoft.UI.Windowing) Propriété AppWindowTitleBar.Height |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset , propriété | (Microsoft.UI.Windowing) Propriété AppWindowTitleBar.LeftInset |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset , propriété | (Microsoft.UI.Windowing) Propriété AppWindowTitleBar.RightInset |
| Espace de noms Windows.ApplicationModel.Resources.Core | Microsoft.Windows.ApplicationModel.Resources. Voir Migration de MRT vers MRT Core. |
| (Windows.ApplicationModel.Resources.Core) Méthode ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) Méthode ResourceManager.CreateResourceContext . Consultez ResourceContext.GetForCurrentView et ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) ResourceContext.GetForViewIndependentUse , méthode | (Microsoft.Windows.ApplicationModel.Resources) Méthode ResourceManager.CreateResourceContext . Consultez ResourceContext.GetForCurrentView et ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) Propriété ResourceManager.Current | Créez un objet ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consultez classe ResourceManager. |
| (Windows.ApplicationModel.Resources.Core) Événement ResourceQualifierObservableMap.MapChanged | Détectez les changements d’environnement pour vous-même. Consultez Modification de la valeur du qualificateur de ressource. |
| (Windows.Graphics.Printing) Classe PrintManager | Non pris en charge dans Windows App SDK 1.0. |
| (Windows.Media.Capture) Classe CameraCaptureUI | Non pris en charge dans Windows App SDK 1.0. |
| (Windows.Security.Authentication.Web) Classe WebAuthenticationBroker | Non pris en charge dans Windows App SDK 1.0. |
| (Windows.Storage.Pickers) Classes FileOpenPicker, FileSavePicker et FolderPicker | Pris en charge, mais vous devez utiliser l’interface IInitializeWithWindow . Consultez MessageDialog et Sélecteurs. |
| (Windows.System.Display) Classe DisplayRequest | Non pris en charge dans Windows App SDK 1.0. |
| Espace de noms Windows.UI.Composition | Espace de noms Microsoft.UI.Composition |
| (Windows.UI.Core) CoreDispatcher , classe | Classe DispatcherQueue (Microsoft.UI.Dispatching). Consultez Modifier CoreDispatcher en DispatcherQueue. |
| (Windows.UI.Core) CoreDispatcher.RunAsync , méthode | (Microsoft.UI.Dispatching) Méthode DispatcherQueue.TryEnqueue . Consultez Modifier RunAsync en TryEnqueue. |
| (Windows.UI.Core) CoreWindow , classe | (Microsoft.UI.Windowing) Classe AppWindow . Consultez Migration des fonctionnalités de fenêtrage. |
(Windows.UI.Core) Propriété CoreWindow.Bounds (généralement en C# sous la forme CoreWindow.GetForCurrentThread.Bounds) |
(Microsoft.UI.Windowing) Propriété AppWindow.Size |
| (Windows.UI.Core) CoreWindow.GetForCurrentThread , méthode | (Microsoft.UI.Windowing) AppWindow.Create , méthode |
| (Windows.UI.Core) CoreWindow.Activate , méthode | (Microsoft.UI.Windowing) AppWindow.Show , méthode |
| (Windows.UI.Core) CoreWindow.Dispatcher, propriété | (Microsoft.UI.Xaml) Propriété Window.DispatcherQueue . Consultez Remplacer CoreWindow.Dispatcher par Window.DispatcherQueue. |
| (Windows.UI.Core) Événement CoreWindow.SizeChanged | (Microsoft.UI.Windowing) Méthode AppWindowChangedEventArgs.DidSizeChange |
| (Windows.UI.Core) Classe SystemNavigationManager (bouton précédent global) | Non pris en charge. Implémentez un bouton Précédent dans votre propre interface utilisateur. Consultez Migration Windows App SDK de l’exemple d’application PhotoLab UWP (C#). |
| (Windows.UI.Core) Classe WindowSizeChangedEventArgs | (Microsoft.UI.Xaml) Classe WindowSizeChangedEventArgs ; par exemple, dans un gestionnaire pour (Microsoft.UI.Xaml) Window.SizeChanged. |
| (Windows.UI.Popups) Classe MessageDialog | Pris en charge, mais vous devez utiliser l’interface IInitializeWithWindow . Consultez MessageDialog et Sélecteurs. |
| (Windows.UI.Text.Core) Classe CoreTextServicesManager | Pris en charge uniquement sur Windows 11. |
| (Windows.UI.ViewManagement) Classe ApplicationView | (Microsoft.UI.Windowing) Classe AppWindow |
| (Windows.UI.ViewManagement) Propriété ApplicationView.Title | (Microsoft.UI.Windowing) Propriété AppWindow.Title |
| (Windows.UI.ViewManagement) Méthode ApplicationView.TryConsolidateAsync | (Microsoft.UI.Windowing) AppWindow.Destroy , méthode |
| (Windows.UI.ViewManagement) Méthode ApplicationView.TryEnterFullScreenMode | (Microsoft.UI.Windowing) Méthode AppWindow.SetPresenter avec AppWindowPresenterKind.FullScreen |
| (Windows.UI.ViewManagement) Méthode ApplicationView.TryEnterViewModeAsync avec ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) Méthode AppWindow.SetPresenter avec AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.ViewManagement) Méthode ApplicationView.TryResizeView | (Microsoft.UI.Windowing) Méthode AppWindow.Resize |
| (Windows.UI.ViewManagement) Champ ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) Champ AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.ViewManagement) Classe ApplicationViewTitleBar | (Microsoft.UI.Windowing) Classe AppWindowTitleBar |
| (Windows.UI.ViewManagement) Champ ApplicationViewWindowingMode.FullScreen | (Microsoft.UI.Windowing) Champ AppWindowPresenterKind.FullScreen |
| (Windows.UI.WindowManagement) Classe AppWindow | (Microsoft.UI.Windowing) Classe AppWindow |
| (Windows.UI.WindowManagement) Événement AppWindow.Changed | (Microsoft.UI.Windowing) Événement Microsoft.UI.Windowing.AppWindow.Changed |
| (Windows.UI.WindowManagement) Méthode AppWindow.CloseAsync | (Microsoft.UI.Windowing) AppWindow.Destroy , méthode |
| (Windows.UI.WindowManagement) Méthode AppWindow.GetPlacement | (Microsoft.UI.Windowing) Propriété AppWindow.Position |
| (Windows.UI.WindowManagement) Méthodes Appwindow.RequestMoveXxx | (Microsoft.UI.Windowing) AppWindow.Move , méthode |
| (Windows.UI.WindowManagement) Méthode AppWindow.RequestSize | (Microsoft.UI.Windowing) Méthode AppWindow.Resize |
| (Windows.UI.WindowManagement) Propriété AppWindow.Title | (Microsoft.UI.Windowing) Propriété AppWindow.Title |
| (Windows.UI.WindowManagement) Méthode AppWindow.TryCreateAsync | (Microsoft.UI.Windowing) AppWindow.Create , méthode |
| (Windows.UI.WindowManagement) Méthode AppWindow.TryShowAsync | (Microsoft.UI.Windowing) AppWindow.Show , méthode |
| (Windows.UI.WindowManagement) Méthode AppWindowChangedEventArgs.DidSizeChange | (Microsoft.UI.Windowing) Méthode AppWindowChangedEventArgs.DidSizeChange |
| (Windows.UI.WindowManagement) Propriété AppWindowPlacement.Size | (Microsoft.UI.Windowing) Propriété AppWindow.Size |
| (Windows.UI.WindowManagement) AppWindowPresentationKind.CompactOverlay field | (Microsoft.UI.Windowing) Champ AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.WindowManagement) Champ AppWindowPresentationKind.FullScreen | (Microsoft.UI.Windowing) Champ AppWindowPresenterKind.FullScreen |
| (Windows.UI.WindowManagement) Méthode AppWindowPresenter.RequestPresentation | (Microsoft.UI.Windowing) Méthode AppWindow.SetPresenter |
| (Windows.UI.WindowManagement) Classe AppWindowTitleBar | (Microsoft.UI.Windowing) Classe AppWindowTitleBar |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Aucun mappage direct 1:1 à une API Windows App SDK |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset et RightInset, couplés à Height, fournissent les mêmes informations. |
| (Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Aucun mappage direct 1:1 à une API Windows App SDK |
| (Windows.UI.WindowManagement) Propriété AppWindowTitleBarOcclusion | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset et RightInset, couplés à Height, fournissent les mêmes informations. |
| (Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Aucun mappage direct 1:1 à une API Windows App SDK |
| Espace de noms Windows.UI.Xaml | Espace de noms Microsoft.UI.Xaml |
(Windows.UI.Xaml) Méthode Application.OnActivated (apparaît généralement en C# sous la forme App.OnActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnBackgroundActivated (généralement en C# sous la forme App.OnBackgroundActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnCachedFileUpdaterActivated (apparaît généralement en C# sous la forme App.OnCachedFileUpdaterActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnFileActivated (généralement en C# sous la forme App.OnFileActivated) |
Consultez Association de type de fichier et OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnFileOpenPickerActivated (apparaît généralement en C# sous la forme App.OnFileOpenPickerActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnFileSavePickerActivated (apparaît généralement en C# sous la forme App.OnFileSavePickerActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnSearchActivated (généralement en C# sous la forme App.OnSearchActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
(Windows.UI.Xaml) Méthode Application.OnShareTargetActivated (généralement en C# sous la forme App.OnShareTargetActivated) |
Consultez OnActivated, OnBackgroundActivated et autres méthodes de gestion de l’activation. |
| (Windows.UI.Xaml) Propriété Window.Current | Déprécié, et retourne null. Pour obtenir une alternative, consultez Modifier Window.Current en App.Window. |
(Windows.UI.Xaml) Propriété Window.Dispatcher (généralement écrite en C# en tant que Window.Current.Dispatcher) |
(Microsoft.UI.Xaml) Propriété Window.DispatcherQueue |
| (Windows.UI.Xaml.Controls) Classe ContentDialog | (Microsoft.UI.Xaml.Controls) ContentDialog est pris en charge, mais vous devez définir sa propriété XamlRoot . Consultez ContentDialog et Popup. |
| (Windows.UI.Xaml.Controls) Classe InkCanvas | Non pris en charge dans Windows App SDK 1.0. |
| (Windows.UI.Xaml.Controls) Classe MediaElement | Non pris en charge dans Windows App SDK 1.0. |
| (Windows.UI.Xaml.Controls.Maps) Classe MapControl | Non pris en charge dans Windows App SDK 1.0. |
| Classe contextuelle (Windows.UI.Xaml.Controls.Primitives) | (Microsoft.UI.Xaml.Controls.Primitives) popup est pris en charge, mais vous devez définir sa propriété XamlRoot . Consultez ContentDialog et Popup. |
| (Windows.UI.Xaml.Media) Propriété AcryliqueBrush.BackgroundSource | Dans le Windows App SDK, l’acryliqueBrush (Microsoft.UI.Xaml.Media) échantillonne toujours le contenu de l’application. Consultez la propriété AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Consultez Migrer winrt.resume_foreground |
Bibliothèques tierces
Cette section documente les différentes bibliothèques prises en charge dans UWP et qui doivent être modifiées lors de l’utilisation de WinUI 3.
| UWP | Kit de développement logiciel (SDK) pour application Windows |
|---|---|
| Kit de développement logiciel (SDK) OneDrive | SDK Microsoft Graph |
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Windows developer
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour