Ez az osztály az Excelhez kapcsolódik és ennek segítségével lehet elvégezni műveleteket xls fájlokon.

Az objektum létrehozáskor rögtön kapcsolódik is az Excelhez, ez néhány másodpercig is eltarthat, ezért érdemes csak akkor példányosítani, ha tényleg szükség van rá.

Amennyiben létrehozás közben bármilyen hiba lép fel, akkor - a többi osztályhoz hasonlóan - false értékkel tér vissza.

CExcel()

Egy üres táblázatot nyit Excelben.

CExcel(string FileName)

A paraméterként megadott fájlt megnyitja Excelben.

int sheetCount()

Visszaadja a munkalapok számát.

array sheetNames()

Visszaadja a munkalapok neveit.

string getActiveSheet()

Megadja az aktuális munkalap nevét.

CExcelRange range(string cell)

A szövegesen megadott cella lesz a tartomány.

CExcelRange range(int x, int y)

A két paraméterrel megadott cell lesz a tartomány.

CExcelRange range(int x1, int y1, int x2, int y2)

A négy paraméterrel kijelölt téglalapba eső cellák lesznek a tartomány elemei.

void setActiveSheet(string name)

Beállítja az aktuális munkalapot a megadott nevűre. Amennyiben ilyen nevű munkalap még nem létezik létrehozza.

void setSheetName(string name)

Az aktuális munkalap nevét lehet megváltoztatni.

bool save()

Elmenti a megnyitott Excel file-t. Siker esetén true, hiba esetén false értékkel tér vissza.

string getValue(string cell)

string getValue(int col, int row)

Visszaadja az adott cella tartalmát.

bool setValue(string cell, string value)

bool setValue(int col, int row, string value)

Beállítja az adott cella tartalmát. Amennyiben a művelet hiba nélkül lefutott, a visszaadott érték true, ellenkező esetben false.

bool show()

Megjeleníti az Excel alkalmazást. Ebben az esetben az Excel nem záródik be a handler lefutása után.

bool setrowheight(int row,float height)

A megadott sorszámú sor (0-tól kezdve a számozást) magasságát height-re állítja.

bool setcolumnwidth(int col,float width)

A megadott sorszámú oszlop (0-tól kezdve a számozást) szélességét width-re állítja.

// létrehozzuk az Excel objektumot, amely a $filename fájlt fogja megnyitni
$a = new CExcel($filename);
 
// átváltunk a test munkalapra; ha ilyen még nincs, akkor létrehozza
$a->setActiveSheet('test');
 
// beállítjuk az A2 mező értékét
$a->setValue('A2','sdlkfjd');
 
// elmentjük a változásokat
$a->save();
 
// kiolvassuk az A2 cella értékét, hogy ellenőrizzük valóban átírta-e
var_dump($a->getValue('A2'));
 
// megjelenítjük az Excelt
$a->show();