Übungsbeispiel 1 / Zoomer

Transkript

1 Übungsbeispiel 1 / Zoomer Motivation Oft werden in einem großen Bearbeitungsgebiet detaillierte Informationen dargestellt. Die Gesamtansicht läßt selbst bei hoher Auflösung und Monitor > 17 wesentliche Informationen nur noch erahnen also wird beim Betrachten der Inhalte fleißig von den Zoom- und Panfunktionen Gebrauch gemacht. Im Laufe der Bearbeitung kristallisieren sich rasch einige Kartenausschnitte heraus, die immer wieder in ähnlichen Darstellungsmaßstäben angezeigt werden und ebenso schnell beginnt das wiederholte Zoomen und Zurechtrücken an den Nerven zu zehren. Alles spricht in einem solchen Projekt für ein Werkzeug, mit dessen Hilfe Ausschnitte benannt werden können und über die Namen auch unmittelbar zugänglich sind. In der View könnte das in etwa so aussehen: Auswahl des darzustellenden Ausschnittes via Message Box Überblick über vorhandene benannte Kartenausschnitte im Hintergrund In der Buttonleiste wären einige Knöpfe für die Steuerung der Namensvergabe, der Auswahl von Ausschnitten, etc. ganz zweckmäßig und mit wenig (Programmier-)Aufwand ist ein lästiges Problem im Umgang mit großflächigen Projekten behoben. Welche Teilaufgaben sind zu lösen? aktiven Bildschirmausschnitt mit Bezeichnung versehen (=neuer Listeneintrag) vorhandenen benannten Ausschnitt (aus der Liste) löschen Ausschnitt auswählen und entsprechenden Bereich im Display der View anzeigen Übersicht über die vorhandenen Ausschnitte darstellen (siehe Abb. im Hintergrund) 1. Aktiven Bildschirmausschnitt mit Bezeichnung versehen Voraussetzungen eine View ist geöffnet und enthält min. ein Thema mit Projektdaten (kann ggf. im Script überprüft werden / wir gehen der Einfachheit halber davon aus, daß es genau so ist!) der in der Folge zu benennende Ausschnitt wurde bereits mittels Zoom- und Panfunktionen ausgewählt Abgrenzung (Extent) des aktiven Ausschnitts aview.getdisplay adisplay.returnextent gibt den rechteckigen sichtbaren Übungsbeispiel 1 / Zoomer Seite 1 von 5

2 Verwaltung von Ausschnittnamen und Abgrenzungen (Extents) mittels Dictionary Dictionary.Make adict.add (akey, avalue) adict.set(akey, avalue) Ausschnitt zurück (arect) Skript S73 ff. jedem AusschnittNamen (=Key) ist ein Ausschnitt (=Value) zugeordnet Gedächtnis für das Dictionary mittels ObjectTags theproject.setobjecttag Skript S48 ff. Anbindung des ObjectTag an das Projekt => die Ausschnitte stehen im gesamten Projekt zur Verfügung Abgrenzung (Extent) des aktiven Ausschnitts ermitteln ObjectTag für das Projekt bereits vorhanden: j/n nein: neuen ObjectTag erstellen, Dictionary anlegen (Make) Benutzerinteraktion: Angabe einer Bezeichnung für den gewählten Ausschnitt via MsgBox Eingegebene Bezeichnung zu den im Dictionary vorhandenen hinzufügen (Add) + Erfolgskontrolle über aboolvar = adict.add (akey, avalue) / (siehe ) kein Erfolg: Bezeichnung existiert (=Key) bereits => überschreiben der bestehenden Bezeichnung j/n 2. Vorhandenen benannten Ausschnitt löschen Aus der Liste vorhandener benannter Kartenausschnitte sollte einer oder mehrere ausgewählt werden können und nach einer Sicherheitsabfrage (z.b. in der Form: Sind Sie wirklich sicher, daß sie soundsoviele Ausschnitte löschen wollen? ) aus dem Dictionary gelöscht werden. Voraussetzungen (UpdateScript) es muß bereits mindestens ein benannter Ausschnitt existieren d.h. entweder jedes Mal prüfen oder eine Lösung über UpdateScripts, wobei der Button für die LöschFunktion nur angeklickt werden kann, wenn benannte Ausschnitte vorhanden sind, also ein Dictionary als ObjectTag am Projekt hängt (siehe Buttons aktivieren / deaktivieren). Auswahl mehrerer Bereiche MsgBox.MultiListAsString (alist, amsg, atitle) Dictionary Keys an Liste ausgeben Einträge mit FOR EACH-Schleife aus Dictionary löschen alist = adict.returnkeys adict.remove(akey) Skript S73 / Requests für Dictionaries Skript S73 / Requests für Dictionaries Liste der vorhandenen benannten Ausschnitte aus Dictionary generieren eventuell alphabetisch sortieren Message Box zur Auswahl von zu löschenden Einträgen für alle ausgewählten -> entfernen aus Dictionary Übungsbeispiel 1 / Zoomer Seite 2 von 5

3 3. Ausschnitt auswählen und entsprechenden Bereich anzeigen Das ist das zentrale Element der Anwendung. Nach der Auswahl genau eines benannten Ausschnittes aus der Liste der vorhandenen soll der damit verknüpfte Kartenausschnitt im Display der View erscheinen. Voraussetzungen es muß bereits mindestens ein benannter Bereich existieren (siehe vorhandenen benannten Ausschnitt löschen und Buttons aktivieren/deaktivieren -> UpdateScript) einen Value aus dem Dictionary über den Key ansprechen einen gewählten Ausschnitt im Display der View anzeigen anobject = adict.get(akey) adisplay.setextent(arect) ; Key = Bezeichnung Value = Extent (vom Typ Rect = Rechteck) arect entspricht dem Ausschnitt aus dem DictionaryValue (Extent) 4. Übersicht über die vorhandenen Ausschnitte darstellen Die graphischer Darstellung der äußeren Umrandung vorhandener Kartenausschnitte gemeinsam mit der entsprechenden Bezeichnung im Dispay einer View erhöht die Qualität der Anwendung beträchtlich das ist bereits fast echter Luxus! Steigern läßt sich der Luxus z.b. wenn der/die Benutzer/-in wählen kann, welche Ausschnitte (im Gegensatz zu alle Ausschnitte ) in der Übersicht abgebildet werden sollen [!]. Der Weg dorthin führt über GraphicShapes, GraphicText und GraphicGroups dazu einige kurze Bemerkungen: Graphiken sind wie die nachfolgende Abbildung des ObjectModels zeigt eine große Klasse von Elementen, deren gemeinsames Merkmal ist, daß sie in Layouts oder Views dargestellt werden können. Im Gegensatz zu geographisch-thematischen Objekten, die innerhalb einer View als thematische Schichten (Themes) organisiert sind schweben Graphics gleichsam im Display einer (oder mehrerer) View(-s). Für unsere kleine Anwendung werden GrapicShapes in Form von Rechtecken (zeigen die Abgrenzung des Ausschnittes) und GraphicText (Bezeichnung des Ausschnittes) benötigt. Jeweils ein Rechteck und der beschreibende Text werden gruppiert also zu einer GraphicGroup zusammengefaßt und bilden dadurch ein einzelnes Element der Übersicht. Zugriff auf die Graphics in Avenue gibt die GraphicList, welche sämtliche mit der View oder dem Layout verknüpften Graphiken enthält. Die für Listen geläufigen Befehle, wie.add,.count,.stehen auch für GraphicLists zur Verfügung. Darüber hinaus gibt es auch spezielle GraphicList-Befehle siehe und Skript S67 ff/ Anzeigen von Graphiken in einem Dokument. Übungsbeispiel 1 / Zoomer Seite 3 von 5

4 Voraussetzungen es muß bereits mindestens ein benannter Bereich existieren (siehe vorhandenen benannten Ausschnitt löschen und Buttons aktivieren/deaktivieren -> UpdateSkript) Liste der vorhandenen Graphics ausgeben ein Rechteck im Ausmaß des Extents erzeugen aview.getgraphics GraphicShape.Make(anExtent) Skript S67 / Anzeigen von Graphiken in einem Dokument Skript S67 / Anzeigen von Graphiken in einem Dokument einen GraphicText erzeugen GraphicText.Make (astring, apoint) apoint: vorzugsweise links unten im Rechteck - siehe arect.returnorigin eine GraphicGroup anlegen und Elemente (Rechteck und Text) hinzufügen eine GraphicGroup zur Liste der Graphiken hinzufügen GraphicGroup.Make agraphicgroup.add(agraphic) agraphiclist.add( agraphicgroup ) Liste der vorhandenen benannten Ausschnitte aus Dictionary generieren Möglichkeit zur Auswahl bieten über Mehrfachauswahl in MsgBox für alle gewählten Einträge den Extent ermitteln, das entsprechende Rechteck und den zugehörigen Text generieren, beide zu einer Gruppe verbinden (d.h. leere Group erzeugen und Elemente hinzufügen), an die Liste der vorhandenen Graphics hängen Übungsbeispiel 1 / Zoomer Seite 4 von 5

5 5. Buttons aktivieren/deaktivieren - UpdateScript Motivation Löschen, Anzeigen und Zoomen von/zu benannten Ausschnitten soll nur möglich sein, wenn mindestens ein solcher Ausschnitt bereits existiert. Eine entsprechende Überprüfung am Beginn der jeweiligen Scripts erübrigt sich durch den Einsatz eines Update-Scripts. Mit dessen Hilfe werden die korrespondierenden Buttons enabled bzw. disabled. Ablauf - UpdateScript geprüft wird am besten das Vorhandensein eines ObjectTags (hier: am Projekt) analog zum Beispiel auf S 48 ff. im Skript in Abhängigkeit davon werden die Buttons gesetzt: self.setenabled(aboolvar) / siehe Skript S51 ff. Übungsbeispiel 1 / Zoomer Seite 5 von 5