CommandBar.IsDynamicOverflowEnabled Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Возвращает или задает значение, указывающее, будут ли основные команды автоматически перемещаться в меню переполнения при ограниченном пространстве.

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"/>

Значение свойства

Boolean

bool

Значение true , если основные команды автоматически перемещаются в меню переполнения при ограниченном пространстве; в противном случае — false. Значение по умолчанию — true.

Комментарии

Дополнительные сведения и рекомендации см. в статье Панель команд .

Начиная с 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.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "IsDynamicOverflowEnabled"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
    }
}