Freigeben über


RadialControllerConfiguration Klasse

Definition

Stellt Konfigurationsdetails für das RadialController-Menü bereit.

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
Vererbung
Object Platform::Object IInspectable RadialControllerConfiguration
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Beispiele

In diesem Beispiel geben wir an, welche integrierten Tools im Menü angezeigt werden, und legen das Standardtool fest.

  1. Zunächst erhalten wir in der ModifySystemDefaults -Funktion einen Verweis auf das RadialControllerConfiguration-Objekt für surface Dial (config) durch Aufrufen von GetForCurrentView.
  2. Anschließend rufen wir SetDefaultMenuItems auf, um die Standardauflistung der integrierten Menüelemente (Volume und Scroll) anzugeben.
  3. In der Select_Volume Funktion versuchen wir, das Standardmenüelement auf Volume festzulegen, indem TrySelectDefaultMenuItem aufgerufen wird.
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); 
  }
}

In diesem Beispiel löschen wir alle integrierten Tools, indem Wir SetDefaultMenuItems aufrufen und eine leere Auflistung übergeben.

Wichtig

Falls vorhanden, fügt die InkToolbar dem RadialController-Menü zwei benutzerdefinierte Tools hinzu (Stift und Strichgröße). Auf diese Tools kann nicht über RadialController-APIs wie Items oder SetDefaultMenuItems zugegriffen werden.

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

Hinweise

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1703 15063 ActiveControllerWhenMenuIsSuppressed
1703 15063 IsMenuSuppressed
1709 16299 App-Controller
1709 16299 IsAppControllerEnabled

Eigenschaften

ActiveControllerWhenMenuIsSuppressed

Ruft den RadialController ab, der aktiviert werden soll, wenn das RadialController-Menü unterdrückt wird, oder legt diesen fest.

AppController

Ruft ab oder legt fest, ob das RadialController-Objekt an den Standard Anwendungsprozess und nicht an eine bestimmte App-Ansicht (oder ein Fenster der obersten Ebene) gebunden ist.

Wenn AppController festgelegt ist, wird dieser radiale Controller (und das Menü) für das Fenster der obersten Ebene und alle Ansichten im Anwendungsprozess verwendet (wobei alle einzelnen Ansichtscontroller überschrieben werden, die Sie definiert haben).

Hinweis

Außerdem müssen Sie IsAppControllerEnabled auf true festlegen.

IsAppControllerEnabled

Ruft ab oder legt fest, ob das RadialController-Objekt als AppController aktiviert ist und Controllerereignisse von Ihrer App verarbeitet werden können.

IsMenuSuppressed

Ruft ab oder legt fest, ob das RadialController-Menü angezeigt werden kann.

Methoden

GetForCurrentView()

Ruft ein RadialControllerConfiguration-Objekt ab, das an die aktive Anwendung gebunden ist.

ResetToDefaultMenuItems()

Stellt das RadialController-Menü auf die Standardkonfiguration zurück.

SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)

Gibt an, welche integrierten Tools im RadialController-Menü angezeigt werden.

Wichtig

Falls vorhanden, fügt die InkToolbar dem RadialController-Menü zwei benutzerdefinierte Tools hinzu (Stift und Strichgröße). Auf diese Tools kann nicht über RadialController-APIs wie Items oder SetDefaultMenuItems zugegriffen werden.

TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

Versucht, ein Tool aus der Sammlung der integrierten RadialController-Tools auszuwählen und zu aktivieren, die für den aktuellen App-Kontext unterstützt werden.

Gilt für:

Weitere Informationen