Compartir a través de


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 exclusiva; cualquiera de las plataformas puede tener más o menos funcionalidades 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 luego 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, el mapeo requiere un poco más de trabajo y, en raras ocasiones, requiere un cambio de enfoque.

Cómo usar la tabla. En primer lugar, busque el nombre del elemento de clase que está usando. Se enumeran los miembros siempre que el mapeo sea más complicado que un simple cambio de nombre de clase o de espacio de nombres. Si el miembro no aparece en la lista, busque el nombre de la clase que está usando. Se enumeran las clases siempre que el mapeo sea más complicado que simplemente cambiar el nombre del espacio de nombres (para obtener instrucciones específicas, consulte las guías del área de funciones). Si la clase no aparece en la lista, la asignación es solo un cambio de espacio de nombres. Primero, busque el nombre del espacio de nombres de la clase y luego descubrirá el nombre del espacio de nombres equivalente en el SDK para aplicaciones de Windows. La clase estará en ese espacio de nombres. Si el espacio de nombres no aparece en la lista, el nombre no habrá cambiado.

UWP SDK para aplicaciones de Windows
(Windows.ApplicationModel.Activation) clase LaunchActivatedEventArgs (Microsoft.UI.Xaml) Clase LaunchActivatedEventArgs ; por ejemplo, en App.OnLaunched.
(Windows.ApplicationModel.Background) Clase BackgroundTaskBuilder (Microsoft.Windows.ApplicationModel.Background)Clase BackgroundTaskBuilder. Consulte Uso de tareas en segundo plano en aplicaciones de Windows.
(Windows.ApplicationModel.Core) Método CoreApplication.CreateNewView Método AppWindow.Create (Microsoft.UI.Windowing)
(Windows.ApplicationModel.Core) class 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 sobre la oclusión.
(Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.Height Microsoft.UI.Windowing (AppWindowTitleBar.Height) propiedad
Propiedad Windows.ApplicationModel.CoreCoreApplicationViewTitleBar.SystemOverlayLeftInset (Microsoft.UI.Windowing) propiedad AppWindowTitleBar.LeftInset
Propiedad (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset (Microsoft.UI.Windowing) Propiedad AppWindowTitleBar.RightInset
Windows.ApplicationModel.Resources.Core namespace 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.
(Windows.ApplicationModel.Resources.Core) ResourceManager.Current propiedad 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 por sí mismo. Consulte Cambio del valor del calificador de recursos.
PrintManager (Windows.Graphics.Printing) clase No se admite en SDK de Aplicaciones para Windows 1.0.
(Windows.Media.Capture) Clase CameraCaptureUI (Microsoft.Windows.Media.Capture) CameraCaptureUI class
(Windows.Security.Authentication.Web) Clase WebAuthenticationBroker (Microsoft.Security.Authentication.OAuth) clase OAuth2Manager (compatible con Windows App SDK 1.7 y versiones posteriores). Consulte Implementación de la funcionalidad de OAuth en aplicaciones de Windows para obtener más información sobre el uso de OAuth2Manager y las API relacionadas para realizar la autenticación de OAuth 2.0. Consulte GitHub para obtener una aplicación de ejemplo completa.
(Windows.Storage.Pickers) Clases FileOpenPicker, FileSavePicker y FolderPicker Compatible, pero debe usar la interfaz IInitializeWithWindow . Consulte MessageDialog y Pickers.
(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) DispatcherQueue clase. Consulte Cambiar CoreDispatcher por 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) AppWindow clase. Consulte Migración de la funcionalidad basada en ventanas.
(Windows.UI.Core) Propiedad CoreWindow.Bounds (normalmente aparece en C# como CoreWindow.GetForCurrentThread.Bounds) (Microsoft.UI.Windowing) AppWindow.Size property
(Windows.UI.Core) Método CoreWindow.GetForCurrentThread No hay correspondencia directa uno a uno con una API del SDK de aplicaciones de 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. Consulte Cambiar CoreWindow.Dispatcher a Window.DispatcherQueue.
(Windows.UI.Core) CoreWindow.SizeChanged evento (Microsoft.UI.Windowing) Método AppWindowChangedEventArgs.DidSizeChange
(Windows.UI.Core) Clase SystemNavigationManager (botón de retroceso global) No está soportado. Implemente un botón Atrás dentro de su propia interfaz de usuario. Consulte Migración de la aplicación de ejemplo PhotoLab de UWP (C#) al SDK para aplicaciones de Windows.
(Windows.UI.Core) WindowSizeChangedEventArgs clase (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 Pickers.
(Windows.UI.Text.Core) Clase CoreTextServicesManager Se admite solo en Windows 11.
(Windows.UI.ViewManagement) Evento AccessibilitySettings.HighContrastChanged (Microsoft.UI.System) evento ThemeSettings.Changed
Clase ApplicationView (Windows.UI.ViewManagement) Clase AppWindow (Microsoft.UI.Windowing)
(Windows.UI.ViewManagement) propiedad ApplicationView.Title Propiedad Microsoft.UI.Windowing (AppWindow.Title)
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) AppWindowPresenterKind.CompactOverlay del campo
(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) (Microsoft.UI.Windowing) AppWindow clase
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) (Microsoft.UI.Windowing) Propiedad AppWindow.Position
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)
(Windows.UI.WindowManagement) Propiedad AppWindow.Title (Microsoft.UI.Windowing) Propiedad AppWindow.Title
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)
(Windows.UI.WindowManagement) Método AppWindowChangedEventArgs.DidSizeChange Método AppWindowChangedEventArgs.DidSizeChange (Microsoft.UI.Windowing)
(Windows.UI.WindowManagement) Propiedad AppWindowPlacement.Size (Microsoft.UI.Windowing) AppWindow.Size property
(Windows.UI.WindowManagement) Campo AppWindowPresentationKind.CompactOverlay (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay del campo
(Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen campo (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 No hay una asignación directa personalizada en una API del SDK para aplicaciones de 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 No hay una asignación directa personalizada en una API del SDK para aplicaciones de 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 No hay una asignación directa personalizada en una API del SDK para aplicaciones de 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 Obsoleto 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) (Microsoft.UI.Xaml) Window.DispatcherQueue propiedad
(Windows.UI.Xaml.Controls) Clase ContentDialog (Microsoft.UI.Xaml.Controls) ContentDialog es compatible, pero debe establecer su propiedad XamlRoot . Consulte ContentDialog y Popup.
(Windows.UI.Xaml.Controls) InkCanvas clase No se admite en SDK de Aplicaciones para Windows 1.0.
(Windows.UI.Xaml.Controls) MediaElement clase No se admite en SDK de Aplicaciones para Windows 1.0.
(Windows.UI.Xaml.Controls.Maps) MapControl clase (Microsoft.UI.Xaml.Controls) MapControl clase
(Windows.UI.Xaml.Controls.Primitives) Clase emergente Se admite Microsoft.UI.Xaml.Controls.PrimitivesPopup, pero debe establecer su propiedad XamlRoot. Consulte ContentDialog y Popup.
(Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource propiedad En el SDK de aplicaciones de Windows, el AcrylicBrush (Microsoft.UI.Xaml.Media) siempre toma muestras 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 que eran compatibles con UWP y que deben cambiarse al usar WinUI 3.

UWP SDK para aplicaciones de Windows
OneDrive SDK SDK de Microsoft Graph

Véase también