CommandBar.IsDynamicOverflowEnabled Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define um valor que indica se os comandos primários se movem automaticamente para o menu de estouro quando o espaço é limitado.

public:
 property bool IsDynamicOverflowEnabled { bool get(); void set(bool value); };

bool IsDynamicOverflowEnabled();

void IsDynamicOverflowEnabled(bool value);

public bool IsDynamicOverflowEnabled { get; set; }

var boolean = commandBar.isDynamicOverflowEnabled;
commandBar.isDynamicOverflowEnabled = boolean;

Public Property IsDynamicOverflowEnabled As Boolean

<CommandBar IsDynamicOverflowEnabled="bool"/>

Valor da propriedade

Boolean

bool

true se os comandos primários se moverem automaticamente para o menu de estouro quando o espaço for limitado; caso contrário, false. O padrão é true.

Comentários

Para obter mais informações e diretrizes, consulte o artigo Barra de comandos.

A partir de Windows 10, versão 1607, CommandBar apresenta um recurso de estouro dinâmico. Por padrão, PrimaryCommands se movem automaticamente para dentro ou para fora da área de estouro à medida que a largura da barra de comandos muda, por exemplo, quando os usuários redimensionam a janela do aplicativo. Você pode definir a propriedade IsDynamicOverflowEnabled como false para desabilitar esse comportamento.

O estouro dinâmico afeta apenas a apresentação da interface do usuário dos comandos, ele não move comandos da coleção PrimaryCommands para SecondaryCommands.

Compatibilidade de versões

A propriedade IsDynamicOverflowEnabled não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Observação

O estouro dinâmico está disponível quando seu aplicativo é compilado para Windows 10, versão 1607 e em execução na versão 1607 (ou posterior). O estouro dinâmico não está disponível quando seu aplicativo é compilado para uma versão anterior ou está em execução em uma versão anterior.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não use essa propriedade sem executar primeiro um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de usá-la.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    ...
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "IsDynamicOverflowEnabled"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
    }
}