CommandBar.IsDynamicOverflowEnabled Свойство

Определение

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

Windows.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

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

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

Начиная с 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;
    }
}