DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Ruban
  • Présentation
  • Manipuler le champ Ruban et ses regroupements
  • Manipuler un champ Ruban
  • Enrouler un champ Ruban
  • Manipuler un regroupement
  • Forcer la fermeture d'un regroupement
  • Propriétés spécifiques aux champs Ruban
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Manipuler un champ Ruban par programmation
Présentation
WINDEV permet de manipuler un champ Ruban, ainsi que ses volets et regroupements par programmation.
Le nom du champ Ruban permet de manipuler le champ Ruban et ses volets par programmation.
Le nom du regroupement permet de manipuler le regroupement par programmation.
Remarque : Le passage d'un volet à l'autre (lorsque l'utilisateur clique sur le libellé du volet) est automatiquement géré.
Manipuler le champ Ruban et ses regroupements

Manipuler un champ Ruban

Pour manipuler un volet du champ Ruban, utilisez la syntaxe suivante :
<Nom Ruban>[NuméroVolet].NomProprieté = <Valeur>
Par exemple, pour griser le second volet du champ Ruban :
RUBAN_Menu[2].Grisé = Vrai
Par défaut, le premier volet du ruban est actif. Il est possible de changer le volet actif par programmation :
  • en utilisant la syntaxe suivante :
    <Nom Ruban> = <Numéro Volet>
  • grâce à la propriété Valeur.
Pour connaître le numéro du volet actif, il est possible de :
  • réaliser une simple affectation :
    <Num Volet actif> = <Nom Ruban>
  • utiliser la propriété Valeur.
La propriété Libellé permet de connaître et de modifier le libellé du volet actif. Par exemple :
Trace(RUBAN_Menu[MonVoletActif].Libellé)

Enrouler un champ Ruban

La propriété Enroulé permet d'enrouler ou non un champ Ruban. Si le champ Ruban est enroulé, seuls les libellés des volets sont affichés (comme pour un menu classique). Le contenu du volet est affiché lorsque l'utilisateur clique sur le libellé du volet. Si l'utilisateur clique à nouveau sur le libellé du volet (ou sur un bouton présent dans le volet), le contenu du volet n'est plus affiché.
Pour forcer la disparition du volet lors d'une action de l'utilisateur (par exemple lors d'une sélection dans un champ Combo), il suffit d'utiliser la fonction RubanFinModeDéplié.

Manipuler un regroupement

Pour manipuler un regroupement, utilisez la syntaxe suivante :
<Nom Ruban>.<Nom du Regroupement>
Par exemple :
RUBAN_Menu.GRPRUB_AccesRapide.Visible = Faux

Forcer la fermeture d'un regroupement

Dans un champ Ruban, les regroupements trop petits n'affichent qu'une icône et une flèche pour ouvrir une popup qui contient tous les champs.
Par défaut, cette popup est refermée :
  • si l'utilisateur clique sur un bouton,
  • si l'utilisateur effectue une sélection dans un champ Combo.
Pour fermer le regroupement sur une autre action (par exemple après la saisie de 3 caractères, ...), utilisez la fonction RubanFermeRegroupement dans le traitement voulu.
Propriétés spécifiques aux champs Ruban
Les principales propriétés utilisables avec un champ Ruban sont les suivantes :
DétachéPermet de savoir si un volet d'un champ Ruban est détaché.
EnrouléPermet d'enrouler ou non un champ Ruban. Si le champ Ruban est enroulé, seuls les libellés des volets apparaissent. En cliquant sur le libellé du volet, celui-ci est alors affiché, avec tous ses regroupements.
OccurrencePermet de connaître le nombre de volets d'un champ Ruban.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Ruban, consultez Propriétés associées au champ Ruban.
Version minimum requise
  • Version 17
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale