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 來指定內建功能表項目的預設集合， (Volume 和 Scroll) 。
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	AppController
1709	16299	IsAppControllerEnabled

屬性

ActiveControllerWhenMenuIsSuppressed	取得或設定 當 RadialController 功能表隱藏時要啟動的 RadialController 。
AppController	取得或設定 RadialController 物件是否系結至主要應用程式進程，而不是特定應用程式檢視 (或最上層視窗) 。 如果已設定 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 桌面範例
• 星形控制器範例