|
|
|
|
- Propriétés spécifiques à la description des variables de type xlsDocument
- Accéder à une colonne d'un document Excel
- Accéder à une cellule d'un document Excel
- Accéder à une cellule d'une colonne d'un document Excel
- Accéder à une cellule d'une ligne d'un document Excel
- Fonctions WLangage manipulant des variables de type xlsDocument
xlsDocument (Type de variable) En anglais : xlsDocument
Une variable de type xlsDocument permet de décrire et modifier un document Excel. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
MaFeuille est un xlsDocument NomFichierXLS est une chaîne NomFichierXLS = fSélecteur(fRepExe(), "", "Sélectionnez un fichier...", ... "Tous fichiers (*.*)" + TAB + "*.*", "*", fselOuvre + fselExiste) SI NomFichierXLS = "" ALORS RETOUR MaFeuille = xlsOuvre(NomFichierXLS, xlsEcriture) // On va mettre OK dans la case A 25 MaFeuille[25,"A"] = "OK" // Sauvegarde xlsSauve(MaFeuille) IDFicXLS est un xlsDocument NomFichierXLS est une chaîne = fRepExe + "\Suivi d'affaires1.xls" IDFicXLS = xlsOuvre(NomFichierXLS, xlsEcriture) SI ErreurDétectée = Faux ALORS Azz est un entier = xlsFeuilleEnCours(IDFicXLS) Info("Feuille en cours dans le fichier Excel : " + Azz) // Changement de feuille SI xlsFeuilleEnCours(IDFicXLS, 2) = Vrai ALORS Info("La feuille courante a été modifiée.") // Lecture d'une cellule pour test Info(xlsDonnée(IDFicXLS, 11, 2)) SINON Erreur("Le fichier sélectionné ne comporte pas de seconde feuille !") FIN SINON Erreur("Attention ! le fichier est déjà ouvert sur un poste de travail !") FIN Remarques Propriétés spécifiques à la description des variables de type xlsDocument Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type xlsDocument : | | | Nom | Type manipulé | Effet |
---|
Cellule | Tableau de xlsCellule | Cellules du document XLS. | Colonne | Tableau de xlsColonne | Colonne du document XLS. | DroiteAGauche | Booléen | - Vrai si la feuille courante est en mode de lecture "Droite vers la gauche".
- Faux si la feuille courante est en mode de lecture "Gauche vers la droite".
| Feuille | Entier | Numéro de la feuille en cours (identique à la fonction xlsFeuilleEnCours). | Fichier | Chaîne de caractères | Nom et chemin complet du fichier XLS associé au document. Cette propriété est disponible en lecture seulement. Elle est affectée lors de l'utilisation de la fonction xlsOuvre. Remarque : lors de l'affectation d'une variable de type xlsDocument dans une autre, cette propriété n'est pas recopiée (sauf lors de l'appel de la fonction xlsOuvre). | Ligne | Tableau de xlsLigne | Ligne du document XLS. | Modifié | Booléen | - Vrai si le document a été modifié
- Faux dans le cas contraire.
Cette propriété est remise à Faux après l'utilisation de la fonction xlsSauve. | NombreColonne | Entier | Nombre de colonnes présentes dans le document (identique à la fonction xlsNbColonne). Cette propriété est disponible en lecture seulement. | NombreFeuille | Entier | Nombre de feuilles présentes dans le document (identique à la fonction xlsNbFeuille). Cette propriété est disponible en lecture seulement. | NombreLigne | Entier | Nombre de lignes présentes dans le document (identique à la fonction xlsNbLigne). Cette propriété est disponible en lecture seulement. | NomFeuille | Chaîne de caractères | Nom de la feuille en cours. Cette propriété peut correspondre à une chaîne de 1 à 31 caractères. Elle est insensible à la casse. | RecalculAuChargement | Booléen | - Vrai si les formules du document doivent être recalculées lors de l'ouverture du document sous Excel ou OpenOffice.
- Faux si aucun calcul ne doit être effectué lors de l'ouverture du document sous Excel ou OpenOffice.
Remarque : Seules les formules initialement présentes dans le document peuvent être recalculées. | Version | Entier | Version du document XLS (identique à la fonction xlsVersion). Cette propriété est disponible en lecture seulement. |
Accéder à une colonne d'un document Excel Pour accéder à une colonne d'un document Excel, il est possible d'utiliser les syntaxes suivantes : - MonDocumentXLS.Colonne[1] : Accède à la colonne 1 du fichier Excel.
- MonDocumentXLS.Colonne["A"] : Accède à la colonne A du fichier Excel.
Accéder à une cellule d'un document Excel Pour accéder à une cellule d'un document Excel, il est possible d'utiliser les syntaxes suivantes : - MonDocumentXLS[1,2] : Accède à la cellule de la ligne 1 et de la colonne 2 du fichier Excel.
- MonDocumentXLS[5, "A"] : Accède à la cellule de la ligne 5 et de la colonne A du fichier Excel.
Accéder à une cellule d'une colonne d'un document Excel Pour accéder à une cellule d'une colonne d'un document Excel, il est possible d'utiliser les syntaxes suivantes : - MonDocumentXLS.Colonne[1].Cellule : Renvoie la valeur de la cellule de la colonne 1 pour la ligne en cours.
- MonDocumentXLS.Colonne["A"].Cellule : Renvoie la valeur de la cellule de la colonne "A" pour la ligne en cours.
Accéder à une cellule d'une ligne d'un document Excel Pour accéder à une cellule d'une ligne d'un document Excel, il est possible d'utiliser la syntaxe suivante : - MonDocumentXLS.Ligne[1].Cellule[2] : Accède à la cellule de la ligne 1 et de la colonne 2 du fichier Excel.
- MonDocumentXLS.Ligne[5].Cellule["A"] : Accède à la cellule de la ligne 5 et de la colonne A du fichier Excel.
Fonctions WLangage manipulant des variables de type xlsDocument - Syntaxe classique :
| | xlsAjouteFeuille | Ajoute ou insère une nouvelle feuille dans un document Excel. | | Supprime la fusion d'une plage de cellules. | xlsDonnée | Récupère le contenu d'une cellule d'un fichier XLS. | xlsFerme | Ferme un fichier XLS. | xlsFeuilleEnCours | Permet de connaître ou de modifier la feuille courante d'un fichier XLS. | | Fusionne les cellules spécifiées dans un document Excel. | xlsMsgErreur | Renvoie le libellé de la dernière erreur due à une fonction XLS. | xlsNbColonne | Renvoie le nombre de colonnes d'une feuille d'un fichier XLS. | xlsNbColonnes | La fonction xlsNbColonnes est conservée uniquement pour compatibilité. | xlsNbFeuille | Renvoie le nombre de feuilles d'un fichier XLS. | xlsNbLigne | Renvoie le nombre de lignes d'un fichier XLS. | xlsNbLignes | La fonction xlsNbLignes est conservée uniquement pour compatibilité. | xlsOuvre | Ouvre un fichier Excel (fichiers xls ou xlsx). | | Recalcule toutes les formules d'un document Excel au format XLSX. | | Permet de savoir si une cellule est fusionnée avec d'autres cellules et d'obtenir la plage des cellules fusionnées correspondante. | xlsSauve | Sauve un document XLS. | xlsSupprimeFeuille | Supprime une feuille du document Excel. | xlsTitreColonne | Récupère l'intitulé d'une colonne d'un fichier XLS. | xlsTypeColonne | Renvoie le type des données saisies dans une colonne d'un fichier XLS. | xlsVersion | Renvoie la version d'Excel avec laquelle le fichier a été enregistré. |
Liste des exemples associés :
|
Exemples unitaires (WINDEV) : Type xls
[ + ] Manipulation des types de variable xlsDocument, xlsColonne, xlsLigne et xlsCellule. Cet exemple a pour but d'offrir une première approche, simple, de la manipulation de ces types de variables.
|
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|