Partilhar via


Mapeando APIs e bibliotecas UWP para o SDK de aplicativos Windows

Este tópico fornece um mapeamento de APIs UWP para seus equivalentes do SDK de Aplicativo 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 alterar o nome do namespace (para obter orientações específicas, consulte os guias da área de recursos). Se sua classe não estiver listada, o mapeamento será apenas uma alteração de namespace. Portanto, localize o nome do namespace da sua classe e, em seguida, você encontrará o nome equivalente do namespace do SDK do Windows App. 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. Veja a migração de MRT para MRT Core .
(Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForCurrentView (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Consulte ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse.
(Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForViewIndependentUse (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Consulte ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse.
(Windows.ApplicationModel.Resources.Core) ResourceManager.Current property Crie um novo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Veja a classe ResourceManager.
Evento (Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged Detete as alterações do ambiente por si mesmo. Consulte Alteração de valor do qualificador de recursos.
(Windows.Graphics.Printing) Classe PrintManager Não suportado no Windows App SDK 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 no Windows App SDK 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 o GitHub para uma aplicação de exemplo completa.
(Windows.Storage.Pickers) classes FileOpenPicker, FileSavePicker e FolderPicker Suportado, mas tens de usar a interface IInitializeWithWindow . Consulte MessageDialog e Seletores.
(Windows.System.Display) Classe DisplayRequest Não suportado no Windows App SDK 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 . Veja Alterar CoreDispatcher para DispatcherQueue.
(Windows.UI.Core) Método CoreDispatcher.RunAsync (Microsoft.UI.Dispatching) Método DispatcherQueue.TryEnqueue . Consulte Alterar RunAsync para TryEnqueue.
(Windows.UI.Core) Classe CoreWindow (Microsoft.UI.Windowing) Classe AppWindow . Consulte migração da funcionalidade 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 existe mapeamento direto 1:1 para uma API do SDK do Windows App. Ao utilizar XAML, pode obter Window.AppWindow para associar a AppWindow com uma Window XAML, mas a aplicação precisa de armazenar em cache o Window ou o AppWindow se quiser aceder a partir de um local que de outra forma não teria 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) CoreWindow.Dispatcher property (Microsoft.UI.Xaml) Propriedade Window.DispatcherQueue . Consulte 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. Consulte uma migração do SDK de aplicativos Windows do aplicativo de exemplo UWP PhotoLab (C#).
(Windows.UI.Core) classe WindowSizeChangedEventArgs (Microsoft.UI.Xaml) Classe WindowSizeChangedEventArgs ; por exemplo, num handler para (Microsoft.UI.Xaml) Window.SizeChanged.
(Windows.UI.Popups) Classe MessageDialog Suportado, mas tens de usar a interface IInitializeWithWindow . Consulte MessageDialog e Seletores.
(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 (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay field
(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) Propriedade AppWindow.Title
(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
(Windows.UI.WindowManagement) Propriedade AppWindowPlacement.Size (Microsoft.UI.Windowing) Propriedade AppWindow.Size
(Windows.UI.WindowManagement) Campo AppWindowPresentationKind.CompactOverlay (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay field
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 Aplicativo 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 Aplicativo 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 Aplicativo 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) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Método Application.OnBackgroundActivated (aparece frequentemente em C# como App.OnBackgroundActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Método Application.OnCachedFileUpdaterActivated (aparece frequentemente em C# como App.OnCachedFileUpdaterActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Método Application.OnFileActivated (aparece frequentemente em C# como App.OnFileActivated) Consulte a associação de tipo de arquivo 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) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Método Application.OnFileSavePickerActivated (aparece frequentemente em C# como App.OnFileSavePickerActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Método Application.OnSearchActivated (aparece frequentemente em C# como App.OnSearchActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Método Application.OnShareTargetActivated (aparece frequentemente em C# como App.OnShareTargetActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos para tratar da ativação.
(Windows.UI.Xaml) Window.Current Obsoleto, e retorna null. Para obter uma alternativa, consulte Alterar Window.Current para App.Window.
(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. Consulte ContentDialog e Popup.
(Windows.UI.Xaml.Controls) Classe InkCanvas Não suportado no Windows App SDK 1.0.
(Windows.UI.Xaml.Controls) Classe MediaElement Não suportado no Windows App SDK 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 . Consulte ContentDialog e Popup.
(Windows.UI.Xaml.Media) Propriedade AcrylicBrush.BackgroundSource No Windows App SDK, o AcrylicBrush (Microsoft.UI.Xaml.Media) faz sempre amostragem do conteúdo da aplicação. Veja a propriedade AcrylicBrush.BackgroundSource.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); Consulte Migrate 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