Partilhar via

Mapeando APIs e bibliotecas UWP para o SDK do Aplicativo Windows

  • Artigo

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) Classe LaunchActivatedEventArgs (Microsoft.UI.Xaml) LaunchActivatedEventArgs; por exemplo, em App.OnLaunched.
(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) Propriedade CoreApplicationViewTitleBar.ExtendViewIntoTitleBar (Microsoft.UI.Windowing) AppWindowTitleBar.ExtendsContentIntoTitleBar . A plataforma continua a desenhar os botões Minimizar/Maximizar/Fechamento 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
(Windows.ApplicationModel.Core) Propriedade CoreApplicationViewTitleBar.SystemOverlayRightInset (Microsoft.UI.Windowing) Propriedade AppWindowTitleBar.RightInset
Namespace Windows.ApplicationModel.Resources.Core Microsoft.Windows.ApplicationModel.Resources. Confira Migração do 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) Propriedade ResourceManager.Current Crie um novo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consulte 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.
(Windows.Graphics.Printing) classe PrintManager Não há suporte no SDK do Aplicativo Windows 1.0.
(Windows.Media.Capture) classe CameraCaptureUI Não há suporte no SDK do Aplicativo Windows 1.0.
(Windows.Security.Authentication.Web) Classe WebAuthenticationBroker 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.
(Windows.System.Display) classe DisplayRequest Não há suporte no SDK do Aplicativo Windows 1.0.
Namespace Windows.UI.Composition Namespace Microsoft.UI.Composition
(Windows.UI.Core) Classe CoreDispatcher (Microsoft.UI.Dispatching) Classe DispatcherQueue . Consulte 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. Confira Migração da funcionalidade de janelas.
(Windows.UI.Core) Propriedade CoreWindow.Bounds (geralmente aparece em C# como CoreWindow.GetForCurrentThread.Bounds) (Microsoft.UI.Windowing) Propriedade AppWindow.Size
(Windows.UI.Core) Método CoreWindow.GetForCurrentThread Nenhum mapeamento 1:1 direto para uma API SDK do Aplicativo Windows. Ao usar XAML, você pode fazer com que Window.AppWindow obtenha o AppWindow associado a uma janela XAML, mas um aplicativo precisa armazenar em cache o Window ou AppWindow se quiser acessá-lo de algum lugar que, de outra forma, não teria acesso. Recomendamos armazenar em 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) Propriedade CoreWindow.Dispatcher (Microsoft.UI.Xaml) Window.DispatcherQueue . Consulte Alterar CoreWindow.Dispatcher para Window.DispatcherQueue.
(Windows.UI.Core) Evento CoreWindow.SizeChanged (Microsoft.UI.Windowing) Método AppWindowChangedEventArgs.DidSizeChange
(Windows.UI.Core) Classe SystemNavigationManager (botão Voltar global) 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 UWP PhotoLab (C#).
(Windows.UI.Core) classe WindowSizeChangedEventArgs (Microsoft.UI.Xaml) WindowSizeChangedEventArgs; por exemplo, em um manipulador para (Microsoft.UI.Xaml) Window.SizeChanged.
(Windows.UI.Popups) classe MessageDialog Com suporte, mas você deve usar a interface IInitializeWithWindow . Consulte MessageDialog e Seletores.
(Windows.UI.Text.Core) Classe CoreTextServicesManager Com suporte apenas no Windows 11.
(Windows.UI.ViewManagement) classe ApplicationView (Microsoft.UI.Windowing) classe AppWindow
(Windows.UI.ViewManagement) Propriedade ApplicationView.Title (Microsoft.UI.Windowing) Propriedade AppWindow.Title
(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) Método ApplicationView.TryEnterViewModeAsync 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) Campo AppWindowPresenterKind.CompactOverlay
(Windows.UI.ViewManagement) Classe ApplicationViewTitleBar (Microsoft.UI.Windowing) classe AppWindowTitleBar
(Windows.UI.ViewManagement) Campo ApplicationViewWindowingMode.FullScreen (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.FullScreen
(Windows.UI.WindowManagement) classe AppWindow (Microsoft.UI.Windowing) classe AppWindow
(Windows.UI.WindowManagement) Evento AppWindow.Changed (Microsoft.UI.Windowing) Evento Microsoft.UI.Windowing.AppWindow.Changed
(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) Campo AppWindowPresenterKind.CompactOverlay
(Windows.UI.WindowManagement) Campo AppWindowPresentationKind.FullScreen (Microsoft.UI.Windowing) Campo 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 Nenhum mapeamento direto 1:1 para uma API 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 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 SDK do Aplicativo Windows
Namespace Windows.UI.Xaml Namespace Microsoft.UI.Xaml
(Windows.UI.Xaml) Application.OnActivated (geralmente aparece em C# como App.OnActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Application.OnBackgroundActivated (geralmente aparece em C# como App.OnBackgroundActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated (geralmente aparece em C# como App.OnCachedFileUpdaterActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Application.OnFileActivated (geralmente 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) Application.OnFileOpenPickerActivated (geralmente aparece em C# como App.OnFileOpenPickerActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Application.OnFileSavePickerActivated (geralmente aparece em C# como App.OnFileSavePickerActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Application.OnSearchActivated (geralmente aparece em C# como App.OnSearchActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Application.OnShareTargetActivated (geralmente aparece em C# como App.OnShareTargetActivated) Consulte OnActivated, OnBackgroundActivated e outros métodos de tratamento de ativação.
(Windows.UI.Xaml) Propriedade Window.Current Preterido e retorna null. Para obter uma alternativa, consulte Alterar Window.Current para App.Window.
(Windows.UI.Xaml) 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 tem suporte, mas você deve definir sua propriedade XamlRoot . Consulte ContentDialog e Popup.
(Windows.UI.Xaml.Controls) classe InkCanvas Não há suporte no SDK do Aplicativo Windows 1.0.
(Windows.UI.Xaml.Controls) classe MediaElement Não há suporte no SDK do Aplicativo Windows 1.0.
(Windows.UI.Xaml.Controls.Maps) classe MapControl (Microsoft.UI.Xaml.Controls) classe MapControl
(Windows.UI.Xaml.Controls.Primitives) Classe pop-up (Microsoft.UI.Xaml.Controls.Primitives) O pop-up é suportado, mas você deve definir sua propriedade XamlRoot. Consulte ContentDialog e Popup.
(Windows.UI.Xaml.Media) Propriedade AcrylicBrush.BackgroundSource No SDK do Aplicativo Windows, o (Microsoft.UI.Xaml.Media) AcrylicBrush sempre mostra amostras 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

Confira também