Asignación de las API y bibliotecas de UWP a SDK de Aplicaciones para Windows

En este tema se proporciona una asignación de los API de UWP a sus equivalentes en 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. Las clases se enumeran cada vez que el mapeo es más complicado que simplemente cambiar el nombre del espacio de nombres (para obtener instrucciones específicas, consulte las Guías de área de características). Si la clase no aparece en la lista, la asignación es solo un cambio de espacio de nombres. Por lo tanto, busca el nombre del espacio de nombres de tu clase y luego encontrarás el nombre del espacio de nombres equivalente del "SDK de Aplicaciones para 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 la 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 de 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 clase
(Windows.Security.Authentication.Web) Clase WebAuthenticationBroker (Microsoft.Security.Authentication.OAuth) clase OAuth2Manager (compatible con SDK de Aplicaciones para Windows 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) FileOpenPicker, FileSavePicker y FolderPicker clases 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) DispatcherQueue clase. Consulte Cambiar CoreDispatcher a DispatcherQueue.
(Windows.UI.Core) Método CoreDispatcher.RunAsync (Microsoft.UI.Dispatching) Método DispatcherQueue.TryEnqueue . Consulte Change RunAsync para TryEnqueue.
(Windows.UI.Core) Clase CoreWindow (Microsoft.UI.Windowing) AppWindow clase. Consulte Migración de la funcionalidadwindowing.
(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 correspondencia directa de uno a uno con una API del SDK de Aplicaciones para Windows. Al usar XAML, puedes obtener Window.AppWindow para acceder al AppWindow asociado a un Window de XAML, pero una aplicación debe almacenar en caché el Window o AppWindow si quiere acceder a él desde algún lugar que de otra manera no tendría acceso. 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. Consulta Una migración de la aplicación de ejemplo PhotoLab de SDK de Aplicaciones para Windows para UWP (C#).
(Windows.UI.Core) WindowSizeChangedEventArgs clase (Microsoft.UI.Xaml) Clase WindowSizeChangedEventArgs ; por ejemplo, en un controlador para (Microsoft.UI.Xaml) Window.SizeChanged.
(Windows.UI.Popups) MessageDialog Compatible, pero debe usar la interfaz IInitializeWithWindow . Consulte MessageDialog y Selectores.
(Windows.UI.Text.Core) Clase CoreTextServicesManager Compatible solamente con 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) 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) (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 Propiedad Microsoft.UI.Windowing (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 (Microsoft.UI.Windowing) Método AppWindowChangedEventArgs.DidSizeChange
(Windows.UI.WindowManagement) Propiedad AppWindowPlacement.Size Propiedad AppWindow.Size (Microsoft.UI.Windowing)
(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 existe una correspondencia directa de 1:1 para 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 No existe una correspondencia directa de 1:1 para 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 No existe una correspondencia directa de 1:1 para 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 File type association 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 Change Window.Current to 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 para Windows, (Microsoft.UI.Xaml.Media) AcrylicBrush siempre muestra el contenido de la aplicación. Consulte la propiedad AcrylicBrush.BackgroundSource.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); Consulte Migrate 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
SDK de OneDrive SDK de Microsoft Graph

Véase también

  • Last updated on