次の方法で共有

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. まず、関数で ModifySystemDefaultsGetForCurrentView を呼び出して、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 メニュー (ペンとストローク サイズ) に 2 つのカスタム ツールを追加します。 これらのツールは、Items や SetDefaultMenuItems などの RadialController API ではアクセスできません。

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 メニュー (ペンとストローク サイズ) に 2 つのカスタム ツールを追加します。 これらのツールは、Items や SetDefaultMenuItems などの RadialController API ではアクセスできません。
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

現在のアプリ コンテキストでサポートされている組み込みの RadialController ツールのコレクションから、ツールの選択とアクティブ化を試みます。

適用対象

こちらもご覧ください