Thierry Seunevel Thierry 
Seunevel 
 Code en stock       
  Accueil   Réalisations Code en stock Téléchargement Curriculum Contact
Accueil > Code en stock > Excel Report

ExcelReport (4) : Méthodes et propriétés de la classe

. Principe
. 1er exemple
. Modèle Excel
. ExcelReport
. Compléments
. Nouveautés V1
La classe ExcelReport V1
La bibliothèque Lotusscript ExcelReport_1 est composée uniquement d'une section déclaration qui contient la définition d'une classe nommé ExcelReport.

Cette classe comporte une interface publique, c'est à dire un ensemble de propriétés et méthodes accessibles depuis l'extérieur de la classe et qui sont seules nécessaires pour l'utiliser.

Cette interface est décrite ci-dessous (les exemples de la colonne paramètres sont donnés pour un objet ExcelReport nommé report, c'est à dire que la déclaration suivante est assumée :
dim report as ExcelReport).
Méthode Paramètres Commentaire
New set report = new ExcelReport(String) Instancie un objet ExcelReport en utilisant le modèle dont le nom est fourni en paramètre
LineField report.LineField = String Propriété en écriture, par défaut cette propriété est égale à REPORTLINE.
Lui attribuer explicitement la valeur *NONE pour un état de type page (sans ligne détail).
RangeValue variant = report.RangeValue(String) Propriété en lecture, permet d'importer dans Notes le contenu d'une cellule nommée
RangeNames variant = report.RangeNames Propriété en lecture, permet de récupérer la liste des noms définis dans le modèle Excel.
Cette liste peut être utilisée pour déterminer les documents Notes nécessaires pour fournir des valeurs au modèle.
Sheet report.Sheet= String Propriété en écriture permettant de définir la feuille courante. Par défaut la feuille courant est la première définie dans le modèle
initHeader report.initHeader DocumentNotes Exécute la substitution en mode page des cellules nommées par les valeurs des champs de même nom du document Notes fourni en paramètre.
Peut être appelée plusieurs fois en fournissant la référence de documents différents
fillReportLine integer = report.fillReportLine (variant) Création d'une nouvelle ligne détail, de même modèle que la plage définie par la propriété ReportLine, et alimentation des cellules de cette plage avec le contenu des champs du document Notes ou du ViewEntry passé en paramètre.
Si on passe à la méthode un objet de type ViewEntry correspondant à une ligne de totalisation dans une vue, on ne peut utiliser que des noms de colonne. Retourne le numéro de ligne insérée (numérotation de 1 à n égale au nombre d'appels de la fonction).
printOut report.printOut Impression de la feuille courante du fichier Excel sans ouverture de la boite de dialogue impression, c'est à dire en utilisant les paramètres par défaut.
preView Report.preView Affiche la feuille courante en mode prévisualisation (même effet que Fichier>aperçu avant impression).
Depuis cet affichage, on peut zoomer, aller de page en page et demander l'impression avec ouverture de la boite de dialogue Imprimer.
insertPgBreak report.insertPgBreak Demande l'insertion d'une nouvelle page dans l'état.
Cette méthode doit être appelée après utilisation de fillReportLine pour le premier document de la nouvelle page, et non avant.
saveAs integer = report.saveAs(String) Sauvegarde du fichier Excel dans le fichier dont le nom est fourni en paramètre.
Une boite de dialogue demandant confirmation est affichée par Excel si un fichier de même nom existe déja au même emplacement.
En V1, cette méthode est désormais une fonction qui retourne vrai ou faux suivant que la sauvegarde a abouti.
La syntaxe précedente (appel de sub) peut être maintenue sans provoquer d'erreur.
closeReport report.closeReport Demande de fermeture de l'état.
Cette méthode est appelée automatiquement par les autres méthodes si nécessaire.
Son appel est généralement facultatif. Un appel explicite est nécessaire si le modèle Excel est défini en recalcul manuel et que vous vouliez rapatrier dans Notes des valeurs de champs calculés.
delete delete report Demande explicite de destruction de l'objet ExcelReport.
Cet appel est facultatif, mais peut éviter des problémes OLE, par exemple conservation d'une session Excel cachée ou d'un fichier ouvert …
lastError string = lastError Si la méthode saveAs a retourné faux, indiquant que la sauvegarde n'a pas pu avoir lieu, cette propriété retourne le texte de l'erreur. En fait ce texte n'est pas explicite. Il s'agit le plus souvent du numéro d'erreur qui correspond à Erreur Ole Automation
Le code de la classe est fourni dans la base de données exemple, ou peut être consulté en cliquant sur ce lien.

    Haut de page  Haut de page  Précédent  Modèle Excel | Compléments  Suivant


©  Thierry Seunevel (2004) www.seusoft.com