AppBarToggleButton.DynamicOverflowOrder Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
int
Ordine in cui questo elemento viene spostato nel menu di overflow rispetto ad altri elementi.
Implementazioni
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
|
Commenti
Per altre info e linee guida, vedi l'articolo Barra dell'app e 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;
}
}