UIViewSettings Klasse

Definition

Namespace:

Windows.UI.ViewManagement

Stellt ui-Zustände und Verhaltensweisen dar, die dem Gerätemodus (Tablet oder Desktop) und dem Eingabegerätetyp zugeordnet sind.

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

Vererbung

Object Platform::Object IInspectable UIViewSettings

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Hier zeigen wir, wie Sie den Benutzerinteraktionsmodus erkennen und darauf reagieren.

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;
        }
    }
}

Hinweise

Rufen Sie GetForCurrentView auf, um eine instance dieser Klasse zu erhalten.

Tablet-Modus (nur Windows 10)

Hinweis

In Windows 11 wird der Tablet-Modus entfernt, und neue Funktionen für die An- und Abkoppelung der Tastatur sind enthalten.

Einige Geräte (PC, Laptop, Tablet) unterstützen sowohl den Desktop- als auch den Tablet-Modus .

Nur auf Windows 10 können Benutzer zwischen der Ausführung im Tablet- und Desktopmodus wechseln, indem Sie zu Einstellungen > System > Tablet-Modus wechseln und Windows touchfreundlicher machen, wenn Sie Ihr Gerät als Tablet verwenden.

Eigenschaften

UserInteractionMode

Ruft einen Wert ab, der angibt, ob die Gerätebenutzeroberfläche für Toucheingaben oder Mauseingaben optimiert ist.

Methoden

GetForCurrentView()

Ruft die Ui-Zustände und Verhaltensweisen ab, die dem Gerätemodus (Tablet oder Desktop) für die aktive App zugeordnet sind. Tablet-Modus (nur Windows 10) Hinweis In Windows 11 wird der Tablet-Modus entfernt, und neue Funktionen für die An- und Abkoppelung der Tastatur sind enthalten. Einige Geräte (PC, Laptop, Tablet) unterstützen sowohl den Desktop- als auch den Tablet-Modus . Nur auf Windows 10 können Benutzer zwischen der Ausführung im Tablet- und Desktopmodus wechseln, indem Sie zu Einstellungen > System > Tablet-Modus wechseln und Windows touchfreundlicher machen, wenn Sie Ihr Gerät als Tablet verwenden.

Weitere Informationen

• Beispiel für den Benutzerinteraktionsmodus