Partager via


RadialControllerConfiguration Classe

Définition

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

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.

  1. Tout d’abord, dans la ModifySystemDefaults fonction , nous obtenons une référence à l’objet RadialControllerConfiguration pour Surface Dial (config) en appelant GetForCurrentView.
  2. Ensuite, nous appelons SetDefaultMenuItems pour spécifier la collection par défaut d’éléments de menu intégrés (Volume et Défilement).
  3. 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 à

Voir aussi