RadialControllerConfiguration クラス

リファレンス

定義

名前空間:: Windows.UI.Input

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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 で導入)

例

この例では、メニューに表示される組み込みツールを指定し、既定のツールを設定します。

まず、関数で ModifySystemDefaultsGetForCurrentView を呼び出して、Surface Dial (config) の RadialControllerConfiguration オブジェクトへの参照を取得します。
次に、 SetDefaultMenuItems を呼び出して、組み込みのメニュー項目 (ボリュームとスクロール) の既定のコレクションを指定します。
関数では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 ツールのコレクションから、ツールの選択とアクティブ化を試みます。

適用対象