PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV 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
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
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

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