PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Présentation
  • Manipuler le champ Tableur par programmation
  • Initialiser un champ Tableur
  • Manipuler le champ Tableur
  • Manipuler les cellules d'un champ Tableur par programmation
  • Manipuler les cellules du champ Tableur
  • Astuce : Fusionner des cellules par programmation
  • Gérer les noms des cellules dans un champ Tableur
  • Gérer les commentaires dans un champ Tableur
  • Champ Tableur : Manipuler par programmation un fichier comportant plusieurs feuilles de calcul
  • Propriétés spécifiques aux champs Tableur
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation
Un champ Tableur présent dans une fenêtre peut être manipulé par programmation.
Pour manipuler un champ Tableur par programmation, WINDEV propose les fonctions Tableur.
Cette page d'aide détaille comment manipuler un champ Tableur dans une fenêtre par programmation.
Remarque : Dans un état, la manipulation du champ Tableur est différente. Pour plus de détails, consultez Manipuler un champ Tableur par programmation (dans un état).
Manipuler le champ Tableur par programmation

Initialiser un champ Tableur

Le champ Tableur peut être initialisé avec des valeurs, des formules, ... dès son affichage selon différentes méthodes :

Manipuler le champ Tableur

Pour manipuler un champ Tableur par programmation, il suffit de spécifier son nom.
Par exemple :
// Affiche la barre de formule
TBLR_Tableur..BarreDeFormuleVisible = Vrai

Plusieurs fonctions WLangage et propriétés permettent de manipuler le champ Tableur.
Manipuler les cellules d'un champ Tableur par programmation

Manipuler les cellules du champ Tableur

Pour manipuler une cellule d'un champ Tableur par programmation, utilisez les notations suivantes :
<Nom Champ Tableur>[<Ligne>, <Colonne>]
ou
<Nom Champ Tableur>["<NomCellule>"]
Exemples :
// Colore en rouge la cellule C1
TBLR_Tableur[1,3]..CouleurFond = RougeClair

// Colore en vert la cellule B1
TBLR_Tableur["B1"]..CouleurFond = VertClair
Pour affecter une valeur à une cellule par programmation, il est possible d'utiliser :
  • soit la fonction <Tableur>.AjouteDonnée.
    Exemple : Ajout d'une valeur dans la cellule "A2" :
    TBLR_Tableur.AjouteDonnée(2, 1, 12)
  • soit l'affectation directe à la cellule :
    • soit en passant par la cellule.
      Exemple : Ajout d'une valeur dans la cellule "A2" :
      TBLR_Tableur["A2"] = 12
    • soit via la colonne et la ligne de la cellule.
      Exemple : Ajout d'une valeur dans la cellule "A2" :
      TBLR_Tableur["A"][2] = 12
Remarques :
  • L'affectation d'une valeur au format 'AAAAMMJJ' à une cellule au format Date transforme automatiquement la valeur en date.
  • L'affectation d'une valeur au format 'HHMM' à une cellule au format Heure transforme automatiquement la valeur en heure.
Exemple : Parcours des cellules d'un champ Tableur :
// Parcours des cellules d'un champ Tableur
sMaChaîne est une chaîne
POUR i = 1 A TBLR_MonTableur..NombreLigne
POUR y = 1 A TBLR_MonTableur..NombreColonne
sMaChaîne += TBLR_MonTableur[i][y] + TAB
FIN
Trace(sMaChaîne + RC)
sMaChaîne = ""
FIN

Astuce : Fusionner des cellules par programmation

L'utilisateur final a la possibilité de fusionner les cellules sélectionnées grâce au ruban (ou à la barre d'outils) du champ Tableur.
Pour fusionner les cellules sélectionnées par programmation, il suffit d'utiliser la fonction ExécuteFAA avec la constante faaTableurFusion :
TBLR_MonTableur.SelectPlus("A1", "C5")
ExécuteFAA(TBLR_MonTableur, faaTableurFusion)
Remarque : La fonction <Tableur>.RécupèreFusion permet de savoir si une cellule est fusionnée avec d'autres cellules et de récupérer la plage de cellules fusionnées.

Gérer les noms des cellules dans un champ Tableur

Le champ Tableur propose différentes fonctions permettant de manipuler les noms des cellules :
Versions 22 et supérieures
<Tableur>.AjouteNom
Nouveauté 22
<Tableur>.AjouteNom
<Tableur>.AjouteNom
Spécifie un nom pour identifier une cellule d'un champ Tableur.
Versions 23 et supérieures
TableurListeNom
Nouveauté 23
TableurListeNom
TableurListeNom
Renvoie la liste des noms qui identifient une cellule d'un champ Tableur.
Versions 23 et supérieures
TableurModifieNom
Nouveauté 23
TableurModifieNom
TableurModifieNom
Modifie le nom utilisé pour identifier une cellule d'un champ Tableur.
Versions 23 et supérieures
TableurSupprimeNom
Nouveauté 23
TableurSupprimeNom
TableurSupprimeNom
Supprime un des noms permettant d'identifier une cellule d'un champ Tableur.
Versions 25 et supérieures

Gérer les commentaires dans un champ Tableur

Le champ Tableur permet aussi bien :
  • d'ajouter des commentaires,
  • d'afficher les commentaires existants dans fichier XLSX.
Les commentaires sont manipulés :
  • via la propriété avancée ..Commentaire. Cette propriété permet de connaître et de modifier les commentaires associés à une cellule via les propriétés suivantes :
    PositionNom de la cellule associé.
    Cette propriété est disponible uniquement en lecture.
    RectangleVariable de type Rectangle permettant de définir le rectangle dans lequel le commentaire est affiché. Les propriétés ..Largeur et ..Hauteur déterminent la taille du rectangle (en millimètres), et les propriétés ..X et ..Y permettent de déterminer la position du commentaire (en millimètres) par rapport au début de la feuille en cours.
    TexteTexte du commentaire.
    Visible
    • Vrai pour afficher le commentaire,
    • Faux pour rendre le commentaire invisible. Dans ce cas, seul un triangle rouge dans le coin haut droit de la cellule permettra à l'utilisateur de savoir que la cellule est associée à un commentaire.

    Exemple :
    // Création d'un commentaire
    TBLR_MonTableur["B1"]..Commentaire..Texte = "Texte de mon commentaire"
    TBLR_MonTableur["B1"]..Commentaire..Visible = Vrai
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Hauteur = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Largeur = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..X = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Y = 50
  • via différentes fonctions WLangage :
    Versions 25 et supérieures
    TableurListeCommentaire
    TableurListeCommentaire
    Liste tous les commentaires de la feuille courante d'un champ Tableur.
    Versions 25 et supérieures
    TableurSelectCommentaire
    TableurSelectCommentaire
    Permet de :
    • savoir si un commentaire est sélectionné dans un champ Tableur,
    • sélectionner ou désélectionner un commentaire dans un champ Tableur.
Nouveauté 25

Gérer les commentaires dans un champ Tableur

Le champ Tableur permet aussi bien :
  • d'ajouter des commentaires,
  • d'afficher les commentaires existants dans fichier XLSX.
Les commentaires sont manipulés :
  • via la propriété avancée ..Commentaire. Cette propriété permet de connaître et de modifier les commentaires associés à une cellule via les propriétés suivantes :
    PositionNom de la cellule associé.
    Cette propriété est disponible uniquement en lecture.
    RectangleVariable de type Rectangle permettant de définir le rectangle dans lequel le commentaire est affiché. Les propriétés ..Largeur et ..Hauteur déterminent la taille du rectangle (en millimètres), et les propriétés ..X et ..Y permettent de déterminer la position du commentaire (en millimètres) par rapport au début de la feuille en cours.
    TexteTexte du commentaire.
    Visible
    • Vrai pour afficher le commentaire,
    • Faux pour rendre le commentaire invisible. Dans ce cas, seul un triangle rouge dans le coin haut droit de la cellule permettra à l'utilisateur de savoir que la cellule est associée à un commentaire.

    Exemple :
    // Création d'un commentaire
    TBLR_MonTableur["B1"]..Commentaire..Texte = "Texte de mon commentaire"
    TBLR_MonTableur["B1"]..Commentaire..Visible = Vrai
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Hauteur = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Largeur = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..X = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Y = 50
  • via différentes fonctions WLangage :
    Versions 25 et supérieures
    TableurListeCommentaire
    TableurListeCommentaire
    Liste tous les commentaires de la feuille courante d'un champ Tableur.
    Versions 25 et supérieures
    TableurSelectCommentaire
    TableurSelectCommentaire
    Permet de :
    • savoir si un commentaire est sélectionné dans un champ Tableur,
    • sélectionner ou désélectionner un commentaire dans un champ Tableur.

Gérer les commentaires dans un champ Tableur

Le champ Tableur permet aussi bien :
  • d'ajouter des commentaires,
  • d'afficher les commentaires existants dans fichier XLSX.
Les commentaires sont manipulés :
  • via la propriété avancée ..Commentaire. Cette propriété permet de connaître et de modifier les commentaires associés à une cellule via les propriétés suivantes :
    PositionNom de la cellule associé.
    Cette propriété est disponible uniquement en lecture.
    RectangleVariable de type Rectangle permettant de définir le rectangle dans lequel le commentaire est affiché. Les propriétés ..Largeur et ..Hauteur déterminent la taille du rectangle (en millimètres), et les propriétés ..X et ..Y permettent de déterminer la position du commentaire (en millimètres) par rapport au début de la feuille en cours.
    TexteTexte du commentaire.
    Visible
    • Vrai pour afficher le commentaire,
    • Faux pour rendre le commentaire invisible. Dans ce cas, seul un triangle rouge dans le coin haut droit de la cellule permettra à l'utilisateur de savoir que la cellule est associée à un commentaire.

    Exemple :
    // Création d'un commentaire
    TBLR_MonTableur["B1"]..Commentaire..Texte = "Texte de mon commentaire"
    TBLR_MonTableur["B1"]..Commentaire..Visible = Vrai
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Hauteur = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Largeur = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..X = 50
    TBLR_MonTableur["B1"]..Commentaire..Rectangle..Y = 50
  • via différentes fonctions WLangage :
    Versions 25 et supérieures
    TableurListeCommentaire
    TableurListeCommentaire
    Liste tous les commentaires de la feuille courante d'un champ Tableur.
    Versions 25 et supérieures
    TableurSelectCommentaire
    TableurSelectCommentaire
    Permet de :
    • savoir si un commentaire est sélectionné dans un champ Tableur,
    • sélectionner ou désélectionner un commentaire dans un champ Tableur.
Champ Tableur : Manipuler par programmation un fichier comportant plusieurs feuilles de calcul
Pour activer la gestion de plusieurs feuilles de calcul :
  • Sous l'éditeur : Dans l'onglet "Détail" de la fenêtre de description du champ, cochez l'option "Autoriser la gestion de plusieurs feuilles de calcul".
  • Par programmation, utilisez la propriété ..MultiFeuille.
Après activation de la gestion de plusieurs feuilles de calcul :
Propriétés spécifiques aux champs Tableur
Les propriétés suivantes sont spécifiques à la gestion d'un champ Tableur par programmation.
Versions 20 et supérieures
BarreDeFormuleVisible
BarreDeFormuleVisible
La propriété ..BarreDeFormuleVisible permet de :
  • Savoir si une barre de formule est affichée dans un champ Tableur.
  • Afficher ou non une barre de formule dans un champ Tableur.
Versions 20 et supérieures
BarreOutilsVisible
Nouveauté 20
BarreOutilsVisible
BarreOutilsVisible
La propriété ..BarreOutilsVisible permet de :
  • Savoir si le ruban du champ est affiché.
  • Afficher ou non un ruban pour le champ.
Versions 23 et supérieures
CheminFichier
Nouveauté 23
CheminFichier
CheminFichier
La propriété ..CheminFichier permet de connaître :
Versions 20 et supérieures
EntêteVisible
Nouveauté 20
EntêteVisible
EntêteVisible
La propriété ..EntêteVisible permet de :
  • Savoir si les entêtes de lignes et colonnes sont affichés dans un champ Tableur.
  • Afficher ou non les entêtes de lignes et colonnes dans un champ Tableur.
Versions 20 et supérieures
FeuilleEnCours
Nouveauté 20
FeuilleEnCours
FeuilleEnCours
La propriété ..FeuilleEnCours permet de connaître et de modifier la feuille courante d'un champ Tableur.
Versions 20 et supérieures
MultiFeuille
Nouveauté 20
MultiFeuille
MultiFeuille
La propriété ..MultiFeuille permet de :
  • Savoir si un champ Tableur gère plusieurs feuilles de calcul.
  • Modifier le mode de gestion des feuilles de calcul d'un champ Tableur.
Versions 20 et supérieures
NbFeuille
Nouveauté 20
NbFeuille
NbFeuille
La propriété ..NbFeuille permet de connaître le nombre de feuilles de calcul dans un champ Tableur.
Versions 20 et supérieures
NomFeuille
Nouveauté 20
NomFeuille
NomFeuille
La propriété ..NomFeuille permet de connaître ou modifier le nom de la feuille de calcul en cours dans un champ Tableur.
Versions 23 et supérieures
QuadrillageVisible
Nouveauté 23
QuadrillageVisible
QuadrillageVisible
La propriété ..QuadrillageVisible permet de :
  • Savoir si le quadrillage est visible ou non dans un champ Tableur.
  • Modifier la visibilité du quadrillage dans un champ Tableur.
Versions 20 et supérieures
SaisieFormule
Nouveauté 20
SaisieFormule
SaisieFormule
La propriété ..SaisieFormule permet de :
  • savoir si l'utilisateur final peut saisir ou modifier des formules dans un champ Tableur.
  • autoriser ou non l'utilisateur final à saisir ou modifier des formules dans un champ Tableur.
Versions 20 et supérieures
SaisieValeur
Nouveauté 20
SaisieValeur
SaisieValeur
La propriété ..SaisieValeur permet de :
  • savoir si l'utilisateur final peut saisir ou modifier des valeurs dans un champ Tableur.
  • autoriser ou non l'utilisateur final à saisir ou modifier des valeurs dans un champ Tableur.
Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Tableur et avec ses cellules, consultez Propriétés associées au champ Tableur.
Liste des exemples associés :
Le champ Tableur Exemples unitaires (WINDEV) : Le champ Tableur
[ + ] Utilisation du champ Tableur.
Cet exemple présente comment :
- charger un fichier xlsx dans un champ tableur,
- sauver le tableur dans un fichier,
- remplir le champ avec des données provenant de la base de données,
- insérer des lignes, des colonnes,
- accéder aux cellules et les manipuler (modifier leur valeur, leur style,...),
- saisir des formules,
- etc.
Version minimum requise
  • Version 23
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire