|
|
|
|
|
|
|
|
|
|
- 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.
 Nouveauté SaaSMaFeuille 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)
MaFeuille[25,"A"] = "OK"
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)
SI xlsFeuilleEnCours(IDFicXLS, 2) = Vrai ALORS
Info("La feuille courante a été modifiée.")
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
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).
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éfinie | Version non définie (valeur par défaut). Le format sera définit lors de l'enregistrement du fichier. | | xlsVersionXls | Document de type XLS. | | xlsVersionXlsx | Document 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 : | | | | Nom | Type manipulé | Effet |
|---|
| Cellule | Tableau de xlsCellule | Cellules du document XLS. | | Colonne | Tableau de xlsColonne | Colonne du document XLS. | | Commentaire | Tableau de xlsCommentaire | Commentaires des cellules 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 sans prendre en compte les colonnes entièrement vides). 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 sans prendre en compte les lignes entièrement vides). 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. | | xlsDéfusionneCellule | 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. | | xlsFusionneCellule | 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). | | xlsRecalculeTout | Recalcule toutes les formules d'un document Excel au format XLSX. | | xlsRécupèreFusion | 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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|