Condividi tramite


RadialControllerConfiguration Classe

Definizione

Fornisce i dettagli di configurazione per il 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
Ereditarietà
Object Platform::Object IInspectable RadialControllerConfiguration
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Esempio

In questo esempio vengono specificati gli strumenti predefiniti visualizzati nel menu e si imposta lo strumento predefinito.

  1. Prima di tutto, nella funzione viene visualizzato un riferimento all'oggetto ModifySystemDefaults RadialControllerConfiguration per Surface Dial (config) chiamando GetForCurrentView.
  2. Quindi, chiamiamo SetDefaultMenuItems per specificare la raccolta predefinita di voci di menu predefinite (Volume e Scorrimento).
  3. Select_Volume Nella funzione si tenta di impostare la voce di menu predefinita su Volume chiamando 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); 
  }
}

In questo esempio vengono cancellati tutti gli strumenti predefiniti chiamando SetDefaultMenuItems e passando una raccolta vuota.

Importante

Quando presente, InkToolbar aggiunge due strumenti personalizzati al menu RadialController (dimensioni penna e tratto). Questi strumenti non sono accessibili tramite API RadialController , ad esempio Elementi o SetDefaultMenuItems.

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

Commenti

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1703 15063 ActiveControllerWhenMenuIsSuppressed
1703 15063 IsMenuSuppressed
1709 16299 AppController
1709 16299 IsAppControllerEnabled

Proprietà

ActiveControllerWhenMenuIsSuppressed

Ottiene o imposta RadialController per attivare quando il menu RadialController viene eliminato.

AppController

Ottiene o imposta se l'oggetto RadialController è associato al processo dell'applicazione principale anziché a una visualizzazione dell'app specifica (o finestra di primo livello).

Se AppController è impostato, tale controller radiale (e menu) viene usato per la finestra di primo livello e tutte le visualizzazioni nel processo dell'applicazione (override di tutti i singoli controller di visualizzazione definiti).

Nota

È anche necessario impostare IsAppControllerEnabled su true.

IsAppControllerEnabled

Ottiene o imposta se l'oggetto RadialController è abilitato come eventi appController e controller possono essere gestiti dall'app.

IsMenuSuppressed

Ottiene o imposta se è possibile visualizzare il menu RadialController .

Metodi

GetForCurrentView()

Recupera un oggetto RadialControllerConfiguration associato all'applicazione attiva.

ResetToDefaultMenuItems()

Ripristina il menu RadialController nella configurazione predefinita.

SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)

Specifica gli strumenti predefiniti visualizzati nel menu RadialController .

Importante

Quando presente, InkToolbar aggiunge due strumenti personalizzati al menu RadialController (dimensioni penna e tratto). Questi strumenti non sono accessibili tramite API RadialController , ad esempio Elementi o SetDefaultMenuItems.

TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

Tenta di selezionare e attivare uno strumento dalla raccolta di strumenti RadialController predefiniti supportati per il contesto dell'app corrente.

Si applica a

Vedi anche