|
|
|
|
|
|
|
|
|
|
- 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
Manipuler un champ Tableur par programmation (dans une fenêtre)
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. 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. 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 :
TBLR_Tableur[1,3].CouleurFond = RougeClair
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" :
- 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 :
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)
Gérer les noms des cellules dans un champ Tableur Le champ Tableur propose différentes fonctions permettant de manipuler les noms des cellules :
| | | TableurAjouteNom | Spécifie un nom pour identifier une cellule d'un champ Tableur. | | TableurListeNom | Renvoie la liste des noms qui identifient une cellule d'un champ Tableur. | | TableurModifieNom | Modifie le nom utilisé pour identifier une cellule d'un champ Tableur. | | TableurSupprimeNom | Supprime 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 :
| | | Position | Nom de la cellule associé. Cette propriété est disponible en lecture seulement. | | Rectangle | Variable 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. | | Texte | Texte 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 :
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 :
| | | TableurListeCommentaire | Liste tous les commentaires de la feuille courante d'un champ Tableur. | | 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 : - 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 :
- Différentes propriété permettent de manipuler les différentes feuilles :
| | | FeuilleEnCours | La propriété FeuilleEnCours permet de connaître et de modifier la feuille courante d'un champ Tableur. | | 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.
| | NbFeuille | La propriété NbFeuille permet de connaître le nombre de feuilles de calcul dans un champ Tableur. | | NomFeuille | La 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.
| | | 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.
| | BarreOutilsVisible | La 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.
| | CheminFichier | La 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.
| | Commentaire | La 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ê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.
| | FeuilleEnCours | La propriété FeuilleEnCours permet de connaître et de modifier la feuille courante d'un champ Tableur. | | 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.
| | NbFeuille | La propriété NbFeuille permet de connaître le nombre de feuilles de calcul dans un champ Tableur. | | NomFeuille | La propriété NomFeuille permet de connaître ou modifier le nom de la feuille de calcul en cours dans un champ Tableur. | | QuadrillageVisible | La propriété QuadrillageVisible permet de : - Savoir si le quadrillage est visible ou non dans un champ.
- Modifier la visibilité du quadrillage dans un champ.
| | 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.
| | 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.
|
Liste des exemples associés :
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|