Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
Windows developer