Поделиться через


RadialControllerConfiguration Класс

Определение

Предоставляет сведения о конфигурации для меню 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
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v3.0)

Примеры

В этом примере мы указываем, какие встроенные средства будут отображаться в меню, и устанавливаем средство по умолчанию.

  1. Во-первых ModifySystemDefaults , в функции мы получаем ссылку на объект RadialControllerConfiguration для Surface Dial (config), вызвав GetForCurrentView.
  2. Затем мы вызываем SetDefaultMenuItems , чтобы указать коллекцию встроенных элементов меню по умолчанию (Volume и Scroll).
  3. Select_Volume В функции мы пытаемся задать для пункта меню по умолчанию значение Volume, вызвав TrySelectDefaultMenuItem.
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 (размер пера и росчерка). Эти средства недоступны через API RadialController , такие как 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 Контроллерприложений
1709 16299 IsAppControllerEnabled

Свойства

ActiveControllerWhenMenuIsSuppressed

Возвращает или задает RadialController , активируемый при подавлении меню RadialController .

AppController

Возвращает или задает значение, указывающее, привязан ли объект RadialController к процессу приложения main, а не к конкретному представлению приложения (или окну верхнего уровня).

Если задан AppController, этот радиальный контроллер (и меню) используется для окна верхнего уровня и всех представлений в процессе приложения (переопределяя все определенные отдельные контроллеры представлений).

Примечание

Также необходимо задать для IsAppControllerEnabled значение true.

IsAppControllerEnabled

Возвращает или задает значение, указывающее, включен ли объект RadialController как AppController , и события контроллера могут обрабатываться приложением.

IsMenuSuppressed

Возвращает или задает значение, указывающее, может ли отображаться меню RadialController .

Методы

GetForCurrentView()

Извлекает объект RadialControllerConfiguration, привязанный к активному приложению.

ResetToDefaultMenuItems()

Восстанавливает меню RadialController в конфигурацию по умолчанию.

SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)

Указывает, какие встроенные средства отображаются в меню RadialController .

Важно!

При наличии InkToolbar добавляет два пользовательских средства в меню RadialController (размер пера и росчерка). Эти средства недоступны через API RadialController , такие как Items или SetDefaultMenuItems.

TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

Пытается выбрать и активировать средство из коллекции встроенных средств RadialController , поддерживаемых для текущего контекста приложения.

Применяется к

См. также раздел