DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XLS
  • 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
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
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
Nouveauté 2024
// Créer un document de type xls
xlsDoc est un xlsDocument(xlsVersionXls)
Syntaxe

Déclarer un document XLS sans spécifier le format Masquer les détails

MaVariable est un xlsDocument
Dans ce cas, la variable créée ne correspond pas à un format spécifique de Excel. Le format sera définit lors de l'enregistrement du fichier (selon l'extension précisée).
Nouveauté 2024

Déclarer un document XLS en spécifiant le format Masquer les détails

MaVariable est un xlsDocument(<Format>)
<Format> : Constante de type Entier
Format du document manipulé. Ce paramètre peut correspondre aux constantes suivantes :
xlsVersionIndéfinieVersion non définie (valeur par défaut). Le format sera définit lors de l'enregistrement du fichier.
xlsVersionXlsDocument de type Xls.
xlsVersionXlsxDocument de type Xlsx.
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 :
NomType manipuléEffet
CelluleTableau de xlsCelluleCellules du document XLS.
ColonneTableau de xlsColonneColonne du document XLS.
DroiteAGaucheBoolé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".
FeuilleEntierNuméro de la feuille en cours (identique à la fonction xlsFeuilleEnCours).
FichierChaîne de caractèresNom 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).
LigneTableau de xlsLigneLigne 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.
NombreColonneEntierNombre de colonnes présentes dans le document (identique à la fonction xlsNbColonne). Cette propriété est disponible en lecture seulement.
NombreFeuilleEntierNombre de feuilles présentes dans le document (identique à la fonction xlsNbFeuille). Cette propriété est disponible en lecture seulement.
NombreLigneEntierNombre de lignes présentes dans le document (identique à la fonction xlsNbLigne). Cette propriété est disponible en lecture seulement.
NomFeuilleChaîne de caractèresNom de la feuille en cours. Cette propriété peut correspondre à une chaîne de 1 à 31 caractères. Elle est insensible à la casse.
RecalculAuChargementBoolé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.
VersionEntierVersion 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 :
    xlsAjouteFeuilleAjoute ou insère une nouvelle feuille dans un document Excel.
    xlsDéfusionneCelluleSupprime la fusion d'une plage de cellules.
    xlsDonnéeRécupère le contenu d'une cellule d'un fichier XLS.
    xlsFermeFerme un fichier XLS.
    xlsFeuilleEnCoursPermet de connaître ou de modifier la feuille courante d'un fichier XLS.
    xlsFusionneCelluleFusionne les cellules spécifiées dans un document Excel.
    xlsMsgErreurRenvoie le libellé de la dernière erreur due à une fonction XLS.
    xlsNbColonneRenvoie le nombre de colonnes d'une feuille d'un fichier XLS.
    xlsNbColonnesLa fonction xlsNbColonnes est conservée uniquement pour compatibilité.
    xlsNbFeuilleRenvoie le nombre de feuilles d'un fichier XLS.
    xlsNbLigneRenvoie le nombre de lignes d'un fichier XLS.
    xlsNbLignesLa fonction xlsNbLignes est conservée uniquement pour compatibilité.
    xlsOuvreOuvre un fichier Excel (fichiers xls ou xlsx).
    xlsRecalculeToutRecalcule toutes les formules d'un document Excel au format XLSX.
    xlsRécupèreFusionPermet de savoir si une cellule est fusionnée avec d'autres cellules et d'obtenir la plage des cellules fusionnées correspondante.
    xlsSauveSauve un document XLS.
    xlsSupprimeFeuilleSupprime une feuille du document Excel.
    xlsTitreColonneRécupère l'intitulé d'une colonne d'un fichier XLS.
    xlsTypeColonneRenvoie le type des données saisies dans une colonne d'un fichier XLS.
    xlsVersionRenvoie la version d'Excel avec laquelle le fichier a été enregistré.
Liste des exemples associés :
Type xls 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.
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cellule calcule les lignes et colonnes vides
Les données sont lues en prenant en compte les lignes et les colonnes vides. Ce fonctionnement est le même qu'en utilisant la fonction xlsDonnée() avec le dernier paramètre à Faux (ce qui n'est pas le fonctionnement par défaut).
klbsjpolp
24 jan. 2010

Dernière modification : 04/01/2024

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