RadialControllerConfiguration Classe

Référence

Définition

Espace de noms:: Windows.UI.Input

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit les détails de configuration du menu RadialController .

public ref class RadialControllerConfiguration sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RadialControllerConfiguration final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RadialControllerConfiguration

Public NotInheritable Class RadialControllerConfiguration

Héritage: Object Platform::Object IInspectable RadialControllerConfiguration

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Exemples

Dans cet exemple, nous spécifions les outils intégrés qui s’affichent dans le menu et définissons l’outil par défaut.

Tout d’abord, dans la ModifySystemDefaults fonction , nous obtenons une référence à l’objet RadialControllerConfiguration pour Surface Dial (config) en appelant GetForCurrentView.
Ensuite, nous appelons SetDefaultMenuItems pour spécifier la collection par défaut d’éléments de menu intégrés (Volume et Défilement).
Dans la Select_Volume fonction , nous essayons de définir l’élément de menu par défaut sur Volume en appelant TrySelectDefaultMenuItem.

public sealed partial class MainPage : Page
{
  RadialControllerConfiguration config;

  private void ModifySystemDefaults(object sender, RoutedEventArgs e) 
  {
    config = RadialControllerConfiguration.GetForCurrentView();
    config.SetDefaultMenuItems(
      new[] { RadialControllerSystemMenuItemKind.Volume, 
        RadialControllerSystemMenuItemKind.Scroll });
  }

  private void Select_Volume(object sender, RoutedEventArgs e)
  {
    config = RadialControllerConfiguration.GetForCurrentView();
    config.TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind.Volume); 
  }
}

Dans cet exemple, nous supprimons tous les outils intégrés en appelant SetDefaultMenuItems et en transmettant une collection vide.

Important

Lorsqu’il est présent, InkToolbar ajoute deux outils personnalisés au menu RadialController (taille du stylet et du trait). Ces outils ne sont pas accessibles via les API RadialController telles que Items ou SetDefaultMenuItems.

private void ClearSystemDefaults(object sender, RoutedEventArgs e) 
{
  config = RadialControllerConfiguration.GetForCurrentView();
  config.SetDefaultMenuItems(
    new[] { });
}

Remarques

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	ActiveControllerWhenMenuIsSuppressed
1703	15063	IsMenuSuppressed
1709	16299	Contrôleurd’application
1709	16299	IsAppControllerEnabled

Propriétés

ActiveControllerWhenMenuIsSuppressed	Obtient ou définit le RadialController à activer lorsque le menu RadialController est supprimé.
AppController	Obtient ou définit si l’objet RadialController est lié au processus d’application main plutôt qu’à une vue d’application spécifique (ou à une fenêtre de niveau supérieur). Si AppController est défini, ce contrôleur radial (et le menu) sont utilisés pour la fenêtre de niveau supérieur et toutes les vues du processus d’application (en remplaçant les contrôleurs d’affichage individuels que vous avez définis). Notes Vous devez également définir IsAppControllerEnabled sur true.
IsAppControllerEnabled	Obtient ou définit si l’objet RadialController est activé en tant qu’AppController et que les événements de contrôleur peuvent être gérés par votre application.
IsMenuSuppressed	Obtient ou définit si le menu RadialController peut être affiché.

Méthodes

GetForCurrentView()	Récupère un objet RadialControllerConfiguration lié à l’application active.
ResetToDefaultMenuItems()	Restaure la configuration par défaut du menu RadialController .
SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)	Spécifie les outils intégrés qui s’affichent dans le menu RadialController . Important Lorsqu’il est présent, InkToolbar ajoute deux outils personnalisés au menu RadialController (taille du stylet et du trait). Ces outils ne sont pas accessibles via les API RadialController telles que Items ou SetDefaultMenuItems.
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)	Tente de sélectionner et d’activer un outil à partir de la collection d’outils RadialController intégrés pris en charge pour le contexte d’application actuel.

S’applique à

Partager via