VARCHART Xtree
Total Page:16
File Type:pdf, Size:1020Kb
VARCHART XTree ActiveX Edition 5.2 Benutzer- und Referenzhandbuch VARCHART XTree ActiveX Edition Version 5.2 Benutzerhandbuch NETRONIC Software GmbH Pascalstraße 15 52076 Aachen Deutschland Tel: +49 (0) 2408 141-0 Fax: +49 (0) 2408 141-33 E-Mail [email protected] www.netronic.de © Copyright 2020 NETRONIC Software GmbH Alle Rechte vorbehalten. Die Informationen im vorliegenden Benutzerhandbuch werden ohne Rücksicht auf einen eventuellen Patentschutz veröffentlicht. Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt. Bei der Zusammenstellung von Texten und Abbildungen wurde mit größter Sorgfalt vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Herausgeber und Autoren können für fehlerhafte Angaben und deren Folgen weder eine juristische Verantwortung noch irgendeine Haftung übernehmen. Das illegale Kopieren und Vertreiben dieses Produktes stellt einen Diebstahl geistigen Eigentums dar und wird von NETRONIC Software GmbH strafrechtlich verfolgt. Alle Rechte vorbehalten, auch die der fotomechanischen Wiedergabe und der Speicherung in elektronischen Medien. Die gewerbliche Nutzung der in diesem Buch gezeigten Abbildungen ist nicht zulässig. Microsoft Windows, Microsoft Explorer, Microsoft Visual Basic und Microsoft Visual Studio sind Warenzeichen der MICROSOFT Corp. Bearbeitungsstand: 27 April 2020 Inhaltsverzeichnis 3 Inhaltsverzeichnis 1 Einleitung 9 1.1 Allgemeines zu VARCHART XTree 9 1.2 Technische Voraussetzungen 12 1.3 Installation 13 1.4 Auslieferung 14 1.5 Datenaustausch mit VARCHART XTree 15 1.6 VARCHART ActiveX in Visual Studio 6.0 oder 7.0 mit Visual C++/MFC 18 1.7 VARCHART ActiveX in HTML-Seiten 21 1.8 Unterstützung und Beratung 27 2 Tutorium 29 2.1 Überblick 29 2.2 VARCHART XTree zur Werkzeugsammlung hinzufügen 30 2.3 VARCHART XTree in einem Formular plazieren 31 2.4 VARCHART XTree automatisch skalieren 34 2.5 Schnittstelle einrichten 35 2.6 Der erste Lauf 37 2.7 Daten aus einer Datei einlesen 40 2.8 Markierung von Knoten festlegen 42 2.9 Filter für Knoten festlegen 43 2.10 Knotenaussehen festlegen 45 2.11 Knotenformate festlegen 49 2.12 Das Aussehen von Verbindungen festlegen 52 2.13 Baumstruktur festlegen 53 2.14 Vertikale und horizontale Anordnung von Baumstrukturen 55 2.15 Baumstrukturen kollabieren und expandieren 59 2.16 TreeView-Stil 63 2.17 Diagramm drucken 66 VARCHART XTree ActiveX Edition 5.2 4 Inhaltsverzeichnis 2.18 Diagramm exportieren 67 2.19 Konfigurationseinstellungen speichern 68 3 Wichtige Konzepte 69 3.1 Boxen 69 3.2 Daten 73 3.3 Datentabellen 74 3.4 Datumsangaben und Zeitumstellung 82 3.5 Ereignisse 84 3.6 Filter 85 3.7 Grafikformate 87 3.8 Horizontale/vertikale Anordnung 92 3.9 Knoten 97 3.10 Knotenaussehen 101 3.11 Knotenformat 103 3.12 Kollabieren und Expandieren 106 3.13 Komplettansicht (World View) 109 3.14 Legendenansicht (Legend View) 112 3.15 Maximale Höhe des Baum-Diagramms 114 3.16 OLE Drag & Drop 115 3.17 Schreiben von PDF-Dateien 119 3.18 Sprachanpassung von Textausgaben 121 3.19 Statuszeilentext 122 3.20 Struktur 123 3.21 Tooltips zur Laufzeit 125 3.22 TreeView-Stil 126 3.23 Unicode-Zeichen 127 3.24 Vertikale Ebenen 128 3.25 Zuordnungstabellen 130 4 Eigenschaftenseiten und Dialogfelder 135 4.1 Allgemeines 135 4.2 Eigenschaftenseite "Außenbereich" 137 VARCHART XTree ActiveX Edition 5.2 Inhaltsverzeichnis 5 4.3 Eigenschaftenseite "Allgemeines" 139 4.4 Eigenschaftenseite "Layout" 140 4.5 Eigenschaftenseite "Knoten" 142 4.6 Eigenschaftenseite "Zusätzliche Ansichten" 146 4.7 Eigenschaftenseite "Objekte" 150 4.8 Dialogfeld "Datentabellen verwalten" 152 4.9 Dialogfeld "Filter verwalten" 155 4.10 Dialogfeld "Filter bearbeiten" 157 4.11 Dialogfeld "Zuordnungstabellen verwalten" 161 4.12 Dialogfeld "Zuordnungstabelle bearbeiten" 163 4.13 Dialogfeld "Zuordnung einstellen" 166 4.14 Dialogfeld "Knotenaussehen verwalten" 168 4.15 Dialogfeld "Knotenaussehen bearbeiten" 172 4.16 Dialogfeld "Boxen verwalten" 176 4.17 Dialogfeld "Box bearbeiten" 179 4.18 Dialogfeld "Boxformate/Knotenformate verwalten" 181 4.19 Dialogfeld "Boxformat bearbeiten" 183 4.20 Dialogfeld "Knotenformat bearbeiten" 186 4.21 Dialogfeld "Linienattribute bearbeiten" 191 4.22 Dialogfeld "Musterattribute bearbeiten" 192 4.23 Dialogfeld "Texte, Grafiken und Legende festlegen" 193 4.24 Dialogfeld "Legendenattribute" 197 4.25 Dialogfeld "Lizenzierung" 199 4.26 Dialogfeld "Lizenzinformationen anfordern" 201 5 Benutzerschnittstelle 203 5.1 Übersicht 203 5.2 Navigation im Diagramm 204 5.3 Zoomen 205 5.4 Knotendaten bearbeiten 207 5.5 Knoten erzeugen 209 5.6 Knoten markieren 212 5.7 Knoten löschen, ausschneiden, kopieren und einfügen 213 VARCHART XTree ActiveX Edition 5.2 6 Inhaltsverzeichnis 5.8 Knoten mit seinem Teilbaum umhängen 214 5.9 Teilstrukturen horizontal und vertikal anordnen 217 5.10 Teilstrukturen kollabieren und expandieren 220 5.11 Seite einrichten 222 5.12 Druckvorschau 226 5.13 Kontextmenü für das Diagramm 229 5.14 Kontextmenü für Knoten 232 5.15 Kontextmenü für die Legende 235 6 Häufig gestellte Fragen 237 6.1 Wie kann das Steuerelement neu lizenziert werden? Was ist bei Problemen mit der Lizenzierung zu tun? 237 6.2 Wie kann erreicht werden, dass eine veränderte ini-Datei des VARCHART ActiveX-Steuerelementes verwendet wird? 238 6.3 Was müssen Benutzer von Borland Delphi beim Upgrade auf eine neue Version von VARCHART XTree tun? 239 6.4 Wieso können Knoten u. U. nicht interaktiv erzeugt werden? 240 6.5 Wie verhindert man das interaktive Erzeugen von Knoten? 241 6.6 Wie lassen sich die Standard-Kontextmenüs abschalten? 242 6.7 Was ist bei Problemen mit dem Drucken zu tun? 243 6.8 Wie lässt sich die Performance verbessern? 244 6.9 Fehlermeldungen 245 7 API Referenz 247 7.1 Objekttypen 247 7.2 DataObject 249 7.3 DataObjectFiles 255 7.4 VcBorderArea 258 7.5 VcBorderBox 259 7.6 VcBox 266 7.7 VcBoxCollection 278 7.8 VcBoxFormat 284 7.9 VcBoxFormatCollection 289 7.10 VcBoxFormatField 295 VARCHART XTree ActiveX Edition 5.2 Inhaltsverzeichnis 7 7.11 VcDataDefinition 305 7.12 VcDataDefinition 306 7.13 VcDataDefinitionTable 307 7.14 VcDataRecord 312 7.15 VcDataRecordCollection 317 7.16 VcDataTable 324 7.17 VcDataTableCollection 327 7.18 VcDataTableField 333 7.19 VcDataTableFieldCollection 339 7.20 VcDefinitionField 344 7.21 VcFilter 348 7.22 VcFilterCollection 354 7.23 VcFilterSubCondition 360 7.24 VcLegendView 364 7.25 VcMap 372 7.26 VcMapCollection 378 7.27 VcMapEntry 385 7.28 VcNode 393 7.29 VcNodeAppearance 404 7.30 VcNodeAppearanceCollection 426 7.31 VcNodeCollection 432 7.32 VcNodeFormat 435 7.33 VcNodeFormatCollection 440 7.34 VcNodeFormatField 446 7.35 VcPrinter 459 7.36 VcRect 476 7.37 VcTree 479 7.38 VcWorldView 579 8 Index 589 VARCHART XTree ActiveX Edition 5.2 Einleitung 9 1 Einleitung 1.1 Allgemeines zu VARCHART XTree Die interaktive Komponente VARCHART XTree ist ein Element der Pro- duktgruppe VARCHART-X. Diese Produktgruppe beinhaltet ActiveX- Steuerelemente, die mit der VARCHART-Funktionsbibliothek der NETRONIC Software GmbH entwickelt wurden (VARCHART XGantt, VARCHART XNet, VARCHART XTree). Mit VARCHART XTree erhalten Sie in wenigen Minuten die erste grafische Darstellung Ihrer Daten. Sie können VARCHART XTree durch seine vielfältigen Gestaltungsmöglichkeiten individuell an Kundenwünsche anpassen. Mit VARCHART XTree können Sie logische Daten in Form von Baum- Diagrammen visualisieren, editieren, exportieren und drucken. VARCHART XTree bietet sich für die Darstellung von hierarchischen Strukturen, wie z.B. Organigrammen, Dateisystemen oder Gliederungen allgemein an. Zusätzlich zur herkömmlichen Baumdarstellung kann auch eine dem Verzeichnisbaum im Microsoft Explorer ähnliche Darstellung angezeigt werden (TreeView- Stil). Daten können über Dateien oder über die Programmierschnittstelle (API) eingelesen und geschrieben werden. Interaktiv können Sie dann neue Daten einfügen, ändern oder löschen. Das Datenformat der einzelnen VARCHART-ActiveX-Komponenten kann untereinander kompatibel gemacht werden (abhängig von den Einstellungen in der jeweiligen Datentabelle), so dass ein Datenaustausch oder eine vernetzte Benutzung innerhalb einer Anwendung möglich ist. Der genaue Aufbau des Datenformats muss zur Entwurfszeit im VARCHART ActiveX-Steuerelement festgelegt werden. Das Einstellen der Eigenschaften des VARCHART-ActiveX-Steuerelements kann zur Entwurfszeit bequem über Eigenschaftenseiten oder zur Laufzeit dynamisch über die Programmierschnittstelle erfolgen. Durch die Vielzahl der zur Verfügung gestellten Ereignisse kann in das Standardverhalten der Interaktionen eingegriffen werden. VARCHART XTree ActiveX Edition 5.2 10 Einleitung Leistungsmerkmale Knoten können durch die Zuweisung verschiedener Knotenaussehen unterschiedlicher Priorität frei gestaltet werden. Grafische Attribute können datengesteuert über Filter zugeordnet werden. (Z. B. können alle Knoten einer bestimmten Abteilung in Gelb dargestellt werden.) Über sog. Knotenformate kann die grafische Gestaltung der Knoten mit den darin enthaltenen Daten sehr flexibel festgelegt werden. Benutzerinteraktionen wie das Anlegen, Löschen und Verschieben von Knoten sind verfügbar. Knoten können im TreeView-Stil angeordnet werden. Dabei werden vertikale Ebenen wie in TreeView-Controls mit Plus- oder Minus- Zeichen dargestellt. Ein Mausklick auf eins der beiden Zeichen überführt den daneben stehenden Knoten in den jeweils anderen Kollabierzustand. Bei vertikaler Anordnung können Sie die Gesamthöhe eines Baum- Diagramms (in Zeilen) begrenzen. Sie können die Baum-Diagramme durch die Kombination horizontal und vertikal