Asignación de las API y bibliotecas de UWP a la SDK de Aplicaciones para Windows
En este tema se proporciona una asignación de las API de UWP a sus equivalentes de SDK de Aplicaciones para Windows. En algunos casos, la asignación no es uno a uno; cualquiera de las plataformas puede tener más o menos funcionalidad que la otra para un espacio de nombres o una clase.
Existen diferencias en los nombres de los espacios de nombres y las clases (incluidos los controles de interfaz de usuario) entre las dos plataformas. En muchos casos, es tan fácil como cambiar un nombre de espacio de nombres y, a continuación, el código se compilará. A veces, un nombre de clase o API ha cambiado, así como el nombre del espacio de nombres. Otras veces, la asignación tarda un poco más en funcionar y, en raras ocasiones, requiere un cambio en el enfoque.
Cómo usar la tabla. En primer lugar, busque el nombre del miembro de clase que está usando. Los miembros se muestran cada vez que la asignación es más complicada que un simple cambio de nombre de clase o nombre de espacio de nombres. Si el miembro no aparece en la lista, busque el nombre de la clase que está usando. Las clases se muestran cada vez que la asignación es más complicada que simplemente cambiar el nombre del espacio de nombres (para obtener instrucciones específicas, consulte las guías del área de características). Si la clase no aparece en la lista, la asignación es simplemente un cambio de espacio de nombres. Por lo tanto, busque el nombre del espacio de nombres de la clase y, a continuación, encontrará el nombre del espacio de nombres SDK de Aplicaciones para Windows equivalente. La clase estará en ese espacio de nombres. Si el espacio de nombres no aparece en la lista, su nombre no ha cambiado.
UWP | SDK para aplicaciones de Windows |
---|---|
(Windows.ApplicationModel.Activation) Clase LaunchActivatedEventArgs | (Microsoft.UI.Xaml) Clase LaunchActivatedEventArgs ; por ejemplo, en App.OnLaunched. |
(Windows.ApplicationModel.Core) Método CoreApplication.CreateNewView | Método AppWindow.Create (Microsoft.UI.Windowing) |
(Windows.ApplicationModel.Core) Clase CoreApplicationViewTitleBar | (Microsoft.UI.Windowing) Clase AppWindowTitleBar |
(Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.ExtendViewIntoTitleBar | (Microsoft.UI.Windowing) Propiedad AppWindowTitleBar.ExtendsContentIntoTitleBar . La plataforma sigue dibujando los botones Minimizar/maximizar/cerrar para usted e informa de la información de oclusión. |
(Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.Height | Propiedad AppWindowTitleBar.Height (Microsoft.UI.Windowing) |
(Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.SystemOverlayLeftInset | Propiedad AppWindowTitleBar.LeftInset (Microsoft.UI.Windowing) |
(Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.SystemOverlayRightInset | Propiedad AppWindowTitleBar.RightInset (Microsoft.UI.Windowing) |
Espacio de nombres Windows.ApplicationModel.Resources.Core | Microsoft.Windows.ApplicationModel.Resources. Consulte Migración de MRT a MRT Core. |
(Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Consulte ResourceContext.GetForCurrentView y ResourceContext.GetForViewIndependentUse. |
(Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForViewIndependentUse | (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Consulte ResourceContext.GetForCurrentView y ResourceContext.GetForViewIndependentUse. |
Propiedad ResourceManager.Current (Windows.ApplicationModel.Resources.Core) | Cree un nuevo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consulte Clase ResourceManager. |
(Windows.ApplicationModel.Resources.Core) Evento ResourceQualifierObservableMap.MapChanged | Detecte los cambios en el entorno automáticamente. Consulte Cambio del valor del calificador de recursos. |
Clase PrintManager (Windows.Graphics.Printing) | No se admite en SDK de Aplicaciones para Windows 1.0. |
(Windows.Media.Capture) Clase CameraCaptureUI | No se admite en SDK de Aplicaciones para Windows 1.0. |
(Windows.Security.Authentication.Web) Clase WebAuthenticationBroker | No se admite en SDK de Aplicaciones para Windows 1.0. |
(Windows.Storage.Pickers) Clases FileOpenPicker, FileSavePicker y FolderPicker | Compatible, pero debe usar la interfaz IInitializeWithWindow. Consulte MessageDialog y Selectores. |
(Windows.System.Display) Clase DisplayRequest | No se admite en SDK de Aplicaciones para Windows 1.0. |
Espacio de nombres Windows.UI.Composition | Espacio de nombres Microsoft.UI.Composition |
(Windows.UI.Core) Clase CoreDispatcher | (Microsoft.UI.Dispatching) Clase DispatcherQueue . Consulte Cambio de CoreDispatcher a DispatcherQueue. |
(Windows.UI.Core) Método CoreDispatcher.RunAsync | (Microsoft.UI.Dispatching) Método DispatcherQueue.TryEnqueue . Consulte Cambiar RunAsync a TryEnqueue. |
(Windows.UI.Core) Clase CoreWindow | (Microsoft.UI.Windowing) Clase AppWindow . Consulte Migración de la funcionalidad basada en ventanas. |
(Windows.UI.Core) Propiedad CoreWindow.Bounds (normalmente aparece en C# como CoreWindow.GetForCurrentThread.Bounds ) |
Propiedad AppWindow.Size (Microsoft.UI.Windowing) |
(Windows.UI.Core) Método CoreWindow.GetForCurrentThread | No hay ninguna asignación directa de 1:1 a una API de SDK de Aplicaciones para Windows. Al usar XAML, puedes obtener Window.AppWindow para obtener la aplicaciónWindow asociada a una ventana XAML, pero una aplicación debe almacenar en caché la ventana o AppWindow si quiere acceder a ella desde algún lugar que no tenga acceso de otro modo. Se recomienda almacenar en caché y exponer la ventana en el objeto App. |
Método CoreWindow.Activate (Windows.UI.Core) | Método AppWindow.Show (Microsoft.UI.Windowing) |
(Windows.UI.Core) Propiedad CoreWindow.Dispatcher | (Microsoft.UI.Xaml) Propiedad Window.DispatcherQueue . Vea Cambiar CoreWindow.Dispatcher a Window.DispatcherQueue. |
(Windows.UI.Core) Evento CoreWindow.SizeChanged | Método AppWindowChangedEventArgs.DidSizeChange (Microsoft.UI.Windowing) |
(Windows.UI.Core) Clase SystemNavigationManager (botón atrás global) | No admitida. Implemente un botón Atrás dentro de su propia interfaz de usuario. Consulta Una SDK de Aplicaciones para Windows migración de la aplicación de ejemplo PhotoLab para UWP (C#). |
(Windows.UI.Core) Clase WindowSizeChangedEventArgs | (Microsoft.UI.Xaml) Clase WindowSizeChangedEventArgs; por ejemplo, en un controlador para (Microsoft.UI.Xaml) Window.SizeChanged. |
(Windows.UI.Popups) Clase MessageDialog | Compatible, pero debe usar la interfaz IInitializeWithWindow. Consulte MessageDialog y Selectores. |
(Windows.UI.Text.Core) Clase CoreTextServicesManager | Solo se admite en Windows 11. |
Clase ApplicationView (Windows.UI.ViewManagement) | Clase AppWindow (Microsoft.UI.Windowing) |
Propiedad ApplicationView.Title (Windows.UI.ViewManagement) | Propiedad AppWindow.Title (Microsoft.UI.Windowing) |
Método ApplicationView.TryConsolidateAsync (Windows.UI.ViewManagement) | Método AppWindow.Destroy (Microsoft.UI.Windowing) |
(Windows.UI.ViewManagement) Método ApplicationView.TryEnterFullScreenMode | Método AppWindow.SetPresenter (Microsoft.UI.Windowing) con AppWindowPresenterKind.FullScreen |
(Windows.UI.ViewManagement) Método ApplicationView.TryEnterViewModeAsync con ApplicationViewMode.CompactOverlay | Método AppWindow.SetPresenter (Microsoft.UI.Windowing) con AppWindowPresenterKind.CompactOverlay |
Método ApplicationView.TryResizeView (Windows.UI.ViewManagement) | Método AppWindow.Resize (Microsoft.UI.Windowing) |
(Windows.UI.ViewManagement) Campo ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.CompactOverlay |
(Windows.UI.ViewManagement) Clase ApplicationViewTitleBar | (Microsoft.UI.Windowing) Clase AppWindowTitleBar |
(Windows.UI.ViewManagement) Campo ApplicationViewWindowingMode.FullScreen | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.FullScreen |
Clase AppWindow (Windows.UI.WindowManagement) | Clase AppWindow (Microsoft.UI.Windowing) |
Evento AppWindow.Changed (Windows.UI.WindowManagement) | (Microsoft.UI.Windowing) Evento Microsoft.UI.Windowing.AppWindow.Changed |
Método AppWindow.CloseAsync (Windows.UI.WindowManagement) | Método AppWindow.Destroy (Microsoft.UI.Windowing) |
Método AppWindow.GetPlacement (Windows.UI.WindowManagement) | Propiedad AppWindow.Position (Microsoft.UI.Windowing) |
Métodos Appwindow.RequestMoveXxx (Windows.UI.WindowManagement) | Método AppWindow.Move (Microsoft.UI.Windowing) |
Método AppWindow.RequestSize (Windows.UI.WindowManagement) | Método AppWindow.Resize (Microsoft.UI.Windowing) |
Propiedad AppWindow.Title (Windows.UI.WindowManagement) | Propiedad AppWindow.Title (Microsoft.UI.Windowing) |
Método AppWindow.TryCreateAsync (Windows.UI.WindowManagement) | Método AppWindow.Create (Microsoft.UI.Windowing) |
Método AppWindow.TryShowAsync (Windows.UI.WindowManagement) | Método AppWindow.Show (Microsoft.UI.Windowing) |
Método AppWindowChangedEventArgs.DidSizeChange (Windows.UI.WindowManagement) | Método AppWindowChangedEventArgs.DidSizeChange (Microsoft.UI.Windowing) |
Propiedad AppWindowPlacement.Size (Windows.UI.WindowManagement) | Propiedad AppWindow.Size (Microsoft.UI.Windowing) |
(Windows.UI.WindowManagement) Campo AppWindowPresentationKind.CompactOverlay | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.CompactOverlay |
(Windows.UI.WindowManagement) Campo AppWindowPresentationKind.FullScreen | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.FullScreen |
Método AppWindowPresenter.RequestPresentation (Windows.UI.WindowManagement) | Método AppWindow.SetPresenter (Microsoft.UI.Windowing) |
(Windows.UI.WindowManagement) Clase AppWindowTitleBar | (Microsoft.UI.Windowing) Clase AppWindowTitleBar |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Ninguna asignación directa de 1:1 a una API de SDK de Aplicaciones para Windows |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset y RightInset, junto con Height, proporcionan la misma información. |
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Ninguna asignación directa de 1:1 a una API de SDK de Aplicaciones para Windows |
(Windows.UI.WindowManagement) Propiedad AppWindowTitleBarOcclusion | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset y RightInset, junto con Height, proporcionan la misma información. |
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Ninguna asignación directa de 1:1 a una API de SDK de Aplicaciones para Windows |
Espacio de nombres Windows.UI.Xaml | Espacio de nombres Microsoft.UI.Xaml |
(Windows.UI.Xaml) Método Application.OnActivated (normalmente aparece en C# como App.OnActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnBackgroundActivated (normalmente aparece en C# como App.OnBackgroundActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnCachedFileUpdaterActivated (normalmente aparece en C# como App.OnCachedFileUpdaterActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnFileActivated (normalmente aparece en C# como App.OnFileActivated ) |
Consulte Asociación de tipos de archivo y OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnFileOpenPickerActivated (normalmente aparece en C# como App.OnFileOpenPickerActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnFileSavePickerActivated (normalmente aparece en C# como App.OnFileSavePickerActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnSearchActivated (normalmente aparece en C# como App.OnSearchActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnShareTargetActivated (normalmente aparece en C# como App.OnShareTargetActivated ) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Propiedad Window.Current | En desuso, y devuelve null . Para obtener una alternativa, consulte Cambiar Window.Current a App.Window. |
(Windows.UI.Xaml) Propiedad Window.Dispatcher (escrita normalmente en C# como Window.Current.Dispatcher ) |
Propiedad Window.DispatcherQueue (Microsoft.UI.Xaml) |
(Windows.UI.Xaml.Controls) Clase ContentDialog | (Microsoft.UI.Xaml.Controls) ContentDialog es compatible, pero debe establecer su propiedad XamlRoot . Consulte ContentDialog y Popup. |
Clase InkCanvas (Windows.UI.Xaml.Controls) | No se admite en SDK de Aplicaciones para Windows 1.0. |
Clase MediaElement (Windows.UI.Xaml.Controls) | No se admite en SDK de Aplicaciones para Windows 1.0. |
Clase MapControl (Windows.UI.Xaml.Controls.Maps) | Clase MapControl (Microsoft.UI.Xaml.Controls) |
(Windows.UI.Xaml.Controls.Primitives) Clase emergente | Se admite el elemento emergente Microsoft.UI.Xaml.Controls.Primitives, pero debe establecer su propiedad XamlRoot. Consulte ContentDialog y Popup. |
(Windows.UI.Xaml.Media) Propiedad AcrylicBrush.BackgroundSource | En el SDK de Aplicaciones para Windows, los ejemplos de AcrylicBrush (Microsoft.UI.Xaml.Media) siempre proceden del contenido de la aplicación. Consulte la propiedad AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Consulte Migración de winrt.resume_foreground |
Bibliotecas de terceros
En esta sección se documentan varias bibliotecas compatibles con UWP y se deben cambiar al usar WinUI 3.
UWP | SDK para aplicaciones de Windows |
---|---|
OneDrive SDK | SDK de Microsoft Graph |