CommandBar.IsDynamicOverflowEnabled Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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;
}
}