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_VolumeTrySelectDefaultMenuItem을 호출하여 기본 메뉴 항목을 볼륨으로 설정하려고 합니다.
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 메뉴(펜 및 스트로크 크기)에 두 개의 사용자 지정 도구를 추가합니다. 이러한 도구는 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 앱컨트롤러
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 메뉴(펜 및 스트로크 크기)에 두 개의 사용자 지정 도구를 추가합니다. 이러한 도구는 Items 또는 SetDefaultMenuItems와 같은 RadialController API를 통해 액세스할 수 없습니다.
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

현재 앱 컨텍스트에서 지원되는 기본 제공 RadialController 도구 컬렉션에서 도구를 선택하고 활성화하려고 시도합니다.

적용 대상

추가 정보