Поделиться через


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

Применяется к

См. также раздел