Compartilhar via


Mapeando APIs e bibliotecas UWP para o SDK do Aplicativo Windows

Este tópico fornece um mapeamento de APIs UWP para seus equivalentes SDK do Aplicativo Windows. Em alguns casos, o mapeamento não é um para um; Qualquer uma das plataformas 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 o nome de um 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, pesquise o nome do membro da classe que você está usando. Os membros são listados sempre que o mapeamento é mais complicado do que uma simples alteração de nome de classe ou nome de namespace. Se o membro não estiver listado, pesquise o nome da classe que você está usando. As classes são listadas sempre que o mapeamento é mais complicado do que simplesmente alterar o nome do namespace (para obter diretrizes 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 do namespace SDK do Aplicativo Windows equivalente. Sua classe estará nesse namespace. Se o namespace não estiver listado, seu nome não foi alterado.

UWP SDK do Aplicativo do Windows
(Windows.ApplicationModel.Activation) LaunchActivatedEventArgs class Classe LaunchActivatedEventArgs (Microsoft.UI.Xaml) ; por exemplo, em App.OnLaunched.
Classe BackgroundTaskBuilder (Windows.ApplicationModel.Background) (Microsoft.Windows.ApplicationModel.Background) BackgroundTaskBuilder classe. Consulte Uso de tarefas em segundo plano nos aplicativos Windows.
Método CoreApplication.CreateNewView (Windows.ApplicationModel.Core) Método AppWindow.Create (Microsoft.UI.Windowing)
Classe CoreApplicationViewTitleBar (Windows.ApplicationModel.Core) Classe AppWindowTitleBar (Microsoft.UI.Windowing)
(Windows.ApplicationModel.Core) Propriedade CoreApplicationViewTitleBar.ExtendViewIntoTitleBar (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.ExtendsContentIntoTitleBar . A plataforma continua a desenhar os botões Minimizar/Maximizar/Fechar para você e relata as informações de oclusão.
(Windows.ApplicationModel.Core) Propriedade CoreApplicationViewTitleBar.Height (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.Height
(Windows.ApplicationModel.Core) Propriedade CoreApplicationViewTitleBar.SystemOverlayLeftInset (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.LeftInset
Propriedade CoreApplicationViewTitleBar.SystemOverlayRightInset (Windows.ApplicationModel.Core) Propriedade AppWindowTitleBar.RightInset (Microsoft.UI.Windowing)
Namespace Windows.ApplicationModel.Resources.Core Microsoft.Windows.ApplicationModel.Resources. Confira Migração do MRT para MRT Core.
Método ResourceContext.GetForCurrentView (Windows.ApplicationModel.Resources.Core) Método ResourceManager.CreateResourceContext (Microsoft.Windows.ApplicationModel.Resources). Consulte ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse.
Método ResourceContext.GetForViewIndependentUse (Windows.ApplicationModel.Resources.Core) Método ResourceManager.CreateResourceContext (Microsoft.Windows.ApplicationModel.Resources). Consulte ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse.
(Windows.ApplicationModel.Resources.Core) Propriedade ResourceManager.Current Crie um novo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consulte a classe ResourceManager.
(Windows.ApplicationModel.Resources.Core) Evento ResourceQualifierObservableMap.MapChanged Detecte as mudanças do ambiente por si mesmo. Consulte Alteração do valor do qualificador de recurso.
Classe PrintManager (Windows.Graphics.Printing) Não há suporte no SDK do Aplicativo Windows 1.0.
Classe CameraCaptureUI (Windows.Media.Capture) Classe CameraCaptureUI (Microsoft.Windows.Media.Capture)
Classe WebAuthenticationBroker (Windows.Security.Authentication.Web) Classe OAuth2Manager (microsoft.Security.Authentication.OAuth) (com suporte no SDK do Aplicativo do Windows 1.7 e posterior). Consulte Implementar a funcionalidade OAuth em aplicativos do Windows para obter mais informações sobre como usar OAuth2Manager e APIs relacionadas para executar a autenticação do OAuth 2.0. Consulte o GitHub para obter um aplicativo de exemplo completo.
(Windows.Storage.Pickers) FileOpenPicker, FileSavePicker e FolderPicker Com suporte, mas você deve usar a interface IInitializeWithWindow . Consulte MessageDialog e Pickers.
Classe DisplayRequest(Windows.System.Display) Não há suporte no SDK do Aplicativo Windows 1.0.
Namespace Windows.UI.Composition Namespace Microsoft.UI.Composition
Classe CoreDispatcher (Windows.UI.Core) Classe DispatcherQueue (Microsoft.UI.Dispatching). Consulte Alterar CoreDispatcher para DispatcherQueue.
Método CoreDispatcher.RunAsync (Windows.UI.Core) Método DispatcherQueue.TryEnqueue (Microsoft.UI.Dispatching). Consulte Alterar RunAsync para TryEnqueue.
Classe CoreWindow(Windows.UI.Core) Classe AppWindow (Microsoft.UI.Windowing). Confira Migração da funcionalidade de janelas.
(Windows.UI.Core) Propriedade CoreWindow.Bounds (normalmente aparece em C# como CoreWindow.GetForCurrentThread.Bounds) Propriedade (Microsoft.UI.Windowing) AppWindow.Size
Método CoreWindow.GetForCurrentThread (Windows.UI.Core) Nenhum mapeamento direto 1:1 para uma API do Windows App SDK. Ao usar XAML, você pode obter Window.AppWindow para obter o AppWindow associado a um Window XAML, mas um aplicativo precisa armazenar em cache o Window ou AppWindow se quiser acessá-lo de algum lugar que não tenha acesso. Recomendamos expor e armazenar em cache a janela no objeto App.
Método CoreWindow.Activate (Windows.UI.Core) Método AppWindow.Show (Microsoft.UI.Windowing)
Propriedade CoreWindow.Dispatcher (Windows.UI.Core) (Microsoft.UI.Xaml) Propriedade Window.DispatcherQueue. Consulte Alterar CoreWindow.Dispatcher para Window.DispatcherQueue.
CoreWindow.SizeChanged evento (Windows.UI.Core) Método AppWindowChangedEventArgs.DidSizeChange (Microsoft.UI.Windowing)
Classe SystemNavigationManager (botão voltar global) (Windows.UI.Core) Não há suporte. Implemente um botão Voltar em sua própria interface do usuário. Consulte Uma migração do SDK do Windows App do aplicativo de exemplo PhotoLab UWP (C#).
Classe WindowSizeChangedEventArgs (Windows.UI.Core) (Microsoft.UI.Xaml) WindowSizeChangedEventArgs classe; por exemplo, em um manipulador para (Microsoft.UI.Xaml) Window.SizeChanged.
Classe MessageDialog(Windows.UI.Popups) Com suporte, mas você deve usar a interface IInitializeWithWindow . Consulte MessageDialog e Pickers.
Classe CoreTextServicesManager (Windows.UI.Text.Core) Com suporte apenas no Windows 11.
(Windows.UI.ViewManagement) Evento de AccessibilitySettings.HighContrastChanged Evento ThemeSettings.Changed (Microsoft.UI.System)
Classe ApplicationView(Windows.UI.ViewManagement) Classe AppWindow (Microsoft.UI.Windowing)
(Windows.UI.ViewManagement) propriedade ApplicationView.Title (Microsoft.UI.Windowing) propriedade AppWindow.Title
Método ApplicationView.TryConsolidateAsync (Windows.UI.ViewManagement) Método AppWindow.Destroy (Microsoft.UI.Windowing)
Método ApplicationView.TryEnterFullScreenMode (Windows.UI.ViewManagement) Método AppWindow.SetPresenter (Microsoft.UI.Windowing) com AppWindowPresenterKind.FullScreen
(Windows.UI.ViewManagement) Método ApplicationView.TryEnterViewModeAsync com o modo ApplicationViewMode.CompactOverlay Método AppWindow.SetPresenter (Microsoft.UI.Windowing) com AppWindowPresenterKind.CompactOverlay
Método ApplicationView.TryResizeView (Windows.UI.ViewManagement) Método AppWindow.Resize (Microsoft.UI.Windowing)
ApplicationViewMode.CompactOverlay campo (Windows.UI.ViewManagement) Campo (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay
Classe ApplicationViewTitleBar (Windows.UI.ViewManagement) Classe AppWindowTitleBar (Microsoft.UI.Windowing)
Campo ApplicationViewWindowingMode.FullScreen (Windows.UI.ViewManagement) Campo (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen
Classe AppWindow(Windows.UI.WindowManagement) Classe AppWindow (Microsoft.UI.Windowing)
Evento Windows.UI.WindowManagement: AppWindow.Changed (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) Propriedade Microsoft.UI.WindowingAppWindow.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) Propriedade AppWindow.Title (Microsoft.UI.Windowing) Propriedade 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)
Método AppWindowChangedEventArgs.DidSizeChange (Windows.UI.WindowManagement) (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange método
Propriedade (Windows.UI.WindowManagement) AppWindowPlacement.Size Propriedade (Microsoft.UI.Windowing) AppWindow.Size
Campo (Windows.UI.WindowManagement) AppWindowPresentationKind.CompactOverlay Campo (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay
Campo (Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen Campo (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen
Método AppWindowPresenter.RequestPresentation (Windows.UI.WindowManagement) Método AppWindow.SetPresenter (Microsoft.UI.Windowing)
Classe AppWindowTitleBar (Windows.UI.WindowManagement) Classe AppWindowTitleBar (Microsoft.UI.Windowing)
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility Nenhum mapeamento direto 1:1 para uma API do Windows App SDK
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, juntamente com Height, fornecem as mesmas informações.
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility Nenhum mapeamento direto 1:1 para uma API do Windows App SDK
Propriedade AppWindowTitleBarOcclusion (Windows.UI.WindowManagement) (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, juntamente com Height, fornecem as mesmas informações.
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility Nenhum mapeamento direto 1:1 para uma API do Windows App SDK
Namespace Windows.UI.Xaml Namespace Microsoft.UI.Xaml
Método Application.OnActivated (Windows.UI.Xaml) (normalmente aparece em C# como App.OnActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnBackgroundActivated (normalmente aparece em C# como App.OnBackgroundActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnCachedFileUpdaterActivated (normalmente aparece em C# como App.OnCachedFileUpdaterActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnFileActivated (normalmente aparece em C# como App.OnFileActivated) Consulte Associação de tipo de arquivo e OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnFileOpenPickerActivated (normalmente aparece em C# como App.OnFileOpenPickerActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnFileSavePickerActivated (normalmente aparece em C# como App.OnFileSavePickerActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnSearchActivated (normalmente aparece em C# como App.OnSearchActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Método Application.OnShareTargetActivated (normalmente aparece em C# como App.OnShareTargetActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
Propriedade Windows.UI.XamlWindow.Current Descontinuado, e retorna null. Para obter uma alternativa, consulte Alterar Window.Current para App.Window.
Propriedade Window.UI.Xaml) Window.Dispatcher (geralmente escrita em C# como Window.Current.Dispatcher) (Microsoft.UI.Xaml) Propriedade Window.DispatcherQueue
Classe ContentDialog(Windows.UI.Xaml.Controls) (Microsoft.UI.Xaml.Controls) O ContentDialog tem suporte, mas você deve definir sua propriedade XamlRoot . Veja ContentDialog e Popup.
Classe InkCanvas(Windows.UI.Xaml.Controls) Não há suporte no SDK do Aplicativo Windows 1.0.
Classe MediaElement(Windows.UI.Xaml.Controls) Não há suporte no SDK do Aplicativo Windows 1.0.
Classe MapControl(Windows.UI.Xaml.Controls.Maps) Classe MapControl (Microsoft.UI.Xaml.Controls)
Classe Popup (Windows.UI.Xaml.Controls.Primitives) O pop-up (Microsoft.UI.Xaml.Controls.Primitives) tem suporte, mas você deve definir sua propriedade XamlRoot. Veja ContentDialog e Popup.
Propriedade (Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource No Windows App SDK, o (Microsoft.UI.Xaml.Media) AcrylicBrush sempre é amostrado do conteúdo do aplicativo. Consulte a propriedade AcrylicBrush.BackgroundSource.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); Consulte Migrar winrt.resume_foreground

Bibliotecas de terceiros

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

UWP SDK do Aplicativo do Windows
OneDrive SDK SDK do Microsoft Graph

Consulte Também