Share via

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 工具集合中選取並啟用工具。

適用於

另請參閱