Mapowanie interfejsów API i bibliotek platformy UWP na Windows SDK dla aplikacji
Ten temat zawiera mapowanie interfejsów API platformy UWP na odpowiedniki zestawu SDK aplikacji systemu Windows. W niektórych przypadkach mapowanie nie jest jedno-do-jednego; jedna platforma może mieć więcej lub mniej funkcji niż druga platforma dla przestrzeni nazw lub klasy.
Istnieją różnice w nazwach przestrzeni nazw i klas (w tym kontrolek interfejsu użytkownika) między dwiema platformami. W wielu przypadkach jest to tak proste, jak zmiana nazwy przestrzeni nazw, a następnie skompilowanie kodu. Czasami nazwa klasy lub interfejsu API uległa zmianie, a także nazwy przestrzeni nazw. Innym razem mapowanie wymaga nieco więcej pracy, i w rzadkich przypadkach wymaga zmiany podejścia.
Jak używać tabeli. Najpierw wyszukaj nazwę używanego członka klasy. Członkowie są wyświetlani za każdym razem, gdy mapowanie jest bardziej skomplikowane niż zmiana nazwy klasy lub przestrzeni nazw. Jeśli Twojego członka nie ma na liście, wyszukaj nazwę używanej klasy. Klasy są wyświetlane za każdym razem, gdy odwzorowanie jest bardziej skomplikowane niż tylko zmiana nazwy przestrzeni nazw (aby uzyskać szczegółowe wskazówki, zobacz przewodniki obszaru funkcji ). Jeśli klasa nie znajduje się na liście, mapowanie jest tylko zmianą przestrzeni nazw. W związku z tym znajdź nazwę przestrzeni nazw klasy, a następnie znajdziesz równoważną nazwę przestrzeni nazw zestawu SDK aplikacji systemu Windows. Klasa będzie znajdować się w tej przestrzeni nazw. Jeśli przestrzeń nazw nie znajduje się na liście, jej nazwa nie została zmieniona.
Platforma UWP | Zestaw SDK aplikacji systemu Windows |
---|---|
Klasa (Windows.ApplicationModel.Activation) LaunchActivatedEventArgs | (Microsoft.UI.Xaml) klasa LaunchActivatedEventArgs; na przykład w App.OnLaunched. |
(Windows.ApplicationModel.Background) BackgroundTaskBuilder, klasa | (Microsoft.Windows.ApplicationModel.Background) BackgroundTaskBuilder, klasa. Zobacz Używanie zadań w tle w aplikacjach systemu Windows. |
(Windows.ApplicationModel.Core) metoda CoreApplication.CreateNewView | (Microsoft.UI.Windowing) metoda AppWindow.Create |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar klasa | (Microsoft.UI.Windowing) AppWindowTitleBar class |
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar właściwość | (Microsoft.UI.Windowing) właściwość AppWindowTitleBar.ExtendsContentIntoTitleBar. Platforma nadal rysuje przyciski Minimalizuj/Maksymalizuj/Zamknij oraz zgłasza informacje o zaślepieniu. |
( właściwośćWindows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height | (Microsoft.UI.Windowing) właściwość AppWindowTitleBar.Height |
(Windows.ApplicationModel.Core) właściwość CoreApplicationViewTitleBar.SystemOverlayLeftInset | (właściwość Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset |
Właściwość Windows.ApplicationModel.Core (CoreApplicationViewTitleBar.SystemOverlayRightInset) | (Microsoft.UI.Windowing) AppWindowTitleBar.RightInset property |
przestrzeń nazw Windows.ApplicationModel.Resources.Core | Microsoft.Windows.ApplicationModel.Resources. Zobacz MRT to MRT Core migration. |
pl-PL: (Windows.ApplicationModel.Resources.Core) metoda ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) metoda ResourceManager.CreateResourceContext. Zobacz ResourceContext.GetForCurrentView i ResourceContext.GetForViewIndependentUse. |
(Windows.ApplicationModel.Resources.Core) ResourceContext.GetForViewIndependentUżyj metodę | (Microsoft.Windows.ApplicationModel.Resources) metoda ResourceManager.CreateResourceContext. Zobacz ResourceContext.GetForCurrentView i ResourceContext.GetForViewIndependentUse. |
(Windows.ApplicationModel.Resources.Core) właściwość ResourceManager.Current | Utwórz nowy obiekt (Microsoft.Windows.ApplicationModel.Resources) ResourceManager. Zobacz klasę ResourceManager. |
(Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged zdarzenie | Wykrywaj zmiany środowiska samodzielnie. Zobacz zmianę wartości kwalifikatora zasobów . |
Klasa |
Brak wsparcia w Windows App SDK 1.0. |
(Windows.Media.Capture) klasa CameraCaptureUI | Brak wsparcia w Windows App SDK 1.0. |
(Windows.Security.Authentication.Web) klasa WebAuthenticationBroker | (Microsoft.Security.Authentication.OAuth) klasa OAuth2Manager (obsługiwana w Windows App SDK w wersji 1.7 lub nowszej). Zobacz Implementowanie funkcji OAuth w aplikacjach systemu Windows, aby uzyskać więcej informacji na temat używania OAuth2Manager i powiązanych interfejsów API do przeprowadzania uwierzytelniania OAuth 2.0. Aby uzyskać pełną przykładową aplikację, zobacz GitHub. |
(Windows.Storage.Pickers ) FileOpenPicker, FileSavePickeri FolderPicker | Obsługiwane, ale należy użyć interfejsu IInitializeWithWindow. Zobacz MessageDialog i wybieraki. |
(Windows.System.Display) klasa DisplayRequest | Brak wsparcia w Windows App SDK 1.0. |
przestrzeń nazw Windows.UI.Composition | przestrzeni nazw Microsoft.UI.Composition |
(Windows.UI.Core) klasa CoreDispatcher | (Microsoft.UI.Dispatching) klasa DispatcherQueue. Zobacz Zmień CoreDispatcher na DispatcherQueue. |
(Windows.UI.Core) metoda CoreDispatcher.RunAsync | (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue metoda. Zobacz , zmień RunAsync na TryEnqueue. |
(Windows.UI.Core) CoreWindow, klasa | (Microsoft.UI.Windowing) klasa AppWindow. Zobacz Migrację funkcjonalności okien. |
(windows.UI.Core) CoreWindow.Bounds property (często pojawia się w języku C# jako CoreWindow.GetForCurrentThread.Bounds ) |
(Microsoft.UI.Windowing ) właściwość AppWindow.Size |
(Windows.UI.Core) metoda CoreWindow.GetForCurrentThread | Nie ma bezpośredniego mapowania 1:1 do interfejsu API zestawu SDK aplikacji systemu Windows. Korzystając z XAML, możesz uzyskać Window.AppWindow, aby uzyskać AppWindow powiązany z XAML Window, ale aplikacja musi buforować Window lub AppWindow, jeśli chce uzyskać do niego dostęp z miejsca, które w przeciwnym razie nie miałoby dostępu. Zalecamy buforowanie i uwidacznianie okna w aplikacji obiekcie. |
(Windows.UI.Core) metoda CoreWindow.Activate | metoda (Microsoft.UI.Windowing) AppWindow.Show |
właściwość (Windows.UI.Core) CoreWindow.Dispatcher | (Microsoft.UI.Xaml) właściwość Window.DispatcherQueue. Zobacz Zmień CoreWindow.Dispatcher na Window.DispatcherQueue. |
(Windows.UI.Core) zdarzenie CoreWindow.SizeChanged | (Microsoft.UI.Windowing) metoda AppWindowChangedEventArgs.DidSizeChange |
(Windows.UI.Core) klasa SystemNavigationManager (globalny przycisk Wstecz) | Nie jest obsługiwane. Zaimplementuj przycisk Wstecz we własnym interfejsie użytkownika. Zobacz migrację Windows App SDK przykładowej aplikacji PhotoLab UWP (C#). |
(Windows.UI.Core) klasa WindowSizeChangedEventArgs | (Microsoft.UI.Xaml) klasa WindowSizeChangedEventArgs; na przykład w procedurze obsługi (Microsoft.UI.Xaml) Window.SizeChanged. |
(Windows.UI.Popups) klasa MessageDialog | Obsługiwane, ale należy użyć interfejsu IInitializeWithWindow. Zobacz MessageDialog i wybieraki. |
(Windows.UI.Text.Core) CoreTextServicesManager, klasa | Obsługiwane tylko w systemie Windows 11. |
(Windows.UI.ViewManagement) AccessibilitySettings.HighContrastChanged zdarzenie | (Microsoft.UI.System) zdarzenie ThemeSettings.Changed |
(Windows.UI.ViewManagement) ApplicationView, klasa | (Microsoft.UI.Windowing) klasa AppWindow |
(Właściwość Windows.UI.ViewManagement) ApplicationView.Title | (Microsoft.UI.Windowing) właściwość AppWindow.Title |
(Windows.UI.ViewManagement) metoda ApplicationView.TryConsolidateAsync | Metoda (Microsoft.UI.Windowing) AppWindow.Destroy |
(Windows.UI.ViewManagement) metoda ApplicationView.TryEnterFullScreenMode | (Microsoft.UI.Windowing) metoda AppWindow.SetPresenter z użyciem AppWindowPresenterKind.FullScreen |
(Windows.UI.ViewManagement) metoda ApplicationView.TryEnterViewModeAsync z ApplicationViewMode.CompactOverlay | Metoda (Microsoft.UI.Windowing) AppWindow.SetPresenter z AppWindowPresenterKind.CompactOverlay |
(Windows.UI.ViewManagement) metoda ApplicationView.TryResizeView | (Microsoft.UI.Windowing) metoda AppWindow.Resize |
(Windows.UI.ViewManagement) ApplicationViewMode.CompactOverlay pole | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay pole |
(Windows.UI.ViewManagement) ApplicationViewTitleBar, klasa | (Microsoft.UI.Windowing) AppWindowTitleBar class |
(windows.UI.ViewManagement) ApplicationViewWindowingMode.FullScreen pole | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen pole |
(Windows.UI.WindowManagement) klasa AppWindow | (Microsoft.UI.Windowing) klasa AppWindow |
(Windows.UI.WindowManagement) AppWindow.Changed zdarzenie | Zdarzenie (Microsoft.UI.Windowing) Microsoft.UI.Windowing.AppWindow.Changed |
(Windows.UI.WindowManagementMetoda ) AppWindow.CloseAsync | Metoda (Microsoft.UI.Windowing) AppWindow.Destroy |
(Windows.UI.WindowManagement) Metoda AppWindow.GetPlacement | (Microsoft.UI.Windowing) właściwość AppWindow.Position |
(Windows.UI.WindowManagement) Appwindow.RequestMoveXxx metody | (Microsoft.UI.Windowing) metoda AppWindow.Move |
Metoda AppWindow.RequestSize (Windows.UI.WindowManagement) | (Microsoft.UI.Windowing) metoda AppWindow.Resize |
właściwość AppWindow.Title (Windows.UI.WindowManagement) | (Microsoft.UI.Windowing) właściwość AppWindow.Title |
Metoda (Windows.UI.WindowManagement) AppWindow.TryCreateAsync | (Microsoft.UI.Windowing) metoda AppWindow.Create |
(Windows.UI.WindowManagement) metoda AppWindow.TryShowAsync | metoda (Microsoft.UI.Windowing) AppWindow.Show |
(Windows.UI.WindowManagement) metoda AppWindowChangedEventArgs.DidSizeChange | (Microsoft.UI.Windowing) metoda AppWindowChangedEventArgs.DidSizeChange |
Właściwość AppWindowPlacement.Size w Windows.UI.WindowManagement | (Microsoft.UI.Windowing ) właściwość AppWindow.Size |
(Windows.UI.WindowManagement) pole AppWindowPresentationKind.CompactOverlay | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay pole |
( |
(Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen pole |
(Windows.UI.WindowManagement) AppWindowPresenter.RequestPresentation metoda | (Microsoft.UI.Windowing) metoda AppWindow.SetPresenter |
(Windows.UI.WindowManagement) klasa AppWindowTitleBar | (Microsoft.UI.Windowing) AppWindowTitleBar class |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Brak bezpośredniego odwzorowania 1:1 na API Windows App SDK |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset i RightInsetw połączeniu z Heightpodają te same informacje. |
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Brak bezpośredniego odwzorowania 1:1 na API Windows App SDK |
Właściwość (Windows.UI.WindowManagement) AppWindowTitleBarOcclusion | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset i RightInsetw połączeniu z Heightpodają te same informacje. |
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Brak bezpośredniego odwzorowania 1:1 na API Windows App SDK |
Windows.UI.Xaml przestrzeń nazw | przestrzeni nazw Microsoft.UI.Xaml |
(Windows.UI.Xaml) Metoda Application.OnActivated (często występuje w języku C# jako App.OnActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
(Windows.UI.Xaml) metoda Application.OnBackgroundActivated (często występuje w języku C# jako App.OnBackgroundActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
(Windows.UI.Xaml) metoda Application.OnCachedFileUpdaterActivated (często występuje w C# jako App.OnCachedFileUpdaterActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
(windows.UI.Xaml) Application.OnFileActivated method (często występuje w języku C# jako App.OnFileActivated ) |
Zobacz Skojarzenie typu pliku oraz metody obsługi aktywacji, takie jak OnActivated, OnBackgroundActivated i inne. |
(windows.UI.Xaml) metoda Application.OnFileOpenPickerActivated (często występuje w języku C# jako App.OnFileOpenPickerActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
(Windows.UI.Xaml) Application.OnFileSavePickerActivated metoda (często występuje w języku C# jako App.OnFileSavePickerActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
(Windows.UI.Xaml) Application.OnSearchActivated method (często występuje w języku C# jako App.OnSearchActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
(Windows.UI.Xaml) metoda Application.OnShareTargetActivated (często występuje w C# jako App.OnShareTargetActivated ) |
Zobacz OnActivated, OnBackgroundActivated i inne metody obsługi aktywacji. |
Windows.UI.Xamlwłaściwość Window.Current | Przestarzałe i zwraca null . Aby uzyskać alternatywę, zobacz Change Window.Current to App.Window. |
(właściwość Windows.UI.Xaml) Window.Dispatcher (często zapisywana w języku C# jako Window.Current.Dispatcher ) |
( właściwośćMicrosoft.UI.Xaml) Window.DispatcherQueue |
(Windows.UI.Xaml.Controls) klasa ContentDialog | (Microsoft.UI.Xaml.Controls) ContentDialog jest obsługiwany, ale należy ustawić jego właściwość XamlRoot. Zobacz ContentDialog oraz Popup. |
(Windows.UI.Xaml.Controls) klasa InkCanvas | Brak wsparcia w Windows App SDK 1.0. |
(Windows.UI.Xaml.Controls) klasa MediaElement | Brak wsparcia w Windows App SDK 1.0. |
(windows.UI.Xaml.Controls.Maps) klasa MapControl | (Microsoft.UI.Xaml.Controls ) MapControl klasa |
(Windows.UI.Xaml.Controls.Primitives) Popup, klasa | (Microsoft.UI.Xaml.Controls.Primitives) Popup jest obsługiwany, ale należy ustawić jego właściwość XamlRoot. Zobacz ContentDialog oraz Popup. |
(Windows.UI.Xaml.Media) właściwość AcrylicBrush.BackgroundSource | W zestawie SDK aplikacji systemu Windows (Microsoft.UI.Xaml.Media) AkrylBrush zawsze próbkuje zawartość aplikacji. Zobacz właściwość AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Zobacz Migrate winrt.resume_foreground |
Biblioteki innych firm
Ta sekcja zawiera dokumenty różnych bibliotek obsługiwanych w systemie UWP i należy je zmienić w przypadku korzystania z interfejsu WinUI 3.
Platforma UWP | Zestaw SDK aplikacji systemu Windows |
---|---|
OneDrive SDK | Zestaw SDK programu Microsoft Graph |