AppBarButton.DynamicOverflowOrder Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece el orden en el que este elemento se mueve al menú de desbordamiento 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 de propiedad

Int32

int

El orden en el que este elemento se mueve al menú de desbordamiento en relación con otros elementos.

Implementaciones

DynamicOverflowOrder

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Para obtener más información e instrucciones, consulta el artículo Barra de aplicaciones y barra de comandos .

A partir de Windows 10, versión 1607, CommandBar presenta una característica de desbordamiento dinámico. De forma predeterminada, PrimaryCommands se mueve o sale automáticamente del área de desbordamiento a medida que cambia el ancho de la barra de comandos, por ejemplo, cuando los usuarios cambian el tamaño de la ventana de la aplicación. Puede establecer la propiedad IsDynamicOverflowEnabled en false para deshabilitar este comportamiento.

El desbordamiento dinámico afecta solo a la presentación de la interfaz de usuario de los comandos, no mueve los comandos de la colección PrimaryCommands a SecondaryCommands.

Esta propiedad solo tiene un efecto cuando este elemento está en la colección CommandBar.PrimaryCommands y CommandBar.IsDynamicOverflowEnabled es true.

Puede asignar el mismo valor DynamicOverflowOrder a más de un elemento. Los elementos con el mismo valor se mueven y salen del área de desbordamiento al mismo tiempo.

Compatibilidad de versiones

La propiedad DynamicOverflowOrder no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Nota

El desbordamiento dinámico está disponible cuando la aplicación se compila para Windows 10, versión 1607 y se ejecuta en la versión 1607 (o posterior). El desbordamiento dinámico no está disponible cuando la aplicación se compila para una versión anterior o se ejecuta en una versión anterior.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

<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;
    }
}