Compartir a través de


AppBarToggleButton.LabelPosition Propiedad

Definición

Obtiene o establece un valor que indica la ubicación y la visibilidad de la etiqueta del botón.

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

Valor de propiedad

Valor de enumeración que especifica la ubicación y la visibilidad de la etiqueta del botón. El valor predeterminado es Default.

Requisitos de Windows

Familia de dispositivos
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

De forma predeterminada, la etiqueta del botón de la barra de la aplicación se muestra en la posición especificada por la propiedad CommandBar.DefaultLabelPosition . Puede establecer la propiedad LabelPosition para invalidar este valor y hacer que la etiqueta siempre esté contraída para un botón de barra de aplicación específico.

Compatibilidad de versiones

La propiedad LabelPosition no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

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

Se aplica a