RadialControllerConfiguration Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Input

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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

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.

Prima di tutto, nella funzione viene visualizzato un riferimento all'oggetto ModifySystemDefaults RadialControllerConfiguration per Surface Dial (config) chiamando GetForCurrentView.
Quindi, chiamiamo SetDefaultMenuItems per specificare la raccolta predefinita di voci di menu predefinite (Volume e Scorrimento).
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