WklChart

WklChart na Accessovem obrazcu izriše grafikon iz tabele, poizvedbe ali stavka SQL: niz meritev po datumu s spodnjo in zgornjo mejo, število po mesecih kot stolpce ali vrednosti po kategorijah kot palice. Kot podobrazec sledi trenutnemu zapisu obrazca prek LinkMasterFields in LinkChildFields. Riše z lastnim izrisovalnikom, zato je slika v pogledu obrazca, pogledu načrta in predogledu tiskanja enaka.

Na voljo od izdaje 1.60.0; v poročilih in s PrintStyle od izdaje 1.62.0.

Prvi koraki

Prikaz niza meritev z mejo in trendom

Pogosta opravila

Prikaz debeline stene trenutnega merilnega mesta po datumu: RecordSource = meritve, XField = datum, YFields = debelina, LinkMasterFields = ključ na obrazcu, LinkChildFields = ključ v meritvah.
Vrisovanje minimuma in maksimuma: AddReference MinDebelina, , "Minimum", wskBad v Form_Current.
Ugotavljanje, kdaj bo minimum dosežen, če se trend nadaljuje: TrendReaches(0, MinDebelina).
Štetje zapadlih pregledov po mesecih: ChartType = wctColumn, Aggregate = wcaCount, Period = wcyMonth.
Pasovi, en niz na merilno mesto iz dolgih podatkov, branje trenda: Prikaz mej in trenda v grafikonu.
En grafikon na zapis poročila, berljiv tudi na sivinskem izpisu: Tiskanje merilnikov in grafikonov v poročilu.

Grafični prikaz

+- WklChart ------------------------------------------------------+
|                       TML-1 Debelina stene                      | 1
| 11,0 |                                                          |
| 10,5 |- - - - - - - - - - - - - - - - - - - - - - - - - Maksimum| 2
| 10,0 |  *-*                                                     |
|  9,5 |      *-*-*  .                                            | 3
|  9,0 |             *-*-*-*  . .                                 | 4
|  8,5 |- - - - - - - - - - - - - - - - - - - - - - - - -  Minimum|
|      +----------+----------+----------+----------+              |
|        2026       2027       2028       2029                    | 5
+-----------------------------------------------------------------+

Območje	Pomen
1	`Title`
2	Mejna črta iz `AddReference` v barvi svoje vrste, z napisom
3	Niz kot črta z oznakami; manjkajoča vrednost črto prekine
4	Linearni trend (`ShowTrend`), črtkan, čez točke, na katerih temelji
5	Časovna os s koledarskimi koraki (leta, meseci, dnevi), izbranimi glede na širino

Ključne zmožnosti

Vezava na podatke: tabela, poizvedba ali stavek SQL, z enim nizom za vsako polje Y („široki“ podatki) ali enim nizom za vsako vrednost polja niza („dolgi“ podatki).
Sledi obrazcu kot podobrazec: LinkMasterFields in LinkChildFields; ob menjavi glavnega zapisa znova prebere podatke.
Štiri vrste: črtni, točkovni, stolpčni in palični; stolpci in palice drug ob drugem ali naloženi.
Združevanje po vrednosti X ali po dnevu, tednu, mesecu, četrtletju ali letu: vsota, povprečje, število, najmanjša in največja vrednost.
Meje in pasovi z napisi, v barvah stanja drugih komponent.
Linearni trend za vsak niz, z naklonom in datumom, ko je dosežena meja.
Dolgi nizi se za prikaz zgostijo, grafikon pa to tudi sporoči; trend in os uporabljata vse vrednosti.
Berljiv za vse: barve nizov, ki ostanejo razločljive tudi pri motnjah barvnega vida in ohranijo kontrast 3 : 1, svojo obliko oznake za vsak niz in barvne sheme drugih komponent.

Osnovni pojmi

Kaj je X, določa os. XKind = wcxDate da časovno os s koledarskimi koraki; wcxNumber številsko os z okroglimi koraki (1-, 2-, 2,5- ali 5-kratnik potence števila deset); wcxCategory eno mesto za vsako različno besedilo v vrstnem redu, v katerem se prvič pojavi.

Manjkajočih vrednosti grafikon ne izmišljuje. Pri Missing = wcvGap (privzeto) vrstica brez vrednosti Y črto prekine. wcvConnect točko izpusti, wcvZero pa jo šteje kot 0. Vrstice brez berljive vrednosti X ni mogoče postaviti; namesto da bi grafikon odpovedal, se prešteje v RowsWithoutX.

Napake se prikažejo, namesto da bi se sprožile. Grafikon podatke bere sam (ob odpiranju obrazca, ob menjavi glavnega zapisa), zunaj vsakega klica VBA, ki bi lahko napako prestregel. Napaka pri branju se izriše v grafikonu, shrani v LastError in sporoči z DataLoaded.

Os vrednosti zajame meje. Os Y vedno vključuje vse mejne črte in pasove, zato meja zunaj izmerjenih vrednosti nikoli ni odrezana. Stolpci in palice se začnejo pri 0.

Zgoščen prikaz je označen. Črta z več točkami, kot jih grafikon lahko prikaže (več kot 2.000), se zgosti z metodo Largest-Triangle-Three-Buckets (Steinarsson, 2013), ki ohrani prvo in zadnjo točko ter vrhove; grafikon nato v kotu izpiše „zgoščeno za prikaz“.

Pogodba

Član	Pomen
`RecordSource`	Tabela, poizvedba ali stavek SQL.
`XField`, `YFields`, `SeriesField`	Polje X; polja Y, ločena s podpičji (vsako en niz); ali eno polje Y in polje, katerega vrednosti poimenujejo nize.
`XKind`	`wcxNumber`, `wcxDate` (privzeto), `wcxCategory`.
`ChartType`, `Grouping`	`wctLine` (privzeto), `wctPoint`, `wctColumn`, `wctBar`; `wcgGrouped` (privzeto), `wcgStacked`.
`Aggregate`, `Period`	`wcaNone` (privzeto), `wcaSum`, `wcaAverage`, `wcaCount`, `wcaMin`, `wcaMax`; `wcyNone` (privzeto), `wcyDay`, `wcyWeek` (ISO, od ponedeljka), `wcyMonth`, `wcyQuarter`, `wcyYear`. Skupina brez vsake vrednosti je vrzel, ne 0; `wcaCount` ne potrebuje polja Y.
`Missing`	`wcvGap` (privzeto), `wcvConnect`, `wcvZero`.
`Title`, `YFormat`	Naslov nad grafikonom; številska oblika .NET za oznake Y, na primer `0.0`.
`ShowLegend`, `ShowTrend`, `ShowMarkers`	Legenda pri več kot enem nizu (privzeto vklopljeno); črta trenda za vsak niz; oznake na črtah do 200 točk (privzeto vklopljeno).
`LinkMasterFields`, `LinkChildFields`	Polja ali kontrolniki obrazca in ustrezna polja podatkov, ločeni s podpičji.
`Requery`	Znova prebere podatke.
`AddReference(FromValue, [ToValue], [Caption], [Kind])`	Doda mejno črto ali pas od `FromValue` do `ToValue`; `Kind` je vrsta stanja `wsk*`. Vrne njeno številko.
`ClearReferences`	Odstrani vse mejne črte in pasove.
`SeriesCount`, `SeriesName(i)`, `SeriesVisible(i)`	Nizi, šteti od 0; klik na vnos v legendi preklopi `SeriesVisible`.
`TrendSlope(i)`	Sprememba Y na enoto X (na časovni osi na dan); `Null` pri manj kot dveh točkah.
`TrendReaches(i, Value)`	X (na časovni osi datum), pri katerem trend doseže `Value`; `Null`, če je nikoli ne doseže.
`RowsWithoutX`, `LastError`	Samo za branje.
`ColorScheme`	Kot pri drugih komponentah.
`PrintStyle`	`wpsAutomatic` (privzeto): nizi, meje in pasovi pri tiskanju ali v predogledu tiskanja tudi z vzorci; `wpsColor`: samo barva; `wpsPatterns`: vzorci tudi na zaslonu.

Dogodek	Kdaj
`PointClick(Series, X, Y)`	Klik na točko, stolpec ali palico; X kot datum, besedilo kategorije ali število.
`DataLoaded(Points)`	Podatki so prebrani; tudi po napaki (glejte `LastError`).

Skrbništvo

Namestitev izdanega paketa

Odpravljanje težav

Zaenkrat ni vnosov.

Za razvijalce

Referenčni priročnik API (v angleščini): WklChart

Sorodne teme

WklGauge: ena vrednost glede na njena območja, kjer grafikon prikazuje niz.