RadialControllerConfiguration 类

定义

命名空间:

Windows.UI.Input

提供 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

继承

Object Platform::Object IInspectable RadialControllerConfiguration

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

示例

在此示例中，我们指定菜单中显示的内置工具，并设置默认工具。

1. 首先，在 函数中ModifySystemDefaults，我们通过调用 GetForCurrentView 获取对 Surface Dial (config) 的 RadialControllerConfiguration 对象的引用。
2. 然后，调用 SetDefaultMenuItems 以指定内置菜单项的默认集合， (卷 和 滚动) 。
3. 在 函数中Select_Volume，我们尝试通过调用 TrySelectDefaultMenuItem 将默认菜单项设置为 Volume。

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); 
  }
}

在此示例中，我们通过调用 SetDefaultMenuItems 并传递空集合来清除所有内置工具。

重要

如果存在， InkToolbar 会将两个自定义工具添加到 RadialController 菜单， (笔和笔划大小) 。 这些工具无法通过 RadialController API（如 Items 或 SetDefaultMenuItems）访问。

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

注解

版本历史记录

Windows 版本	SDK 版本	已添加值
1703	15063	ActiveControllerWhenMenuIsSuppressed
1703	15063	IsMenuSuppressed
1709	16299	应用控制器
1709	16299	IsAppControllerEnabled

属性

ActiveControllerWhenMenuIsSuppressed	获取或设置 在取消显示 RadialController 菜单时要激活 的 RadialController 。
AppController	获取或设置 RadialController 对象是否绑定到main应用程序进程，而不是绑定到特定应用视图 (或顶级窗口) 。 如果设置了 AppController，该径向控制器 (和菜单) 将用于顶级窗口，应用程序进程中的所有视图 (重写) 定义的任何单个视图控制器。 注意 还必须将 IsAppControllerEnabled 设置为 true。
IsAppControllerEnabled	获取或设置 RadialController 对象是否作为 AppController 启用，并且控制器事件可由应用处理。
IsMenuSuppressed	获取或设置是否可以显示 RadialController 菜单。

方法

GetForCurrentView()	检索绑定到活动应用程序的 RadialControllerConfiguration 对象。
ResetToDefaultMenuItems()	将 RadialController 菜单还原到默认配置。
SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)	指定在 RadialController 菜单上显示的内置工具。 重要 如果存在， InkToolbar 会将两个自定义工具添加到 RadialController 菜单， (笔和笔划大小) 。 这些工具无法通过 RadialController API（如 Items 或 SetDefaultMenuItems）访问。
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)	尝试从当前应用上下文支持的内置 RadialController 工具集合中选择和激活工具。

另请参阅

• Windows.UI.Input
• Surface Dial 交互
• 通用 Windows 平台示例（C# 和 C++）
• Windows 桌面示例
• 径向控制器示例