CommandBar.IsDynamicOverflowEnabled Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore che indica se i comandi primari vengono spostati automaticamente nel menu di overflow quando lo spazio è limitato.

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"/>

Valore della proprietà

Boolean

bool

true se i comandi primari si spostano automaticamente nel menu di overflow quando lo spazio è limitato; in caso contrario, false. Il valore predefinito è True.

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à IsDynamicOverflowEnabled su 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.

Compatibilità tra versioni

La proprietà IsDynamicOverflowEnabled 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 usare questa proprietà senza prima eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di usarla.

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