ADOBE Dreamweaver API CS5 User Manual [de]

ADOBE® DREAMWEAVER® CS5 & CS5.5

API-Referenzhandbuch

Rechtliche Hinweise

Rechtliche Hinweise

Rechtliche Hinweise finden Sie unter http://help.adobe.com/de_DE/legalnotices/index.html.

Letzte Aktualisierung 22.6.2011

Inhalt

Kapitel 1: Einführung

Erweiterungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Erweitern von Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Weitere Ressourcen für das Programmieren von Erweiterungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Neue Funktionen in Dreamweaver CS5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

In diesem Handbuch verwendete Konventionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Kapitel 2: API für Datei-E/A

Konfigurationsordner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Funktionen der API für Datei-E/A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Kapitel 3: HTTP-API

Funktionsweise der HTTP-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Funktionen der HTTP-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Kapitel 4: API für Design Notes

Funktionsweise von Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

JavaScript-API für Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

C-API für Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

iii

Kapitel 5: Fireworks-Integration

FWLaunch-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Kapitel 6: Flash-Integration

API für Flash-Objekte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Funktionen für Flash-Bedienfelder und Flash-Dialogfelder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Kapitel 7: Photoshop-Integration

Funktionsweise von Smart Objekten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

API für Smart Objekte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Kapitel 8: API für Datenbanken

Funktionsweise der API für Datenbanken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Funktionen für Datenbankverbindungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Funktionen für den Datenbankzugriff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Kapitel 9: API für Datenbankverbindungen

Auswählen eines neuen Verbindungstyps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Erstellen eines neuen Verbindungstyps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

API für Verbindungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Generierte Include-Datei . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Definitionsdatei für den Verbindungstyp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

Inhalt

Kapitel 10: API zur Integration der Quellcodeverwaltung

Funktionsweise der Integration der Quellcodeverwaltung in Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Hinzufügen von Quellcode-Verwaltungssystemfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Erforderliche Funktionen der API zur Integration der Quellcodeverwaltung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Optionale Funktionen der API zur Integration der Quellcodeverwaltung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Enabler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Kapitel 11: Anwendung

Funktionen für externe Anwendungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Globale Anwendungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Bridge-Kommunikationsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Kapitel 12: Arbeitsbereich

Verlaufsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Funktionen zum Einfügen von Objekten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Tastaturfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Menüfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

Ergebnisfenster-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Umschaltfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Symbolleistenfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Fensterfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Funktionen für die Informationsleiste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Funktionen für zugehörige Dateien . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Funktionen für die vertikal geteilte Ansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Funktionen für das Ausblenden von Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Symbolleistenfunktionen der Codeansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Farbfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

iv

Kapitel 13: Site

Berichtfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Site-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

Kapitel 14: Dokument

Konvertierungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Befehlsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Dateibearbeitungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Globale Dokumentfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

Pfadfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Auswahlfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

Stringbearbeitungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Übersetzungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

XSLT-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

Kapitel 15: Seiteninhalt

Funktionen für das Bedienfeld „Elemente“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

Verhaltensfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Zwischenablagefunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

Bibliotheks- und Vorlagenfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

Inhalt

Funktionen für das Bedienfeld „Codefragmente“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

Bearbeitungsfunktionen für Spry-Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Einfügen von Spry-Widget-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

Funktionen für die Browserkompatibilitätsprüfung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

Kapitel 16: Dynamische Dokumente

Funktionen für Serverkomponenten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

Datenquellenfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Extension Data Manager-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Live Data-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

Live-Ansichtsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

Serververhalten-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

Servermodell-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Kapitel 17: Entwurf

CSS-Layoutfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

Funktionen für Frames und Framesets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Funktionen für Ebenen und Imagemaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

Funktionen für die Layout-Umgebung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

Funktionen für die Layoutansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

Funktionen für die Auflösungsverwaltung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

Medienabfrage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

Zoom-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

Funktionen und Eigenschaften für Hilfslinien . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435

Funktionen zum Bearbeiten von Tabellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

v

Kapitel 18: Code

Codefunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

Funktionen zum Suchen und Ersetzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457

Allgemeine Bearbeitungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

Druckfunktion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479

Funktionen für den Quick Tag Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480

Funktionen für die Codeansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

Funktionen für die Live-Codeansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

Funktionen für Tag-Editor und Tag-Bibliothek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501

Kapitel 19: Enabler

Enabler-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

Letzte Aktualisierung 22.6.2011

Kapitel 1: Einführung

Im Adobe Dreamweaver CS5 API-Referenzhandbuch werden die Anwendungsprogrammierschnittstellen (APIs)
beschrieben. Mit APIs können Sie während der Entwicklung von Adobe® Dreamweaver® CS5-Erweiterungen und
beim Hinzufügen von Programmcode zu Dreamweaver-Webseiten verschiedene unterstützende Aufgaben ausführen.
Eine der wichtigsten APIs ist die JavaScript-API, die Zugriff auf die meisten Kernfunktionen von Dreamweaver bietet.
Unter die Kernfunktionen von Dreamweaver fallen generell alle menügesteuerten Aktionen. Hinzu kommen
verschiedene Dienstprogramm-APIs für gängige Aufgaben wie das Schreiben und Lesen von Dateien, die
Datenübertragung mit HTTP und die Kommunikation mit Fireworks und Flash.

Mit der umfangreichen JavaScript-API können Sie vielfältige kleinere Aufgaben erledigen. Dabei handelt es sich in der
Mehrzahl um Arbeitsschritte, die ein Benutzer i. d. R. beim Erstellen oder Bearbeiten von Dreamweaver-Dokumenten
ausführt. Diese API-Funktionen sind nach den betreffenden Komponenten der Dreamweaver-Benutzeroberfläche
gruppiert. So umfasst die JavaScript-API beispielsweise Arbeitsbereichfunktionen, Dokumentfunktionen,
Designfunktionen usw. Mit den API-Funktionen können Sie einige der folgenden Aufgaben und vieles mehr
ausführen:

• Öffnen neuer Dokumente

• Abrufen oder Festlegen einer Schriftgröße

• Suchen nach einem Suchstring im HTML-Code

• Sichtbarmachen von Symbolleisten

1

Erweiterungen

In diesem Buch wird davon ausgegangen, dass Sie Kenntnisse in Dreamweaver, HTML, XML, der JavaScript­Programmierung und eventuell der Programmierung in C haben. Wenn Sie Erweiterungen zum Erstellen von
Webanwendungen programmieren, sollten Sie auch mit serverbasierten Skripts auf mindestens einer Plattform
vertraut sein, z. B. Active Server Pages (ASP), ASP.NET, PHP: Hypertext Preprocessor (PHP), Adobe ColdFusion oder
Java Server Pages (JSP).

Erweitern von Dreamweaver

Weitere Informationen über das Dreamweaver-Framework und die API zur Erstellung von Dreamweaver­Erweiterungen finden Sie im Handbuch Dreamweaver erweitern. Im Handbuch Dreamweaver erweitern werden die
API-Funktionen beschrieben, die Dreamweaver zur Implementierung von Objekten, Menüs, schwebenden
Bedienfeldern, Serververhalten usw. aufruft, welche die verschiedenen Funktionen von Dreamweaver umfassen.
Mithilfe dieser APIs können Sie dem Produkt Objekte, Menüs, schwebende Bedienfelder oder andere Funktionen
hinzufügen. Im Handbuch Dreamweaver erweitern wird darüber hinaus erläutert, wie Sie Dreamweaver an Ihre
spezifischen Anforderungen anpassen. Durch das Bearbeiten und Hinzufügen von Tags zu verschiedenen HTML- und
XML-Dateien können Sie beispielsweise Menüelemente oder Dokumenttypen hinzufügen.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

Einführung

Weitere Ressourcen für das Programmieren von Erweiterungen

Wenn Sie sich mit anderen Entwicklern austauschen möchten, die ebenfalls Erweiterungen erstellen, können Sie der
Dreamweaver Extensibility Newsgroup beitreten. Die Website für diese Newsgroup befindet sich unter

http://www.adobe.com/cfusion/webforums/forum/categories.cfm?forumid=12&catid=190.

Neue Funktionen in Dreamweaver CS5

Die folgenden neuen Funktionen wurden der JavaScript-API von Dreamweaver CS5 hinzugefügt. Die Überschriften
beziehen sich auf die Kapitel und Abschnitte, die die neuen Funktionen enthalten.

Dynamische Dokumente

Die folgenden Funktionen wurden zum Kapitel „Dynamische Dokumente“ hinzugefügt.

Live-Ansichtsfunktionen

„dom.setLiveViewFollowsLinks()“ auf Seite 371

2

„dom.getLiveViewFollowsLinks()“ auf Seite 372

„dom.isLiveViewBrowsingHomeURI()“ auf Seite 372

„dreamweaver.findSiteForURI()“ auf Seite 373

„dom.browser.isPageNavigationHistoryEnabled()“ auf Seite 374

„dom.browser.enablePageNavigationHistory()“ auf Seite 375

„dom.browser.getPageNavigationHistoryLength()“ auf Seite 375

„dom.browser.getPageNavigationHistoryPosition()“ auf Seite 375

„dom.browser.goToPageNavigationHistoryPosition()“ auf Seite 376

„dom.browser.getPageNavigationHistoryItem()“ auf Seite 376

„dom.browser.setHomePage()“ auf Seite 377

„dom.browser.getHomePage()“ auf Seite 377

Arbeitsbereich

Die folgenden neuen Funktionen wurden zum Kapitel „Arbeitsbereich“ hinzugefügt.

Funktionen für zugehörige Dateien

„dreamweaver.getRelatedFilesFilter()“ auf Seite 198

„dreamweaver.setRelatedFilesFilter()“ auf Seite 198

„dreamweaver.getQuickRelatedFilesFilterStrings()“ auf Seite 198

„dreamweaver.invokeRelatedFilesCustomFilterDialog()“ auf Seite 199

„dreamweaver.getDynamicRelatedFilesDiscoverySetting()“ auf Seite 199

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

Einführung

„dreamweaver.setDynamicRelatedFilesDiscoverySetting()“ auf Seite 200

„dreamweaver.refreshRelatedFiles()“ auf Seite 200

„dreamweaver.saveAllRelatedFiles()“ auf Seite 201

„dreamweaver.canSaveAllRelatedFiles()“ auf Seite 201

„document.isRelatedFileViewOpen()“ auf Seite 201

„document.getRelatedFiles()“ auf Seite 202

„document.addRelatedFile()“ auf Seite 203

„document.removeRelatedFile()“ auf Seite 203

„document.getDependentFiles()“ auf Seite 204

... und weitere.

Dokument

Die folgenden neuen Funktionen wurden zum Kapitel „Dokument“ hinzugefügt.

„DWUri.isValidURI()“ auf Seite 286

3

„DWUri.isAbsolute()“ auf Seite 287

„DWUri.isRelative()“ auf Seite 287

„DWUri.isDirectory()“ auf Seite 287

„DWUri.isHierarchical()“ auf Seite 288

„DWUri.isOfType()“ auf Seite 288

„DWUri.isOfFileType()“ auf Seite 288

... und weitere.

Code

Die folgenden neuen Funktionen wurden zum Kapitel „Code“ hinzugefügt.

„dom.getLiveCodeHighlightsChanges()“ auf Seite 500

„dom.setLiveCodeHighlightsChanges()“ auf Seite 500

... und weitere.

In diesem Handbuch verwendete Konventionen

Typografische Konventionen

In diesem Handbuch werden die folgenden typografischen Konventionen verwendet:

• Codeschrift kennzeichnet Codefragmente und API-Literale, z. B. Klassennamen, Methodennamen,

Funktionsnamen, Typnamen, Skripts, SQL-Anweisungen, HTML- und XML-Tag-Namen sowie Attributnamen.

• Kursive Codeschrift kennzeichnet Platzhalterelemente im Code.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

Einführung

• Das Fortsetzungssymbol (¬) weist darauf hin, dass ein langer Code über mehrere Zeilen umbrochen wurde. Da die

Zeilenlänge in diesem Handbuch durch die im Format festgelegten Ränder begrenzt ist, muss Code, der eigentlich
fortlaufend ist, auf mehrere Zeilen verteilt werden. Löschen Sie beim Kopieren der Codezeilen das
Fortsetzungssymbol und geben Sie die Zeilen ohne Umbruch ein.

• Geschweifte Klammern ({ }), die ein Argument einschließen, weisen darauf hin, dass es sich um ein optionales

Argument handelt.

• Funktionsnamen mit dem Präfix dreamweaver.Funktionsname können beim Programmieren von Code als

dw.Funktionsname abgekürzt werden. In diesem Handbuch wird das ausführliche Präfix dreamweaver. bei der

Definition der Funktion und im Index verwendet. In vielen Beispielen wird jedoch das kürzere Präfix

dw.

verwendet.

Namengebungskonventionen

Folgende Namengebungskonventionen werden in diesem Handbuch verwendet:

• Sie – die Person, die für das Programmieren von Erweiterungen verantwortlich ist (also der Entwickler).

• Der Benutzer – die Person, die Dreamweaver verwendet.

4

Letzte Aktualisierung 22.6.2011

Kapitel 2: API für Datei-E/A

Adobe® Dreamweaver® CS5 enthält eine gemeinsam genutzte C-Bibliothek mit dem Namen „DWfile“. Mithilfe von
DWfile können Autoren von Objekten, Befehlen, Verhalten, Datenübersetzern, schwebenden Bedienfeldern und
Eigenschafteninspektoren im lokalen Dateisystem Dateien lesen und schreiben. In diesem Kapitel werden die API für
Datei-E/A und deren Verwendung erläutert.

Allgemeine Informationen über das Zusammenwirken von C-Bibliotheken mit dem JavaScript-Interpreter in
Dreamweaver finden Sie in Dreamweaver erweitern unter „C-Level-Erweiterbarkeit“.

Konfigurationsordner

Unter Microsoft Windows 2000, Windows XP und Mac OS X verfügen die Benutzer über eigene Kopien der
Konfigurationsdateien. Wenn Dreamweaver in eine Konfigurationsdatei schreibt, übernimmt Dreamweaver diese
Änderung in den Ordner „Configuration“ des Benutzers. Auch beim Lesen einer Konfigurationsdatei sucht
Dreamweaver zunächst im Ordner „Configuration“ des Benutzers und erst dann im Ordner „Configuration“ von
Dreamweaver. DWfile-Funktionen arbeiten nach dem gleichen Prinzip. Wenn also Ihre Erweiterung eine Datei im
Dreamweaver-Ordner „Configuration“ schreibt oder liest, greift sie dabei auch auf den Ordner „Configuration“ des
Benutzers zu. Weitere Informationen zu Konfigurationsordnern in Mehrbenutzersystemen finden Sie im Handbuch
Dreamweaver erweitern.

5

Funktionen der API für Datei-E/A

Alle Funktionen der API für Datei-E/A sind Methoden des Objekts DWfile.

DWfile.copy()

Verfügbarkeit

Dreamweaver 3.

Beschreibung

Diese Funktion kopiert die angegebene Datei an einen neuen Ort.

Argumente

originalURL, copyURL

• Das Argument originalURL ist die Datei, die Sie kopieren möchten, im URL-Format „file://“.

• Das Argument copyURL ist der Speicherort, an dem Sie die kopierte Datei speichern möchten, im URL-Format

„file://“.

Rückgabewerte

Ein boolescher Wert:

true, wenn der Kopiervorgang erfolgreich ist, andernfalls false.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

Beispiel

Der folgende Code kopiert die Datei „myconfig.cfg“ nach „myconfig_backup.cfg“:

var fileURL = "file:///c|/Config/myconfig.cfg";
var newURL ="file:///c|/Config/myconfig_backup.cfg";
DWfile.copy(fileURL, newURL);

DWfile.createFolder()

Verfügbarkeit

Dreamweaver 2.

Beschreibung

Diese Funktion erstellt einen Ordner am angegebenen Ort.

Argumente

folderURL

• Das Argument folderURL ist der Speicherort des Ordners, den Sie erstellen möchten, im URL-Format „file://“.

6

Rückgabewerte

Ein boolescher Wert:

true, wenn der Ordner erfolgreich erstellt wurde, andernfalls false.

Beispiel

Der folgende Code erstellt den Ordner „tempFolder“ im Stammverzeichnis von Laufwerk C: und teilt in einem
Dialogfeld mit, ob der Vorgang erfolgreich ausgeführt wurde:

var folderURL = "file:///c|/tempFolder";
if (DWfile.createFolder(folderURL)){

alert("Created " + folderURL);

}else{

alert("Unable to create " + folderURL);

}

DWfile.exists()

Verfügbarkeit

Dreamweaver 2.

Beschreibung

Diese Funktion prüft das Vorhandensein einer bestimmten Datei.

Argumente

fileURL

• Das Argument fileURL ist die angeforderte Datei im URL-Format „file://“.

Rückgabewerte

Ein boolescher Wert:

true, wenn die Datei vorhanden ist, andernfalls false.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

Beispiel

Der folgende Code sucht die Datei „mydata.txt“ und teilt in einer Meldung mit, ob sie vorhanden ist:

var fileURL = "file:///c|/temp/mydata.txt";
if (DWfile.exists(fileURL)){

alert(fileURL + " exists!");

}else{

alert(fileURL + " does not exist.");

}

DWfile.getAttributes()

Verfügbarkeit

Dreamweaver 2.

Beschreibung

Diese Funktion ruft die Attribute der angegebenen Datei bzw. des angegebenen Ordners ab.

Argumente

fileURL

7

• Das Argument fileURL ist die Datei oder der Ordner, für die bzw. den Sie Attribute abrufen möchten, im URL-

Format „file://“.

Rückgabewerte

Ein String, der die Attribute der angegebenen Datei bzw. des angegebenen Ordners darstellt. Existiert die Datei oder
der Ordner nicht, gibt die Funktion den Wert

null zurück. Die Attribute werden durch folgende Zeichen im String

dargestellt:

• R (schreibgeschützt)

• D (Ordner)

• H (verborgen)

• S (Systemdatei oder Ordner)

Beispiel

Der folgende Code fragt die Attribute der Datei „mydata.txt“ ab und zeigt eine Warnmeldung an, falls die Datei
schreibgeschützt ist:

var fileURL = "file:///c|/temp/mydata.txt";
var str = DWfile.getAttributes(fileURL);
if (str && (str.indexOf("R") != -1)){

alert(fileURL + " is read only!");

}

DWfile.getModificationDate()

Verfügbarkeit

Dreamweaver 2.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

Beschreibung

Diese Funktion fragt den Zeitpunkt der letzten Änderung einer Datei ab.

Argumente

fileURL

• Das Argument fileURL ist die Datei, deren Zeitpunkt der letzten Änderung Sie überprüfen, im URL-Format

„file://“.

Rückgabewerte

Ein String mit einer hexadezimalen Zahl, die die Anzahl der seit dem Ausgangszeitpunkt verstrichenen Zeiteinheiten
angibt. Die jeweilige Bedeutung der Zeiteinheiten und des Ausgangszeitpunkts hängt von der verwendeten Plattform
ab. So beträgt in Windows eine Zeiteinheit 100 ns und als Ausgangszeitpunkt wird der 1. Januar 1600 verwendet.

Beispiel

Sie sollten die Funktion zweimal aufrufen und die Rückgabewerte vergleichen, da der Rückgabewert dieser Funktion
plattformabhängig ist und keine direkt lesbaren Datums- und Uhrzeitwerte darstellt. Der folgende Code fragt das
Änderungsdatum von „file1.txt“ und „file2.txt“ ab und zeigt eine Meldung an, in der angegeben wird, welche der
beiden Dateien aktueller ist:

8

var file1 = "file:///c|/temp/file1.txt";
var file2 = "file:///c|/temp/file2.txt";
var time1 = DWfile.getModificationDate(file1);
var time2 = DWfile.getModificationDate(file2);
if (time1 == time2){

alert("file1 and file2 were saved at the same time");

}else if (time1 < time2){

alert("file1 older that file2");

}else{

alert("file1 is newer than file2");

}

DWfile.getCreationDate()

Verfügbarkeit

Dreamweaver 4.

Beschreibung

Diese Funktion fragt den Zeitpunkt ab, zu der die Datei erstellt wurde.

Argumente

fileURL

• Das Argument fileURL ist die Datei, deren Zeitpunkt der Erstellung Sie überprüfen, im URL-Format „file://“.

Rückgabewerte

Ein String mit einer hexadezimalen Zahl, die die Anzahl der seit dem Ausgangszeitpunkt verstrichenen Zeiteinheiten
angibt. Die jeweilige Bedeutung der Zeiteinheiten und des Ausgangszeitpunkts hängt von der verwendeten Plattform
ab. So beträgt in Windows eine Zeiteinheit 100 ns und als Ausgangszeitpunkt wird der 1. Januar 1600 verwendet.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

Beispiel

Sie können diese Funktion und die Funktion

DWfile.getModificationDate() aufrufen, um das Änderungsdatum

einer Datei mit ihrem Erstelldatum zu vergleichen:

var file1 = "file:///c|/temp/file1.txt";
var time1 = DWfile.getCreationDate(file1);
var time2 = DWfile.getModificationDate(file1);
if (time1 == time2){

alert("file1 has not been modified since it was created");

}else if (time1 < time2){

alert("file1 was last modified on " + time2);

}

DWfile.getCreationDateObj()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion ruft das JavaScript-Objekt für den Zeitpunkt ab, zu dem die Datei erstellt wurde.

9

Argumente

fileURL

• Das Argument fileURL ist die Datei, deren Zeitpunkt der Erstellung Sie überprüfen, im URL-Format „file://“.

Rückgabewerte

Ein JavaScript

Date-Objekt für Datum und Uhrzeit der Erstellung einer Datei.

DWfile.getModificationDateObj()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion ruft das JavaScript

Argumente

fileURL

• Das Argument fileURL ist die Datei, deren Zeitpunkt der letzten Änderung Sie überprüfen, im URL-Format

„file://“.

Rückgabewerte

Ein JavaScript

Date-Objekt für Datum und Uhrzeit der letzten Änderung an einer Datei.

Date-Objekt für den Zeitpunkt der letzten Änderung an einer Datei ab.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

DWfile.getSize()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion ruft die Größe einer Datei ab.

Argumente

fileURL

• Das Argument fileURL ist die Datei, deren Größe Sie überprüfen, im URL-Format „file://“.

Rückgabewerte

Eine Ganzzahl für die tatsächliche Größe (in Byte) einer Datei.

DWfile.listFolder()

10

Verfügbarkeit

Dreamweaver 2.

Beschreibung

Diese Funktion erstellt eine Liste mit dem Inhalt des angegebenen Ordners.

Argumente

folderURL, {constraint}

• Das Argument folderURL ist der Ordner, für den Sie eine Inhaltsliste erstellen möchten, im URL-Format „file://“

gefolgt von einem optionalen Dateimasken-Platzhalter. Gültige Platzhalter sind Sternchen (*) für ein oder mehrere
Zeichen und Fragezeichen (?) für ein Zeichen.

• Das Argument constraint, falls angegeben, muss entweder "files" (nur Dateien zurückgeben) oder

"directories" (nur Ordner zurückgeben) lauten. Falls das Argument nicht angegeben wird, werden sowohl

Dateien als auch Ordner berücksichtigt.

Rückgabewerte

Ein String-Array mit den einzelnen Elementen des Ordners.

Beispiel

Der folgende Code erstellt eine Liste aller Textdateien (TXT) im Ordner „C:/temp“. Die Liste wird in einer Meldung
angezeigt:

var folderURL = "file:///c|/temp";
var fileMask = "*.txt";
var list = DWfile.listFolder(folderURL + "/" + fileMask, "files");
if (list){

alert(folderURL + " contains: " + list.join("\n"));

}

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

DWfile.read()

Verfügbarkeit

Dreamweaver 2.

Beschreibung

Diese Funktion liest den Inhalt der angegebenen Datei und schreibt ihn in einen String.

Argumente

fileURL

• Das Argument fileURL ist die Datei, die Sie lesen möchten, im URL-Format „file://“.

Rückgabewerte

Ein String, in dem sich der Inhalt der Datei befindet, oder der Wert

Beispiel

Der folgende Code liest die Datei „mydata.txt“ und zeigt bei einem erfolgreichen Lesevorgang eine Meldung mit dem
Inhalt der Datei an:

null, wenn der Lesevorgang fehlgeschlagen ist.

11

var fileURL = "file:///c|/temp/mydata.txt";
var str = DWfile.read(fileURL);
if (str){

alert(fileURL + " contains: " + str);

}

DWfile.remove()

Verfügbarkeit

Dreamweaver 3.

Beschreibung

Diese Funktion löscht die angegebene Datei.

Argumente

fileURL

• Das Argument fileURL ist die Datei, die Sie entfernen möchten, im URL-Format „file://“.

Rückgabewerte

Ein boolescher Wert:

Beispiel

Im folgenden Beispiel wird mit

confirm() ein Ja/Nein-Dialogfeld in der Benutzeroberfläche angezeigt:

true, wenn der Vorgang erfolgreich ist, andernfalls false.

DWfile.getAttributes() ermittelt, ob eine Datei schreibgeschützt ist, und mit

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

function deleteFile(){

var delAnyway = false;
var selIndex = document.theForm.menu.selectedIndex;

var selFile = document.theForm.menu.options[selIndex].value;

if (DWfile.getAttributes(selFile).indexOf('R') != -1){

delAnyway = confirm('This file is read-only. Delete anyway?');
if (delAnyway){

DWfile.remove(selFile);

}

}

}

DWfile.setAttributes()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion legt die Attribute auf Systemebene für eine bestimmte Datei fest.

12

Argumente

fileURL, strAttrs

• Das Argument fileURL identifiziert die Datei, für die Sie die Attribute festlegen, im URL-Format „file://“.

• Das Argument strAttrs legt die Attribute auf Systemebene für die von fileURL bezeichnete Datei fest. In der

folgenden Tabelle sind gültige Attributwerte und ihre Bedeutungen aufgeführt:

Attributwert Beschreibung

R

W

H

V

Gültige Werte für den

R und W schließen sich gegenseitig aus und sollten daher nicht gemeinsam verwendet werden. Werden sie in der

Kombination eingesetzt, wird

H und V schließen sich gegenseitig aus. Wenn Sie sie kombinieren, wird H außer Kraft gesetzt und die Datei wird

auf sichtbar (

Legen Sie

V) gesetzt.

H oder V ohne das Lese-/Schreibattribut R oder W fest, bleibt das aktuelle Lese-/Schreibattribut der Datei

unverändert. Wenn Sie

strAttrs-String sind R, W, H, V, RH, RV, WH und WV.

R außer Kraft gesetzt und der Schreibschutz für die Datei wird aufgehoben (W). Auch

R oder W festlegen, ohne das Attribut H oder V anzugeben, wird das aktuelle

Schreibgeschützt

Kein Schreibschutz (überschreibt R)

Verborgen

Sichtbar (überschreibt H)

Sichtbarkeitsattribut der Datei nicht geändert.

Rückgabewerte

Keine.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Datei-E/A

DWfile.write()

Verfügbarkeit

Dreamweaver 2.

Beschreibung

Diese Funktion schreibt den festgelegten String in die angegebene Datei. Wenn die angegebene Datei noch nicht
vorhanden ist, wird sie erstellt.

Argumente

fileURL, text, {mode}

• Das Argument fileURL ist die Datei, in die Sie schreiben, im URL-Format „file://“.

Hinweis: Wenn der Pfad Leerzeichen enthält, werden mit dieser Funktion keine Dateien geschrieben.

• Das Argument text gibt den zu schreibenden String an.

• Als mode-Argument (falls angegeben) muss append verwendet werden. Falls dieses Argument nicht angegeben

wird, überschreibt der String den Dateiinhalt.

13

Rückgabewerte

Ein boolescher Wert:

true bei erfolgreichem Schreibvorgang, andernfalls false.

Beispiel

Der folgende Code schreibt den String
Schreibvorgang eine Meldung aus. Anschließend wird der String

xxx in die Datei „mydata.txt“ und gibt nach einem erfolgreichen

aaa an den Dateiinhalt angehängt. Wenn dieser

Vorgang erfolgreich verläuft, wird eine zweite Meldung ausgegeben. Nach Ausführung des Skripts enthält die Datei
„mydata.txt“ lediglich den Text

var fileURL = "file:///c|/temp/mydata.txt";
if (DWfile.write(fileURL, "xxx")){

alert("Wrote xxx to " + fileURL);
}
if (DWfile.write(fileURL, "aaa", "append")){

alert("Appended aaa to " + fileURL);
}

xxxaaa.

Letzte Aktualisierung 22.6.2011

Kapitel 3: HTTP-API

Die Einsatzmöglichkeiten der Erweiterungen beschränken sich nicht auf das lokale Dateisystem. Adobe®
Dreamweaver® bietet einen Mechanismus, mit dem über HTTP (Hypertext Transfer Protocol) Informationen von
einem Webserver abgerufen bzw. an diesen gesendet werden können. In diesem Kapitel werden die HTTP-API und
deren Verwendung erläutert.

Funktionsweise der HTTP-API

Alle Funktionen der HTTP-API sind Methoden des Objekts MMHttp. Bei den meisten dieser Funktionen wird als
Argument eine URL verwendet und die meisten geben ein Objekt zurück. Als Standardanschluss für URL-Argumente
wird Anschluss 80 verwendet. Wenn Sie einen anderen Anschluss verwenden möchten, fügen Sie einen Doppelpunkt
und die Nummer des Anschlusses an die URL an, wie im folgenden Beispiel gezeigt:

MMHttp.getText("http://www.myserver.com:8025");

Bei Funktionen, die ein Objekt zurückgeben, verfügt das Objekt über zwei Eigenschaften: statusCode und data.

14

Die Eigenschaft

• 200: Status OK

• 400: Unverständliche Anforderung

• 404: Angeforderte URL nicht gefunden

• 405: Server unterstützt angeforderte Methode nicht

• 500: Unbekannter Serverfehler

• 503: Serverkapazität erreicht

Eine umfassende Liste der Statuscodes für Ihren Server erhalten Sie bei Ihrem Internetdienstanbieter oder
Systemadministrator.

Der Wert der Eigenschaft
Funktionsbeschreibungen angegeben.

Funktionen, die ein Objekt zurückgeben, sind jeweils auch in einer sogenannten Callback-Version vorhanden. Bei
Callback-Funktionen können andere Funktionen ausgeführt werden, während der Webserver eine HTTP­Anforderung bearbeitet. Dies ist dann nützlich, wenn Sie in Dreamweaver mehrere HTTP-Anforderungen ausgeben.
Die Callback-Version einer Funktion übergibt ihre ID und ihren Rückgabewert direkt an die als ihr erstes Argument
definierte Funktion.

statusCode gibt den Status der Operation an. Mögliche Werte sind unter anderem:

data ist von der jeweiligen Funktion abhängig. Die möglichen Werte sind bei den einzelnen

Funktionen der HTTP-API

In diesem Abschnitt werden die Funktionen, bei denen es sich um Methoden des Objekts MMHttp handelt, ausführlich
erläutert.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

HTTP-API

MMHttp.clearServerScriptsFolder()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Löscht den Ordner „_mmServerScripts“ und alle darin enthaltenen Dateien im Stammordner der aktuellen lokalen
Site oder Remote-Site. Der Ordner „_mmServerScripts“ befindet sich im Ordner
„Configuration/Connections/Scripts/Servermodell/_mmDBScripts“.

Argumente

serverScriptsfolder

• serverScriptsfolder ist ein String, der einen bestimmten Ordner relativ zum Ordner „Configuration“ auf dem

Anwendungsserver bezeichnet, von dem Sie Serverskripts abrufen und löschen möchten.

Rückgabewerte

Ein Objekt, das die Antwort vom Server repräsentiert. Die Eigenschaft
Inhalt der gelöschten Skripts. Wenn ein Fehler auftritt, zeigt Dreamweaver diesen in der Eigenschaft
zurückgegebenen Objekts an.

data dieses Objekts ist ein String mit dem

statusCode des

15

Beispiel

Wenn der folgende Code in einer Menübefehlsdatei im Ordner „Configuration/Menus“ steht, entfernt er beim Aufruf
über ein Menü alle Dateien aus dem Ordner „_mmServerScripts“:

<!-- MENU-LOCATION=NONE -->
<html>
<head>
<TITLE>Clear Server Scripts</TITLE>
<SCRIPT SRC="ClearServerScripts.js"></SCRIPT>
<SCRIPT LANGUAGE="javascript">
</SCRIPT>
<body onLoad="MMHttp.clearServerScriptsFolder()">
</body>
</html>

MMHttp.clearTemp()

Beschreibung

Diese Funktion löscht alle Dateien aus dem Ordner „Configuration/Temp“, der sich im Anwendungsordner von
Dreamweaver befindet.

Argumente

Keine.

Rückgabewerte

Keine.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

HTTP-API

Beispiel

Wenn der folgende Code als Datei im Ordner „Configuration/Shutdown“ gespeichert wird, werden beim Beenden von
Dreamweaver alle Dateien aus dem Ordner „Configuration/Temp“ gelöscht:

<html>
<head>
<title>Clean Up Temp Files on Shutdown</title>
</head>
<body onLoad="MMHttp.clearTemp()">
</body>
</html>

MMHttp.getFile()

Beschreibung

Diese Funktion ruft die Datei unter der angegebenen URL ab und speichert sie im Ordner „Configuration/Temp“, der
sich im Anwendungsordner von Dreamweaver befindet. Dreamweaver erstellt automatisch Unterordner, durch die
die Ordnerstruktur des Servers nachgeahmt wird. Lautet der angegebene Pfad beispielsweise
„www.dreamcentral.com/people/index.html“, speichert Dreamweaver die Datei „index.html“ im Unterordner
„People“ des Ordners „www.dreamcentral.com“.

16

Argumente

URL, {prompt}, {saveURL}, {titleBarLabel}

• Das Argument URL ist eine absolute URL auf einem Webserver. Wenn http:// in der URL nicht angegeben wird,

geht Dreamweaver davon aus, dass HTTP verwendet wird.

• Das optionale Argument prompt ist ein boolescher Wert, der angibt, ob der Benutzer zum Speichern der Datei

aufgefordert wird. Wenn sich saveURL auf einen Speicherort außerhalb des Ordners „Configuration/Temp“
bezieht, wird beim Argument prompt der Wert

false aus Sicherheitsgründen ignoriert.

• Das optionale Argument saveURL ist der Speicherort auf der Festplatte des Benutzers, an dem die Datei gespeichert

werden soll (im URL-Format „file://“). Wenn für „prompt“ der Wert

true definiert wurde oder sich saveURL auf

einen Speicherort außerhalb des Ordners „Configuration/Temp“ bezieht, kann der Benutzer saveURL im
Dialogfeld „Speichern“ überschreiben.

• Das optionale Argument titleBarLabel ist die Bezeichnung, die in der Titelleiste des Dialogfelds „Speichern“

angezeigt werden soll.

Rückgabewerte

Ein Objekt, das die Antwort vom Server repräsentiert. Die Eigenschaft
Speicherort der Datei enthält (im URL-Format „file://“). Normalerweise enthält die Eigenschaft

data dieses Objekts ist ein String, der den

statusCode des

Objekts den vom Server empfangenen Statuscode. Wenn jedoch beim Speichern auf dem lokalen Laufwerk ein
Datenträgerfehler aufgetreten ist und der Vorgang nicht erfolgreich ausgeführt werden kann, enthält die Eigenschaft

statusCode einen Fehlercode in Form eines der folgenden ganzzahligen Werte:

• 1: Unbekannter Fehler

• 2: Datei nicht gefunden

• 3: Ungültiger Pfad

• 4: Zu viele Dateien geöffnet

• 5: Zugriff verweigert

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

HTTP-API

• 6: Ungültiges Datei-Handle

• 7: Aktueller Arbeitsordner kann nicht entfernt werden

• 8: Keine weiteren Ordnereinträge

• 9: Fehler beim Setzen des Dateizeigers

• 10: Hardwarefehler

• 11: Zugriffsverletzung

• 12: Sperrverletzung

• 13: Festplatte voll

• 14: Dateiende erreicht

Beispiel

Mit dem folgenden Code wird zunächst eine HTML-Datei abgerufen. Dann werden alle Dateien im Ordner
„Configuration/Temp“ gespeichert und die lokale Kopie der HTML-Datei wird in einem Browser geöffnet:

var httpReply = MMHttp.getFile("http://www.dreamcentral.com/people/profiles/scott.html",
false);
if (Boolean == 200){

var saveLoc = httpReply.data;

dw.browseDocument(saveLoc);
}

17

MMHttp.getFileCallback()

Beschreibung

Diese Funktion ruft die Datei unter der angegebenen URL ab, speichert die Datei im Ordner „Configuration/Temp“
innerhalb des Anwendungsordners von Dreamweaver und ruft anschließend die angegebene Funktion mit der
Anforderungs-ID und dem Antwortergebnis auf. Wenn die Datei lokal gespeichert wird, erstellt Dreamweaver
automatisch Unterordner, durch die die Ordnerstruktur des Servers nachgeahmt wird. Lautet der angegebene Pfad
beispielsweise „www.dreamcentral.com/people/index.html“, speichert Dreamweaver die Datei „index.html“ im
Unterordner „People“ des Ordners „www.dreamcentral.com“.

Argumente

callbackFunction, URL, {prompt}, {saveURL}, {titleBarLabel}

• Das Argument callbackFunction ist der Name der JavaScript-Funktion, die nach erfolgter HTTP-Anfrage

aufgerufen werden soll.

• Das Argument URL ist eine absolute URL auf einem Webserver. Wenn http:// in der URL nicht angegeben wird,

geht Dreamweaver davon aus, dass HTTP verwendet wird.

• Das optionale Argument prompt ist ein boolescher Wert, der angibt, ob der Benutzer zum Speichern der Datei

aufgefordert wird. Wenn sich saveURL auf einen Speicherort außerhalb des Ordners „Configuration/Temp“
bezieht, wird beim Argument prompt der Wert

• Das optionale Argument saveURL ist der Speicherort auf der Festplatte des Benutzers, an dem die Datei gespeichert

werden soll (im URL-Format „file://“). Wenn für „prompt“ der Wert
einen Speicherort außerhalb des Ordners „Configuration/Temp“ bezieht, kann der Benutzer saveURL im
Dialogfeld „Speichern“ überschreiben.

false aus Sicherheitsgründen ignoriert.

true definiert wurde oder sich saveURL auf

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

HTTP-API

• Das optionale Argument titleBarLabel ist die Bezeichnung, die in der Titelleiste des Dialogfelds „Speichern“

angezeigt werden soll.

Rückgabewerte

Ein Objekt, das die Antwort vom Server repräsentiert. Die Eigenschaft
Speicherort der Datei enthält (im URL-Format „file://“). Normalerweise enthält die Eigenschaft

data dieses Objekts ist ein String, der den

statusCode des

Objekts den vom Server empfangenen Statuscode. Wenn jedoch beim Speichern auf dem lokalen Laufwerk ein
Datenträgerfehler aufgetreten ist, enthält die Eigenschaft

statusCode einen ganzzahligen Fehlercode. Eine Liste der

möglichen Fehlercodes finden Sie unter „MMHttp.getFile()“ auf Seite 16.

MMHttp.getText()

Verfügbarkeit

Dreamweaver UltraDev 4, verbessert in Dreamweaver MX.

Beschreibung

Ruft den Inhalt des Dokuments unter der angegebenen URL ab.

18

Argumente

URL, {serverScriptsFolder}

• Das Argument URL ist eine absolute URL auf einem Webserver. Wenn http:// in der URL nicht angegeben wird,

geht Dreamweaver davon aus, dass HTTP verwendet wird.

• Das Argument serverScriptsFolder ist ein optionaler String, der einen bestimmten Ordner relativ zum Ordner

„Configuration“ auf dem Anwendungsserver bezeichnet, von dem Sie Serverskripts abrufen möchten. Zum
Abrufen der Skripts verwendet Dreamweaver das entsprechende Übertragungsprotokoll (z. B. FTP, WebDAV oder
Remote-Dateisystem). Dreamweaver kopiert diese Dateien in den Unterordner „_mmServerScripts“ im
Stammordner der aktuellen Site.

Wenn ein Fehler auftritt, zeigt Dreamweaver diesen in der Eigenschaft

statusCode des zurückgegebenen Objekts an.

MMHttp.getTextCallback()

Verfügbarkeit

Dreamweaver UltraDev 4, verbessert in Dreamweaver MX.

Beschreibung

Ruft den Inhalt des Dokuments unter der angegebenen URL ab und übergibt ihn an die angegebene Funktion.

Argumente

callbackFunc, URL, {serverScriptsFolder}

• Das Argument callbackFunc ist die JavaScript-Funktion, die nach erfolgter HTTP-Anfrage aufgerufen werden soll.

• Das Argument URL ist eine absolute URL auf einem Webserver. Wenn http:// in der URL nicht angegeben wird,

geht Dreamweaver davon aus, dass HTTP verwendet wird.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

HTTP-API

• Das Argument serverScriptsFolder ist ein optionaler String, der einen bestimmten Ordner relativ zum Ordner

„Configuration“ auf dem Anwendungsserver bezeichnet, von dem Sie Serverskripts abrufen möchten. Zum
Abrufen der Skripts verwendet Dreamweaver das entsprechende Übertragungsprotokoll (z. B. FTP, WebDAV oder
Remote-Dateisystem). Dreamweaver ruft diese Dateien ab und übergibt sie an die Funktion, die durch
callbackFunc angegeben wird.

Wenn ein Fehler auftritt, zeigt Dreamweaver MX diesen in der Eigenschaft

statusCode

des zurückgegebenen Objekts an.

MMHttp.postText()

Verfügbarkeit

Dreamweaver UltraDev 4, verbessert in Dreamweaver MX.

Beschreibung

Führt einen HTTP-Sendevorgang durch, um die angegebenen Daten an die angegebene URL zu übertragen. In der
Regel handelt es sich dabei um formularkodierten Text, doch kann mit der Funktion jeder beliebige Datentyp
übertragen werden, den der Server erwartet.

Argumente

URL, dataToPost, {contentType}, {serverScriptsFolder}

19

• Das Argument URL ist eine absolute URL auf einem Webserver. Wenn http:// in der URL nicht angegeben wird,

geht Dreamweaver davon aus, dass HTTP verwendet wird.

• Das Argument dataToPost gibt die zu sendenden Daten an. Wenn das dritte Argument "application/x-www-

form-urlencoded" lautet oder weggelassen wird, muss das Argument dataToPost gemäß Abschnitt 8.2.1 der

Spezifikation RFC 1866 (zu finden unter www.faqs.org/rfcs/rfc1866.html) formularkodiert sein.

• Das optionale Argument contentType bezeichnet den Inhaltstyp der Daten, die durch das post-Verfahren

übertragen werden sollen. Bei fehlendem Argument wird als Standardwert

urlencoded" verwendet.

"application/x-www-form-

• Das Argument serverScriptsFolder ist ein optionaler String, der einen bestimmten Ordner relativ zum Ordner

„Configuration“ auf dem Anwendungsserver bezeichnet, auf den Sie Daten übertragen möchten. Zum Senden der
Daten verwendet Dreamweaver das entsprechende Übertragungsprotokoll (z. B. FTP, WebDAV oder Remote­Dateisystem).

Wenn ein Fehler auftritt, zeigt Dreamweaver diesen in der Eigenschaft

statusCode des zurückgegebenen Objekts an.

Beispiel

Im folgenden Beispiel für einen

MMHttp.postText()-Funktionsaufruf wird davon ausgegangen, dass ein Entwickler

die Datei „myScripts.cfm“ im Ordner „DeployScripts“ abgelegt hat, der sich im Ordner „Configuration“ des lokalen
Computers befindet:

MMHttp.postText(

"http://ultraqa8/DeployScripts/myScripts.cfm",

"arg1=Foo",

"application/x-www-form-urlencoded",

"Configuration/DeployScripts/"
)

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

HTTP-API

Sobald Dreamweaver diesen Funktionsaufruf ausführt, läuft Folgendes ab:

1 Die Datei „myScripts.cfm“ im Ordner „Configuration/DeployScripts“ des lokalen Computers wird in einen

anderen Ordner „DeployScripts“ kopiert, der ein Unterordner des Stammordners der Website „ultraqa8“ ist. Zum
Bereitstellen der Dateien verwendet Dreamweaver das bei der Konfiguration der Site angegebene Protokoll.

2 Dreamweaver verwendet das HTTP-Protokoll, um die arg1=Foo-Daten an den Webserver zu übertragen.

3 Das Ergebnis der Übertragungsanfrage ist, dass der Webserver von „ultraqa8“ das Skript „myScripts.cfm“ unter

Verwendung der

arg1-Daten ausführt.

MMHttp.postTextCallback()

Verfügbarkeit

Dreamweaver UltraDev 4, verbessert in Dreamweaver MX.

Beschreibung

Führt einen HTTP-Sendevorgang durch, um den Text an die angegebene URL zu übertragen, und übergibt die
Antwort vom Server an die angegebene Funktion. In der Regel handelt es sich dabei um formularkodierten Text, doch
kann mit der Funktion jeder beliebige Datentyp übertragen werden, den der Server erwartet.

20

Argumente

callbackFunc, URL, dataToPost, {contentType}, {serverScriptsFolder}

• Das Argument callbackFunc ist der Name der JavaScript-Funktion, die nach erfolgter HTTP-Anfrage aufgerufen

werden soll.

• Das Argument URL ist eine absolute URL auf einem Webserver. Wenn http:// in der URL nicht angegeben wird,

geht Dreamweaver davon aus, dass HTTP verwendet wird.

• Das Argument dataToPost gibt die zu sendenden Daten an. Wenn das dritte Argument "application/x-www-

form-urlencoded" lautet oder weggelassen wird, muss das Argument data gemäß Abschnitt 8.2.1 der

Spezifikation RFC 1866 (zu finden unter www.faqs.org/rfcs/rfc1866.html) formularkodiert sein.

• Das optionale Argument contentType bezeichnet den Inhaltstyp der Daten, die durch das post-Verfahren

übertragen werden sollen. Bei fehlendem Argument wird als Standardwert

urlencoded" verwendet.

"application/x-www-form-

• serverScriptsFolder ist ein optionaler String. Er bezeichnet einen bestimmten Ordner relativ zum Ordner

„Configuration“ auf dem Anwendungsserver, an den Sie Daten senden möchten. Zum Senden der Daten
verwendet Dreamweaver das entsprechende Übertragungsprotokoll (z. B. FTP, WebDAV oder Remote­Dateisystem). Dreamweaver ruft diese Daten ab und übergibt sie an die Funktion, die durch callbackFunc
angegeben wird.

Wenn ein Fehler auftritt, zeigt Dreamweaver diesen in der Eigenschaft

statusCode des zurückgegebenen Objekts an.

Letzte Aktualisierung 22.6.2011

Kapitel 4: API für Design Notes

Mit Adobe® Dreamweaver®, Adobe® Fireworks® und Adobe® Flash® haben Webdesigner und Webentwickler die
Möglichkeit, zusätzliche Informationen über Dokumente zu speichern und abzurufen. Diese Informationen sind in
Dateien gespeichert, die als „Design Notes“ bezeichnet werden. Zu diesen Informationen zählen
Revisionskommentare, Änderungshinweise oder die Quelldateien für GIF- oder JPEG-Dateien.

Weitere Informationen zur Verwendung von Design Notes in Dreamweaver finden Sie in der Dokumentation
Dreamweaver verwenden.

Funktionsweise von Design Notes

In jeder Design Notes-Datei sind Informationen zu einem einzigen Dokument gespeichert. Wenn mit einem oder
mehreren Dokumenten in einem Ordner eine Design Notes-Datei verknüpft ist, erstellt Dreamweaver einen
Unterordner mit dem Namen „_notes“, in dem Design Notes-Dateien gespeichert werden können. Der Ordner
„_notes“ und die darin enthaltenen Design Notes-Dateien werden im Bedienfeld „Dateien“ nicht angezeigt, jedoch im
Finder (Macintosh) bzw. in Windows Explorer. Design Notes-Dateinamen bestehen aus dem Hauptdateinamen und
der Erweiterung „.mno“. Die Design Notes-Datei für die Datei „avocado8.gif“ trägt beispielsweise den Namen
„avocado8.gif.mno“.

21

Design Notes-Dateien sind XML-Dateien, in denen Informationen in einer Folge von Schlüssel-Wert-Paaren
gespeichert sind. Der Schlüssel beschreibt den gespeicherten Informationstyp und der Wert stellt die eigentlichen
Informationen dar. Schlüssel können höchstens 64 Zeichen lang sein.

Im folgenden Beispiel ist die Design Notes-Datei für die Datei „foghorn.gif.mno“ dargestellt:

<?xml version="1.0" encoding="iso-8859-1" ?>
<info>

<infoitem key="FW_source" value="file:///C|sites/dreamcentral/images/sourceFiles/¬

foghorn.png" />
<infoitem key="Author" value="Heidi B." />
<infoitem key="Status" value="Final draft, approved by Jay L." />

</info>

JavaScript-API für Design Notes

Alle Funktionen der JavaScript-API für Design Notes sind Methoden des MMNotes-Objekts. MMNotes ist eine
gemeinsam genutzte C-Bibliothek, mit deren Hilfe die Autoren von Erweiterungen Design Notes-Dateien lesen und
schreiben können. Wie die gemeinsam genutzte Bibliothek DWfile verfügt auch MMNotes über eine JavaScript-API,
über die Sie die Funktionen aufrufen können. Die Funktionen werden über Objekte, Befehle, Verhalten, schwebende
Bedienfelder, Eigenschafteninspektoren und Datenübersetzer der Bibliothek aufgerufen. Die gemeinsam genutzte
Bibliothek MMNotes kann unabhängig von Dreamweaver verwendet werden, selbst wenn Dreamweaver nicht
installiert ist.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Design Notes

MMNotes.close()

Beschreibung

Diese Funktion schließt die angegebene Design Notes-Datei und speichert alle Änderungen. Wenn alle Schlüssel­Wert-Paare entfernt wurden, löscht Dreamweaver die Design Notes-Datei. Wenn es sich um die letzte Design Notes­Datei im Ordner „_notes“ handelt, wird auch der Ordner gelöscht.

22

Hinweis: Rufen Sie nach Verwendung von Design Notes immer die Funktion
Dreamweaver das Schreiben in die Datei abschließt.

Argumente

fileHandle

MMNotes.close() auf, damit

• Das Argument fileHandle ist das von der Funktion MMNotes.open() zurückgegebene Datei-Handle.

Rückgabewerte

Keine.

Beispiel

Siehe „MMNotes.set()“ auf Seite 26.

MMNotes.filePathToLocalURL()

Beschreibung

Diese Funktion wandelt den angegebenen lokalen Laufwerkspfad in das URL-Format „file://“ um.

Argumente

drivePath

• Das Argument drivePath ist ein String, der den vollständigen Laufwerkspfad enthält.

Rückgabewerte

Ein String mit der URL der angegebenen Datei im URL-Format „file://“.

Beispiel

Beim Aufruf von

"file:///c|/sites/webdev/index.htm" zurückgegeben.

MMNotes.filePathToLocalURL('C:\sites\webdev\index.htm') wird der String

MMNotes.get()

Beschreibung

Diese Funktion ruft den Wert des angegebenen Schlüssels in einer Design Notes-Datei ab.

Argumente

fileHandle, keyName

• Das Argument fileHandle ist das von MMNotes.open() zurückgegebene Datei-Handle.

• Das Argument keyName ist ein String, der den Namen des Schlüssels enthält.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Design Notes

Rückgabewerte

Ein String mit dem Wert des Schlüssels.

Beispiel

Siehe „MMNotes.getKeys()“ auf Seite 23.

MMNotes.getKeyCount()

Beschreibung

Diese Funktion ruft die Anzahl der Schlüssel-Wert-Paare in der angegebenen Design Notes-Datei ab.

Argumente

fileHandle

• Das Argument fileHandle ist das von der Funktion MMNotes.open() zurückgegebene Datei-Handle.

Rückgabewerte

Eine Ganzzahl, die die Anzahl der Schlüssel-Wert-Paare in der Design Notes-Datei angibt.

23

MMNotes.getKeys()

Beschreibung

Diese Funktion ruft eine Liste sämtlicher Schlüssel in einer Design Notes-Datei ab.

Argumente

fileHandle

• Das Argument fileHandle ist das von der Funktion MMNotes.open() zurückgegebene Datei-Handle.

Rückgabewerte

Ein String-Array, in dem jeder String den Namen eines Schlüssels enthält.

Beispiel

Der folgende Code kann in einem benutzerdefinierten schwebenden Bedienfeld verwendet werden, um die
Design Notes-Informationen für das aktive Dokument anzuzeigen.

var noteHandle = MMNotes.open(dw.getDocumentDOM().URL);
var theKeys = MMNotes.getKeys(noteHandle);
var noteString = "";
var theValue = "";
for (var i=0; i < theKeys.length; i++){

theValue = MMNotes.get(noteHandle,theKeys[i]);
noteString +=0theKeys[i] + " = " theValue + "\n";

}
document.theForm.bigTextField.value = noteString;
// always close noteHandle
MMNotes.close(noteHandle);

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Design Notes

MMNotes.getSiteRootForFile()

Beschreibung

Diese Funktion ermittelt den Stammordner für die angegebene Design Notes-Datei.

Argumente

fileURL

• Das Argument fileURL im URL-Format „file://“ ist der Pfad zu einer lokalen Datei.

Rückgabewerte

Ein String, der den Pfad des lokalen Stammordners der Site enthält (im URL-Format „file://“) oder der leer ist, wenn
Dreamweaver nicht installiert ist oder die Design Notes-Datei sich außerhalb einer mit Dreamweaver definierten Site
befindet. Diese Funktion sucht nach allen Sites, die in Dreamweaver definiert sind.

MMNotes.getVersionName()

Beschreibung

Diese Funktion ruft den Versionsnamen der gemeinsam genutzten Bibliothek MMNotes ab, der gleichzeitig die
implementierende Anwendung angibt.

24

Argumente

Keine.

Rückgabewerte

Ein String mit dem Namen der Anwendung, von der die gemeinsam genutzte Bibliothek MMNotes implementiert
wurde.

Beispiel

Wenn die Funktion
Eigenschafteninspektor, ein schwebendes Bedienfeld oder einen Datenübersetzer in Dreamweaver aufgerufen wurde,
wird der String
Fireworks wird ebenfalls
vom Dreamweaver-Entwicklungsteam erstellt wurde.

MMNotes.getVersionName() über einen Befehl, ein Objekt, ein Verhalten, einen

"Dreamweaver" zurückgegeben. Durch Aufrufen der Funktion MMNotes.getVersionName() über

"Dreamweaver" zurückgegeben, da Fireworks dieselbe Bibliotheksversion verwendet, die

MMNotes.getVersionNum()

Beschreibung

Diese Funktion ruft die Versionsnummer der gemeinsam genutzten Bibliothek MMNotes ab.

Argumente

Keine.

Rückgabewerte

Ein String, der die Versionsnummer enthält.

Letzte Aktualisierung 22.6.2011

DREAMWEAVER API-REFERENZHANDBUCH

API für Design Notes

MMNotes.localURLToFilePath()

Beschreibung

Diese Funktion wandelt den im URL-Format „file://“ angegebenen Pfad in einen lokalen Laufwerkspfad um.

Argumente

fileURL

• Das Argument fileURL im URL-Format „file://“ ist der Pfad zu einer lokalen Datei.

Rückgabewerte

Ein String, der den lokalen Laufwerkspfad für die angegebene Datei enthält.

Beispiel

Beim Aufruf von

"MacintoshHD:images:moon.gif" zurückgegeben.

MMNotes.localURLToFilePath('file:///MacintoshHD/images/moon.gif') wird der String

MMNotes.open()

25

Beschreibung

Diese Funktion öffnet die der angegebenen Datei zugeordnete Design Notes-Datei oder erstellt sie gegebenenfalls.

Argumente

filePath, {bForceCreate}

• Das Argument filePath im URL-Format „file://“ ist der Pfad zur Hauptdatei, mit der die Design Notes-Datei

verknüpft ist.

• Das Argument bForceCreate ist ein boolescher Wert, der angibt, ob die Design Notes-Datei auch dann erstellt

werden soll, wenn Design Notes für die Site deaktiviert ist oder wenn filePath mit keiner Site verknüpft ist.

Rückgabewerte

Das Datei-Handle für die Design Notes-Datei oder Null (0), wenn die Datei nicht geöffnet oder erstellt wurde.

Beispiel

Siehe „MMNotes.set()“ auf Seite 26.

MMNotes.remove()

Beschreibung

Diese Funktion entfernt den angegebenen Schlüssel (und seinen Wert) aus einer Design Notes-Datei.

Argumente

fileHandle, keyName

• Das Argument fileHandle ist das von der Funktion MMNotes.open() zurückgegebene Datei-Handle.

• Das Argument keyName ist ein String, der den Namen des zu entfernenden Schlüssels enthält.

Letzte Aktualisierung 22.6.2011