AppBarToggleButton.DynamicOverflowOrder Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta l'ordine in cui l'elemento viene spostato nel menu di overflow 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" .../>

Valore della proprietà

Int32

int

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

Implementazioni

DynamicOverflowOrder

Commenti

Per altre informazioni e linee guida, vedi l'articolo Sulla barra dei comandi .

A partire da Windows 10 versione 1607, CommandBar introduce una funzionalità di overflow dinamico. Per impostazione predefinita, PrimaryCommands si sposta automaticamente all'interno o all'esterno dell'area di overflow man mano che cambia la larghezza della barra dei comandi, ad esempio quando gli utenti ridimensionano la finestra dell'app. È possibile impostare la proprietà IsDynamicOverflowEnabledsu false per disabilitare questo comportamento.

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

Questa proprietà ha 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 vengono spostati all'interno e all'esterno dell'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 è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Nota

L'overflow dinamico è disponibile quando l'app viene compilata per Windows 10, versione 1607 e in esecuzione nella versione 1607 (o successiva). L'overflow dinamico non è disponibile quando l'app viene compilata per una versione precedente o è in esecuzione in una versione precedente.

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. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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