AppBarToggleButton.DynamicOverflowOrder Свойство

Определение

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

Microsoft.UI.Xaml.Controls

Возвращает или задает порядок перемещения этого элемента в меню переполнения CommandBar .

public:
 property int DynamicOverflowOrder { int get(); void set(int value); };

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarToggleButton.dynamicOverflowOrder;
appBarToggleButton.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarToggleButton DynamicOverflowOrder="int" .../>

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

Int32

int

Порядок перемещения этого элемента в меню переполнения относительно других элементов.

Реализации

DynamicOverflowOrder

Комментарии

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

Начиная с Windows 10 версии 1607, в CommandBar реализована функция динамического переполнения. По умолчанию PrimaryCommands автоматически перемещаются в область переполнения или из нее при изменении ширины панели команд, например при изменении размера окна приложения пользователями. Чтобы отключить это поведение, можно задать для свойства IsDynamicOverflowEnabledзначение false .

Динамическое переполнение влияет только на представление команд в пользовательском интерфейсе, не перемещая команды из коллекции PrimaryCommands в SecondaryCommands.

Это свойство действует только в том случае, если этот элемент находится в коллекции CommandBar.PrimaryCommands и параметру CommandBar.IsDynamicOverflowEnabled присвоенозначение true.

Одно и то же значение DynamicOverflowOrder можно назначить нескольким элементам. Элементы с одинаковым значением перемещаются в область переполнения и из нее одновременно.

Совместимость версий

Свойство DynamicOverflowOrder недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше , чем "представленная версия", показанная в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Код с адаптивной версией.

Примечание

Динамическое переполнение доступно, если приложение компилируется для Windows 10 версии 1607 и работает в версии 1607 (или более поздней). Динамическое переполнение недоступно, если приложение компилируется для предыдущей версии или выполняется в предыдущей версии.

Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не устанавливайте это свойство в XAML и не используйте его без выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого свойства перед его настройкой.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
    <AppBarToggleButton x:Name="appBarButtonRepeat" Icon="RepeatAll" Label="Repeat"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonShuffle.DynamicOverflowOrder = 1;
        appBarButtonRepeat.DynamicOverflowOrder = 2;
    }
}