CommandBar.DynamicOverflowItemsChanging Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при перемещении элементов в меню переполнения или из него.
// 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"/>
Тип события
Требования к Windows
| Семейство устройств |
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v3.0)
|
Комментарии
Сведения о событиях см. в разделе DynamicOverflowItemsChangingEventArgs.
Начиная с Windows 10 версии 1607, в CommandBar реализована функция динамического переполнения. По умолчанию PrimaryCommands автоматически перемещаются в область переполнения или из нее при изменении ширины панели команд, например при изменении пользователем размера окна приложения. Чтобы отключить это поведение, можно присвоить свойству IsDynamicOverflowEnabledзначение false .
Динамическое переполнение влияет только на представление команд в пользовательском интерфейсе, не перемещая команды из коллекции PrimaryCommands в SecondaryCommands.
Совместимость версий
Событие IsDynamicOverflowEnabled недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше значения "введенной версии", показанной в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Адаптивный к версии код.
Примечание
Динамическое переполнение доступно, если приложение компилируется для Windows 10 версии 1607 и работает в версии 1607 (или более поздней). Динамическое переполнение недоступно, если приложение скомпилировано для предыдущей версии или выполняется в предыдущей версии.
Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не подключайте это событие без предварительного выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого события перед его использованием.
<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;
}
}