Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |
| ( |
(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
Windows developer