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 工具集合中选择和激活工具。

适用于

另请参阅