UIViewSettings Classe

Definição

Namespace:

Windows.UI.ViewManagement

Representa estados e comportamentos da interface do usuário associados ao modo de dispositivo (Tablet ou Desktop) e ao tipo de dispositivo de entrada.

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

Herança

Object Platform::Object IInspectable UIViewSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Aqui, mostramos como detectar e responder ao modo de interação do usuário.

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

Comentários

Para obter uma instância dessa classe, chame GetForCurrentView.

Modo tablet (somente Windows 10)

Observação

No Windows 11, o modo Tablet é removido e a nova funcionalidade é incluída para posturas de anexação e desanexação do teclado.

Alguns dispositivos (pc, laptop, tablet) dão suporte a um modo Desktop e Tablet .

Somente no Windows 10, os usuários podem alternar entre a execução no modo Tablet e o modo Desktop acessando o modo Tablet do Sistema > de Configurações > e configurando Tornar o Windows mais sensível ao toque ao usar seu dispositivo como tablet.

Propriedades

UserInteractionMode

Obtém um valor que indica se a interface do usuário do dispositivo é otimizada para entrada por toque ou entrada do mouse.

Métodos

GetForCurrentView()

Obtém os estados e comportamentos da interface do usuário associados ao modo de dispositivo (Tablet ou Área de Trabalho) para o aplicativo ativo. Modo tablet (somente Windows 10) Observação No Windows 11, o modo Tablet é removido e a nova funcionalidade é incluída para posturas de anexação e desanexação do teclado. Alguns dispositivos (pc, laptop, tablet) dão suporte a um modo Desktop e Tablet . Somente no Windows 10, os usuários podem alternar entre a execução no modo Tablet e o modo Desktop acessando o modo Tablet do Sistema > de Configurações > e configurando Tornar o Windows mais sensível ao toque ao usar seu dispositivo como tablet.

Confira também

• Amostra do modo de interação do usuário