CommandBar.IsDynamicOverflowEnabled Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor que indica si los comandos principales se mueven automáticamente al menú de desbordamiento cuando el espacio está 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 de propiedad

Boolean

bool

true si los comandos principales se mueven automáticamente al menú de desbordamiento cuando el espacio está limitado; de lo contrario, false. El valor predeterminado es true.

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.

Compatibilidad de versiones

La propiedad IsDynamicOverflowEnabled 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 use esta propiedad sin realizar primero 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 usarla.

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