AppBarToggleButton.DynamicOverflowOrder 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 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 = appBarToggleButton.dynamicOverflowOrder;
appBarToggleButton.dynamicOverflowOrder = int32;Public Property DynamicOverflowOrder As Integer<AppBarToggleButton DynamicOverflowOrder="int" .../>
Valor de propiedad
int
El orden en el que este elemento se mueve al menú de desbordamiento en relación con otros elementos.
Implementaciones
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">
<AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
<AppBarToggleButton x:Name="appBarButtonRepeat" Icon="RepeatAll" Label="Repeat"/>
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "DynamicOverflowOrder"))
{
commandBar1.IsDynamicOverflowEnabled = true;
appBarButtonShuffle.DynamicOverflowOrder = 1;
appBarButtonRepeat.DynamicOverflowOrder = 2;
}
}