AppBarSeparator.DynamicOverflowOrder Proprietà

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

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarSeparator.dynamicOverflowOrder;
appBarSeparator.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

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

Valore della proprietà

Ordine in cui questo elemento viene spostato nel menu di overflow rispetto ad altri elementi.

Implementazioni

Requisiti Windows

Commenti

Per altre informazioni e linee guida, vedere l'articolo Barra dell'app e barra dei comandi .

A partire da Windows 10, versione 1607, CommandBar introduce una funzionalità di overflow dinamica. Per impostazione predefinita, PrimaryCommands si sposta automaticamente nell'area di overflow perché la larghezza della barra dei comandi cambia, ad esempio quando gli utenti ridimensionano la finestra dell'app. È possibile impostare la proprietà IsDynamicOverflowEnabled su false per disabilitare questo comportamento.

Il overflow dinamico influisce solo sulla presentazione dell'interfaccia utente dei comandi, non sposta i comandi dall'insieme PrimaryCommands a SecondaryCommands.

Questa proprietà ha un effetto solo quando questo elemento si trova nell'insieme CommandBar.PrimaryCommands e CommandBar.IsDynamicOverflowEnabled è true.

È possibile assegnare lo stesso valore DynamicOverflowOrder a più di un elemento. Gli elementi con lo stesso valore si spostano e si escono dall'area di overflow contemporaneamente.

Compatibilità tra versioni

La proprietà DynamicOverflowOrder non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è minore della versione "introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per l'account. Per altre informazioni, vedere Codice adattivo della versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. In questo esempio viene illustrato come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
    <AppBarButton x:Name="appBarButtonCopy" Icon="Copy" Label="Copy"/>
    <AppBarSeparator x:Name="appBarSeparator1"/>
    <AppBarButton x:Name="appBarButtonPaste" Icon="Paste" Label="Paste"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarSeparator", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonCut.DynamicOverflowOrder = 1;
        appBarButtonCopy.DynamicOverflowOrder = 2;
        appBarSeparator1.DynamicOverflowOrder = 2;
        appBarButtonPaste.DynamicOverflowOrder = 3;
    }
}

Si applica a