Objekt TrendsView

Celý obraz obsahující tento grafický prvek pro prohlížení trendů včetně pomocných tlačítek atd. lze jednoduše vytvořit - viz Předkonfigurace "Obraz s prohlížečkou trendů". Grafický vzhled prohlížeče určuje vlastnost ViewMode - data jsou zobrazena buď formou tabulky nebo graficky - 2-rozměrně se 2-(3-)rozměrně zobrazenými průběhy hodnot. Pro nastavení vlastností tabulkového módu slouží vlastnosti začínající prefixem Table, např. TableTimeBgColor,... Průběh jedné trendované veličiny je reprezentován objektem typu tvTrend. Trendovaných veličin (objektů typu tvTrend) může být v prohlížeči více a lze tedy na jedné grafické ploše pozorovat více průběhů. Objekt typu tvTrend může být připojen ke zdroji hodnot (např. metodou tvTrend.Connect) a v tom případě si prohlížeč automaticky dočítá data ze zdroje - ze serveru trendů. Serverem trendů je PROMOTIC aplikace, jenž uchovává data pomocí objektu PmTrend. Trendovaná veličina v prohlížeči však nemusí být připojena k serveru a pak lze datové body tvořící průběh veličiny nastavit voláním metod objektu typu tvPoints, např. tvPoints.AddPoints, viz příklad Příklad na zobrazení matematických funkci pomocí prohlížečky trendů. V tomto případě lze také využít událost onReadData pro dynamické plnění metodou AddPoints (viz uvedený příklad) Objekt typu tvPoints je v obou případech (připojený nebo nepřipojený objekt tvTrend) držitelem datových bodů (ať už zadaných metodou tvPoints.AddPoints nebo dočtených ze serveru). Průběh jednoho trendu je zobrazován nástroji pro kreslení - jedním nebo více objekty typu tvGraph. Objekty tvGraph se vytvářejí v objektu tvTrend a slouží k definici typu čáry (tlouštky, barvy, typu atd) pro grafický mód nebo fontu, barvy písma atd pro tabulkový mód. Každý objekt tvTrend má přinejmenším jeden základní objekt tvGraph a přístup k němu je pomocí vlastnosti tvTrend.GraphDefault. Objekt tvTrend však může mít více objektů tvGraph (každý může být nakonfigurován např. na jinou barvu), přidávají se voláním metody tvTrend.AddGraph a v tom případě u takových objektů je nutno definovat, ve kterých časových úsecích se kreslí kterým objektem, viz parametr sValidityFce metody AddGraph. Pomocí objektů tvGraph tak lze např. v grafickém módu zobrazit grafický průběh veličiny, která bude standardně zelená, ale v oblasti překročení zadané limitní hodnoty bude tato křivka červená. V tabulkovém módu lze pomocí objektů tvGraph hodnoty překračující limitu zobrazit barevně odlišně a také jiným fontem. Viz způsob vykreslování tvTrend a tvGraph. Průběhy trendů jsou vykreslovány v pořadí vytváření objektů tvTrend (např. metodami AddTrend, InsertTrend). V pořadí první objekt je vykreslen nedříve a nejvíce nahoře je vykreslen průběh aktivního objektu Trend (Aktivní trend je ten z objektů v kontejneru, jehož index v poli je roven hodnotě TrendActive). Rozsah časové (X-ové) osy prohlížeče určují vlastnosti TimeMin a TimeMax, rozsah hodnotové (Y-ové) osy vlastnosti aktivního trendu tvTrend.ValueMin a tvTrend.ValueMax. V prohlížeči lze zapnout automatické dočítání nejnovějších hodnot průběhů trendů a automatický posun časové osy (časového sloupce v tabulkovém módu) nastavením vlastnosti Autoscroll na True. Periodu dočítání určuje vlastnost AutoscrollRate, způsob dočítání a způsob posunu časové osy vlastnost AutoscrollType.

Změnit nastavení stupnice časové či hodnotové lze v objektech ScaleTime nebo ScaleValue, změnit nastavení vlastností mřížky lze v objektech GridTime nebo GridValue.

Samotný prohlížeč neobsahuje hlavičku se seznamem aktuálně vytvořených objektů tvTrend. V PROMOTIC aplikaci lze použít tento ActiveX objekt samostatně jako grafický prvek (v nabídce prvků prvek Prohlížeč trendů) nebo lze použít grafický prvek Prohlížeč trendů s hlavičkou, což je komplexnější prvek obsahující tento ActiveX objekt a navíc i hlavičku. Prohlížeč lze konfigurovat v editoru obrazů v dialogu konfigurace grafického prvku tlačítkem Vlastnosti.... Pro prohlížení v Internet Exploreru lze použít buď HTML stránky dodané se systémem PROMOTIC (tyto obsahují i hlavičku) nebo libovolné nově uživatelsky vytvořené. Viz příklad Příklad na vytvoření klient/server trendů.

Aktuální nastavení vlastností prohlížeče včetně seznamu vytvořených a k serveru připojených objektů tvTrend lze ukládat do textového konfiguračního XML souboru a případně načítat zpět pomocí metod SaveCfg, LoadCfg.

Obsah prohlížeče lze tisknout např. metodou SaveToHtm pomocí s prohlížečem dodaných HTML stránek ať už ve formě grafické či tabulky. Tyto HTML stránky lze zkopírovat, dle potřeby upravit a použít místo originálních dodaných se systémem.

Metodami DlgTrends a tvTrend.DlgProperties lze dynamicky za běhu runtime měnit seznam aktuálně zobrazovaných průběhů trendů

Ovládání dostupné pomocí myši nebo klávesnice (při ovládání z klávesnice musí mít prvek fokus, který získá např. kliknutím myši nebo přesunem pomocí tabelátoru): Hierarchie podobjektů: