Personalizar
Botones de la cinta
Añade botones personalizados a la cinta de opciones de Excel que abran tu panel de tareas, ejecuten una de tus funciones o lancen un diálogo — colocados en una pestaña integrada o en tu propia pestaña con marca.
6 min de lectura
Desde la página Resources → Ribbon buttons de un entorno, añade controles que aparecen directamente en la cinta de opciones de Excel — sin necesidad de abrir el panel de tareas. Cada botón tiene una etiqueta, una descripción emergente, un icono, una ubicación de pestaña y una de tres acciones.
Tipos de acción
| Field | Type | Description |
|---|---|---|
show_taskpaneOptional | Mostrar panel de tareas | Abre tu panel de tareas — el lanzador integrado. Funciona en cualquier pestaña, integrada o personalizada. |
execute_functionOptional | Ejecutar función | Inserta =NAMESPACE.MODULE.FN() en la celda activa sin argumentos — solo se pueden asignar funciones sin parámetros obligatorios. Debe ir en tu pestaña personalizada. |
open_dialogOptional | Abrir diálogo | Lanza uno de tus diálogos configurados, que recoge datos de entrada e inserta la fórmula compuesta. Debe ir en tu pestaña personalizada. |
Una función que necesita datos de entrada va detrás de un diálogo
Un botón de Ejecutar función inserta directamente una fórmula sin argumentos, así que solo se le pueden asignar funciones con todos los parámetros opcionales. Una función que primero necesita un valor — un id de cliente, un rango de fechas — va detrás de un botón de Abrir diálogo, que recoge el dato antes de insertar la fórmula.
Ubicación
Los botones se colocan en una pestaña integrada de Excel (Home, Insert, Formulas, Data, Review, View) o en la pestaña personalizada de tu complemento. Las pestañas integradas solo pueden alojar botones de Mostrar panel de tareas — los botones de Ejecutar función y Abrir diálogo siempre necesitan la pestaña personalizada, ya que Office reserva las pestañas integradas solo para el lanzador.
Renombra tu pestaña personalizada desde esa misma página de Botones de la cinta; por defecto usa el nombre de marca de tu complemento. Consulta Marca blanca para el resto de los controles de marca del complemento.
Iconos y orden
Sube un PNG, JPEG, WEBP, GIF o SVG — se rasteriza en el servidor en variantes de 16/32/80px — o elige uno ya presente en la biblioteca de iconos de tu organización. Reordena los botones con los tiradores de arrastre de la lista; el orden que establezcas ahí es el orden en que Excel los renderiza dentro de su grupo.
El límite de doce botones
Cada entorno puede definir hasta 12 botones de la cinta. El botón de crear en el panel se desactiva al alcanzar el límite — elimina o reutiliza uno para añadir otro.
La mayoría de los cambios necesitan un redespliegue del manifiesto
Añadir, eliminar, renombrar, reordenar, restilizar o cambiar el icono de un botón modifica el manifiesto de Office — tus usuarios necesitan reinstalarlo antes de que Excel muestre el cambio. La única excepción es retargeting (cambiar el objetivo): apuntar un botón existente de Ejecutar función o Abrir diálogo a una función o diálogo distinto se aplica en vivo, sin redespliegue, porque la identidad del botón en el manifiesto nunca cambia.
Constructor del panel de tareas
Diseña el panel de tareas que tus usuarios abren desde la cinta de opciones — arrastra bloques a las pestañas, dale tu propia marca con colores y logo, y publica los cambios en cada libro abierto sin necesidad de un redespliegue.
Marca blanca
Sustituye cada marca de ConnXL que verían tus usuarios finales — el nombre del complemento, su icono, la pestaña de la cinta y todo el aspecto del panel de tareas — por tu propia marca, extraída de una única biblioteca de recursos compartida.