Cellatartományok formázása

Ahogy az egyes cellák, úgy a cellatartományok is a com.sun.star.table.CellProperties szolgáltatással formázhatók. További információkért és példákért lásd: Formázás szakasz.

Számolás cellatartományokkal

A computeFunction metódussal matematikai műveleteket végezhetünk a cellatartományokon. A computeFunction metódus egy állandót vár paraméterként, amely leírja a használni kívánt matematikai funkciót. A hozzátartozó állandók a com.sun.star.sheet.GeneralFunction enumerációban vannak definiálva. A következő értékek használhatók:

• SUM - a numerikus értékek összege.

• COUNT - az értékek száma (beleértve a nem numerikus értékeket is).

• COUNTNUMS - a numerikus értékek száma.

• AVERAGE - a numerikus értékek átlaga.

• MAX - a legnagyobb numerikus érték.

• MIN - a legkisebb numerikus érték.

• PRODUCT - a numerikus értékek szorzata.

• STDEV - szórás.

• VAR - szórásnégyzet.

• STDEVP - szórás a teljes populációra vetítve.

• VARP - szórásnégyzet a teljes populációra vetítve.

A következő példa kiszámítja az átlagát az A1:C3 tartománynak, és megjeleníti az eredményt egy üzenetablakban:

Dim Doc As Object

Dim Sheet As Object

Dim CellRange As Object



Doc = StarDesktop.CurrentComponent

Sheet = Doc.Sheets.getByName("Sheet 1")

CellRange = Sheet.getCellRangeByName("A1:C3")



MsgBox CellRange.computeFunction(com.sun.star.sheet.GeneralFunction.AVERAGE)

Cellatartalmak törlése

A clearContents metódus leegyszerűsíti a cellatartalmak és cellatartományok törlését azzal, hogy egy adott típusú tartalmat töröl egy cellatartományból.

A következő példa eltávolítja az összes karakterláncot és közvetlen formázási információt a B2:C3 tartományból.

Dim Doc As Object

Dim Sheet As Object

Dim CellRange As Object

Dim Flags As Long



Doc = StarDesktop.CurrentComponent

Sheet = Doc.Sheets(0)

CellRange = Sheet.getCellRangeByName("B2:C3")



Flags = com.sun.star.sheet.CellFlags.STRING + _

      com.sun.star.sheet.CellFlags.HARDATTR



CellRange.clearContents(Flags)

A clearContents metódusban megadott jelzők a com.sun.star.sheet.CellFlags állandólistából származnak. Ez a lista a következő elemeket biztosítja:

• VALUE - numerikus érték, amely nem dátumként vagy időként van formázva.

• DATETIME - numerikus érték, amely dátumként vagy időként van formázva.

• STRING - karakterláncok.

• ANNOTATION - cellákhoz csatolt megjegyzések.

• FORMULA - képletek.

• HARDATTR - cellák közvetlen formázása.

• STYLES - közvetett formázás.

• OBJECTS - cellákhoz csatolt rajzobjektumok.

• EDITATTR - csak a cellák részeire vonatkozó karakterformázás.

Az állandókat össze is adhatjuk, hogy a clearContents metódussal különböző információkat töröljünk.