CommandBar.DefaultLabelPosition Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica la ubicación y visibilidad de las etiquetas en los botones de la barra de comandos.
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" />
Valor de propiedad
Valor de enumeración que indica la ubicación y visibilidad de las etiquetas en los botones de la barra de comandos. El valor predeterminado es Bottom.
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 debajo del icono. Puede establecer esta propiedad para mostrar etiquetas a la derecha del icono o para ocultar etiquetas.
Puede establecer la propiedad AppBarButton.LabelPosition para invalidar este valor y hacer que la etiqueta siempre se contraiga para un botón de barra de aplicación específico.
Compatibilidad de versiones
La propiedad DefaultLabelPosition 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 tener 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">
...
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "DefaultLabelPosition"))
{
commandBar1.DefaultLabelPosition = CommandBarDefaultLabelPosition.Right;
}
}