PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Manipuler le champ Tableur par programmation
  • Manipuler le champ Tableur
  • Manipuler les cellules du champ Tableur
  • Astuce : Fusionner des cellules par programmation
  • Initialiser un champ Tableur
  • Gérer les noms des cellules 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/iPadApple WatchUniversal 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

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 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 TableurAjouteDonnée.
    Exemple : Ajout d'une valeur dans la cellule "A2" :
    TableurAjouteDonnée(TBLR_Tableur, 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 à la possibilité de fusionner les cellules sélectionnées grâce à 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 :
TableurSelectPlus(TBLR_MonTableur, "A1", "C5")
ExécuteFAA(TBLR_MonTableur, faaTableurFusion)
Remarque : La fonction TableurRé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.

Initialiser un champ Tableur

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

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
TableurAjouteNom
Nouveauté 22
TableurAjouteNom
TableurAjouteNom
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.
Champ Tableur : Manipuler par programmation un fichier comportant plusieurs feuilles de calcul
A partir de la version 200057, la gestion des fichiers comportant plusieurs feuilles de calculs est disponible.
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 :
  • le nom du fichier xlsx associé à un champ Tableur. Ce nom est initialisé par les fonctions TableurCharge et TableurSauve.
  • le nom du fichier associé à un champ Editeur d'images. Ce nom est initialisé par les fonctions PicOuvre et PicSauve.
  • le nom du fichier PDF associée à un champ Lecteur PDF. Ce nom est initialisé par la fonction LecteurPDFOuvre.
  • le nom du fichier DOCX associé à un champ Traitement de texte. Ce nom est initialisé par les fonctions DocOuvre et DocSauve.
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 20
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire