UIViewSettings Classe

Definizione

Rappresenta gli stati e i comportamenti dell'interfaccia utente associati alla modalità dispositivo (Tablet o Desktop) e al tipo di dispositivo di input.

public ref class UIViewSettings sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UIViewSettings final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class UIViewSettings
Public NotInheritable Class UIViewSettings
Ereditarietà
Object IInspectable UIViewSettings
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Qui viene illustrato come rilevare e rispondere alla modalità di interazione dell'utente.

using System.ComponentModel;
using Windows.UI.Core;
using Windows.UI.ViewManagement;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;

namespace SDKTemplate
{
    public sealed partial class Scenario1_Basic : Page, INotifyPropertyChanged
    {
        private MainPage rootPage;

        public Scenario1_Basic()
        {
            this.InitializeComponent();
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            rootPage = MainPage.Current;

            // The SizeChanged event is raised when the
            // user interaction mode changes.
            Window.Current.SizeChanged += OnWindowResize;
            UpdateContent();
        }

        protected override void OnNavigatedFrom(NavigationEventArgs e)
        {
            Window.Current.SizeChanged -= OnWindowResize;
        }

        void OnWindowResize(object sender, WindowSizeChangedEventArgs e)
        {
            UpdateContent();
        }

        public event PropertyChangedEventHandler PropertyChanged;

        #region InteractionMode data binding
        private UserInteractionMode interactionMode;

        public UserInteractionMode InteractionMode
        {
            get { return interactionMode; }
            set
            {
                if (interactionMode != value)
                {
                    interactionMode = value;
                    if (PropertyChanged != null)
                    {
                        PropertyChanged(this, 
                            new PropertyChangedEventArgs("InteractionMode"));
                    }
                }
            }
        }

        #region CheckBoxStyle data binding
        private Style checkBoxStyle;

        public Style CheckBoxStyle
        {
            get { return checkBoxStyle; }
            set
            {
                if (checkBoxStyle != value)
                {
                    checkBoxStyle = value;
                    if (PropertyChanged != null)
                    {
                        PropertyChanged(this, 
                            new PropertyChangedEventArgs("CheckBoxStyle"));
                    }
                }
            }
        }

        void UpdateContent()
        {
            InteractionMode = 
                UIViewSettings.GetForCurrentView().UserInteractionMode;

            // Update styles
            CheckBoxStyle = 
                InteractionMode == 
                    UserInteractionMode.Mouse ? 
                        MouseCheckBoxStyle : TouchCheckBoxStyle;
        }
    }
}

Commenti

Per ottenere un'istanza di questa classe, chiamare GetForCurrentView.

Modalità tablet (solo Windows 10)

Nota

In Windows 11, la modalità Tablet viene rimossa e viene inclusa una nuova funzionalità per il collegamento da tastiera e la rimozione delle posizioni.

Alcuni dispositivi (PC, laptop, tablet) supportano sia la modalità Desktop che tablet .

Solo in Windows 10, gli utenti possono passare dall'esecuzione in modalità Tablet alla modalità Desktop passando a Impostazioni > modalità Tablet di sistema > e impostando Rendi Windows più semplice quando si usa il dispositivo come tablet.

Proprietà

UserInteractionMode

Ottiene un valore che indica se l'interfaccia utente del dispositivo è ottimizzata per l'input tocco o l'input del mouse.

Metodi

GetForCurrentView()

Ottiene gli stati e i comportamenti dell'interfaccia utente associati alla modalità dispositivo (Tablet o Desktop) per l'app attiva.

Modalità tablet (solo Windows 10)

Nota

In Windows 11, la modalità Tablet viene rimossa e viene inclusa una nuova funzionalità per il collegamento da tastiera e la rimozione delle posizioni.

Alcuni dispositivi (PC, laptop, tablet) supportano sia la modalità Desktop che tablet .

Solo in Windows 10, gli utenti possono passare dall'esecuzione in modalità Tablet alla modalità Desktop passando a Impostazioni > modalità Tablet di sistema > e impostando Rendi Windows più semplice quando si usa il dispositivo come tablet.

Si applica a

Vedi anche