AppBarToggleButton.LabelPosition 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 un valore che indica la posizione e la visibilità dell'etichetta del pulsante.
public:
property CommandBarLabelPosition LabelPosition { CommandBarLabelPosition get(); void set(CommandBarLabelPosition value); };
CommandBarLabelPosition LabelPosition();
void LabelPosition(CommandBarLabelPosition value);
public CommandBarLabelPosition LabelPosition { get; set; }
var commandBarLabelPosition = appBarToggleButton.labelPosition;
appBarToggleButton.labelPosition = commandBarLabelPosition;
Public Property LabelPosition As CommandBarLabelPosition
<AppBarToggleButton LabelPosition="commandBarLabelPositionMemberName" />
Valore della proprietà
Valore di enumerazione che specifica la posizione e la visibilità dell'etichetta del pulsante. Il valore predefinito è Default.
Commenti
Per impostazione predefinita, l'etichetta del pulsante della barra dell'app viene visualizzata nella posizione specificata dalla proprietà CommandBar.DefaultLabelPosition . È possibile impostare la proprietà LabelPosition per eseguire l'override di questo valore e rendere l'etichetta sempre compressa per un pulsante della barra dell'app specifico.
Compatibilità tra versioni
La proprietà LabelPosition 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.
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"/>
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "LabelPosition"))
{
appBarButtonShuffle.LabelPosition = CommandBarLabelPosition.Collapsed;
}
}