Parma, 16-03-2002

Manuale d'uso del modulo LuaXls

Daniele Piazza

 

QS Informatica

 

Release 1.0

 

Home | Code | Download

  1. Introduzione
  2. Note tecniche
  3. Elenco delle funzioni definite nella DLL
  4. Le API Lua
  5. Elenco delle classi LuaXls
  6. Struttura delle classi

 

Introduzione

Il modulo LuaXls è una semplice API Lua per la scrittura diretta di files Excel. La scrittura viene eseguita senza utilizzare OLE, per cui non è necessario avere Excel installato.

 

Note tecniche

Il formato generato è un BIFF5 quindi risalente a versioni arcaiche di Excel. In ogni caso le ultime versioni aprono ancora questo formato. Le API sono essenzialmente composte da due files: una DLL che espone le funzioni di base per la scrittura e un file Lua che ingloba le API in un paio di classi per facilitarne l'uso.

Elenco delle funzioni definite nella DLL:

XlsTest
XlsNewFile
XlsCloseFile
XlsSetBOF
XlsSetCalcMode
XlsSetCalcCount
XlsSetRefMode
XlsSetDelta
XlsSetPrecision
XlsSet1904
XlsSetIteration
XlsSetColumnWidth
XlsSetPrintRowHeaders
XlsSetPrintGridlines
XlsSetDefaultRowHeight
XlsSetFont
XlsSetHeader
XlsSetFooter
XlsSetLeftMargin
XlsSetRightMargin
XlsSetTopMargin
XlsSetBottomMargin
XlsSetBackup
XlsSetFormatCount
XlsSetFormat
XlsSetWindowProtect
XlsSetDimensions
XlsSetRow
XlsAddInteger
XlsAddDouble
XlsAddString
XlsAddBlank
XlsAddFormula

Attenzione: alcune di queste funzioni possono essere non definite nella versione 1.0

 

Le API Lua

Queste funzioni possono ovviamente essere utilizzate direttamente, ma l'utilizzo può risultare a volte inagevole. Per questo motivo sono state realizzate alcune classi Lua per facilitare la scrittura dei files di Excel.

 

Elenco delle classi LuaXls

XlsFont
XlsCell
XlsSheet

Struttura delle classi

Classe

Membro/Metodo

Descrizione

XmlFont    
  name nome del font
  height altezza del font
  bold grassetto
  italic corsivo
  underline sottolineato
  strikeout cancellato
     
XlsCell    
  value
valore della cella
  formula formula della cella
  recalc  
  row coordinata della riga (0 based)
  col coordinata della colonna (0 based)
  hidden flag nascosta
  locked flag bloccata
  shaded flag ombreggiata
  bottomborder flag bordo inferiore
  topborder flag bordo superiore
  rightborder flag bordo di destra
  leftborder flag bordo di sinistra
  leftalign allineamento a sinistra
  rightalign allineamento a destra
  centeralign allineamento al centro
  generalalign  
  fillalign  
  multiplandefaultalign  
  fontnumber  
  formatcode  
     
  WriteAsInteger() scrive la cella come intero
  WriteAsDouble() scrive la cella come reale
  WriteAsString() scrive la cella come stringa
  WriteAsFormula() scrive la cella come formula
  WriteAsBlank() scrive la cella come blank
     
XlsSheet    
  filename
nome del file XLS (path completa)
  version versione
  doctype tipo di documento
  calcmode  
  calccount  
  refmode  
  iteration  
  delta  
  precision  
  datesystem  
  printrowheaders  
  printgridlines  
  defaultrowheight  
  header Intestazione
  footer piè di pagina
  leftmargin margine di sinistra
  rightmargin margine di destra
  topmargin margine superiore
  bottommargin margine inferiore
  backup  
  windowprotect  
  fonts lista dei font caricati
  formatcount  
  formats elenco dei formati caricati
     
  AddFont(font) aggiunge un font alla lista
  AddFormat(format) aggiunge un formato alla lista
  Create() crea il nuovo documento
  Close() chiude il documento
  BuildStockXLSHeader() crea tutte le impostazioni di base del documento
     
     
General    
  NewObj(obj, init) Crea un'istanza dell'oggetto "obj" inizializzando i parametri "init"
     
     
     
     

 

La struttura delle classi è stata inserita nel modulo "LuaXls.lua".


Daniele Piazza - QS Informatica