AppBarButton.DynamicOverflowOrder Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define a ordem na qual este item é movido para o menu de estouro CommandBar .

public:
 property int DynamicOverflowOrder { int get(); void set(int value); };

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarButton.dynamicOverflowOrder;
appBarButton.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarButton DynamicOverflowOrder="int" .../>

Valor da propriedade

Int32

int

A ordem na qual esse item é movido para o menu de estouro em relação a outros itens.

Implementações

DynamicOverflowOrder

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)

Comentários

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

A partir do 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.

Essa propriedade só tem efeito quando esse elemento está na coleção CommandBar.PrimaryCommands e CommandBar.IsDynamicOverflowEnabled é true.

Você pode atribuir o mesmo valor DynamicOverflowOrder a mais de um elemento. Elementos com o mesmo valor são movidos para dentro e para fora da área de estouro ao mesmo tempo.

Compatibilidade de versões

A propriedade DynamicOverflowOrder 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 que a "versão introduzida" mostrada no bloco Requisitos posteriormente 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 defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
    <AppBarButton x:Name="appBarButtonCopy" Icon="Copy" Label="Copy"/>
    <AppBarSeparator x:Name="appBarSeparator1"/>
    <AppBarButton x:Name="appBarButtonPaste" Icon="Paste" Label="Paste"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonCut.DynamicOverflowOrder = 1;
        appBarButtonCopy.DynamicOverflowOrder = 2;
        appBarSeparator1.DynamicOverflowOrder = 2;
        appBarButtonPaste.DynamicOverflowOrder = 3;
    }
}