[Xojo 2026r2] Mejoras en DesktopToolbar

A continuación encontrarás traducido al castellano el artículo escrito por William Yu y publicado originalmente en el Blog oficial de Xojo.

Las actualizaciones para DesktopToolbar incorporan nuevas opciones que facilitan la personalización de las barras de herramientas tn todas las plataformas Desktop, junto con el soporte de WinUI en Windows.

Estos cambios se centran en dos áreas principales:

• Soporte de símbolos ampliado para DesktopToolbarButton.
• Nuevas opciones de presentación en el diseño mediante las opciones de estilos para la barra de herramientas.

Gestión de Icono más inteligente mediante símbolos

Una novedad clave es la nueva propiedad Symbol en DesktopToolbarButton. Te permite proporcionar una cadena que contenga el nombre de múltiples símbolos separados mediante punto y coma. Cada plataforma comprobará dicha lista y utilizará el primer símbolo que reconozca.

👉 La característica Symbol sólo está soportada en Windows cuando se opta por WinUI.

👉 AllowMulticolorSymbol se ha añadido para macOS. Cuando se activa el sistema operativo puede renderizar los símbolos de la barra de herramientas utilizando variantes de varios colores si están disponibles, en vez de utilizar el estilo monocromático.

Ejemplo:

home.Symbol = "house.fill;home;go-home"
home.AllowMulticolorSymbol = True
back.Symbol = "chevron.left;back;go-previous"
forward.Symbol = "chevron.right;forward;go-forward"
search.Symbol = "magnifyingglass;find;system-search"

Así funciona

En vez de emplear un icono estático, ahora la barra de herramientas intenta aplicar un símbolo en primer lugar. Si se encuentra un símbolo entonces se utilizará de forma preferente frente al icono asignado.

El orden de búsqueda es:

• Primer símbolo encontrado en la lista.
• Si no se encuentra ninguno, entonces aplicará el icono asignado (si es el caso).

Esto te permite proporcionar múltiples nombres simbólicos como una cadena de respaldo, mejorando así la fiabilidad entre plataformas de despliegue y entre temas.

Dónde encontrar el listado de símbolos soportados

• WinUI: https://learn.microsoft.com/en-us/uwp/api/windows.ui.xaml.controls.symbol
• Linux: https://specifications.freedesktop.org/icon-naming
• macOS: https://developer.apple.com/design/human-interface-guidelines/sf-symbols

Mejor control sobre el diseño de la barra de herramientas

La barra de herramientas propiamente dicha también cuenta con la nueva propiedad Style. Esta controla cómo se ordenarán visualmente los botones.

Las opciones de DesktopToolbarStyles son:

• Default. Generalmente el icono/símbolo en la parte superior, la etiqueta debajo. En Linux y WinUI: icono/símbolo a la izquierda, la etiqueta en la derecha.
• IconCaptionVertical. Fuerza un diseño vertical (icono/símbolo sobre el texto).
• IconCaptionHorizontal. Fuerza un diseño horizontal (icono/símbolo junto al texto).

Sólo soportado en Linux y Windows

• IconOnly. Muestra sólo el icono/símbolo.
• CaptionOnly. Muestra sólo las etiquetas de texto.

En Conclusión

Con soporte para símbolos, estilos de diseño adicionales y soporte de WinUI en el caso de Windows, hemos simplificado la creación de barras de herramientas que tengan un aspecto más moderno y se sientan más nativas en cada sistema operativo; además de que se adapten mejor a diferentes entornos de usuario. Tanto si prefieres barras de herramientas basadas únicamente en iconos, como sólo texto o bien usando símbolos Multiplataforma, las nuevas opciones te permiten refinar la experiencia para tus usuarios sin tener que añadir complejidad adicional a tus proyectos.