Delphi - TDBChart komponens

Eddig a grafikon tulajdonságait szerkesztési időben, a beépített property editor-on keresztül állítottuk be. Most azt vizsgáljuk, hogy programból, illetve az Object Inspector-on keresztül milyen property-ket érünk el, és azokat hogyan használhatjuk.

AllowPanning: futási időben a grafikont a vízszintes és függőleges tengely mentén eltolhatja a felhasználó, ha a jobb egérgombot lenyomva tartva mozgatja az egeret a grafikon fölött. Ezzel a property-vel ezt engedélyezhetjük, illetve tilthatjuk le. Értékei a következők lehetnek: pmNone (nincs engedélyezve), pmHorizontal (csak a vízszintes tengely mentén tolható el a grafikon), pmVertical (csak a függőleges tengely mentén tolható el), pmBoth (mindkét tengely mentén eltolható).
AllowZoom: igaz érték esetén az egér bal gombjával nagyíthatjuk, illetve kicsinyíthetjük a grafikont. Ez a nagyítás nem a grafikon teljes területét nagyítja, hanem csak a tengelyeket húzza szét, illetve nyomja össze. Ez a művelet úgy történik, hogy a bal egérgomb segítségével egy téglalapot rajzolunk a grafikonra, és a grafikon ennek megfelelően változik. Ha először a téglalap bal felső sarkát adjuk meg, majd a jobb alsót, akkor nagyítás, ha először a jobb alsót és utána a bal felsőt, akkor kicsinyítés történik.
AnimatedZoom és AnimatedZoomStep: amikor programból nagyítjuk, vagy kicsinyítjük a grafikont, és az AnimatedZoom property értéke igaz, akkor az átméretezés az AnimatedZoomStep property-ben megadott számú lépésben történik.
AutoRefresh: igaz érték esetén automatikusan frissíti a grafikont, ha abban Dataset vagy Query van megjelenítve.
AxisVisible: logikai érték, amivel a tengelyek megjelenítését kapcsolhatjuk ki vagy be.
BackColor: a grafikon hátterének színe. Ez nem a komponens színe, hanem például 3D oszlopdiagram esetében az oszlopok mögötti részé.
BackImage, BackImageMode: megadhatunk egy háttérképet, ami a grafikon mögött jelenik meg. A BackImageMode property-vel szabályozhatjuk, hogy a kép milyen módon jelenjen meg. Ezek a következők lehetnek: pbmCenter (középen), pbmTile (mozaikszerűen), pbmStretch (a komponens méretéhez igazítva).
BackWall: 3D-s megjelenítésnél a grafikon mögötti "lap" megjelenítését szabályozhatjuk vele. Ahhoz, hogy látható eredménye legyen a View3D és a View3DWalls property értékét igazra kell állítani.
BottomAxis: az alsó tengely számos tulajdonságát állíthatjuk be ezen a property-n keresztül:

- Automatic, AutomaticMinimum és AutomaticMaximum: a tengely értékbeosztásának automatikus beállítását szabályozzák.
- Axis: a tengely megjelenésének tulajdonságait állíthatjuk be (szín, vonal stílus, stb.).
- AxisValueFormat: a tengely értékeinek formátumát határozza meg abban az esetben, ha ezek az értékek számok.
- DateTimeFormat: dátum értékek esetén határozza meg a formátumot.
- EndPosition: a tengely szélességét adja meg a grafikon szélességéhez képest százalékban.
- ExactDateTime : amikor dátum értékek vannak a tengelyen megjelenítve, és az értékek 1 hónaponként növekednek, akkor hamis érték esetén a dátum 30 naponként változik. Ha a property értéke igaz, akkor figyelembe veszi, hogy az adott hónapon belül hány nap van.
- Grid: ezen keresztül a rács jelölését szabályozhatjuk. A rács segíti az értékek leolvasását a grafikonról.
- GridCentered: igaz érték esetén a rácsvonalak a tengely értékhelyeiből indulnak ki. Például egy oszlopdiagramnál ebben az esetben a rácsvonal pont az oszlopot fogja kettéosztani. Ha a property értéke hamis, akkor a rácsvonalak az értékhelyek között jelennek meg.
- Increment: az értékek közötti lépésközt határozza meg, ami lehet pozitív vagy negatív szám, vagy dátum érték esetén dátum is.
- Inverted: ha igaz, akkor az értékek fordított sorrendben lesznek megjelenítve.
- Labels: a tengely feliratait kapcsolhatjuk ki, illetve be.
- LabelsFont: a tengely feliratának betűtípusa.
- LabelsMultiLine: engedélyezi, vagy letiltja a feliratok többsoros megjelenítését.
- LabelsOnAxis: azt szabályozza, hogy a tengely minimum és maximum értékénél legyen-e felirat.
- LabelsSeparation: a feliratok közötti minimum távolságot adja meg százalékban.
- LabelsSize: a feliratokra fenntartott terület mérete. 0 érték esetén automatikusan lesz beállítva a felirat méretéből.
- LabelStyle: a megjelenítendő felirat. talAuto (automatikus), talMark (az érték jelölése, ami például oszlopdiagram esetén az oszlopok felett látszik), talNone (semmi), talText (szöveg), talValue (érték, ami szöveges érték esetén sorszám).
- Logarithmic: az értékek a tengelyen logaritmikusan növekednek. Akkor használható jól, ha a minimum és maximum értékek között nagyon nagy különbség van.
- LofarithmicBase: logaritmikus értékek esetén a logaritmus alapja.
- Maximum: a tengely legmagasabb értéke.
- Minimum: a tengely minimum értéke.
- MinorGrid: a fő értékek közötti rács stílusának beállításai.
- MinorTickCount: a fő értékek között megjelenítendő értékek száma.
- MinorTickLength: a fő értékek közötti értékeket jelölő vonalak hossza.
- MinorTicks: a fő értékek között értékek jelölésének módja.
- PositionPercent: a grafikon széléhez viszonyított távolság százalékban.
- RoundFirstLabel: kerekíti a tengely első értékét.
- StartPosition: a tengely pozíciója a grafikon széléhez viszonyítva százalékban.
- TickInnerLength: a tengelyen az értékek jelölése vonallal történik, ennek hosszát adja meg a property a tengely belső felén belül.
- TickLength: az értéket jelölő vonal hossza.
- TickOnLabelsOnly: igaz érték esetén csak ott lesz jelölve vonallal az érték, ahol a felirat is látszik.
- Ticks: az értéket jelölő vonal tulajdonságai.
- TicksInner: az értéket jelölő vonal tulajdonságai a tengely belső felén.
- Title: a tengely felirata, és annak tulajdonságai.
- TitleSize: a tengely feliratának fenntartott terület mérete. 0 érték esetén automatikus.
- Visible: a tengely megjelenítésének ki- és bekapcsolása.

BottomWall: a grafikon alapjának tulajdonságai (lásd BackWall).
Chart3DPercent: 3D-s grafikon esetében a grafikon mélysége százalékban.
DepthAxis: a Z tengely tulajdonságait állíthatjuk be ezen a property-n keresztül. A Z tengely a sorozatok kezdőpontjainak elhelyezkedését szabályozza. Ugyanazokat a property-ket találjuk itt, mint a BottomAxis-nál.
Foot: lásd lejjebb a Title property leírásánál.
Frame: a grafikon keretének tulajdonságai: szín, stílus, vastagság, stb.
Gradient: a property segítségével egy színátmenetet hozhatunk létre a grafikon mögött. A színátmenet csak akkor látszik, ha a BackImage property-ben megadott kép nem takarja el.
Direction: a színátmenet iránya. Értékei a következők lehetnek: gdTopBottom (fentről lefelé), gdBottomTop (alulról felfelé), gdLeftRight (balról jobbra), gdRightLeft (jobbról balra), gdFromBottomLeft (a bal alsó sarokból indulva), gdFromCenter (középről indulva), gdFormTopLeft (a bal felső sarokból indulva).
EndColor: a színátmenet befejező színe.
StartColor: a színátmenet kezdő színe.
Visible: a színátmenet ki/bekapcsolása.
Left Axis: a baloldali tengely beállításai (lásd BottomAxis property).
Left Wall: a baloldali "fal" tulajdonságai (lásd BackWall property).
Legend: a jelmagyarázat tulajdonságai.
Alignment: meghatározza, hogy a jelmagyarázat igazítása a grafikon melyik széléhez történjen. Értékei lehetnek: laLeft (balra), laRight (jobbra), laTop (felül), laBottom (alul).
ColorWidth: a jelmagyarázatban látható szín-jelölések szélességét befolyásolja.
DividingLines: a jelmagyarázat sorai közötti elválasztó vonal tulajdonságait adhatjuk meg a property-n keresztül (szín, stílus, ki- és bekacsolás, stb.).
FirstValue: a jelmagyarázatban megadja az elsőnek megjelenítendő sorozat sorszámát.
Font: a jelmagyarázat szövegének betűtípusa.
Frame: a jelmagyarázat keretének stílusa.
HorizMargin: a jelmagyarázat és a grafikon vízszintes távolsága.
Inverted: igaz érték esetén a jelmagyarázat elemei fordított sorrendben jelennek meg.
LegendStyle: megadja, hogy a jelmagyarázatban milyen szöveg szerepeljen. Értékei a következők lehetnek: lsAuto (automatikus), lsLastValues (a sorozatok utolsó értéke), lsSeries (a sorozatok nevei), lsValues (az első sorozat értékei).
ResizeChart: igaz érték esetén úgy méretezi át a grafikont, hogy a jelmagyarázatot ne takarja el.
ShadowColor: a jelmagyarázat árnyékának színe.
ShadowSize: az árnyék mérete.
TextStyle: ha a LegendStyle property értéke lsLastValues vagy lsValues, akkor a megjelenítendő érték formátumát határozza meg. Értékei lehetnek: ltfLeftPercent (baloldalon az érték százalékban, mellette pedig az X tengely felirata), ltfLeftValue (baloldalon az érték, mellete pedig az X tengely felirata), ltfPlain (az X tengely felirata), ltfRightPercent (baloldalon az érték százalékban, balra mellette pedig az X tengely felirata), ltfRightValue (jobboldalon az érték százalékban, balra mellette pedig az X tengely felirata), ltfXValue (az X tengely értéke).
TopPos: A jelmagyarázat függőleges pozíciója.
VertMargin: A jelmagyarázat területének függőleges mérete.
Visible: a jelmagyarázat ki- és bekapcsolása.
MarginBottom, MarginLeft, MarginRight, MarginTop: A grafikon margói a komponens szélességéhez és magasságához képest. Meghatározzák azt a területet, amelyen belül a grafikon megjelenhet.
MaxPointsPerPage: több oldalas grafikonokat is létrehozhatunk úgy, hogy meghatározzuk az egy grafikonon belül megjeleníthető értékek számát. Akkor érdemes használni, ha nagyon sok adatot szeretnénk a grafikonban megjeleníteni. Ha például egy oszlopdiagramban 12 értéket szeretnénk megjeleníteni, és ebben a property-ben 5-öt adunk meg, akkor az első két oldalon (lásd Page property) 5-5 oszlop lesz látható, míg az utolsón csak 2.
MonoChrome: fekete-fehér megjelenítés ki- és bekapcsolása.
Page: többoldalas grafikon esetében az éppen látható lapot állíthatjuk be ezen a property-n keresztül.
RefreshInterval: ha 0-nál nagyobb értéket adunk meg, akkor a megadott időközönként frissíti a grafikon adatait.
ScaleLastPage: többoldalas grafikon esetében előfordulhat, hogy az utolsó lapon kevesebb adat látható, mint az előző lapokon. Ebben az esetben, ha a property értéke igaz, akkor átméretezi a vízszintes tengelyt.
SeriesList: a cikksorozat első részében részletes leírást olvashat erről.
ShowGlassCursor: igaz érték esetén megváltoztatja az egér kurzort homokórára, amikor az adatokat kiolvassa a Dataset-ből vagy a Query-ből. Csak akkor érdemes igazra állítani, ha ez a művelet hosszabb ideig tart.
Title: a grafikon címsorának tulajdonságait állíthatjuk be a property-n keresztül. Akár többsoros szöveget is megadhatunk.
TopAxis: a felső tengely tulajdonságai. (lásd Bottom Axis).
View3D: a 3D-s megjelenítés ki/bekapcsolása
View3DWalls: igaz érték esetén megjeleníti a "falakat" 3D-s grafikonoknál. Hamis érték esetén a "falak" átlátszóak lesznek, de ha a rácsok be vannak állítva (Axis.Grid.Visible=true), akkor azok ugyanúgy megjelennek.
View3DOptions: a 3D-s megjelenítéssel kapcsolatos tulajdonságok:

- Elevation: a vízszintes tengely körüli elforgatás szögét határozza meg. A használható érték 270 és 360 között van. A 270-nél teljesen felülnézetből látjuk a grafikont.
- HorizOffset: a grafikon vízszintes eltolásának mértéke. Pozitív és negatív szám egyaránt megadható.
- Orthogonal: igaz érték esetén "ál 3D"-s hatást kapunk. Ebben az esetben nem tudjuk a grafikont forgatni.
- Perspective: a 3D perspektivikus hatást növelhetjük az érték növelésével.
- Rotation: a függőleges tengely körüli elforgatás szögét adja meg. A használható érték itt is 270 és 360 között van. 270-es értéknél pont szemből látjuk a grafikont.
- Tilt: a grafikonra merőleges tengely körüli elforgatás szögét adja meg. A használható értékek itt is 270 és 360 között vannak.
- VertOffset: a grafikon függőleges eltolásának mértéke. Pozitív és negatív szám egyaránt megadható.
- Zoom: a grafikon nagyításának mértéke százalékban.
- ZoomText: igaz érték esetén a feliratokat is a megfelelő mértékben nagyítja, illetve kicsinyíti.

A cikksorozat következő részében megnézzük, hogy hogyan tudjuk egy kész grafikon nyomtatási képét megjeleníteni, illetve a grafikont kinyomtatni.

TDBChart komponens

3. rész