RadialControllerConfiguration Klasse

Referenz

Definition

Namespace:: Windows.UI.Input

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute MarshalingBehaviorAttribute

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.

Zunächst erhalten wir in der ModifySystemDefaults -Funktion einen Verweis auf das RadialControllerConfiguration-Objekt für surface Dial (config) durch Aufrufen von GetForCurrentView.
Anschließend rufen wir SetDefaultMenuItems auf, um die Standardauflistung der integrierten Menüelemente (Volume und Scroll) anzugeben.
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: