RadialControllerConfiguration Classe

  • Referência

Definição

Namespace:
Windows.UI.Input
Editar

Fornece detalhes de configuração para o menu 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
Herança
Object Platform::Object IInspectable RadialControllerConfiguration
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Exemplos

Neste exemplo, especificamos quais ferramentas internas são exibidas no menu e definimos a ferramenta padrão.

  1. Primeiro, na ModifySystemDefaults função , obtemos uma referência ao objeto RadialControllerConfiguration para o Surface Dial (config) chamando GetForCurrentView.
  2. Em seguida, chamamos SetDefaultMenuItems para especificar a coleção padrão de itens de menu internos (Volume e Rolagem).
  3. Select_Volume Na função , tentamos definir o item de menu padrão como Volume chamando 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); 
  }
}

Neste exemplo, limpamos todas as ferramentas internas chamando SetDefaultMenuItems e passando uma coleção vazia.

Importante

Quando presente, o InkToolbar adiciona duas ferramentas personalizadas ao menu RadialController (tamanho da caneta e do traço). Essas ferramentas não são acessíveis por meio de APIs RadialController , como Itens ou SetDefaultMenuItems.

private void ClearSystemDefaults(object sender, RoutedEventArgs e) 
{
  config = RadialControllerConfiguration.GetForCurrentView();
  config.SetDefaultMenuItems(
    new[] { });
}

Comentários

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1703 15063 ActiveControllerWhenMenuIsSuppressed
1703 15063 IsMenuSuppressed
1.709 16299 Controlador deAplicativo
1.709 16299 IsAppControllerEnabled

Propriedades

ActiveControllerWhenMenuIsSuppressed

Obtém ou define o RadialController a ser ativado quando o menu RadialController é suprimido.
AppController

Obtém ou define se o objeto RadialController está associado ao processo de aplicativo main em vez de uma exibição de aplicativo específica (ou janela de nível superior).

Se AppController estiver definido, esse controlador radial (e menu) será usado para a janela de nível superior e todas as exibições no processo do aplicativo (substituindo todos os controladores de exibição individuais que você definiu).

Observação

Você também deve definir IsAppControllerEnabled como true.
IsAppControllerEnabled

Obtém ou define se o objeto RadialController está habilitado como um AppController e os eventos do controlador podem ser manipulados pelo seu aplicativo.
IsMenuSuppressed

Obtém ou define se o menu RadialController pode ser exibido.

Métodos

GetForCurrentView()

Recupera um objeto RadialControllerConfiguration associado ao aplicativo ativo.
ResetToDefaultMenuItems()

Restaura o menu RadialController para a configuração padrão.
SetDefaultMenuItems(IIterable<RadialControllerSystemMenuItemKind>)

Especifica quais ferramentas internas são mostradas no menu RadialController .

Importante

Quando presente, o InkToolbar adiciona duas ferramentas personalizadas ao menu RadialController (tamanho da caneta e do traço). Essas ferramentas não são acessíveis por meio de APIs RadialController , como Itens ou SetDefaultMenuItems.
TrySelectDefaultMenuItem(RadialControllerSystemMenuItemKind)

Tenta selecionar e ativar uma ferramenta da coleção de ferramentas RadialController internas com suporte para o contexto atual do aplicativo.

Aplica-se a

Confira também