Background

Minden diagramnak van háttérterülete. Minden háttérterület rendelkezik egy objektummal, amely a diagramobjektum következő tulajdonságaival érhető el:

• Area (objektum) - a diagram háttérterülete (a com.sun.star.chart.ChartArea szolgáltatást támogatja).

A diagram háttérterülete lefedi a diagram teljes területét, beleértve a cím, az alcím és a jelmagyarázat alatti területet is. A com.sun.star.chart.ChartArea szolgáltatás támogatja a vonal- és kitöltési tulajdonságokat, és nem biztosít további tulajdonságokat.

Diagramhátterek és -alapsíkok

Ugyan a diagram háttérterülete kitölti a diagram teljes területét, a diagramháttér csak az adatterület mögötti részt tölti ki.

A térbeli diagramoknál általában két háttér létezik: egy az adatterület mögött és egy az Y tengelytől hátra eső területen. Rendszerint a térbeli diagramok rendelkeznek alapsíkkal is.

• Floor (objektum) - a diagram alapsíkja (csak térbeli diagramoknál, a com.sun.star.chart.ChartArea szolgáltatást támogatja).

• Wall (objektum) - a diagram hátterei (csak térbeli diagramoknál, a com.sun.star.chart.ChartArea szolgáltatást támogatja).

Ezek az objektumok a com.sun.star.chart.ChartArea szolgáltatást támogatják, amely viszont rendelkezik a szokásos vonal- és kitöltési tulajdonságokkal (a com.sun.star.drawing.FillProperties és a com.sun.star.drawing.LineStyle szolgáltatás, lásd: Fejezet 8, Rajzok és bemutatók).

A diagram háttereit és alapsíkját a Chart objektumon keresztül lehet elérni, amely viszont a Chart objektum része:

Chart.Area.FillBitmapName = "Sky"   

A következő példa bemutatja, hogyan használható fel egy, a StarOffice programban megtalálható ábra (Sky) a diagram háttérterületében.

Dim Doc As Object

Dim Charts As Object

Dim Chart as Object



Dim Rect As New com.sun.star.awt.Rectangle

Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress



Rect.X = 8000

Rect.Y = 1000

Rect.Width = 10000

Rect.Height = 7000



RangeAddress(0).Sheet = 0

RangeAddress(0).StartColumn = 0 

RangeAddress(0).StartRow = 0

RangeAddress(0).EndColumn = 2

RangeAddress(0).EndRow = 12



Doc = StarDesktop.CurrentComponent

Charts = Doc.Sheets(0).Charts



Charts.addNewByName("MyChart", Rect, RangeAddress(), True, True)

Chart = Charts.getByName("SajátDiagram").EmbeddedObject



Chart.Area.FillStyle = com.sun.star.drawing.FillStyle.BITMAP

Chart.Area.FillBitmapName = "Sky"

Chart.Area.FillBitmapMode = com.sun.star.drawing.BitmapMode.REPEAT

Tengelyek

A StarOffice öt különböző tengelyt tud használni a diagramokban. A legegyszerűbb esetben ez az X és Y tengely. Térhatású diagramoknál általában van egy Z tengely is. Az olyan diagramoknál, ahol az adatsorok értékei jelentősen eltérnek egymástól, a StarOffice biztosít egy másodlagos X és Y tengelyt a méretezéshez.

Első X, Y és Z tengely

A tengelyeken kívül minden első X, Y és Z tengelyhez létezhet egy cím, egy leírás, egy rács és egy segédrács. Az egyes elemek külön-külön megjeleníthetők vagy elrejthetők. A diagramobjektum a következő tulajdonságokat biztosítja ezeknek a funkcióknak a kezeléséhez (a példában az X tengely látható, az Y és a Z tengely tulajdonságai azonosak felépítésűek).

• HasXAxis (logikai érték) - aktiválja az X tengelyt.

• XAxis (objektum) - az X tengelyről részletes adatokat tartalmazó objektum (támogatja a com.sun.star.chart.ChartAxis szolgáltatást).

• HasXAxisDescription (logikai érték) - aktiválja az X tengely leírását.

• HasXAxisGrid (logikai érték) - aktiválja az X tengely fő vezetőrácsát.

• XMainGrid (objektum) - az X tengely fő vezetőrácsáról részletes adatokat tartalmazó objektum (támogatja a com.sun.star.chart.ChartGrid szolgáltatást).

• HasXAxisHelpGrid (logikai érték) - aktiválja az X tengely segédrácsát.

• XHelpGrid (objektum) - az X tengely segédrácsáról részletes adatokat tartalmazó objektum (támogatja a com.sun.star.chart.ChartGrid szolgáltatást).

• HasXAxisTitle (logikai érték) - aktiválja az X tengely címét.

• XAxisTitle (objektum) - az X tengely címéről részletes adatokat tartalmazó objektum (támogatja a com.sun.star.chart.ChartTitle szolgáltatást).