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 Tableur
  • 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 WatchMac CatalystUniversal Windows 10 App
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 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 Ã€ TBLR_MonTableur.NombreLigne
	POUR y = 1 Ã€ 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 :
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.

Gérer les noms des cellules dans un champ Tableur

Le champ Tableur propose différentes fonctions permettant de manipuler les noms des cellules :
TableurAjouteNomSpécifie un nom pour identifier une cellule d'un champ Tableur.
TableurListeNomRenvoie la liste des noms qui identifient une cellule d'un champ Tableur.
TableurModifieNomModifie le nom utilisé pour identifier une cellule d'un champ Tableur.
TableurSupprimeNomSupprime un des noms permettant d'identifier une cellule d'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 un 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 en lecture seulement.
    RectangleVariable de type Rectangle.
    Permet 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 :
    TableurListeCommentaireListe tous les commentaires de la feuille courante d'un champ Tableur.
    TableurSelectCommentairePermet 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 :
  • Il est possible de charger les différentes feuilles de calcul d'un fichier XLSX (fonction TableurCharge).
  • Différentes fonctions permettent de manipuler les différentes feuilles de calcul :
    TableurAjouteFeuilleAjoute une feuille de calcul dans un champ Tableur présent dans une fenêtre.
    TableurInsèreFeuilleInsère une feuille de calcul dans un champ Tableur présent dans une fenêtre.
    TableurListeFeuilleRenvoie la liste des feuilles de calcul présentes dans un champ Tableur.
    TableurSelectFeuilleSélectionne une feuille de calcul (identifiée par son nom) dans un champ Tableur.
    TableurSupprimeFeuilleSupprime une feuille de calcul dans un champ Tableur présent dans une fenêtre.
  • Différentes propriété permettent de manipuler les différentes feuilles :
    FeuilleEnCoursLa propriété FeuilleEnCours permet de connaître et de modifier la feuille courante d'un champ Tableur.
    MultiFeuilleLa 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.
    NbFeuilleLa propriété NbFeuille permet de connaître le nombre de feuilles de calcul dans un champ Tableur.
    NomFeuilleLa propriété NomFeuille permet de connaître ou modifier le nom de la feuille de calcul en cours dans un champ Tableur.
  • L'utilisateur dispose de FAA (Fonctionnalités Automatiques de vos Applications) pour gérer les différentes 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.
BarreDeFormuleVisibleLa 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.
BarreOutilsVisibleLa propriété BarreOutilsVisible permet :
  • de savoir si la barre d'outils ou le ruban est affichée dans un champ.
  • d'afficher ou non la barre d'outils ou le ruban dans un champ.
CheminFichierLa propriété CheminFichier permet de connaître :
  • le nom du fichier xlsx associé à un champ Tableur.
  • le nom du fichier associé à un champ Editeur d'images.
  • le nom du fichier PDF associée à un champ Lecteur PDF.
  • le nom du fichier DOCX associé à un champ Traitement de texte.
  • le nom du fichier wddiag associé à un champ Editeur de diagrammes.
CommentaireLa propriété Commentaire permet de définir et de connaître les différentes caractéristiques des commentaires présents sur une cellule d'un champ Tableur.
EntêteVisibleLa 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.
FeuilleEnCoursLa propriété FeuilleEnCours permet de connaître et de modifier la feuille courante d'un champ Tableur.
MultiFeuilleLa 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.
NbFeuilleLa propriété NbFeuille permet de connaître le nombre de feuilles de calcul dans un champ Tableur.
NomFeuilleLa propriété NomFeuille permet de connaître ou modifier le nom de la feuille de calcul en cours dans un champ Tableur.
QuadrillageVisibleLa propriété QuadrillageVisible permet de :
  • Savoir si le quadrillage est visible ou non dans un champ.
  • Modifier la visibilité du quadrillage dans un champ.
SaisieFormuleLa 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.
SaisieValeurLa 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

Dernière modification : 27/05/2024

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