Mapear APIs e bibliotecas UWP para o SDK de Aplicações Windows

Este tópico fornece um mapeamento das APIs UWP para os seus equivalentes do SDK de Aplicações Windows. Em alguns casos, o mapeamento não é um-para-um; Qualquer plataforma pode ter mais ou menos funcionalidade do que a outra para um namespace ou classe.

Há diferenças nos nomes de namespaces e classes (incluindo controles de interface do usuário) entre as duas plataformas. Em muitos casos, é tão fácil quanto alterar um nome de namespace e, em seguida, seu código será compilado. Às vezes, um nome de classe ou API foi alterado, bem como o nome do namespace. Outras vezes, o mapeamento dá um pouco mais de trabalho e, em casos raros, requer uma mudança de abordagem.

Como usar a tabela. Primeiro, procure o nome do membro da classe que você está usando. Os membros são listados sempre que o mapeamento é mais complicado do que um simples nome de classe ou alteração de nome de namespace. Se o seu membro não estiver listado, procure o nome da classe que está a utilizar. As classes são listadas sempre que o mapeamento é mais complicado do que simplesmente mudar o nome do espaço de nomes (para orientações específicas, veja os guias da área de funcionalidades). Se sua classe não estiver listada, o mapeamento será apenas uma alteração de namespace. Portanto, encontra o nome do namespace da tua classe e depois encontrarás o nome equivalente do namespace do SDK de Aplicações Windows. Sua classe estará nesse namespace. Se seu namespace não estiver listado, seu nome não foi alterado.

UWP SDK de aplicativos do Windows
(Windows.ApplicationModel.Activation) classe LaunchActivatedEventArgs (Microsoft.UI.Xaml) Classe LaunchActivatedEventArgs ; por exemplo, em App.OnLaunched.
(Windows.ApplicationModel.Background) BackgroundTaskBuilder class (Microsoft.Windows.ApplicationModel.Background) Classe BackgroundTaskBuilder . Consulte Usando tarefas em segundo plano em aplicativos do Windows.
(Windows.ApplicationModel.Core) Método CoreApplication.CreateNewView (Microsoft.UI.Windowing) Método AppWindow.Create
(Windows.ApplicationModel.Core) Classe CoreApplicationViewTitleBar (Microsoft.UI.Windowing) Classe AppWindowTitleBar
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar propriedade (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.ExtendsContentIntoTitleBar . A plataforma continua a desenhar os botões Minimizar/Maximizar/Fechar para si e reporta a informação sobre oclusão.
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height propriedade (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.Height
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset propriedade (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset property
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset propriedade (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.RightInset
Espaço de nomes Windows.ApplicationModel.Resources.Core Microsoft.Windows.ApplicationModel.Resources. Ver MRT para migração para o núcleo MRT.
(Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForCurrentView (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Veja ResourceContext.GetForCurrentView, e ResourceContext.GetForViewIndependentUse.
(Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForViewIndependentUse (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Veja ResourceContext.GetForCurrentView, e ResourceContext.GetForViewIndependentUse.
(Windows.ApplicationModel.Resources.Core) ResourceManager.Current propriedade Crie um novo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consulte Classe ResourceManager.
Evento (Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged Detete as alterações do ambiente por si mesmo. Ver Alteração de valor do qualificador de recursos.
(Windows.Graphics.Printing) Classe PrintManager Não suportado no SDK de Aplicações Windows 1.0.
(Windows.Media.Capture) Classe CameraCaptureUI (Microsoft.Windows.Media.Capture) Classe CameraCaptureUI
(Windows.Security.Authentication.Web) Classe WebAuthenticationBroker (Microsoft.Security.Authentication.OAuth) classe OAuth2Manager (suportada na SDK de Aplicações Windows 1.7 e posteriores). Consulte Implementar a funcionalidade OAuth em aplicativos do Windows para obter mais informações sobre como usar o OAuth2Manager e APIs relacionadas para executar a autenticação OAuth 2.0. Consulte GitHub para uma aplicação de amostra completa.
(Windows.Storage.Pickers) FileOpenPicker, FileSavePicker e FolderPicker Suportado, mas tens de usar a interface IInitializeWithWindow . Veja MessageDialog e Pickers.
(Windows.System.Display) Classe DisplayRequest Não suportado no SDK de Aplicações Windows 1.0.
Espaço de nomes Windows.UI.Composition Espaço de nomes Microsoft.UI.Composition
(Windows.UI.Core) CoreDispatcher Classe (Microsoft.UI.Dispatching) Classe DispatcherQueue . Consulte Altere CoreDispatcher para DispatcherQueue.
(Windows.UI.Core) Método CoreDispatcher.RunAsync (Microsoft.UI.Dispatching) Método DispatcherQueue.TryEnqueue . Veja Altere RunAsync para TryEnqueue.
(Windows.UI.Core) Classe CoreWindow (Microsoft.UI.Windowing) Classe AppWindow . Veja Migração de funcionalidades de janelas.
(Windows.UI.Core) Propriedade CoreWindow.Bounds (normalmente aparece em C# como CoreWindow.GetForCurrentThread.Bounds) (Microsoft.UI.Windowing) Propriedade AppWindow.Size
(Windows.UI.Core) Método CoreWindow.GetForCurrentThread Não há mapeamento direto 1:1 para uma API do SDK de Aplicações Windows. Ao usar XAML, pode obter Window.AppWindow para obter o AppWindow associado a um Window XAML, mas uma aplicação precisa de armazenar em cache o Window ou AppWindow se quiser aceder a partir de um local que não tenha acesso. Sugerimos criar uma cache e expor a Janela no objeto App.
(Windows.UI.Core) Método CoreWindow.Activate (Microsoft.UI.Windowing) Método AppWindow.Show
(Windows.UI.Core) Propriedade CoreWindow.Dispatcher (Microsoft.UI.Xaml) Propriedade Window.DispatcherQueue . Veja Alterar CoreWindow.Dispatcher para Window.DispatcherQueue.
(Windows.UI.Core) Evento de CoreWindow.SizeChanged (Microsoft.UI.Windowing) Método AppWindowChangedEventArgs.DidSizeChange método
(Windows.UI.Core) Classe SystemNavigationManager (botão de voltar global) Não suportado. Implemente um botão Voltar em sua própria interface do usuário. Veja a migração para o SDK de Aplicações Windows do aplicativo de exemplo PhotoLab UWP (C#).
(Windows.UI.Core) classe WindowSizeChangedEventArgs (Microsoft.UI.Xaml) Classe WindowSizeChangedEventArgs ; por exemplo, num handler para (Microsoft.UI.Xaml) Window.SizeChanged.
(Windows.UI.Popups) MessageDialog classe Suportado, mas tens de usar a interface IInitializeWithWindow . Veja MessageDialog e Pickers.
(Windows.UI.Text.Core) Classe CoreTextServicesManager Suportado apenas no Windows 11.
(Windows.UI.ViewManagement) AccessibilitySettings.HighContrastChanged evento (Microsoft.UI.System) Evento de Mudança de Definições de Tema
(Windows.UI.ViewManagement) Classe ApplicationView (Microsoft.UI.Windowing) Classe AppWindow
(Windows.UI.ViewManagement) Propriedade ApplicationView.Title (Microsoft.UI.Windowing) Título da propriedade AppWindow
(Windows.UI.ViewManagement) Método ApplicationView.TryConsolidateAsync (Microsoft.UI.Windowing) Método AppWindow.Destroy
(Windows.UI.ViewManagement) Método ApplicationView.TryEnterFullScreenMode (Microsoft.UI.Windowing) Método AppWindow.SetPresenter com AppWindowPresenterKind.FullScreen
(Windows.UI.ViewManagement) ApplicationView.TryEnterViewModeAsync método com ApplicationViewMode.CompactOverlay (Microsoft.UI.Windowing) Método AppWindow.SetPresenter com AppWindowPresenterKind.CompactOverlay
(Windows.UI.ViewManagement) Método ApplicationView.TryResizeView (Microsoft.UI.Windowing) Método AppWindow.Resize
(Windows.UI.ViewManagement) campo ApplicationViewMode.CompactOverlay Campo (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay
(Windows.UI.ViewManagement) Classe ApplicationViewTitleBar (Microsoft.UI.Windowing) Classe AppWindowTitleBar
(Windows.UI.ViewManagement) campo de ApplicationViewWindowingMode.FullScreen (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen
(Windows.UI.WindowManagement) Classe AppWindow (Microsoft.UI.Windowing) Classe AppWindow
(Windows.UI.WindowManagement) Evento AppWindow.Changed (Microsoft.UI.Windowing) Microsoft.UI.Windowing.AppWindow.Changed evento
(Windows.UI.WindowManagement) Método AppWindow.CloseAsync (Microsoft.UI.Windowing) Método AppWindow.Destroy
(Windows.UI.WindowManagement) Método AppWindow.GetPlacement (Microsoft.UI.Windowing) Propriedade AppWindow.Position
(Windows.UI.WindowManagement) Métodos Appwindow.RequestMoveXxx (Microsoft.UI.Windowing) Método AppWindow.Move
(Windows.UI.WindowManagement) Método AppWindow.RequestSize (Microsoft.UI.Windowing) Método AppWindow.Resize
(Windows.UI.WindowManagement) Propriedade AppWindow.Title (Microsoft.UI.Windowing) Título da propriedade AppWindow
(Windows.UI.WindowManagement) Método AppWindow.TryCreateAsync (Microsoft.UI.Windowing) Método AppWindow.Create
(Windows.UI.WindowManagement) Método AppWindow.TryShowAsync (Microsoft.UI.Windowing) Método AppWindow.Show
(Windows.UI.WindowManagement) Método AppWindowChangedEventArgs.DidSizeChange (Microsoft.UI.Windowing) Método AppWindowChangedEventArgs.DidSizeChange método
(Windows.UI.WindowManagement) Propriedade AppWindowPlacement.Size (Microsoft.UI.Windowing) Propriedade AppWindow.Size
(Windows.UI.WindowManagement) Campo AppWindowPresentationKind.CompactOverlay Campo (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay
Campo (Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen
(Windows.UI.WindowManagement) Método AppWindowPresenter.RequestPresentation (Microsoft.UI.Windowing) Método AppWindow.SetPresenter
(Windows.UI.WindowManagement) Classe AppWindowTitleBar (Microsoft.UI.Windowing) Classe AppWindowTitleBar
(Windows. UI. WindowManagement) AppWindowTitleBar.GetPreferredVisibility Sem mapeamento direto 1:1 para uma API do SDK de Aplicações Windows
(Windows. UI. WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, juntamente com Height, fornecem a mesma informação.
(Windows. UI. WindowManagement) AppWindowTitleBar.SetPreferredVisibility Sem mapeamento direto 1:1 para uma API do SDK de Aplicações Windows
(Windows.UI.WindowManagement) Propriedade AppWindowTitleBarOcclusion (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, juntamente com Height, fornecem a mesma informação.
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility Sem mapeamento direto 1:1 para uma API do SDK de Aplicações Windows
Espaço de nomes Windows.UI.Xaml Espaço de nomes Microsoft.UI.Xaml
(Windows.UI.Xaml) Método Application.OnActivated (aparece frequentemente em C# como App.OnActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Método Application.OnBackgroundActivated (aparece frequentemente em C# como App.OnBackgroundActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Método Application.OnCachedFileUpdaterActivated (aparece frequentemente em C# como App.OnCachedFileUpdaterActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Método Application.OnFileActivated (aparece frequentemente em C# como App.OnFileActivated) Veja Associação de tipos de ficheiro e OnActivated, OnBackgroundActivated e outros métodos de manipulação de ativação.
(Windows.UI.Xaml) Método Application.OnFileOpenPickerActivated (aparece frequentemente em C# como App.OnFileOpenPickerActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Método Application.OnFileSavePickerActivated (aparece frequentemente em C# como App.OnFileSavePickerActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Método Application.OnSearchActivated (aparece frequentemente em C# como App.OnSearchActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Método Application.OnShareTargetActivated (aparece frequentemente em C# como App.OnShareTargetActivated) Veja OnActivated, OnBackgroundActivated e outros métodos de gestão de ativação.
(Windows.UI.Xaml) Window.Current Obsoleto, e retorna null. Para uma alternativa, veja Alterar Janela.Atual para Aplicação.Janela.
(Windows.UI.Xaml) Propriedade Window.Dispatcher (comumente escrita em C# como Window.Current.Dispatcher) (Microsoft.UI.Xaml) Propriedade Window.DispatcherQueue
(Windows.UI.Xaml.Controls) Classe ContentDialog (Microsoft.UI.Xaml.Controls) ContentDialog é suportado, mas deve definir a sua propriedade XamlRoot. Veja ContentDialog e Popup.
(Windows.UI.Xaml.Controls) Classe InkCanvas Não suportado no SDK de Aplicações Windows 1.0.
(Windows.UI.Xaml.Controls) Classe MediaElement Não suportado no SDK de Aplicações Windows 1.0.
(Windows.UI.Xaml.Controls.Maps) MapControl Classe (Microsoft.UI.Xaml.Controls) MapControl classe
(Windows.UI.Xaml.Controls.Primitives) Classe Popup (Microsoft.UI.Xaml.Controls.Primitives) Popup é suportado, mas deve definir a sua propriedade XamlRoot . Veja ContentDialog e Popup.
(Windows.UI.Xaml.Media) Propriedade AcrylicBrush.BackgroundSource No SDK de Aplicações Windows, o (Microsoft.UI.Xaml.Media) AcrylicBrush obtém sempre amostras do conteúdo da app. Veja a propriedade AcrylicBrush.BackgroundSource.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); Veja Migrar winrt.resume_foreground

Bibliotecas de terceiros

Esta seção documenta várias bibliotecas que eram suportadas na UWP e precisam ser alteradas ao usar o WinUI 3.

UWP SDK de aplicativos do Windows
OneDrive SDK SDK do Microsoft Graph

Ver também