CommandBar.DynamicOverflowItemsChanging Evento
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í.
Se produce cuando los elementos se mueven o salen del menú de desbordamiento.
// Register
event_token DynamicOverflowItemsChanging(TypedEventHandler<CommandBar, DynamicOverflowItemsChangingEventArgs const&> const& handler) const;
// Revoke with event_token
void DynamicOverflowItemsChanging(event_token const* cookie) const;
// Revoke with event_revoker
CommandBar::DynamicOverflowItemsChanging_revoker DynamicOverflowItemsChanging(auto_revoke_t, TypedEventHandler<CommandBar, DynamicOverflowItemsChangingEventArgs const&> const& handler) const;public event TypedEventHandler<CommandBar,DynamicOverflowItemsChangingEventArgs> DynamicOverflowItemsChanging;function onDynamicOverflowItemsChanging(eventArgs) { /* Your code */ }
commandBar.addEventListener("dynamicoverflowitemschanging", onDynamicOverflowItemsChanging);
commandBar.removeEventListener("dynamicoverflowitemschanging", onDynamicOverflowItemsChanging);
- or -
commandBar.ondynamicoverflowitemschanging = onDynamicOverflowItemsChanging;Public Custom Event DynamicOverflowItemsChanging As TypedEventHandler(Of CommandBar, DynamicOverflowItemsChangingEventArgs) <CommandBar DynamicOverflowItemsChanging="eventhandler"/>
Tipo de evento
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 datos de eventos, consulte DynamicOverflowItemsChangingEventArgs.
A partir de Windows 10, versión 1607, CommandBar presenta una característica de desbordamiento dinámico. De forma predeterminada, PrimaryCommands se mueve automáticamente dentro o fuera 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 enfalse 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
El evento 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 tener 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 conecte este evento 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 este evento antes de usarla.
<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
...
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.CommandBar", "DynamicOverflowItemsChanging"))
{
commandBar1.DynamicOverflowItemsChanging += CommandBar1_DynamicOverflowItemsChanging;
}
}