CommandBar.DefaultLabelPosition Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft einen Wert ab, der die Platzierung und Sichtbarkeit der Bezeichnungen auf den Schaltflächen der Befehlsleiste angibt, oder legt diesen fest.

public:
 property CommandBarDefaultLabelPosition DefaultLabelPosition { CommandBarDefaultLabelPosition get(); void set(CommandBarDefaultLabelPosition value); };

CommandBarDefaultLabelPosition DefaultLabelPosition();

void DefaultLabelPosition(CommandBarDefaultLabelPosition value);

public CommandBarDefaultLabelPosition DefaultLabelPosition { get; set; }

var commandBarDefaultLabelPosition = commandBar.defaultLabelPosition;
commandBar.defaultLabelPosition = commandBarDefaultLabelPosition;

Public Property DefaultLabelPosition As CommandBarDefaultLabelPosition

<CommandBar DefaultLabelPosition="commandBarDefaultLabelPositionMemberName" />

Eigenschaftswert

CommandBarDefaultLabelPosition

Ein Enumerationswert, der die Platzierung und Sichtbarkeit der Bezeichnungen auf den Schaltflächen der Befehlsleiste angibt. Der Standardwert ist Bottom.

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Standardmäßig wird die Bezeichnung einer App-Leistenschaltfläche unter dem Symbol angezeigt. Sie können diese Eigenschaft festlegen, um Bezeichnungen rechts neben dem Symbol anzuzeigen oder Bezeichnungen auszublenden.

Sie können die AppBarButton.LabelPosition-Eigenschaft so festlegen, dass dieser Wert überschrieben wird, und die Bezeichnung für eine bestimmte App-Balkenschaltfläche immer reduziert.

Versionskompatibilität

Die DefaultLabelPosition-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie festlegen.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    ...
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "DefaultLabelPosition"))
    {
        commandBar1.DefaultLabelPosition = CommandBarDefaultLabelPosition.Right;
    }
}