Mapping delle API e delle librerie UWP a Windows App SDK
Questo argomento fornisce un mapping di API e librerie UWP ai relativi equivalenti Windows App SDK. In alcuni casi il mapping non è uno a uno; una delle due piattaforme potrebbe avere più o meno funzionalità rispetto all'altra per uno spazio dei nomi o una classe.
Tra le due piattaforme esistono differenze nei nomi degli spazi dei nomi e delle classi (inclusi i controlli dell'interfaccia utente). In molti casi è sufficiente modificare un nome dello spazio dei nomi e il codice verrà compilato. In alcuni casi, oltre al nome dello spazio dei nomi è stato modificato un nome di classe o di API. In altri casi, il mapping richiede un po' più di lavoro e in rari casi richiede un cambiamento di approccio.
Come usare la tabella. Cercare prima di tutto il nome del membro della classe in uso. I membri vengono elencati ogni volta che il mapping è più complesso di una semplice modifica del nome della classe o del nome dello spazio dei nomi. Se il membro non è elencato, cercare il nome della classe in uso. Le classi vengono elencate ogni volta che il mapping è più complesso rispetto alla semplice modifica del nome dello spazio dei nomi (per indicazioni specifiche, vedere le Guide alle aree di funzionalità). Se la classe non è elencata, il mapping è solo una modifica dello spazio dei nomi. Trovare quindi il nome dello spazio dei nomi della classe e trovare il nome dello spazio dei nomi equivalente in Windows App SDK. La classe si troverà in quello spazio dei nomi. Se lo spazio dei nomi non è nell'elenco, il nome non è cambiato.
UWP | Windows App SDK |
---|---|
(Windows.ApplicationModel.Activation) classe LaunchActivatedEventArgs | (Microsoft.UI.Xaml) classe LaunchActivatedEventArgs: ad esempio, in App.OnLaunched. |
(Windows.ApplicationModel.Core) metodo CoreApplication.CreateNewView | (Microsoft.UI.Windowing) metodo AppWindow.Create |
(Windows.ApplicationModel.Core) classe CoreApplicationViewTitleBar | (Microsoft.UI.Windowing) classe AppWindowTitleBar |
(Windows.ApplicationModel.Core) proprietà CoreApplicationViewTitleBar.ExtendViewIntoTitleBar | (Microsoft.UI.Windowing) proprietà AppWindowTitleBar.ExtendsContentIntoTitleBar. La piattaforma continua a disegnare automaticamente i pulsanti Riduci/Ingrandisci/Chiudi e segnala le informazioni sull'occlusione. |
(Windows.ApplicationModel.Core) proprietà CoreApplicationViewTitleBar.Height | (Microsoft.UI.Windowing) proprietà AppWindowTitleBar.Height |
(Windows.ApplicationModel.Core) proprietà CoreApplicationViewTitleBar.SystemOverlayLeftInset | (Microsoft.UI.Windowing) proprietà AppWindowTitleBar.LeftInset |
(Windows.ApplicationModel.Core) proprietà CoreApplicationViewTitleBar.SystemOverlayRightInset | (Microsoft.UI.Windowing) proprietà AppWindowTitleBar.RightInset |
Windows.ApplicationModel.Resources.Core (spazio dei nomi) | Microsoft.Windows.ApplicationModel.Resources. Vedi Migrazione da MRT a MRT Core. |
(Windows.ApplicationModel.Resources.Core) metodo ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) metodo ResourceManager.CreateResourceContext. Vedere ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse. |
(Windows.ApplicationModel.Resources.Core) metodo ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) metodo ResourceManager.CreateResourceContext. Vedere ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse. |
(Windows.ApplicationModel.Resources.Core) proprietà ResourceManager.Current | Creare un nuovo oggetto (Microsoft.Windows.ApplicationModel.Resources) ResourceManager. Vedere Classe ResourceManager. |
(Windows.ApplicationModel.Resources.Core) evento ResourceQualifierObservableMap.MapChanged | Rilevare autonomamente le modifiche all'ambiente. Vedere Modifica del valore del qualificatore di risorsa. |
(Windows.Graphics.Printing) classe PrintManager | Non supportata in Windows App SDK 1.0. |
(Windows.Media.Capture) classe CameraCaptureUI | Non supportata in Windows App SDK 1.0. |
(Windows.Security.Authentication.Web) classe WebAuthenticationBroker | Non supportata in Windows App SDK 1.0. |
(Windows.Storage.Pickers) classi FileOpenPicker, FileSavePicker e FolderPicker | Supportate, ma è necessario usare l'interfaccia IInitializeWithWindow. Vedere MessageDialog e Pickers. |
(Windows.System.Display) classe DisplayRequest | Non supportata in Windows App SDK 1.0. |
Windows.UI.Composition (spazio dei nomi) | Microsoft.UI.Composition (spazio dei nomi) |
(Windows.UI.Core) classe CoreDispatcher | (Microsoft.UI.Dispatching) classe DispatcherQueue. Vedere Modificare CoreDispatcher in DispatcherQueue. |
(Windows.UI.Core) metodo CoreDispatcher.RunAsync | (Microsoft.UI.Dispatching) metodo DispatcherQueue.TryEnqueue . Vedere Modificare RunAsync in TryEnqueue. |
(Windows.UI.Core) classe CoreWindow | (Microsoft.UI.Windowing) classe AppWindow . Vedere Migrazione della funzionalità di windowing. |
(Windows.UI.Core) proprietà CoreWindow.Bounds (comunemente visualizzata in C# come CoreWindow.GetForCurrentThread.Bounds ) |
(Microsoft.UI.Windowing) proprietà AppWindow.Size |
(Windows.UI.Core) metodo CoreWindow.GetForCurrentThread | Nessun mapping diretto 1:1 a un'API SDK per app di Windows. Quando usi XAML, puoi ottenere Window.AppWindow per ottenere l'appWindow associata a una finestra XAML, ma un'app deve memorizzare nella cache la finestra o AppWindow se vuole accedervi da un punto qualsiasi che altrimenti non abbia accesso. È consigliabile memorizzare nella cache ed esporre Window nell'oggetto App. |
(Windows.UI.Core) metodo CoreWindow.Activate | (Microsoft.UI.Windowing) metodo AppWindow.Show |
(Windows.UI.Core) proprietà CoreWindow.Dispatcher | (Microsoft.UI.Xaml) proprietà Window.DispatcherQueue. Vedere Modificare CoreWindow.Dispatcher in Window.DispatcherQueue. |
(Windows.UI.Core) evento CoreWindow.SizeChanged | (Microsoft.UI.Windowing) metodo AppWindowChangedEventArgs.DidSizeChange |
(Windows.UI.Core) classe SystemNavigationManager (pulsante indietro globale) | Non supportato. Implementare un pulsante Indietro all'interno dell'interfaccia utente. Vedere Migrazione a Windows App SDK dell'app di esempio PhotoLab di UWP (C#). |
(Windows.UI.Core) classe WindowSizeChangedEventArgs | (Microsoft.UI.Xaml) classe WindowSizeChangedEventArgs ad esempio, in un gestore per (Microsoft.UI.Xaml) Window.SizeChanged. |
(Windows.UI.Popups) classe MessageDialog | Supportate, ma è necessario usare l'interfaccia IInitializeWithWindow. Vedere MessageDialog e Pickers. |
(Windows.UI.Text.Core) classe CoreTextServicesManager | Supportata solo su Windows 11. |
(Windows.UI.ViewManagement) classe ApplicationView | (Microsoft.UI.Windowing) classe AppWindow |
(Windows.UI.ViewManagement) proprietà ApplicationView.Title | (Microsoft.UI.Windowing) proprietà AppWindow.Title |
(Windows.UI.ViewManagement) metodo ApplicationView.TryConsolidateAsync | (Microsoft.UI.Windowing) metodo AppWindow.Destroy |
(Windows.UI.ViewManagement) metodo ApplicationView.TryEnterFullScreenMode | (Microsoft.UI.Windowing) metodo AppWindow.SetPresenter con AppWindowPresenterKind.FullScreen |
(Windows.UI.ViewManagement) metodo ApplicationView.TryEnterViewModeAsync con ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) metodo AppWindow.SetPresenter con AppWindowPresenterKind.CompactOverlay |
(Windows.UI.ViewManagement) metodo ApplicationView.TryResizeView | (Microsoft.UI.Windowing) metodo 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) metodo AppWindow.CloseAsync | (Microsoft.UI.Windowing) metodo AppWindow.Destroy |
(Windows.UI.WindowManagement) metodo AppWindow.GetPlacement | (Microsoft.UI.Windowing) proprietà AppWindow.Position |
(Windows.UI.WindowManagement) metodi Appwindow.RequestMoveXxx | (Microsoft.UI.Windowing) metodo AppWindow.Move |
(Windows.UI.WindowManagement) metodo AppWindow.RequestSize | (Microsoft.UI.Windowing) metodo AppWindow.Resize |
(Windows.UI.WindowManagement) proprietà AppWindow.Title | (Microsoft.UI.Windowing) proprietà AppWindow.Title |
(Windows.UI.WindowManagement) metodo AppWindow.TryCreateAsync | (Microsoft.UI.Windowing) metodo AppWindow.Create |
(Windows.UI.WindowManagement) metodo AppWindow.TryCreateAsync | (Microsoft.UI.Windowing) metodo AppWindow.Show |
(Windows.UI.WindowManagement) metodo AppWindowChangedEventArgs.DidSizeChange | (Microsoft.UI.Windowing) metodo AppWindowChangedEventArgs.DidSizeChange |
(Windows.UI.WindowManagement) proprietà AppWindowPlacement.Size | (Microsoft.UI.Windowing) proprietà 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) metodo AppWindowPresenter.RequestPresentation | (Microsoft.UI.Windowing) metodo AppWindow.SetPresenter |
(Windows.UI.WindowManagement) classe AppWindowTitleBar | (Microsoft.UI.Windowing) classe AppWindowTitleBar |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Nessun mapping diretto 1:1 a un'API Windows App SDK |
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, abbinati con Altezza, forniscono le stesse informazioni. |
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Nessun mapping diretto 1:1 a un'API Windows App SDK |
(Windows.UI.WindowManagement) proprietà AppWindowTitleBarOcclusion | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, abbinati con Altezza, forniscono le stesse informazioni. |
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Nessun mapping diretto 1:1 a un'API Windows App SDK |
Windows.UI.Xaml (spazio dei nomi) | Microsoft.UI.Xaml (spazio dei nomi) |
(Windows.UI.Xaml) metodo Application.OnActivated (comunemente visualizzato in C# come App.OnActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnBackgroundActivated (comunemente visualizzato in C# come App.OnBackgroundActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnCachedFileUpdaterActivated (comunemente visualizzato in C# come App.OnCachedFileUpdaterActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnFileActivated (comunemente visualizzato in C# come App.OnFileActivated ) |
Vedere Associazioni di tipi di file e OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnFileOpenPickerActivated (comunemente visualizzato in C# come App.OnFileOpenPickerActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnFileSavePickerActivated (comunemente visualizzato in C# come App.OnFileSavePickerActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnSearchActivated (comunemente visualizzato in C# come App.OnSearchActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) metodo Application.OnShareTargetActivated (comunemente visualizzato in C# come App.OnShareTargetActivated ) |
Vedere OnActivated, OnBackgroundActivated e altri metodi di gestione dell'attivazione. |
(Windows.UI.Xaml) proprietà Window.Current | Deprecata e restituisce null . Per un'alternativa, vedere Modificare Window.Current in App.Window. |
(Windows.UI.Xaml) proprietà Window.Dispatcher (comunemente scritta in C# come Window.Current.Dispatcher ) |
(Microsoft.UI.Xaml) proprietà Window.DispatcherQueue |
(Windows.UI.Xaml.Controls) classe ContentDialog | (Microsoft.UI.Xaml.Controls) ContentDialog è supportato, ma devi impostarne la proprietà XamlRoot. Vedere ContentDialog e Popup. |
(Windows.UI.Xaml.Controls) classe InkCanvas | Non supportata in Windows App SDK 1.0. |
(Windows.UI.Xaml.Controls) classe MediaElement | Non supportata in Windows App SDK 1.0. |
(Windows.UI.Xaml.Controls.Maps) classe MapControl | Classe MapControl (Microsoft.UI.Xaml.Controls) |
(Windows.UI.Xaml.Controls.Primitives) classe Popup | (Microsoft.UI.Xaml.Controls.Primitives) Popup è supportato, ma devi impostarne la proprietà XamlRoot. Vedere ContentDialog e Popup. |
(Windows.UI.Xaml.Media) proprietà AcrylicBrush.BackgroundSource | In Windows App SDK, la proprietà (Microsoft.UI.Xaml.Media) AcrylicBrush utilizza sempre frammenti dei contenuti dell'app. Vedere proprietà AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Vedere Migrazione di winrt.resume_foreground |
Librerie di terze parti
Questa sezione documenta varie librerie supportate nella piattaforma UWP e deve essere modificata quando si usa WinUI 3.
UWP | Windows App SDK |
---|---|
OneDrive SDK | Microsoft Graph SDK |