Programmierung mit ArcObjectsProgrammierung mit ArcObjects

Frank MünsterFrank Münster

Proseminar Geoinformation IIProseminar Geoinformation II

InhaltInhalt

• 1. Einführung - Was ist ArcObjects?– Was ist die Component Object Model (COM)-Architektur?

• 2. Einbinden von Funktionen in ArcMap– Aufgabe 1: „Custom Toolbar“

• 3. Programmierung– Programmiersprachen / Syntax

– ArcObjects Developer Help

– Programmbeispiel: „Zoom in“

– Aufgabe 2: „Zoom out / Message Box“

Was ist ArcObjects?Was ist ArcObjects?

• ArcObjects ist eine Bibliothek von Klassen, aus der die ArcGis-Software besteht.

• ArcObjects ist nach Microsoft‘s COM (Component Object Model)-Architektur aufgebaut

• Es ist also keine Programmiersprache– Programmierung: Visual Basic, VBA, C++, u.a.

AnwendungsmöglichkeitenAnwendungsmöglichkeiten

• Erweiterung der Software– Hinzufügen neuer Funktionen– Vereinfachen häufig genutzter Vorgänge

(Makros)

Die COM-ArchitekturDie COM-Architektur

• COM ist eine Art „Standard“ oder „Norm“ der Software-Entwicklung.

• Genauer: Es ist eine Client / Server-Architektur– Server stellt Funktionalitäten bereit und der Client nutzt diese.

• COM ermöglicht die Kommunikation zwischen Objekten auf binärer Ebene (Maschinencode)– Vorteil: Objekte können auf binärer Ebene „wiederverwendet“

werden, Weiterentwickler brauchen keinen Zugang zum Quelltext.

– Client muß lediglich wissen, welche Funktionen vom Server zur Verfügung gestellt werden, um sie durch Methodenaufrufe zu nutzen.

Interface-Based-ProgrammingInterface-Based-Programming

• Objekte besitzen Schnittstellen („Interfaces“).

• Kommunikation zwischen den Objekten läuft über ihre Schnittstellen ab.

• Das Interface definiert, was ein Objekt „tun“ kann, die Klasse definiert, wie es „getan“ wird.– Wie es intern „getan“ wird, braucht der Programmierer nicht zu

wissen.

Einbinden von FunktionenEinbinden von Funktionen

• Neue Funktionen müssen irgendwie in die Software integriert werden, um sie nutzbar zu machen.

• Erzeugen einer neuen Toolbar

Erzeugen einer ToolbarErzeugen einer Toolbar

„Customize“ clicken...

Menü: Tools

Erzeugen einer ToolbarErzeugen einer ToolbarToolbars-Karte...

„New...“ clicken...

OK...

Funktionen hinzufügenFunktionen hinzufügenNeue Toolbar

„Commands“-Karte...

Funktionen aus dem Commands-Menü per „Drag & Drop“ auf die neue Toolbar übertragen...

Icons ändernIcons ändernBei offenem Customize-Fenster Rechtsclick auf das Icon...

„Change Button Image...“

Aufgabe 1Aufgabe 1

• Kopieren Sie die Dateien Europa4.mxd und Europa4.mxt aus dem Verzeichnis „V:\F_M“ in Ihr Home-Verzeichnis.

• Öffnen Sie Europa4.mxt (Template) in ArcMap.

• Erzeugen Sie eine Toolbar, speichern Sie diese in „Europa4.mxt“. (Tools-Menü, Customize clicken)

• Fügen Sie die Funktion „Pan“ hinzu, ändern Sie danach das Button-Image.

ProgrammierungProgrammierung

• Durch die COM-Architektur ist die Entwicklung mit ArcObjects relativ unabhängig von der Programmiersprache.

• Programmiert werden kann u.a. mit C++, Visual Basic, VBA, etc.

ProgrammierungProgrammierung

• In das System ist bereits ein Microsoft Visual-Basic-Editor integriert.

• Die hier verwendete Sprache ist jedoch nicht Visual Basic, sondern Visual Basic for ApplicationsVisual Basic for Applications (VBAVBA).

• Der Unterschied: Mit Visual Basic können eigenständige Programme erstellt werden, VBA funktioniert jedoch nur in der entsprechenden Applikation (hier: ArcMap).– Die Syntax ist jedoch die gleiche wie bei Visual Basic.

Visual Basic - Syntax (1)Visual Basic - Syntax (1)Sub Prozedur()

‘Programmtext

End Sub

„Sub“ kennzeichnet den Beginn einer Prozedur oder eines Programms, „End Sub“ das Ende. Mit dem Apostroph lassen sich Kommentare markieren.

Dim i As Integer „Dim ... As ...“ ist die Variablen-deklaration in VBA und VB. Die Variable „i“ wird als ganze Zahl eingeführt (Integer).

Visual Basic - Syntax (2)Visual Basic - Syntax (2)

Set pDoc = ThisDocument Zeiger:

Anstatt der üblichen Variablen-zuweisung ohne „Set“ wird hier in der Variablen „pDoc“ ein „Zeiger“ auf das Objekt „ThisDocument“ gespeichert.

If a<b Then

...

End If

Statt den aus Java bekannten geschweiften Klammern werden in VB/ VBA die Kommandos einer If-Anwei-sung duch „Then“ und „End If“ markiert.

Message BoxMessage Box

Um mit dem Benutzer in Dialog zu treten, ist die aus Visual Basic stammende „Message Box“ ein wichtiges und einfach anzuwendendes Hilfsmittel.

Message Box - BeispielMessage Box - Beispiel

Dim Antwort As Integer

Antwort = MsgBox(“Meldung", vbYesNo, “Titel")

If Antwort = vbYes Then

...

End If

Text in der Box

Art der Box

Text in der Titelzeile

Erzeugen eines Makro (1)Erzeugen eines Makro (1)

„Tools“-Menü...

„Macros...“ clicken

Erzeugen eines Makro (2)Erzeugen eines Makro (2)„Macro name“ eintragen...

„Create“ clicken...

•Nach diesen Schritten öffnet sich automatisch der Visual Basic-Editor und man kann den Programmtext schreiben.

Erzeugen eines Makro (3)Erzeugen eines Makro (3)

Nach dem Erzeugen: Makro ist unter Customize / Commands in der Kategorie „Macros“ verfügbar.

Von hier aus kann das Makro nun per „Drag & Drop“ in eine „Custom Toolbar“ integriert werden.

ArcObjects Developer HelpArcObjects Developer Help

Programme> Gis> ArcGIS> ArcObjects Developer Help

ArcObjects Developer HelpArcObjects Developer Help

ArcObjects Developer HelpArcObjects Developer Help

• Detaillierte Beschreibung aller Klassen, Interfaces, Methoden usw.

• Teilweise mit Programmbeispielen

• Wichtig zum Verständnis vorhandener Quelltexte

• Nützlich um neue Methoden und Möglichkeiten des Systems kennenzulernen.

ProgrammbeispielProgrammbeispielSub NeuerZoom()

Dim pDoc As IMxDocument

Dim pEnv As IEnvelope

Set pDoc = ThisDocument

Set pEnv = pDoc.ActiveView.Extent

pEnv.Expand 0.5, 0.5, True

pDoc.ActiveView.Extent = pEnv

pDoc.ActiveView.Refresh

End Sub

Aufgabe 2Aufgabe 2• Unter „V:\F_m“ liegt das vorherige Beispiel als

„Macro.txt“ vor. Erzeugen Sie ein Macro und kopieren Sie das Beipiel hinein.

• Integrieren Sie das Makro in Ihre Custom-Toolbar.

• Der Programmtext soll nun so verändert werden, daß das Makro zunächst einzoomt, dann auf Anfrage hin (über die Message Box) wieder zurückzoomt.– Dim Antwort As Integer

– Antwort = MsgBox(“Meldung", vbYesNo, “Titel")

– If Antwort = vbYes Then ...

• Tip: Um herauszufinden, wie man herauszoomt, verwenden Sie ArcObjects Developer Help (Expand-Methode)!