Compartir a través de

RadialControllerConfiguration Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Input
Editar

Proporciona detalles de configuración para el menú 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
Herencia
Object Platform::Object IInspectable RadialControllerConfiguration
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Ejemplos

En este ejemplo, especificamos qué herramientas integradas se muestran en el menú y establecemos la herramienta predeterminada.

  1. En primer lugar, en la ModifySystemDefaults función, obtenemos una referencia al objeto RadialControllerConfiguration para Surface Dial (config) llamando a GetForCurrentView.
  2. A continuación, llamamos a SetDefaultMenuItems para especificar la colección predeterminada de elementos de menú integrados (Volumen y Desplazamiento).
  3. En la Select_Volume función , intentamos establecer el elemento de menú predeterminado en Volume llamando a 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); 
  }
}

En este ejemplo, borramos todas las herramientas integradas llamando a SetDefaultMenuItems y pasando una colección vacía.

Importante

Cuando está presente, InkToolbar agrega dos herramientas personalizadas al menú RadialController (tamaño de lápiz y trazo). Estas herramientas no son accesibles a través de las API RadialController , como Items o SetDefaultMenuItems.

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

Comentarios

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1703 15063 ActiveControllerWhenMenuIsSuppressed
1703 15063 IsMenuSuppressed
1709 16299 AppController
1709 16299 IsAppControllerEnabled

Propiedades

ActiveControllerWhenMenuIsSuppressed

Obtiene o establece el RadialController que se activará cuando se suprima el menú RadialController .
AppController

Obtiene o establece si el objeto RadialController está enlazado al proceso de aplicación principal en lugar de a una vista de aplicación específica (o a una ventana de nivel superior).

Si se establece AppController, ese controlador radial (y menú) se usa para la ventana de nivel superior y todas las vistas del proceso de aplicación (reemplazando los controladores de vista individuales que haya definido).

Nota:

También debe establecer IsAppControllerEnabled en true.
IsAppControllerEnabled

Obtiene o establece si el objeto RadialController está habilitado como un appController y los eventos de controlador se pueden controlar mediante la aplicación.
IsMenuSuppressed

Obtiene o establece si se puede mostrar el menú RadialController .

Métodos

GetForCurrentView()

Recupera un objeto RadialControllerConfiguration enlazado a la aplicación activa.
ResetToDefaultMenuItems()

Restaura el menú RadialController a la configuración predeterminada.
SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)

Especifica qué herramientas integradas se muestran en el menú RadialController .

Importante

Cuando está presente, InkToolbar agrega dos herramientas personalizadas al menú RadialController (tamaño de lápiz y trazo). Estas herramientas no son accesibles a través de las API RadialController , como Items o SetDefaultMenuItems.
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

Intenta seleccionar y activar una herramienta de la colección de herramientas RadialController integradas compatibles con el contexto de la aplicación actual.

Se aplica a

Consulte también