Condividi tramite


Mapping di API e librerie UWP all'SDK di Windows App

Questo argomento fornisce un mapping delle API 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 delle classi e dei namespace (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. Prima, cerca il nome del membro della classe che stai usando. 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 delle aree delle funzionalità). Se la classe non è elencata, il mapping è semplicemente una modifica dello spazio dei nomi. Individua il nome dello spazio dei nomi della tua classe e quindi trova quello equivalente nel Windows App SDK. La tua classe sarà in quel namespace. Se il 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.Background) BackgroundTaskBuilder Classe (Microsoft.Windows.ApplicationModel.Background Classe) BackgroundTaskBuilder. Vedi Uso delle attività in background nelle app di Windows.
(Windows.ApplicationModel.Core) Metodo CoreApplication.CreateNewView (Microsoft.UI.Windowing) Metodo AppWindow.Create
(Windows.ApplicationModel.Core) classe CoreApplicationViewTitleBar (Classe Microsoft.UI.Windowing) AppWindowTitleBar
(Windows.ApplicationModel.Core) Proprietà CoreApplicationViewTitleBar.ExtendViewIntoTitleBar Proprietà Microsoft.UI.WindowingAppWindowTitleBar.ExtendsContentIntoTitleBar. La piattaforma continua a disegnare i pulsanti Riduci ingrandisci//chiusura per te e segnala le informazioni sull'occlusione.
(Windows.ApplicationModel.Core) Proprietà CoreApplicationViewTitleBar.Height Proprietà AppWindowTitleBar.Height (Microsoft.UI.Windowing)
(Windows.ApplicationModel.Core) Proprietà CoreApplicationViewTitleBar.SystemOverlayLeftInset (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset proprietà
(Windows.ApplicationModel.Core) Proprietà CoreApplicationViewTitleBar.SystemOverlayRightInset (Microsoft.UI.Windowing) Proprietà AppWindowTitleBar.RightInset
Namespace Windows.ApplicationModel.Resources.Core Microsoft.Windows.ApplicationModel.Resources. Per ulteriori informazioni, consulta la migrazione MRT a MRT Core.
Metodo ResourceContext.GetForCurrentView (Windows.ApplicationModel.Resources.Core) (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext metodo. Vedere ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse.
(Windows.ApplicationModel.Resources.Core) Metodo ResourceContext.GetForViewIndependentUse (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext metodo. Vedere ResourceContext.GetForCurrentView e ResourceContext.GetForViewIndependentUse.
(Proprietà ResourceManager.Current di Windows.ApplicationModel.Resources.Core) ResourceManager.Current Creare un nuovo oggetto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Vedere classe ResourceManager.
Evento ResourceQualifierObservableMap.MapChanged (Windows.ApplicationModel.Resources.Core) Individua da solo i cambiamenti nell'ambiente. Consultare Resource qualifier value change.
(Windows.Graphics.Printing) Classe PrintManager Non supportato in Windows App SDK 1.0.
(Windows.Media.Capture) Classe CameraCaptureUI Classe CameraCaptureUI (Microsoft.Windows.Media.Capture)
(Windows.Security.Authentication.Web) Classe WebAuthenticationBroker (Microsoft.Security.Authentication.OAuth) classe OAuth2Manager (supportata in Windows App SDK 1.7 e versioni successive). Per altre informazioni sull'uso di OAuth2Manager e sulle API correlate per l'esecuzione dell'autenticazione OAuth 2.0, vedere Implementare la funzionalità OAuth nelle app di Windows. Per un'applicazione di esempio completa, vedere GitHub.
(Windows.Storage.Pickers) classi FileOpenPicker, FileSavePicker e FolderPicker Supportato, ma è necessario usare l'interfaccia IInitializeWithWindow . Vedere MessageDialog e Pickers.
(Windows.System.Display) Classe DisplayRequest Non supportato in Windows App SDK 1.0.
Namespace Windows.UI.Composition Namespace Microsoft.UI.Composition
(Windows.UI.Core) Classe CoreDispatcher (Microsoft.UI.Dispatching) Classe DispatcherQueue . Vedere Change CoreDispatcher to DispatcherQueue.
(Windows.UI.Core) Metodo CoreDispatcher.RunAsync (Microsoft.UI.Dispatching) Metodo DispatcherQueue.TryEnqueue . Vedere Change RunAsync to TryEnqueue.
(Windows.UI.Core) Classe CoreWindow (Microsoft.UI.Windowing) Classe AppWindow . Vedere migrazione delle 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 Nessuna corrispondenza diretta 1:1 con un'API del Windows App SDK. Quando utilizzi XAML, puoi ottenere Window.AppWindow per ottenere l'AppWindow associato a una Window, ma l'app deve memorizzare nella cache la Window o l'AppWindow se desidera accedervi da una posizione che altrimenti non ha accesso. Consigliamo di memorizzare nella cache ed esporre Window sull'oggetto App.
(Windows.UI.Core) Metodo CoreWindow.Activate (Microsoft.UI.Windowing) Metodo AppWindow.Show
(Windows.UI.Core) Proprietà CoreWindow.Dispatcher (Microsoft.UI.Xaml) Proprietà di Window.DispatcherQueue. Vedi Change CoreWindow.Dispatcher to 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. Consulta la migrazione all'SDK di Windows App dell'app di esempio PhotoLab 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) MessageDialog Supportato, ma è necessario usare l'interfaccia IInitializeWithWindow . Vedere MessageDialog e Pickers.
Classe CoreTextServicesManager (Windows.UI.Text.Core) Supportato solo in Windows 11.
(Windows.UI.ViewManagement) Evento AccessibilitySettings.HighContrastChanged (Microsoft.UI.System) ThemeSettings.Changed evento
Classe ApplicationView (Windows.UI.ViewManagement) (Microsoft.UI.Windowing) Classe AppWindow
Proprietà ApplicationView.Title (Windows.UI.ViewManagement) ApplicationView.Title Proprietà AppWindow.Title (Microsoft.UI.Windowing) 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) 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
(Classe Windows.UI.ViewManagement) ApplicationViewTitleBar (Classe Microsoft.UI.Windowing) AppWindowTitleBar
(Windows.UI.ViewManagement) Campo FullScreen di ApplicationViewWindowingMode Campo Microsoft.UI.WindowingAppWindowPresenterKind.FullScreen
(Windows.UI.WindowManagement) Classe AppWindow (Microsoft.UI.Windowing) Classe AppWindow
(Windows.UI.WindowManagement) Evento di AppWindow.Changed Evento Microsoft.UI.WindowingMicrosoft.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) Appwindow.RequestMoveXxx metodi (Microsoft.UI.Windowing) Metodo AppWindow.Move
(Windows.UI.WindowManagement) Metodo AppWindow.RequestSize (Microsoft.UI.Windowing) Metodo AppWindow.Resize
Proprietà AppWindow.Title (Windows.UI.WindowManagement) AppWindow.Title Proprietà AppWindow.Title (Microsoft.UI.Windowing) AppWindow.Title
(Windows.UI.WindowManagement) Metodo AppWindow.TryCreateAsync (Microsoft.UI.Windowing) Metodo AppWindow.Create
(Windows.UI.WindowManagement) Metodo AppWindow.TryShowAsync (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) AppWindowPresentationKind.FullScreen campo Campo Microsoft.UI.WindowingAppWindowPresenterKind.FullScreen
(Windows.UI.WindowManagement) Metodo AppWindowPresenter.RequestPresentation (Microsoft.UI.Windowing) Metodo AppWindow.SetPresenter
(Classe Windows.UI.WindowManagement) AppWindowTitleBar (Classe Microsoft.UI.Windowing) AppWindowTitleBar
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility Nessun mapping diretto 1:1 a un'API di Windows App SDK
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, insieme a Height, forniscono le stesse informazioni.
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility Nessuna associazione diretta 1:1 a un'API di Windows App SDK
(Windows.UI.WindowManagement) Proprietà AppWindowTitleBarOcclusion (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset e RightInset, insieme a Height, forniscono le stesse informazioni.
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility Nessun mapping diretto di 1:1 a un'API del Windows App SDK
Spazio dei nomi Windows.UI.Xaml namespace Microsoft.UI.Xaml
(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 associazione di tipi 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) 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 Obsoleta, restituisce null. Per un'alternativa, vedere Cambia 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
Classe ContentDialog (Windows.UI.Xaml.Controls) (Microsoft.UI.Xaml.Controls) ContentDialog è supportato, ma devi impostarne la proprietà XamlRoot . Vedere ContentDialog e Popup.
Classe InkCanvas (Windows.UI.Xaml.Controls) Non supportato in Windows App SDK 1.0.
Classe MediaElement (Windows.UI.Xaml.Controls) Non supportato in Windows App SDK 1.0.
Classe MapControl (Windows.UI.Xaml.Controls.Maps) Classe MapControl (Microsoft.UI.Xaml.Controls)
Classe (Windows.UI.Xaml.Controls.Primitives)Popup (Microsoft.UI.Xaml.Controls.Primitives) Popup è supportato, ma devi impostarne la proprietà XamlRoot . Vedere ContentDialog e Popup.
Proprietà AcrylicBrush.BackgroundSource (Windows.UI.Xaml.Media) Nel Windows App SDK, Microsoft.UI.Xaml.MediaAcrylicBrush campiona sempre dal contenuto dell'app. Vedere la proprietà AcrylicBrush.BackgroundSource.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); Vedere Migrate 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

Vedere anche