|
|
|
|
|
|
|
|
- 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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|