PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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 manipulant des variables de type xlsDocument
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
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.
Versions 16 et supérieures
WINDEVLinux Ce type de variable est désormais disponible en WINDEV Linux.
WEBDEV - Code ServeurLinux Ce type de variable est désormais disponible en WEBDEV Linux.
Nouveauté 16
WINDEVLinux Ce type de variable est désormais disponible en WINDEV Linux.
WEBDEV - Code ServeurLinux Ce type de variable est désormais disponible en WEBDEV Linux.
WINDEVLinux Ce type de variable est désormais disponible en WINDEV Linux.
WEBDEV - Code ServeurLinux Ce type de variable est désormais disponible en WEBDEV Linux.
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 :
NomType manipuléEffet
CelluleTableau de xlsCelluleCellules du document XLS.
ColonneTableau de xlsColonneColonne du document XLS.
Versions 17 et supérieures
DroiteAGauche
Nouveauté 17
DroiteAGauche
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".
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 uniquement. 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 uniquement.
NombreFeuilleEntierNombre de feuilles présentes dans le document (identique à la fonction xlsNbFeuille). Cette propriété est disponible en lecture uniquement.
NombreLigneEntierNombre de lignes présentes dans le document (identique à la fonction xlsNbLigne). Cette propriété est disponible en lecture uniquement.
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.
Versions 17 et supérieures
RecalculAuChargement
Nouveauté 17
RecalculAuChargement
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.
VersionEntierVersion du document XLS (identique à la fonction xlsVersion). Cette propriété est disponible en lecture uniquement.
Remarque : Ces propriétés peuvent être utilisées avec une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

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 manipulant des variables de type xlsDocument

Versions 14 et supérieures
xlsAjouteFeuille
Nouveauté 14
xlsAjouteFeuille
xlsAjouteFeuille
Ajoute ou insère une nouvelle feuille dans un document Excel.
Versions 09 et supérieures
xlsDonnée
Nouveauté 09
xlsDonnée
xlsDonnée
Récupère le contenu d'une cellule d'un fichier XLS.
Versions 09 et supérieures
xlsFerme
Nouveauté 09
xlsFerme
xlsFerme
Ferme un fichier XLS.
Versions 11 et supérieures
xlsFeuilleEnCours
Nouveauté 11
xlsFeuilleEnCours
xlsFeuilleEnCours
Permet de connaître ou de modifier la feuille courante d'un fichier XLS.
Versions 09 et supérieures
xlsMsgErreur
Nouveauté 09
xlsMsgErreur
xlsMsgErreur
Renvoie le libellé de la dernière erreur due à une fonction XLS.
Versions 09 et supérieures
xlsNbColonne
Nouveauté 09
xlsNbColonne
xlsNbColonne
Renvoie le nombre de colonnes d'une feuille d'un fichier XLS.
Versions 11 et supérieures
xlsNbFeuille
Nouveauté 11
xlsNbFeuille
xlsNbFeuille
Renvoie le nombre de feuilles d'un fichier XLS.
Versions 09 et supérieures
xlsNbLigne
Nouveauté 09
xlsNbLigne
xlsNbLigne
Renvoie le nombre de lignes d'un fichier XLS.
Versions 09 et supérieures
xlsOuvre
Nouveauté 09
xlsOuvre
xlsOuvre
Ouvre un fichier Excel (fichiers xls ou xlsx).
Versions 12 et supérieures
xlsSauve
Nouveauté 12
xlsSauve
xlsSauve
Sauve un document XLS.
Versions 14 et supérieures
xlsSupprimeFeuille
Nouveauté 14
xlsSupprimeFeuille
xlsSupprimeFeuille
Supprime une feuille du document Excel.
Versions 09 et supérieures
xlsTitreColonne
Nouveauté 09
xlsTitreColonne
xlsTitreColonne
Récupère l'intitulé d'une colonne d'un fichier XLS.
Versions 09 et supérieures
xlsTypeColonne
Nouveauté 09
xlsTypeColonne
xlsTypeColonne
Renvoie le type des données saisies dans une colonne d'un fichier XLS.
Versions 09 et supérieures
xlsVersion
Nouveauté 09
xlsVersion
xlsVersion
Renvoie 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
Modification syntaxe
la ligne dans l'exemple possède une parenthèse fermante de trop

Actuellement
SI xlsFeuilleEnCours(IDFicXLS, 2)) = Vrai ALORS

Après correction
SI xlsFeuilleEnCours(IDFicXLS, 2) = Vrai ALORS
Gérard
08 avr. 2017
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