Mapeando APIs e bibliotecas UWP para o SDK do Aplicativo Windows
Este tópico fornece um mapeamento de APIs UWP para seus equivalentes de SDK do Aplicativo Windows. Em alguns casos, o mapeamento não é um para um; uma 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 (inclusive controles de interface do usuário) entre as duas plataformas. Em muitos casos, isso é tão fácil quanto alterar um nome de namespace e, em seguida, o código será compilado. Às vezes, uma classe ou o nome da API mudou, bem como o nome do namespace. Em outras ocasiões, o mapeamento requer um pouco mais de trabalho e, em casos raros, requer uma mudança na 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 um nome de classe simples ou uma alteração de 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 equivalente SDK do Aplicativo Windows nome do namespace. A classe estará nesse namespace. Se o namespace não estiver listado, o nome dele não será alterado.
| UWP | SDK do Aplicativo do Windows |
|---|---|
| Classe LaunchActivatedEventArgs (Windows.ApplicationModel.Activation) | Classe LaunchActivatedEventArgs (Microsoft.UI.Xaml) ; por exemplo, em App.OnLaunched. |
| Método CoreApplication.CreateNewView (Windows.ApplicationModel.Core) | Método (Microsoft.UI.Windowing) AppWindow.Create |
| 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/Fechamento para você e relata as informações de oclusão. |
| Propriedade CoreApplicationViewTitleBar.Height (Windows.ApplicationModel.Core) | Propriedade (Microsoft.UI.Windowing) AppWindowTitleBar.Height |
| (Windows.ApplicationModel.Core) Propriedade CoreApplicationViewTitleBar.SystemOverlayLeftInset | Propriedade (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset |
| (Windows.ApplicationModel.Core) Propriedade CoreApplicationViewTitleBar.SystemOverlayRightInset | Propriedade (Microsoft.UI.Windowing) AppWindowTitleBar.RightInset |
| 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 do Windows.ApplicationModel.Resources.Core | Método ResourceManager.CreateResourceContext (Microsoft.Windows.ApplicationModel.Resources). Consulte ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse. |
| Propriedade (Windows.ApplicationModel.Resources.Core) ResourceManager.Current | Crie um novo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consulte Classe ResourceManager. |
| (Windows.ApplicationModel.Resources.Core) Evento ResourceQualifierObservableMap.MapChanged | Detectar alterações de ambiente para 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) | Não há suporte no SDK do Aplicativo Windows 1.0. |
| Classe WebAuthenticationBroker (Windows.Security.Authentication.Web) | Não há suporte no SDK do Aplicativo Windows 1.0. |
| (Windows.Storage.Pickers) Classes FileOpenPicker, FileSavePicker e FolderPicker | Com suporte, mas você deve usar a interface IInitializeWithWindow . Consulte MessageDialog e Seletores. |
| 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). Consulte Migração da funcionalidade de janela. |
(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) | Método (Microsoft.UI.Windowing) AppWindow.Create |
| Método CoreWindow.Activate (Windows.UI.Core) | Método AppWindow.Show (Microsoft.UI.Windowing) |
| Propriedade CoreWindow.Dispatcher (Windows.UI.Core) | Propriedade Window.DispatcherQueue (Microsoft.UI.Xaml). Consulte Alterar CoreWindow.Dispatcher para Window.DispatcherQueue. |
| Evento CoreWindow.SizeChanged (Windows.UI.Core) | Método (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange |
| 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 SDK do Aplicativo Windows do aplicativo de exemplo do PhotoLab UWP (C#). |
| Classe WindowSizeChangedEventArgs (Windows.UI.Core) | Classe (Microsoft.UI.Xaml) WindowSizeChangedEventArgs ; 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 Seletores. |
| Classe CoreTextServicesManager (Windows.UI.Text.Core) | Com suporte apenas em Windows 11. |
| Classe ApplicationView (Windows.UI.ViewManagement) | Classe AppWindow (Microsoft.UI.Windowing) |
| Propriedade ApplicationView.Title (Windows.UI.ViewManagement) | Propriedade (Microsoft.UI.Windowing) 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 |
| Método ApplicationView.TryEnterViewModeAsync (Windows.UI.ViewManagement) com 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) |
| (Windows.UI.ViewManagement) Campo ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.CompactOverlay |
| Classe ApplicationViewTitleBar (Windows.UI.ViewManagement) | Classe AppWindowTitleBar (Microsoft.UI.Windowing) |
| (Windows.UI.ViewManagement) Campo ApplicationViewWindowingMode.FullScreen | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.FullScreen |
| Classe AppWindow (Windows.UI.WindowManagement) | Classe AppWindow (Microsoft.UI.Windowing) |
| (Windows.UI.WindowManagement) Evento 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 AppWindow.Position (Microsoft.UI.Windowing) |
| 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) |
| Propriedade AppWindow.Title (Windows.UI.WindowManagement) | Propriedade AppWindow.Title (Microsoft.UI.Windowing) |
| 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 |
| Propriedade AppWindowPlacement.Size (Windows.UI.WindowManagement) | Propriedade AppWindow.Size (Microsoft.UI.Windowing) |
| (Windows.UI.WindowManagement) Campo AppWindowPresentationKind.CompactOverlay | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.WindowManagement) Campo AppWindowPresentationKind.FullScreen | (Microsoft.UI.Windowing) Campo 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 de SDK do Aplicativo Windows |
| (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 de SDK do Aplicativo Windows |
| (Windows.UI.WindowManagement) Propriedade AppWindowTitleBarOcclusion | (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 de SDK do Aplicativo Windows |
| Namespace Windows.UI.Xaml | Namespace Microsoft.UI.Xaml |
(Windows.UI.Xaml) Método Application.OnActivated (normalmente aparece em C# como App.OnActivated) |
Consulte OnActivated, OnBackgroundActivated e outros métodos de manipulação 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 manipulação 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 manipulação 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 manipulação 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 manipulação 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 manipulação 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 manipulação 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 manipulação de ativação. |
| Propriedade Window.Current (Windows.UI.Xaml) | Preterido e retorna null. Para obter uma alternativa, consulte Alterar Window.Current para App.Window. |
Propriedade Window.Dispatcher (Windows.UI.Xaml) (comumente escrita em C# como Window.Current.Dispatcher) |
Propriedade Window.DispatcherQueue (Microsoft.UI.Xaml) |
| Classe ContentDialog (Windows.UI.Xaml.Controls) | (Microsoft.UI.Xaml.Controls) Há suporte para ContentDialog , mas você deve definir sua propriedade XamlRoot . Consulte ContentDialog e Pop-up. |
| 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) | Não há suporte no SDK do Aplicativo Windows 1.0. |
| Classe pop-up (Windows.UI.Xaml.Controls.Primitives) | (Microsoft.UI.Xaml.Controls.Primitives) Há suporte para pop-up , mas você deve definir sua propriedade XamlRoot . Consulte ContentDialog e Pop-up. |
| Propriedade AcrylicBrush.BackgroundSource do (Windows.UI.Xaml.Media) | No SDK do Aplicativo Windows, o AcrylicBrush (Microsoft.UI.Xaml.Media) sempre é amostrado do conteúdo do aplicativo. Consulte a propriedade AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Confira 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 |
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
Windows developer
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de