DREAMWEAVER API-REFERENZHANDBUCH - help.adobe.com · Dreamweaver sowie Details zur Flash-Objekt-API...

DREAMWEAVER API-REFERENZHANDBUCHADOBE® DREAMWEAVER® CS3

Copyright© 2007 Adobe Systems Incorporated. Alle Rechte vorbehalten.Adobe® Dreamweaver® für Windows® und MacintoshWenn dieses Handbuch mit Software verteilt wird, die einen Endnutzervertrag beinhaltet, stehen das Handbuch sowie die darin beschriebene Software unter dieser Lizenz und dürfen nur in Übereinstimmung mit den Bedingungen dieser Lizenz verwendet oder kopiert werden. Sofern nicht durch eine solche Lizenz gestattet, darf kein Teil dieses Handbuchs ohne die vorherige schriftliche Genehmigung durch Adobe Systems Incorporated in irgendeiner Form oder durch irgendwelche Mittel elektronisch, mechanisch, durch Aufzeichnung oder auf andere Weise reproduziert, in einem Abfragesystem gespeichert oder übertragen werden. Bitte beachten Sie, dass der Inhalt dieses Handbuchs durch Urheberrechtsgesetze geschützt ist, auch wenn es nicht mit Software verteilt wird, die einen Endnutzervertrag beinhaltet. Der Inhalt dieses Handbuchs ist nur für Information-szwecke vorgesehen, kann ohne vorherige Benachrichtigung geändert werden und sollte nicht als eine Verpflichtung durch Adobe Systems Incorporated ausgelegt werden. Adobe Systems Incorporated übernimmt keine Verantwortung oder Haftung für etwaige Fehler oder Ungenauigkeiten, die im informatorischen Inhalt in diesem Handbuch vorkommen mögen.Bitte denken Sie daran, dass vorhandene Illustrationen oder Bilder, die Sie in Ihren Projekten möglicherweise verwenden wollen, durch Urheberrechtsgesetze geschützt sein können. Die unerlaubte Einbindung solcher Materialien in Ihr neues Werk könnte eine Verletzung der Rechte des Urheberrechtsinhabers darstellen. Bitte stellen Sie sicher, dass Sie jegliche erforderliche Genehmigung vom Urheberrechtsinhaber einholen. Die Bezugnahme auf Firmennamen in Beispielvorlagen dient ausschließlich Demonstration-szwecken und ist nicht als Bezugnahme auf irgendwelche tatsächlich existierenden Organisationen beabsichtigt.Adobe, das Adobe-Logo, ActionScript, Adobe Bridge, ColdFusion, Creative Suite, Director, Dreamweaver, Fireworks, Flash, FlashPaper, HomeSite, JRun, Photoshop, Shockwave und Version Cue sind entweder eingetragene Marken oder Marken von Adobe Systems Incorporated in den USA.ActiveX, Microsoft und Windows sind Marken oder eingetragene Marken der Microsoft Corporation in den USA und/oder anderen Ländern. Apple und Mac OS sind Marken von Apple Inc., eingetragen in den USA und anderen Ländern. Java und Solaris sind Marken oder eingetragene Marken von Sun Microsystems, Inc. in den USA und anderen Ländern. Linux ist eine eingetragene Marke von Linus Torvalds in den USA und anderen Ländern. UNIX ist eine Marke in den USA und in anderen Ländern, exklusiv lizenziert durch X/Open Company, Ltd. Alle anderen Marken gehören den jeweiligen Eigentümern.Dieses Produkt enthält Software, die von der Apache Software Foundation (http://www.apache.org/) entwickelt wurde. Das Graphics Interchange Format © ist urheberrechtlich Eigentum von CompuServe Incorporated. GIF(sm) ist eine Dienstleistungsmarke, die CompuServe Incorporated gehört. MPEG Layer-3 Audiokomprimierungstechnologie lizenziert durch Fraunhofer IIS und Thomson Multimedia (http://www.mp3licensing.com). Das in der Software enthaltene MP3-komprimierte Audio kann nicht für Echtzeit- oder Live-Sendungen verwendet werden. Wenn Sie einen MP3-Decoder für Echtzeit- oder Live-Übertragungen benötigen, sind Sie dafür zuständig, die entsprechende MP3-Lizenz zu erhalten. Sprachkomprimierungs- und -dekomprimierungsstechnologien stehen unter der Lizenz der Firma Nellymoser, Inc. (www.nellymoser.com). Flash CS3 Video wird betrieben mit der On2 TrueMotion-Videotechnik. © 1992-2005 On2 Technologies, Inc. Alle Rechte vorbehalten. http://www.on2.com. Dieses Produkt enthält Software, die von der OpenSymphony Group (http://www.opensymphony.com/) entwickelt wurde. Sorenson SparkTM Videokomprimierungs- und -dekomprimierungsstechnologien stehen unter der Lizenz der Firma Sorenson Media, Inc.Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.Hinweis für Endnutzer der Regierung der Vereinigten Staaten. Die Software und das Begleitmaterial sind Handelswaren („Commercial Items“) im Sinne von 48 C.F.R. §2.101, bestehend aus kommerzieller Computersoftware („Commercial Computer Software“) und Begleitmaterial für kommerzielle Computersoftware („Commercial Computer Software Documentation“) im Sinne von 48 C.F.R. §12.212 bzw. 48 C.F.R. §227.7202. Gemäß 48 C.F.R. §12.212 bzw. 48 C.F.R. §§227.7202-1 bis 227.7202-4 werden die kommerz-ielle Computersoftware und das Begleitmaterial für kommerzielle Computersoftware für Endnutzer der vereinigten Staaten (a) nur als Handelswaren und (b) nur mit jenen Rechten zur Verfügung gestellt, die allen anderen Endnutzern gewährt werden, gemäß den Bestimmungen des Lizenzvertrags für Endnutzer von Adobe. Unveröffentlichte Rechte bleiben gemäß den Gesetzen zum Urheberrecht der Vereinigten Staaten vorbehalten. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Für Endnutzer der Regierung der Vereinigten Staaten verpflichtet sich Adobe, alle anwendbaren Gesetze zur Chancengleichheit anzuwenden, einschließlich der Bestimmungen der Executive Order 11246, einschließlich Ergänzungen, Abschnitt 402 des Vietnam Era Veterans Readjustment Assistance Act von 1974 (38 USC 4212), und Abschnitt 503 des Rehabilitation Act von 1973, einschließlich Ergänzungen, sowie Vorschriften in 41 CFR, 60-1 bis 60-60, 60-250 und 60-741. Die Gesetze und Vorschriften über aktive Förderungsmaßnahmen zugunsten von Minderheiten im vorgenannten Satz sind als Bezug in diesen Vertrag aufzunehmen.

iii

Inhaltsverzeichnis

Kapitel 1: Einführung

Hintergrund . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Dreamweaver erweitern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

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

Neue Funktionen in Dreamweaver CS3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Entfernte Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Errata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

In diesem Handbuch verwendete Konventionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

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

Auf Konfigurationsordner zugreifen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Die API für Datei-E/A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Kapitel 3: Die HTTP-API

Funktionsweise der HTTP-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Die HTTP-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Kapitel 4: API für Design Notes

Funktionsweise von Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

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

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

Kapitel 5: Integration von Fireworks

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

Kapitel 6: Flash-Integration

Funktionsweise von Flash-Elementen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Flash-Elemente einfügen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

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

Kapitel 7: Datenbank-API

Funktionsweise der Datenbank-API-Funktion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Datenbankverbindungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Datenbankzugriffsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Kapitel 8: Die Datenbank-Konnektivitäts-API

Neue Verbindungstypen entwickeln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Die Verbindungs-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Die generierte Include-Datei . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Definitionsdateien für Ihren Verbindungstyp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Kapitel 9: Die JavaBeans-API

Die JavaBeans-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Kapitel 10: API zur Integration der Quellcodeverwaltung

So funktioniert die Integration der Quellcodeverwaltung in Dreamweaver . . . . . . . . . . . . . . . . . 81

Quellcode-Verwaltungssystemfunktionen hinzufügen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Erforderliche Funktionen für die API zur Integration der Quellcodeverwaltung . . . . . . . . . . . . . 82

iv

Optionale Funktionen für die API zur Integration der Quellcodeverwaltung . . . . . . . . . . . . . . . . 87

Enabler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Kapitel 11: Anwendung

Funktionen für externe Anwendungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

Globale Anwendungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Bridge-Kommunikationsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113

Kapitel 12: Arbeitsbereich

Verlaufsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

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

Tastaturfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126

Menüfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133

Ergebnisfenster-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134

Umschaltfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

Symbolleistenfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166

Fensterfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171

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

Symbolleistenfunktionen der Codeansicht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186

Kapitel 13: Site

Berichtfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191

Sitefunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191

Kapitel 14: Dokument

Konvertierungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223

Befehlsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224

Dateibearbeitungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225

Globale Dokumentfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238

Pfadfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

Auswahlfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249

Funktionen zur Behandlung von Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255

Übersetzungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258

XSLT-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260

Kapitel 15: Seiteninhalt

Funktionen des Bedienfelds „Elemente“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263

Verhaltensfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272

Zwischenablagefunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279

Bibliotheks- und Vorlagenfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284

Codefragmente (Bedienfeld), Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289

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

Funktionen zum Einfügen von Spry-Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294

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

Kapitel 16: Dynamische Dokumente

Funktionen von Serverkomponenten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303

Datenquellenfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304

Extension Data Manager-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305

Live Data-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307

Serververhalten-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311

v

Servermodell-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313

Kapitel 17: Design

CSS-Layoutfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319

Frame- und Frameset-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .336

Ebenen- und Imagemap-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337

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

Layoutansicht-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344

Vergrößerungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353

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

Tabellenbearbeitungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .362

Kapitel 18: Code

Codefunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .371

Suchen- und Ersetzen-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .374

Allgemeine Bearbeitungsfunktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .379

Druckfunktion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .393

Quick Tag Editor-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .394

Codeansicht-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .395

Tag-Editor- und Tag-Bibliothek-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .410

Kapitel 19: Enabler

Enabler-Funktionen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .415

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .449

1

Kapitel 1: Einführung

Im Adobe Dreamweaver CS3 API-Referenzhandbuch werden die Anwendungsprogrammierschnittstellen (Application Programming Interfaces, APIs) beschrieben, mit denen Sie verschiedene Aufgaben bei der Entwicklung Adobe® Dream-weaver® CS3-Erweiterungen und beim Hinzufügen von Programmcode zu Ihren Dreamweaver-Webseiten ausführen können. Zu diesen APIs gehören die JavaScript-API, die Zugriff zu vielen Kernfunktionen von Dreamweaver (alles, was über Menüs ausgeführt werden kann, und mehr) bietet, sowie verschiedene Dienstprogramm-APIs für die Ausführung allgemeiner Aufgaben wie Lesen und Schreiben von Dateien, Übertragen von Informationen über HTTP und Kommuni-kation mit Fireworks und Flash.

Die Dienstprogramm-APIs enthalten eine Untergruppe von zusammenhängenden Funktionen, mit denen Sie bestimmte Aufgaben durchführen können. Es gibt folgende Dienstprogramm-APIs:

• Die API für Datei-E/A, mit der Sie Dateien im lokalen Dateisystem lesen und schreiben können.

• Die API für HTTP, mit der Sie Informationen von einem Webserver empfangen und an diesen senden können.

• Die API für Design Notes, mit der Sie Notizen über Dreamweaver-Dokumente speichern und abrufen können.

• Die API zur Integration von Fireworks, die die Kommunikation mit Adobe Fireworks ermöglicht.

• Die Flash-Integration, die Informationen über das Hinzufügen von Flash-Elementen zur Benutzeroberfläche von Dreamweaver sowie Details zur Flash-Objekt-API enthält (letztere ermöglicht die Erstellung von Objekten für Adobe Flash-Inhalt).

• Die API für Datenbanken, die den Zugriff auf Informationen in Datenbanken und die Verwaltung von Datenbankver-bindungen ermöglicht.

• Die API für die Datenbank-Konnektivität, mit deren Hilfe Sie einen neuen Verbindungstyp und die entsprechenden Dialogfelder für neue oder vorhandene Servermodelle erstellen können.

• Die API für JavaBeans, die Klassennamen, Methoden, Eigenschaften und Ereignisse für von Ihnen definierte JavaBeans abruft.

• Die API zur Integration der Quellcodeverwaltung, mit deren Hilfe Sie gemeinsam genutzte Bibliotheken schreiben können, um die Funktionen zum Ein- und Auschecken von Dreamweaver zu erweitern.

Mithilfe der umfangreichen JavaScript-API können Sie diverse kleinere Aufgaben durchführen, bei denen es sich häufig um Aktionen handelt, die der Benutzer bei der Erstellung von Dreamweaver-Dokumenten durchführt. Diese API-Funktionen sind nach den betreffenden Komponenten der Dreamweaver-Benutzeroberfläche gruppiert. So umfasst die JavaScript-API beispielsweise Arbeitsbereichfunktionen, Dokumentfunktionen, Designfunktionen usw. Mithilfe dieser Funktionen können Sie Aufgaben wie das Öffnen eines neuen Dokuments, Abrufen oder Festlegen einer Schriftgröße, Suchen nach einem Suchstring im HTML-Code, Sichtbarmachen einer Symbolleiste usw. durchführen.

HintergrundIn diesem Buch wird davon ausgegangen, dass Sie Kenntnisse über Dreamweaver, HTML, XML, die JavaScript-Program-mierung und eventuell der Programmierung in C haben. Wenn Sie Erweiterungen zur Erstellung von Webanwendungen schreiben, sollten Sie darüber hinaus über Kenntnisse über serverbasierte Skripts auf mindestens einer Plattform verfügen, wie z. B. Active Server Pages (ASP), ASP.NET, PHP: Hypertext Preprocessor (PHP), ColdFusion oder Java Server Pages (JSP).

ADOBE DREAMWEAVER 9.0API-Referenzhandbuch

2

Dreamweaver erweitern 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 Objekte, Menüs, schwebende Bedienfelder oder andere Funktionen zum Produkt hinzufügen. Im Handbuch Dreamweaver erweitern wird darüber hinaus erläutert, wie Dreamweaver durch das Bearbeiten und Hinzufügen von Tags zu verschie-denen HTML- und XML-Dateien angepasst werden kann, indem Menüelemente oder Dokumenttypen usw. hinzugefügt werden.

Weitere Ressourcen für das Schreiben von ErweiterungenWenn Sie mit anderen Entwicklern kommunizieren möchten, die Erweiterungen erstellen, können Sie der Dreamweaver Extensibility Newsgroup beitreten. Die Website dieser Newsgroup finden Sie (in englischer Sprache) unter folgender Adresse: www.adobe.com/support/dreamweaver/extend/form/.

Neue Funktionen in Dreamweaver CS3Die folgenden Funktionen wurden der JavaScript-API von Dreamweaver CS3 hinzugefügt. Die Überschriften beziehen sich auf die Kapitel und Abschnitte, in denen die neuen Funktionen enthalten sind:

AnwendungDie folgenden Funktionen wurden zum Kapitel „Anwendung“ hinzugefügt.

Funktionen für externe Anwendungen• „dom.insertFiles()“ auf Seite 107

• „dreamweaver.activateApp()“ auf Seite 108

• „dreamweaver.printDocument()“ auf Seite 108

• „dreamweaver.revealDocument()“ auf Seite 108

Globale Anwendungsfunktionen• „dw.registerIdleHandler()“ auf Seite 112

• „dw.revokeIdleHandler()“ auf Seite 113

Bridge-Kommunikation• „BridgeTalk.bringToFront()“ auf Seite 113

• „Bridgetalk.send()“ auf Seite 114

• „BridgeTalk.suppressStartupScreen()“ auf Seite 114

• „dw.browseInBridge()“ auf Seite 115

ArbeitsbereichDie folgenden neuen Funktionen für aktiven Inhalt und die Codeansicht wurden im Kapitel „Arbeitsbereich“ auf Seite 117 hinzugefügt.

http://www.adobe.com/support/dreamweaver/extend/form/


3

Aktive Inhalte• „dom.convertNextActiveContent()“ auf Seite 126

• „dom.convertActiveContent()“ auf Seite 126

Codeansicht• „dom.source.refreshVariableCodeHints()“ auf Seite 188

SiteDie folgenden neuen Site-Funktionen wurden zum Kapitel „Site“ auf Seite 191 hinzugefügt.

• „site.displaySyncInfoForFile()“ auf Seite 201

• „site.canDisplaySyncInfoForFile()“ auf Seite 442

Dokumente Die folgende neue XML-Datensatzfunktion wurde zum Kapitel „Dokument“ auf Seite 223 hinzugefügt.

• „MMXSLT.getXML()“ auf Seite 260

SeiteninhaltDie folgenden neuen Funktionen wurden zum Kapitel „Seiteninhalt“ auf Seite 263 hinzugefügt. Sie betreffen das Erstellen von Spry-XML-Datensätzen, das verbesserte Bearbeiten von Spry- und anderen Widgets, das Einfügen von Spry-Widgets und das Überprüfen der Browserkompatibilität.

Spry-Widgets bearbeiten• „element.removeTranslatedAttribute()“ auf Seite 293

• „element.setTranslatedAttribute()“ auf Seite 293

• „element.translatedClassName“ auf Seite 293

• „element.translatedStyle“ auf Seite 294

Spry-Widgets einfügen• „dom.addJavaScript()“ auf Seite 294

• „dom.copyAssets()“ auf Seite 295

• „dom.getDefaultAssetFolder()“ auf Seite 296

Probleme bei der Browserkompatibilitätsprüfung• „elem.getComputedStyleProp()“ auf Seite 296

• „window.getDeclaredStyle()“ auf Seite 297

• „dom.getMinDisplayWidth()“ auf Seite 298

• „dom.getBlockElements() elem.getBlockElements()“ auf Seite 298

• „dom.getInlineElements() elem.getInlineElements()“ auf Seite 299

• „dom.getHeaderElements() elem.getHeaderElements()“ auf Seite 300

• „dom.getListElements() elem.getListElements()“ auf Seite 300

• „elem.isBlockElement()“ auf Seite 301

• „elem.isInlineElement()“ auf Seite 301

• „elem.isHeaderElement()“ auf Seite 302

• „elem.isListElement()“ auf Seite 302


4

Dynamische Dokumente Die folgende neue Datenquellenfunktion wurde zum Kapitel „Dynamische Dokumente“ auf Seite 303 hinzugefügt.

• „dw.dbi.setExpanded()“ auf Seite 305

DesignDie folgenden neuen CSS-Layoutfunktionen wurden zum Kapitel „Design“ auf Seite 319 hinzugefügt.

CSS-Layout• „dom.applyLayout()“ auf Seite 319

• „dom.canApplyLayout()“ auf Seite 320

• „dw.getLayoutNames()“ auf Seite 321

• „dw.getLayoutDescriptions()“ auf Seite 321

• „dw.getFilesForLayout()“ auf Seite 320

Entfernte FunktionenDie folgenden Funktionen wurden aus der Dreamweaver CS3-API entfernt, da die dazugehörigen Funktionen nicht mehr im Produkt enthalten sind.

• „dreamweaver.exportCSS() (veraltet)“ auf Seite 230

• „dreamweaver.canExportCSS() (veraltet)“ auf Seite 426

ErrataIm Abschnitt zur Erweiterbarkeit, den Sie (in englischer Sprache) im Dreamweaver Support Center (www.adobe.com/support/dreamweaver/extend/extending_dwmx_errata) finden, steht eine aktualisierte Liste mit bekannten Problemen zur Verfügung.

In diesem Handbuch verwendete Konventionen

Typografische KonventionenIn diesem Handbuch werden die folgenden typografischen Konventionen verwendet:

• Codeschrift kennzeichnet Codefragmente und API-Literale, z. B. Klassennamen, Methodenbezeichnungen, Funkti-onsnamen, Typnamen, Skripts, SQL-Anweisungen, HTML- und XML-Tagnamen sowie Attributnamen.

• Kursive Codeschrift kennzeichnet Elemente im Code, die zu ersetzen sind.

• 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 Schreiben 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.

http://adobe.com/support/dreamweaver/extend/extending_dwmx_errata


5

NamengebungskonventionenFolgende Namengebungskonventionen werden in diesem Handbuch verwendet:

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

• Der Benutzer – die Person, die Dreamweaver verwendet.


6

7

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

Adobe® Dreamweaver® CS3 enthält eine gemeinsam genutzte C-Bibliothek, die es Autoren von Objekten, Befehlen, Verhalten, Datenübersetzern, schwebenden Bedienfeldern und Eigenschafteninspektoren ermöglichen, auf dem lokalen Dateisystem Dateien zu lesen und zu 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 Dream-weaver finden Sie im Handbuch Dreamweaver erweitern unter „C-Level-Erweiterbarkeit“.

Auf Konfigurationsordner zugreifenUnter Microsoft Windows 2000, Windows XP und Mac OS X verfügen die Benutzer über eigene Kopien der Konfigurati-onsdateien. 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 Konfigurationsordner 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 Konfi-gurationsordnern in Mehrbenutzersystemen finden Sie im Handbuch Dreamweaver erweitern.

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

DWfile.copy()

VerfügbarkeitDreamweaver 3.

BeschreibungDiese Funktion kopiert die angegebene Datei an einen neuen Ort.

ArgumenteoriginalURL, copyURL

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

• Das Argument copyURL im URL-Format „file://“ ist der Speicherort, an dem Sie die kopierte Datei speichern möchten.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Kopiervorgang, andernfalls false.

BeispielDer folgende Code kopiert die Datei myconfig.cfg in die Datei myconfig_backup.cfg:

var fileURL = "file:///c|/Config/myconfig.cfg";

var newURL ="file:///c|/Config/myconfig_backup.cfg";

DWfile.copy(fileURL, newURL);


8

DWfile.createFolder()


BeschreibungDiese Funktion erstellt einen Ordner am angegebenen Ort.

ArgumentefolderURL

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

RückgabewerteEin Boolescher Wert: true, wenn der Ordner erfolgreich erstellt wurde, andernfalls false.

BeispielDer 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()


BeschreibungDiese Funktion prüft das Vorhandensein einer bestimmten Datei.

ArgumentefileURL

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

RückgabewerteEin Boolescher Wert: true, wenn die Datei vorhanden ist, andernfalls false.

BeispielDer folgende Code sucht die Datei mydata.txt und zeigt in einer Meldung an, ob die Datei vorhanden ist:

var fileURL = "file:///c|/temp/mydata.txt";

if (DWfile.exists(fileURL)){

alert(fileURL + " exists!");

} else {

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

}


9

DWfile.getAttributes()


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

ArgumentefileURL

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

RückgabewerteEin 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 nachfolgende Zeichen im String darge-stellt:

• R (schreibgeschützt)

• D (Ordner)

• H (verborgen)

• S (Systemdatei oder Ordner)

BeispielDer folgende Code fragt die Attribute der Datei mydata.txt ab und zeigt eine Warnmeldung an, falls die Datei schreibge-schützt ist:


var str = DWfile.getAttributes(fileURL);

if (str && (str.indexOf("R") != -1)){

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

}

DWfile.getModificationDate()


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

ArgumentefileURL

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

RückgabewerteEin 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.


10

BeispielSie sollten die Funktion zweimal aufrufen und die Rückgabewerte vergleichen, da der Rückgabewert dieser Funktion platt-formabhängig ist und keine direkt lesbaren Datums- und Uhrzeitwerte darstellt. Der folgende Code fragt das Änderungs-datum von Datei1.txt und Datei2.txt ab und zeigt eine Meldung an, in der angegeben wird, welche der beiden Dateien aktueller ist:

var file1 = "file:///c|/temp/file1.txt";


var time1 = DWfile.getModificationDate(file1);


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()


BeschreibungDiese Funktion fragt die Uhrzeit ab, zu der die Datei erstellt wurde.

ArgumentefileURL

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

RückgabewerteEin 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.

BeispielSie können diese Funktion und die Funktion DWfile.getModificationDate() aufrufen, um das Änderungsdatum einer Datei mit ihrem Erstelldatum zu vergleichen:


var time1 = DWfile.getCreationDate(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ügbarkeitDreamweaver MX

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


11

ArgumentefileURL

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

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

DWfile.getModificationDateObj()


BeschreibungDiese Funktion ruft das JavaScript Date-Objekt für den Zeitpunkt der letzten Änderung an einer Datei ab.

ArgumentefileURL

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

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

DWfile.getSize()


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

ArgumentefileURL

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

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

DWfile.listFolder()


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

ArgumentefolderURL, {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.


12

RückgabewerteEin String-Array mit den einzelnen Elementen des Ordners.

BeispielDer 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"));

}

DWfile.read()


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

ArgumentefileURL

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

RückgabewerteEin String, in dem sich der Inhalt der Datei befindet, oder der Wert null, wenn der Lesevorgang fehlgeschlagen ist.

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


var str = DWfile.read(fileURL);

if (str){

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

}

DWfile.remove()


BeschreibungDiese Funktion löscht die angegebene Datei.

ArgumentefileURL

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

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false.


13

BeispielIm nachfolgenden Beispiel wird mit DWfile.getAttributes() ermittelt, ob eine Datei schreibgeschützt ist, und mit confirm() ein Ja/Nein-Dialogfeld in der Benutzeroberfläche angezeigt:

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()


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

ArgumentefileURL, 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 nachfol-genden Tabelle sind gültige Attributwerte und ihre Bedeutungen aufgeführt:

Gültige Werte für den strAttrs-String sind R, W, H, V, RH, RV, WH oder WV.

R und W schließen sich gegenseitig aus und sollten daher nicht gemeinsam verwendet werden. Werden sie in der Kombi-nation eingesetzt, wird R außer Kraft gesetzt, und der Schreibschutz für die Datei wird aufgehoben (W). Auch H und V schließen sich gegenseitig aus. Wenn Sie sie kombinieren, wird H außer Kraft gesetzt, und die Datei wird auf sichtbar (V) gesetzt.

Legen Sie H oder V ohne das Lese-/Schreibattribut R oder W fest, bleibt das aktuelle Lese-/Schreibattribut der Datei unver-ändert. Wenn Sie R oder W, festlegen, ohne das Attribut H oder V anzugeben, bleibt das aktuelle Sichtbarkeitsattribut der Datei ebenfalls bestehen.

RückgabewerteKeine

Attributwert Beschreibung

R Schreibgeschützt

W Kein Schreibschutz (überschreibt R)

H Verborgen

V Sichtbar (überschreibt H)


14

DWfile.write()


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

ArgumentefileURL, text, {mode}

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

• Das Argument text ist der String, der geschrieben wird.

• Als mode-Argument (falls angegeben) muss "append" verwendet werden. Sollte dieses Argument nicht verwendet werden, wird der Datei-Inhalt durch den String überschrieben.

RückgabewerteEin Boolescher Wert: true bei erfolgreichem Schreibvorgang, andernfalls false.

BeispielDer folgende Code schreibt den String "xxx" in die Datei mydata.txt und gibt nach einem erfolgreichen Schreibvorgang eine Meldung aus. Anschließend wird der String "aaa" an die Datei angehängt. Falls dieser Vorgang erfolgreich verläuft, wird eine zweite Meldung ausgegeben. Nach Ausführung des Skripts enthält die Datei mydata.txt lediglich den Text xxxaaa.


if (DWfile.write(fileURL, "xxx")){

alert("Wrote xxx to " + fileURL);

}

if (DWfile.write(fileURL, "aaa", "append")){

alert("Appended aaa to " + fileURL);

}

15

Kapitel 3: Die HTTP-API

Die Einsatzmöglichkeiten der Erweiterungen beschränken sich nicht auf das lokale Dateisystem. Adobe® Dreamweaver® CS3 bietet einen Mechanismus, um über HTTP (Hypertext Transfer Protocol) Informationen von einem Webserver abzurufen bzw. an diesen zu senden. 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, besitzt das Objekt zwei Eigenschaften: statusCode und data.

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

• 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

Ein umfassende Liste der Statuscodes für Ihren Server erhalten Sie bei Ihrem Internet-Service-Provider oder Ihrem Systemadministrator.

Der Wert der Eigenschaft data ist von der jeweiligen Funktion abhängig. Die möglichen Werte sind bei den einzelnen Funktionsbeschreibungen verzeichnet.

Funktionen, die ein Objekt zurückgeben, sind jeweils auch in einer so genannten 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.

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

MMHttp.clearServerScriptsFolder()


BeschreibungLö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\Connec-tions\Scripts\Servermodell\_mmDBScripts.

16

ArgumenteserverScriptsfolder

• serverScriptsfolder ist ein String, der einen bestimmten Ordner relativ zum Ordner Configuration auf dem Anwen-dungsserver bezeichnet, von dem Sie Serverskripts abrufen möchten.

RückgabewerteEin Objekt, das die Antwort vom Server repräsentiert. Die Eigenschaft data dieses Objekts ist ein String mit dem Inhalt des gelöschten Skripts. Falls ein Fehler auftritt, zeigt Dreamweaver diesen in der Eigenschaft statusCode des zurückgegebenen Objekts an.

BeispielWenn der folgende Code in einer Menübefehlsdatei im Ordner Configuration\Menus steht, entfernt er beim Aufruf von einem Menü aus alle Dateien aus dem Ordner _mmServerScripts:



<HTML>

<head>

<TITLE>Clear Server Scripts

</TITLE>

<SCRIPT SRC="ClearServerScripts.js"></SCRIPT>

<SCRIPT LANGUAGE="javascript">

</SCRIPT>

<body onLoad="MMHttp.clearServerScriptsFolder()">

</body>

</html>

MMHttp.clearTemp()

BeschreibungDiese Funktion löscht alle Dateien im Ordner Configuration\Temp, der sich im Anwendungsordner von Dreamweaver befindet.

ArgumenteKeine

RückgabewerteKeine

BeispielWenn 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>


17

MMHttp.getFile()

BeschreibungDiese Funktion ruft die Datei von 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 Ordner-struktur des Servers nachgeahmt wird. Lautet der angegebene Pfad beispielsweise www.dream-central.com/people/index.html, speichert Dreamweaver die Datei index.html im Unterordner People des Ordners www.dreamcentral.com.

ArgumenteURL, {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 aufge-fordert wird. Wenn sich saveURL auf einen Speicherort außerhalb des Ordners Configuration/Temp bezieht, wird der Wert false für das Argument prompt 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 enthält die Bezeichnung, die in der Titelleiste des Dialogfelds Speichern angezeigt wird.

RückgabewerteEin Objekt, das die Antwort vom Server repräsentiert. Die Eigenschaft data dieses Objekts ist ein String, der den Speicherort enthält, an dem die Datei gespeichert ist (im URL-Format „file://“). Normalerweise enthält die Eigenschaft statusCode des Objekts den vom Server empfangenen Statuscode. Wenn jedoch beim Speichern auf dem lokalen Laufwerk ein Fehler aufgetreten ist und der Vorgang nicht erfolgreich ausgeführt werden kann, enthält die Eigenschaft statusCode als Fehlercode einen der folgenden ganzzahligen Werte:

• 1: Unbekannter Fehler

• 2: Datei nicht gefunden

• 3: Ungültiger Pfad

• 4: Zu viele Dateien geöffnet

• 5: Zugriff verweigert

• 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


18

BeispielMit dem folgenden Code wird zunächst eine HTML-Datei abgerufen. Dann werden alle Dateien im Ordner Configu-ration\Temp gespeichert und die lokale Kopie der HTML-Datei 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);

}

MMHttp.getFileCallback()

BeschreibungDiese Funktion ruft die Datei von 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.dream-central.com/people/index.html, speichert Dreamweaver die Datei index.html im Unterordner People des Ordners www.dreamcentral.com.

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

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


• Das optionale Argument prompt ist ein Boolescher Wert, der angibt, ob der Benutzer zum Speichern der Datei aufge-fordert wird. Wenn sich saveURL auf einen Speicherort außerhalb des Ordners Configuration\Temp bezieht, wird der Wert false für das Argument prompt 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 enthält die Bezeichnung, die in der Titelleiste des Dialogfelds Speichern angezeigt wird.

RückgabewerteEin Objekt, das die Antwort vom Server repräsentiert. Die Eigenschaft data dieses Objekts ist ein String, der den Ort enthält, an dem die Datei gespeichert wurde (im URL-Format „file://“). Normalerweise enthält die Eigenschaft statusCode des Objekts den vom Server empfangenen Statuscode. Wenn jedoch beim Speichern auf dem lokalen Laufwerk ein Daten-trägerfehler aufgetreten ist, enthält die Eigenschaft statusCode einen ganzzahligen Fehlercode. Eine Liste der möglichen Fehlercodes finden Sie unter „MMHttp.getFile()“ auf Seite 17.

MMHttp.getText()

VerfügbarkeitDreamweaver UltraDev 4; verbessert in Dreamweaver MX.

BeschreibungRuft den Inhalt des Dokuments von der angegebenen URL ab.


19

ArgumenteURL, {serverScriptsFolder}

• Das Argument URL ist eine absolute URL auf einem Webserver. Auch wenn in der URL „http://“ nicht enthalten ist, geht Dreamweaver davon aus, dass das HTTP-Protokoll verwendet wird.

• Das Argument serverScriptsFolder ist ein optionaler String, der einen bestimmten Ordner relativ zum Ordner Confi-guration 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.

Falls ein Fehler auftritt, zeigt Dreamweaver diesen in der Eigenschaft statusCode des zurückgegebenen Objekts an.

MMHttp.getTextCallback()

VerfügbarkeitDreamweaver UltraDev 4, erweitert in Dreamweaver MX.

BeschreibungRuft den Inhalt des Dokuments von der angegebenen URL ab und leitet ihn an die angegebene Funktion weiter.

ArgumentecallbackFunc, URL, {serverScriptsFolder}

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


• Das Argument serverScriptsFolder ist ein optionaler String, der einen bestimmten Ordner relativ zum Ordner Confi-guration 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.

Falls ein Fehler auftritt, zeigt Dreamweaver MX diesen in der Eigenschaft statusCode des zurückgegebenen Objekts an.

MMHttp.postText()


BeschreibungFü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.


20

ArgumenteURL, dataToPost, {contentType}, {serverScriptsFolder}


• 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 Standard "application/x-www-form-urlencoded" verwendet.

• Das Argument serverScriptsFolder ist ein optionaler String, der einen bestimmten Ordner relativ zum Ordner Confi-guration 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).


BeispielIm 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/"

)

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 in den Eigenschaften zur Seitenkonfiguration 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()


BeschreibungFührt einen HTTP-Sendevorgang an die angegebene URL durch 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.

http://www.faqs.org/rfcs/rfc1866.html


21

ArgumentecallbackFunc, URL, dataToPost, {contentType}, {serverScriptsFolder}

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


• 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 Standard "application/x-www-form-urlencoded" verwendet.

• serverScriptsFolder ist ein optionaler String. Er bezeichnet einen bestimmten Ordner relativ zum Ordner Configu-ration 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.


http://www.faqs.org/rfcs/rfc1866.html


22

23

Kapitel 4: API für Design Notes

Mit Adobe® Dreamweaver® CS3, Fireworks und Flash haben Webdesigner und Webentwickler die Möglichkeit, zusätzliche Informationen über Dokumente zu speichern und abzurufen. Zu diesen Informationen gehören Revisionskommentare, Änderungshinweise oder der Name der Quelldatei einer GIF- oder JPEG-Grafik. Diese Informationen werden in Dateien gespeichert, die Design Notes genannt werden.

MMNotes ist eine gemeinsam genutzte C-Bibliothek, mit deren Hilfe die Autoren von Erweiterungen Design Notes-Dateien lesen und schreiben können. MMNotes weist wie die gemeinsam genutzte Bibliothek DWfile eine JavaScript-API auf, über die alle in der Bibliothek enthaltenen Funktionen von Objekten, Befehlen, Verhalten, schwebenden Bedien-feldern, Eigenschafteninspektoren und Datenübersetzern aus aufgerufen werden können.

MMNotes hat darüber hinaus eine C-API, die es anderen Anwendungen ermöglicht, Design Notes-Dateien zu lesen und zu schreiben. Die gemeinsam genutzte Bibliothek MMNotes kann unabhängig von Dreamweaver verwendet werden, sogar wenn Dreamweaver überhaupt nicht installiert ist.

Weitere Informationen über die Nutzung von Design Notes in Dreamweaver finden Sie in der Dokumentation Dream-weaver verwenden.

Funktionsweise von Design NotesIn jeder Design Notes-Datei sind Informationen über ein einziges 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 Site 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 zur Datei avocado8.gif beispielsweise trägt den Namen avocado8.gif.mno.

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 eigentliche Information dar. Schlüssel können höchstens 64 Zeichen lang sein.

Das folgende Beispiel zeigt die Design Notes-Datei für die Beispieldatei foghorn.gif.mno:

<?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 NotesAlle Funktionen der JavaScript-API für Design Notes sind Methoden des Objekts MMNotes.

MMNotes.close()

BeschreibungDiese 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, löscht Dreamweaver auch den Ordner.


24

Hinweis: Rufen Sie immer die Funktion MMNotes.close() auf, wenn Sie Ihre Arbeit mit Design Notes abgeschlossen haben, um Dreamweaver zu veranlassen, in die Datei zu schreiben.

ArgumentefileHandle

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

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „MMNotes.set()“ auf Seite 27.

MMNotes.filePathToLocalURL()

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

ArgumentedrivePath

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

RückgabewerteEin String mit der URL der angegebenen Datei (im URL-Format „file://“).

BeispielBeim Aufruf von MMNotes.filePathToLocalURL('C:\sites\webdev\index.htm') wird der String "file:///c|/sites/webdev/index.htm" zurückgegeben.

MMNotes.get()

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

ArgumentefileHandle, 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.

RückgabewerteEin String mit dem Wert des Schlüssels.

BeispielWeitere Informationen finden Sie unter „MMNotes.getKeys()“ auf Seite 25.

MMNotes.getKeyCount()

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

ArgumentefileHandle



25

RückgabewerteEin ganzzahliger Wert, der die Anzahl der Schlüssel-Wert-Paare in der Design Notes-Datei angibt.

MMNotes.getKeys()

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

ArgumentefileHandle


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

BeispielDer folgende Code könnte 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;

// noteHandle immer schließen

MMNotes.close(noteHandle);

MMNotes.getSiteRootForFile()

BeschreibungDiese Funktion bestimmt den Stammordner für die angegebene Design Notes-Datei.

ArgumentefileURL

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

RückgabewerteEin String, der den Pfad des lokalen Stammordners der Site enthält (im URL-Format „file://“), bzw. 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()

BeschreibungDiese Funktion ruft den Versionsnamen der gemeinsam genutzten Bibliothek MMNotes ab, der gleichzeitig die implemen-tierende Anwendung angibt.

ArgumenteKeine

RückgabewerteEin String mit dem Namen der Anwendung, die die gemeinsam genutzte Bibliothek MMNotes implementiert hat.


26

BeispielWenn die Funktion MMNotes.getVersionName() von einem Dreamweaver-Befehl, einem Objekt, einem Verhalten, einem Eigenschafteninspektor, einem schwebenden Bedienfeld oder einem Datenübersetzer aus aufgerufen wird, wird der String "Dreamweaver" zurückgegeben. Durch Aufrufen der Funktion MMNotes.getVersionName() von Fireworks aus wird auch "Dreamweaver" zurückgegeben, da Fireworks dieselbe Bibliotheksversion verwendet, die vom Dreamweaver-Entwick-lungsteam erstellt wurde.

MMNotes.getVersionNum()

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

ArgumenteKeine

RückgabewerteEin String, der die Versionsnummer enthält.

MMNotes.localURLToFilePath()

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

ArgumentefileURL

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

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

BeispielBeim Aufruf von MMNotes.localURLToFilePath(‘file:///MacintoshHD/images/moon.gif’) wird der String "Macin-toshHD:images:moon.gif" zurückgegeben.

MMNotes.open()

BeschreibungDiese Funktion öffnet die der angegebenen Datei zugeordnete Design Notes-Datei bzw. erstellt eine solche, falls noch keine existiert.

ArgumentefilePath, {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 Note auch dann erstellt werden soll, wenn Design Notes für die Site deaktiviert sind oder filePath mit keiner Site verknüpft ist.

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

BeispielWeitere Informationen finden Sie unter „MMNotes.set()“ auf Seite 27.


27

MMNotes.remove()

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

ArgumentefileHandle, keyName


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


MMNotes.set()

BeschreibungDiese Funktion erstellt bzw. aktualisiert ein Schlüssel-Wert-Paar in einer Design Notes-Datei.

ArgumentefileHandle, keyName, valueString


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

• Das Argument valueString ist ein String, der den Wert enthält.


BeispielMit dem folgenden Beispielcode wird die mit der Site dreamcentral verknüpfte Design Notes-Datei peakhike99\index.html geöffnet, dieser ein neues Schlüssel-Wert-Paar hinzugefügt, der Wert eines bestehenden Schlüssels geändert und danach die Design Notes-Datei geschlossen.

var noteHandle = MMNotes.open('file:///c|/sites/dreamcentral/peakhike99/

index.html',true);

if(noteHandle > 0){

MMNotes.set(noteHandle,"Author","M. G. Miller");

MMNotes.set(noteHandle,"Last Changed","August 28, 1999");

MMNotes.close(noteHandle);

}

C-API für Design NotesAbgesehen von der JavaScript-API enthält die gemeinsam genutzte Bibliothek MMNotes auch eine C-API, über die andere Anwendungen Design Notes-Dateien erstellen können. Wenn Sie die Bibliothek MMNotes in Dreamweaver verwenden, brauchen Sie diese C-Funktionen nicht direkt aufzurufen, da die entsprechenden JavaScript-Versionen der Funktionen dies für Sie übernehmen.

Dieser Abschnitt enthält eine Beschreibung der Funktionen und deren Argumente und Rückgabewerte. Sie finden die Definition der Funktionen und Datentypen in der Datei MMInfo.h im Ordner Extending\c_files innerhalb des Anwen-dungsordners von Dreamweaver.


28

void CloseNotesFile()

BeschreibungDiese Funktion schließt die angegebene Design Notes-Datei und speichert alle Änderungen. Wenn alle Schlüssel-Wert-Paare aus der Design Notes-Datei entfernt wurden, löscht Dreamweaver die Datei. Dreamweaver entfernt den Ordner _notes, nachdem die letzte Design Notes-Datei gelöscht wurde.

ArgumentenoteHandle

• Das Argument noteHandle ist das von der Funktion OpenNotesFile() zurückgegebene Datei-Handle.

RückgabewerteKeine

BOOL FilePathToLocalURL()

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

Argumenteconst char* drivePath, char* localURLBuf, int localURLMaxLen

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

• Das Argument localURLBuf bezeichnet den Puffer, in dem der URL-String „file://“ gespeichert wird.

• Das Argument localURLMaxLen ist die maximale Größe von localURLBuf.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. Das Argument localURLBuf erhält den Wert des URL-Strings „file://“.

BOOL GetNote()

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

ArgumenteFileHandle noteHandle, const char keyName[64], char* valueBuf, int valueBufLength


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

• Das Argument valueBuf bezeichnet den Puffer, in dem der Wert gespeichert wird.

• Das Argument valueBufLength ist die Ganzzahl, die von GetNoteLength(noteHandle, keyName) zurückgegeben wird und die maximale Länge des Wertepuffers angibt.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. Das Argument valueBuf erhält den Wert des Schlüssels.

BeispielMit dem folgenden Code wird der Wert des Schlüssels comments in der mit welcome.html verknüpften Design Notes-Datei abgerufen:


29

FileHandle noteHandle = OpenNotesFile("file:///c|/sites/avocado8/iwjs/welcome.html");

if(noteHandle > 0){

int valueLength = GetNoteLength( noteHandle, "comments");

char* valueBuffer = new char[valueLength + 1];

GetNote(noteHandle, "comments", valueBuffer, valueLength + 1);

printf("Comments: %s",valueBuffer);

CloseNotesFile(noteHandle);

}

int GetNoteLength()

BeschreibungDiese Funktion ruft die Länge des Werts für den angegebenen Schlüssel ab.

ArgumenteFileHandle noteHandle, const char keyName[64]



RückgabewerteEine Ganzzahl, die die Länge des Werts angibt.

BeispielWeitere Informationen finden Sie unter „BOOL GetNote()“ auf Seite 28.

int GetNotesKeyCount()

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

ArgumenteFileHandle noteHandle


RückgabewerteEin ganzzahliger Wert, der die Anzahl der Schlüssel-Wert-Paare in der Design Notes-Datei angibt.

BOOL GetNotesKeys()

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

ArgumenteFileHandle noteHandle, char* keyBufArray[64], int keyArrayMaxLen

• Das Argument noteHandle ist das von OpenNotesFile() zurückgegebene Datei-Handle.

• Das Argument keyBufArray[64] bezeichnet das Pufferfeld, wo die Schlüssel gespeichert werden.

• Das Argument keyArrayMaxLen ist der von GetNotesKeyCount(noteHandle) zurückgegebene ganzzahlige Wert, der die maximale Anzahl von Elementen im Schlüsselpuffer-Array angibt.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. Das Argument keyBufArray erhält die Schlüsselnamen.


30

BeispielMit dem folgenden Code werden die Schlüsselnamen und -werte sämtlicher Schlüssel in der Design Notes-Datei von welcome.html ausgegeben:

typedef char[64] InfoKey;

FileHandle noteHandle = OpenNotesFile("file:///c|/sites/avocado8/iwjs/welcome.html");

if(noteHandle > 0){

int keyCount = GetNotesKeyCount(noteHandle);

if (keyCount <= 0)

return;

InfoKey* keys = new InfoKey[keyCount];

BOOL succeeded = GetNotesKeys(noteHandle, keys, keyCount);

if (succeeded){

for (int i=0; i < keyCount; i++){

printf("Key is: %s\n", keys[i]);

printf("Value is: %s\n\n", GetNote(noteHandle, keys[i]);

}

}

delete []keys;

}

CloseNotesFile(noteHandle);

BOOL GetSiteRootForFile()

BeschreibungDiese Funktion bestimmt den Stammordner für die angegebene Design Notes-Datei.

Argumenteconst char* filePath, char* siteRootBuf, int siteRootBufMaxLen, {InfoPrefs* infoPrefs}

• Das Argument filePath im URL-Format „file://“ ist die Datei, deren Stammordner ermittelt werden soll.

• Das Argument siteRootBuf bezeichnet den Puffer, in dem der Stammordner gespeichert ist.

• siteRootBufMaxLen ist die maximale Größe des Puffers, auf den siteRootBuf verweist.

• Das optionale Argument infoPrefs ist ein Verweis auf eine struct, in der die Voreinstellungen für die Site gespeichert werden.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. Das Argument siteRootBuf erhält die Adresse des Puffers, in dem der Stammordner gespeichert ist. Wenn Sie infoPrefs angeben, werden auch die Design Notes-Voreinstellungen für die Site zurückgegeben. Die struct InfoPrefs besitzt zwei Variablen: bUseDesignNotes und bUploadDesignNotes, beide vom Typ BOOL.

BOOL GetVersionName()

BeschreibungDiese Funktion ruft den Versionsnamen der gemeinsam genutzten Bibliothek MMNotes ab, der gleichzeitig die implemen-tierende Anwendung angibt.

Argumentechar* versionNameBuf, int versionNameBufMaxLen

• Das Argument versionNameBuf bezeichnet den Puffer, in dem der Versionsname gespeichert wird.

• versionNameBufMaxLen ist die maximale Größe des Puffers, auf den versionNameBuf verweist.


31

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. Dreamweaver speichert "Dreamweaver" im Argument versionNameBuf.

BOOL GetVersionNum()

BeschreibungDiese Funktion ruft die Versionsnummer der gemeinsam genutzten Bibliothek MMNotes ab, sodass Sie ermitteln können, ob bestimmte Funktionen verfügbar sind.

Argumentechar* versionNumBuf, int versionNumBufMaxLen

• Das Argument versionNumBuf bezeichnet den Puffer, in dem die Versionsnummer gespeichert wird.

• versionNumBufMaxLen ist die maximale Größe des Puffers, auf den versionNumBuf verweist.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. versionNumBuf speichert die Versions-nummer.

BOOL LocalURLToFilePath()

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

Argumenteconst char* localURL, char* drivePathBuf, int drivePathMaxLen

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

• Das Argument drivePathBuf bezeichnet den Puffer, in dem die lokale Pfadangabe gespeichert wird.

• drivePathMaxLen ist die maximale Größe des Puffers, auf den drivePathBuf verweist.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vorgang, andernfalls false. drivePathBuf erhält die lokale Pfadangabe.

FileHandle OpenNotesFile()

BeschreibungDiese Funktion öffnet die der angegebenen Datei zugeordnete Design Notes-Datei bzw. erstellt eine solche, falls noch keine existiert.

Argumenteconst char* localFileURL, {BOOL bForceCreate}

• Das Argument localFileURL im URL-Format „file://“ ist ein String, der den Pfad zur Hauptdatei, mit der die Design Notes-Datei verknüpft ist, enthält.

• 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 sind oder der für localFileURL angegebene Pfad mit keiner Site verknüpft ist.

FileHandle OpenNotesFilewithOpenFlags()

BeschreibungDiese Funktion öffnet die der angegebenen Datei zugeordnete Design Notes-Datei bzw. erstellt eine solche, falls noch keine existiert. Die Datei kann im schreibgeschützten Modus geöffnet werden.


32

Argumenteconst char* localFileURL, {BOOL bForceCreate}, {BOOL bReadOnly}

• Das Argument localFileURL im URL-Format „file://“ ist ein String, der den Pfad zur Hauptdatei, mit der die Design Notes-Datei verknüpft ist, enthält.

• 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 sind oder der Pfad mit keiner Site verknüpft ist. Der Standardwert ist false. Dieses Argument ist optional, doch muss es angegeben werden, wenn Sie das dritte Argument angeben.

• Das optionale Argument bReadOnly ist ein Boolescher Wert, der angibt, ob die Datei im schreibgeschützten Modus geöffnet werden soll. Der Standardwert ist false. bReadOnly ist ab Version 2 von MMNotes.dll verfügbar.

BOOL RemoveNote()

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

ArgumenteFileHandle noteHandle, const char keyName[64]


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


BOOL SetNote()

BeschreibungDiese Funktion erstellt bzw. aktualisiert ein Schlüssel-Wert-Paar in einer Design Notes-Datei.

ArgumenteFileHandle noteHandle, const char keyName[64], const char* value



• Das Argument value ist ein String, der den Wert enthält.


33

Kapitel 5: Integration von Fireworks

FWLaunch ist eine gemeinsam genutzte C-Bibliothek, durch die Autoren von Objekten, Befehlen, Verhalten und Eigen-schafteninspektoren mit Adobe® Fireworks® kommunizieren können. Mithilfe von FWLaunch können Sie JavaScript-Code schreiben, um die Fireworks-Benutzeroberfläche zu öffnen und Befehle an Fireworks über dessen eigene JavaScript-API zu senden. Informationen dazu finden Sie im Handbuch Extending Fireworks. Allgemeine Informationen über das Zusam-menwirken von C-Bibliotheken mit dem JavaScript-Interpreter in Adobe® Dreamweaver® CS3 finden Sie im Handbuch Dreamweaver erweitern unter „C-Level-Erweiterbarkeit“.

FWLaunch-APIMit dem FWLaunch-Objekt können Sie Fireworks öffnen, Fireworks-Operationen über die JavaScript-API von Fireworks durchführen und anschließend Werte an Dreamweaver zurückgeben. In diesem Kapitel werden die FWLaunch-Kommu-nikations-API und deren Verwendung erläutert.

FWLaunch.bringDWToFront()

VerfügbarkeitDreamweaver 3, Fireworks 3.

BeschreibungDiese Funktion stellt Dreamweaver in den Vordergrund.

ArgumenteKeine

RückgabewerteKeine

FWLaunch.bringFWToFront()


BeschreibungDiese Funktion stellt Fireworks in den Vordergrund, falls es ausgeführt wird.

ArgumenteKeine

RückgabewerteKeine


34

FWLaunch.execJsInFireworks()


BeschreibungDiese Funktion übergibt das angegebene JavaScript oder einen Verweis auf eine JavaScript-Datei zur Ausführung an Fireworks.

ArgumentejavascriptOrFileURL

• Das Argument javascriptOrFileURL im URL-Format „file://“ enthält entweder expliziten JavaScript-Code oder den Pfad zu einer JavaScript-Datei.

RückgabewerteEin Cookie-Objekt, falls die JavaScript-Daten erfolgreich übergeben wurden, oder ein Fehlercode ungleich Null, falls einer der folgenden Fehler aufgetreten ist:

• Ungültige Verwendung: javascriptOrFileURL wurde als null oder als leerer String definiert, oder der Pfad zu der .JS- bzw. .JSF-Datei ist ungültig.

• I/O-Dateifehler: Fireworks konnte keine Antwortdatei erstellen, da die Festplatte voll ist.

• Fehlermeldung an Dreamweaver: Benutzer führt keine gültige Version von Dreamweaver (Version 3 oder höher) aus.

• Fehler beim Starten des Fireworks-Prozesses: Die Funktion startet keine gültige Version von Fireworks (Version 3 oder höher erforderlich).

• Die Aktion wurde vom Benutzer abgebrochen.

FWLaunch.getJsResponse()


BeschreibungDiese Funktion bestimmt, ob Fireworks noch immer den von FWLaunch.execJsInFireworks() übergebenen JavaScript-Code ausführt, ob das Skript erfolgreich beendet wurde oder ob ein Fehler aufgetreten ist.

ArgumenteprogressTrackerCookie

• Das Argument progressTrackerCookie ist das von der Funktion FWLaunch.execJsInFireworks() zurückgegebene Cookie-Objekt.

RückgabewerteEin String mit dem Ergebnis des an FWLaunch.execJsInFireworks() übergebenen Skripts, falls der Vorgang erfolgreich beendet wurde. Der Wert ist null, wenn Fireworks noch immer den JavaScript-Code ausführt. Ein Fehlercode ungleich Null wird zurückgegeben, wenn einer der folgenden Fehler aufgetreten ist:

• Ungültige Verwendung: Beim Ausführen des Skripts ist ein JavaScript-Fehler aufgetreten.

• I/O-Dateifehler: Fireworks konnte keine Antwortdatei erstellen, da die Festplatte voll ist.

• Fehlermeldung an Dreamweaver: Benutzer führt keine gültige Version von Dreamweaver (Version 3 oder höher) aus.

• Fehler beim Starten des Fireworks-Prozesses: Die Funktion startet keine gültige Version von Fireworks (3 oder höher erforderlich).



35

BeispielDer folgende Code übergibt den String "prompt('Geben Sie Ihren Namen ein:')" an FWLaunch.execJsInFireworks() und prüft dann das Ergebnis:

var progressCookie = FWLaunch.execJsInFireworks("prompt('Please enter your name:')");

var doneFlag = false;

while (!doneFlag){

// alle 0,5 Sekunden auf Abschluss prüfen

setTimeout('checkForCompletion()',500);

}

function checkForCompletion(){

if (progressCookie != null) {

var response = FWLaunch.getJsResponse(progressCookie);

if (response != null) {

if (typeof(response) == "number") {

// Fehler oder Abbruch durch Benutzer, Fenster schließen

// und den Benutzer über Fehler benachrichtigen

window.close();

alert("An error occurred.");

} else {

// gültige Antwort!

alert("Nice to meet you, " + response);

window.close();

}

doneFlag = true;

}

}

}

FWLaunch.mayLaunchFireworks()


BeschreibungDiese Funktion bestimmt, ob der Start einer Fireworks-Optimierungssitzung möglich ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob Windows oder Macintosh als Plattform verwendet wird. Bei Macintosh wird angezeigt, ob bereits eine weitere Fireworks-Optimierungssitzung ausgeführt wird.

FWLaunch.optimizeInFireworks()


BeschreibungDiese Funktion startet für das angegebene Bild eine Fireworks-Optimierungssitzung.


36

ArgumentedocURL, imageURL, {targetWidth}, {targetHeight}

• Das Argument docURL ist der Pfad zum aktiven Dokument im URL-Format „file://“.

• imageURL ist der Pfad zum ausgewählten Bild. Wenn der Pfad relativ ausgedrückt ist, ist er relativ zu dem in docURL angegebenen Pfad.

• Das optionale Argument targetWidth ist die Breite, auf die das Bild angepasst werden soll.

• Das optionale Argument targetHeight ist die Höhe, auf die das Bild angepasst werden soll.

RückgabewerteNull, wenn für das ausgewählte Bild eine Fireworks-Optimierungssitzung erfolgreich gestartet wurde. Ein Fehlercode ungleich Null wird zurückgegeben, falls einer der folgenden Fehler aufgetreten ist:

• Ungültige Verwendung: docURL, imageURL oder beide wurden als null bzw. als leerer String definiert.

• I/O-Dateifehler: Fireworks konnte keine Reaktionsdatei erstellen, da die Festplatte voll ist.

• Fehlermeldung an Dreamweaver: Benutzer arbeitet mit einer ungültigen Version von Dreamweaver (2 oder höher erfor-derlich).

• Fehler beim Starten des Fireworks-Prozesses: Die Funktion startet keine gültige Version von Fireworks (Version 2 oder höher erforderlich).


FWLaunch.validateFireworks()


BeschreibungDiese Funktion sucht auf der Festplatte des Benutzers nach der angegebenen Version von Fireworks.

Argumente{versionNumber}

• Das Argument versionNumber ist ein optionaler Gleitkommawert, der mindestens 2 beträgt. Er stellt die erforderliche Fireworks-Version dar. Bei fehlendem Argument wird der Wert 2 als Standard verwendet.

RückgabewerteEin Boolescher Wert, der angibt, ob die betreffende Version von Fireworks gefunden wurde.

BeispielMit dem folgenden Code wird überprüft, ob Fireworks installiert ist:

if (FWLaunch.validateFireworks(6.0)){

alert("Fireworks 6.0 or later is installed.");

} else {

alert("Fireworks 6.0 is not installed.");

}


37

Einfaches FWLaunch-KommunikationsbeispielMit dem folgenden Befehl wird Fireworks angewiesen, den Benutzer nach seinem Namen zu fragen und diesen Namen an Dreamweaver zu übergeben:

<HTML>

<head>

<title>Prompt in Fireworks

</title>

<meta http-equiv="Content-Type" content="text/html; ¬

charset=iso-8859-1">

<script>

function commandButtons(){

return new Array("Prompt", "promptInFireworks()", "Cancel", ¬

"readyToCancel()", "Close","window.close()");

}

var gCancelClicked = false;

var gProgressTrackerCookie = null;

function readyToCancel() {

gCancelClicked = true;

}

function promptInFireworks() {

var isFireworks3 = FWLaunch.validateFireworks(3.0);

if (!isFireworks3) {

alert("You must have Fireworks 3.0 or later to use this ¬

command");

return;

}

// Fireworks anweisen, die prompt()-Methode auszuführen.

gProgressTrackerCookie = FWLaunch.execJsInFireworks¬

("prompt('Please enter your name:')");

// Null bedeutet, dass Fireworks nicht gestartet wurde, eine Zahl weist auf einen Fehlercode hin.

if (gProgressTrackerCookie == null || ¬

typeof(gProgressTrackerCookie) == "number") {

window.close();

alert("an error occurred");

gProgressTrackerCookie = null;

} else {

// Fireworks in den Vordergrund bringen

FWLaunch.bringFWToFront();

// Prüfung starten, um zu sehen, ob Fireworks schon abgeschlossen wurde

checkOneMoreTime();

}

}

function checkOneMoreTime() {

// alle 0,5 Sekunden die Funktion JsResponse() aufrufen, und überprüfen,

// ob Fireworks schon abgeschlossen wurde

window.setTimeout("checkJsResponse();", 500);

}

function checkJsResponse() {

var response = null;

// Benutzer hat auf 'Abbrechen' geklickt, Fenster schließen

if (gCancelClicked) {

window.close();

alert("cancel clicked");

} else {

// wird noch ausgeführt, Status von Fireworks abfragen

if (gProgressTrackerCookie != null)


38

response = FWLaunch.getJsResponse(gProgressTrackerCookie);

if (response == null) {

// wartet noch auf Antwort, in 0,5 Sekunden noch

// einmal anfragen

checkOneMoreTime();

} else if (typeof(response) == "number") {

// Zahl als Antwort bedeutet, dass ein Fehler aufgetreten ist

// Aktion wurde vom Benutzer in Fireworks abgebrochen

window.close();

alert("an error occurred.");

} else {

// gültige Antwort! Dieser Rückgabewert

// ist nicht immer hilfreich, da nicht alle Funktionen in

// Fireworks einen String zurückgeben, diese aber doch,

// deshalb kann dem Benutzer angezeigt werden, was vorliegt.

window.close();

FWLaunch.bringDWToFront();// Dreamweaver in den Vordergrund bringen

alert("Nice to meet you, " + response + "!");

}

}

}

</script>

</head>

<body>

<formular>

<table width="313" nowrap>

<tr>

<td>This command asks Fireworks to execute the prompt() ¬

aufruft. When you click Prompt, Fireworks comes forward and ¬

asks you to enter a value into a dialog box. That value is then ¬

returned to Dreamweaver and displayed in an alert.</td>

</tr>

</table>

</form>

</body>

</html>

39

Kapitel 6: Flash-Integration

Adobe® Dreamweaver® CS3 unterstützt Flash-Elemente. Außerdem steht eine ständige Unterstützung der API für Flash-Objekte zur Verfügung, wodurch die Flash Generator-Vorlagendatei veranlasst wird, neue Flash-Objekte zu erstellen. In diesem Kapitel werden die Verwendung der Flash-Elemente (SWC-Dateien) beschrieben sowie Details zur Erstellung von Flash-Objekten (SWF-Dateien) mithilfe von Flash Generator-Vorlagen (SWT-Dateien) bereitgestellt.

Informationen zum Hinzufügen von Flash-Inhalt zu Dreamweaver-Objekten oder -Befehlen finden Sie im Handbuch Dreamweaver erweitern.

Funktionsweise von Flash-ElementenFlash-Elemente liegen komprimiert in Form von SWC-Dateien vor. Eine SWC-Datei ist ein von Flash erstellter, kompi-lierter Komponenten-Clip, der von Adobe-Produkten und Produkten anderer Anbieter verwendet werden kann. Dream-weaver stellt den Benutzern diese Komponenten über die Einfügeleiste, das Menü Einfügen oder die Symbolleiste zur Verfügung. Flash-Elemente werden mit dem Flash-Authoring-Tool erstellt. Dreamweaver kann jedoch die Eigenschaften eines Flash-Elements analysieren und sie über das (dem object-Tag untergeordnete) param-Tag darstellen. Benutzer können dann die Attribute des param-Tags bearbeiten, um die Eigenschaften des Elements beim Veröffentlichen zu ändern. (Weitere Informationen zum Arbeiten mit Komponenteneigenschaften in Dreamweaver finden Sie im Abschnitt Dream-weaver verwenden.)

Flash-Elemente einfügenFlash-Elemente werden über den Extension Manager installiert. Dreamweaver fügt den Dokumenten Flash-Elemente auf die gleiche Weise hinzu wie Objekte, die auf der Einfügeleiste oder im Menü Einfügen verfügbar sind (weitere Informa-tionen zum Arbeiten mit Dreamweaver-Objekten finden Sie unter „Objekte der Einfügeleiste“ im Handbuch Dreamweaver erweitern). Benutzer können Strings in ein Dokument einfügen, indem Sie auf der Einfügeleiste auf Objekte klicken oder Menüoptionen im Menü Einfügen auswählen. Flash-Elemente stehen den Benutzern auf der Einfügeleiste oder im Menü Einfügen zur Verfügung. (Sie können also der Einfügeleiste bzw. dem Menü Einfügen ein gültiges Flash-Element hinzu-fügen, das bereits im Ordner Configuration\Objects\FlashElements oder in den entsprechenden Unterordnern abgelegt ist.) Die Entwickler von Erweiterungen können die JavaScript-Funktion „dom.insertFlashElement()“ auf Seite 124 in der Objektdefinitionsdatei verwenden, um einem Dokument verfügbare Flash-Elemente hinzufügen. Wählt der Benutzer das Flash-Element aus, entpackt Dreamweaver die SWC-Datei mit dem Flash-Inhalt (einer SWF-Datei) sowie eine Datei, die mitteilt, welche Parameter vom Benutzer geändert werden. Dreamweaver fügt die SWF-Datei anschließend in das Benut-zerdokument ein.

Flash-Element der Einfügeleiste hinzufügenEin Flash-Element wird wie jedes andere Objekt über das button-Tag zur Einfügeleiste hinzugefügt. Ein button-Tag für ein Flash-Element muss jedoch ein file- und command-Attribut enthalten, damit das Element dem Dokument erfolgreich hinzugefügt werden kann (weitere Informationen zum button-Tag finden Sie unter „Objekte der Einfügeleiste“ im Handbuch Dreamweaver erweitern). Mithilfe des file-Attributs wird Dreamweaver mitgeteilt, wo die Quelldatei des Elements in Bezug auf den Ordner Objects abgelegt ist. Weisen Sie Dreamweaver anschließend über das command-Attribut an, die Funktion dom.insertFlashElement() zu verwenden, wenn der Benutzer auf eine Schaltfläche der Einfügeleiste klickt.

Das folgende Beispiel zeigt den Code, der in die Datei insertbar.xml eingefügt wird (als untergeordnetes Objekt des entsprechenden category- oder menubutton-Tags, abhängig davon, wo die Schaltfläche für das Flash-Element angezeigt werden soll):


40

<button id="FlashElement_Nav" name="Navigation"

file="FlashElements\nav.swc"

command="dw.getDocumentDOM().insertFlashElement('nav.swc')" />

Hinweis: Das Bild für das Flash-Element auf der Einfügeleiste ist in der SWC-Datei festgelegt. Außerdem muss für das button-Tag eines Flash-Elements ein file-Attribut definiert sein.

Flash-Elemente einem Menü hinzufügenIn Dreamweaver kann sich ein Flash-Element auch auf der Einfügeleiste oder in anderen Menüs befinden. Verwenden Sie die JavaScript-Funktion „dom.insertFlashElement()“ auf Seite 124 in der Datei menus.xml, um die Position des Flash-Elements im Menü anzugeben (siehe „Menüs und Menübefehle“ im Handbuch Dreamweaver erweitern). Mithilfe des folgenden Codes in der Datei menus.xml wird unter Einfügen > Flash-Element das Flash-Element Navigation hinzu-gefügt.

<menuitem name="Navigation"

key=""command="dw.getDocumentDOM().insertFlashElement('nav.swc')"

enabled="(dw.getFocus() != 'browser') && (dw.getDocumentDOM() != null && ¬

dw.getDocumentDOM().getParseMode() == 'html')"

id="DWMenu_Insert_FlashElement_Nav" />

API für Flash-ObjekteMit der API für Flash-Objekte können Objekte zum Erstellen einfacher Flash-Inhalte mithilfe von Flash Generator entwickelt werden. Mit dieser API können Sie Parameter in einer Flash Generator-Vorlage festlegen und eine SWF- bzw. eine Bilddatei erstellen. Des Weiteren können Sie mit ihr neue Flash-Objekte erstellen und vorhandene Flash-Objekte lesen und bearbeiten. Die Flash-Funktionsmerkmale für Schaltflächen und Text werden mit dieser API erstellt.

Die SWT-Datei ist eine Flash Generator-Vorlagendatei, in der sich alle erforderlichen Daten für das Erstellen einer Flash-Objektdatei befinden. Mithilfe dieser API-Funktionen können Sie eine neue SWF-Datei (oder Bilddatei) aus einer SWT-Datei erstellen, indem Sie die Parameter der SWT-Datei durch echte Werte ersetzen. Weitere Informationen über Flash finden Sie in der Flash-Dokumentation. Die folgenden Funktionen stellen Methoden des SWFFile-Objekts dar.

SWFFile.createFile()

BeschreibungDiese Funktion generiert eine neue Flash-Objektdatei mit der angegebenen Vorlage und einem Parameter-Array. Außerdem erstellt sie GIF-, PNG-, JPEG- und MOV-Versionen des Titels, sofern für diese Formate Dateinamen angegeben wurden.

Wenn Sie einen optionalen Parameter angeben möchten, der auf andere optionale Parameter folgt, die Sie jedoch nicht verwenden möchten, müssen Sie für die nicht zu verwendenden Parameter leere Strings angeben. Wenn Sie beispielsweise eine PNG-Datei, jedoch keine GIF-Datei angeben möchten, müssen Sie vor dem PNG-Dateinamen einen leeren String angeben.

ArgumentetemplateFile, templateParams, swfFileName, {gifFileName}, {pngFileName}, {jpgFileName}, {movFileName}, {generatorParams}

• Das Argument templateFile ist ein Pfad zu einer Vorlagendatei im URL-Format „file:// “. Hierbei kann es sich um eine SWT-Datei handeln.

• Das Argument templateParams ist ein Array aus Name-Wert-Paaren. Die Namen stehen hierbei für die Parameter-namen in der SWT-Datei und die Werte für die gewünschten Werte dieser Parameter. Damit Dreamweaver eine SWF-Datei als Flash-Objekt erkennt, muss der erste Parameter "dwType" lauten. Der Wert muss ein String sein, der den Namen des Objekttyps repräsentiert, beispielsweise "Flash Text".


41

• Das Argument swfFileName ist der Name einer SWF-Ausgabedatei im URL-Format „file://“ bzw. ein leerer String, der ignoriert wird.

• Das Argument gifFileName ist der Name einer GIF-Ausgabedatei im URL-Format „file://“. Dieses Argument ist optional.

• Das Argument pngFileName ist der Name einer GIF-Ausgabedatei im URL-Format „file://“. Dieses Argument ist optional.

• Das Argument jpgFileName ist der Name einer GIF-Ausgabedatei im URL-Format „file://“. Dieses Argument ist optional.

• Das Argument movFileName ist der Name einer QuickTime-Ausgabedatei im URL-Format „file://“. Dieses Argument ist optional.

• Das Argument generatorParams ist ein String-Array, das optionale Befehlszeilen-Flags für Flash Generator angibt. Dieses Argument ist optional. Die Datenelemente für jeden Flag müssen hinter diesem Argument folgen. Die folgende Tabelle beschreibt die gängigsten Flags.

RückgabewerteEin String, der einen der folgenden Werte enthält:

• "noError" bedeutet, dass der Aufruf erfolgreich war.

• "invalidTemplateFile" bedeutet, dass die angegebene Vorlagendatei ungültig war oder nicht gefunden wurde.

• "invalidOutputFile" bedeutet, dass mindestens einer der angegebenen Ausgabedateinamen ungültig ist.

• "invalidData" bedeutet, dass mindestens eins der Name-Wert-Paare templateParams ungültig war.

• "initGeneratorFailed" bedeutet, dass Flash Generator nicht initialisiert werden konnte.

• "outOfMemory" bedeutet, dass für den Vorgang nicht genügend Speicher zur Verfügung stand.

• "unknownError" bedeutet, dass ein unbekannter Fehler eintrat.

BeispielMit dem folgenden JavaScript wird eine Flash-Objektdatei vom "myType" erstellt, die jeden "text"-String in der Vorlagen-datei durch den String "Hello World" ersetzt. Dabei werden eine GIF- und eine SWF-Datei erstellt.

var params = new Array;

params[0] = "dwType";

params[1] = "myType";

params[2] = "text";

params[3] = "Hello World";

errorString = SWFFile.createFile( "file:///MyMac/test.swt", ¬

params, "file:///MyMac/test.swf", "file:///MyMac/test.gif");

SWFFile.getNaturalSize()

BeschreibungDiese Funktion gibt die natürliche Größe eines unkomprimierten Flash-Inhalts zurück.

ArgumentefileName

• Das Argument fileName ist der Pfad zum Flash-Inhalt im URL-Format „file://“.

Options-Flag Daten Beschreibung Beispiel

-defaultsize Breite, Höhe Stellt die Größe des Ausgabebilds auf die ange-gebene Breite und Höhe ein.

"-defaultsize",

"640", "480"

-exactFit Kein Streckt den Inhalt des Ausgabebilds, um es genau an die festgelegte Ausgabegröße anzu-passen.

"-exactFit"


42

RückgabewerteEin Array mit zwei Elementen, die die Breite und Höhe einer unkomprimierten SWF-Datei angeben bzw. den Wert null, wenn die Datei keine unkomprimierte SWF-Datei ist.

SWFFile.getObjectType()

BeschreibungDiese Funktion gibt den Flash-Objekttyp zurück, d. h. den Wert, der im Parameter dwType übergeben wurde, als die Datei durch die Funktion SWFFile.createFile() erstellt wurde.

ArgumentefileName

• Das Argument fileName ist der Pfad zu einer Flash-Objektdatei im URL-Format „file:// “ Hierbei handelt es sich norma-lerweise um eine SWF-Datei.

RückgabewerteEin String, der den Objekttyp repräsentiert, oder null, wenn die Datei kein Flash-Objekt ist oder nicht gefunden werden konnte.

BeispielMit dem folgenden Code wird geprüft, ob die Datei test.swf ein Flash-Objekt des Typs myType ist:

if ( SWFFile.getObjectType("file:///MyMac/test.swf") == "myType" ){

alert ("This is a myType object.");

} else {

alert ("This is not a myType object.");

}

SWFFile.readFile()

BeschreibungMit dieser Funktion wird eine Flash-Objektdatei gelesen.

ArgumentefileName

• Das Argument fileName ist der Pfad zu einer Flash-Objektdatei im URL-Format „file:// “

RückgabewerteEin String-Array, bei dem das erste Array-Element den vollständigen Pfad zur SWT-Vorlagendatei angibt. Die folgenden Strings geben die Parameter (Name-Wert-Paare) für das Objekt an. Im Array befindet sich hinter jedem Namen der entsprechende Wert. Das erste Name-Wert-Paar ist "dwType" und der entsprechende Wert. Die Funktion gibt den Wert null zurück, wenn die Datei nicht gefunden werden kann oder wenn sie keine Flash-Objektdatei ist.

BeispielDurch Aufrufen von var params = SWFFile.readFile("file:///MyMac/test.swf") werden die folgenden Werte im Parameter-Array zurückgegeben:

"file:///MyMac/test.swt" // Vorlagendatei beim Erstellen dieser .swf-Datei

"dwType" // erster Parameter

"myType" // erster Parameterwert

"text" // zweiter Parameter

"Hello World" // zweiter Parameterwert

43

Kapitel 7: Datenbank-API

Mit den Funktionen der Datenbank-API können Sie Datenbankverbindungen verwalten und auf Informationen zugreifen, die in Datenbanken gespeichert sind. Mit der Datenbank-API werden folgende Aufgaben durchgeführt: Verwalten von und Zugreifen auf Datenbankverbindungen.

Beim Verwalten der Datenbankverbindungen können Sie den Benutzernamen und das Kennwort abfragen, die für den Verbindungsaufbau erforderlich sind, ein Dialogfeld über die Verbindung mit der Datenbank öffnen und ähnliche Aufgaben durchführen.

Beim Zugriff auf Datenbankinformationen können Sie beispielsweise Metadaten abrufen, die das Schema oder die Struktur einer Datenbank beschreiben. Zu diesen Metadaten gehören Informationen über den Namen von Tabellen, Spalten, gespeicherten Prozeduren und Ansichten. Sie können auch die Ergebnisse der Ausführung einer Datenbankabfrage oder gespeicherten Prozedur anzeigen. Für den Zugriff auf eine Datenbank über diese API verwenden Sie SQL-Anweisungen (Structured Query Language).

Datenbank-API-Funktionen werden in der Entwurfsphase ausgeführt, in der die Benutzer ihre Webanwendungen entwerfen, und nicht in der Laufzeit, in der die Webanwendung eingesetzt wird.

Sie können diese Funktionen in einer beliebigen Erweiterung verwenden. Auch die API-Funktionen des Adobe® Dream-weaver® CS3-Serververhaltens, der Datenformate und der Datenquellen nutzen diese Datenbankfunktionen.

Die in diesem Kapitel beschriebenen Funktionen sind in den folgenden Abschnitten zusammengefasst:

• „Datenbankverbindungsfunktionen“ auf Seite 45

• „Datenbankzugriffsfunktionen“ auf Seite 56


44

Funktionsweise der Datenbank-API-FunktionDas folgende Beispiel zeigt, wie die Serververhaltensfunktion getDynamicBindings() für Recordset.js definiert ist. Es wird die Funktion MMDB.getColumnAndTypeList() verwendet:

function getDynamicBindings(ss)

{

var serverModel = dw.getDocumentDOM().serverModel.getServerName();

var bindingsAndTypeArray = new Array();

var connName

=

ss.connectionName;

var statement = ss.source;

var rsName

= ss.rsName;

// SQL-Kommentare entfernen

statement = statement.replace(/\/\*[\S\s]*?\*\//g, " ");

var bIsSimple = ParseSimpleSQL(statement);

statement = stripCFIFSimple(statement);

if (bIsSimple) {

statement = RemoveWhereClause(statement,false);

} else {

var pa = new Array();

if (ss.ParamArray != null) {

for (var i = 0; i < ss.ParamArray.length; i++) {

pa[i] = new Array();

pa[i][0] = ss.ParamArray[i].name;

pa[i][1] = ss.ParamArray[i].value;

}

}

var statement = replaceParamsWithVals(statement, pa, serverModel);

}

bindingsAndTypeArray = MMDB.getColumnAndTypeList(connName, statement);

return bindingsAndTypeArray;

}


45

DatenbankverbindungsfunktionenMithilfe von Datenbankverbindungsfunktionen können Sie beliebige Verbindungen herstellen und verwalten, z. B. der in Dreamweaver enthaltenen ADO-, ColdFusion- und JDBC-Verbindungen. Diese Funktionen bilden lediglich eine Schnitt-stelle mit dem Connection Manager; sie werden nicht verwendet, um eine Datenbank direkt aufzurufen. Informationen über Funktionen, die Datenbanken aufrufen, finden Sie unter „Datenbankzugriffsfunktionen“ auf Seite 56.

MMDB.deleteConnection()


BeschreibungDiese Funktion löscht die benannte Datenbankverbindung.

ArgumenteconnName

• Das Argument connName ist der Name der Datenbankverbindung gemäß der Angabe im Connection Manager. Dieses Argument bezeichnet den Namen der zu löschenden Datenbankverbindung.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird eine Datenbankverbindung gelöscht:

function clickedDelete()

{

var selectedObj = dw.serverComponents.getSelectedNode();

if (selectedObj && selectedObj.objectType=="Connection")

{

var connRec = MMDB.getConnection(selectedObj.name);

if (connRec)

{

MMDB.deleteConnection(selectedObj.name);

dw.serverComponents.refresh();

}

}

}

MMDB.getColdFusionDsnList()

VerfügbarkeitDreamweaver UltraDev 4.

BeschreibungDiese Funktion ruft mithilfe der Funktionen getRDSUserName() und getRDSPassword() die ColdFusion-DSNs (Data Source Names = Datenquellennamen) vom Siteserver ab.

ArgumenteKeine

RückgabewerteEin Array mit den ColdFusion-DSNs, die auf dem Server der aktuellen Site gespeichert sind.


46

MMDB.getConnection()


BeschreibungDiese Funktion ruft ein benanntes Verbindungsobjekt ab.

Argumentename

• Das Argument name ist eine Stringvariable, die den Namen der Verbindung bezeichnet, auf die Sie verweisen möchten.

RückgabewerteEin Bezug auf ein benanntes Verbindungsobjekt. Verbindungsobjekte enthalten folgende Eigenschaften:

Hinweis: Bei diesen Eigenschaften handelt es sich um die von Dreamweaver implementierten Standardeigenschaften. Entwickler können eigene Verbindungstypen definieren und diese Standardeigenschaften durch neue Eigenschaften ergänzen oder einen völlig anderen Eigenschaftensatz zur Verfügung stellen.

Eigenschaft Beschreibung

name Verbindungsname

type Wenn useHTTP den Wert false hat, zeigt dies an, welche DLL-Datei zur Laufzeit für den Aufbau der Verbindung mit einer Datenbank verwendet werden soll

string Laufzeit-ADO-Verbindungsstring oder JDBC-URL

dsn ColdFusion DSN

driver Laufzeit-JDBC-Treiber

username Laufzeit-Benutzername

password Laufzeit-Kennwort

useHTTP Ein String, der entweder den Wert true oder false enthält und dadurch anzeigt, ob in der Entwurfsphase ein entfernter Treiber (HTTP-Verbindung) verwendet werden soll; anderenfalls wird ein lokaler Treiber (DLL) verwendet.

includePattern Ein regulärer Ausdruck, mit dem die include-Anweisung auf der Seite in den Ansichten Live Data und Vorschau in Browser gesucht wird.

variables Ein Array der Seitenvariablennamen und ihrer Werte, die in den Ansichten Live Data und Vorschau im Browser verwendet werden.

catalog Wird zur Einschränkung der angezeigten Metadaten verwendet (weitere Informatio-nen finden Sie unter „MMDB.getProcedures()“ auf Seite 60).

schema Wird zur Einschränkung der angezeigten Metadaten verwendet (weitere Informatio-nen finden Sie unter „MMDB.getProcedures()“ auf Seite 60).

filename Dateiname des Dialogfelds, das zur Erstellung der Verbindung verwendet wurde


47

MMDB.getConnectionList()


BeschreibungDiese Funktion ruft eine Liste aller im Connection Manager definierten Verbindungsstrings ab.

ArgumenteKeine

RückgabewerteEin String-Array. Jeder String ist hierbei der Name einer Verbindung laut Anzeige im Connection Manager.

BeispielEin Aufruf von MMDB.getConnectionList() kann die Strings ["EmpDB", "Test", "TestEmp"] zurückgeben.

MMDB.getConnectionName()


BeschreibungDiese Funktion ruft einen Verbindungsnamen ab, der dem angegebenen Verbindungsstring entspricht. Diese Funktion ist nützlich, wenn Sie aus Daten auf der Seite einen Verbindungsnamen in der Benutzeroberfläche neu auswählen.

Sollte sich ein Verbindungsstring auf zwei verschiedene Treiber beziehen, können Sie sowohl den Verbindungsstring als auch den Treiber, der dem zurückzugebenden Verbindungsnamen entspricht, angeben. Sie können beispielsweise zwei Verbindungen haben:

• Connection 1 hat folgende Eigenschaften:ConnectionString="jdbc:inetdae:velcro-qa-5:1433?database=pubs"

DriverName="com.inet.tds.TdsDriver"

• Connection 2 hat folgende Eigenschaften:ConnectionString="jdbc:inetdae:velcro-qa-5:1433?database=pubs"

DriverName="com.inet.tds.TdsDriver2"

Connection 1 und Connection 2 verwenden beide denselben Verbindungsstring. Connection 2 stellt eine Verbindung zu einer neueren Version des Treibers TdsDriver her. Sie sollten den Treibernamen an diese Funktion weiterleiten, um den zurückzugebenden Verbindungsnamen vollständig zu bestimmen.

ArgumenteconnString, {driverName}

• Das Argument connString ist der Verbindungsstring, der den Verbindungsnamen abruft.

• Das Argument driverName ist ein optionales Argument, das connString näher bestimmt.

RückgabewerteEin Verbindungsnamensstring, der dem Verbindungsstring entspricht.

BeispielDer folgende Code gibt den String EmpDB zurück:

var connectionName = MMDB.getConnectionName ¬("dsn=EmpDB;uid=;pwd=");


48

MMDB.getConnectionString()


BeschreibungDiese Funktion ruft den Verbindungsstring ab, der mit der benannten Verbindung verknüpft ist.

ArgumenteconnName

• Das Argument connName ist ein Verbindungsname, der im Connection Manager festgelegt wurde. Er bezeichnet den Verbindungsstring, den Dreamweaver beim Herstellen einer Datenbankverbindung mit einer Live Data-Quelle verwenden soll.

RückgabewerteEin Verbindungsstring, der der benannten Verbindung entspricht.

BeispielDer Code var connectionString = MMDB.getConnectionString ("EmpDB") gibt verschiedene Strings für eine ADO- oder JDBC-Verbindung zurück.

• Bei einer ADO-Verbindung kann folgender String zurückgegeben werden:"dsn=EmpDB;uid=;pwd=";

• Bei einer JDBC-Verbindung kann folgender String zurückgegeben werden:"jdbc:inetdae:192.168.64.49:1433?database=pubs&user=JoeUser&¬

password=joesSecret"

MMDB.getDriverName()


BeschreibungDiese Funktion ruft den Treibernamen ab, der mit der angegebenen Verbindung verknüpft ist. Nur eine JDBC-Verbindung hat einen Treibernamen.

ArgumenteconnName


RückgabewerteEin String, der den Treibernamen enthält.

BeispielDie Anweisung MMDB.getDriverName ("EmpDB"); könnte folgenden String zurückgeben:

"jdbc/oracle/driver/JdbcOracle"


49

MMDB.getDriverUrlTemplateList() (veraltet)

VerfügbarkeitDreamweaver UltraDev 4; von der Verwendung in Dreamweaver MX wird abgeraten

Hinweis: Bei Dreamweaver UltraDev 4 wird die Liste der JDBC-Treiber in der Datei connections.xml gespeichert, die sich im Ordner Configuration\Connections befindet. Mit jedem Treiber ist eine URL-Vorlage verknüpft. Diese Funktion gibt die Liste der JDBC-Treiber zurück.

Bei Dreamweaver MX (oder höher) sind diese Treiber und URL-Vorlagen in den JDBC-Dialogfeldern fest kodiert. Darüber hinaus ist diese Funktion eine leere Funktionsdefinition, um Fehler aufgrund einer nicht definierten Definition zu verhindern. Das folgende Beispiel zeigt, in welcher Weise ein JDBC-Treiber und eine URL-Vorlage fest kodiert sind:

var DEFAULT_DRIVER = "COM.ibm.db2.jdbc.app.DB2Driver";var DEFAULT_TEMPLATE = "jdbc:db2:[database name]";

In Dreamweaver ist ein Dialogfeld für jedes Treiber/URL-Vorlage-Paar vorhanden.

Zusammenfassend kann gesagt werden, dass Entwickler von Dreamweaver UltraDev 4 dem XML-Code einen neuen Eintrag hinzufügen und Entwickler von Dreamweaver MX (oder höher) ein neues Dialogfeld implementieren müssen.

BeschreibungDiese Funktion ruft JDBC-Treiber und die entsprechenden URL-Vorlagen ab.

ArgumenteKeine

RückgabewerteEin Array, in dem sich die im System des Benutzers gefundenen JDBC-Treiber und (falls angegeben) die entsprechenden URL-Vorlagen befinden. Das Array enthält eine gerade Anzahl von Elementen, in denen folgende Informationen gespei-chert sind: Driver1, UrlTemplate1, Driver2, UrlTemplate2, usw.

MMDB.getLocalDsnList()


BeschreibungDiese Funktion ruft ODBC-DSNs ab, die im System des Benutzers definiert sind.

ArgumenteKeine

RückgabewerteEin Array, das die im System des Benutzers definierten ODBC-DSNs enthält.


50

MMDB.getPassword()


BeschreibungDiese Funktion ruft das Kennwort für die angegebene Verbindung ab.

ArgumenteconnName


RückgabewerteEin mit dem Verbindungsnamen verknüpfter Kennwortstring.

BeispielDie Anweisung MMDB.getPassword ("EmpDB"); könnte beispielsweise "joessecret" zurückgeben.

MMDB.getRDSPassword()


BeschreibungDiese Funktion ruft das RDS-Kennwort (Remote Development Services) ab (zur Verwendung mit ColdFusion-Verbin-dungen).

ArgumenteKeine

RückgabewerteEin String, der das RDS-Kennwort enthält.

MMDB.getRDSUserName()


BeschreibungDiese Funktion ruft den RDS-Benutzernamen (zur Verwendung mit ColdFusion-Verbindungen) ab.

ArgumenteKeine

RückgabewerteEin String, der den RDS-Benutzernamen enthält.


51

MMDB.getRemoteDsnList()


BeschreibungDiese Funktion ruft die ODBC-DSNs vom Siteserver ab. Die Funktionen getRDSUserName() und getRDSPassword() werden verwendet, wenn ColdFusion das Servermodell der aktuellen Site ist. Mit dieser Funktion haben Entwickler die Möglichkeit, einen URL-Parameterstring anzugeben, der an die von MMDB.getRemoteDsnList() generierte Remote Connectivity-URL angefügt wird. Wenn der Entwickler einen Parameterstring zur Verfügung stellt, übergibt ihn diese Funktion an die HTTP-Connectivity-Skripts.

Argumente{urlParams}

• Das optionale Argument urlParams ist ein String, der eine Liste von Ausdrücken im Format name=value enthält, die jeweils durch Und-Zeichen (&) voneinander getrennt sind. Die Werte dürfen nicht in Anführungszeichen einge-schlossen werden. Einige Zeichen, wie beispielsweise das Leerzeichen im Wert Hello World, müssen kodiert werden. Es folgt ein Beispiel für ein gültiges Argument, das an MMDB.getRemoteDsnList() übergeben werden kann: a=1&b=Hello%20World

RückgabewerteGibt ein Array mit den ODBC-DSNs zurück, die auf dem Server der aktuellen Site definiert sind.

MMDB.getRuntimeConnectionType()


BeschreibungDiese Funktion gibt den Laufzeitverbindungstyp des angegebenen Verbindungsnamens zurück.

ArgumenteconnName


RückgabewerteEin Verbindungsstring, der dem Verbindungstyp entspricht. Diese Funktion kann einen der folgenden Werte zurückgeben: "ADO", "ADODSN", "JDBC" oder "CFDSN".

BeispielDer folgende Code würde bei einer ADO-Verbindung den String "ADO" zurückgeben:

var connectionType = MMDB.getRuntimeConnectionType ("EmpDB")


52

MMDB.getUserName()


BeschreibungDiese Funktion gibt einen Benutzernamen für die angegebene Verbindung zurück.

ArgumenteconnName


RückgabewerteEin mit dem Verbindungsnamen verknüpfter Benutzernamenstring.

BeispielDie Anweisung MMDB.getUserName ("EmpDB"); könnte beispielsweise "amit" zurückgeben.

MMDB.hasConnectionWithName()


BeschreibungDiese Funktion stellt fest, ob eine Verbindung mit dem angegebenen Namen vorhanden ist.

Argumentename

• Das Argument name ist der Verbindungsname.

RückgabewerteGibt einen Booleschen Wert zurück: true, wenn eine Verbindung mit dem angegebenen Namen vorhanden ist, andernfalls false .

MMDB.needToPromptForRdsInfo()


BeschreibungDiese Funktion legt fest, ob Dreamweaver das Dialogfeld RDS-Anmeldeinformationen öffnen soll.

ArgumentebForce

• Das Argument bForce ist ein Boolescher Wert; true gibt an, dass der Benutzer, der zuvor das Dialogfeld RDS-Anmeld-einformationen über die Schaltfläche Abbrechen geschlossen hat, immer noch zur Eingabe der RDS-Anmeldeinforma-tionen aufgefordert werden muss.

RückgabewerteEin Boolescher Wert: true, wenn der Benutzer zur Eingabe der RDS-Anmeldeinformationen aufgefordert werden muss, anderenfalls false.


53

MMDB.needToRefreshColdFusionDsnList()


BeschreibungDiese Funktion beauftragt den Connection Manager, den Cache-Speicher zu löschen und die ColdFusion-Datenquellen-liste vom Anwendungsserver abzurufen, wenn ein Benutzer die Liste das nächste Mal anfordert.

ArgumenteKeine

RückgabewerteKeine

MMDB.popupConnection()


BeschreibungDiese Funktion blendet ein Verbindungsdialogfeld ein. Diese Funktion hat die folgenden drei Signaturen:

• Wenn die Argumentliste nur aus dem Argument dialogFileName besteht (einem String), bewirkt die Funktion popup-Connection(), dass Dreamweaver das Verbindungsdialogfeld anzeigt, sodass Sie eine neue Verbindung definieren können.

• Besteht die Argumentliste nur aus dem Argument connRec (einer Referenz auf die Verbindung), bewirkt die Funktion opupConnection(), dass Dreamweaver das Verbindungsdialogfeld im Bearbeitungsmodus anzeigt, sodass Sie die benannte Verbindung bearbeiten können. In diesem Modus wird das Textfeld Name abgeblendet.

• Besteht die Argumentliste aus dem Argument connRec und dem Booleschen Wert bDuplicate, bewirkt die Funktion popupConnection(), dass Dreamweaver das Verbindungsdialogfeld im Duplizierungsmodus anzeigt. In diesem Modus wird das Textfeld Name abgeblendet, und die restlichen Eigenschaften werden kopiert, um ein Duplikat der Verbindung zu definieren.

Argumente dialogFileName

oderconnRec oderconnrec, bDuplicate

• Das Argument dialogFileName ist ein String, der den Namen einer HTML-Datei enthält, die im Ordner Configu-ration\Connections\Servermodell gespeichert ist. Mit dieser HTML-Datei wird das Dialogfeld definiert, das zur Erstellung einer Verbindung verwendet wird. In dieser Datei müssen drei JavaScript-API-Funktionen implementiert sein: findConnection(), inspectConnection() und applyConnection(). In der Regel erstellen Sie eine JavaScript-Datei, die diese Funktionen implementiert, und anschließend fügen Sie diese Datei in die HTML-Datei ein. (Weitere Informa-tionen zum Herstellen einer Verbindung finden Sie unter „Die Datenbank-Konnektivitäts-API“ auf Seite 69.)

• Das Argument connRec ist eine Referenz auf ein vorhandenes Verbindungsobjekt.

• Das Argument bDuplicate ist ein Boolescher Wert.

RückgabewerteKeine Das definierte Verbindungsdialogfeld wird eingeblendet.


54

MMDB.setRDSPassword()


BeschreibungDiese Funktion legt das RDS-Kennwort fest.

Argumentepassword

• Das Argument password ist ein String, der das RDS-Kennwort enthält.

RückgabewerteKeine

MMDB.setRDSUserName()


BeschreibungDiese Funktion legt den RDS-Benutzernamen fest.

Argumenteusername

• Das Argument username ist ein gültiger RDS-Benutzername.

RückgabewerteKeine

MMDB.showColdFusionAdmin()


BeschreibungDiese Funktion zeigt das Dialogfeld ColdFusion-Administrator an.

ArgumenteKeine

RückgabewerteKeine Das Dialogfeld ColdFusion Administrator wird eingeblendet.

MMDB.showConnectionMgrDialog()


BeschreibungDiese Funktion zeigt das Dialogfeld Connection Manager an.

ArgumenteKeine


55

RückgabewerteKeine Das Dialogfeld Connection Manager wird angezeigt.

MMDB.showOdbcDialog()

VerfügbarkeitDreamweaver UltraDev 4 (nur Windows).

BeschreibungDiese Funktion zeigt das Dialogfeld System-ODBC-Administration oder ODBC-Datenquellen-Administrator an.

ArgumenteKeine

RückgabewerteKeine Das Dialogfeld System-ODBC-Administration oder ODBC-Datenquellen-Administrator wird angezeigt.

MMDB.showRdsUserDialog()


BeschreibungDiese Funktion zeigt das Dialogfeld zur Eingabe des RDS-Benutzernamens und Kennworts an.

Argumenteusername, password

• Das Argument username ist der anfänglich verwendete Benutzername.

• Das Argument password ist das anfänglich verwendete Kennwort.

RückgabewerteEin Objekt, das die neuen Werte in den Eigenschaften username und password enthält. Wird eine der beiden Eigenschaften nicht eingegeben, weist dies darauf hin, dass der Benutzer das Dialogfeld über den Befehl Abbrechen geschlossen hat.

MMDB.showRestrictDialog()


BeschreibungDiese Funktion zeigt das Dialogfeld Beschränken an.

Argumentecatalog, schema

• Das Argument catalog ist der anfänglich verwendete Katalogwert.

• Das Argument schema ist der anfänglich verwendete Schemawert.

RückgabewerteEin Objekt, das die neuen Werte in den Eigenschaften catalog und schema enthält. Wird eine der beiden Eigenschaften nicht eingegeben, weist dies darauf hin, dass der Benutzer das Dialogfeld über den Befehl Abbrechen geschlossen hat.


56

MMDB.testConnection()


BeschreibungDiese Funktion prüft die Verbindungseinstellungen. Sie zeigt ein modales Dialogfeld ein, in dem die Ergebnisse beschrieben werden.

ArgumenteserverPropertiesArray

Diese Funktion erwartet ein einzelnes Argument, ein Array-Objekt, das Werte aus der folgenden Liste enthält, die auf das aktuelle Servermodell zutreffen. Geben Sie für Eigenschaften, die auf die zu prüfende Verbindung nicht zutreffen, einen leeren String ("") an.

• Wenn useHTTP den Wert false hat, zeigt das Argument type an, welche DLL-Datei für den Verbindungsaufbau mit einer Datenbank in der Entwurfsphase zum Prüfen von Verbindungseinstellungen verwendet werden soll.

• Das Argument string ist der ADO-Verbindungsstring oder JDBC-URL.

• Das Argument dsn ist der Data Source Name.

• Das Argument driver ist der JDBC-Treiber.

• Das Argument username ist der Benutzername.

• Das Argument password ist das Kennwort.

• Das Argument useHTTP ist ein Boolescher Wert. Mit dem Wert true wird festgelegt, dass Dreamweaver in der Entwurfs-phase eine HTTP-Verbindung verwenden soll; andernfalls verwendet Dreamweaver ein DLL-Datei.

RückgabewerteEin Boolescher Wert: true, wenn die Prüfung der Verbindung erfolgreich durchgeführt werden konnte, andernfalls false.

DatenbankzugriffsfunktionenMithilfe der Datenbankzugriffsfunktionen können Sie eine Datenbank abfragen. Eine Sammlung der Funktionen, die eine Datenbankverbindung verwalten, finden Sie unter „Datenbankverbindungsfunktionen“ auf Seite 45.

Die folgende Liste beschreibt einige der Argumente, die den verfügbaren Funktionen gemeinsam sind:

• Die meisten Datenbankzugriffsfunktionen verwenden einen Verbindungsnamen als Argument. Eine Liste der gültigen Verbindungsnamen finden Sie im Connection Manager. Sie können aber auch mit der Funktion MMDB.getConnec-tionList() eine Liste aller Verbindungsnamen abrufen.

• Für gespeicherte Prozeduren sind oft Parameter erforderlich. Die Parameterwerte von Datenbankfunktionen können auf zwei Arten festgelegt werden. Eine Möglichkeit besteht darin, ein Array von Parameterwerten anzugeben (paramValuesArray). Falls Sie nur Parameterwerte festlegen, müssen die Werte in der Reihenfolge erscheinen, in der die gespeicherte Prozedur sie benötigt. Der zweite Schritt besteht darin, Parameterwerte zu definieren, um ein Array von Parameternamen (paramNameArray) bereitzustellen. Mithilfe der Funktion MMDB.getSPParamsAsString() können Sie die Parameter der gespeicherten Prozedur abrufen. Sollten Sie Parameternamen festlegen, müssen die in paramValuesArray angegebenen Werte in derselben Reihenfolge angegeben werden, in der die Parameternamen auch in paramNameArray festgelegt wurden.


57

MMDB.getColumnAndTypeList()


BeschreibungDiese Funktion ruft eine Liste der Spalten und deren Typen aus einer ausgeführten SQL SELECT-Anweisung ab.

ArgumenteconnName, statement


• Das Argument statement ist die auszuführende SQL SELECT-Anweisung.

RückgabewerteEin String-Array, das eine Liste der Spalten (und deren Typen) repräsentiert, die der SELECT-Anweisung entsprechen. Ansonsten ein Fehler, wenn die SQL-Anweisung ungültig war oder die Verbindung nicht hergestellt werden konnte.

BeispielDer Code var columnArray = MMDB.getColumnAndTypeList("EmpDB","Select * from Employees") gibt das folgende String-Array zurück:

columnArray[0] = "EmpName"

columnArray[1] = "varchar"

columnArray[2] = "EmpFirstName"

columnArray[3] = "varchar"

columnArray[4] = "Age"

columnArray[5] = "integer"

MMDB.getColumnList()


BeschreibungDiese Funktion ruft eine Liste der Spalten aus einer ausgeführten SQL SELECT-Anweisung ab.

ArgumenteconnName, statement


• Das Argument statement ist die auszuführende SQL SELECT-Anweisung.

RückgabewerteEin String-Array, das eine Liste der Spalten repräsentiert, die der SELECT-Anweisung entsprechen. Ansonsten ein Fehler, wenn die SQL-Anweisung ungültig war oder die Verbindung nicht hergestellt werden konnte.

BeispielDer Code var columnArray = MMDB.getColumnList("EmpDB","Select * from Employees") gibt das folgende String-Array zurück:

columnArray[0] = "EmpName"

columnArray[1] = "EmpFirstName"

columnArray[2] = "Age"


58

MMDB.getColumns()

VerfügbarkeitDreamweaver MX, Argumente aktualisiert in Dreamweaver MX 2004.

BeschreibungDiese Funktion gibt ein Array von Objekten zurück, die die in der Tabelle angegebenen Spalten beschreiben.

ArgumenteconnName, tableName

• Das Argument connName ist der Verbindungsname. Dieser Wert bezeichnet den Verbindungsstring, den Dreamweaver beim Herstellen einer Datenbankverbindung mit einer Live Data-Quelle verwenden soll.

• Das Argument tableName ist die abzufragende Tabelle.

RückgabewerteEin Array von Objekten, wobei für jede Spalte ein Objekt verwendet wird. Jedes Objekt definiert die folgenden drei Eigen-schaften der zugehörigen Spalte.

BeispielIm folgenden Beispiel wird mithilfe von MMDB.getColumns() der QuickInfo-Textwert festgelegt:

var columnNameObjs = MMDB.getColumns(connName,tableName);

var databaseType = MMDB.getDatabaseType(connName);

for (i = 0; i < columnNameObjs.length; i++)

{

var columnObj = columnNameObjs[i];

var columnName = columnObj.name;

var typename = columnObj.datatype;

if (dwscripts.isNumber(typename))

{

// ist bereits eine Zahl

typename = dwscripts.getDBColumnTypeAsString(typename, databaseType);

}

var tooltiptext = typename;

}

Name der Eigenschaft Beschreibung

name Name der Spalte (beispielsweise price)

datatype Datentyp der Spalte (beispielsweise small money)

definedsize Definierte Größe der Spalte (beispielsweise 8)

nullable Gibt an, ob die Spalte null-Werte enthalten darf.


59

MMDB.getColumnsOfTable()


BeschreibungDiese Funktion erstellt eine Liste aller in der angegebenen Tabelle enthaltenen Spalten.



• Das Argument tableName ist der Name einer Tabelle in der Datenbank, die über connName angegeben wurde.

RückgabewerteEin String-Array. Jeder String ist hierbei der Name einer Spalte in der Tabelle.

BeispielDie Anweisung MMDB.getColumnsOfTable ("EmpDB","Employees"); gibt die folgenden Strings zurück:

["EmpID", "FirstName", "LastName"]

MMDB.getPrimaryKeys()


BeschreibungDiese Funktion gibt die Namen der Spalten zurück, die gemeinsam den Primärschlüssel der benannten Tabelle bilden. Ein Primärschlüssel ist der eindeutige Bezeichner einer Datenbankzeile; er besteht aus mindestens einer Spalte.



• Das Argument tableName ist der Name der Tabelle, aus der Sie die Spalten abrufen möchten, die den Primärschlüssel der Tabelle bilden.

RückgabewerteEin String-Array. Das Array besteht aus einem String für jede Spalte, aus der sich der Primärschlüssel zusammensetzt.

BeispielIm folgenden Beispiel wird der Primärschlüssel für die angegebene Tabelle zurückgegeben.

var connName = componentRec.parent.parent.parent.name;

var tableName = componentRec.name;

var primaryKeys = MMDB.getPrimaryKeys(connName,tableName);


60

MMDB.getProcedures()


BeschreibungDiese Funktion gibt ein Array der Prozedurobjekte zurück, die mit einer benannten Verbindung verknüpft sind.

ArgumenteconnName


RückgabewerteEin Array der Prozedurobjekte, wobei jedes Prozedurobjekt die folgenden drei Eigenschaften aufweist:


schemaa

a. Sobald Sie eine Datensatzgruppe modifizieren, stellt Dreamweaver eine Verbindung zur Datenbank her und ruft alle Tabellen aus der Datenbank ab. Wenn die Datenbank viele Tabellen enthält, benötigt Dreamweaver auf bestimmten Systemen u. U. viel Zeit, um diese abzurufen. Enthält die Datenbank ein Schema oder einen Katalog, können Sie mit dessen Hilfe die Anzahl der Datenbankelemente beschränken, die Dreamweaver während der Entwurfsphase abruft. Zunächst müssen Sie in Ihrer Datenbankanwendung ein Schema oder einen Katalog erstellen, bevor Sie das Schema oder den Katalog in Dreamweaver zuweisen können. Weitere Informationen können Sie der Dokumentation Ihrer Datenbank entnehmen oder von Ihrem Systemadministrator erfragen.

Name des mit dem Objekt verknüpften Schemas.

Diese Eigenschaft bezeichnet den Benutzer, der mit der gespeicherten Prozedur in der SQL-Datenbank verknüpft ist, die von der Funktion getProcedures() aufgerufen wird. Die von dieser Funktion aufgerufene Datenbank hängt vom Typ der Verbindung ab.

• Bei ODBC-Verbindungen wird die Datenbank durch die ODBC-Datenquelle definiert. Der DSN wird durch die Eigenschaft dsn im Verbindungsobjekt (connName) angegeben, das Sie an die Funktion getProcedures() übergeben.

• Bei OLE-Datenbankverbindungen wird die Datenbank durch den Verbindungsstring defi-niert.

catalog Name des mit dem Objekt verknüpften Katalogs (Eigentümerqualifizierer).

Der Wert der Eigenschaft catalog wird durch ein Attribut des OLE-DBTreibers definiert. Mit diesem Treiberattribut wird eine standardmäßige Eigenschaft user.database definiert, die verwendet wird, wenn im OLE-DB-Verbindungsstring keine Datenbank festgelegt wird.

procedure Name der Prozedur.


61

BeispielMit folgendem Code wird eine Liste der Prozeduren abgerufen:

var procObjects = MMDB.getProcedures(connectionName);

for (i = 0; i < procObjects.length; i++)

{

var thisProcedure = procObjects[i]

thisSchema =

Trim(thisProcedure.schema)

if (thisSchema.length == 0)

{

thisSchema = Trim(thisProcedure.catalog)

}

if (thisSchema.length > 0)

{

thisSchema += "."

}

var procName = String(thisSchema + thisProcedure.procedure);

}

MMDB.getSPColumnList()


BeschreibungDiese Funktion ruft eine Liste der Ergebnissatzspalten ab, die durch einen Aufruf der angegebenen gespeicherten Prozedur erzeugt wurden.

ArgumenteconnName, statement, paramValuesArray


• Das Argument statement ist der Name der gespeicherten Prozedur, die den Ergebnissatz zurückgibt, wenn sie ausge-führt wird.

• Das Argument paramValuesArray ist ein Array, das eine Liste von Testwerten der Entwurfsphasenparameter enthält. Geben Sie die Parameterwerte in der Reihenfolge ein, in der sie die Prozedur erwartet. Mithilfe der Funktion MMDB.getSPParamsAsString() können Sie die Parameter der gespeicherten Prozedur abrufen.

RückgabewerteEin String-Array, das die Liste der Spalten repräsentiert. Diese Funktion gibt einen Fehler zurück, wenn die SQL-Anweisung oder der Verbindungsstring ungültig ist.

BeispielDer folgende Code kann eine Liste der Ergebnissatzspalten zurückgeben, die von der ausgeführten gespeicherten Prozedur getNewEmployeesMakingAtLeast generiert wurden:

var paramValueArray = new Array("2/1/2000", "50000")

var columnArray = MMDB.getSPColumnList("EmpDB", ¬

"getNewEmployeesMakingAtLeast", paramValueArray)

Die folgenden Werte werden zurückgegeben:

columnArray[0] = "EmpID", columnArray[1] = "LastName", ¬

columnArray[2] ="startDate", columnArray[3] = "salary"


62

MMDB.getSPColumnListNamedParams()


BeschreibungDiese Funktion ruft eine Liste der Ergebnissatzspalten ab, die durch einen Aufruf der angegebenen gespeicherten Prozedur erzeugt wurden.

ArgumenteconnName, statement, paramNameArray, paramValuesArray


• Das Argument statement ist der Name der gespeicherten Prozedur, die den Ergebnissatz zurückgibt, wenn sie ausge-führt wird.

• Das Argument paramNameArray ist ein Array, das eine Liste von Parameternamen enthält. Mithilfe der Funktion MMDB.getSPParamsAsString() können Sie die Parameter der gespeicherten Prozedur abrufen.

• Das Argument paramValuesArray ist ein Array, das eine Liste von Testwerten der Entwurfsphasenparameter enthält. Sie können festlegen, ob die Prozedur für ihre Ausführung Parameter erfordert. Sollten Sie in paramNameArray Parameter-namen angegeben haben, müssen Sie die Parameternamen in derselben Reihenfolge festgelegen, wie sie in paramName-Array aufgeführt sind. Falls Sie paramNameArray nicht festgelegt haben, legen Sie die Werte in der Reihenfolge fest, in der sie die gespeicherte Prozedur erwartet.

RückgabewerteEin String-Array, das die Liste der Spalten repräsentiert. Diese Funktion gibt einen Fehler zurück, wenn die SQL-Anweisung oder der Verbindungsstring ungültig ist.

BeispielDer folgende Code kann eine Liste der Ergebnissatzspalten zurückgeben, die von der ausgeführten gespeicherten Prozedur getNewEmployeesMakingAtLeast generiert wurden:

var paramNameArray = new Array("startDate", "salary")


var columnArray = MMDB.getSPColumnListNamedParams("EmpDB", ¬

"getNewEmployeesMakingAtLeast", paramNameArray, paramValueArray)

Die folgenden Werte werden zurückgegeben:

columnArray[0] = "EmpID", columnArray[1] = "LastName", ¬

columnArray[2] ="startDate", columnArray[3] = "salary"

MMDB.getSPParameters()


BeschreibungDiese Funktion gibt ein Array der Parameterobjekte einer benannten Prozedur zurück.

ArgumenteconnName, procName


• Das Argument procName ist der Name der Prozedur.


63

RückgabewerteEin Array von Parameterobjekten, die jeweils die folgende Gruppe von Eigenschaften bezeichnen:

BeispielIm folgenden Beispiel werden die Parameterobjekte für die angegebene Prozedur abgerufen und eine QuickInfo für jedes Objekt basierend auf der entsprechenden Eigenschaft erstellt.

var paramNameObjs = MMDB.getSPParameters(connName,procName);

for (i = 0; i < paramNameObjs.length; i++)

{

var paramObj = paramNameObjs[i];

var tooltiptext = paramObj.datatype;

tooltiptext+=" ";

tooltiptext+=GetDirString(paramObj.directiontype);

}

MMDB.getSPParamsAsString()


BeschreibungDiese Funktion ruft einen String ab, der Kommas als Trennzeichen verwendet und in dem die Liste der Parameter enthalten ist, die die gespeicherte Prozedur annimmt.

ArgumenteconnName, procName


• Das Argument procName ist der Name der gespeicherten Prozedur.

RückgabewerteEin String, der Kommas als Trennzeichen verwendet und in dem die Liste der Parameter gespeichert ist, die die gespei-cherte Prozedur annimmt. Der Name, die Richtung und der Datentyp der Parameter sind enthalten und durch einen Strich-punkt (;) voneinander getrennt.

BeispielDer Code MMDB.getSPParamsAsString ("EmpDB","getNewEmployeesMakingAtLeast") kann einen String des Formular-namens startDate;direction:in;datatype:date, salary;direction:in;datatype:integer zurückgeben.

In diesem Beispiel hat die gespeicherte Prozedur getNewEmployeesMakingAtLeast zwei Parameter: startDate und Salary. Bei startDate ist die Richtung in und der Datentyp date. Bei salary ist die Richtung in und der Datentyp date.


name Name des Parameters (beispielsweise @@lolimit)

datatype Datentyp des Parameters (beispielsweise smallmoney)

direction Richtung des Parameters:

1– Der Parameter wird nur für Eingaben verwendet.

2– Der Parameter wird nur für Ausgaben verwendet. In diesem Fall wird der Parameter durch Bezugnahme übergeben, und die Methode schreibt einen Wert in ihn. Sie kön-nen den Wert verwenden, nachdem die Methode einen Rückgabewert geliefert hat.

3– Der Parameter wird für Ein- und Ausgaben verwendet.

4– Der Parameter enthält einen Rückgabewert.


64

MMDB.getTables()


BeschreibungDiese Funktion ruft eine Liste aller Tabellen ab, die für die angegebene Datenbank definiert wurden. Jedes Tabellenobjekt weist drei Eigenschaften auf: table, schema und catalog.

ArgumenteconnName


RückgabewerteEin Array von Objekten, wobei jedes Objekt drei Eigenschaften ausweist: table, schema und catalog. Table ist der Name der Tabelle. Schema ist der Name des Schemas, das die Tabelle enthält. Catalog ist der Katalog, der die Tabelle enthält.

BeispielDie Anweisung MMDB.getTables ("EmpDB"); könnte beispielsweise ein Array mit zwei Objekten erzeugen. Die Eigen-schaften des ersten Objekts sehen möglicherweise wie im folgenden Beispiel aus:

object1[table:"Employees", schema:"personnel", catalog:"syscat"]

Die Eigenschaften des zweiten Objekts sehen möglicherweise wie im folgenden Beispiel aus:

object2[table:"Departments", schema:"demo", catalog:"syscat2"]

MMDB.getViews()


BeschreibungDiese Funktion ruft eine Liste aller Ansichten ab, die für die angegebene Datenbank definiert wurden. Jedes Ansichtsobjekt hat die Eigenschaften catalog, schema und view.

ArgumenteconnName


RückgabewerteEin Array von Ansichtsobjekten, wobei jedes Objekt drei Eigenschaften ausweist: catalog, schema und view. catalog bzw. schema dient zum Einschränken oder Filtern der Anzahl der Ansichten, die sich auf einen bestimmten Schemen- oder Katalognamen beziehen, der im Rahmen der Verbindungsinformationen definiert wurde.


65

BeispielDas folgende Beispiel gibt die Ansichten für einen bestimmten Verbindungswert, CONN_LIST.getValue(), zurück:

var viewObjects = MMDB.getViews(CONN_LIST.getValue())for (i = 0; i < viewObjects.length; i++)

{

thisView = viewObjects[i]

thisSchema = Trim(thisView.schema)

if (thisSchema.length == 0)

{

thisSchema = Trim(thisView.catalog)

}

if (thisSchema.length > 0)

{

thisSchema += "."

}

views.push(String(thisSchema + thisView.view))

}

MMDB.showResultset()


BeschreibungDiese Funktion zeigt ein Dialogfeld mit den Ergebnissen aus der Ausführung der angegebenen SQL-Anweisung an. Das Dialogfeld zeigt ein tabellarisches Raster an, wobei die Überschrift die Spalteninformationen zum Ergebnissatz wiedergibt. Sollte der Verbindungsstring oder die SQL-Anweisung ungültig sein, wird ein Fehler angezeigt. Diese Funktion überprüft die SQL-Anweisung.

ArgumenteconnName, SQLstatement


• Das Argument SQLstatement ist die SQL SELECT-Anweisung.

RückgabewerteKeine Diese Funktion gibt einen Fehler zurück, wenn die SQL-Anweisung oder der Verbindungsstring ungültig ist.

BeispielDer folgende Code zeigt die Ergebnisse der ausgeführten SQL-Anweisung an:

MMDB.showResultset("EmpDB","Select EmpName,EmpFirstName,Age ¬

from Employees")


66

MMDB.showSPResultset()


BeschreibungDiese Funktion zeigt ein Dialogfeld mit den Ergebnissen aus der Ausführung der angegebenen gespeicherten Prozedur an. Das Dialogfeld zeigt ein tabellarisches Raster an, wobei die Überschrift die Spalteninformationen zum Ergebnissatz wiedergibt. Sollte der Verbindungsstring oder die gespeicherte Prozedur ungültig sein, wird ein Fehler angezeigt. Diese Funktion überprüft die gespeicherte Prozedur.

ArgumenteconnName, procName, paramValuesArray


• Das Argument procName ist der Name der auszuführenden gespeicherten Prozedur.

• Das Argument paramValuesArray ist ein Array, das eine Liste von Testwerten der Entwurfsphasenparameter enthält. Geben Sie die Parameterwerte in der Reihenfolge ein, in der sie die Prozedur erwartet. Mithilfe der Funktion MMDB.getSPParamsAsString() können Sie die Parameter der gespeicherten Prozedur abrufen.

RückgabewerteDiese Funktion gibt einen Fehler zurück, wenn die SQL-Anweisung oder der Verbindungsstring ungültig ist, andernfalls gibt es keinen Rückgabewert.

BeispielDer folgende Code zeigt die Ergebnisse der ausgeführten gespeicherten Prozedur an:


MMDB.showSPResultset("EmpDB", "getNewEmployeesMakingAtLeast", ¬

paramValueArray)

MMDB.showSPResultsetNamedParams()


BeschreibungDiese Funktion zeigt ein Dialogfeld mit den Ergebnissen der angegebenen gespeicherten Prozedur an. Das Dialogfeld zeigt ein tabellarisches Raster an, wobei die Überschrift die Spalteninformationen zum Ergebnissatz wiedergibt. Sollte der Verbindungsstring oder die gespeicherte Prozedur ungültig sein, wird ein Fehler angezeigt. Diese Funktion überprüft die gespeicherte Prozedur. Diese Funktion unterscheidet sich von MMDB.showSPResultset(), da Sie hier Parameterwerte nach dem Namen festlegen können und nicht nach der Reihenfolge, in der die gespeicherte Prozedur sie erwartet.


67

ArgumenteconnName, procName, paramNameArray, paramValuesArray


• Das Argument procName ist der Name der gespeicherten Prozedur, die den Ergebnissatz zurückgibt, wenn sie ausgeführt wird.

• Das Argument paramNameArray ist ein Array, das eine Liste von Parameternamen enthält. Mithilfe der Funktion MMDB.getSPParamsAsString() können Sie die Parameter der gespeicherten Prozedur abrufen.

• Das Argument paramValuesArray ist ein Array, das eine Liste von Testwerten der Entwurfsphasenparameter enthält.

RückgabewerteDiese Funktion gibt einen Fehler zurück, wenn die SQL-Anweisung oder der Verbindungsstring ungültig ist, andernfalls gibt es keinen Rückgabewert.

BeispielDer folgende Code zeigt die Ergebnisse der ausgeführten gespeicherten Prozedur an:

var paramNameArray = new Array("startDate", "salary")


MMDB.showSPResultsetNamedParams("EmpDB","getNewEmployees¬

MakingAtLeast", paramNameArray, paramValueArray)


68

69

Kapitel 8: Die Datenbank-Konnektivitäts-API

Als Entwickler können Sie neue Verbindungstypen und die entsprechenden Dialogfelder für neue bzw. vorhandene Server-modelle für Adobe® Dreamweaver® CS3 erstellen. Anschließend kann ein Benutzer, der eine Site zum Erstellen von Seiten einrichtet, ein neues Verbindungsobjekt nach Auswahl einer bestimmten Verbindung erstellen.

Der Benutzer kann dabei eine der folgenden Möglichkeiten wählen:

• Er klickt im Bedienfeld Anwendung auf die Schaltfläche mit dem Pluszeichen (+) und wählt die Option Datensatz-gruppe. Er blendet im Dialogfeld Datensatzgruppe die Einträge des Listenfelds Verbindung ein.

• Er klickt im Bedienfeld Datenbanken auf der Registerkarte Datenbank auf die Schaltfläche mit dem Pluszeichen (+) und wählt Data Source Name.

Neue Verbindungstypen entwickeln Die folgenden Schritte erläutern den Prozess der Erstellung eines neuen Verbindungstyps:

1 Erstellen Sie das Layout für das Verbindungsdialogfeld.

Erstellen Sie eine HTML-Datei, die die Benutzeroberfläche (UI) für das Verbindungsdialogfeld festlegt. Speichern Sie die Datei unter einem ähnlichen Namen wie die Verbindung selbst (z. B. „myConnection.htm“). Informationen zum Erstellen eines Dialogfelds finden Sie im Handbuch Erste Schritte mit Dreamweaver.

Vergewissern Sie sich, dass diese HTML-Datei die JavaScript-Implementierungsdatei enthält, die Sie in Schritt 2, „Erstellen Sie eine JavaScript-Datei, die mindestens die nachfolgenden Elemente implementiert:“ auf Seite 70, definieren, wie im folgenden Beispiel dargestellt:

<head>

<script SRC="../myConnectionImpl.js"></script>

</head>

Speichern Sie diese HTML-Datei, die das Verbindungsdialogfeld definiert, im Ordner Configuration/Connections/server-model/Plattform (dabei steht Plattform entweder für Windows oder für Macintosh handelt).

Beispielsweise wird das Standard-ADO-Verbindungsdialogfeld für ein ASP-JavaScript-Dokument auf einer Windows-Plattform im Ordner ASP_Js/Win abgelegt und unter dem Namen Connection_ado_conn_string.htm gespeichert.

Hinweis: Zur Laufzeit erstellt Dreamweaver dynamisch eine Liste von Verbindungstypen, die dem Benutzer aus der Auswahl der Dialogfelder im Ordner ASP_Js\Win zur Verfügung stehen.

Im Ordner Configuration\ServerModels sind HTML-Dateien abgelegt, die jedes Servermodell definieren. Jede dieser HTML-Dateien enthält die Funktion getServerModelFolderName(), die den Namen des Ordners zurückgibt, der mit dem jeweiligen Servermodell verknüpft ist. Nachfolgendes Beispiel erläutert die Funktion für den ASP JavaScript-Dokumenttyp:

function getServerModelFolderName()

{

return "ASP_JS";}

Anhand der Datei MMDocumentTypes.xml im Ordner Configuration/DocumentTypes können Sie die Zuordnung der Servermodelle zu den Dokumenttypen ermitteln.


70

2 Erstellen Sie eine JavaScript-Datei, die mindestens die nachfolgenden Elemente implementiert:

Sie können einen beliebigen Namen für diese Implementierungsdatei vergeben, sie muss jedoch die Erweiterung „.js“ haben (z. B. „myConnectionImpl.js“). Sie können die Datei lokal oder auf einem Remote-Computer speichern. Sie können auch einen Unterordner im Ordner Configuration/Connections anlegen und die Implementierungsdatei dort speichern.

Hinweis: Die in Schritt 1, „Erstellen Sie das Layout für das Verbindungsdialogfeld.“ auf Seite 69, definierte HTML-Datei muss diese Implementierungsdatei zum Verbindungstyp enthalten.

Wenn Sie die in der Standarddatei connection_includefile.edml festgelegten Verbindungsparameter nicht anpassen müssen, genügen zum Erstellen eines neuen Verbindungsdialogfelds diese beiden Schritte.

Hinweis: Der Titel des Dialogfelds auf der Benutzeroberfläche steht im Tag title, das im HTML-Dokument festgelegt wird.

Mithilfe der im nächsten Abschnitt aufgeführten Funktionen können Sie ein Verbindungsdialogfeld erstellen. Zusammen mit dem Aufruf zum Generieren von Include-Dateien für den Benutzer müssen Sie möglicherweise auch Ihren Verbin-dungstyp beim Servermodell-Abschnitt der Verbindungs-XML-Datei anmelden.

Weitere Informationen zur Datenbank-Konnektivitäts-API im Zusammenhang mit dem Erstellen einer neuen Verbindung finden Sie unter „Datenbankverbindungsfunktionen“ auf Seite 45.

Die Verbindungs-APIUm einen neuen Verbindungstyp zu erstellen, einschließlich des Dialogfelds für die Benutzeroberfläche, müssen Sie die folgenden drei Funktionen implementieren: findConnection(), inspectConnection() und applyConnection(). Sie schreiben die drei Funktionen und nehmen Sie in die JavaScript-Implementierungsdatei auf, die mit Ihrem neuen Verbin-dungstyp verknüpft wird (siehe Schritt 2, „Erstellen Sie eine JavaScript-Datei, die mindestens die nachfolgenden Elemente implementiert:“ auf Seite 70).

Die Funktion applyConnection() gibt eine HTML-Quelle innerhalb einer Include-Datei zurück. Beispiele für eine HTML-Quelle finden Sie unter „Die generierte Include-Datei“ auf Seite 73. Die Funktion findConnection() extrahiert die Eigen-schaften der HTML-Quelle. Sie können die Funktion findConnection() implementieren, um mithilfe der Suchmuster in XML-Dateien Informationen zu extrahieren, die von applyConnection() zurückgegeben werden. Die nachfolgenden zwei JavaScript-Dateien erläutern eine solche Implementierung:

• connection_ado_conn_string.js befindet sich im Ordner Configuration/Connections/ASP_Js.

• connection_common.js befindet sich im Ordner Configuration/Connections/Shared.

Wenn ein Benutzer eine Site aufruft, öffnet Dreamweaver jede Datei im Ordner Connections und gibt deren Inhalt an die Funktion findConnection() weiter. Entspricht der Inhalt einer Datei den Kriterien für eine gültige Verbindung, gibt die Funktion findConnection() ein Verbindungsobjekt zurück. Alle Verbindungsobjekte werden in Dreamweaver im Bedienfeld Database Explorer angezeigt.

Wenn ein Benutzer ein Verbindungsdialogfeld öffnet, um eine neue Verbindung zu erstellen oder eine bestehende zu kopieren bzw. zu bearbeiten, ruft Dreamweaver die Funktion inspectConnection() auf und gibt das gleiche Verbindungs-objekt zurück, das von findConnection() erstellt wurde. Auf diese Weise können im Dialogfeld die Verbindungsinforma-tionen angezeigt werden.

Element Beschreibung Beispiele

Eine Gruppe von Variablen Jede Variable definiert eine bestimmte Ver-bindungseigenschaft.

Verbindungstyp, DSN usw.

Eine Gruppe von Schaltflächen Jede Schaltfläche wird im Verbindungsdia-logfeld angezeigt.

Testen, Hilfe usw. (OK und Abbre-chen gehören standardmäßig dazu.)

Konnektivitätsfunktionen Alle diese Funktionen definieren die Konnek-tivitäts-API.

findConnection()

applyConnection()

inspectConnection()


71

Wenn ein Benutzer im Verbindungsdialogfeld auf die Schaltfläche OK klickt, schickt Dreamweaver einen Aufruf an die Funktion applyConnection(), um die HTML-Datei zu erstellen, die dann in die Include-Datei im Ordner Configu-ration/Connections aufgenommen wird. Die Funktion applyConnection() gibt einen leeren String zurück, der anzeigt, dass eines der Felder einen Fehler enthält und das Dialogfeld noch nicht geschlossen werden sollte. Die Dateinamenerwei-terung der Include-Datei entspricht dem aktuellen Servermodell.

Wenn ein Benutzer in eine Seite ein Serververhalten aufnimmt, das die Verbindung verwendet, z. B. eine Datensatzgruppe oder eine gespeicherte Prozedur, nimmt Dreamweaver eine Anweisung in die Seite auf, die die Include-Datei der Verbindung enthält.

findConnection()


BeschreibungDreamweaver ruft diese Funktion auf, um eine Verbindung in der ausgewählten HTML-Quelle zu finden und die Verbin-dungsparameter zu analysieren. Stimmt der Inhalt dieser Quelldatei mit den Kriterien für eine gültige Verbindung überein, gibt findConnection() ein Verbindungsobjekt zurück. Andernfalls gibt diese Funktion den Wert null zurück.

ArgumenthtmlSource

Das Argument htmlSource ist die HTML-Quelle für eine Verbindung.

RückgabewerteEin Verbindungsobjekt, das Werte für eine bestimmte Kombination der nachfolgend aufgeführten Eigenschaften liefert. Die Eigenschaften, für die diese Funktion einen Wert zurückgibt, sind vom Dokumenttyp abhängig.


name Der Name der Verbindung

type Wenn useHTTP auf false gesetzt ist, wird angezeigt, welche DLL für die Verbindung mit der Datenbank während der Laufzeit verwendet werden soll.

string Verbindungsstring während der Ausführung Für ADO ist es ein String von Verbin-dungsparametern, für JDBC eine Verbindungs-URL.

dsn Data Source Name, der für ODBC- oder Cold Fusion-Verbindungen (Laufzeit) verwen-det wird.

driver Name eines JDBC-Treibers (Laufzeit)

username Name des Benutzers für die Laufzeitverbindung

password Kennwort für die Laufzeitverbindung

designtimeString Entwurfsphasen-Verbindungsstring (siehe string)

designtimeDsn Entwurfsphasen-Data Source Name (siehe dsn)

designtimeDriver Name eines JDBC-Treibers (Entwurfsphase)

designtimeUsername Name des Benutzers für die Entwurfsphasenverbindung

designtimePassword Kennwort für die Entwurfsphasenverbindung

designtimeType Entwurfsphasen-Verbindungstyp

usesDesigntimeInfo Wenn false, benutzt Dreamweaver Laufzeiteigenschaften in der Entwurfsphase; wenn nicht, Entwurfsphaseneigenschaften.

useHTTP Ein String. der true oder false enthält: true gibt an, dass die HTTP-Verbindung bei der Entwurfsphase verwendet werden soll; false gibt an, dass DLL verwendet wer-den soll.


72

Wird keine Verbindung in htmlSource gefunden, wird der Wert null zurückgegeben.

Hinweis: Entwickler können benutzerdefinierte Eigenschaften , z. B. Metadaten, in die HTML-Quelle aufnehmen, die von applyConnection() zusammen mit den Standardeigenschaften zurückgeben werden.

inspectConnection()


BeschreibungDreamweaver ruft diese Funktion auf, um die Dialogfelddaten zum Definieren der Verbindung zu initialisieren, wenn der Benutzer eine bestehende Verbindung bearbeitet. Auf diese Weise können im Dialogfeld die richtigen Verbindungsinfor-mationen angezeigt werden.

Argumentparameters

Beim Argument parameters handelt es sich um das gleiche Objekt, das die Funktion findConnection() zurückgibt.

RückgabewerteKeine

applyConnection()


BeschreibungDreamweaver ruft diese Funktion auf, wenn der Benutzer im Verbindungsdialogfeld auf OK klickt. Die Funktion apply-Connection() generiert die HTML-Quelle für eine Verbindung. Dreamweaver schreibt den HTML-Code in die Include-Datei Configuration\Connections\Verbindungsname.erw, wobei Verbindungsname der Name Ihrer Verbindung (siehe „Erstellen Sie das Layout für das Verbindungsdialogfeld.“ auf Seite 69) und .erw die Standarderweiterung für das Servermodell ist.

ArgumenteKeine

RückgabewerteDie HTML-Quelle für eine Verbindung. Dreamweaver schließt auch das Verbindungsdialogfeld. Wenn eine Feldüber-prüfung einen Fehler ergibt, zeigt applyConnection() eine Fehlermeldung an und gibt einen leeren String zurück, um anzuzeigen, dass das Dialogfeld nicht geschlossen werden soll.

includePattern Ein regulärer Ausdruck, mit dem die include-Anweisung auf der Seite in den Ansichten Live Data und Vorschau in Browser gesucht wird.

variables Objekt mit einer Eigenschaft für jede Seitenvariable, die auf deren entsprechenden Wert gesetzt wird. Dieses Objekt wird in den Ansichten Live Data und Vorschau in Browser verwendet.

catalog String mit einer Datenbankkennung, die den Umfang der angezeigten Metadaten ein-schränkt.

schema String mit einer Datenbankkennung, die den Umfang der angezeigten Metadaten ein-schränkt.

filename Name des Dialogfelds, über das die Verbindung erstellt wird.


73

Die generierte Include-DateiIn der von applyConnection() generierten Include-Datei werden alle Eigenschaften einer Verbindung deklariert. Der Dateiname der Include-Datei ist der Verbindungsname und weist die Erweiterung auf, die für das mit der aktuellen Site verknüpfte Servermodell definiert ist.

Hinweis: Verbindungen werden zur gemeinsamen Verwendung zentral abgelegt; setzen Sie daher den Wert für allowMultiple auf false. Dadurch wird gewährleistet, dass die Verbindungsdatei nur einmal in das Dokument aufgenommen wird und dass das Serverskript auf der Seite bleibt, auch dann, wenn andere Serververhalten es verwenden.

In den nachfolgenden Abschnitten finden Sie Beispiele für Include-Dateien, die von applyConnection() für diverse Standard-Servermodelle generiert werden.

Hinweis: Um ein neues Dateiformat für eine Include-Datei zu erstellen, müssen Sie eine neue EDML-Zuordnungsdatei definieren, die der Datei connection_includefile.edm ähnlich sein sollte (siehe dazu „Definitionsdateien für Ihren Verbin-dungstyp“ auf Seite 74).

ASP JavaScriptDie ASP- und JavaScript-Include-Datei sollte den Namen myConnection1.asp haben, wobei myConnection1 der Name der Verbindung ist. Das nachfolgende Beispiel ist eine Include-Datei für den ADO-Verbindungsstring:

<%

// Dateiname="Connection_ado_conn_string.htm"// Type="ADO"

// HTTP="true"

// Catalog=""

// Schema=""

var MM_MyConnection1_STRING = "dsn=pubs";%>

Die Serververhaltensdatei schließt diese Verbindung mit ein, indem sie die relative Include-Anweisung verwendet (siehe nachfolgendes Beispiel):



ColdFusionWenn Sie mit UltraDev 4 ColdFusion arbeiten, ruft Dreamweaver mithilfe einer ColdFusion Include-Datei eine Liste von Datenquellen ab.

Hinweis: Bei Dreamweaver-ColdFusion ignoriert Dreamweaver normalerweise alle Include-Dateien und ruft die Liste der Datenquellen stattdessen über RDS von ColdFusion ab.

Die Include-Datei für UltraDev 4 ColdFusion sollte den Namen myConnection1.cfm haben, wobei myConnection1 der Name Ihrer Verbindung ist. Nachfolgendes Beispiel zeigt die Include-Datei für eine ColdFusion-Verbindung mit einer Produkttabelle.











<CFSET MM_MyConnection1_DSN = "products">

<CFSET MM_MyConnection1_USERNAME = "">

<CFSET MM_Product_USERNAME = "">

<CFSET MM_MyConnection1_PASSWORD = "">

Die Serververhaltensdatei schließt diese Verbindung mit ein, indem sie die Anweisung cfinclude verwendet (siehe nachfolgendes Beispiel):

<cfinclude template="Connections/MyConnection1.cfm">


74

JSPDie JSP Include-Datei sollte den Namen MyConnection1.jsp haben, wobei MyConnection1 der Name Ihrer Verbindung ist. Nachfolgend ist ein Beispiel für eine Include-Datei für eine JDBC-Verbindung mit einer Datenbank aufgeführt:

<%

// Dateiname="Connection_jdbc_conn1.htm"

// Type="JDBC"

// HTTP="false"

// Catalog=""

// Schema=""

String MM_MyConnection1_DRIVER = "com.inet.tds.TdsDriver";

String MM_MyConnection1_USERNAME = "testadmin";

String MM_MyConnection1_PASSWORD = "velcro";

String MM_MyConnection1_URL = "jdbc:server:test-3:1433?database=pubs";

%>

Die Serververhaltensdatei schließt diese Verbindung mit ein, indem sie die relative Include-Anweisung verwendet (siehe nachfolgendes Beispiel):

<%@ include file="Connections/MyConnection1.jsp" %>

Definitionsdateien für Ihren Verbindungstyp Für jedes Servermodell gibt es eine eigene Datei connection_includefile.edml, die den Verbindungstyp definiert und die die in der Include-Datei definierten Eigenschaften den entsprechenden Elementen der Dreamweaver-Schnittstelle zuordnet.

Dreamweaver bietet standardmäßig sieben Definitionsdateien, d. h. eine für jedes der vordefinierten Servermodelle, die in der nachfolgenden Tabelle aufgeführt sind.

Dreamweaver ermittelt Verbindungsblöcke mit den Parametern quickSearch und searchPattern und erstellt Verbin-dungsblöcke mit dem Parameter insertText. Weitere Informationen über EDML-Tags und -Attribute sowie Suchmuster für reguläre Ausdrücke finden Sie unter „Serververhalten“ im Handbuch Dreamweaver erweitern.

Hinweis: Wenn Sie das Format Ihrer Include-Datei ändern oder eine Include-Datei für ein neues Servermodell definieren, müssen Sie die Verbindungsparameter der Dreamweaver Benutzeroberfläche sowie den Ansichten Live Data und Vorschau in Browser zuordnen. In nachfolgendem Beispiel für eine EDML-Datei, die mit dem Standard-ASP-JS-Servermodell verknüpft ist, wurden alle Variablen der Verbindungsseite den entsprechenden Werten zugeordnet, bevor die Seite an den Server gesendet wurde. Weitere Informationen über EDML und Suchmuster für reguläre Ausdrücke finden Sie unter „Serververhalten“ im Handbuch Dreamweaver erweitern.

Servermodell Unterordner im Ordner Configuration/Connections

ASP-JavaScript ASP_Js

ASP.NET CSharp ASP.NET_Csharp

ASP.NET VBScript ASP.NET_VB

ASP-VBScript ASP_Vbs

ColdFusion ColdFusion

JavaServer Page JSP

PHP MySql PHP_MySql


75

<participant name="connection_includefile" version="5.0"><quickSearch>

<![CDATA[// HTTP=]]></quickSearch>

<insertText location="">

<![CDATA[

<%

// FileName="@@filename@@"

// Type="@@type@@" @@designtimeString@@

// DesigntimeType="@@designtimeType@@"

// HTTP="@@http@@"

// Catalog="@@catalog@@"

// Schema="@@schema@@"

var MM_@@cname@@_STRING = @@string@@%>

]]>

</insertText>

<searchPatterns whereToSearch="directive">

<searchPattern paramNames="filename">

<![CDATA[/\/\/\s*FileName="([^"]*)"/]]></searchPattern>

<searchPattern paramNames="type,designtimeString">

<![CDATA[/\/\/\s+Type="(\w*)"([^\r\n]*)/]]></searchPattern>

<searchPattern paramNames="designtimeType" isOptional="true">

<![CDATA[/\/\/\s*DesigntimeType="(\w*)"/]]></searchPattern>

<searchPattern paramNames="http">

<![CDATA[/\/\/\s*HTTP="(\w+)"/]]></searchPattern>

<searchPattern paramNames="catalog">

<![CDATA[/\/\/\s*Catalog="(\w*)"/]]></searchPattern>

<searchPattern paramNames="schema">

<![CDATA[/\/\/\s*Schema="(\w*)"/]]></searchPattern>

<searchPattern paramNames="cname,string">

<![CDATA[/var\s+MM_(\w*)_STRING\s*=\s*([^\r\n]+)/]]></searchPattern></searchPatterns>

</participant>

Tokens in einer EDML-Datei, wie @@filename@@ in diesem Beispiel, ordnen Werte in der Include-Datei den jeweiligen Eigenschaften eines Verbindungsobjekts zu. Die Eigenschaften von Verbindungsobjekten legen Sie in der JavaScript-Imple-mentierungsdatei fest.

Alle standardmäßig im Lieferumfang von Dreamweaver enthaltenen Dialogfelder verwenden die Zuordnungsdatei connection_includefile.edml. Damit Dreamweaver diese Datei finden kann, wird der Dateiname, wie im folgenden Beispiel gezeigt, in der JavaScript-Implementierungsdatei festgelegt:

var PARTICIPANT_FILE = "connection_includefile";

Beim Erstellen eines benutzerdefinierten Verbindungstyps können Sie in Ihren Dialogfeldern eine beliebige Zuordnungs-datei angeben. Wenn Sie eine Zuordnungsdatei erstellen, können Sie für Ihre EDML-Datei einen beliebigen Namen neben connection_includefile verwenden. Wenn Sie einen anderen Namen verwenden, müssen Sie diesen auch in der JavaScript-Implementierungsdatei verwenden, wenn Sie den Wert für die Variable PARTICIPANT_FILE angeben, wie im folgenden Beispiel dargestellt.

var PARTICIPANT_FILE = "myConnection_mappingfile";


76

77

Kapitel 9: Die JavaBeans-API

In diesem Kapitel sind die APIs für JavaBeans beschrieben. Die MMJB*()-Funktionen sind JavaScript-Hooks, die Java-Intro-spektionsaufrufe für JavaBeans-Unterstützung aufrufen. Diese Funktionen rufen die Klassennamen, Methoden, Eigen-schaften und Ereignisse aus JavaBeans ab, die in der Dreamweaver-Benutzeroberfläche angezeigt werden können. Damit diese JavaScript-Funktionen verwendet werden können und Adobe® Dreamweaver® CS3 der Zugriff auf JavaBeans ermög-licht wird, muss sich JavaBeans im Ordner Configuration\Classes befinden.

Hinweis: Die in diesem Kapitel beschriebenen Funktionsargumente verfügen möglicherweise über das Argument packageName.className, das einen einzelnen Wert repräsentiert.

Die JavaBeans-API Die folgenden Funktionen stellen Methoden des MMJB-Objekts dar.

MMJB.getClasses()


BeschreibungDiese Funktion ruft alle JavaBeans-Klassennamen ab, die sich im Ordner Configuration\Classes befinden.

ArgumenteKeine

RückgabewerteEin String-Array von Klassennamen im Ordner Configuration\Classes. Bei einem Fehler wird ein leeres Array zurückge-geben.

MMJB.getClassesFromPackage()


BeschreibungDiese Funktion ruft alle JavaBeans-Klassen aus dem Paket ab.

ArgumentepackageName.pathName

• Das Argument packageName.pathName ist der Pfad zu dem Paket. Es muss sich dabei um ein Java-Archiv (JAR oder ZIP) handeln, z. B. C:\jdbcdrivers\Una2000_Enterprise.zip.

RückgabewerteEin String-Array von Klassennamen in einem bestimmten JAR- oder ZIP-Java-Archiv. Bei einem Fehler wird ein leeres Array zurückgegeben.


78

MMJB.getErrorMessage()


BeschreibungDiese Funktion ruft die letzte Dreamweaver-Fehlermeldung ab, die während der Verwendung der MMJB-Schnittstelle ausgegeben wurde.

ArgumenteKeine

RückgabewerteEin String aus der letzten Dreamweaver-Fehlermeldung.

MMJB.getEvents()


BeschreibungÜberprüft die JavaBeans-Klasse und gibt deren Ereignisse zurück.

ArgumentepackageName.className, {packagePath}

• Das Argument packageName.className ist der Name der Klasse. Die Klasse muss sich in einem JAR- oder ZIP-Java-Archiv befinden. Wenn packagePath weggelassen wird, muss sich das Archiv im classpath Ihres Systems befinden oder eine Klassendatei sein, die im Ordner Configuration\Classes gespeichert ist.

• Das Argument packagePath ist ein optionaler String, der auf den Speicherort des JAR- oder ZIP-Java-Archivs verweist, das className enthält.

RückgabewerteEin String-Array von Ereignissen, die className zugeordnet sind. Bei einem Fehler wird ein leeres Array zurückgegeben.

MMJB.getIndexedProperties()


BeschreibungÜberprüft die JavaBeans-Klasse und gibt deren indizierte Eigenschaften zurück, d. h. Entwurfsmuster mit dem gleichen Verhalten wie Sammlungen.




RückgabewerteEin String-Array der indizierten Eigenschaften, die className zugeordnet sind. Bei einem Fehler wird ein leeres Array zurückgegeben.


79

MMJB.getMethods()


BeschreibungÜberprüft die JavaBeans-Klasse und gibt deren Methoden zurück.




RückgabewerteEin String-Array von Methoden, die className zugeordnet sind. Bei einem Fehler wird ein leeres Array zurückgegeben.

MMJB.getProperties()


BeschreibungÜberprüft die JavaBeans-Klasse und gibt deren Eigenschaften zurück.




RückgabewerteEin String-Array von Eigenschaften, die className zugeordnet sind. Bei einem Fehler wird ein leeres Array zurückgegeben.

MMJB.getReadProperties()


BeschreibungRuft Nur-Lesen-Eigenschaften für JavaBeans ab, die get accessor-Aufrufe unterstützen.





80

RückgabewerteEin String-Array von Nur-Lesen-Eigenschaften, die className zugeordnet sind. Bei einem Fehler wird ein leeres Array zurückgegeben.

MMJB.getWriteProperties()


BeschreibungRuft Nur-Schreiben-Eigenschaften für JavaBeans auf, die set method-Aufrufe unterstützen.




RückgabewerteEin String-Array von Nur-Lesen-Eigenschaften, die className zugeordnet sind. Bei einem Fehler wird ein leeres Array zurückgegeben.

81

Kapitel 10: API zur Integration der Quellcodeverwaltung

Mit der API zur Integration der Quellcodeverwaltung können Sie gemeinsam genutzte Bibliotheken schreiben, um das Ein- und Auschecken in Adobe® Dreamweaver® CS3 unter Verwendung von Quellcode-Verwaltungssystemen (wie Sourcesafe oder CVS) zu erweitern.

Ihre Bibliotheken müssen eine Mindestanzahl erforderlicher API-Funktionen unterstützen, damit Dreamweaver in ein Quellcode-Verwaltungssystem integriert werden kann. Außerdem müssen sich Ihre Bibliotheken im Ordner Programme/Adobe/Adobe Dreamweaver CS3/Configuration/SourceControl befinden.

Beim Start von Dreamweaver werden die einzelnen Bibliotheken geladen. Dreamweaver ruft GetProcAddress() für jede API-Funktion auf, um zu ermitteln, welche Funktionen die Bibliothek unterstützt. Wenn keine Adresse vorhanden ist, nimmt Dreamweaver an, dass die API nicht von der Bibliothek unterstützt wird. Wenn die Adresse vorhanden ist, verwendet Dreamweaver die Bibliothek-Version der Funktion, um die Funktionalität zu unterstützen. Wenn ein Dream-weaver-Benutzer eine Site definiert oder bearbeitet und anschließend die Registerkarte Web Server SCS auswählt, werden zusätzlich zu den Standardelementen die Auswahlmöglichkeiten angezeigt, die den aus dem Ordner Programme/Adobe/Adobe Dreamweaver CS3/Configuration/SourceControl geladenen DLLs entsprechen.

Um ein Menü des Typs Site > Quellcodeverwaltung zu erstellen, dem Sie benutzerdefinierte Elemente hinzufügen können, fügen Sie den folgenden Code in das Menü Site in der Datei menus.xml ein:

<menu name="Source Control" id="DWMenu_MainSite_Site_Source¬

Control"><menuitem dynamic name="None"file="Menus/MM/¬

File_SCSItems.htm" id="DWMenu_MainSite_Site_NewFeatures_¬

Default" />

</menu>


• „Erforderliche Funktionen für die API zur Integration der Quellcodeverwaltung“ auf Seite 82

• „Optionale Funktionen für die API zur Integration der Quellcodeverwaltung“ auf Seite 87

• „Enabler“ auf Seite 95

So funktioniert die Integration der Quellcodeverwaltung in DreamweaverWenn ein Dreamweaver-Benutzer eine Serververbindung, eine Dateiübertragung oder Funktionen im Zusammenhang mit Design Notes auswählt, ruft Dreamweaver die DLL-Version der entsprechenden API-Funktion auf (Connect(), Disconnect(), Get(), Put(), Checkin(), Checkout(), Undocheckout() und Synchronize()). Die DLL handhabt die Anfor-derung und das Anzeigen von Dialogfeldern, in denen Informationen erfasst werden oder über die Benutzer mit der DLL interagieren. Die DLL zeigt außerdem Informationen und Fehlermeldungen an.

Das Quellcodeverwaltungsystem kann optional Design Notes und das Ein- und Auschecken unterstützen. In Dreamweaver aktivieren Sie Design Notes für das Quellcode-Verwaltungssystem, indem Sie im Dialogfeld Sites bearbeiten die Register-karte Design Notes auswählen und dann das entsprechende Kontrollkästchen aktivieren. So werden Design Notes auch über FTP und LANs aktiviert. Wenn Design Notes vom Quellcode-Verwaltungssystem nicht unterstützt werden und der Benutzer diese Funktion verwenden möchte, werden Design Notes-Dateien (MNO-Dateien) von Dreamweaver transpor-tiert, um die Design Notes zu verwalten (wie auch über FTP und LANs).

Das Ein- und Auschecken wird anders behandelt als die Funktion der Design Notes: Wenn das Quellcode-Verwaltungs-system dies unterstützt, kann der Benutzer die Verwendung nicht vom Dialogfeld Design Notes aus außer Kraft setzen. Wenn der Benutzer versucht, das Quellcode-Verwaltungssystem außer Kraft zu setzen, wird eine Fehlermeldung angezeigt.


82

Quellcode-Verwaltungssystemfunktionen hinzufügenSie können zu Dreamweaver Quellcode-Verwaltungssystemfunktionen hinzufügen, indem Sie einen GetNewFeatures-Handler schreiben, der eine Gruppe von Menüobjekten und entsprechenden C-Funktionen zurückgibt. Wenn Sie beispiels-weise eine Sourcesafe-Bibliothek schreiben und es Dreamweaver-Benutzern ermöglichen möchten, den Verlauf einer Datei anzuzeigen, können Sie einen Handler GetNewFeatures schreiben, der das Menüobjekt Verlauf und den C-Funktions-namen history zurückgibt. Wenn der Benutzer anschließend in Windows mit der rechten Maustaste auf eine Datei klickt, ist das Menüobjekt Verlauf eine der Optionen im Kontextmenü. Wenn ein Benutzer das Menüobjekt Verlauf auswählt, ruft Dreamweaver die entsprechende Funktion auf, und die ausgewählten Dateien werden an die DLL weitergegeben. Die DLL zeigt das Dialogfeld Verlauf an, sodass der Benutzer damit genauso interagieren kann wie bei Sourcesafe.

Erforderliche Funktionen für die API zur Integration der QuellcodeverwaltungDie API zur Integration der Quellcodeverwaltung verfügt über erforderliche und optionale Funktionen. Bei den hier aufge-führten Funktionen handelt es sich um erforderliche Funktionen.

bool SCS_GetAgentInfo()

BeschreibungDiese Funktion fordert die DLL auf, ihren Namen und eine Beschreibung zurückzugeben. Diese Informationen werden im Dialogfeld Sites bearbeiten angezeigt. Der Name wird im Popupmenü Server-Zugriff angezeigt (z. B. sourcesafe, webdav, perforce) und die Beschreibung direkt unter dem Popupmenü.

Argumentechar name[32], char version[32], char description[256], const char *dwAppVersion

• Das Argument name ist der Name des Quellcode-Verwaltungssystems. Der Name wird im Dialogfeld Sites bearbeiten auf der Registerkarte Quellcodeverwaltung im Kombinationsfeld zum Auswählen eines Quellcode-Verwaltungssy-stems angezeigt. Der Name kann aus maximal 32 Zeichen bestehen.

• Das Argument version ist ein String, der die Version der DLL anzeigt. Die Version wird im Dialogfeld Sites bearbeiten auf der Registerkarte Quellcodeverwaltung angezeigt. Die Version kann aus maximal 32 Zeichen bestehen.

• Das Argument description ist ein String, der die Beschreibung des Quellcode-Verwaltungssystems enthält. Die Beschreibung wird im Dialogfeld Sites bearbeiten auf der Registerkarte Quellcodeverwaltung angezeigt. Die Beschreibung kann aus maximal 256 Zeichen bestehen.

• Das Argument dwAppVersion ist ein String, der die Dreamweaver-Version angibt, die die DLL aufruft. Die DLL kann anhand dieses Strings die Version und Sprache von Dreamweaver bestimmen.

RückgabewerteEin Boolescher Wert: true, wenn erfolgreich, andernfalls false.

bool SCS_Connect()

BeschreibungDiese Funktion verbindet den Benutzer mit dem Quellcode-Verwaltungssystem. Wenn die DLL nicht über Anmeldungs-informationen verfügt, muss die DLL ein Dialogfeld anzeigen, in dem der Benutzer aufgefordert wird, die Informationen einzugeben. Sie muss außerdem die Daten für die spätere Verwendung speichern.

Argumentevoid **connectionData, const char siteName[64]


83

• Das Argument connectionData ist ein Handle zu den Daten, die beim Aufrufen anderer API-Funktionen von Dream-weaver an den Agenten weitergegeben werden sollen.

• Das Argument siteName ist ein String, der auf den Namen der Site verweist. Der Sitename kann aus maximal 64 Zeichen bestehen.


bool SCS_Disconnect()

BeschreibungDiese Funktion trennt die Verbindung des Benutzers zum Quellcode-Verwaltungssystem.

Argumentevoid *connectionData

• Das Argument connectionData ist ein Zeiger auf die Daten des Agenten, die während des Aufrufs von Connect() an Dreamweaver weitergegeben wurden.


bool SCS_IsConnected()

BeschreibungDiese Funktion bestimmt den Status der Verbindung.




int SCS_GetRootFolderLength()

BeschreibungDiese Funktion gibt die Länge des Stammordnernamens zurück.



RückgabewerteEine Ganzzahl, die die Länge des Stammordnernamens angibt. Ist der Rückgabewert der Funktion < 0, wird dies von Dreamweaver als Fehler interpretiert, und das Programm versucht, die Fehlermeldung von der DLL abzurufen, sofern dies unterstützt wird.

bool SCS_GetRootFolder()

BeschreibungDiese Funktion gibt den Namen des Stammordners zurück.


84

Argumentevoid *connectionData, char remotePath[], const int folderLen


• remotePath ist ein Puffer, in dem der Remote-Pfad des Stammordners gespeichert wird.

• Das Argument folderLen ist eine Ganzzahl, mit der die Länge von remotePath angezeigt wird. Dies ist der von GetRoot-FolderLength zurückgegebene Wert.


int SCS_GetFolderListLength()

BeschreibungDiese Funktion gibt die Anzahl der Elemente im eingereichten Ordner zurück.

Argumentevoid *connectionData, const char *remotePath


• Das Argument remotePath ist der vollständige Pfad und Name des Remote-Ordners, den die DLL auf die Anzahl der Elemente prüft.

RückgabewerteEine Ganzzahl, die die Anzahl der Elemente im aktuellen Ordner angibt. Ist der Rückgabewert der Funktion < 0, wird dies von Dreamweaver als Fehler interpretiert, und das Programm versucht, die Fehlermeldung von der DLL abzurufen, sofern dies unterstützt wird.

bool SCS_GetFolderList()

BeschreibungDiese Funktion gibt eine Liste der Dateien und Ordner im eingereichten Ordner zurück, einschließlich zugehöriger Infor-mationen wie Größe, Datum der letzten Änderung und der Angabe, ob es sich um einen Ordner oder eine Datei handelt.

Argumentevoid *connectionData, const char *remotePath, itemInfo itemList[ ], const int numItems


• Das Argument remotePath ist der Pfadname des Remote-Ordners, den die DLL auf die Anzahl der Elemente prüft.

• Das Argument itemList ist eine bereits zugewiesene Liste mit itemInfo-Strukturen:

name char[256] Name der Datei oder des Ordners

isFolder bool true, wenn Ordner; false, wenn Datei

month int Komponente Monat von Änderungsdatum 1–12

day int Komponente Tag von Änderungsdatum 1–31

year int Komponente Jahr von Änderungsdatum 1900+

hour int Komponente Stunde von Änderungsdatum 0–23

minutes int Komponente Minute von Änderungsdatum 0–59


85

• Das Argument numItems ist die Anzahl der für itemList zugewiesenen Elemente (zurückgegeben von GetFolderList-Length).


bool SCS_Get()

BeschreibungDiese Funktion ruft eine Liste mit Dateien oder Ordnern ab und speichert sie lokal.

Argumentevoid *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems


• Das Argument remotePathList ist eine Liste der abzurufenden Remote-Dateien oder Remote-Ordner. Die Liste enthält die vollständigen Pfade und Namen.

• Das Argument localPathList ist eine gespiegelte Liste der Namen lokaler Dateien oder Ordnerpfade.

• Das Argument numItems ist die Anzahl der Elemente in jeder Liste.


bool SCS_Put()

BeschreibungDiese Funktion stellt eine Liste mit lokalen Dateien oder Ordnern im Quellcode-Verwaltungssystem bereit.

Argumentevoid *connectionData, const char *localPathList[], const char *remotePathList[], const int numItems


• Das Argument localPathList ist die Liste mit Namen der lokalen Dateien oder Pfaden zu lokalen Ordnern, die im Quellcode-Verwaltungssystem bereitgestellt werden sollen.

• Das Argument remotePathList ist eine gespiegelte Liste mit Namen von Remote-Dateien oder Pfaden zu Remote-Ordnern.



Sekunden int Komponente Sekunde von Änderungsdatum 0–59

type char[256] Dateityp (falls nicht durch die DLL festgelegt, bestimmt Dreamweaver den Typ wie bisher anhand der Dateierweiterung)

Größe int in Byte

name char[256] Name der Datei oder des Ordners


86

bool SCS_NewFolder()

BeschreibungMit dieser Funktion wird ein neuer Ordner erstellt.



• Das Argument remotePath ist der vollständige Pfadname des Remote-Ordners, der von der DLL erstellt wird.


bool SCS_Delete()

BeschreibungDiese Funktion löscht eine Liste mit Dateien oder Ordnern aus dem Quellcode-Verwaltungssystem.

Argumentevoid *connectionData, const char *remotePathList[], const int numItems


• Das Argument remotePathList ist eine Liste der Namen zu löschender Remote-Dateien bzw. der Pfade zu löschender Remote-Ordner.

• Das Argument numItems ist die Anzahl der Elemente in remotePathList.


bool SCS_Rename()

BeschreibungDiese Funktion bewirkt, dass eine Datei oder ein Ordner umbenannt oder verschoben wird, je nach den für oldRemotePath und newRemotePath angegebenen Werten. Ist beispielsweise oldRemotePath gleich "$/folder1/file1" und newRemotePath gleich "$/folder1/renamefile1", wird file1 in renamefile1 umbenannt und befindet sich in folder1.

Ist oldRemotePath gleich "$/folder1/file1" und newRemotePath gleich "$/folder1/subfolder1/file1", wird file1 in den Ordner subfolder1 verschoben.

Um herauszufinden, ob es sich bei dem Aufruf dieser Funktion um eine Verschiebung oder um ein Umbenennen handelt, überprüfen Sie die übergeordneten Pfade der beiden Eingabewerte. Wenn sie identisch sind, handelt es sich bei dem Vorgang um eine Umbenennung.

Argumentevoid *connectionData, const char *oldRemotePath, const char *newRemotePath


• Das Argument oldRemotePath ist der Pfad des umzubenennenden Remote-Ordners bzw. der umzubenennenden Remote-Datei.

• Das Argument newRemotePath ist der Remote-Pfad des neuen Namens für die Datei oder den Ordner.


87


bool SCS_ItemExists()

BeschreibungDiese Funktion bestimmt, ob eine Datei bzw. ein Ordner auf dem Server vorhanden ist.



• Das Argument remotePath ist der Pfad zu einer Remote-Datei bzw. einem Remote-Ordner.


Optionale Funktionen für die API zur Integration der QuellcodeverwaltungDie API zur Integration der Quellcodeverwaltung verfügt über erforderliche und optionale Funktionen. Bei den hier aufge-führten Funktionen handelt es sich um optionale Funktionen.

bool SCS_GetConnectionInfo()

BeschreibungDiese Funktion zeigt ein Dialogfeld an, in dem der Benutzer die Verbindungsinformationen für diese Site ändern oder festlegen kann. Eine Verbindung wird nicht hergestellt. Diese Funktion wird aufgerufen, wenn der Benutzer im Dialogfeld Sites bearbeiten im Abschnitt Remote-Informationen auf die Schaltfläche Einstellungen... klickt.

Argumentevoid **connectionData, const char siteName[64]

• Das Argument connectionData ist ein Handle zu den Daten, die beim Aufrufen anderer API-Funktionen von Dream-weaver an den Agenten weitergegeben werden sollen.

• Das Argument siteName ist ein String, der auf den Namen der Site verweist. Der Name darf höchstens 64 Zeichen enthalten.


bool SCS_SiteDeleted()

BeschreibungDiese Funktion teilt der DLL mit, dass die Site gelöscht wurde oder nicht mehr mit diesem Quellcode-Verwaltungssystem verbunden ist. Dies bedeutet, dass das Quellcodeverwaltungssystem die persistenten Daten für diese Site löschen kann.

Argumenteconst char siteName[64]

• Das Argument siteName ist ein String, der auf den Namen der Site verweist. Der Name darf höchstens 64 Zeichen enthalten.


88


bool SCS_SiteRenamed()

BeschreibungDiese Funktion teilt der DLL mit, wenn der Benutzer die Site umbenannt hat, sodass die permanenten Informationen zu der Site in der DLL aktualisiert werden können.

Argumenteconst char oldSiteName[64], const char newSiteName[64]

• Das Argument oldSiteName ist ein String, der auf den ursprünglichen Namen der Site verweist. Dies ist der Name der Site vor der Umbenennung. Der Name darf höchstens 64 Zeichen enthalten.

• Das Argument newSiteName ist ein String, der auf den neuen Namen der Site verweist. Dies ist der Name der Site nach der Umbenennung. Der Name darf höchstens 64 Zeichen enthalten.


int SCS_GetNumNewFeatures()

BeschreibungDiese Funktion gibt die Zahl der neuen Funktionen zurück, die Dreamweaver hinzugefügt werden (z. B. Dateiverlauf, Unterschiede usw.).

ArgumenteKeine

RückgabewerteEine Ganzzahl, die die Anzahl der neuen Funktionen angibt, die Dreamweaver hinzugefügt werden. Ist der Rückgabewert der Funktion < 0, wird dies von Dreamweaver als Fehler interpretiert, und das Programm versucht, die Fehlermeldung von der DLL abzurufen, sofern dies unterstützt wird.

bool SCS_GetNewFeatures()

BeschreibungDiese Funktion gibt eine Liste mit Menüelementen zurück, die in das Hauptmenü und in die Kontextmenüs von Dream-weaver eingefügt werden sollen. Beispielsweise können mit der Sourcesafe-DLL Verlauf und Dateiunterschiede in das Hauptmenü eingefügt werden.

Argumentechar menuItemList[][32], scFunction functionList[], scFunction enablerList[], const int numNewFeatures

• Das Argument menuItemList ist eine Liste mit Strings, die von der DLL ausgefüllt wird. Sie gibt die Menüelemente an, die dem Hauptmenü und den Kontextmenüs hinzugefügt werden sollen. Jeder String kann höchstens 32 Zeichen enthalten.

• Das Argument functionList wird von der DLL gefüllt. Es legt fest, welche Routinen in der DLL aufgerufen werden, wenn der Benutzer das entsprechende Menüelement auswählt.

• Das Argument enablerList wird von der DLL gefüllt. Es legt fest, welche Routinen in der DLL aufgerufen werden, wenn Dreamweaver bestimmen muss, ob das entsprechende Menüelement aktiviert ist.

• Das Argument numNewFeatures ist die Anzahl der Elemente, die von der DLL hinzugefügt werden. Dieser Wert wird vom Aufruf GetNumNewFeatures() abgerufen.


89

Die folgende Funktionssignatur definiert die Funktionen und Enabler, die mit den Argumenten functionlist und enablerList an den Aufruf von SCS_GetNewFeatures() übergeben werden.

bool (*scFunction)(void *connectionData, const char *remotePathList[],

const char *localPathList[], const int numItems)


bool SCS_GetCheckoutName()

BeschreibungDiese Funktion gibt den Auschecknamen des aktuellen Benutzers zurück. Falls diese Funktion vom Quellcode-Verwal-tungssystem nicht unterstützt wird, aber vom Benutzer aktiviert wurde, wird die interne Dreamweaver-Funktion Einchecken/Auschecken verwendet, mit der LCK-Dateien in das Quellcode-Verwaltungssystem und aus dem Quellcode-Verwaltungssystem transportiert werden.

Argumentevoid *connectionData, char checkOutName[64], char emailAddress[64]


• Das Argument checkOutName ist der Name des aktuellen Benutzers.

• Das Argument emailAddress ist die E-Mail-Adresse des aktuellen Benutzers.


bool SCS_Checkin()

BeschreibungDiese Funktion checkt eine Liste mit lokalen Dateien oder Ordnern in das Quellcode-Verwaltungssystem ein. Die DLL ist verantwortlich für das Einstellen des Schreibschutzes für die Datei. Falls diese Funktion vom Quellcode-Verwaltungs-system nicht unterstützt wird, aber vom Benutzer aktiviert wurde, wird die interne Dreamweaver-Funktion Einchecken/Auschecken verwendet, mit der LCK-Dateien in das Quellcode-Verwaltungssystem und aus dem Quellcode-Verwaltungssystem transportiert werden.

Argumentevoid *connectionData, const char *localPathList[], const char *remotePathList[], bool successList[], const int numItems


• Das Argument localPathList ist eine Liste der Namen einzucheckender lokaler Dateien oder Ordnerpfade.


• Das Argument successList ist eine Liste mit Booleschen Werten, die von der DLL angegeben werden, um Dreamweaver mitzuteilen, welche der zugehörigen Dateien erfolgreich eingecheckt wurden.




90

bool SCS_Checkout()

BeschreibungDiese Funktion checkt eine Liste lokaler Dateien oder Ordner aus dem Quellcode-Verwaltungssystem aus. Die DLL ist verantwortlich dafür, die Schreibberechtigungen für die Datei zu gewähren. Falls diese Funktion vom Quellcode-Verwal-tungssystem nicht unterstützt wird, aber vom Benutzer aktiviert wurde, wird die interne Dreamweaver-Funktion Einchecken/Auschecken verwendet, mit der LCK-Dateien in das Quellcode-Verwaltungssystem und aus dem Quellcode-Verwaltungssystem transportiert werden.

Argumentevoid *connectionData, const char *remotePathList[], const char *localPathList[], bool successList[], const int numItems


• Das Argument remotePathList ist eine Liste der Namen auszucheckender Remote-Dateien bzw. der Pfade auszuchek-kender Remote-Ordner.


• Das Argument successList ist eine Liste mit Booleschen Werten, die von der DLL angegeben werden, um Dreamweaver mitzuteilen, welche der zugehörigen Dateien erfolgreich ausgecheckt wurden.



bool SCS_UndoCheckout()

BeschreibungDiese Funktion macht den Auscheck-Status einer Liste mit Dateien oder Ordnern rückgängig. Die DLL ist verantwortlich für das Einstellen des Schreibschutzes für die Datei. Falls diese Funktion vom Quellcode-Verwaltungssystem nicht unter-stützt wird, aber vom Benutzer aktiviert wurde, wird die interne Dreamweaver-Funktion Einchecken/Auschecken verwendet, mit der LCK-Dateien in das Quellcode-Verwaltungssystem und aus dem Quellcode-Verwaltungssystem trans-portiert werden.

Argumentevoid *connectionData, const char *remotePathList[], const char *localPathList[], bool successList[], const int numItems


• Das Argument remotePathList ist eine Liste der Namen von Remote-Dateien oder Pfadnamen von Remote-Ordnern, für die das Auschecken rückgängig gemacht werden soll.


• Das Argument successList ist eine Liste mit Booleschen Werten, die von der DLL angegeben werden, um Dreamweaver mitzuteilen, für welche der zugehörigen Dateien das Auschecken erfolgreich rückgängig gemacht wurde.




91

int SCS_GetNumCheckedOut()

BeschreibungDiese Funktion gibt die Anzahl der Benutzer zurück, die eine Datei ausgecheckt haben.



• Das Argument remotePath ist der Name der Remote-Datei oder der Pfad zum Remote-Ordner, der daraufhin überprüft werden soll, wie viele Benutzer die Datei bzw. den Ordner ausgecheckt haben.

RückgabewerteEine Ganzzahl, die angibt, wie viele Personen die Datei ausgecheckt haben. Ist der Rückgabewert der Funktion < 0, wird dies von Dreamweaver als Fehler interpretiert, und das Programm versucht, die Fehlermeldung von der DLL abzurufen, sofern dies unterstützt wird.

bool SCS_GetFileCheckoutList()

BeschreibungDiese Funktion gibt eine Liste der Benutzer zurück, die eine Datei ausgecheckt haben. Wenn die Liste leer ist, hat niemand die Datei ausgecheckt.

Argumentevoid *connectionData, const char *remotePath, char checkOutList[][64], char emailAddressList[][64], const int numCheckedOut


• Das Argument remotePath ist der Pfadname der Remote-Datei oder des Remote-Ordners, der daraufhin überprüft werden soll, wie viele Benutzer die Datei bzw. den Ordner ausgecheckt haben.

• Das Argument checkOutList ist eine Liste mit Strings, die den Benutzern entsprechen, die die Datei ausgecheckt haben. Die Benutzerstrings können jeweils maximal 64 Zeichen lang sein.

• Das Argument emailAddressList ist eine Liste mit Strings, die den E-Mail-Adressen der Benutzer entsprechen. Die Strings für die E-Mail-Adressen können jeweils maximal 64 Zeichen lang sein.

• Das Argument numCheckedOut ist die Anzahl der Personen, die die Datei ausgecheckt haben. Diese Zahl wird von GetNumCheckedOut() zurückgegeben.


int SCS_GetErrorMessageLength()

BeschreibungDiese Funktion gibt die Länge der aktuellen internen Fehlermeldung der DLL zurück. Dies weist den Puffer zu, der an die Funktion GetErrorMessage() übergeben wird. Diese Funktion sollte nur dann aufgerufen werden, wenn eine API-Funktion false oder <0 zurückgibt, wodurch ein Fehler dieser API-Funktion angezeigt wird.




92

RückgabewerteEine Ganzzahl, die die Länge der Fehlermeldung angibt.

bool SCS_GetErrorMessage()

BeschreibungDiese Funktion gibt die letzte Fehlermeldung zurück. Wenn Sie getErrorMessage() implementieren, ruft Dreamweaver die Funktion jedes Mal auf, wenn eine Ihrer API-Funktionen den Wert false zurückgibt.

Wenn eine Routine –1 oder false zurückgibt, wird dadurch angezeigt, dass eine Fehlermeldung verfügbar sein sollte.

Argumentevoid *connectionData, char errorMsg[], const int *msgLength

Das Argument connectionData ist ein Zeiger auf die Daten des Agenten, die während des Aufrufs von Connect() an Dreamweaver weitergegeben wurden.

• Das Argument errorMsg ist ein bereits zugewiesener String, der von der DLL mit der Fehlermeldung gefüllt wird.

• Das Argument msgLength ist die Länge des Puffers, der durch das errorMsg[]-Argument dargestellt wird.


int SCS_GetNoteCount()

BeschreibungDiese Funktion gibt die Anzahl der Design Note-Schlüssel für den angegebenen Pfad der Remote-Datei bzw. des Remote-Ordners zurück. Wenn dies vom Quellcode-Verwaltungssystem nicht unterstützt wird, ruft Dreamweaver diese Informa-tionen aus der zugehörigen MNO-Datei ab.



• Das Argument remotePath ist der Pfadname der Remote-Datei oder des Remote-Ordners, den die DLL auf die Anzahl der angefügten Design Notes überprüft.

RückgabewerteEine Ganzzahl, die die Anzahl der Design Notes angibt, die zu dieser Datei gehören. Ist der Rückgabewert der Funktion < 0, wird dies von Dreamweaver als Fehler interpretiert, und das Programm versucht, die Fehlermeldung von der DLL abzurufen, sofern dies unterstützt wird.


93

int SCS_GetMaxNoteLength()

BeschreibungDiese Funktion gibt die Länge der größten Design Note für die angegebene Datei bzw. den angegebenen Ordner zurück. Wenn dies vom Quellcode-Verwaltungssystem nicht unterstützt wird, ruft Dreamweaver diese Informationen aus der zugehörigen MNO-Datei ab.



• Das Argument remotePath ist der Pfadname der Remote-Datei oder des Remote-Ordners, den die DLL auf die maximale Design Note-Länge überprüft.

RückgabewerteEine Ganzzahl, die die Größe der längsten Design Note angibt, die zu dieser Datei gehört. Ist der Rückgabewert der Funktion < 0, wird dies von Dreamweaver als Fehler interpretiert, und das Programm versucht, die Fehlermeldung von der DLL abzurufen, sofern dies unterstützt wird.

bool SCS_GetDesignNotes()

BeschreibungDiese Funktion ruft Schlüssel-Wertpaare aus den Meta-Informationen für die angegebene Datei bzw. den angegebenen Ordner ab. Wenn dies vom Quellcode-Verwaltungssystem nicht unterstützt wird, ruft Dreamweaver diese Informationen aus der zugehörigen MNO-Datei ab.

Argumentevoid *connectionData, const char *remotePath, char keyList[][64], char *valueList[], bool showCol-umnList[], const int noteCount, const int noteLength


• Das Argument remotePath ist der Pfadname der Remote-Datei oder des Remote-Ordners, den die DLL auf die Anzahl der Elemente überprüft.

• Das Argument keyList ist eine Liste der Design Note-Schlüssel, z. B. "Status".

• Das Argument valueList ist eine Liste der Design Note-Werte, die den Design Note-Schlüsseln entsprechen, z. B. "Awaiting Signoff".

• Das Argument showColumnList ist eine Liste der Booleschen Werte, die den Design Note-Schlüsseln entsprechen. Damit wird angegeben, ob Dreamweaver den Schlüssel als Spalte im Bedienfeld Site anzeigen kann.

• Das Argument noteCount ist die Anzahl der Design Notes, die an eine Datei oder einen Ordner angefügt sind. Dieser Wert wird vom Aufruf GetNoteCount() zurückgegeben.

• Das Argument noteLength ist die maximale Länge einer Design Note. Dies ist der vom Aufruf GetMaxNoteLength() zurückgegebene Wert.



94

bool SCS_SetDesignNotes()

BeschreibungDiese Funktion speichert die Schlüssel-Wertpaare in den Meta-Informationen für die angegebene Datei bzw. für den angegebenen Ordner. Hierdurch wird das Set von Meta-Informationen für die Datei ersetzt. Wenn dies vom Quellcode-Verwaltungssystem nicht unterstützt wird, speichert Dreamweaver Design Notes in MNO-Dateien.

Argumentevoid *connectionData, const char *remotePath, const char keyList[][64], const char *valueList[], bool showColumnList[], const int noteCount, const int noteLength


• Das Argument remotePath ist der Pfadname der Remote-Datei oder des Remote-Ordners, den die DLL auf die Anzahl der Elemente überprüft.

• Das Argument keyList ist eine Liste der Design Note-Schlüssel, z. B. "Status".

• Das Argument valueList ist eine Liste der Design Note-Werte, die den Design Note-Schlüsseln entsprechen, z. B. "Awaiting Signoff".

• Das Argument showColumnList ist eine Liste der Booleschen Werte, die den Design Note-Schlüsseln entsprechen. Damit wird angegeben, ob Dreamweaver den Schlüssel als Spalte im Bedienfeld Site anzeigen kann.

• Das Argument noteCount ist die Anzahl der Design Notes, die an eine Datei oder einen Ordner angefügt sind. Anhand dieser Zahl kann die DLL die Größe der angegebenen Listen ermitteln. Wenn noteCount gleich 0 ist, werden alle Design Notes aus der Datei entfernt.

• Das Argument noteLength ist die Länge der größten Design Note für die angegebene Datei bzw. den angegebenen Ordner.


bool SCS_IsRemoteNewer()

BeschreibungDiese Funktion prüft jeden angegebenen Remote-Pfad, um festzustellen, ob die Remote-Version neuer ist. Wenn dies vom Quellcode-Verwaltungssystem nicht unterstützt wird, verwendet Dreamweaver seinen internen isRemoteNewer-Algorithmus.

Argumentevoid *connectionData, const char *remotePathList[], const char *localPathList[], int remoteIsNewerList[], const int numItems


• Das Argument remotePathList ist eine Liste der Namen von Remote-Dateien oder Pfadnamen von Remote-Ordnern, die auf einen neueren Status überprüft werden sollen.


• Das Argument remoteIsNewerList ist eine Liste mit Ganzzahlen, die von der DLL ausgefüllt wird und Dreamweaver mitteilt, welche der entsprechenden Dateien auf der Remote-Seite neuer sind. Folgende Werte sind gültig: 1 gibt an, dass die Remote-Version neuer ist. –1 gibt an, dass die lokale Version neuer ist. 0 gibt an, dass die beiden Versionen identisch sind.




95

EnablerWenn die optionalen Enabler vom Quellcode-Verwaltungssystem nicht unterstützt werden oder wenn die Anwendung nicht mit dem Server verbunden ist, bestimmt Dreamweaver, wann die Menüobjekte aktiviert werden, und zwar anhand der vorliegenden Informationen über die Remote-Dateien.

bool SCS_canConnect()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Verbindung herstellen aktiviert werden soll.

ArgumenteKeine


bool SCS_canGet()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Abrufen aktiviert werden soll.



• Das Argument remotePathList ist eine Liste der Namen abzurufender Remote-Dateien bzw. der Pfade abzurufender Remote-Ordner.




bool SCS_canCheckout()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Auschecken aktiviert werden soll.








96

bool SCS_canPut()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Bereitstellen aktiviert werden soll.

Argumente void *connectionData, const char *localPathList[], const char *remotePathList[], const int numItems


• Das Argument localPathList ist eine Liste mit Namen der lokalen Dateien oder Pfaden zu lokalen Ordnern, die im Quellcode-Verwaltungssystem bereitgestellt werden sollen.

• Das Argument localPathList ist eine gespiegelte Liste mit den Namen der Remote-Dateien oder Pfadnamen der Remote-Ordner, die im Quellcode-Verwaltungssystem bereitgestellt werden sollen.



bool SCS_canCheckin()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Einchecken aktiviert werden soll.

Argumente void *connectionData, const char *localPathList[], const char *remotePathList[], const int numItems


• Das Argument localPathList ist eine Liste der Namen einzucheckender lokaler Dateien oder Ordnerpfade.




bool SCS_CanUndoCheckout()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Auschecken rückgängig aktiviert werden soll.




• Das Argument localPathList ist eine Liste mit Namen der lokalen Dateien oder Pfaden zu lokalen Ordnern, die im Quellcode-Verwaltungssystem bereitgestellt werden sollen.



97


bool SCS_canNewFolder()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Neuer Ordner aktiviert werden soll.



• Das Argument remotePath ist eine Liste mit Namen der Remote-Dateien oder Pfaden zu Remote-Ordnern, die der Benutzer ausgewählt hat, um anzugeben, wo der neue Ordner erstellt wird.


bool SCS_canDelete()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Löschen aktiviert werden soll.

Argumentevoid *connectionData, const char *remotePathList[], const int numItems


• Das Argument remotePathList ist eine Liste der Namen zu löschender Remote-Dateien bzw. der Pfade zu löschender Remote-Ordner.



bool SCS_canRename()

BeschreibungDiese Funktion gibt zurück, ob das Menüelement Umbenennen aktiviert werden soll.



• Das Argument remotePathList stellt die Dateinamen oder Ordnerpfade dar, die umbenannt werden können.



98

bool SCS_BeforeGet()

BeschreibungDreamweaver ruft diese Funktion auf, bevor eine oder mehrere Dateien abgerufen oder ausgecheckt werden. Mit dieser Funktion kann Ihre DLL einen Vorgang ausführen und beispielsweise einer Gruppe von Dateien einen Auscheck-Kommentar hinzufügen.

Argumente*connectionData

• Das Argument *connectionData ist ein Zeiger auf die Daten des Agenten, die während des Aufrufs von Connect() an Dreamweaver weitergegeben wurden.


BeispielUm eine Gruppe von Dateien abzurufen, führt Dreamweaver in der folgenden Reihenfolge Aufrufe an die DLL durch:

SCS_BeforeGet(connectionData);

SCS_Get(connectionData,remotePathList1,localPathList1,successList1);



SCS_AfterGet(connectionData);

bool SCS_BeforePut()

BeschreibungDreamweaver ruft diese Funktion auf, bevor eine oder mehrere Dateien bereitgestellt oder eingecheckt werden. Mit dieser Funktion kann Ihre DLL einen Vorgang ausführen und beispielsweise einer Gruppe von Dateien einen Eincheck-Kommentar hinzufügen.




BeispielUm eine Gruppe von Dateien abzurufen, führt Dreamweaver in der folgenden Reihenfolge Aufrufe an die DLL durch:

SCS_BeforePut(connectionData);

SCS_Put(connectionData,localPathList1,remotePathList1,successList1);



SCS_AfterPut(connectionData);


99

bool SCS_AfterGet()

BeschreibungDreamweaver ruft diese Funktion auf, nachdem eine oder mehrere Dateien abgerufen oder ausgecheckt wurden. Mit dieser Funktion kann Ihre DLL nach einem Abrufen oder Auschecken per Stapelverarbeitung einen beliebigen Vorgang ausführen und beispielsweise ein Dialogfeld mit einer Zusammenfassung erstellen.




BeispielWeitere Informationen finden Sie unter „bool SCS_BeforeGet()“ auf Seite 98.

bool SCS_AfterPut()

BeschreibungDreamweaver ruft diese Funktion auf, nachdem eine oder mehrere Dateien bereitgestellt oder eingecheckt wurden. Mit dieser Funktion kann Ihre DLL nach einem Bereitstellen oder Einchecken per Stapelverarbeitung einen beliebigen Vorgang ausführen und beispielsweise ein Dialogfeld mit einer Zusammenfassung erstellen.




BeispielWeitere Informationen finden Sie unter „bool SCS_BeforePut()“ auf Seite 98.


100

101

Kapitel 11: Anwendung

Die Anwendungsfunktionen führen Vorgänge aus, die die Interaktion zwischen Adobe® Dreamweaver® CS3 und anderen Anwendungen betreffen, sowie die von einzelnen Dokumenten unabhängigen Dreamweaver-Vorgänge, wie dem Festlegen von Voreinstellungen oder dem Beenden von Dreamweaver.


• „Funktionen für externe Anwendungen“ auf Seite 101

• „Globale Anwendungsfunktionen“ auf Seite 109

• „Bridge-Kommunikationsfunktionen“ auf Seite 113

Funktionen für externe AnwendungenFunktionen für externe Anwendungen führen Vorgänge aus, die sich auf Anwendungen, wie Adobe® Flash®, sowie auf Browser und externe Editoren beziehen, die in den Einstellungen Vorschau in Browser und Externe Editoren definiert werden. Mithilfe dieser Funktionen können Sie Informationen über diese externen Anwendungen abrufen und mit ihnen Dateien öffnen.

dreamweaver.browseDocument()

VerfügbarkeitDreamweaver 2, in 3 und 4 verbessert.

BeschreibungÖffnet die betreffende URL im angegebenen Browser.

ArgumentefileName, {browser}

• Das Argument fileName ist der Name der zu öffnenden Datei, ausgedrückt als absolute URL.

Hinweis: Einige Browser können die Datei nicht finden, wenn die URL einen Anker enthält, z. B. Configuration/Exten-sionHelp/browseHelp.htm#helpyou.

• In Dreamweaver 3 wurde das Browser-Argument eingeführt, das einen Browser angibt. Bei diesem Argument kann es sich um den Namen eines Browsers handeln, der in den Voreinstellungen für Vorschau in Browser definiert wurde, oder einfach um 'primary' oder 'secondary'. Wenn das Argument nicht angegeben wird, wird die URL im Primärbrowser des Benutzers geöffnet.

RückgabewerteKeine


102

BeispielDie folgende Funktion öffnet mithilfe der Funktion dreamweaver.browseDocument() die Homepage von Hotwired in einem Browser:

function goToHotwired(){

dreamweaver.browseDocument('http://www.hotwired.com/');

}

In Dreamweaver 4 kann dieser Vorgang wie folgt erweitert werden, um das Dokument in Microsoft Internet Explorer zu öffnen:

function goToHotwired(){

var prevBrowsers = dw.getBrowserList();

var theBrowser = "";

for (var i=1; i < prevBrowsers.length; i+2){

if (prevBrowsers[i].indexOf('Iexplore.exe') != -1){

theBrowser = prevBrowsers[i];

break;

}

}

dw.browseDocument('http://www.hotwired.com/',theBrowser);

}

Weitere Informationen zur Funktion dreamweaver.getBrowserList() finden Sie unter „dreamweaver.getBrowserList()“ auf Seite 102.

dreamweaver.getBrowserList()


BeschreibungRuft eine Liste aller im Untermenü Datei > Vorschau in Browser enthaltenen Browser ab.

ArgumenteKeine

RückgabewerteEin Array mit jeweils zwei Strings für die Browser in der Liste. Der jeweils erste String enthält den Namen des Browsers und der zweite String den Speicherort auf dem Computer des Benutzers, ausgedrückt im URL-Format „file://“. Wenn das Untermenü keine Browser enthält, wird kein Wert zurückgegeben.

dreamweaver.getExtensionEditorList()

VerfügbarkeitDreamweaver 3

BeschreibungRuft für die angegebene Datei eine Liste der Editoren aus den Voreinstellungen für Externe Editoren ab.

ArgumentefileURL

• Das Argument fileURL kann eine vollständige Angabe im URL-Format „file://“, ein Dateiname oder eine Dateierwei-terung (einschließlich Punkt) sein.


103

RückgabewerteEin Array mit jeweils zwei Strings für die einzelnen Editoren in der Liste. Der jeweils erste String enthält den Namen des Editors und der zweite String den Speicherort auf dem Computer des Benutzers, ausgedrückt im URL-Format „file://“. Wenn unter Voreinstellungen kein Editor definiert ist, wird ein Array mit einem leeren String zurückgegeben.

BeispielBeim Aufruf der Funktion dreamweaver.getExtensionEditorList(".gif") kann beispielsweise ein Array mit den folgenden Strings zurückgegeben werden:

• "Fireworks 3"

• "file://C|/Programme/Adobe/Fireworks 3/Fireworks 3.exe"

dreamweaver.getExternalTextEditor()


BeschreibungRuft den Namen des derzeit konfigurierten externen Texteditors ab.

ArgumenteKeine

RückgabewerteEin String mit dem Namen des Texteditors, der für die Anzeige in der Benutzeroberfläche geeignet ist, nicht der vollständige Pfad.

dreamweaver.getFlashPath()


BeschreibungRuft den vollständigen Pfad zur Anwendung Flash in Form einer Datei-URL ab.

ArgumenteKeine

RückgabewerteEin Array mit zwei Elementen. Element [0] ist ein String mit dem Namen des Flash-Editors. Element [1] ist ein String, der den Pfad zur Flash-Anwendung auf dem lokalen Computer enthält, der ausgedrückt wird im URL-Format „file://“. Wenn die Anwendung nicht installiert ist, wird kein Wert zurückgegeben.

BeispielDurch das folgende Beispiel wird die Funktion dw.getFlashPath() aufgefordert, den Pfad zur Flash-Anwendung aufzu-rufen und diesen Pfad dann im URL-Format „file://“ an die Funktion dw.openWithApp() zu übergeben, um das Dokument mit Flash zu öffnen:

var myDoc = dreamweaver.getDocumentDOM();

if (dreamweaver.validateFlash()) {

var flashArray = dreamweaver.getFlashPath();

dreamweaver.openWithApp(myDoc.myForm.swfFilePath, flashArray[1]);

}


104

dreamweaver.getPrimaryBrowser()


BeschreibungRuft den Pfad zum Primärbrowser ab.

ArgumenteKeine

RückgabewerteEin String mit dem Pfad des Primärbrowsers auf dem Computer des Benutzers, ausgedrückt im URL-Format „file://“. Wenn kein Primärbrowser definiert wurde, wird kein Wert zurückgegeben.

dreamweaver.getPrimaryExtensionEditor()


BeschreibungRuft den Primäreditor für die angegebene Datei ab.

ArgumentefileURL

• Das Argument fileURL ist der Pfad der zu öffnenden Datei, ausgedrückt im URL-Format „file://“.

RückgabewerteEin Array mit einem String-Paar. Der erste String enthält den Namen des Editors und der zweite den Speicherort auf dem Computer des Benutzers, ausgedrückt im URL-Format „file://“. Wenn kein Primäreditor definiert wurde, wird ein Array mit einem leeren String zurückgegeben.

dreamweaver.getSecondaryBrowser()


BeschreibungRuft den Pfad zum Sekundärbrowser ab.

ArgumenteKeine

RückgabewerteEin String mit dem Pfad des Sekundärbrowsers auf dem Computer des Benutzers, ausgedrückt im URL-Format „file://“. Wenn kein Primärbrowser definiert wurde, wird kein Wert zurückgegeben.


105

dreamweaver.openHelpURL()


BeschreibungÖffnet die festgelegte Hilfedatei in der Hilfeansicht des Betriebssystems.

Dreamweaver zeigt Hilfedaten in der Hilfeansicht des Betriebssystems, nicht in einem Browser an. Die Hilfe hat das Format HTML, ist aber für die Windows-HTML-Hilfe oder den Help Viewer für Mac OS 9 und OS X ausgelegt.

Die Hilfe setzt sich aus folgenden vier Komponenten zusammen: Weitere Informationen zu Hilfedateien finden Sie in der Dokumentation Ihres Betriebssystems.

• Das Hilfehandbuch

Ein Hilfehandbuch besteht aus HTML-Dateien, Grafiken und Indizes. Unter Windows wird die Hilfe als Datei mit der Dateinamenerweiterung „.chm“ bereitgestellt. Auf einem Macintosh-Computer ist das Hilfehandbuch ein Ordner.

Die Dateien sind im Dreamweaver-Ordner Help abgelegt.

• Die Datei help.xml

Die Datei help.xml ordnet den Abschnitten im Hilfehandbuch Buchkennungen zu. Im folgenden XML-Codebeispiel wird die Buchkennung für die Dreamweaver-Hilfe den Dateinamen zugeordnet, die Hilfehandbücher sowohl für Windows als auch für Macintosh enthalten:

<?xml version = "1.0" ?><help-books> <book-id id="DW_Using" win-mapping="UsingDreamweaver.chm" mac-mapping="Dreamweaver Help"/></help-books>

Jeder book-id-Eintrag hat folgende Attribute:

• Das id-Attribut ist die Buchkennung, die in den Dateien help.map und HelpDoc.js verwendet wird.

• Das Attribut win-mapping ist der Name des Windows-Handbuchs, in unserem Beispiel „UsingDreamweaver.chm“.

• Das Attribut mac-mapping ist der Name des Macintosh-Handbuchs, in unserem Beispiel „Dreamweaver Help“.

• Die Datei help.map

Die Datei help.map ordnet Inhaltskennungen dem jeweiligen Abschnitt in der Hilfe zu. Dreamweaver findet mithilfe der Datei help.map bestimmte Hilfeeinträge, wenn die Hilfe intern aufgerufen wird.

• Die Datei helpDoc.js

Mit der Datei helpDoc.js können Sie Variablennamen zuordnen, die Sie anstelle der Buchkennung und des Seitenstrings verwenden können. Die Datei helpDoc.js ordnet eine Hilfeinhaltkennung einer HTML-Seite in einem bestimmten Hilfe-abschnitt oder -buch zu. Dreamweaver ruft die Hilfe unter Verwendung der Datei helpDoc.js über JavaScript auf.

ArgumentebookID

• Das erforderliche bookID-Argument hat das Format: ID:page

Der Teil ID stellt die Buchkennung (bookID) des Eintrags in der Datei help.xml dar und gibt der Datei mit dem anzuzei-genden Hilfeinhalt ihren Namen. Durch page wird die anzuzeigende Seite angegeben. Die Seiten sind in der Datei help.map referenziert.

Rückgabewertetrue, wenn erfolgreich; false, wenn Dreamweaver die angegebene Datei in der Hilfeansicht nicht öffnen kann.

BeispielopenHelpURL("DW_Using:index.htm");


106

dreamweaver.openWithApp()


BeschreibungÖffnet die betreffende Datei in der angegebenen Anwendung.

ArgumentefileURL, appURL


• Das Argument appURL ist der Pfad der Anwendung, in der die Datei geöffnet werden soll, ausgedrückt im URL-Format „file://“.

RückgabewerteKeine

dreamweaver.openWithBrowseDialog()


BeschreibungÖffnet das Dialogfeld Externen Editor auswählen. In diesem Dialogfeld kann der Benutzer die Anwendung auswählen, mit der die angegebene Datei geöffnet werden soll.

ArgumentefileURL


RückgabewerteKeine

dreamweaver.openWithExternalTextEditor()


BeschreibungÖffnet das aktuelle Dokument in dem externen Texteditor, der im Dialogfeld Voreinstellungen unter Externe Editoren definiert wurde.

ArgumenteKeine

RückgabewerteKeine


107

dreamweaver.openWithImageEditor()


BeschreibungÖffnet die betreffende Datei im angegebenen Bildeditor.

Hinweis: Falls Fireworks als Bildeditor festgelegt ist, wird eine spezielle Funktion zur Integration von Adobe Fireworks gestartet, die dem aktiven Dokument Informationen zurückgibt. Um Fehlermeldungen zu vermeiden, wenn kein Dokument aktiv ist, rufen Sie diese Funktion nicht vom Bedienfeld Site aus auf.

ArgumentefileURL, appURL


• Das Argument appURL ist der Pfad der Anwendung, in der die Datei geöffnet werden soll, ausgedrückt im URL-Format „file://“.

RückgabewerteKeine

dreamweaver.validateFlash()


BeschreibungErmittelt, ob Flash MX (oder eine spätere Version) auf dem lokalen Computer installiert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Flash MX (oder eine spätere Version) auf dem lokalen Computer installiert ist, andern-falls false.

dom.insertFiles()

VerfügbarkeitDreamweaver CS3.

BeschreibungFügt eine oder mehrere Dateien an der aktuellen Einfügemarke oder anstelle der aktuellen Markierung in das aktuelle Dokument ein und fordert den Benutzer ggf. zur Eingabe von Parametern auf.

Argumente:strFiles

strFiles ist ein String, der die Pfade und Namen der einzufügenden Dateien angibt. An diese Funktion können mehrere Dateinamen übergeben werden.

RückgabewerteKeine


108

dreamweaver.activateApp()


BeschreibungStellt die angegebene Anwendung in den Vordergrund, wodurch sie zur aktiven Anwendung wird.

Argumente:applicationID

applicationID ist ein String, der die zu aktivierende Anwendung angibt, zum Beispiel dreamweaver.

RückgabewerteKeine

dreamweaver.printDocument()


BeschreibungFührt die Entsprechung des Dreamweaver-Befehls Datei > Code drucken für die angeforderte Datei aus.

Argumente:fileName

fileName ist ein String, der den Namen der zu druckenden Datei als URL angibt.

RückgabewerteKeine

dreamweaver.revealDocument()


BeschreibungSetzt den Betriebssystemfokus auf Dreamweaver, und bringt die angegebene Datei, falls diese in Dreamweaver geöffnet ist, in den Vordergrund.

Argumente:fileName

fileName ist ein String, der den Namen der anzuzeigenden Datei als URL angibt.

RückgabewerteKeine


109

Globale AnwendungsfunktionenGlobale Anwendungsfunktionen wirken sich auf die Anwendung insgesamt aus. Mit ihnen kann unter anderem das Dialogfeld Voreinstellungen aufgerufen und beendet werden.

dreamweaver.beep()


BeschreibungLässt einen Systemwarnton erklingen.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird die Aufmerksamkeit des Benutzers mithilfe von dw.beep() auf eine von der Funktion alert() angezeigte Meldung gelenkt:

beep(){

if(confirm(“Is your order complete?”)

{

dreamweaver.beep();

alert(“Click OK to submit your order”);

}

}

dreamweaver.getShowDialogsOnInsert()


BeschreibungÜberprüft, ob im Dialogfeld Voreinstellungen in der Kategorie Allgemein die Option Beim Einfügen von Objekten Dialog anzeigen aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob die Option aktiviert ist.

dreamweaver.quitApplication()


BeschreibungMit dieser Funktion wird Dreamweaver beendet, sobald das aufrufende Skript abgeschlossen ist.


110

ArgumenteKeine

RückgabewerteKeine

dreamweaver.showAboutBox()


BeschreibungÖffnet das Dialogfeld Über.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.showDynamicDataDialog()


BeschreibungZeigt das Dialogfeld Dynamische Daten oder Dynamischer Text an und wartet darauf, dass der Benutzer das Dialogfeld schließt. Wenn der Benutzer auf OK klickt, gibt die Funktion showDynamicDataDialog() einen String zurück, der in das Dokument des Benutzers eingefügt wird. (Dieser String wurde von der API-Datenquellenfunktion generateDynamicDa-taRef() zurückgegeben und an die API-Datenformatfunktion formatDynamicDataRef() übergeben. Der Rückgabewert von formatDynamicDataRef() entspricht dem von der Funktion showDynamicDataDialog() zurückgegebenen Wert.)

Argumentesource, {title}

• Das Argument source ist ein String mit Quellcode, der das dynamische Datenobjekt darstellt. Es ist der gleiche String, der bei einem früheren Aufruf dieser Funktion zurückgegeben wurde. Die Funktion verwendet den Inhalt des source-Arguments, um alle Steuerelemente in Dialogfeldern zu initialisieren, damit sie genauso angezeigt werden wie zu dem Zeitpunkt, als der Benutzer zum Erstellen dieses Strings auf OK geklickt hat.

Dreamweaver übergibt diesen String an die Funktion inspectDynamicDataRef(), um zu ermitteln, ob der String einem der Knoten in der Struktur entspricht. Falls der String einem Knoten entspricht, wird dieser ausgewählt, wenn das Dialogfeld angezeigt wird. Sie können auch einen leeren String übergeben. Dadurch wird das Dialogfeld nicht initialisiert. So wird ein Dialogfeld bei der Erstellung eines neuen Elements beispielsweise nicht initialisiert.

• Das optionale Argument title ist ein String mit dem Text, der in der Titelleiste des Dialogfelds angezeigt werden soll. Wird dieses Argument nicht angegeben, zeigt Dreamweaver „Dynamische Daten“ in der Titelleiste an.

RückgabewerteEin String, der das dynamische Datenobjekt definiert, wenn der Benutzer auf OK klickt.


111

dreamweaver.showPasteSpecialDialog()


BeschreibungDiese Funktion zeigt das Dialogfeld Inhalte einfügen an. Klickt der Benutzer auf OK, führt die Funktion showPasteSpecialDialog() den Einfügevorgang aus.

ArgumenteKeine

RückgabewerteKeine

Beispieldw.showPasteSpecialDialog();

dreamweaver.showPreferencesDialog()

VerfügbarkeitDreamweaver 3. In Dreamweaver 8 wurde das Argument strCategory hinzugefügt.

BeschreibungDiese Funktion öffnet das Dialogfeld Voreinstellungen.

Argumente{strCategory}

• Damit die entsprechende Kategorie im Dialogfeld Voreinstellungen geöffnet wird, muss das optionale strCategory-Argument einen der folgenden Strings darstellen: "general", "accessibility", "html colors" (für die Kategorie Farbe für Code), "html format" (für die Kategorie Codeformat), "code hints", "html rewriting" (für die Kategorie Codeumschreibung), "copyPaste", "css styles", "file compare", "external editors" (für die Kategorie Datei-typen/Editoren), "fonts", "highlighting", "invisible elements", "layers", "layout mode", "new document", "floaters" (für die Kategorie Bedienfelder), "browsers" (für die Kategorie Vorschau in Browser), "site ftp" (für die Kategorie Site), "status bar" und "validator". Falls das Argument nicht als gültiger Name erkannt oder ausge-lassen wird, wird das Dialogfeld mit dem Bereich geöffnet, der zuletzt aktiv war.

RückgabewerteKeine

BeispielDas folgende Beispiel öffnet das Dialogfeld Voreinstellungen und wählt die Kategorie Farbe für Code aus:

dw.showPreferencesDialog(“html colors”);


112

dreamweaver.showTagChooser()


BeschreibungSchaltet die Sichtbarkeit des Dialogfelds Tag-Auswahl um, mit dem Benutzer in der Codeansicht Tags einfügen können. Die Funktion zeigt das Dialogfeld Tag-Auswahl im Vordergrund vor allen anderen Dreamweaver-Fenstern an. Ist das Dialogfeld nicht sichtbar, wird es von der Funktion geöffnet, in den Vordergrund gebracht und aktiviert. Ist die Tag-Auswahl sichtbar, blendet die Funktion das Dialogfeld aus.

ArgumenteKeine

RückgabewerteKeine

dw.registerIdleHandler()


BeschreibungDiese Funktion registriert eine JavaScript-Funktion, die im Leerlauf (wenn keine Verarbeitung erfolgt) regelmäßig aufge-rufen werden soll.

Argumenteid, idleFunction, interval

• id - ein eindeutiger String, um die Leerlauf-Aufgabe, die registriert werden soll, zu identifizieren. Damit die Eindeu-tigkeit gewährleistet ist, stellen Sie der ID eine eindeutige Kennung voran. So könnten Sie zum Beispiel alle 5 Sekunden ein akustisches Signal („Beep“) erzeugen; diese Aufgabe sollten Sie jedoch nicht "beep" nennen, da möglicherweise jemand anders eine Aufgabe mit demselben Namen erstellt hat. Ein besserer Name wäre zum Beispiel "acme_beep_task", womit sowohl Kontextinformation geboten als auch Eindeutigkeit gewährleistet wird.

• idleFunction - die JavaScript-Funktion, die während der Leerlaufzeiten aufgerufen werden soll.

• interval - die Anzahl Sekunden zwischen den Aufrufen von idleFunction, sofern die Leerlaufsituation gegeben ist.

RückgabewerteEin Boolescher Wert, der angibt, ob die Leerlauf-Aufgabe erfolgreich registriert wurde.

BeispielIm folgenden Beispiel generiert das System alle 5 Sekunden ein akustisches Signal:

dw.registerIdleHandler("acme_beep_task", function() { dw.beep();}, 5);


113

dw.revokeIdleHandler()


Beschreibung Diese Funktion entfernt eine Leerlauf-Aufgabe, die zuvor durch die Funktion registerIdleHandler() ausgelöst wurde. Auf diese Weise sollen zuvor registrierte Leerlauf-Aufgaben entfernt werden. Wenn eine Leerlauf-Aufgabe aktiv bleiben soll, bis die Anwendung beendet wird, muss diese Funktion nicht aufgerufen werden. In diesem Fall wird die Leerlauf-Aufgabe vor dem Beenden der Anwendung automatisch entfernt.

Argumenteid

• id - ein eindeutiger String, um die registrierte Leerlauf-Aufgabe, die entfernt werden soll, zu identifizieren. Dies ist dieselbe ID, die anfänglich zur Registrierung der Aufgabe verwendet wurde.

RückgabewerteEin Boolescher Wert, der angibt, ob die Leerlauf-Aufgabe erfolgreich entfernt wurde.

BeispielIm folgenden Beispiel wird die Leerlauf-Aufgabe "dw_beep_task" aus der Warteschlange der Leerlauf-Aufgaben entfernt:

dw.revokeIdleHandler("acme_beep_task");

Bridge-KommunikationsfunktionenDie Bridge-Kommunikationsfunktionen ermöglichen den Datenaustausch zwischen Dreamweaver und Bridge-Anwendung. Eine Funktion dieser Kommunikation besteht darin, dem Benutzer zu ermöglichen, von Dreamweaver aus zu Dateien in Bridge zu navigieren.

BridgeTalk.bringToFront()


BeschreibungMacht die angegebene Anwendung zum Prozess im Vordergrund, indem die Funktion BridgeTalk::bringToFront() aufgerufen wird.

ArgumenteapplicationID

applicationID ist ein String, zum Beispiel bridge oder dreamweaver, der die zu aktivierende Anwendung angibt.

RückgabewerteKeine


114

BeispielIn diesem Beispiel implementiert Dreamweaver die Funktion browseInBridge(). Zunächst erstellen Sie eine BridgeTalk-Instanz, danach werden die beiden wichtigsten Eigenschaften festgelegt: target und body. <target> ist die Zielanwendung. In diesem Fall ist dies die Bridge-Anwendung. Der Bezeichner ist bridge. <body> ist die zu sendende Nachricht. Norma-lerweise ist <body> ein Skript, dass von der Zielanwendung interpretiert werden kann und nach dem Empfang ausgeführt wird. Die Funktion send() wird aufgerufen, um die Nachricht <body> an das Ziel <target> zu senden.

if (!JSBridge.isRunning('bridge'))

{

var bt = new BridgeTalk;

var scriptSavePath = browsePath.replace(/['"\\]/g, "\\$&");

var script = "app.document.thumbnail = new Thumbnail(decodeURI('" + scriptSavePath + "'));";

// Skript an Bridge senden und 10 Sekunden Zeit für den Start lassen, bevor ein Fehler gemeldet wird.

bt.target = "bridge";

bt.body = script;

result = bt.send(10);

}

if (result)

BridgeTalk.bringToFront('bridge');

Bridgetalk.send()


BeschreibungErmöglicht den Datenaustausch mit Adobe Bridge.

Argumente:timeout

Dieses optionale Attribut legt das Zeitüberschreitungsintervall in Sekunden fest.

RückgabewerteEin Boolescher Wert, der angibt, ob die Kommunikation mit der Bridge-Anwendung erfolgreich war (True) oder nicht (False).

Beispielresult = bridgeTalk.send(10);

BridgeTalk.suppressStartupScreen()


BeschreibungSucht die Startoptionen für -nostartupscreen, um festzustellen, ob die modalen Fenster nach dem Start unterdrückt werden sollen.

RückgabewerteEin Boolescher Wert, der angibt, ob Startbildschirme unterdrückt werden.


115

dw.browseInBridge()


BeschreibungErmöglicht das Suchen von Dateien in Bridge von Dreamweaver aus. Mit der Funktion dw.browseInBridge() wird die Bridge-Anwendung gestartet. Wenn Bridge bereits ausgeführt wird, wechselt dw.browseInBridge zur Bridge-Anwendung.

Argumente:Kein

RückgabewerteEin Boolescher Wert, der angibt, ob das Browsing-Skript erfolgreich an die Bridge-Anwendung gesendet wurde (true) oder nicht (false).


116

117

Kapitel 12: Arbeitsbereich

API-Arbeitsbereichsfunktionen erstellen und verwenden Elemente für den Arbeitsbereich von Adobe® Dreamweaver® CS3. Sie führen unter anderem folgende Aktionen aus: Schritte wiederherstellen, die im Bedienfeld Verlauf angezeigt werden, Objekte in der Einfügeleiste platzieren, mithilfe von Tastaturfunktionen navigieren, Menüs neu laden, separate oder integrierte Ergebnisfenster bearbeiten, Optionen festlegen, Symbolleisten positionieren, Fokus abrufen und einstellen.


• „Verlaufsfunktionen“ auf Seite 117

• „Funktionen zum Einfügen von Objekten“ auf Seite 124

• „Tastaturfunktionen“ auf Seite 126

• „Menüfunktionen“ auf Seite 133

• „Ergebnisfenster-Funktionen“ auf Seite 134

• „Umschaltfunktionen“ auf Seite 146

• „Symbolleistenfunktionen“ auf Seite 166

• „Fensterfunktionen“ auf Seite 171

• „Funktionen für das Ausblenden von Code“ auf Seite 180

• „Symbolleistenfunktionen der Codeansicht“ auf Seite 186

VerlaufsfunktionenVerlaufsfunktionen bewirken das Rückgängigmachen, Wiederholen, Aufzeichnen und Wiedergeben von Schritten, die im Bedienfeld Verlauf angezeigt werden. Als Schritt wird jede wiederholbare Veränderung am Dokument oder an einer Auswahl im Dokument bezeichnet. Die Methoden des Objekts dreamweaver.historyPalette gelten für die Auswahl im Bedienfeld Verlauf, nicht die im aktuellen Dokument.

dom.redo()


BeschreibungStellt den zuletzt im Dokument rückgängig gemachten Schritt wieder her.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canRedo()“ auf Seite 421.

dom.undo()



118

BeschreibungMacht den zuvor ausgeführten Schritt rückgängig.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canUndo()“ auf Seite 423.

dreamweaver.getRedoText()


BeschreibungRuft den Text ab, der mit der Bearbeitungsaktion verknüpft ist, die wiederhergestellt wird, wenn der Benutzer den Befehl Bearbeiten > Wiederherstellen auswählt oder <Strg>+<Y> (Windows) bzw. <Befehl>+<Y> (Macintosh) drückt.

ArgumenteKeine

RückgabewerteEin String mit dem Text für den wiederherzustellenden Bearbeitungsvorgang.

BeispielWenn durch die letzte Aktion des Benutzers der ausgewählte Text fett formatiert wurde, wird beim Aufrufen der Funktion dreamweaver.getRedoText() der Wert "Repeat Apply Bold" zurückgegeben.

dreamweaver.getUndoText()


BeschreibungRuft den Text ab, der mit der Bearbeitungsaktion verknüpft ist, die rückgängig gemacht wird, wenn der Benutzer den Befehl Bearbeiten > Rückgängig auswählt oder <Strg>+<Z> (Windows) bzw. <Befehl>+<Z> (Macintosh) drückt.

ArgumenteKeine

RückgabewerteEin String mit dem Text des rückgängig zu machenden Bearbeitungsvorgangs.

BeispielWenn durch die letzte Aktion des Benutzers ein CSS-Stil (Cascading Stylesheet) auf ausgewählten Text angewendet wurde, wird beim Aufrufen der Funktion dreamweaver.getUndoText() der Wert "Undo Apply <span>" zurückgegeben.

dreamweaver.playRecordedCommand()



119

BeschreibungGibt den aufgezeichneten Befehl im aktiven Dokument wieder.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canPlayRecordedCommand()“ auf Seite 428.

dreamweaver.redo()


BeschreibungStellt den zuletzt im aktiven Dokumentfenster, Dialogfeld, schwebenden Bedienfeld oder Bedienfeld Site rückgängig gemachten Schritt wieder her.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canRedo()“ auf Seite 428.

dreamweaver.startRecording()


BeschreibungBeginnt die Aufzeichnung von Schritten im aktiven Dokument; der zuvor aufgezeichnete Befehl wird sofort verworfen.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.isRecording()“ auf Seite 434. (Es muss der Wert false zurückge-geben werden.)

dreamweaver.stopRecording()



120

BeschreibungStoppt die Aufzeichnung, ohne den Benutzer dazu aufzufordern.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.isRecording()“ auf Seite 434. (Es muss der Wert true zurückgegeben werden.)

dreamweaver.undo()


BeschreibungMacht den zuvor im aktiven Dokumentfenster, Dialogfeld, schwebenden Bedienfeld oder Bedienfeld Site durchgeführten Schritt rückgängig.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canUndo()“ auf Seite 423.

dreamweaver.historyPalette.clearSteps()


BeschreibungEntfernt alle Schritte aus dem Bedienfeld Verlauf und deaktiviert die Menüeinträge Rückgängig und Wiederherstellen.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.historyPalette.copySteps()


BeschreibungKopiert die angegebenen Verlaufsschritte in die Zwischenablage. Der Benutzer wird vor eventuell unbeabsichtigten Folgen gewarnt, wenn die betreffenden Schritte eine nicht wiederholbare Aktion beinhalten.


121

ArgumentearrayOfIndices

• Das Argument arrayOfIndices ist ein Array von Positionsindizes im Bedienfeld Verlauf.

RückgabewerteEin String mit JavaScript-Code, der den angegebenen Verlaufsschritten entspricht.

BeispielIm folgenden Beispiel werden die ersten vier Schritte im Bedienfeld Verlauf kopiert:

dreamweaver.historyPalette.copySteps([0,1,2,3]);

dreamweaver.historyPalette.getSelectedSteps()


BeschreibungBestimmt, welcher Teil des Bedienfelds Verlauf ausgewählt ist.

ArgumenteKeine

RückgabewerteEin Array mit den Positionsindizes aller ausgewählten Schritte. Die erste Position ist Position 0 (Null).

BeispielWenn im Bedienfeld Verlauf der zweite, der dritte und der vierte Schritt ausgewählt sind, wie in der folgenden Abbildung gezeigt, wird beim Aufrufen der Funktion dreamweaver.historyPalette.getSelectedSteps() der Wert [1,2,3] zurück-gegeben.

dreamweaver.historyPalette.getStepCount()


BeschreibungRuft die Anzahl der Schritte im Bedienfeld Verlauf ab.

ArgumenteKeine

RückgabewerteEine Ganzzahl, die die Anzahl der Schritte angibt, die sich derzeit im Bedienfeld Verlauf befinden.


122

dreamweaver.historyPalette.getStepsAsJavaScript()


BeschreibungRuft den JavaScript-Code ab, der den ausgewählten Verlaufsschritten entspricht.




BeispielWenn im Bedienfeld Verlauf die im folgenden Beispiel angezeigten drei Schritte ausgewählt sind, wird beim Aufrufen der Funktion dreamweaver.historyPalette.getStepsAsJavaScript(dw.historyPalette.getSelectedSteps()) folgender Code zurückgegeben: "dw.getDocumentDOM().insertText('Hey diddle diddle, a cat and a fiddle, the cow jumped over the moon.');\ndw.getDocumentDOM().newBlock();\n dw.getDocumentDOM().insertHTML('<img

src=\"../wdw99/50browsers/images/sun.gif\">', true);\n":

dreamweaver.historyPalette.getUndoState()


BeschreibungRuft den aktuellen Rückgängig-Status ab.

ArgumenteKeine

RückgabewerteDie Position der Rückgängig-Markierung im Bedienfeld Verlauf.

dreamweaver.historyPalette.replaySteps()


BeschreibungGibt die angegebenen Verlaufsschritte im aktiven Dokument wieder. Der Benutzer wird vor eventuell unbeabsichtigten Folgen gewarnt, wenn die betreffenden Schritte eine nicht wiederholbare Aktion beinhalten.


123




BeispielBeim Aufruf der Funktion dreamweaver.historyPalette.replaySteps([0,2,3]) werden der erste, der dritte und der vierte Schritt im Bedienfeld Verlauf wiedergegeben.

dreamweaver.historyPalette.saveAsCommand()


BeschreibungÖffnet das Dialogfeld Als Befehl speichern, in dem der Benutzer die angegebenen Schritte als Befehl speichern kann. Der Benutzer wird vor eventuell unbeabsichtigten Folgen gewarnt, wenn die betreffenden Schritte eine nicht wiederholbare Aktion beinhalten.




BeispielIm folgenden Beispiel werden der vierte, der sechste und der achte Schritt im Bedienfeld Verlauf als Befehl gespeichert:

dreamweaver.historyPalette.saveAsCommand([3,5,7]);

dreamweaver.historyPalette.setSelectedSteps()


BeschreibungWählt die angegebenen Schritte im Bedienfeld Verlauf aus.


• Die Funktion arrayOfIndices ist ein Array von Positionsindizes im Bedienfeld Verlauf. Wenn kein Argument angegeben wird, werden alle Schritte deaktiviert.

RückgabewerteKeine

BeispielIm folgenden Beispiel werden der erste, der zweite und der dritte Schritt im Bedienfeld Verlauf ausgewählt:

dreamweaver.historyPalette.setSelectedSteps([0,1,2]);


124

dreamweaver.historyPalette.setUndoState()


BeschreibungDurchläuft die korrekte Anzahl von Rückgängig- bzw. Wiederherstellen-Schritten, um den angegebenen Rückgängig-Status zu erreichen.

ArgumenteundoState

• Das Argument undoState ist das von der Funktion dreamweaver.historyPalette.getUndoState() zurückgegebene Objekt.

RückgabewerteKeine

Funktionen zum Einfügen von ObjektenFunktionen zum Einfügen von Objekten beziehen sich auf Vorgänge für die Objekte auf der Einfügeleiste bzw. im Menü Einfügen.

dom.insertFlashElement()

VerfügbarkeitDreamweaver MX 2004

BeschreibungFügt ein angegebenes Flash-Element (SWC-Datei) in das aktuelle Dokument ein. Diese Funktion setzt voraus, dass das Flash-Element zur Einfügeleiste hinzugefügt wurde und dass sich die Komponentendatei im Ordner Configuration\Objects\FlashElements bzw. in einem entsprechenden Unterordner befindet.

ArgumenteswcFilename

• Der String swcFilename besteht aus dem Pfad und dem Namen der gewünschten Flash- Komponente und bezieht sich auf den Ordner Configuration\Objects\FlashElements.

RückgabewerteKeine

BeispielMit dem folgenden Beispiel wird die Flash-Komponente für die Navigationsleiste in das aktuelle Dokument eingefügt. Diese Komponente befindet sich im Ordner Components\Objects\FlashElements\Navigation.

dom.insertFlashElement("\Navigation\navBar.swc");

dreamweaver.objectPalette.getMenuDefault()


BeschreibungRuft den ID-String des Standardelements für das zugehörige Menü ab.


125

ArgumentemenuId

• Das Argument menuId ist der String, durch den das Menü in der Datei insertbar.xml definiert wird.

RückgabewerteEin String, durch den die ID des Standardelements definiert wird.

Beispiel Im folgenden Beispiel wird das aktuelle Standardobjekt für das Menü Medien der Variablen defID zugewiesen:

var defId = dw.objectPalette.getMenuDefault("DW_Media");

dreamweaver.objectPalette.setMenuDefault()


BeschreibungLegt das Standardobjekt für ein Popupmenü fest. Das Symbol für das Standardobjekt bezieht sich auf das angegebene Popupmenü in der Einfügeleiste. Der Benutzer kann auf das Standardobjekt klicken, um dieses Objekt einzufügen, oder auf den Pfeil neben dem Standardobjekt, um das Popupmenü zu öffnen und die anderen Objekte in diesem Menü anzuzeigen. Dreamweaver legt die neue Standardeinstellung für das Menü fest, die verwendet wird, wenn der Benutzer das nächste Mal Dreamweaver öffnet oder den Befehl Erweiterungen neu laden verwendet.

ArgumentemenuId, defaultId

• Das Argument menuId ist der String, durch den das Menü in der Datei insertbar.xml definiert wird.

• Das Argument defaultId ist der String, durch den das neue Standardobjekt im Feld insertbar.xml definiert wird.

RückgabewerteEin Boolescher Wert: true, wenn die neue Standardeinstellung erfolgreich festgelegt wurde, andernfalls false.

BeispielIm folgenden Beispiel wird das Flash-Objekt als Standardobjekt für das Menü Medien festgelegt:

dw.objectPalette.setMenuDefault("DW_Media", "DW_Flash");

dreamweaver.reloadObjects()


BeschreibungLädt alle Objekte in der Einfügeleiste neu. Diese Funktion entspricht dem Vorgang, im Menü Kategorien der Einfügeleiste mit der linken Maustaste zu klicken, währenddessen die Taste <Strg> gedrückt zu halten und die Menüoption Erweite-rungen neu laden auszuwählen.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Objekte erfolgreich geladen wurden, andernfalls false.


126

dom.convertActiveContent()


BeschreibungKonvertiert den gesamten aktiven Inhalt im angegebenen Dokument.

ArgumenteforceUpdate

• forceUpdate ist ein Boolescher Wert, der angibt, ob die Voreinstellungen des Benutzers übergangen werden sollen (true) oder nicht. Dieses Argument ist optional.

RückgabewerteDer Boolesche Wert true, wenn der gesamte aktive Inhalt erfolgreich konvertiert wurde. Gibt false zurück, wenn ein Teil des aktiven Inhalts, der konvertiert werden sollte, nicht konvertiert wurde (zum Beispiel Objekt-Tags in einem gesperrten Bereich einer Vorlageninstanz).

Beispielif( !dom.convertActiveContent(true) ) {

alert(dw.loadString("ActiveContent/notAllConverted"));

}

dom.convertNextActiveContent()


BeschreibungGibt an, dass für das nächste Objekt-Tag, das eingefügt wird (für den Rest der aktuellen Bearbeitungsaktion, die rückgängig gemacht werden kann), ein Skript erstellt wird. Diese Funktion ermöglicht, dass Sie das entsprechende Skript für den bestimmten aktiven Inhalt mit einer Erweiterung von Drittanbietern generieren können.

ArgumenteKeine

RückgabewerteKeine

Beispieldom.convertNextActiveContent();

dom.insertHTML("<object classid=\"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000\" codebase=\

"http://download.Macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,19,0\"

width=\"100\" height=\"22\"><param name=\"movie\" value=\"button1.swf\" /><param name=\

"quality\" value=\"high\" /><embed src=\"button1.swf\" quality=\"high\" pluginspage=\

"http://www.Macromedia.com/go/getflashplayer\" type=\"application/

x-shockwave-flash\"width=\"100\" height=\"22\"></embed></object>\");

TastaturfunktionenMit Tastaturfunktionen werden die Pfeiltasten, die Rücktaste sowie die Tasten <Entf>, <Bild-auf> und <Bild-ab> simuliert. Abgesehen von allgemeinen Pfeil- und Steuertastenfunktionen, wie arrowLeft() und backspaceKey(), stehen in Dream-weaver auch Funktionen zur Verfügung, mit denen zum nächsten oder zum vorherigen Wort bzw. Absatz gesprungen werden kann. Außerdem kann zum Anfang oder zum Ende der Zeile bzw. des Dokuments gesprungen werden.


127

dom.arrowDown()


BeschreibungBewegt die Einfügemarke um die angegebene Anzahl von Schritten nach unten.

Argumente{nTimes}, {bShiftIsDown}

• Das Argument nTimes gibt die Anzahl der Schritte an, um die die Einfügemarke nach unten bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.

• Das Argument bShiftIsDown ist ein Boolescher Wert, der angibt, ob die Auswahl erweitert werden soll. Bei fehlendem Argument gilt der Standardwert false.

RückgabewerteKeine

dom.arrowLeft()


BeschreibungBewegt die Einfügemarke um die angegebene Anzahl von Schritten nach links.


• Das optionale Argument nTimes gibt die Anzahl der Schritte an, um die die Einfügemarke nach links bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.

• Das optionale Argument bShiftIsDown ist ein Boolescher Wert, der angibt, ob die Auswahl erweitert werden soll. Bei fehlendem Argument gilt der Standardwert false.

RückgabewerteKeine

dom.arrowRight()


BeschreibungBewegt die Einfügemarke um die angegebene Anzahl von Schritten nach rechts.


• Das optionale Argument nTimes gibt die Anzahl der Schritte an, um die die Einfügemarke nach rechts bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.


RückgabewerteKeine


128

dom.arrowUp()


BeschreibungDiese Funktion bewegt die Einfügemarke um die angegebene Anzahl von Schritten nach oben.


• Das optionale Argument nTimes gibt die Anzahl der Schritte an, um die die Einfügemarke nach oben bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.


RückgabewerteKeine

dom.backspaceKey()


BeschreibungDiese Funktion entspricht dem Drücken der Rücktaste (so oft wie angegeben). Das Ergebnis hängt davon ab, ob eine Auswahl oder nur eine Einfügemarke vorhanden ist.

Argumente{nTimes}

• Das optionale Argument nTimes gibt an, wie oft die Rücktaste gedrückt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.

RückgabewerteKeine

dom.deleteKey()


BeschreibungDiese Funktion entspricht dem Drücken der Taste <Entf> (so oft wie angegeben). Das Ergebnis hängt davon ab, ob eine Auswahl oder nur eine Einfügemarke vorhanden ist.

Argumente{nTimes}

• Das optionale Argument nTimes gibt an, wie oft die Taste <Entf> gedrückt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.

RückgabewerteKeine


129

dom.endOfDocument()


BeschreibungBewegt die Einfügemarke zum Ende des Dokuments (d. h. hinter den letzten sichtbaren Inhalt im Dokumentfenster bzw. hinter das abschließende HTML-Tag im Codeinspektor, je nachdem, welches Fenster sich im Fokus befindet).

Argumente{bShiftIsDown}


RückgabewerteKeine

dom.endOfLine()


BeschreibungBewegt die Einfügemarke an das Ende der Zeile.



RückgabewerteKeine

dom.nextParagraph()


BeschreibungBewegt die Einfügemarke an den Anfang des nächsten Absatzes oder überspringt mehrere Absätze, falls nTimes größer als 1 ist.


• Das optionale Argument nTimes gibt die Anzahl der Absätze an, um die die Einfügemarke weiter bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.

• Das Argument bShiftIsDown ist ein Boolescher Wert, der angibt, ob die Auswahl erweitert werden soll. Bei fehlendem Argument gilt der Standardwert false.

RückgabewerteKeine


130

dom.nextWord()


BeschreibungBewegt die Einfügemarke an den Anfang des nächsten Wortes oder überspringt mehrere Wörter, falls nTimes größer als 1 ist.


• Das optionale Argument nTimes gibt die Anzahl der Wörter an, um die die Einfügemarke weiter bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.


RückgabewerteKeine

dom.pageDown()


BeschreibungBewegt die Einfügemarke um eine Seite nach unten (entspricht der Taste <Bild-ab>).


• Das optionale Argument nTimes gibt die Anzahl der Seiten an, um die die Einfügemarke nach unten bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.


RückgabewerteKeine

dom.pageUp()


BeschreibungBewegt die Einfügemarke um eine Seite nach oben (entspricht der Taste <Bild-auf>).


• Das optionale Argument nTimes gibt die Anzahl der Seiten an, um die die Einfügemarke nach oben bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.



131

RückgabewerteKeine

dom.previousParagraph()


BeschreibungBewegt die Einfügemarke an den Anfang des vorherigen Absatzes oder überspringt mehrere Absätze, falls nTimes größer als 1 ist.


• Das optionale Argument nTimes gibt die Anzahl der Absätze an, um die die Einfügemarke zurück bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.


RückgabewerteKeine

dom.previousWord()


BeschreibungBewegt die Einfügemarke an den Anfang des vorherigen Wortes oder überspringt mehrere Wörter, falls nTimes größer als 1 ist.


• Das optionale Argument nTimes gibt die Anzahl der Wörter an, um die die Einfügemarke zurück bewegt werden soll. Bei fehlendem Argument wird der Wert 1 als Standard verwendet.


RückgabewerteKeine

dom.startOfDocument()


BeschreibungBewegt die Einfügemarke an den Anfang des Dokuments (d. h. vor den ersten sichtbaren Inhalt im Dokumentfenster bzw. vor das öffnende HTML-Tag im Codeinspektor, je nachdem, welches Fenster sich im Fokus befindet).



132


RückgabewerteKeine

dom.startOfLine()


BeschreibungBewegt die Einfügemarke an den Anfang der Zeile.



RückgabewerteKeine

dreamweaver.mapKeyCodeToChar()


BeschreibungKonvertiert einen Tastencode, der aus dem Feld keyCode des Ereignisobjekts abgerufen wurde, in ein Zeichen. Überprüfen Sie, ob es sich bei dem Tastencode um eine Sondertaste handelt, wie z. B. um POS 1, BILD-AUF usw. Bezieht sich der Tastencode nicht auf eine Sondertaste, kann diese Methode verwendet werden, um den Code in einen für die Anzeige geeigneten Zeichencode umzusetzen.

ArgumentekeyCode

• Das Argument keyCode ist der Tastencode, der in ein Zeichen umgesetzt werden soll.

RückgabewerteGibt den Zeichencode zurück, falls die Zuordnung erfolgreich war. Andernfalls wird 0 zurückgegeben.


133

MenüfunktionenMithilfe von Menüfunktionen lassen sich die Menüs von Dreamweaver optimieren und neu laden. Die Funktionen dream-weaver.getMenuNeedsUpdating() und dreamweaver.notifyMenuUpdated() sind speziell dafür konzipiert, unnötige Aktualisierungen der in Dreamweaver integrierten dynamischen Menüs zu vermeiden. Weitere Informationen finden Sie unter „dreamweaver.getMenuNeedsUpdating()“ auf Seite 133 und „dreamweaver.notifyMenuUpdated()“ auf Seite 133.

dreamweaver.getMenuNeedsUpdating()


BeschreibungÜberprüft, ob das betreffende Menü aktualisiert werden muss.

ArgumentemenuId

• Das Argument menuId ist ein String mit dem Wert des Attributs id für das Menüelement, wie in der Datei menus.xml angegeben.

RückgabewerteEin Boolescher Wert, der angibt, ob das Menü aktualisiert werden muss. Diese Funktion gibt nur dann den Wert false zurück, wenn dreamweaver.notifyMenuUpdated() mit diesem menuId-Argument aufgerufen wurde und der Rückgabewert von menuListFunction nicht geändert wurde. Weitere Informationen finden Sie unter „dreamweaver.notifyMenuUp-dated()“ auf Seite 133.

dreamweaver.notifyMenuUpdated()


BeschreibungGibt eine Meldung an Dreamweaver aus, wenn das angegebene Menü aktualisiert werden muss.

ArgumentemenuId, menuListFunction

• Das Argument menuId ist ein String mit dem Wert des Attributs id für das Menüelement, wie in der Datei menus.xml angegeben.

• Das Argument menuListFunction muss einer der folgenden Strings sein: "dw.cssStylePalette.getStyles()", "dw.getDocumentDOM().getFrameNames()", "dw.getDocumentDOM().getEditableRegionList", "dw.getBrow-serList()", "dw.getRecentFileList()", "dw.getTranslatorList()", "dw.getFontList()", "dw.getDocu-mentList()", "dw.htmlStylePalette.getStyles()" oder "site.getSites()".

RückgabewerteKeine


134

dreamweaver.reloadMenus()


BeschreibungLädt die gesamte Menüstruktur aus der Datei menus.xml im Ordner Configuration.

ArgumenteKeine

RückgabewerteKeine

Ergebnisfenster-FunktionenMit den Ergebnisfenster-Funktionen können Sie mit den integrierten Bedienfeldern in der Bedienfeldgruppe Ergebnisse interagieren oder ein separates Fenster erstellen, in dem Spalten mit formatierten Daten angezeigt werden.

Mit der integrierten Bedienfeldgruppe „Ergebnisse“ arbeiten Mit diesen Funktionen wird eine Ausgabe in der Bedienfeldgruppe Ergebnisse erzeugt. In der Bedienfeldgruppe Ergeb-nisse werden Registerkarten für Suchvorgänge, Quellcodeprüfungen, site-bezogene Berichte, Browserkompatibilitätsprü-fungen, Server-Debugging, FTP-Protokolle und Hyperlink-Überprüfungen angezeigt.

Mit bestimmten untergeordneten Bedienfeldern arbeitenDie folgenden untergeordneten Bedienfelder sind integrierte Ergebnisfenster, die grundsätzlich in der Dreamweaver-Benutzeroberfläche zur Verfügung stehen und auf die Sie direkt zugreifen können.

• dreamweaver.resultsPalette.siteReports

• dreamweaver.resultsPalette.validator

• dreamweaver.resultsPalette.bcc

Da es sich bei diesen Bedienfeldern um Ergebnisfenster handelt, können Sie die folgenden, für separate Ergebnisfenster definierten Methoden verwenden:

• getItem()

• getItemCount()

• getSelectedItem()

• setSelectedItem()

Weitere Informationen zur Verwendung der resWin-Methoden finden Sie unter „Separate Ergebnisfenster erstellen“ auf Seite 139.

Mit dem aktiven untergeordneten Bedienfeld arbeitenDie folgenden allgemeinen API-Funktionen gelten für das jeweils aktive untergeordnete Bedienfeld. Bei einigen unterge-ordneten Bedienfeldern werden manche dieser Funktionen möglicherweise ignoriert. Wenn das aktive untergeordnete Bedienfeld die Funktion nicht unterstützt, hat der Aufruf dieser Funktion keinerlei Auswirkungen.


135

dreamweaver.showResults()


BeschreibungÖffnet das angegebene schwebende Bedienfeld Ergebnisse und wählt das Element aus.

Hinweis: Diese Funktion wird nur für die Fenster Überprüfung, Browserkompatibilitätsprüfung und Site-Berichte der Bedienfeldgruppe Ergebnisse unterstützt.

ArgumentefloaterName, floaterIndex

• Das Argument floaterName ist ein String, der angibt, welches schwebende Ergebnisbedienfeld geöffnet werden soll. Gültige Werte sind 'validation' oder 'reports'.

• Das Argument floaterIndex ist eine Zahl oder ein String. Mit einer Zahl geben Sie den Index eines Elements an, das im Bedienfeld Ergebnisse ausgewählt werden soll. Mit einem String geben Sie die URL eines Dokuments an. Wenn Sie eine URL angeben, wählt die Funktion das erste sichtbare Element für das Dokument aus.

RückgabewerteKeine

Beispiel Mithilfe des folgenden Beispiels wird am Offset der aktuellen Auswahl im Dokument eine Fehlerprüfung vorgenommen. Werden Fehler gefunden, werden sie im angegebenen Fenster (floaterName) im Bedienfeld Ergebnisse angezeigt. Anderenfalls wird das Fenster Browserkompatibilitätsprüfung im Bedienfeld Ergebnisse geöffnet, und das erste sichtbare Element für das aktuelle Dokument wird angezeigt.

var offset = dw.getDocumentDOM().source.getSelection()[0];

var errors = dw.getDocumentDOM().source.getValidationErrorsForOffset(offset);

if ( errors && errors.length > 0 )

dw.showResults( errors[0].floaterName, errors[0].floaterIndex );

else

dw.showResults('bcc', dw.getDocumentDOM().URL);


136

dreamweaver.resultsPalette.siteReports.addResultItem()


BeschreibungFügt dem aktuellen Ergebnisfenster einen neuen Ergebniseintrag hinzu. Dabei dienen die Daten in der Datei als Grundlage, die von der Funktion processfile() verarbeitet werden.

Diese Funktion steht nur über die Rückruffunktion processFile() eines Site-Berichts zur Verfügung. Ausführliche Infor-mationen zu Site-Berichten finden Sie im Abschnitt „Berichte“ unter Dreamweaver erweitern.

ArgumentestrFilePath, strIcon, strDisplay, strDesc, {iLineNo}, {iStartSel}, {iEndSel}

• Das Argument strFilePath ist der vollständige URL-Pfadname der zu verarbeitenden Datei.

• Das Argument strIcon ist der Pfad des zu verwendenden Symbols. Um ein integriertes Symbol anzuzeigen, geben Sie anstelle des vollständigen Pfadnamens für das Symbol einen Wert von 1 bis 10 ein. (Geben Sie 0 ein, wenn kein Symbol angezeigt werden soll.) In der folgenden Tabelle sind die Symbole aufgeführt, die den Werten von 1 bis 10 entsprechen:

• Das Argument strDisplay ist der String, der in der ersten Spalte des Ergebnisfensters angezeigt werden soll (normaler-weise der Dateiname).

• Das Argument strDesc ist die Beschreibung für den Eintrag.

• Das Argument iLineNo entspricht der Anzahl der Zeilen in der Datei (optional).

• Das Argument iStartSel ist der Beginn des Offsets in der Datei. (Dieses Argument ist optional. Wenn es verwendet wird, muss auch das Argument iEndSel verwendet werden.)

• Das Argument iEndSel ist das Ende des Offsets in der Datei (erforderlich, wenn iStartSel verwendet wurde).

RückgabewerteKeine

dreamweaver.resultsPalette.clear()


BeschreibungLöscht den Inhalt des aktiven Bedienfelds.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canClear()“ auf Seite 435.


137

dreamweaver.resultsPalette.Copy()


BeschreibungSendet eine kopierte Meldung an das aktive Fenster (dies wird häufig für das Fenster für die FTP-Protokollierung verwendet).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canCopy()“ auf Seite 435.

dreamweaver.resultsPalette.cut()


BeschreibungSendet eine ausgeschnittene Meldung an das aktive Fenster (dies wird häufig für das Fenster für die FTP-Protokollierung verwendet).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canCut()“ auf Seite 435.

dreamweaver.resultsPalette.Paste()


BeschreibungSendet eine eingefügte Meldung an das aktive Fenster (dies wird häufig für das Fenster für die FTP-Protokollierung verwendet).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canPaste()“ auf Seite 436.


138

dreamweaver.resultsPalette.openInBrowser


BeschreibungSendet einen Bericht an den Standardbrowser (Site-Berichte, Zielbrowser-Prüfung, Überprüfung und Hyperlinkprüfung).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canOpenInBrowser()“ auf Seite 436.

dreamweaver.resultsPalette.openInEditor()


BeschreibungSpringt bei bestimmten Berichten (Site-Berichte, Zielbrowser-Prüfung, Überprüfung und Hyperlink-Prüfer) zur ausge-wählten Zeile und öffnet das Dokument im Editor.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canOpenInEditor()“ auf Seite 436.

dreamweaver.resultsPalette.save()


BeschreibungÖffnet das Dialogfeld Speichern für ein Fenster, das die Funktion Speichern unterstützt (Site-Berichte, Zielbrowser-Prüfung, Überprüfung und Hyperlink-Prüfer).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canSave()“ auf Seite 436.


139

dreamweaver.resultsPalette.selectAll()


BeschreibungSendet den Befehl Alles auswählen an das aktive Fenster.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.resultsPalette.canSelectAll()“ auf Seite 437.

Separate Ergebnisfenster erstellenDie Funktion dreamweaver.createResultsWindow erstellt ein Ergebnisfenster.

dreamweaver.createResultsWindow()


BeschreibungErstellt ein neues Ergebnisfenster und gibt eine JavaScript-Objektreferenz an dieses Fenster zurück.

ArgumentestrName, arrColumns

• Das Argument strName ist der String für den Fenstertitel.

• Das Argument arrColumns ist ein Array von Spaltennamen, die für das Listensteuerelement verwendet werden.

RückgabewerteEine Objektreferenz, die an das erstellte Fenster übergeben wird.


140

resWin.addItem()


BeschreibungFügt dem Ergebnisfenster ein neues Element hinzu.

Hinweis: Verwenden Sie nur ein eigenständiges Ergebnisfenster, das mit „dreamweaver.createResultsWindow()“ auf Seite 139 erstellt wurde. Die Funktion resWin.addItem() kann nicht mit den integrierten Ergebnisfenstern (Überprüfung, Browserkom-patibilitätsprüfung und Site-Berichte) verwendet werden.

ArgumenteresultWindowObj, strIcon, strDesc, itemData, iStartSel, iEndSel, colNdata

• Das Argument resultWindowObj ist das von der Funktion createResultsWindow() zurückgegebene Objekt.

• Das Argument strIcon ist ein String, der den Pfad zu dem gewünschten Symbol angibt. Um ein integriertes Symbol anzuzeigen, geben Sie anstelle des vollständigen Pfadnamens einen Wert von 1 bis 10 an. Geben Sie 0 (Null) an, wenn kein Symbol angezeigt werden soll. In der folgenden Tabelle sind die Symbole aufgeführt, die den Werten von 1 bis 10 entsprechen:

• Das Argument strDesc ist eine ausführliche Beschreibung des Elements. Geben Sie 0 an, wenn keine Beschreibung vorhanden ist.

• Das Argument itemData ist ein String, in dem Sie bestimmte Daten für das hinzuzufügende Element (z. B. die Zeilen-nummer im Dokument) speichern können.

• Das Argument iStartSel ist der Beginn des Auswahl-Offsets in der Datei. Geben Sie den Wert null an, wenn Sie keinen Offset angeben möchten.

• Das Argument iEndSel ist das Ende des Auswahl-Offsets in der Datei. Geben Sie den Wert null an, wenn Sie keinen Offset angeben möchten.

• Das Argument colNdata ist ein String-Array, das die Daten für die einzelnen Spalten angibt (d. h., für 3 Spalten ist ein Array von 3 Strings anzugeben).

RückgabewerteEin Boolescher Wert: true, wenn das Element erfolgreich hinzugefügt wurde, andernfalls false.

Beispiel Mithilfe des folgenden Beispiels wird ein Ergebnisfenster mit dem Namen resWin erstellt, das die Spaltenüberschriften „Frodo“, „Sam“ und „Gollum“ enthält. Durch den Aufruf der Funktion resWin.addItem() wird ein Ordnersymbol hinzu-gefügt. Dann werden die drei Strings msg1, msg2 und msg3 in die drei, für das Fenster definierten Spalten eingefügt.

var resWin = dw.createResultsWindow("Test Window", ["Frodo", "Sam", "Gollum"]);

resWin.addItem(resWin, "3", "Description", null, null, null, ["msg1", "msg2", "msg3"]);


141

resWin.getItem()


BeschreibungRuft ein Array mit Elementen ab, das die Namen der Befehle enthält, mit denen die jeweiligen Elemente hinzugefügt wurden, sowie die Strings, die an die Funktion addItem() übergeben wurden.

ArgumenteitemIndex

• Das Argument itemIndex ist der Index des Elements, dessen Daten abgerufen werden sollen.

RückgabewerteEin String-Array. Das erste Feld im Array ist der Name des Befehls, mit dem das Element hinzugefügt wurde. Die weiteren Felder enthalten die Strings, die an die Funktion addItem() übergeben wurden.

resWin.getItemCount()


BeschreibungRuft die Anzahl der Elemente in der Liste ab.

ArgumenteKeine

RückgabewerteDie Anzahl der Elemente in der Liste.

resWin.getSelectedItem()


BeschreibungRuft den Index des ausgewählten Elements ab.

ArgumenteKeine

RückgabewerteDer Index des aktuell ausgewählten Elements.


142

resWin.setButtons()


BeschreibungDefiniert die im Argument arrButtons angegebenen Schaltflächen.

ArgumentecmdDoc, arrButtons

• Das Argument cmdDoc bezeichnet ein Dokumentobjekt, das den Befehl repräsentiert, der die Funktion aufruft. Befehle sollten das Schlüsselwort this verwenden.

• Das Argument arrButtons ist ein Array mit Strings, die den Schaltflächentext sowie den JavaScript-Code angeben, der ausgeführt werden soll, wenn der Benutzer auf die Schaltfläche klickt. Dies entspricht der Arbeitsweise der Funktion commandButtons() für Befehle. Im Fenster können nur zwei Schaltflächen definiert werden.

RückgabewerteKeine

resWin.setCallbackCommands()


BeschreibungTeilt dem Ergebnisfenster mit, bei welchen Befehlen die Methode processFile() aufgerufen werden soll. Wenn diese Funktion nicht aufgerufen wird, wird stattdessen der Befehl, mit dem das Ergebnisfenster erstellt wurde, aufgerufen.

ArgumentearrCmdNames

• Das Argument arrCmdNames ist ein Array von Befehlen, bei denen die Funktion processFile() aufgerufen werden soll.

RückgabewerteKeine

resWin.setColumnWidths()


BeschreibungStellt die Breite der einzelnen Spalten ein.

ArgumentearrWidth

• Das Argument arrWidth ist ein Array von Ganzzahlen, das die Breite der einzelnen Spalten im Steuerelement definiert.

RückgabewerteKeine


143

resWin.setFileList()


BeschreibungÜbergibt eine Liste mit Dateien und/oder Ordnern an das Ergebnisfenster, um einen Befehlssatz zur Verarbeitung aufzu-rufen.

ArgumentearrFilePaths, bRecursive

• Das Argument arrFilePaths ist ein Array von Pfaden zu Dateien oder Ordnern, das wiederholt durchlaufen werden soll.

• Das Argument bRecursive ist ein Boolescher Wert, der angibt, ob die Wiederholung rekursiv (true) oder nicht rekursiv (false) erfolgen soll.

RückgabewerteKeine

resWin.setSelectedItem()


BeschreibungWeist dem ausgewählten Element das mit itemIndex angegebene Element zu.

ArgumenteitemIndex

• Der Index des in der Liste auszuwählenden Elements.

RückgabewerteDer Index des zuvor ausgewählten Elements.

resWin.setTitle()


BeschreibungStellt den Titel des Fensters ein.

ArgumentestrTitle

• Das Argument strTitle ist der neue Name des schwebenden Bedienfelds.

RückgabewerteKeine


144

resWin.startProcessing()


BeschreibungStartet die Verarbeitung der Datei.

ArgumenteKeine

RückgabewerteKeine

resWin.stopProcessing()


BeschreibungStoppt die Verarbeitung der Datei.

ArgumenteKeine

RückgabewerteKeine

Server debuggenDreamweaver kann Dateien von ColdFusion anfordern und die Antwort im eingebetteten Browser anzeigen. Wenn die Antwort vom Server zurückgegeben wird, durchsucht Dreamweaver die Antwort nach einem XML-Paket mit einer bekannten Signatur. Wenn Dreamweaver XML-Code mit dieser Signatur findet, wird der XML-Code verarbeitet, und der Inhalt wird in einer Strukturansicht angezeigt. Diese Strukturansicht enthält Informationen über die folgenden Elemente:

• Alle Vorlagen, benutzerdefinierten Tags und Include-Dateien, die für die Erstellung der angezeigten CFM-Seite verwendet werden.

• Ausnahmen

• SQL-Abfragen

• Objektabfragen

• Variablen

• Verfolgungsprotokolle

Im Bedienfeld Serverdebug können zudem Debugdaten von anderen Servermodellen angezeigt werden. Verwenden Sie die Funktion dreamweaver.resultsPalette.debugWindow.addDebugContextData(), um Dreamweaver für das Debuggen anderer Servermodelle einzurichten.


145

dreamweaver.resultsPalette.debugWindow.addDebugContextData()


BeschreibungInterpretiert eine benutzerdefinierte XML-Datei, die von dem im Dialogfeld Site-Definition angegebenen Server zurück-gegeben wird. Der Inhalt der XML-Datei wird in einer Strukturansicht im Bedienfeld Serverdebug angezeigt. Daher können Sie im Bedienfeld Serverdebug den vom Server erstellten Inhalt verschiedener Servermodelle auswerten.

Argumentetreedata

• Das Argument treedata enthält den vom Server zurückgegebenen XML-String. Für den XML-String sollte die folgende Formatierung verwendet werden:

server debug node Stammknoten für die XML-Debugdaten

debugnode Entspricht den einzelnen Knoten

context Name des Elements, das in der Kontextliste angezeigt wird

icon Das für den Strukturknoten zu verwendende Symbol

name Der anzuzeigende Name

value Der anzuzeigende Wert

timestamp Gilt nur für den Kontextknoten

Die folgenden Strings sind optional:

jumptoline Hyperlink zu einer bestimmten Zeilennummer

template Name der Vorlagendatei in der URL

path Pfad der Datei aus Sicht des Servers

line number Zeilennummer innerhalb der Datei

start position Startzeichen-Offset innerhalb der Zeile

end position Endzeichen-Offset innerhalb der Zeile


146

Beispiel:

<serverdebuginfo>

<context>

<template><![CDATA[/ooo/master.cfm]]></template>

<path><![CDATA[C:\server\wwwroot\ooo\master.cfm]]></path>

<timestamp><![CDATA[0:0:0.0]]></timestamp>

</context>

<debugnode>

<name><![CDATA[CGI]]></name>

<icon><![CDATA[ServerDebugOutput/ColdFusion/CGIVariables.gif]]></icon>

<debugnode>

<name><![CDATA[Pubs.name.sourceURL]]></name>

<icon><![CDATA[ServerDebugOutput/ColdFusion/Variable.gif]]></icon>

<value><![CDATA[jdbc:Macromedia:sqlserver:

//name.Macromedia.com:1111;databaseName=Pubs]]></value>

</debugnode>

</debugnode>

<debugnode>

<name><![CDATA[Element Snippet is undefined in class

coldfusion.compiler.TagInfoNotFoundException]]></name>

<icon><![CDATA[ServerDebugOutput/ColdFusion/Exception.gif]]></icon>

<jumptoline linenumber="3" startposition="2" endposition="20">

<template><![CDATA[/ooo/master.cfm]]></template>

<path><![CDATA[C:\Neo\wwwroot\ooo\master.cfm]]></path>

</jumptoline>

</debugnode>

</serverdebuginfo>

RückgabewerteKeine

UmschaltfunktionenMit Umschaltfunktionen lassen sich verschiedene Optionen abrufen und einstellen, die entweder aktiviert oder deaktiviert sind.

dom.getEditNoFramesContent()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Modifizieren > Frameset > NoFrames-Inhalt bearbeiten ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der NOFRAMES-Inhalt die aktive Ansicht darstellt, andernfalls false.


147

dom.getHideAllVisualAids()


BeschreibungDiese Funktion bestimmt, ob die visuellen Hilfsmittel ausgeblendet sind.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Option Alle visuellen Hilfsmittel ausblenden aktiviert ist, andernfalls false.

dom.getPreventLayerOverlaps()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ebenenüberlappungen verhindern ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Option Ebenenüberlappungen verhindern aktiviert ist, andernfalls false.

dom.getShowAutoIndent()


BeschreibungDiese Funktion bestimmt, ob der automatische Einzug in der Codeansicht des Dokumentfensters aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der automatische Einzug aktiviert ist, andernfalls false.


148

dom.getShowFrameBorders()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Visuelle Hilfsmittel > Frame-Rahmen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Frame-Rahmen angezeigt werden, andernfalls false.

dom.getShowGrid()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Raster > Raster anzeigen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Raster angezeigt wird, andernfalls false.

dom.getShowHeadView()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Head-Inhalt ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Head-Inhalt angezeigt wird, andernfalls false.


149

dom.getShowInvalidHTML()


BeschreibungDiese Funktion bestimmt, ob ungültiger HTML-Code derzeit in der Codeansicht des Dokumentfensters markiert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true wenn ungültiger HTML-Code markiert ist; andernfalls false.

dom.getShowImageMaps()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Visuelle Hilfsmittel > Imagemaps ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Imagemaps angezeigt werden, andernfalls false.

dom.getShowInvisibleElements()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Visuelle Hilfsmittel > Unsichtbare Elemente ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Markierungen für unsichtbare Elemente angezeigt werden, andernfalls false.


150

dom.getShowLayerBorders()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Visuelle Hilfsmittel > Ebenenrahmen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Ebenenrahmen angezeigt werden, andernfalls false.

dom.getShowLineNumbers()


BeschreibungDiese Funktion bestimmt, ob Zeilennummern in der Codeansicht angezeigt werden.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Zeilennummern angezeigt werden, andernfalls false.

dom.getShowRulers()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Lineale > Zeigen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Lineale angezeigt werden, andernfalls false.


151

dom.getShowSyntaxColoring()


BeschreibungDiese Funktion bestimmt, ob die farbliche Darstellung der Syntax in der Codeansicht des Dokumentfensters aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die farbliche Darstellung der Syntax aktiviert ist, andernfalls false.

dom.getShowTableBorders()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Visuelle Hilfsmittel > Tabellenrahmen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Tabellenrahmen angezeigt werden, andernfalls false.

dom.getShowToolbar()


BeschreibungDiese Funktion bestimmt, ob die Symbolleiste angezeigt wird.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Symbolleiste angezeigt wird, andernfalls false.


152

dom.getShowTracingImage()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Tracing-Bild > Zeigen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Option aktiviert ist, andernfalls false.

dom.getShowWordWrap()


BeschreibungDiese Funktion bestimmt, ob der Zeilenumbruch in der Codeansicht des Dokumentfensters aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Zeilenumbruch aktiviert ist, andernfalls false.

dom.getSnapToGrid()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Raster > Am Raster ausrichten ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Option Am Raster ausrichten aktiviert ist, andernfalls false.


153

dom.setEditNoFramesContent()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Modifizieren > Frameset > NoFrames-Inhalt bearbeiten.

ArgumentebEditNoFrames

• Das Argument bEditNoFrames ist ein Boolescher Wert: true, um die Option NoFrames-Inhalt bearbeiten zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canEditNoFramesContent()“ auf Seite 419.

dom.setHideAllVisualAids()


BeschreibungDiese Funktion deaktiviert die Anzeige aller Rahmen, Imagemaps und unsichtbaren Elemente, unabhängig von den indivi-duellen Einstellungen im Menü Ansicht.

ArgumentebSet

• Das Argument bSet ist ein Boolescher Wert: true, um visuelle Hilfsmittel auszublenden, andernfalls false.

RückgabewerteKeine

dom.setPreventLayerOverlaps()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ebenenüberlappungen verhindern.

ArgumentebPreventLayerOverlaps

• Das Argument bPreventLayerOverlaps ist ein Boolescher Wert: true, um die Option Ebenenüberlappungen verhindern zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine


154

dom.setShowFrameBorders()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Visuelle Hilfsmittel > Frame-Rahmen.

ArgumentebShowFrameBorders

• Das Argument bShowFrameBorders ist ein Boolescher Wert: true, um die Option Frame-Rahmen zu aktivieren, andern-falls false.

RückgabewerteKeine

dom.setShowGrid()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Raster > Raster anzeigen.

ArgumentebShowGrid

• Das Argument bShowGrid ist ein Boolescher Wert: true, um die Option Ansicht > Raster > Raster anzeigen zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

dom.setShowHeadView()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Head-Inhalt.

ArgumentebShowHead

• Das Argument bShowHead ist ein Boolescher Wert: true, um die Option Head-Inhalt zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine


155

dom.setShowInvalidHTML()


BeschreibungMit dieser Funktion wird die Markierung des ungültigen HTML-Codes in der Codeansicht des Dokumentfensters aktiviert bzw. deaktiviert.

Diese Funktion bestimmt, ob ungültiger HTML-Code gegenwärtig markiert ist.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um ungültigen HTML-Code sichtbar zu markieren, andernfalls false.

RückgabewerteKeine

dom.setShowImageMaps()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Visuelle Hilfsmittel > Imagemaps.

ArgumentebShowImageMaps

• Das Argument bShowImageMaps ist ein Boolescher Wert: true, um die Option Imagemaps zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

dom.setShowInvisibleElements()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Visuelle Hilfsmittel > Unsichtbare Elemente.

ArgumentebViewInvisibleElements

• Das Argument bViewInvisibleElements ist ein Boolescher Wert: true, um die Option Unsichtbare Elemente zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine


156

dom.setShowLayerBorders()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Visuelle Hilfsmittel > Ebenenrahmen.

ArgumentebShowLayerBorders

• Das Argument bShowLayerBorders ist ein Boolescher Wert: true, um die Option Ebenenrahmen zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

dom.setShowLineNumbers()


BeschreibungDiese Funktion blendet die Zeilennummern in der Codeansicht des Dokumentfensters ein oder aus.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die Zeilennummern anzuzeigen; false, um sie auszublenden.

RückgabewerteKeine

dom.setShowRulers()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Lineale > Zeigen.

ArgumentebShowRulers

• Das Argument bShowRulers ist ein Boolescher Wert: true, um die Option Einblenden zu aktivieren; false, um sie zu deaktivieren.

RückgabewerteKeine


157

dom.setShowSyntaxColoring()


BeschreibungMit dieser Funktion wird die farbliche Darstellung der Syntax in der Codeansicht des Dokumentfensters aktiviert bzw. deaktiviert.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die farbliche Darstellung der Syntax anzuzeigen, andernfalls false.

RückgabewerteKeine

dom.setShowTableBorders()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Visuelle Hilfsmittel > Tabellenrahmen.

ArgumentebShowTableBorders

• Das Argument bShowTableBorders ist ein Boolescher Wert: true, um die Option Tabellenrahmen zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

dom.setShowToolbar()


BeschreibungDiese Funktion blendet die Symbolleiste ein oder aus.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die Symbolleiste anzuzeigen, andernfalls false .

RückgabewerteKeine


158

dom.setShowTracingImage()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Tracing-Bild > Zeigen.

ArgumentebShowTracingImage

• Das Argument bShowTracingImage ist ein Boolescher Wert: true, um die Option Einblenden zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

dom.setShowWordWrap()


BeschreibungDiese Funktion blendet den Zeilenumbruch in der Codeansicht des Dokumentfensters ein bzw. aus.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um den Zeilenumbruch zu aktivieren, andernfalls false .

RückgabewerteKeine

dom.setSnapToGrid()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Raster > Am Raster ausrichten.

ArgumentebSnapToGrid

• Das Argument bSnapToGrid ist ein Boolescher Wert: true, um die Option Am Raster ausrichten zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine


159

dreamweaver.getHideAllFloaters()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Bedienfelder ausblenden ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Option Bedienfelder ausblenden aktiviert ist; false, wenn die Option zum Einblenden von Bedienfeldern aktiviert ist.

dreamweaver.getShowStatusBar()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Ansicht > Statusleiste ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Statusleiste angezeigt wird, andernfalls false.

dreamweaver.htmlInspector.getShowAutoIndent()


BeschreibungDiese Funktion bestimmt, ob im Codeinspektor die Option Automatischer Einzug aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der automatische Einzug aktiviert ist, andernfalls false.


160

dreamweaver.htmlInspector.getShowInvalidHTML()


BeschreibungDiese Funktion bestimmt, ob ungültiger HTML-Code gegenwärtig im Codeinspektor markiert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true wenn ungültiger HTML-Code markiert ist; andernfalls false.

dreamweaver.htmlInspector.getShowLineNumbers()


BeschreibungDiese Funktion bestimmt, ob im Codeinspektor Zeilennummern angezeigt werden.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Zeilennummern angezeigt werden, andernfalls false.

dreamweaver.htmlInspector.getShowSyntaxColoring()


BeschreibungDiese Funktion bestimmt, ob im Codeinspektor die farbliche Darstellung der Syntax aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die farbliche Darstellung der Syntax aktiviert ist, andernfalls false.


161

dreamweaver.htmlInspector.getShowWordWrap()


BeschreibungDiese Funktion bestimmt, ob im Codeinspektor der Zeilenumbruch aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Zeilenumbruch aktiviert ist, andernfalls false.

dreamweaver.htmlInspector.setShowAutoIndent()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert im Codeinspektor die Option Automatischer Einzug.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die Option Automatischer Einzug zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

dreamweaver.htmlInspector.setShowInvalidHTML()


BeschreibungMit dieser Funktion wird die Markierung des ungültigen HTML-Codes im Codeinspektor aktiviert bzw. deaktiviert.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die Markierung des ungültigen HTML-Codes anzuzeigen; false, um die Markierung auszublenden.

RückgabewerteKeine


162

dreamweaver.htmlInspector.setShowLineNumbers()


BeschreibungDiese Funktion blendet die Zeilennummern im Codeinspektor ein oder aus.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die Zeilennummern anzuzeigen; false, um sie auszublenden.

RückgabewerteKeine

dreamweaver.htmlInspector.setShowSyntaxColoring()


BeschreibungMit dieser Funktion wird die farbliche Darstellung der Syntax im Codeinspektor aktiviert bzw. deaktiviert.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die farbliche Darstellung der Syntax anzuzeigen; false, um sie auszublenden.

RückgabewerteKeine

dreamweaver.htmlInspector.setShowWordWrap()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert den Zeilenumbruch im Codeinspektor.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um den Zeilenumbruch zu aktivieren; false, um ihn zu deakti-vieren.

RückgabewerteKeine


163

dreamweaver.setHideAllFloaters()


BeschreibungDiese Funktion aktiviert entweder die Option Bedienfelder ausblenden oder die Option zum Einblenden von Bedien-feldern.

ArgumentebShowFloatingPalettes

• Das Argument bShowFloatingPalettes ist ein Boolescher Wert: true, um die Option Bedienfelder ausblenden zu aktivieren; false, um die Option zum Einblenden von Bedienfeldern zu aktivieren.

RückgabewerteKeine

dreamweaver.setShowStatusBar()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Ansicht > Statusleiste.

ArgumentebShowStatusBar

• Das Argument bShowStatusBar ist ein Boolescher Wert: true, um die Option Statusleiste zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

site.getShowDependents()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Abhängige Dateien anzeigen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn abhängige Dateien in der Sitemap angezeigt werden; false, wenn abhängige Dateien ausgeblendet sind.


164

site.getShowHiddenFiles()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Als versteckt markierte Dateien anzeigen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn versteckte Dateien in der Sitemap angezeigt werden, andernfalls false.

site.getShowPageTitles()


BeschreibungDiese Funktion ruft den aktuellen Status der Option Seitentitel anzeigen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Seitentitel in der Sitemap angezeigt werden, andernfalls false.

site.getShowToolTips()


BeschreibungDiese Funktion ruft den aktuellen Status der Option QuickInfo ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn QuickInfos im Bedienfeld Site angezeigt werden, andernfalls false.


165

site.setShowDependents()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Abhängige Dateien anzeigen in der Sitemap.

ArgumentebShowDependentFiles

• Das Argument bShowDependentFiles ist ein Boolescher Wert: true, um die Option Abhängige Dateien anzeigen zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

site.setShowHiddenFiles()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Als versteckt markierte Dateien anzeigen in der Sitemap.

ArgumentebShowHiddenFiles

• Das Argument bShowHiddenFiles ist ein Boolescher Wert: true, um die Option Als versteckt markierte Dateien anzeigen zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

site.setShowPageTitles()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option Seitentitel anzeigen in der Sitemap.

ArgumentebShowPageTitles

• Das Argument bShowPageTitles ist ein Boolescher Wert: true, um die Option Seitentitel anzeigen zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canShowPageTitles()“ auf Seite 447.


166

site.setShowToolTips()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert die Option QuickInfo.

ArgumentebShowToolTips

• Das Argument bShowToolTips ist ein Boolescher Wert: true, um die Option QuickInfo zu aktivieren; false, um die Option zu deaktivieren.

RückgabewerteKeine

SymbolleistenfunktionenMit den folgenden JavaScript-Funktionen können Sie die Sichtbarkeit von Symbolleisten und deren Beschriftungen abrufen und festlegen, die Beschriftungen von Symbolleisten im aktuellen Fenster abrufen, Symbolleisten positionieren und Symbolleisten-IDs abrufen. Weitere Informationen zum Erstellen und Bearbeiten von Symbolleisten finden Sie unter „Symbolleisten“ im Hilfemodul Dreamweaver erweitern.

dom.forceToolbarUpdate()


BeschreibungErzwingt, dass die Aktualisierungsprozeduren für alle Elemente in der angegebenen Symbolleiste ausgeführt werden.

ArgumentetoolbarID

• Das Argument toolbarID ist die ID der Symbolleiste, die die zu aktualisierenden Elemente enthält.

RückgabewerteKeine

dom.getShowToolbarIconLabels()


BeschreibungDiese Funktion bestimmt, ob Beschriftungen von Schaltflächen im aktuellen Dokumentfenster angezeigt werden. Dream-weaver zeigt Beschriftungen für andere Steuerelemente als Schaltflächen immer an, sofern diese Beschriftungen definiert wurden.

ArgumenteKeine


167

RückgabewerteEin Boolescher Wert: true, wenn Beschriftungen von Schaltflächen im aktuellen Dokumentfenster angezeigt werden, andernfalls false .

BeispielIm folgenden Beispiel werden die Beschriftungen von Schaltflächen sichtbar gemacht:

var dom = dw.getDocumentDom();

if (dom.getShowToolbarIconLabels() == false)

{

dom.setShowToolbarIconLabels(true);

}

dom.getToolbarIdArray()


BeschreibungDiese Funktion gibt ein Array der IDs aller Symbolleisten in der Anwendung zurück. Mit dom.getToolbarIdArray() können Sie alle Symbolleisten ausblenden. Anschließend können Sie sie neu anordnen und nur eine bestimmte Auswahl einblenden.

ArgumenteKeine

RückgabewerteEin Array aller Symbolleisten-IDs.

BeispielIm folgenden Beispiel wird das Array der Symbolleisten-IDs in der Variablen tb_ids gespeichert:

var tb_ids = new Array();tb_ids = dom.getToolbarIdArray();

dom.getToolbarItemValue()


BeschreibungRuft den Wert des angegebenen Symbolleistenelements ab.

ArgumentetoolbarID, itemID

• Das Argument toolbarID ist ein String, der die ID der Symbolleiste mit dem Element angibt, für das Sie einen Wert abrufen möchten.

• Das Argument itemID ist ein String, der die ID des Elements angibt, für das Sie einen Wert abrufen möchten.

RückgabewerteEin String, der den Wert des Symbolleistenelements darstellt.


168

BeispielBei dem folgenden Beispiel für receiveArguments() handelt es sich um einen Symbolleistenbefehl, der das Verhalten eines Textfelds für die Größe steuert. Der Wert für das Feld Größe wird als Argument abgerufen. Anschließend wird der Wert für das Feld Einheiten gelesen, um einen gültigen Wert für die Funktion font-size der CSS-Eigenschaft zu ermitteln:

receiveArguments(newSize){

var dom = dw.getDocumentDOM();

if (newSize != ""){

dom.applyFontMarkupAsStyle('font-size', newSize +

dom.getToolbarItemValue("DW_Toolbar_Text","DW_Text_Units"));

}

else{

dom.removeFontMarkupAsStyle('font-size');

}

}

dom.getToolbarLabel()


BeschreibungDiese Funktion ruft die Beschriftung der angegebenen Symbolleiste ab. Sie können dom.getToolbarLabel() auf Menüs anwenden, die Symbolleisten ein- oder ausblenden.

Argumentetoolbar_id

• Das Argument toolbar_id ist die ID der Symbolleiste, d. h. der Wert des ID-Attributs für das Symbolleisten-Tag in der Datei toolbars.xml.

Rückgabewerte Der Namenstring label, der dem toolbar-Tag als Attribut zugeordnet ist.

BeispielIm folgenden Beispiel wird die Beschriftung für myEditbar in der Variablen label gespeichert:

var label = dom.getToolbarLabel("myEditbar");

dom.getToolbarVisibility()


BeschreibungDiese Funktion gibt einen Booleschen Wert zurück. Mit diesem Wert wird angegeben, ob die durch toolbar_id angegebene Symbolleiste angezeigt wird.

Argumentetoolbar_id

• Das Argument toolbar_id ist der ID-String, der der Symbolleiste zugeordnet ist.

RückgabewerteEin Boolescher Wert: true, wenn die Symbolleiste angezeigt wird; false, wenn die Symbolleiste nicht angezeigt wird oder nicht vorhanden ist.


169

BeispielIm folgenden Beispiel wird geprüft, ob die Symbolleiste myEditbar im Dokumentfenster angezeigt wird. Anschließend wird der Wert in der Variablen retval gespeichert:

var retval = dom.getToolbarVisibility("myEditbar");

return retval;

dom.setToolbarItemAttribute()


BeschreibungÄndert einen Attributwert für die drei Bildattribute oder das tooltip-Attribut eines Symbolleistenelements.

ArgumentetoolbarID, toolbarItemId, attrName, attrValue

• Das Argument toolbarID ist ein String, der die ID der Symbolleiste angibt.

• Das Argument toolbarItemId ist ein String, der die ID des Symbolleistenelements angibt.

• Das Argument attrName ist ein String, der den Namen des festzulegenden Attributs angibt. Gültige Werte sind 'image', 'overImage', 'disabledImage' und 'tooltip'.

• Das Argument attrValue ist ein String, der den festzulegenden Wert angibt.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird dom.setToolbarItemAttribute() dreimal aufgerufen, um die Attribute image, imageOver und tooltip für das Symbolleistenelement MyButton auf der Symbolleiste mit der ID DW_Toolbar_Main festzulegen.


dom.setToolbarItemAttribute('DW_Toolbar_Main', 'MyButton', 'image',

'Toolbars/imgs/newimage.gif');

dom.setToolbarItemAttribute('DW_Toolbar_Main', 'MyButton', 'imageOver',

'Toolbars/imgs/newimageOver.gif');

dom.setToolbarItemAttribute('DW_Toolbar_Main', 'MyButton', 'tooltip', 'One fine button');

dom.setShowToolbarIconLabels()


BeschreibungDiese Funktion weist Dreamweaver an, die Beschriftungen von Schaltflächen anzuzeigen. Dreamweaver zeigt Beschrif-tungen für andere Steuerelemente als Schaltflächen immer an, sofern diese Beschriftungen definiert wurden.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert: true, um die Beschriftungen für Schaltflächen anzuzeigen, andernfalls false.

RückgabewerteKeine


170

BeispielIm folgenden Beispiel wird Dreamweaver angewiesen, die Beschriftungen für die Schaltflächen auf den Symbolleisten anzuzeigen:

dom.setShowToolbarIconLabels(true);

dom.setToolbarPosition()


BeschreibungDiese Funktion verschiebt die angegebene Symbolleiste an die angegebene Position.

Hinweis: Die aktuelle Position einer Symbolleiste kann nicht bestimmt werden.

Argumentetoobar_id, position, relative_to


• Das Argument position gibt an, an welcher Stelle Dreamweaver die Symbolleiste im Verhältnis zu anderen Symbol-leisten positionieren soll. Die möglichen Werte für position sind in der folgenden Liste beschrieben:

• top ist die Standardposition. Die Symbolleiste wird oberhalb des Dokumentfensters angezeigt.

• below bewirkt die Anzeige der Symbolleiste am Anfang der Zeile, unmittelbar unterhalb der durch relative_to angege-benen Symbolleiste. Dreamweaver gibt eine Fehlermeldung aus, wenn die durch relative_to angegebene Symbolleiste nicht gefunden wurde.

• floating bewirkt, dass die Symbolleiste über dem Dokument schwebt. Dreamweaver fügt die Symbolleiste automatisch versetzt zu anderen schwebenden Symbolleisten an. Auf dem Macintosh wird floating ebenso wie top interpretiert.

• relative_to="toolbar_id" ist erforderlich, wenn position den Wert below hat. Andernfalls wird der Parameter ignoriert. Gibt die ID der Symbolleiste an, unterhalb der diese Symbolleiste positioniert werden soll.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird die myEditbar-Symbolleiste unterhalb der myPicturebar-Symbolleiste positioniert:

dom.setToolbarPosition("myEditbar", "below", "myPicturebar");

dom.setToolbarVisibility()


BeschreibungDiese Funktion blendet die angegebene Symbolleiste ein oder aus.

Argumentetoolbar_id, bShow


• Das Argument bShow ist ein Boolescher Wert, der angibt, ob die Symbolleiste ein- oder ausgeblendet werden soll. Hat bshow den Wert true, blendet dom.setToolbarVisibility() die Symbolleiste ein. Hat bShow den Wert false, blendet dom.setToolbarVisibility() die Symbolleiste aus.


171

RückgabewerteKeine

BeispielIm folgenden Beispiel wird geprüft, ob die myEditbar-Symbolleiste im Dokumentfenster angezeigt wird. Ist dies nicht der Fall, wird sie eingeblendet:


if(dom != null && dom.getToolbarVisibility("myEditbar") == false)

{

dom.setToolbarVisibility("myEditbar", true);

{

FensterfunktionenFensterfunktionen beeinflussen das Dokumentfenster und die schwebenden Bedienfelder. Diese Funktionen können schwebende Bedienfelder ein- und ausblenden, bestimmen, welcher Bereich des Dokumentfensters aktiviert ist, und das aktive Dokument festlegen. Informationen zu Funktionen, die speziell das Bedienfeld Site betreffen, finden Sie unter „Sitefunktionen“ auf Seite 191.

Hinweis: Einige der in diesem Abschnitt aufgeführten Funktionen können nur unter Windows verwendet werden. Ob dies der Fall ist, können Sie jeweils der Beschreibung einer Funktion entnehmen.

dom.getFocus()


BeschreibungDiese Funktion bestimmt, auf welchem Teil der Anwendung sich der Fokus momentan befindet.

ArgumenteKeine

RückgabewerteEiner der folgenden Strings:

• Der String "head", wenn der Bereich HEAD aktiv ist.

• Der String "body", wenn der Bereich BODY oder NOFRAMES aktiv ist.

• Der String "frameset", wenn ein Frameset oder einer seiner Frames ausgewählt ist.

• Der String "none", wenn der Fokus sich nicht auf dem Dokument befindet (sondern beispielsweise auf dem Eigenschaf-teninspektor oder einem anderen schwebenden Bedienfeld).


172

dom.getView()


BeschreibungDiese Funktion bestimmt, welche Ansicht sichtbar ist.

ArgumenteKeine

Rückgabewerte"design", "code" oder "split", je nachdem, welche Ansicht sichtbar ist.

dom.getWindowTitle()


BeschreibungDiese Funktion ruft den Titel des Fensters ab, das das Dokument enthält.

ArgumenteKeine

RückgabewerteEin String mit dem Text, der zwischen den TITLE-Tags des Dokuments enthalten ist, bzw. kein Rückgabewert, wenn sich das Dokument nicht in einem geöffneten Fenster befindet.

dom.setView()


BeschreibungDiese Funktion blendet die Entwurfsansicht bzw. die Codeansicht ein oder aus, damit nur eine Entwurfsansicht, nur eine Codeansicht oder eine geteilte Ansicht angezeigt wird.

ArgumenteviewString

• Das Argument viewString ist die gewünschte Ansicht. Es muss sich dabei um einen der folgenden Werte handeln: "design", "code" oder "split".

RückgabewerteKeine


173

dreamweaver.bringAttentionToFloater()


BeschreibungBewegt das angegebene Bedienfeld bzw. den angegebenen Inspektor in den Vordergrund und macht den Benutzer auf dieses Bedienfeld bzw. diesen Inspektor durch Blinken aufmerksam. Diese Funktion unterscheidet sich geringfügig von dw.toggleFloater().

ArgumentefloaterName

• Das Argument floaterName ist der Name des Fensters, Bedienfelds oder Inspektors.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird das Bedienfeld Elemente geöffnet und durch Blinken hervorgehoben:

dw.bringAttentionToFloater("library");

dreamweaver.cascade()

VerfügbarkeitDreamweaver MX (nur Windows), Dreamweaver 8 (um Macintosh-Unterstützung erweitert).

BeschreibungDie Dokumentfenster werden überlappend angeordnet. Dabei wird ausgehend von der linken oberen Ecke jedes weitere Fenster etwas rechts unterhalb des vorherigen Fensters positioniert.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel werden die geöffneten Dokumente überlappend angeordnet:

dw.cascade()

dreamweaver.getActiveWindow()


BeschreibungDiese Funktion ruft das Dokument im aktiven Fenster ab.

ArgumenteKeine

RückgabewerteDas dem aktiven Fenster zugehörige Dokumentobjekt bzw., falls sich das Dokument in einem Frame befindet, das dem Frameset entsprechende Dokumentobjekt.


174

dreamweaver.getDocumentList()


BeschreibungDiese Funktion ruft eine Liste aller geöffneten Dokumente ab.

ArgumenteKeine

RückgabewerteEin Array von Dokumentobjekten, die jeweils einem geöffneten Dokumentfenster entsprechen. Wenn ein Dokument-fenster ein Frameset enthält, bezieht sich das Dokumentobjekt auf das Frameset und nicht auf den Inhalt der Frames.

dreamweaver.getFloaterVisibility()


BeschreibungDiese Funktion prüft, ob das angegebene Bedienfeld bzw. der angegebene Inspektor sichtbar ist.


• Das Argument floaterName ist der Name eines schwebenden Bedienfelds. Entspricht der Wert von floaterName nicht einem der integrierten Bedienfeldnamen, sucht Dreamweaver im Ordner Configuration\Floaters nach einer Datei mit dem Namen floaterName.htm. Hierbei steht floaterName für den Namen eines schwebenden Bedienfelds.

Die Werte von floaterName für die integrierten Dreamweaver-Bedienfelder sind in der folgenden Liste rechts neben den Bedienfeldnamen aufgeführt:

Elemente = "assets"

Verhalten = "behaviors"

Bindungen = "data bindings"

Codeinspektor = "html"

Komponenten = "server components"

CSS-Stile = "css styles"

Frames = "frames"

Verlauf = "history"

Einfügen = "objects"

Ebenen = "layers"

Bibliothek = "library"

Hyperlink-Prüfer (Ergebnisse) = "linkchecker"

Eigenschaften = "properties"

Referenz = "reference"

Berichte (Ergebnisse) = "reports"

Suche (Ergebnisse) = "search"


175

RückgabewerteEin Boolescher Wert: true, wenn das schwebende Bedienfeld sichtbar ist und sich im Vordergrund befindet, false, falls dies nicht zutrifft oder kein schwebendes Bedienfeld mit dem Namen floaterName gefunden werden kann.

dreamweaver.getFocus()


BeschreibungDiese Funktion bestimmt, auf welchem Teil der Anwendung sich der Fokus momentan befindet.

ArgumentebAllowFloaters

• Das Argument bAllowFloaters ist ein Boolescher Wert: true, damit die Funktion den Namen des schwebenden Bedien-felds zurückgibt (wenn sich der Fokus auf einem schwebenden Bedienfeld befindet), andernfalls false.


• Der String "document", wenn sich der Fokus auf dem Dokumentfenster befindet.

• Der String "site", wenn sich der Fokus auf dem Bedienfeld Site befindet.

• Der String "textView", wenn sich der Fokus auf der Textansicht befindet.

• Der String "html", wenn sich der Fokus auf dem Codeinspektor befindet.

• Der String floaterName, wenn bAllowFloaters den Wert true hat und sich der Fokus auf einem schwebenden Bedienfeld befindet. floaterName kann folgende Werte haben: "objects", "properties", "launcher", "library", "css styles", "html styles", "behaviors", "timelines", "layers", "frames", "templates" oder "history".

• (Macintosh) Der String "none", wenn weder das Bedienfeld Site noch ein Dokumentfenster geöffnet ist.

dreamweaver.getPrimaryView()


BeschreibungDiese Funktion bestimmt, welche Ansicht als primäre Ansicht im Vordergrund angezeigt wird.

ArgumenteKeine

Auswahlinspektor = "selection inspector"

Serververhalten = "server behaviors"

Site = "site"

Site-Dateien = "site files"

Sitemap - "site map"

Codefragmente = "snippets"

Browserkompatibilitätsprüfung = "bcc"

Überprüfung (Ergebnisse) = "validation"


176

Rückgabewerte Der String "design" oder "code", je nachdem, welche Ansicht angezeigt wird oder sich in einer geteilten Ansicht oben befindet.

dreamweaver.getSnapDistance()


BeschreibungDiese Funktion gibt den Abstand für die Einrastfunktion in Pixel zurück.

ArgumenteKeine

RückgabewerteEine Ganzzahl, die den Abstand für die Einrastfunktion in Pixel angibt. Der Standardwert lautet 10 Pixel; 0 bedeutet, dass die Einrastfunktion deaktiviert ist.

dreamweaver.minimizeRestoreAll()


BeschreibungDiese Funktion bewirkt, dass alle Fenster in Dreamweaver minimiert (auf Symbolgröße verkleinert) oder wiederhergestellt werden.

ArgumentebMinimize

• Das Argument bMinimize ist ein Boolescher Wert: true, um die Fenster zu minimieren; false, um die minimierten Fenster auf die volle Größe wiederherzustellen.

RückgabewerteKeine

dreamweaver.setActiveWindow()


BeschreibungDiese Funktion aktiviert das Fenster, das das angegebene Dokument enthält.

ArgumentedocumentObject, {bActivateFrame}

• Das Argument documentObject ist das Objekt am Stamm der DOM-Struktur eines Dokuments (der von dream-weaver.getDocumentDOM() zurückgegebene Wert).

• Das optionale Argument bActivateFrame ist nur gültig, wenn sich documentObject innerhalb eines Framesets befindet. Das Argument bActivateFrame ist ein Boolescher Wert: true, um den Frame, der das Dokument enthält, sowie das Fenster, das das Frameset enthält, zu aktivieren, andernfalls false.


177

RückgabewerteKeine

dreamweaver.setFloaterVisibility()


BeschreibungDiese Funktion legt fest, ob ein bestimmtes schwebendes Bedienfeld oder ein Inspektor sichtbar gemacht werden soll.

ArgumentefloaterName, bIsVisible

• Das Argument floaterName ist der Name eines schwebenden Bedienfelds. Entspricht der Wert von floaterName nicht einem der integrierten Bedienfeldnamen, sucht Dreamweaver im Ordner Configuration\Floaters nach einer Datei mit dem Namen floaterName.htm. Hierbei steht floaterName für den Namen eines schwebenden Bedienfelds. Sollte kein schwebendes Bedienfeld mit dem Namen floaterName gefunden werden, hat diese Funktion keine Auswirkung.

Die Werte von floaterName für die integrierten Dreamweaver-Bedienfelder sind in der folgenden Liste rechts neben den Bedienfeldnamen aufgeführt:

Elemente = "assets"

Verhalten = "behaviors"

Bindungen = "data sources"

Codeinspektor = "html"

Komponenten = "server components"

CSS-Stile = "css styles"

Frames = "frames"

Verlauf = "history"

HTML-Stile = "html styles"

Einfügen = "objects"

Ebenen = "layers"

Bibliothek = "library"

Hyperlink-Prüfer (Ergebnisse) = "linkchecker"

Eigenschaften = "properties"

Referenz = "reference"

Berichte (Ergebnisse) = "reports"

Suche (Ergebnisse) = "search"

Serververhalten = "server behaviors"

Site = "site"

Site-Dateien = "site files"

Sitemap = "site map"

Codefragmente = "snippets"

Tag-Inspektor = "tag inspector"


178

Das Argument bIsVisible ist ein Boolescher Wert, der angibt, ob das schwebende Bedienfeld sichtbar gemacht werden soll.

RückgabewerteKeine

dreamweaver.setPrimaryView()


BeschreibungDiese Funktion zeigt die angegebene Ansicht oben im Dokumentfenster an.

ArgumenteviewString

• Das Argument viewString ist die Ansicht, die oben im Dokumentfenster angezeigt werden soll. Es kann sich um einen der folgenden Werte handeln: "design" oder "code".

RückgabewerteKeine

dreamweaver.setSnapDistance()


BeschreibungDiese Funktion legt den Abstand für die Einrastfunktion in Pixel fest.

ArgumentesnapDistance

• Das Argument snapDistance ist eine Ganzzahl, die den Abstand für die Einrastfunktion in Pixel angibt. Der Standardwert beträgt 10 Pixel. Geben Sie 0 an, um die Einrastfunktion zu deaktivieren.

RückgabewerteKeine

dreamweaver.showProperties()


BeschreibungDiese Funktion zeigt den Eigenschafteninspektor an und übergibt ihm den Fokus.

ArgumenteKeine

Browserkompatibilitätsprüfung = "bcc"

Vorlagen = "templates"

Überprüfung (Ergebnisse) = "validation"


179

RückgabewerteKeine

dreamweaver.tileHorizontally()


BeschreibungOrdnet die Dokumentfenster untereinander an, wobei die einzelnen Fenster aneinander grenzen, ohne dass sich die Dokumente überlappen. Dieser Vorgang entspricht einer vertikalen Aufteilung des Arbeitsbereichs.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel werden die geöffneten Dokumente untereinander angeordnet:

dw.tileHorizontally()

dreamweaver.tileVertically()


BeschreibungOrdnet die Dokumentfenster nebeneinander an, wobei die einzelnen Fenster aneinander grenzen, ohne dass sich die Dokumente überlappen. Dieser Vorgang entspricht einer horizontalen Aufteilung des Arbeitsbereichs.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel werden die geöffneten Dokumente nebeneinander angeordnet:

dw.tileVertically()

dreamweaver.toggleFloater()


BeschreibungDiese Funktion bewirkt, dass das angegebene schwebende Bedienfeld bzw. der Inspektor eingeblendet, ausgeblendet oder in den Vordergrund gestellt wird.

Hinweis: Diese Funktion hat nur in der Datei menus.xml Bedeutung. Um schwebende Bedienfelder anzuzeigen, in den Vorder-grund zu stellen oder auszublenden, verwenden Sie dw.setFloaterVisibility().


180


• Das Argument floaterName ist der Name des Fensters. Wenn der Name des schwebenden Bedienfelds reference lautet, kann der Status sichtbar/unsichtbar des Bedienfelds Referenz durch die Auswahl aktualisiert werden, die der Benutzer in der Codeansicht vornimmt. Für alle anderen Bedienfelder wird die Auswahl stets protokolliert. Bei dem Bedienfeld Referenz wird die Auswahl in der Codeansicht jedoch nur protokolliert, wenn der Benutzer diese Funktion explizit aufruft.

RückgabewerteKeine

dreamweaver.updateReference()


BeschreibungDiese Funktion aktualisiert das schwebende Bedienfeld Referenz. Wenn das schwebende Bedienfeld Referenz nicht sichtbar ist, wird es durch dw.updateReference() angezeigt und aktualisiert.

ArgumenteKeine

RückgabewerteKeine

Funktionen für das Ausblenden von CodeFunktionen für das Ausblenden von Code erlauben Ihnen, den Code visuell aus- und einzublenden. Sie können eine beliebige Codeauswahl oder Fragmente zwischen öffnenden und schließenden Tags aus- oder einblenden. Zwar sind diese Funktionen sowohl im DOM- als auch im HTML-Inspektor verfügbar, doch sind die ausgeblendeten Bereiche in der Codeansicht und im Code-Inspektor dieselben.

dom.collapseFullTag()


BeschreibungDiese Funktion bestimmt, ob die Auswahl in der Codeansicht sich gänzlich innerhalb eines einzigen Start-End-Tag-Paars befindet oder ein einziges Paar an Start- und End-Tags enthält. Ist das der Fall, wird das Codefragment ausgeblendet, das direkt vor dem Start-Tag beginnt und hinter dem End-Tag endet. Andernfalls hat die Funktion keine Auswirkung.

ArgumenteallowCodeFragmentAdjustment

• Das Argument allowCodeFragmentAdjustment ist ein obligatorischer Boolescher Wert. Wenn true, hat dieses Argument momentan keine Auswirkung bzw. dieselbe Auswirkung wie der Wert false. Wenn false, blendet Dreamweaver den Code aus, der unmittelbar vor dem öffnenden Tag beginnt und unmittelbar hinter dem schließenden Tag endet, und zwar ohne irgendwelche Veränderungen.

RückgabewerteKeine


181

BeispielIm folgenden Beispiel wird das Codefragment in der aktuellen Auswahl der Codeansicht ausgeblendet, das direkt vor dem Start-Tag beginnt und nach dem End-Tag endet:

var currentDOM = dw.getDocumentDOM();

currentDOM.collapseFullTag(false);

dom.collapseFullTagInverse()


BeschreibungDiese Funktion bestimmt, ob die Auswahl in der Codeansicht sich gänzlich innerhalb eines einzigen Start-End-Tag-Paars befindet oder ein einziges Paar an Start- und End-Tags enthält. Ist das der Fall, wird der Code vor dem Start-Tag und hinter dem End-Tag ausgeblendet. Andernfalls hat die Funktion keine Auswirkung.

ArgumenteallowAdjustmentOfCodeFragments

• Das Argument allowAdjustmentOfCodeFragments ist ein obligatorischer Boolescher Wert. Wenn true, passt Dream-weaver die Begrenzungen des Codes vor dem Start-Tag und hinter dem End-Tag an, um eine intelligente Ausblendung durchzuführen, d. h., aktuelle Einzüge und Leerräume bleiben erhalten. Wenn false, blendet Dreamweaver die Codefragmente vor dem öffnenden Tag und hinter dem schließenden Tag aus, genau wie von der Auswahl angezeigt.

RückgabewerteKeine

BeispielIm folgenden Beispiel werden die Begrenzungen des Codes vor dem Start-Tag und hinter dem End-Tag angepasst, um eine intelligente Ausblendung durchzuführen, bei der die Einzüge und Leerräume erhalten bleiben:


currentDOM.collapseFullTagInverse(true);

dom.collapseSelectedCodeFragment()


BeschreibungDiese Funktion blendet den in der Codeansicht ausgewählten Code aus. Ist die Auswahl bereits ausgeblendet, hat diese Funktion keine Auswirkung.


• Das Argument allowCodeFragmentAdjustment ist ein obligatorischer Boolescher Wert. Wenn true, ändert Dream-weaver die Begrenzungen der aktuellen Auswahl, um eine intelligente Ausblendung durchzuführen, d. h., aktuelle Einzüge und Leerräume bleiben erhalten. Wenn false, blendet Dreamweaver das aktuell ausgewählte Codefragment wie in der Auswahl angezeigt aus.

RückgabewerteKeine


182

BeispielIm folgenden Beispiel wird das ausgewählte Codefragment ohne Änderung in der Codeansicht ausgeblendet.


currentDOM.collapseSelectedCodeFragment(false);

dom.collapseSelectedCodeFragmentInverse()


BeschreibungDiese Funktion blendet den gesamten Code vor und hinter dem in der Codeansicht ausgewählten Code aus.


• Das Argument allowAdjustmentOfCodeFragments ist ein obligatorischer Boolescher Wert. Wenn true, passt Dream-weaver die Begrenzungen des Codes vor und hinter der aktuellen Auswahl an, um eine intelligente Ausblendung durch-zuführen, d. h., aktuelle Einzüge und Leerräume bleiben erhalten. Wenn false, blendet Dreamweaver die Codefragmente wie in der Auswahl angezeigt aus.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der gesamte Code vor und hinter dem in der Codeansicht ausgewählten Code angepasst und dann ausgeblendet.


currentDOM.collapseSelectedCodeFragmentInverse(true);

dom.expandAllCodeFragments()


BeschreibungDiese Funktion blendet alle in der Codeansicht ausgeblendeten Codefragmente wieder ein, einschließlich verschachtelter ausgeblendeter Codefragmente.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der gesamte in der Codeansicht ausgeblendete Code wieder eingeblendet:


currentDOM.expandAllCodeFragments();


183

dom.expandSelectedCodeFragments()


BeschreibungDiese Funktion blendet alle in der Codeansicht ausgeblendeten Codefragmente innerhalb der aktuellen Auswahl wieder ein. Umfasst die Auswahl keine Ausblendungen, hat diese Funktion keine Auswirkung.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der gesamte ausgeblendete Code in der aktuellen Auswahl in der Codeansicht wieder einge-blendet:


currentDOM.expandSelectedCodeFragments();

dreamweaver.htmlInspector.collapseFullTag()


BeschreibungDiese Funktion bestimmt, ob die Auswahl im Codeinspektor sich gänzlich innerhalb eines einzigen Start-End-Tag-Paars befindet oder ein einziges Paar an Start- und End-Tags enthält. Ist das der Fall, wird das Codefragment ausgeblendet, das direkt vor dem Start-Tag beginnt und hinter dem End-Tag endet. Andernfalls hat die Funktion keine Auswirkung.

ArgumenteallowACodeFragmentAdjustment

• Das Argument allowCodeFragmentAdjustment ist ein obligatorischer Boolescher Wert. Wenn true, hat dieses Argument momentan keine Auswirkung bzw. dieselbe Auswirkung wie der Wert false. Wenn false, blendet Dreamweaver den Code aus, der unmittelbar vor dem öffnenden Tag beginnt und unmittelbar hinter dem schließenden Tag endet, und zwar ohne irgendwelche Veränderungen.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird das Codefragment in der aktuellen Auswahl des Codeinspektors ausgeblendet, das direkt vor dem Start-Tag beginnt und nach dem End-Tag endet:

dreamweaver.htmlInspector.collapseFullTag(false);


184

dreamweaver.htmlInspector.collapseFullTagInverse()


BeschreibungDiese Funktion bestimmt, ob die Auswahl im Codeinspektor sich gänzlich innerhalb eines einzigen Start-End-Tag-Paars befindet oder ein einziges Paar an Start- und End-Tags enthält. Ist das der Fall, wird der Code vor dem Start-Tag und hinter dem End-Tag ausgeblendet. Andernfalls hat die Funktion keine Auswirkung.


• Das Argument allowAdjustmentOfCodeFragments ist ein obligatorischer Boolescher Wert. Wenn true, passt Dream-weaver die Begrenzungen des Codes vor dem Start-Tag und hinter dem End-Tag an, um eine intelligente Ausblendung durchzuführen, d. h., vorhandene Einzüge und Leerräume bleiben erhalten. Wenn false, blendet Dreamweaver den Code vor dem öffnenden Tag und hinter dem schließenden Tag aus, und zwar ohne irgendwelche Veränderungen.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird auf die Codeabschnitte vor dem Start- und hinter dem End-Tag der aktuellen Auswahl eine intelligente Ausblendung angewendet:

dreamweaver.htmlInspector.collapseFullTagInverse(true);

dreamweaver.htmlInspector.collapseSelectedCodeFragment()


BeschreibungDiese Funktion blendet den im Codeinspektor ausgewählten Code aus. Ist die Auswahl bereits ausgeblendet, hat diese Funktion keine Auswirkung.


• Das Argument allowCodeFragmentAdjustment ist ein obligatorischer Boolescher Wert. Wenn true, ändert Dream-weaver die Begrenzungen der aktuellen Auswahl, um eine intelligente Ausblendung durchzuführen, d. h., vorhandene Einzüge und Leerräume bleiben erhalten. Wenn false, blendet Dreamweaver das aktuell ausgewählte Codefragment wie in der Auswahl angezeigt aus.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der im Codeinspektor ausgewählte Code angepasst und ausgeblendet:

dreamweaver.htmlInspector.collapseSelectedCodeFragment(true);


185

dreamweaver.htmlInspector.collapseSelectedCodeFragmentInverse()


BeschreibungDiese Funktion blendet den gesamten Code vor und hinter dem im Codeinspektor ausgewählten Code aus. Ist die Auswahl bereits ausgeblendet, hat diese Funktion keine Auswirkung.


• Das Argument allowAdjustmentOfCodeFragments ist ein obligatorischer Boolescher Wert. Wenn true, passt Dream-weaver die Begrenzungen der Codeabschnitte vor und hinter der aktuellen Auswahl an, um eine intelligente Ausblendung durchzuführen, d. h., aktuelle Einzüge und Leerräume bleiben erhalten. Wenn false, blendet Dreamweaver die Codeab-schnitte wie in der Auswahl angezeigt aus.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der gesamte Code vor und hinter dem im Codeinspektor ausgewählten Code ausgeblendet, genau wie in der Auswahl angezeigt:

dreamweaver.htmlInspector.collapseSelectedCodeFragmentInverse(false);

dreamweaver.htmlInspector.expandAllCodeFragments()


BeschreibungDiese Funktion blendet alle im Codeinspektor ausgeblendeten Codefragmente wieder ein, einschließlich verschachtelter ausgeblendeter Codefragmente.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der gesamte im Codeinspektor ausgeblendete Code wieder eingeblendet:

dreamweaver.htmlInspector.expandAllCodeFragments();

dreamweaver.htmlInspector.expandSelectedCodeFragments()


BeschreibungDiese Funktion blendet alle innerhalb der aktuellen Auswahl im Codeinspektor ausgeblendeten Codefragmente wieder ein. Umfasst die Auswahl keine Ausblendungen, hat diese Funktion keine Auswirkung.


186

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird der gesamte ausgeblendete Code in der aktuellen Auswahl im Codeinspektor wieder einge-blendet:

dreamweaver.htmlInspector.expandSelectedCodeFragments();

Symbolleistenfunktionen der CodeansichtMithilfe der Symbolleistenfunktionen der Codeansicht können Sie Text einfügen, Kommentare entfernen, Sonderzeichen für Leerräume anzeigen oder verbergen und den Pfad des aktuellen Dokuments abrufen.

Hinweis: Es gibt zwei verschiedene Code-Symbolleisten: eine für die Codeansicht und eine für den Codeinspektor. Beide werden in der Datei Configuration/Toolbars/toolbars.xml angepasst.

dom.getOpenPathName()


BeschreibungDiese Funktion ruft den absoluten Dateipfad des geöffneten Dokuments ab.

ArgumenteKeine

RückgabewerteEin String, der den absoluten Dateipfad des geöffneten Dokuments beschreibt.

BeispielIm folgenden Beispiel wird der String mit dem Pfad des gerade geöffneten Dokuments der Variable fileName zugewiesen:

var fileName = dom.getOpenPathName();

dom.getShowHiddenCharacters()


BeschreibungDiese Funktion bestimmt, ob in der Codeansicht des Dokumentfensters die Sonderzeichen für Leerräume angezeigt werden.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die verborgenen Zeichen angezeigt werden, andernfalls false.

187

BeispielIm folgenden Beispiel wird die Anzeige der Leerraum-Sonderzeichen deaktiviert, wenn die Anzeige ursprünglich aktiviert war.


if (currentDOM.getShowHiddenCharacters()){

currentDOM.setShowHiddenCharacters(false);

}

dom.setShowHiddenCharacters()


BeschreibungDiese Funktion zeigt im Codeinspektor die Sonderzeichen für Leerräume an bzw. verbirgt sie.

Ein Beispiel finden Sie unter „dom.getShowHiddenCharacters()“ auf Seite 186.

ArgumenteEinblenden

• Das obligatorische Argument show ist ein Boolescher Wert, der angibt, ob die verborgenen Zeichen angezeigt werden sollen.

RückgabewerteKeine

dom.source.applyComment()


BeschreibungDiese Funktion fügt den im Argument beforeText angegebenen Text vor der aktuellen Auswahl ein und den im Argument afterText angegebenen Text hinter der aktuellen Auswahl. Die Funktion erweitert dann die aktuelle Auswahl um den hinzugefügten Text. Wurde kein Text ausgewählt, wählt die Funktion nichts aus. Ist der im Argument afterText angegebene Text null, fügt die Funktion den im Argument beforeText angegebenen Text zu Beginn jeder Zeile in der aktuellen Auswahl ein.

ArgumentebeforeText, afterText

• Das Argument beforeText ist obligatorisch. Dieses Argument beschreibt den Text, der am Anfang der Auswahl einzu-fügen ist, bzw. den Text, der am Anfang jeder Zeile in der Auswahl einzufügen ist, wenn der Wert des Arguments afterText null ist.

• Das (optionale) Argument afterText beschreibt den Text, der am Ende der Auswahl eingefügt werden soll.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird aus der aktuellen Auswahl ein HTML-Kommentar gemacht:

dw.getDocumentDOM().source.applyComment('')

188

dom.source.refreshVariableCodeHints()


BeschreibungDurchsucht die Seite erneut nach Variablen und entsprechenden Klassenzuweisungen. Mit dieser Funktion wird die Farbzustands-Engine und die Variablenliste neu erstellt.

ArgumentebSyncDoc

• Dies ist ein Boolescher Wert. Die Standardeinstellung ist false. Bei dem Wert true wird die Entwurfsansicht mit der Codeansicht synchronisiert.

RückgabewerteKeine

Beispieldom.source.refreshVariableCodeHints();

dom.source.removeComment()


BeschreibungDiese Funktion entfernt Kommentare. Wenn Sie keine Argumente angeben, werden aus der aktuellen Auswahl alle Arten von Kommentaren entfernt außer serverseitigen Includes und Dreamweaver-spezifischen Kommentaren. Bei verschach-telten Kommentaren wird nur der äußerste Kommentar entfernt. Wurde kein Text ausgewählt, wird nur der erste Zeilen-kommentar der Zeile entfernt, in der sich der Cursor befindet. Wenn Sie Argumente angeben, entfernt die Funktion nur die Kommentare, die den Werten in den Argumenten beforeText und afterText entsprechen, diese allerdings auch dann, wenn sie in anderen Arten von Kommentaren verschachtelt sind.

ArgumentebeforeText, afterText

• Das Argument beforeText ist optional. Es beschreibt den Text, der den Beginn des Kommentars kennzeichnet, der aus der Auswahl entfernt werden soll, bzw., wenn das Argument afterText den Wert null hat, die Art des Zeilenkom-mentars, der aus der aktuellen Auswahl entfernt werden soll.

• Das (optionale) Argument afterText beschreibt den Text, der das Ende des Kommentars kennzeichnet, der aus der Auswahl entfernt werden soll.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird ein HTML-Kommentar entfernt:

dw.getDocumentDOM().source.removeComment('')


189

dreamweaver.htmlInspector.getShowHiddenCharacters()


BeschreibungDiese Funktion bestimmt, ob in der Codeansicht des Codeinspektors die Sonderzeichen für Leerräume angezeigt werden.

ArgumenteKeine


BeispielIm folgenden Beispiel wird die Anzeige der Leerraum-Sonderzeichen im Codeinspektor deaktiviert, wenn die Anzeige ursprünglich aktiviert war.

if (dreamweaver.htmlinspector.getShowHiddenCharacters()){

dreamweaver.htmlinspector.setShowHiddenCharacters(false);

}

dreamweaver.htmlInspector.setShowHiddenCharacters()


BeschreibungDiese Funktion zeigt im Codeinspektor die Sonderzeichen für Leerräume an bzw. verbirgt sie.

ArgumenteEinblenden

• Das obligatorische Argument show ist ein Boolescher Wert, der angibt, ob die verborgenen Leerraumzeichen angezeigt werden sollen.


BeispielWeitere Informationen finden Sie unter „dreamweaver.htmlInspector.getShowHiddenCharacters()“ auf Seite 189.


190

191

Kapitel 13: Site

Site-Funktionen von Adobe® Dreamweaver® CS3 führen Operationen durch, die zur Verwaltung einer Website dienen. Zu diesen Operationen gehören das Anpassen von Berichten, das Definieren einer neuen Site, das Ein- und Auschecken von Dateien, das Ausführen einer Site-Prüfung usw.


• „Berichtfunktionen“ auf Seite 191

• „Sitefunktionen“ auf Seite 191

BerichtfunktionenDie Berichtfunktionen ermöglichen den Zugriff auf die Berichtfunktionalität, sodass Sie die Berichtvorgänge einleiten, überwachen und anpassen können. Weitere Informationen finden Sie unter „Berichte“ in der Hilfe Dreamweaver erweitern.

dreamweaver.isReporting()


BeschreibungÜberprüft, ob derzeit ein Berichtvorgang ausgeführt wird.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn ein Prozess ausgeführt wird, andernfalls false.

dreamweaver.showReportsDialog()


BeschreibungÖffnet das Dialogfeld Berichte.

ArgumenteKeine

RückgabewerteKeine

SitefunktionenSitefunktionen beziehen sich auf Dateien in der Ansicht Site-Dateien und in der Ansicht Sitemap. Mit diesen Funktionen können Sie folgende Aufgaben durchführen:

• Hyperlinks zwischen Dateien erstellen


192

• Dateien abrufen, bereitstellen, einchecken und auschecken

• Dateien auswählen und die Auswahl von Dateien aufheben

• Dateien erstellen und entfernen

• Informationen über die vom Benutzer definierten Sites abrufen

• Site-Informationen importieren und exportieren

dom.getSiteURLPrefixFromDoc()


BeschreibungDiese Funktion ruft das Site-URL-Präfix ab, das aus der HTTP-Adresse extrahiert worden ist. Die HTTP-Adresse wird im Dialogfeld Site-Definition in der Kategorie Lokale Infos definiert.

ArgumenteKeine

RückgabewerteEin String, der das Site-URL-Präfix beschreibt.

BeispielIm folgenden Beispiel wird das Site-URL-Präfix des aktuellen Dokuments abgerufen:


var sitePrefix = dom.getSiteURLPrefixFromDoc();

dom.localPathToSiteRelative()


BeschreibungDiese Funktion konvertiert einen lokalen Dateipfad in eine site-relative URI-Referenz.

ArgumentelocalFilePath

• Das obligatorische Attribut localFilePath ist ein String, der den Pfad zu einer lokalen Datei auf Ihrem lokalen Computer beschreibt.

RückgabewerteEin String, der den site-relativen URI beschreibt.

BeispielIm folgenden Beispiel wird "/myWebApp/myFile.cfm" zurückgegeben. Der Pfad basiert auf Ihren Site- Zuordnungen und der HTTP-Adresse, die im Dialogfeld Site-Definition im Register Erweitert in der Kategorie Lokale Infos angegeben wurde.

var siteRelativeURI = site.localPathToSiteRelative("C:\Inetpub\wwwroot\siteA\myFile.cfm")

dom.siteRelativeToLocalPath()



193

BeschreibungDiese Funktion konvertiert eine site-relative URI-Referenz in einen lokalen Dateipfad.

ArgumentesiteRelativeURI

• Das obligatorische Attribut siteRelativeURI ist ein String, der den site-relativen URI enthält.

RückgabewerteEin String, der den Pfad zu einer lokalen Datei auf Ihrem lokalen Computer angibt.

BeispielIm folgenden Beispiel

var filePath = siteRelativeToLocalPath("/myWebApp/myFile.xml");

wird "C:\Inetpub\wwwroot\siteA\myFile.xml" zurückgegeben. Der Pfad basiert auf Ihren Site- Zuordnungen und der HTTP-Adresse, die im Dialogfeld Site-Definition in der Kategorie Lokale Infos angegeben wurde.

dreamweaver.compareFiles()


BeschreibungDiese Funktion startet die Anwendung für Dateivergleiche, die der Benutzer im Dialogfeld Voreinstellungen in der Kategorie Dateien vergleichen angegeben hat.

Argumentefile1, file2

• Das obligatorische Attribut file1 ist ein String, der den vollständigen Pfad zur ersten zu vergleichenden Datei beschreibt.

• Das obligatorische Attribut file2 ist ein String, der den vollständigen Pfad zur zweiten zu vergleichenden Datei beschreibt.

RückgabewerteKeine

BeispielIm folgenden Beispiel werden zwei Dateien, red.htm und blue.htm, verglichen:

dw.compareFiles(hc:\data\red.htm", "e:\data\blue.htm");

dreamweaver.loadSitesFromPrefs()


BeschreibungLädt die Site-Informationen für alle Sites aus der Systemregistrierung (Windows) bzw. aus der Dreamweaver-Voreinstel-lungsdatei (Macintosh) in Dreamweaver. Wenn diese Funktion aufgerufen wird, während die Site mit einem Remote-Server verbunden ist, wird diese Verbindung automatisch unterbrochen.

ArgumenteKeine


194

RückgabewerteKeine

dreamweaver.saveSitesToPrefs()


BeschreibungSpeichert alle Informationen über die vom Benutzer definierten Sites in der Systemregistrierung (Windows) bzw. in der Dreamweaver-Voreinstellungsdatei (Macintosh).

ArgumenteKeine

RückgabewerteKeine

dreamweaver.siteSyncDialog.compare()


BeschreibungDiese Funktion führt die Anwendung für Dateivergleiche aus, die im Dialogfeld Voreinstellungen in der Kategorie Dateien vergleichen angegeben ist, um die auf den lokalen und Remote-Sites ausgewählten Dateien zu vergleichen.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.siteSyncDialog.canCompare()“ auf Seite 437.

dreamweaver.siteSyncDialog.markDelete()


BeschreibungDiese Funktion ändert die Aktion für die ausgewählten Elemente im Dialogfeld Site Synchronization (Site-Synchroni-sation) auf Delete (Löschen).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.siteSyncDialog.canMarkDelete()“ auf Seite 437.


195

dreamweaver.siteSyncDialog.markGet()


BeschreibungDiese Funktion ändert die Aktion für die ausgewählten Elemente im Dialogfeld Site Synchronization (Site-Synchroni-sation) auf Get (Abrufen).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.siteSyncDialog.canMarkGet()“ auf Seite 438.

dreamweaver.siteSyncDialog.markIgnore()


BeschreibungDiese Funktion ändert die Aktion für die ausgewählten Elemente im Dialogfeld Site Synchronization (Site-Synchroni-sation) auf Ignore (Ignorieren).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.siteSyncDialog.canMarkIgnore()“ auf Seite 438.

dreamweaver.siteSyncDialog.markPut()


BeschreibungDiese Funktion ändert die Aktion für die ausgewählten Elemente im Dialogfeld Site Synchronization (Site-Synchroni-sation) auf Put (Bereitstellen).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.siteSyncDialog.canMarkPut()“ auf Seite 438.


196

dreamweaver.siteSyncDialog.markSynced()


BeschreibungDiese Funktion ändert die Aktion für die ausgewählten Elemente im Dialogfeld Site Synchronization (Site-Synchroni-sation) auf Synced (Synchronisiert).

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.siteSyncDialog.canMarkSynced()“ auf Seite 439.

dreamweaver.siteSyncDialog.toggleShowAllFiles()


BeschreibungMithilfe dieser Funktion können Sie im Vorschaufenster Site Synchronize (Site synchronisieren) anzeigen, welche Dateien auf den Remote- und lokalen Sites von Dreamweaver als gleich ermittelt wurden. Wird die Funktion aufgerufen, während das Kontrollkästchen Alle Dateien zeigen aktiviert ist, wird es deaktiviert (und umgekehrt).

ArgumenteKeine

RückgabewerteKeine

site.addLinkToExistingFile()


BeschreibungÖffnet das Dialogfeld HTML-Datei auswählen, in dem der Benutzer eine Datei auswählen kann. Danach wird ein Hyperlink vom ausgewählten Dokument zu dieser Datei erstellt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canAddLink()“ auf Seite 440.


197

site.addLinkToNewFile()


BeschreibungÖffnet das Dialogfeld Verknüpfen mit neuer Datei, in dem der Benutzer Einzelheiten zur neuen Datei angeben kann. Danach wird ein Hyperlink vom ausgewählten Dokument zu dieser Datei erstellt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canAddLink()“ auf Seite 440.

site.changeLinkSitewide()


BeschreibungÖffnet das Dialogfeld Hyperlink für ganze Site ändern.

ArgumenteKeine

RückgabewerteKeine

site.changeLink()


BeschreibungÖffnet das Dialogfeld HTML-Datei auswählen, in dem der Benutzer eine neue Datei für den Hyperlink auswählen kann.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canChangeLink()“ auf Seite 440.

site.checkIn()



198

BeschreibungCheckt die ausgewählten Dateien ein und verarbeitet abhängige Dateien auf eine der folgenden Weisen:

• Wenn der Benutzer bei den Site-Voreinstellungen die Option Aufforderung bei Bereitstellen/Einchecken aktiviert, wird das Dialogfeld Abhängige Dateien angezeigt.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Ja geklickt hat, werden die abhängigen Dateien hochgeladen, ohne dass zuvor ein Dialogfeld angezeigt wird.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Nein geklickt hat, werden die abhängigen Dateien nicht hochgeladen, und es wird auch kein Dialogfeld angezeigt.

ArgumentesiteOrURL

• Das Argument siteOrURL muss das Schlüsselwort "site" sein, damit die Funktion sich auf die Auswahl im Bedienfeld Site auswirkt, oder eine URL, wenn es sich um eine einzelne Datei handelt.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canCheckIn()“ auf Seite 440.

site.checkLinks()


BeschreibungÖffnet das Dialogfeld Hyperlink-Prüfer und überprüft die Hyperlinks in den angegebenen Dateien.

ArgumentescopeOfCheck

• Das Argument scopeOfCheck gibt den Umfang der Hyperlink-Überprüfung an. Der Wert muss entweder "document", "selection" oder "site" lauten.

RückgabewerteKeine

site.checkOut()


BeschreibungCheckt die ausgewählten Dateien aus und verarbeitet abhängige Dateien auf eine der folgenden Weisen:

• Wenn der Benutzer bei den Site-Voreinstellungen die Option Aufforderung bei Abrufen/ Auschecken aktiviert, wird das Dialogfeld Abhängige Dateien angezeigt.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Ja geklickt hat, werden die abhängigen Dateien heruntergeladen, ohne dass zuvor ein Dialogfeld angezeigt wird.


199

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Nein geklickt hat, werden die abhängigen Dateien nicht heruntergeladen, und es wird auch kein Dialogfeld angezeigt.

ArgumentesiteOrURL

• siteOrURL muss das Schlüsselwort "site" sein, damit die Funktion sich auf die Auswahl im Bedienfeld Site auswirkt, oder eine URL, wenn es sich um eine einzelne Datei handelt.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canCheckOut()“ auf Seite 441.

site.checkTargetBrowsers()


BeschreibungFührt in den ausgewählten Dateien eine Browser-Zielüberprüfung durch.

ArgumenteKeine

RückgabewerteKeine

site.cloak()


BeschreibungSchließt die aktuelle Auswahl im Bedienfeld Site oder den angegebenen Ordner mit dem Cloaking aus.

ArgumentesiteOrURL

Das Argument siteOrURL muss einen der beiden folgenden Werte enthalten:

• Das Schlüsselwort "site", das anzeigt, dass cloak() sich auf die Auswahl im Bedienfeld Site auswirken soll.

• Die URL eines bestimmten Ordners, die anzeigt, dass cloak() sich auf den angegebenen Ordner und seinen gesamten Inhalt auswirken soll.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canCloak()“ auf Seite 441.


200

site.compareFiles()


BeschreibungDiese Funktion startet das Vergleichstool für den Vergleich zweier Dateien.

Argumenteurl

Das obligatorische Argument url muss einen der beiden folgenden Werte enthalten:

• Das Schlüsselwort "site", das anzeigt, dass compare() sich auf die Auswahl im Bedienfeld Site auswirken soll.

• Die URL der lokalen Datei, die mit ihrer Remote-Version verglichen werden soll.

RückgabewerteEin Boolescher Wert: true bei einem erfolgreichen Vergleich, andernfalls false.

EnablerWeitere Informationen finden Sie unter „site.canCompareFiles()“ auf Seite 442.

BeispielIm folgenden Beispiel werden die im Bedienfeld Site ausgewählten Dateien mit ihren Remote-Versionen verglichen:

site.compareFiles("site");

site.defineSites()


BeschreibungDiese Funktion öffnet das Dialogfeld Sites bearbeiten.

ArgumenteKeine

RückgabewerteKeine

site.deleteSelection()


BeschreibungLöscht die ausgewählten Dateien.

ArgumenteKeine

RückgabewerteKeine


201

site.deployFilesToTestingServerBin()


BeschreibungLegt eine bestimmte Datei (oder Dateien) im Ordner bin des Testservers ab. Wenn für die aktuelle Site keine Einstellungen für die Bereitstellung unterstützender Dateien definiert sind, ruft diese Funktion das Dialogfeld Unterstützende Dateien auf dem Testserver bereitstellen auf.

ArgumentefilesToDeploy

• Das Argument filesToDeploy ist ein Array von Dateinamen, die Dreamweaver bereitstellt.

RückgabewerteEin Boolescher Wert: true, wenn die Bereitstellung erfolgreich war, andernfalls false.

Beispiel In diesem Beispiel werden die Dateien image1.jpg und script1.js im Ordner bin des Testservers bereitgestellt:

site.deployFilesToTestingServerBin("image1.jpg", "script1.js");

site.displaySyncInfoForFile()

VerfügbarkeitDreamweaver CS3

BeschreibungStellt ein Dialogfeld dar, dass die lokale Zeit, die Remote-Zeit und die Testzeit der Datei entsprechend der übergebenen Parameter enthält. Diese Informationen werden in der Synchronisierungsdatei dwsync.xml gespeichert.

Das Dialogfeld zeigt vier Zeiten an:

• Die lokale Remote-Zeit, wobei es sich um den Zeitstempel der lokalen Datei für den letzten Abruf- oder Bereitstellungs-vorgang auf dem Remote-Server handelt.

• Die Remote-Zeit, wobei es sich um den Zeitstempel der Datei auf dem Remote-Server für den letzten Abruf- oder Bereit-stellungsvorgang auf dem Remote-Server handelt.

• Die lokale Testzeit, wobei es sich um den Zeitstempel der lokalen Datei für den letzten Abruf- oder Bereitstellungs-vorgang auf dem Testserver handelt.

• Die Testzeit, wobei es sich um den Zeitstempel der Datei auf dem Testserver für den letzten Abruf- oder Bereitstellungs-vorgang auf dem Testserver handelt.

Falls die Datei dwsync.xml keine Informationen zu einer Datei enthält, wird eine entsprechende Meldung angezeigt. Wenn die Zeit in der xml-Datei festgelegt wurde, wird sie im Datums-/Zeitformat der jeweiligen Gebietseinstellung angezeigt (zum Beispiel: 6/24/05 2:43pm). Wenn die Zeit im Eintrag für die Datei nicht festgelegt wurde, wird ein Bindestrich (-) angezeigt.

Diese Funktion kann für die in der lokalen Dateiansicht ausgewählte Datei verwendet werden, falls 'site' übergeben wird, oder für die Datei, die der lokalen URL entspricht, falls eine URL übergeben wird.

Argumentepath, 'site'

• path ist die URL zu einer lokalen Datei.

• 'site' gibt an, dass die Funktion die im Bedienfeld Site ausgewählte Datei verwendet.


202

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canDisplaySyncInfoForFile()“ auf Seite 442.

site.editColumns()

BeschreibungDiese Funktion zeigt das Dialogfeld Sites bearbeiten an, das den Abschnitt Dateiansichtspalten enthält.

ArgumenteKeine

RückgabewerteKeine

site.exportSite()


BeschreibungExportiert eine Dreamweaver-Site in eine XML-Datei, die dann in eine andere Dreamweaver-Instanz importiert werden kann, um die Site zu duplizieren.

Alle Informationen im Dialogfeld Site-Definition werden in der XML-Datei gespeichert. Die XML-Datei enthält auch die Liste der mit dem Cloaking ausgeschlossenen Ordner sowie Informationen über den Standarddokumenttyp. Wenn der FTP-Zugriff festgelegt wurde, können der Anmeldename und das Kennwort des Benutzers jedoch weggelassen werden.

ArgumentesiteName

• Das Argument siteName identifiziert die zu exportierende Site. Wenn siteName ein leerer String ist, exportiert Dream-weaver die aktuelle Site.

RückgabewerteEin Boolescher Wert: true, wenn die angegebene Site vorhanden ist und die XML-Datei erfolgreich exportiert wurde, andernfalls false.

BeispielIm folgenden Beispiel wird eine XML-Musterdatei dargestellt, die Dreamweaver erstellt, wenn Sie eine Site exportieren.

<?xml version="1.0" ?>

<site>

<localinfo

sitename="DW00"

localroot="C:\Documents and Settings\jlondon\Desktop\DWServer\"

imagefolder="C:\Documents and Settings\jlondon\Desktop\DWServer\Images\"

spacerfilepath=""

refreshlocal="TRUE"

cache="FALSE"

httpaddress="http://" curserver="webserver" />

<remoteinfo

accesstype="ftp"

host="dreamweaver"

remoteroot="kojak/"

user="dream"

checkoutname="Jay"


203

emailaddress="[email protected]"

usefirewall="FALSE"

usepasv="TRUE"

enablecheckin="TRUE"

checkoutwhenopen="TRUE" />

<designnotes

usedesignnotes="TRUE"

sharedesignnotes="TRUE" />

<sitemap

homepage="C:\Documents and Settings\jlondon\Desktop\DWServer\Untitled-2.htm"

pagesperrow="200" columnwidth="125" showdependentfiles="TRUE"

showpagetitles="FALSE" showhiddenfiles="TRUE" />

<fileviewcolumns sharecolumns="TRUE">

<column name="Local Folder"

align="left" show="TRUE" share="FALSE" builtin="TRUE"

localwidth="180" remotewidth="180" />

<column name="Notes"

align="center" show="TRUE" share="FALSE" builtin="TRUE"


<column name="Size"

align="right" show="TRUE" share="FALSE" builtin="TRUE"

localwidth="-2" remotewidth="-2" />

<column name="Type"



<column name="Modified"



<column name="Checked Out By"



<column name="Status" note="status"

align="left" show="TRUE" share="FALSE" builtin="FALSE"


</fileviewcolumns>

<appserverinfo

servermodel="ColdFusion"

urlprefix="http://dreamweaver/kojak/"

serverscripting="CFML"

serverpageext=""

connectionsmigrated="TRUE"

useUD4andUD5pages="TRUE"

defaultdoctype=""

accesstype="ftp"

host="dreamweaver"

remoteroot="kojak/"

user="dream"

usefirewall="FALSE"

usepasv="TRUE" />

<cloaking enabled="TRUE" patterns="TRUE">

<cloakedfolder folder="databases/" />

<cloakedpattern pattern=".png" />

<cloakedpattern pattern=".jpg" />

<cloakedpattern pattern=".jpeg" />

</cloaking>

</site>

site.findLinkSource()



204

BeschreibungÖffnet die Datei, die den ausgewählten Hyperlink bzw. die abhängige Datei enthält, und markiert darin den Text des Hyper-links bzw. die Referenz zu der abhängigen Datei. Diese Funktion kann nur auf Dateien in der Ansicht Sitemap angewendet werden.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canFindLinkSource()“ auf Seite 442.

site.get()


BeschreibungRuft die angegebenen Dateien ab und verarbeitet abhängige Dateien auf eine der folgenden Weisen:

• Wenn der Benutzer bei den Site-Voreinstellungen die Option Aufforderung bei Abrufen/Auschecken aktiviert, wird das Dialogfeld Abhängige Dateien angezeigt.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Ja geklickt hat, werden die abhängigen Dateien heruntergeladen, ohne dass zuvor ein Dialogfeld angezeigt wird.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Nein geklickt hat, werden die abhängigen Dateien nicht heruntergeladen, und es wird auch kein Dialogfeld angezeigt.

ArgumentesiteOrURL


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canGet()“ auf Seite 443.

site.getAppServerAccessType()


BeschreibungGibt die Zugriffsmethode zurück, die für alle Dateien auf dem Anwendungsserver der aktuellen Site verwendet wird. Die Site, zu der das derzeit aktive Dokument gehört, ist die aktuelle Site. Wenn kein Dokument aktiv ist, wird die Site verwendet, die Sie in Dreamweaver geöffnet haben.

Hinweis: ColdFusion Component Explorer verwendet diese Funktion. Siehe „site.getAppServerPathToFiles()“ auf Seite 205 und „site.getLocalPathToFiles()“ auf Seite 208.


205

ArgumenteKeine


• "none"

• "local/network"

• "ftp"

• "source_control"

site.getAppServerPathToFiles()


BeschreibungBestimmt den Pfad der Remote-Dateien auf dem Anwendungsserver, der für die aktuelle Site definiert ist. Die Site, zu der das derzeit aktive Dokument gehört, ist die aktuelle Site. Wenn kein Dokument aktiv ist, wird die Site verwendet, die Sie in Dreamweaver geöffnet haben.

Hinweis: ColdFusion Component Explorer verwendet diese Funktion. Siehe „site.getAppServerAccessType()“ auf Seite 204 und „site.getLocalPathToFiles()“ auf Seite 208.

ArgumenteKeine

RückgabewerteWenn für die Dateien auf dem Anwendungsserver der Zugriffstyp local/network gilt, gibt diese Funktion einen Pfad zurück. Andernfalls gibt sie einen leeren String zurück.

site.getAppURLPrefixForSite()


BeschreibungDiese Funktion ruft den Wert des URL-Präfixes ab, das aus der HTTP-Adresse extrahiert worden ist. Die HTTP-Adresse wird im Dialogfeld Site-Definition im Abschnitt Lokale Infos definiert. Dieser Wert entspricht dem Pfad hinter http://hostname:portnumber/.

Argumente{ siteName }

Das optionale Argument siteName ist der Name der Site, deren URL-Präfix sie abrufen wollen. Wenn Sie keine Verbindung angeben, ruft die Funktion das URL-Präfix der aktuellen Site ab.

RückgabewerteEin String, der das URL-Präfix der aktuell ausgewählten Site enthält.

Beispielvar sitePrefix = site.getAppURLPrefixForSite();


206

site.getCheckOutUser()


BeschreibungRuft den Anmelde- und Auschecknamen ab, der zur aktuellen Site gehört.

ArgumenteKeine

RückgabewerteEin String mit einem Anmelde- und Auschecknamen, falls definiert, oder ein leerer String, wenn das Ein-/Auschecken deaktiviert ist.

BeispielBeim Aufruf von site.getCheckOutUser() kann beispielsweise "denise (deniseNotebook)" zurückgegeben werden. Wenn kein Auscheckname festgelegt ist, wird nur der Anmeldename zurückgegeben (beispielsweise "denise").

site.getCheckOutUserForFile()


BeschreibungRuft den Anmelde- und Auschecknamen des Benutzers ab, der die angegebene Datei ausgecheckt hat.

ArgumentefileName

• Das Argument fileName ist der Pfad der abgefragten Datei, ausgedrückt im URL-Format „file://“.

RückgabewerteEin String mit dem Anmelde- und Auschecknamen des Benutzers, der die Datei ausgecheckt hat, oder ein leerer String, wenn die Datei nicht ausgecheckt ist.

BeispielBeim Aufruf von site.getCheckOutUserForFile("file://C:/sites/avocado8/index.html") könnte beispielsweise "denise (deniseLaptop)" zurückgegeben werden. Wenn kein Auscheckname festgelegt ist, wird nur der Anmeldename zurückgegeben (beispielsweise "denise").

site.getCloakingEnabled()


BeschreibungBestimmt, ob das Cloaking für die aktuelle Site aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Cloaking für die aktuelle Site aktiviert ist, andernfalls false.


207

site.getConnectionState()


BeschreibungRuft den aktuellen Verbindungsstatus ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob eine Verbindung zur Remote-Site besteht.

EnablerWeitere Informationen finden Sie unter „site.canConnect()“ auf Seite 442.

site.getCurrentSite()


BeschreibungRuft die aktuelle Site ab.

ArgumenteKeine

RückgabewerteEin String, der den Namen der aktuellen Site enthält.

BeispielWenn Sie mehrere Sites definiert haben, wird beim Aufruf von site.getCurrentSite() diejenige zurückgegeben, die im Bedienfeld Site in der Liste der aktuellen Sites angezeigt wird.

site.getFocus()


BeschreibungBestimmt, welcher Bereich des Bedienfelds Site sich gerade im Fokus befindet.

ArgumenteKeine

Rückgabewerte Einer der folgenden Strings:

• "local"

• "remote"

• "site map"


208

site.getLinkVisibility()


BeschreibungÜberprüft, ob alle in der Sitemap ausgewählten Hyperlinks sichtbar sind (also nicht als ausgeblendet markiert).

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn alle der ausgewählten Hyperlinks sichtbar sind, andernfalls false.

site.getLocalPathToFiles()


BeschreibungBestimmt den Pfad der lokalen Dateien, die für die aktuelle Site definiert sind. Die Site, zu der das derzeit aktive Dokument gehört, ist die aktuelle Site. Wenn kein Dokument aktiv ist, wird die Site verwendet, die Sie in Dreamweaver geöffnet haben.

Hinweis: ColdFusion Component Explorer verwendet diese Funktion. Siehe „site.getAppServerAccessType()“ auf Seite 204 und „site.getAppServerPathToFiles()“ auf Seite 205.

ArgumenteKeine

RückgabewerteDer Pfad der Dateien, die sich auf dem lokalen Computer für die aktuelle Site befinden.

site.getSelection()


BeschreibungBestimmt, welche Dateien momentan im Bedienfeld Site ausgewählt sind.

ArgumenteKeine

RückgabewerteEin Array von Strings mit den Pfaden der ausgewählten Dateien und Ordner (ausgedrückt im URL-Format „file://“) bzw. ein leeres Array, wenn keine Dateien oder Ordner ausgewählt sind.

site.getSiteForURL()


BeschreibungRuft den Namen der Site ab (falls vorhanden), die zu einer bestimmten Datei gehört.


209

ArgumentefileURL

• Das Argument fileURL ist die vollständige URL einer benannten Datei (einschließlich des Strings "file://").

RückgabewerteEin String mit dem Namen der Site (falls vorhanden), in der die angegebene Datei sich befindet. Wenn die angegebene Datei sich nicht in einer definierten Site befindet, ist der String leer.

site.getSites()


BeschreibungRuft eine Liste der definierten Sites ab.

ArgumenteKeine

RückgabewerteEin Array von Strings mit den Namen der definierten Sites bzw. ein leeres Array, wenn keine Site definiert ist.

site.getSiteURLPrefix()


BeschreibungRuft das Site-URL-Präfix ab, das aus der HTTP-Adresse im Abschnitt Lokale Infos extrahiert worden ist.

ArgumenteKeine

RückgabewerteEin String, der das Site-URL-Präfix enthält.

BeispielsitePrefix = getSiteURLPrefix();

site.importSite()


BeschreibungErstellt eine Dreamweaver-Site auf Grundlage einer XML-Datei. Wenn beim Importieren der durch das Attribut localroot des Elements <localinfo> angegebene Ordner auf dem lokalen Computer nicht vorhanden ist, fordert Dreamweaver den Benutzer zur Angabe eines anderen lokalen Stammordners auf. Dreamweaver zeigt eine entsprechende Aufforderung auch dann an, wenn es den Standardordner für Bilder sucht, der vom Attribut imagefolder des Elements <localinfo> angegeben wird.

ArgumentefileURL


210

• Das Argument fileURL ist ein String, der die URL der XML-Datei enthält. Dreamweaver verwendet diese XML-Datei, um eine neue Site zu erstellen. Wenn fileURL ein leerer String ist, fordert Dreamweaver den Benutzer auf, die zu impor-tierende XML-Datei auszuwählen.

RückgabewerteEin Boolescher Wert: true, wenn die genannte XML-Datei vorhanden ist und die Site erfolgreich erstellt wird, andernfalls false.

site.invertSelection()


BeschreibungKehrt die Auswahl in der Sitemap um.

ArgumenteKeine

RückgabewerteKeine

site.isCloaked()


BeschreibungBestimmt, ob das Cloaking für die aktuelle Auswahl im Bedienfeld Site oder für den angegebenen Ordner gilt.

ArgumentesiteOrURL

• Das Argument siteOrURL muss einen der beiden folgenden Werte enthalten:

• Das Schlüsselwort "site", das anzeigt, dass isCloaked() die Auswahl im Bedienfeld Site testen soll.

• Die URL eines bestimmten Ordners, die angibt, dass isCloaked() den angegebenen Ordner testen soll.

RückgabewerteEin Boolescher Wert: true, wenn das Cloaking für das angegebene Objekt gilt, andernfalls false.

site.locateInSite()


BeschreibungSucht die angegebenen Dateien im festgelegten Bereich des Bedienfelds Site und wählt die Dateien aus.

ArgumentelocalOrRemote, siteOrURL

• Das Argument localOrRemote muss entweder "local" oder "remote" sein.

• Das Argument siteOrURL muss das Schlüsselwort "site" sein, damit die Funktion sich auf die Auswahl im Bedienfeld Site auswirkt, oder eine URL, wenn es sich um eine einzelne Datei handelt.


211

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canLocateInSite()“ auf Seite 443.

site.makeEditable()


BeschreibungHebt den Schreibschutz bei den ausgewählten Dateien auf.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canMakeEditable()“ auf Seite 444.

site.makeNewDreamweaverFile()


BeschreibungErstellt im Bedienfeld Site eine neue Dreamweaver-Datei, und zwar im selben Ordner, in dem sich die erste ausgewählte Datei bzw. der erste ausgewählte Ordner befindet.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canMakeNewFileOrFolder()“ auf Seite 444.

site.makeNewFolder()


BeschreibungErstellt im Bedienfeld Site einen neuen Ordner, und zwar im selben Ordner, in dem sich die erste ausgewählte Datei bzw. der erste ausgewählte Ordner befindet.

ArgumenteKeine


212

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canMakeNewFileOrFolder()“ auf Seite 444.

site.newHomePage()


BeschreibungÖffnet das Dialogfeld Neue Homepage, in dem der Benutzer eine neue Homepage erstellen kann.

Hinweis: Diese Funktion kann nur auf Dateien in der Ansicht Sitemap angewendet werden.

ArgumenteKeine

RückgabewerteKeine

site.newSite()


BeschreibungÖffnet das Dialogfeld Site-Definition für eine neue, unbenannte Site.

ArgumenteKeine

RückgabewerteKeine

site.open()


BeschreibungÖffnet die Dateien, die momentan im Bedienfeld Site ausgewählt sind. Falls Ordner ausgewählt sind, werden sie in der Site-Dateienansicht erweitert dargestellt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canOpen()“ auf Seite 444.


213

site.put()


BeschreibungStellt die ausgewählten Dateien bereit und verarbeitet abhängige Dateien auf eine der folgenden Weisen:

• Wenn der Benutzer bei den Site-Voreinstellungen die Option Aufforderung bei Bereitstellen/Einchecken aktiviert, wird das Dialogfeld Abhängige Dateien angezeigt.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Ja geklickt hat, werden die abhängigen Dateien hochgeladen, ohne dass zuvor ein Dialogfeld angezeigt wird.

• Wenn der Benutzer zuvor im Dialogfeld Abhängige Dateien die Option Diese Meldung nicht mehr anzeigen aktiviert und dann auf Nein geklickt hat, werden die abhängigen Dateien nicht hochgeladen, und es wird auch kein Dialogfeld angezeigt.

ArgumentesiteOrURL


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canPut()“ auf Seite 444.

site.recreateCache()


BeschreibungErstellt den Cache für die aktuelle Site neu.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canRecreateCache()“ auf Seite 445.

site.refresh()


BeschreibungAktualisiert die Dateiliste im angegebenen Bereich des Bedienfelds Site.


214

ArgumentewhichSide

• Das Argument whichSide muss "local" oder "remote" sein. Wenn sich die Sitemap im Fokus befindet und für whichSide der Wert "local" angegeben wurde, wird die Sitemap aktualisiert.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canRefresh()“ auf Seite 445.

site.remoteIsValid()


BeschreibungBestimmt, ob die entfernte Site gültig ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob eine Remote-Site definiert ist. Falls es sich um den Servertyp Lokal/Netzwerk handelt, gibt dieser Wert auch an, ob das Laufwerk eingehängt ist.

site.removeLink()


BeschreibungEntfernt den ausgewählten Hyperlink aus dem in der Sitemap darüber befindlichen Dokument.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canRemoveLink()“ auf Seite 445.

site.renameSelection()


BeschreibungStellt den Namen der ausgewählten Datei in einem Textfeld dar, damit die Datei umbenannt werden kann. Wenn mehr als eine Datei ausgewählt ist, wirkt sich die Funktion auf die zuletzt ausgewählte Datei aus.


215

ArgumenteKeine

RückgabewerteKeine

site.runValidation()


BeschreibungFührt den Validator für die ganze Site oder nur für die hervorgehobenen Elemente aus.

ArgumenteAuswahl

• Das Argument selection gibt an, dass der Validator nur die hervorgehobenen Elemente prüfen soll. Andernfalls prüft der Validator die ganze aktuelle Site.

RückgabewerteKeine

site.saveAsImage()


BeschreibungÖffnet das Dialogfeld Speichern unter, in dem der Benutzer die Sitemap als Bild speichern kann.

ArgumentefileType

• Das Argument fileType ist der Typ des zu speichernden Bildes. Für Windows sind die zulässigen Werte "bmp" und "png", für Macintosh "pict" und "jpeg". Bei fehlendem Argument oder wenn der Wert für die verwendete Plattform ungültig ist, gilt für Windows als Standard "bmp" und für Macintosh "pict".

RückgabewerteKeine

site.selectAll()


BeschreibungWählt alle Dateien in der aktiven Ansicht aus (in den Ansichten Sitemap oder Site-Dateien).

ArgumenteKeine

RückgabewerteKeine


216

site.selectHomePage()


BeschreibungÖffnet das Dialogfeld Datei öffnen, in dem der Benutzer eine neue Homepage auswählen kann.

Hinweis: Diese Funktion kann nur auf Dateien in der Ansicht Sitemap angewendet werden.

ArgumenteKeine

RückgabewerteKeine

site.selectNewer()


BeschreibungWählt alle Dateien aus, die im angegebenen Bereich des Bedienfelds Site neuer sind.

ArgumentewhichSide

• Das Argument whichSide muss entweder "local" oder "remote" sein.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canSelectNewer()“ auf Seite 446.

site.serverActivity()


BeschreibungDiese Funktion bestimmt, ob Dreamweaver momentan mit einem Server interagiert. Da Dreamweaver jeweils nur eine Serveraktivität ausführen kann, können Sie mithilfe dieser Funktion bestimmen, ob Funktionalitäten deaktiviert werden, die eine Server-Interaktion erfordern.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der anzeigt, ob Dreamweaver gerade mit einem Server interagiert.


217

BeispielIm folgenden Beispiel, aus der Datei menus.xml , wird ein Menüelement angezeigt, wenn keine Serveraktivität vorliegt (und in Dreamweaver eine aktuelle Site angegeben ist):

<menuitem name="Remove Connection Scripts" enabled="!site.serverActivity() &&

site.getCurrentSite() != ''" command="alert(MMDB.removeConnectionScripts())"

id="SiteOptionsSiteMenu_RemoveConnectionScripts" />

site.setAsHomePage()


BeschreibungBestimmt die Datei, die in der Ansicht Site-Dateien als Homepage für die Site ausgewählt ist.

ArgumenteKeine

RückgabewerteKeine

site.setCloakingEnabled()


BeschreibungBestimmt, ob das Cloaking für die aktuelle Site aktiviert sein soll.

Argumenteenable

• Das Argument enable ist ein Boolescher Wert, der angibt, ob das Cloaking aktiviert sein soll. Der Wert true aktiviert das Cloaking für die aktuelle Site, der Wert false deaktiviert das Cloaking für die aktuelle Site.

RückgabewerteKeine

site.setConnectionState()


BeschreibungSetzt den Verbindungsstatus der aktuellen Site.

ArgumentebConnected

• Das Argument bConnected ist ein Boolescher Wert, der angibt, ob eine Verbindung zur aktuellen Site besteht (true) oder nicht (false).

RückgabewerteKeine


218

site.setCurrentSite()


BeschreibungÖffnet die angegebene Site im lokalen Bereich des Bedienfelds Site.

ArgumentewhichSite

• Das Argument whichSite ist der Name einer definierten Site (wie in der Liste der aktuellen Sites im Bedienfeld Site bzw. im Dialogfeld Sites bearbeiten angezeigt).

RückgabewerteKeine

BeispielWenn drei Sites definiert sind (zum Beispiel „avocado8“, „dreamcentral“ und „testsite“), wird beim Aufruf von site.setCurrentSite("dreamcentral"); dreamcentral zur aktuellen Site.

site.setFocus()


BeschreibungÜbergibt den Fokus an einen angegebenen Bereich im Bedienfeld Site. Wenn der betreffende Bereich nicht sichtbar war, wird er durch diese Funktion angezeigt und erhält den Fokus.

ArgumentewhichPane

• Das Argument whichPane muss einer der folgenden Strings sein: "local", "remote" oder "sitemap".

RückgabewerteKeine

site.setLayout()


BeschreibungÖffnet im Dialogfeld Sitedefinition den Bereich Sitemap-Layout.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canSetLayout()“ auf Seite 446.


219

site.setLinkVisibility()


BeschreibungBlendet den aktuellen Hyperlink ein bzw. aus.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert, der angibt, ob das Kennzeichen Versteckt vom aktuellen Hyperlink entfernt werden soll.

RückgabewerteKeine

site.setSelection()


BeschreibungWählt Dateien oder Ordner im aktiven Bereich des Bedienfelds Site aus.

ArgumentearrayOfURLs

• Das Argument arrayOfURLs ist ein Array mit Strings, die jeweils den Pfad einer Datei oder eines Ordners in der aktuellen Site angeben, ausgedrückt im URL-Format „file://“.

Hinweis: Verwenden Sie bei der Angabe von Ordnerpfaden am Ende keinen Schrägstrich (/).

RückgabewerteKeine

site.siteRelativeToLocalPath()


BeschreibungDiese Funktion konvertiert eine site-relative URI-Referenz in einen lokalen Dateipfad.

ArgumentesiteRelativeURI

• Das obligatorische Attribut siteRelativeURI ist ein String, der den site-relativen URI enthält.

RückgabewerteEin String, der den Pfad zu einer lokalen Datei auf Ihrem lokalen Computer angibt.

BeispielIm folgenden Beispiel

var filePath = site.siteRelativeToLocalPath("/myWebApp/myFile.xlml");

wird "C:\Inetpub\wwwroot\siteA\myFile.xml" zurückgegeben. Der Pfad basiert auf Ihren Site-Zuordnungen und der HTTP-Adresse, die im Dialogfeld Site-Definition in der Kategorie Lokale Infos angegeben wurde.


220

site.synchronize()


BeschreibungÖffnet das Dialogfeld Dateien synchronisieren.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canSynchronize()“ auf Seite 447.

site.uncloak()


BeschreibungHebt das Cloaking der aktuellen Auswahl im Bedienfeld Site oder des angegebenen Ordners auf.

ArgumentesiteOrURL

• Das Argument siteOrURL muss einen der folgenden Werte enthalten:

• Das Schlüsselwort "site", das anzeigt, dass unCloak() sich auf die Auswahl im Bedienfeld Site auswirken soll.

• Die URL eines bestimmten Ordners, die anzeigt, dass unCloak() sich auf den angegebenen Ordner und seinen gesamten Inhalt auswirken soll.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canUncloak()“ auf Seite 447.

site.uncloakAll()


BeschreibungHebt das Cloaking für alle Ordner in der aktuellen Site auf und deaktiviert das Kontrollkästchen Cloaking von Dateien mit Erweiterung in den Einstellungen für das Cloaking.

ArgumenteKeine

RückgabewerteKeine


221

EnablerWeitere Informationen finden Sie unter „site.canUncloak()“ auf Seite 447.

site.undoCheckOut()


BeschreibungEntfernt die zu den angegebenen Dateien gehörenden Sperrdateien aus den lokalen und entfernten Sites und ersetzt die lokalen Kopien der angegebenen Dateien durch die entfernten Kopien.

ArgumentesiteOrURL


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canUndoCheckOut()“ auf Seite 447.

site.viewAsRoot()


BeschreibungVerschiebt die ausgewählte Datei vorübergehend an die oberste Position der Sitemap.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „site.canViewAsRoot()“ auf Seite 448.


222

223

Kapitel 14: Dokument

Die Dokumentfunktionen in Adobe® Dreamweaver® CS3 führen Vorgänge durch, die sich auf das Dokument auswirken, an dem der Benutzer arbeitet. Diese Funktionen führen beispielsweise folgende Aufgaben aus: Tabellen in Ebenen konver-tieren, Befehle im Ordner Configuration\Commands ausführen, nach Datei-URLs suchen, die Rechtschreibung prüfen, Seiteneigenschaften festlegen, relative URLs in absolute konvertieren, den aktuell ausgewählte Knoten abrufen, die URL-Kodierung für einen String durchführen oder einen Übersetzer für ein Dokument ausführen.


• „Konvertierungsfunktionen“ auf Seite 223

• „Befehlsfunktionen“ auf Seite 224

• „Dateibearbeitungsfunktionen“ auf Seite 225

• „Globale Dokumentfunktionen“ auf Seite 238

• „Pfadfunktionen“ auf Seite 247

• „Auswahlfunktionen“ auf Seite 249

• „Funktionen zur Behandlung von Strings“ auf Seite 255

• „Übersetzungsfunktionen“ auf Seite 258

• „XSLT-Funktionen“ auf Seite 260

KonvertierungsfunktionenKonvertierungsfunktionen dienen dazu, Tabellen in Ebenen, Ebenen in Tabellen und CSS (Cascading Stylesheets) in HTML-Markup umzuwandeln. Diese Funktionen haben jeweils den gleichen Effekt wie die entsprechenden Konvertie-rungsbefehle im Menü Datei bzw. Modifizieren.

dom.convertLayersToTable()


BeschreibungÖffnet das Dialogfeld Ebenen in Tabelle konvertieren.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canConvertLayersToTable()“ auf Seite 417.

dom.convertTablesToLayers()



224

BeschreibungÖffnet das Dialogfeld Tabellen in Ebenen konvertieren.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canConvertTablesToLayers()“ auf Seite 417.

BefehlsfunktionenMithilfe der Befehlsfunktionen können Sie die Dateien im Ordner Configuration\Commands optimal nutzen. Sie dienen zur Verwaltung des Menüs Befehle und ermöglichen den Aufruf von Befehlen in anderen Erweiterungsdateien.

dreamweaver.editCommandList()


BeschreibungÖffnet das Dialogfeld Befehlsliste bearbeiten.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.popupCommand() (veraltet)

VerfügbarkeitDreamweaver 2, in 3 abgelöst von „dreamweaver.runCommand()“ auf Seite 225.

BeschreibungDiese Funktion führt den angegebenen Befehl aus. Für den Benutzer ist der Effekt der gleiche, als würde er den Befehl in einem Menü auswählen. Wenn mit dem Befehl ein Dialogfeld verknüpft ist, wird es angezeigt. Diese Funktion bietet die Möglichkeit, einen Befehl aus einer anderen Erweiterungsdatei aufzurufen. Andere Bearbeitungsvorgänge sind so lange gesperrt, bis der Benutzer das Dialogfeld schließt.

Hinweis: Diese Funktion kann nur in objectTag() oder einem Skript in einer Befehlsdatei oder der Eigenschafteninspektor-Datei aufgerufen werden.

ArgumentecommandFile

• Das Argument commandFile ist der Name einer Befehlsdatei im Ordner Configuration\Commands (z. B. "Format Table.htm").

RückgabewerteKeine


225

dreamweaver.runCommand()


BeschreibungFührt einen ausgewählten Befehl aus. Entspricht dem Auswählen eines Befehls aus dem Menü. Ist ein Dialogfeld mit dem Befehl verknüpft, wird dieses angezeigt. Das Befehlsskript verhindert andere Bearbeitungen, bis der Benutzer das Dialogfeld schließt. Diese Funktion bietet die Möglichkeit, einen Befehl aus einer anderen Erweiterungsdatei aufzurufen.

Hinweis: Diese Funktion kann nur in objectTag() oder einem Skript in einer Befehlsdatei oder der Eigenschafteninspektor-Datei aufgerufen werden.

ArgumentecommandFile, {commandArg1}, {commandArg2},...{commandArgN}

• Das Argument commandFile ist ein Dateiname im Ordner Configuration\Commands.

• Die anderen (optionalen) Argumente wie commandArg1, commandArg2 usw. werden an die Funktion receiveArgu-ments() im Argument commandFile übergeben.

RückgabewerteKeine

BeispielSie können beispielsweise einen benutzerdefinierten Eigenschafteninspektor für Tabellen schreiben, in dem der Benutzer über eine Schaltfläche den Befehl Tabelle formatieren wählen kann. Dazu wird von der Ereignisprozedur onClick der Schaltfläche die folgende Funktion aufgerufen:

function callFormatTable(){

dreamweaver.runCommand('Format Table.htm');

}

Dateibearbeitungsfunktionen Zu den Dateibearbeitungsfunktionen gehört das Erstellen, Öffnen und Speichern von Dokumenten (auch in den Formaten XML und XHTML), das Konvertieren bestehender HTML-Dokumente in XHTML-Dokumente sowie das Exportieren von CSS-Dokumenten in externe Dateien. Darüber hinaus können Sie nach Dateien und Ordnern suchen, Dateien nach Vorlagen erstellen, Dokumente schließen und Informationen über die zuletzt geöffneten Dateien abrufen.

dom.cleanupXHTML()


BeschreibungDiese Funktion ähnelt convertToXHTML(), optimiert aber vorhandene XHTML-Dokumente. Die Funktion kann auf eine Auswahl innerhalb des Dokuments angewendet werden. Sie können mit cleanupXHTML() die Syntax des gesamten XHTML-Dokuments optimieren oder lediglich die eines ausgewählten Dokumentabschnitts.

ArgumentebWholeDoc

• Das Argument bWholeDoc enthält einen Booleschen Wert. Ist der Wert auf true gesetzt, optimiert cleanupXHTML() das ganze Dokument, andernfalls wird nur der ausgewählte Abschnitt bearbeitet.


226

RückgabewerteEin Array von sechs Ganzzahlen, die die Anzahl der folgenden Elemente bezeichnen:

• XHTML-Fehler, die von Dreamweaver repariert wurden.

• map-Elemente ohne id-Attribut, die nicht repariert werden können.

• script-Elemente ohne type-Attribut, die nicht repariert werden können.

• style-Elemente ohne type-Attribut, die nicht repariert werden können.

• img-Elemente ohne alt-Attribut, die nicht repariert werden können.

• area-Elemente ohne alt-Attribute, die nicht repariert werden können.

dom.convertToXHTML()

VerfügbarkeitDreamweaver MX.

BeschreibungAnalysiert aus dem HTML-Code eine DOM-Struktur, fügt fehlende, für XHTML erforderliche Elemente ein, optimiert die Struktur und erstellt dann einen ihr entsprechenden neuen XHTML-Code. Zu den fehlenden Direktiven, Deklarationen, Elementen und Attributen, die convertToXHTML() ggf. in die DOM-Struktur aufnimmt, gehören folgende Elemente:

• Eine XML-Direktive

• Eine Deklaration vom Typ doctype

• Das xmlns-Attribut im html-Element

• Ein head-Abschnitt

• Ein title-Element

• Ein body-Abschnitt

Während der Konvertierung konvertiert die Funktion dom.convertToXHTML() reine HTML-Tags und -Attribute in Klein-buchstaben, schreibt HTML-Tags und -Attribute in korrekte XHTML-Syntax um und fügt fehlende HTML-Attribute dort ein, wo es möglich ist. Diese Funktion behandelt Tags und Attribute von Drittanbietern entsprechend der Einstellungen im Dialogfeld Voreinstellungen.

Ist das Dokument eine Vorlage, gibt dom.convertToXHTML() eine Meldung an den Benutzer weiter, führt aber keine Konver-tierung durch.

ArgumenteKeine

RückgabewerteEin Array von sechs Ganzzahlen, die die Anzahl der folgenden Elemente angeben:

• XHTML-Fehler, die von Dreamweaver repariert wurden.

• map-Elemente ohne id-Attribut, die nicht repariert werden können.

• script-Elemente ohne type-Attribut, die nicht repariert werden können.

• style-Elemente ohne type-Attribut, die nicht repariert werden können.

• img-Elemente ohne alt-Attribut, die nicht repariert werden können.

• area-Elemente ohne alt-Attribute, die nicht repariert werden können.


227

BeispielIn der Regel ruft eine Erweiterung zunächst dreamweaver.openDocument() oder dreamweaver.getDocumentDOM() auf, um eine Referenz zu dem Dokument zu erhalten. Die Erweiterung ruft dann dom.getIsXHTMLDocument() auf, um zu ermitteln, ob das Dokument bereits das XHTML-Format aufweist. Ist dies nicht der Fall, ruft die Erweiterung die Funktion dom.convertToXHTML() auf, um das Dokument in XHTML zu konvertieren. Abschließend ruft die Erweiterung dream-weaver.saveDocument() auf, um das konvertierte Dokument unter einem neuen Dateinamen zu speichern.

dom.getIsXHTMLDocument()


BeschreibungÜberprüft ein Dokument (im Besonderen die Deklaration <!DOCTYPE>) darauf, ob das XHTML-Format vorliegt.

ArgumenteKeine

Rückgabewertetrue für XHTML-Dokumente, andernfalls false.

dreamweaver.browseForFileURL()

VerfügbarkeitDreamweaver 1, erweitert in 2, 3 und 4.

BeschreibungÖffnet das angegebene Dialogfeld mit der entsprechenden Bezeichnung in der Titelleiste.

ArgumenteopenSelectOrSave, {titleBarLabel}, {bShowPreviewPane}, {bSupressSiteRootWarnings}, {arrayOfExtensions}

• Das Argument openSelectOrSave ist ein String, der den Dialogfeldtyp mit "open", "select" oder "save" angibt.

• titleBarLabel wurde in Dreamweaver 2 eingeführt und enthält die Bezeichnung, die in der Titelleiste des Dialogfelds angezeigt werden soll. Bei Auslassung dieses Arguments wird die Standardbezeichnung des Betriebssystems verwendet.

• bShowPreviewPane wurde in Dreamweaver 2 eingeführt. Dies ist ein Boolescher Wert, der angibt, ob die Bildvorschau im Dialogfeld angezeigt werden soll. Wenn der Wert true lautet, wird im Dialogfeld nach Bilddateien gefiltert. Falls das Argument ausgelassen wird, gilt der Standardwert false.

• bSupressSiteRootWarnings wurde in Dreamweaver 3 eingeführt. Wenn sich die ausgewählte Datei außerhalb des Site-Stamms befindet, gibt dieser Boolesche Wert an, ob entsprechende Warnungen unterdrückt werden sollen. Bei fehlendem Argument gilt false als Standardwert.

• arrayOfExtensions wurde in Dreamweaver 4 eingeführt und besteht aus einem Array von Strings, das den Standard-inhalt der Dateitypliste im unteren Bereich des Dialogfelds bestimmt. Die korrekte Syntax lautet menuEn-tryText|.xxx[;.yyy;.zzz]|CCCC|. Dabei ist menuEntryText der Name des anzuzeigenden Dateityps. Die Erweiterungen können in der Form .xxx[;.yyy;.zzz] oder CCCC angegeben werden, wobei .xxx die Erweiterung des Dateityps definiert (.yyy und .zzz können wahlweise zur Angabe mehrerer Dateinamenerweiterungen verwendet werden). CCCC ist die aus vier Buchstaben bestehende Konstante für den Dateityp beim Macintosh.

RückgabewerteEin String mit dem Dateinamen, der im URL-Format „file://“ ausgedrückt wird.


228

dreamweaver.browseForFolderURL()


BeschreibungÖffnet das Dialogfeld Ordner wählen mit der entsprechenden Bezeichnung in der Titelleiste.

Argumente{titleBarLabel}, {directoryToStartIn}

• Das Argument titleBarLabel ist die Bezeichnung, die in der Titelleiste des Dialogfelds angezeigt werden soll. Bei Auslassung wird für titleBarLabel der Text „Ordner wählen“ angezeigt.

• directoryToStartIn ist der Pfad, in dem der Ordner geöffnet werden soll (im URL-Format „file://“).

RückgabewerteEin String mit dem Ordnernamen, der im URL-Format „file://“ ausgedrückt wird.

BeispielMit dem folgenden Code wird die URL eines Ordners zurückgegeben:

return dreamweaver.browseForFolderURL('Select a Folder', ¬

dreamweaver.getSiteRoot());

dreamweaver.closeDocument()


BeschreibungSchließt das angegebene Dokument.

ArgumentedocumentObject

• Das Argument documentObject ist das Objekt am Stamm der DOM-Struktur eines Dokuments (der von dream-weaver.getDocumentDOM() zurückgegebene Wert). Wenn sich das Argument documentObject auf das aktive Dokument bezieht, wird das Dokumentfenster erst nach Beendigung des aufrufenden Skripts geschlossen.

RückgabewerteKeine

dreamweaver.createDocument()

VerfügbarkeitDreamweaver 2, erweitert in Dreamweaver 4.

BeschreibungAbhängig vom Argument, das Sie an diese Funktion weitergeben, öffnet sie ein neues Dokument entweder im gleichen oder in einem neuen Fenster. Das neue Dokument wird zum aktiven Dokument.

Hinweis: Diese Funktion kann nur von der Datei menus.xml, von einer Befehlsdatei oder einer Eigenschafteninspektor-Datei aus aufgerufen werden. Wenn eine Verhaltensaktion oder ein Objekt diese Funktion aufzurufen versucht, wird eine Fehler-meldung ausgegeben.

Argumente{bOpenInSameWindow}, {type}


229

• Das Argument bOpenInSameWindow ist ein Boolescher Wert, der angibt, ob das neue Dokument im aktuellen Fenster geöffnet werden soll. Wenn bOpenInSameWindow den Wert false hat oder ausgelassen wird oder wenn die Funktion auf einem Macintosh aufgerufen wird, wird das neue Dokument in einem eigenen Fenster geöffnet.

• Das Argument type gibt den zu erstellenden Dokumenttyp an, entsprechend dem in der Dreamweaver-Datei Configu-ration\DocumentTypes\MMDocumentTypes.xml festgelegten id-Attribut des Tags documenttype. Beispiele für type: "HTML", "ASP-JS", "ASP-VB", "ColdFusion", "CFC", "JSP", "ASP.NET_VB" usw. Eine vollständige Liste möglicher Dokumenttypen finden Sie in der Datei MMDocumentTypes.xml. Wenn Sie keinen type angeben, wird der Wert standardmäßig auf "HTML" gesetzt.

Hinweis: Sie können die MMDocumentTypes-Datei erweitern, indem Sie Ihre eigenen Dokumenttypen hinzufügen. Weitere Informationen über das Erweitern von Dokumenttypen finden Sie unter Dreamweaver erweitern.

RückgabewerteDas Dokumentobjekt für das neu erstellte Dokument. Dabei handelt es sich um den gleichen Wert, der von dream-weaver.getDocumentDOM() zurückgegeben wird.

dreamweaver.createXHTMLDocument()


BeschreibungAbhängig vom Argument, das Sie an diese Funktion weitergeben, öffnet sie das neue XHTML-Dokument entweder im gleichen oder in einem neuen Fenster. Das neue Dokument wird zum aktiven Dokument. Sie ähnelt der Funktion dream-weaver.createDocument().

Wenn Dreamweaver ein neues XHTML-Dokument erstellt, wird die Datei default.xhtml gelesen, die im Ordner Configu-ration\Templates abgelegt ist. Anhand dieser Datei wird eine Ausgabedatei mit folgenden Aufbaudeklarationen erstellt:

<?xml version="1.0">

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<title>Untitled Document

</title>

<meta http-equiv="Content-Type" content="text/html; charset=" />

</head>

<body bgcolor="#FFFFFF" text="#000000">

</body>

</html>

Die Standarddeklaration der Dokumententypdefinition (DTD) ist XHTML 1.0 Transitional, und nicht Strict. Wenn ein Benutzer ein Frameset in ein Dokument aufnimmt, wechselt Dreamweaver von DTD zu XHTML 1.0 Frameset. Content-Type ist text/html, und charset wird zunächst bewusst nicht in die Datei default.xhtml aufgenommen, wird aber hinzu-gefügt, bevor der Benutzer das neue Dokument aufruft. Die Direktive ?xml ist nicht erforderlich, wenn das Dokument mit der UTF-8- oder UTF-16-Zeichenverschlüsselung arbeitet. Wenn sie vorhanden ist, kann sie möglicherweise von älteren Browsern wiedergegeben werden. Da diese Direktive aber in einem XHTML-Dokument enthalten sein sollte, wird sie von Dreamweaver sowohl für neue als auch für konvertierte Dokumente verwendet. Benutzer können die Direktive manuell löschen. Die Direktive ?xml enthält das Verschlüsselungsattribut, das dem Argument charset im Attribut Content-Type entspricht.

Argumente{bOpenInSameWindow}


230

• Das Argument bOpenInSameWindow ist ein Boolescher Wert, der angibt, ob das neue Dokument im aktuellen Fenster geöffnet werden soll. Wenn dieses Argument den Wert false hat oder ausgelassen wird oder wenn die Funktion auf einem Macintosh aufgerufen wird, wird das neue Dokument in einem eigenen Fenster geöffnet.

RückgabewerteDas Dokumentobjekt für das neu erstellte Dokument, d. h. der gleiche Wert, der von dreamweaver.getDocumentDOM() zurückgegeben wird.

dreamweaver.createXMLDocument()


BeschreibungErstellt und öffnet eine neue XML-Datei, die nur die XML-Anweisung enthält.

ArgumenteKeine

RückgabewerteDas DOM der neuen XML-Datei.

BeispielIm nachfolgenden Beispiel wird ein neues Dokument erstellt, das lediglich die XML-Direktive enthält:

var theDOM = dreamweaver.createXMLDocument("document");

dreamweaver.exportCSS() (veraltet)


BeschreibungÖffnet das Dialogfeld Stile als CSS-Datei exportieren.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canExportCSS() (veraltet)“ auf Seite 426.

dreamweaver.exportEditableRegionsAsXML() (veraltet)

VerfügbarkeitDreamweaver 3, in MX nicht mehr empfohlen.

BeschreibungDiese Funktion öffnet das Dialogfeld Editierbare Bereiche als XML exportieren.

ArgumenteKeine


231

RückgabewerteKeine

dreamweaver.exportTemplateDataAsXML()


BeschreibungExportiert das aktuelle Dokument als XML in die angegebene Datei. Diese Funktion wirkt sich auf das Dokument aus, auf dem sich der Fokus befindet. Dieses muss eine Vorlage sein. Wenn Sie kein Dateinamenargument angeben, öffnet Dreamweaver MX ein Dialogfeld zum Anfordern des Exportdatei-Strings.

Argumente{filePath}

• Das optionale Argument filePath ist ein String, der die Datei angibt, in die Dreamweaver die Vorlage exportiert. filepath muss als URL-Dateistring ausgedrückt werden, wie z. B. "file:///c|/temp/mydata.txt".

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canExportTemplateDataAsXML()“ auf Seite 426.

Beispielif(dreamweaver.canExportTemplateDataAsXML())

{

dreamweaver.exportTemplateDataAsXML("file:///c|/dw_temps/mytemplate.txt")

}

dreamweaver.getDocumentDOM()


BeschreibungErmöglicht den Zugriff auf die Objektstruktur des angegebenen Dokuments. Nachdem die Objektstruktur an die aufru-fende Funktion zurückgegeben wurde, kann diese den Dokumentinhalt ändern.

Argumente{sourceDoc}

• Das Argument sourceDoc muss entweder "document", "parent", "parent.frames[number]", "parent.frames['frameName']" oder eine URL sein. Der Wert sourceDoc wird standardmäßig auf "document" gesetzt, wenn Sie keinen Wert angeben. Diese Argumentwerte haben folgende Bedeutung:

• "document" legt das Dokument fest, das sich im Fokus befindet und die aktuelle Auswahl enthält.

• parent legt das übergeordnete Frameset fest (wenn das aktuell ausgewählte Dokument sich in einem Frame befindet).

• parent.frames[number] und parent.frames['frameName'] legen ein Dokument in einem bestimmten Frame eines Framesets fest, der das aktuelle Dokument enthält.

• Wenn das Argument eine relative URL ist, bezieht sie sich auf die Erweiterungsdatei.

Hinweis: Wenn als Argument "document" übergeben wird, muss die aufrufende Funktion entweder applyBehavior(), deleteBehavior(), objectTag() oder eine beliebige Funktion in einer Befehls- oder Eigenschafteninspektor-Datei sein, mit der das Dokument bearbeitet werden kann.


232

RückgabewerteDas JavaScript-Dokumentobjekt am Stamm der Struktur.

BeispieleIm folgenden Beispiel wird das aktuelle Dokument mit dreamweaver.getDocumentDOM() aufgerufen:

var theDOM = dreamweaver.getDocumentDOM("document");

Im nachfolgenden Beispiel bezeichnet das DOM eine Auswahl und fügt sie am Ende eines anderen Dokuments ein.

var currentDOM = dreamweaver.getDocumentDOM('document');

currentDOM.setSelection(100,200);

currentDOM.clipCopy();

var otherDOM = dreamweaver.openDocument(dreamweaver.¬

getSiteRoot() + "html/foo.htm");

otherDOM.endOfDocument();

otherDOM.clipPaste();

Hinweis: openDocument() wird verwendet, da Methoden des Objekts DOM in der Regel nur auf geöffnete Dokumente angewendet werden können. Das Ausführen einer Funktion für ein geschlossenes Dokument ruft eine Dreamweaver-Fehler-meldung hervor. Bei Methoden des Objekts DOM, die nur auf das aktive Dokument oder auf geschlossene Dokumente angewendet werden können, wird in der jeweiligen Beschreibung auf diesen Umstand hingewiesen.

dreamweaver.getNewDocumentDOM()

VerfügbarkeitDreamweaver MX; das Argument documentType wurde in Dreamweaver 8 hinzugefügt.

BeschreibungErmöglicht den Zugriff auf bearbeitbare Struktur für ein neues, leeres Dokument. Diese Funktion ähnelt der Funktion getDocumentDOM(), außer dass sie auf ein neues Dokument statt auf ein vorhandenes verweist und das Dokument nicht öffnet.

Argumente{documentType}

• Das Argument documentType ist ein String. Sein Wert muss ein Dokumenttyp sein, der in der Datei Document-Types.xml festgelegt worden ist.

RückgabewerteVerweis auf ein neues, leeres Dokument.

BeispielDOM gibt folgenden Code für ein neues, leeres Dokument zurück:

var theDOM = dreamweaver.getNewDocumentDOM();

dreamweaver.getRecentFileList()


BeschreibungRuft eine Liste der zuletzt geöffneten Dateien ab, die im unteren Bereich des Menüs Datei angezeigt werden.

ArgumenteKeine


233

RückgabewerteEin Array von Strings, die die Pfade der zuletzt aufgerufenen Dateien darstellen. Jeder Pfad wird ausgedrückt im URL-Format „file://“. Wenn keine zuletzt geöffneten Dateien vorhanden sind, wird kein Wert zurückgegeben.

dreamweaver.importXMLIntoTemplate()


BeschreibungImportiert eine XML-Textdatei in das aktuelle Vorlagendokument. Diese Funktion wirkt sich auf das Dokument aus, auf dem sich der Fokus befindet. Dieses muss eine Vorlage sein. Wenn Sie kein Dateinamenargument angeben, öffnet Dream-weaver ein Dialogfeld zum Anfordern des Importdatei-Strings.

Argumente{filePath}

• Das optionale Argument filePath ist ein String, der die Datei angibt, in die Dreamweaver die Vorlage importiert. filepath muss als URL-Dateistring ausgedrückt werden, wie z. B. "file:///c|/temp/mydata.txt".

RückgabewerteKeine

dreamweaver.newDocument()


BeschreibungÖffnet in der aktuellen Site ein neues Dokument und ruft das Dialogfeld Neues Dokument auf.

Argumente{bopenWithCurSiteAndShowDialog}

• Das optionale Argument bopenWithCurSiteAndShowDialog hat den Wert true oder false. Geben Sie true an, um in der aktuellen Site ein neues Dokument zu öffnen und das Dialogfeld Neues Dokument aufzurufen. andernfalls verwenden Sie false.

RückgabewerteKeine

dreamweaver.newFromTemplate()


BeschreibungErstellt ein neues Dokument mit der angegebenen Vorlage. Wenn kein Argument übergeben wird, wird das Dialogfeld Vorlage auswählen eingeblendet.

Argumente{templateURL}, bMaintain

• Das Argument templateURL ist der Pfad zu einer Vorlage in der aktuellen Site, ausgedrückt im URL-Format „file://“.

• bmaintain ist ein Boolescher Wert, true oder false, der angibt, ob der Hyperlink zur ursprünglichen Vorlage beibe-halten werden soll oder nicht.


234

RückgabewerteKeine

dreamweaver.openDocument()


BeschreibungÖffnet ein Dokument zum Bearbeiten in einem neuen Dreamweaver-Fenster und verlagert den Fokus auf dieses Fenster. Für den Benutzer ist der Effekt der gleiche, als würde er den Befehl Datei > Öffnen und dann eine Datei auswählen. Wenn die betreffende Datei bereits geöffnet ist, wird das zugehörige Dokumentfenster in den Vordergrund gestellt. Dieses Fenster wird zum aktuell ausgewählten Dokument. In Dreamweaver 2 wird die Datei bei aktiviertem Einchecken/Auschecken vor dem Öffnen ausgecheckt. In Dreamweaver 3 oder höher müssen Sie hierzu „dreamweaver.openDocumentFromSite()“ auf Seite 234 aufrufen.

Hinweis: Wenn diese Funktion aus einer Verhaltensaktion oder einer Objektdatei aufgerufen wird, verursacht sie einen Fehler.

ArgumentefileName

• Das Argument fileName ist der Name der zu öffnenden Datei, ausgedrückt als URL. Falls es sich um eine relative URL handelt, bezieht sie sich auf die Skriptdatei, von der aus diese Funktion aufgerufen wurde.

RückgabewerteDas Dokumentobjekt für die angegebene Datei, d. h. derselbe Wert, der von dreamweaver.getDocumentDOM() zurückge-geben wird.

dreamweaver.openDocumentFromSite()


BeschreibungÖffnet ein Dokument zum Bearbeiten in einem neuen Dreamweaver-Fenster und verlagert den Fokus auf dieses Fenster. Für einen Benutzer ist der Effekt der gleiche, als würde er im Bedienfeld Site auf eine Datei doppelklicken. Wenn die betref-fende Datei bereits geöffnet ist, wird das zugehörige Dokumentfenster in den Vordergrund gestellt. Dieses Fenster wird zum aktuell ausgewählten Dokument.

Hinweis: Diese Funktion kann nicht über die Aktion Verhalten oder Objektdateien aufgerufen werden, da dies eine Fehler-meldung verursacht.

ArgumentefileName

• Das Argument fileName gibt die zu öffnende Datei an, ausgedrückt als URL. Falls es sich um eine relative URL handelt, bezieht sie sich auf die Skriptdatei, von der aus diese Funktion aufgerufen wurde.

RückgabewerteDas Dokumentobjekt für die angegebene Datei, d. h. derselbe Wert, der von dreamweaver.getDocumentDOM() zurückge-geben wird.

dreamweaver.openInFrame()



235

BeschreibungÖffnet das Dialogfeld Öffnen in Frame. Wenn der Benutzer ein Dokument auswählt, wird es im aktiven Frame geöffnet.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canOpenInFrame()“ auf Seite 427.

dreamweaver.releaseDocument()


BeschreibungGibt ein zuvor angefordertes Dokument im Speicher explizit frei.

Dokumente, die von dreamweaver.getObjectTags(), dreamweaver.getObjectRefs(), dreamweaver.getDocumentPath() oder dreamweaver.getDocumentDOM() referenziert werden, werden nach Beendigung des aufrufenden Skripts automatisch freigegeben. Wenn das Skript viele Dokumente enthält, müssen Sie sie mit der Funktion explizit freigeben, bevor Sie das Skript beenden. Dadurch wird ein Speicherüberlauf verhindert.

Hinweis: Diese Funktion ist nur für solche Dokumente relevant, die über eine URL aufgerufen wurden, die momentan nicht in einem Frame oder einem Dokumentfenster geöffnet sind und bei denen es sich nicht um Erweiterungsdateien handelt. (Erwei-terungsdateien werden beim Start in den Speicher geladen und erst beim Beenden von Dreamweaver freigegeben.)


• Das Argument documentObject ist das Objekt am Stamm der DOM-Struktur eines Dokuments, welches der von dream-weaver.getDocumentDOM() zurückgegebene Wert ist.

RückgabewerteKeine

dreamweaver.revertDocument()


BeschreibungStellt das angegebene Dokument wieder in der zuvor gespeicherten Version her.



RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canRevertDocument()“ auf Seite 428.


236

dreamweaver.saveAll()


BeschreibungSpeichert alle geöffneten Dokumente. Für Dokumente, die zuvor noch nicht gespeichert waren, wird das Dialogfeld Speichern unter angezeigt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canSaveAll()“ auf Seite 429.

dreamweaver.saveDocument()


BeschreibungSpeichert die angegebene Datei auf einem lokalen Computer.

Hinweis: In Dreamweaver 2 wird versucht, die Datei auszuchecken, falls diese schreibgeschützt ist. Wenn das Dokument auch nach diesem Versuch noch schreibgeschützt ist bzw. nicht erstellt werden kann, wird eine Fehlermeldung angezeigt.

ArgumentedocumentObject, {fileURL}


• Das optionale Argument fileURL ist eine URL, die den Speicherort auf dem lokalen Laufwerk angibt. Wenn es sich um eine relative URL handelt, bezieht sie sich auf die Erweiterungsdatei. In Dreamweaver 2 muss dieses Argument angegeben werden. Wenn das Argument fileURL in Dreamweaver 4 ausgelassen wird, wird die Datei am aktuellen Speicherort gespeichert, falls sie zuvor bereits gespeichert war, andernfalls wird das Dialogfeld Speichern angezeigt.

RückgabewerteEin Boolescher Wert, der angibt, ob der Vorgang erfolgreich war (true) oder fehlgeschlagen ist (false).

EnablerWeitere Informationen finden Sie unter „dreamweaver.canSaveDocument()“ auf Seite 429.


237

dreamweaver.saveDocumentAs()


BeschreibungÖffnet das Dialogfeld Speichern unter.



RückgabewerteKeine

dreamweaver.saveDocumentAsTemplate()


BeschreibungÖffnet das Dialogfeld Als Vorlage speichern.

ArgumentedocumentObject, {fileName}

• Das Argument documentObject ist das Objekt im Stamm der DOM-Struktur eines Dokuments (der von dream-weaver.getDocumentDOM() zurückgegebene Wert).

• Das optionale Argument fileName ist der Name der zu öffnenden Datei, ausgedrückt als absolute URL.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canSaveDocumentAsTemplate()“ auf Seite 429.

dreamweaver.saveFrameset()


BeschreibungSpeichert das angegebene Frameset bzw. öffnet das Dialogfeld Speichern unter, falls das Frameset zuvor noch nicht gespei-chert wurde.



RückgabewerteKeine


238

EnablerWeitere Informationen finden Sie unter „dreamweaver.canSaveFrameset()“ auf Seite 430.

dreamweaver.saveFramesetAs()


BeschreibungÖffnet das Dialogfeld Speichern unter für die Frameset-Datei, die das angegebene DOM enthält.



RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canSaveFramesetAs()“ auf Seite 430.

Globale DokumentfunktionenGlobale Dokumentfunktionen wirken sich auf ein gesamtes Dokument aus. Mit ihnen kann die Rechtschreibprüfung durchgeführt werden, lassen sich Ziel-Browser überprüfen, Seiteneigenschaften einstellen und für die enthaltenen Elemente die korrekten Objektreferenzen bestimmen.

dom.checkSpelling()


BeschreibungFührt im Dokument die Rechtschreibprüfung durch und öffnet dazu bei Bedarf das entsprechende Dialogfeld. Am Ende der Überprüfung wird eine Meldung angezeigt.

ArgumenteKeine

RückgabewerteKeine


239

dom.checkTargetBrowsers()


BeschreibungFührt im Dokument eine Zielbrowser-Prüfung durch. Wie Sie für einen Ordner oder mehrere Dateien eine Zielbrowser-Prüfung durchführen, ist unter „site.checkTargetBrowsers()“ auf Seite 199 beschrieben.

ArgumenteKeine

RückgabewerteKeine

dom.getParseMode()


BeschreibungRuft den aktuellen Analysemodus des Dokuments ab, der bestimmt, wie das Dokument ausgewertet wird und ob es im Hauptdokumentfenster als HTML angezeigt wird.

ArgumenteKeine

RückgabewerteEin String, der den aktuellen Analysemodus festlegt: "html", "xml", "css" oder "text".

dom.hideInfoMessagePopup()


BeschreibungBlendet die QuickInfo-Meldung für das Dokumentfenster aus, falls sie angezeigt wird.

ArgumenteKeine

RückgabewerteKeine

Siehe auch„dom.showInfoMessagePopup()“ auf Seite 241.


240

dom.runValidation()

VerfügbarkeitDreamweaver MX, optionale Argumente in Dreamweaver MX 2004 hinzugefügt.

BeschreibungFührt den Validator für ein einzelnes angegebenes Dokument aus (vergleichbar mit „site.runValidation()“ auf Seite 215). Der Validator überprüft, ob das Dokument mit der im doctype angegebenen Sprache (z. B. HTML 4.0 oder HTML 3.2) und der durch das Servermodell bestimmten Sprache (z. B. ColdFusion oder ASP) übereinstimmt. Wenn das Dokument keinen doctype enthält, verwendet der Validator die im Dialogfeld Voreinstellungen unter Validator festgelegte Sprache.

Argumente{controlString}, {bOpenResultsWindow}, {bShowInfoMessage}

• Das Argument controlString ist ein optionaler String mit vier möglichen Werten: ein leerer String, "xml", "auto-explicit" oder "auto-implicit".

• Wenn das Argument ein leerer String ist, führt der Validator eine Standardüberprüfung durch. Wenn das Argument den Wert "xml" hat, wertet der Validator das Dokument als XML aus.

• Lautet das Argument "auto-explicit" oder "auto-implicit", führt Dreamweaver eine automatische Überprüfung durch (auch als Inline-Überprüfung bezeichnet), bei der Fehler in der Codeansicht anstatt im Auswertungsergebnisfenster markiert werden (siehe „dom.source.getValidationErrorsForOffset()“ auf Seite 402 und „dom.getAutoValidationCount()“ auf Seite 397).

• Wenn das Argument controlString den Wert "auto-explicit" hat, fordert Dreamweaver den Benutzer auf, ungespeicherte Dokumente zu speichern, bevor die Auswertung durchgeführt wird.

• Wenn controlString den Wert "auto-implicit" hat, schlägt die Auswertung fehl, ohne dass der Benutzer darauf hingewiesen wird, dass das aktuelle Dokument noch nicht gespeichert wurde.

Hinweis: Eine automatische Überprüfung (bestimmt durch den Wert "auto-explicit" oder "auto-implicit" für control-String) ist derzeit nur für die Browserkompatibilitätsprüfung verfügbar.

• bOpenResultsWindow ist ein optionaler Boolescher Wert: mit true wird das Auswertungsergebnisfenster geöffnet, mit false nicht. Der Standardwert ist true.

• Das Argument bShowInfoMessage wird nur verwendet, wenn das Argument controlString als "auto-explicit" oder "auto-implicit" definiert ist. bShowInfoMessage enthält einen Booleschen Wert: wenn der Wert true ist, wird ein Informationshinweis mit der Anzahl der gefundenen Fehler unter dem Symbolleistenelement DW_ValidatorErrors angezeigt; bei false wird nichts angezeigt. Der Standardwert ist false.

RückgabewerteDas Auswertungsergebnisfenster-Objekt.

BeispielIm folgenden Beispiel wird eine reguläre Überprüfung durchgeführt, wenn der Benutzer die Menüoption Datei > Seite überprüfen > Markup überprüfen (oder Aktuelles Dokument überprüfen im Bedienfeld Überprüfung) auswählt:

dw.getDocumentDOM().runValidation('');

Im folgenden Beispiel wird der Benutzer zum Speichern eines ungespeicherten Dokuments aufgefordert, eine automatische Überprüfung wird ausgeführt, das Auswertungsergebnisfenster wird nicht geöffnet, aber die Gesamtanzahl von Fehlern wird über der Symbolleistenschaltfläche DW_ValidatorErrors angezeigt:

dw.getDocumentDOM().runValidation('auto-explicit', false, true);

Im folgenden Beispiel wird der Benutzer nicht zum Speichern eines ungespeicherten Dokuments aufgefordert. Falls das Dokument nicht gespeichert wurde, wird die Überprüfung nicht gestartet. Wenn das Dokument gespeichert wurde, führt Dreamweaver eine automatische Überprüfung aus, das Auswertungsergebnisfenster wird nicht geöffnet, und die Gesamt-anzahl von Fehlern wird nicht in der Dokument-Symbolleiste angezeigt:


241

dw.getDocumentDOM().runValidation('auto-implicit', false);

dom.showInfoMessagePopup()


BeschreibungZeigt eine QuickInfo-Meldung im Dokumentfenster oder unter einem Symbolleistenelement an.

Argumentelocation, message, timeout

• Das Argument location kann einen String, der das Symbolleistenelement bestimmt, oder einen leeren String oder eines der folgenden Schlüsselwörter enthalten: "top", "topright", "right", "bottomright", "bottom", "bottomleft", "left" oder "topleft". Die QuickInfo wird an der angegebenen Seite oder Ecke angezeigt und zentriert. Ein leerer String gibt an, dass sie im Dokument zentriert wird. Um ein Symbolleistenelement festzulegen, verwenden Sie "toolbar:toolbarID:itemID", wobei toolbarID und itemID den IDs in der Datei toolbars.xml entsprechen.

• Das Argument message ist ein String, der die Meldung enthält.

• timeout ist eine Zahl, die die Anzeigedauer der Meldung in Millisekunden angibt. Der Standardwert ist 0. Wenn der Wert 0 ist, wird die Meldung dauerhaft angezeigt. Sobald der Benutzer darauf klickt oder zu einem anderen Dokument wechselt, oder sobald das Zeitlimit überschritten wird, schließt Dreamweaver die Meldung automatisch.

RückgabewerteKeine

BeispielIm folgenden Beispiel werden zwei QuickInfo-Meldungen angezeigt. Die erste Codezeile zeigt die Meldung „This message is in the center (Diese Meldung ist zentriert)“ in der Mitte des Dokuments an. Die zweite Funktion showInfoMes-sagePopup() ruft die QuickInfo-Meldung „Don't forget the title for the window (Vergessen Sie nicht den Titel für das Fenster)“ für das Bearbeitungsfeld des Titeltexts (ID DW_SetTitle) in der Symbolleiste mit der ID DW_Toolbar_Main auf.

dw.getDocumentDOM.showInfoMessagePopup('', 'This message is in the center', 5000);

dw.getDocumentDOM.showInfoMessagePopup('toolbar:DW_Toolbar_Main:DW_SetTitle', 'Don't

forget the title for the window', 5000);

Siehe auch„dom.hideInfoMessagePopup()“ auf Seite 239.

dom.showPagePropertiesDialog()


BeschreibungÖffnet das Dialogfeld Seiteneigenschaften.

ArgumenteKeine

RückgabewerteKeine


242

dreamweaver.doURLDecoding()


BeschreibungVerwendet den internen URL-Dekodierungsmechanismus von Dreamweaver, um Sonderzeichen und Symbole in URL-Strings zu dekodieren. Die folgende Funktion dekodiert beispielsweise %20 als Leerzeichen und den String &quot als gerades Anführungszeichen (").

ArgumenteinStr

• Das Argument inStr ist der zu dekodierende String.

RückgabewerteEin String, der die dekodierte URL enthält.

Beispiel Im folgenden Beispiel wird dw.doURLDecoding() aufgerufen, um die Sonderzeichen in dem Argument zu dekodieren und das Ergebnis in outstr zu speichern:

outStr = dreamweaver.doURLDecoding(“http://maps.yahoo.com/py/ddResults.py?Pyt= ¬Tmap&tarname=&tardesc=&newname=&newdesc=&newHash=&newTHash=&newSts=&newTSts=&tlt=&tln= ¬&slt=&sln=&newFL=Use+Address+Below&newaddr=2000+Shamrock+Rd&newcsz=Metroo+Park%2C+CA& ¬newcountry=us&newTFL=Use+Address+Below&newtaddr=500+El+Camino&newtcsz=Santa+Clara%2C+CA& ¬newtcountry=us&Submit=Get+Directions”)

dreamweaver.getElementRef()


BeschreibungRuft für ein bestimmtes Tag-Objekt in der DOM-Baumstruktur die Objektreferenz für Netscape Navigator oder Microsoft Internet Explorer ab.

ArgumenteNSorIE, tagObject

• Das Argument NSorIE muss entweder "NS 4.0" oder "IE 4.0" lauten. Das DOM und die Regeln für verschachtelte Bezüge sind in Netscape Navigator 4.0 und Microsoft Internet Explorer 4.0 verschieden. Mit diesem Argument wird festgelegt, für welchen Browser eine gültige Referenz zurückgegeben werden soll.

• tagObject ist ein Tag-Objekt in der DOM-Struktur.


243

RückgabewerteEin String mit einer gültigen JavaScript-Referenz zu dem Objekt, beispielsweise document.layers['myLayer']. Der String unterliegt folgenden Bedingungen:

• Bei Microsoft Internet Explorer werden für die Tags A, AREA, APPLET, EMBED, DIV, SPAN, INPUT, SELECT, OPTION, TEXTAREA, OBJECT und IMG korrekte Referenzen zurückgegeben.

• Bei Netscape Navigator werden für die Tags A, AREA, APPLET, EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT und IMG sowie für absolut positionierte Tags der Typen DIV und SPAN korrekte Referenzen zurückgegeben. Für nicht absolut positionierte Tags DIV und SPAN wird "cannot reference <tag>" zurückgegeben.

• Für unbenannte Objekte werden keine Referenzen zurückgegeben. Wenn ein Objekt weder das Attribut NAME noch ID enthält, wird "unnamed <tag>" zurückgegeben. Wenn der Browser keine Referenz nach Name unterstützt, wird das Objekt nach Index referenziert (z. B. document.myform.applets[3]).

• Für benannte Objekte in unbenannten Formularen und Ebenen (z. B. document.forms[2].myCheckbox) werden Referenzen zurückgegeben.

dreamweaver.getObjectRefs() (veraltet)

VerfügbarkeitDreamweaver 1, in 3 abgelöst.

BeschreibungDiese Funktion durchsucht das angegebene Dokument nach bestimmten Tags (oder, falls keine Tags angegeben sind, nach allen Tags) und erstellt für diese Tags browserspezifische Referenzen. Diese Funktion ist äquivalent dazu, getElementsBy-TagName() und danach dreamweaver.getElementRef() für jedes Tag in der nodelist aufzurufen.

ArgumenteNSorIE, sourceDoc, {tag1}, {tag2},...{tagN}

• Das Argument NSorIE muss entweder "NS 4.0" oder "IE 4.0" lauten. Das DOM und die Regeln für verschachtelte Bezüge sind in Netscape Navigator 4.0 und Microsoft Internet Explorer 4.0 verschieden. Mit diesem Argument wird festgelegt, für welchen Browser eine gültige Referenz zurückgegeben werden soll.

• Das Argument sourceDoc muss entweder "document", "parent", "parent.frames[number]", "parent.frames['frameName']" oder eine URL sein. document legt das Dokument fest, das sich im Fokus befindet und die aktuelle Auswahl enthält. parent bestimmt das übergeordnete Frameset (wenn sich das momentan ausgewählte Dokument in einem Frame befindet) und mit parent.frames[number] und parent.frames['frameName'] wird ein Dokument festgelegt, das sich in einem bestimmten Frame innerhalb des Framesets mit dem aktuellen Dokument befindet. Wenn das Argument eine relative URL ist, bezieht sie sich auf die Erweiterungsdatei.

• Das dritte und, falls angegeben, alle weiteren Argumente enthalten die Namen von Tags (z. B. "IMG", "FORM" oder "HR").

RückgabewerteEin Array von Strings, jeweils mit einer gültigen JavaScript-Referenz zu einer benannten Instanz des angeforderten Tags im betreffenden Dokument (z. B. "document.myLayer.document.myImage") für den angegebenen Browser:

• Bei Microsoft Internet Explorer werden für die Tags A, AREA, APPLET, EMBED, DIV, SPAN, INPUT, SELECT, OPTION, TEXTAREA, OBJECT und IMG korrekte Referenzen zurückgegeben.

• Bei Netscape Navigator werden für die Tags A, AREA, APPLET, EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT und IMG sowie für absolut positionierte Tags der Typen DIV und SPAN korrekte Referenzen zurückgegeben. Für nicht absolut positionierte Tags DIV und SPAN wird "cannot reference <tag>" zurückgegeben.

• Für unbenannte Objekte werden keine Referenzen zurückgegeben. Wenn ein Objekt weder das Attribut NAME noch ID enthält, wird "unnamed <tag>" zurückgegeben. Wenn der Browser keine Referenz nach Name unterstützt, wird das Objekt nach Index referenziert (z. B. document.myform.applets[3]).

• Für benannte Objekte in unbenannten Formularen und Ebenen (z. B. document.forms[2].myCheckbox) werden keine Referenzen zurückgegeben.


244

Bei Übergabe der gleichen Liste von Argumenten an getObjectTags() geben die beiden Funktionen ein Array gleicher Länge und übereinstimmenden Inhalts zurück.

dreamweaver.getObjectTags() (veraltet)

VerfügbarkeitDreamweaver 1, in 3 abgelöst.

BeschreibungDiese Funktion durchsucht das angegebene Dokument nach Vorkommen von bestimmten Tags bzw., falls keine Tags angegeben sind, nach allen Tags. Diese Funktion ist äquivalent dazu, getElementsByTagName() und danach outerHTML für jedes Element in der nodelist aufzurufen.

ArgumentesourceDoc, {tag1}, {tag2},...{tagN}

• Das Argument sourceDoc muss entweder "document", "parent", "parent.frames[number]", "parent.frames['frameName']" oder eine URL sein. document legt das Dokument fest, das sich im Fokus befindet und die aktuelle Auswahl enthält. parent bestimmt das übergeordnete Frameset (wenn sich das momentan ausgewählte Dokument in einem Frame befindet), und mit parent.frames[number] und parent.frames['frameName'] wird ein Dokument festgelegt, das sich in einem bestimmten Frame innerhalb des Framesets mit dem aktuellen Dokument befindet. Wenn das Argument eine relative URL ist, bezieht sie sich auf die Erweiterungsdatei.

• Das zweite und, falls angegeben, alle weiteren Argumente enthalten die Namen von Tags (z. B. "IMG", "FORM" oder "HR").

RückgabewerteEin Array von Strings, jeweils mit dem Quellcode für eine Instanz des angeforderten Tags im betreffenden Dokument.

• Wenn der Wert eines der Argumente vom Typ tag LAYER lautet, gibt die Funktion alle Tags vom Typ LAYER und ILAYER sowie alle absolut positionierten Tags vom Typ DIV und SPAN zurück.

• Wenn der Wert des Arguments tag INPUT lautet, gibt die Funktion alle Formularelemente zurück. Um einen bestimmten Typ Formularelement abzurufen, geben Sie INPUT/TYPE an, wobei für TYPE die Werte button, text, radio, checkbox, password, textarea, select, hidden, reset oder submit angegeben werden können.

Bei Übergabe der gleichen Liste von Argumenten an getObjectRefs() geben die beiden Funktionen ein Array gleicher Länge zurück.

Beispiel Beim Aufruf von dreamweaver.getObjectTags("document", "IMG") wird je nach Inhalt des aktiven Dokuments beispiels-weise ein Array mit den folgenden Elementen zurückgegeben:

• "<IMG SRC="/images/dot.gif" WIDTH="10" HEIGHT="10" NAME="bullet">"

• "<IMG SRC="header.gif" WIDTH="400" HEIGHT="32" NAME="header">" • "<IMG SRC="971208_nj.jpg" WIDTH="119" HEIGHT="119" NAME="headshot">"

dreamweaver.getPreferenceInt()


BeschreibungErmöglicht den Abruf eines ganzzahligen Voreinstellungswerts für eine Erweiterung.

Argumentesection, key, default_value

• Das Argument section ist ein String mit dem Voreinstellungsabschnitt, der den Eintrag enthält.

• key ist ein String, der den Eintrag des abzurufenden Werts angibt.


245

• default_value ist der Standardwert, den Dreamweaver zurückgibt, wenn der Eintrag nicht gefunden werden konnte. Hierbei muss es sich um eine Ganzzahl ohne Vorzeichen im Bereich 0 bis 65.535 oder um eine Ganzzahl mit Vorzeichen im Bereich –32.768 bis 32.767 handeln.

RückgabewerteGanzzahlwert des angegebenen Eintrags im angegebenen Abschnitt oder der Standardwert, wenn die Funktion den Eintrag nicht findet. Gibt 0 zurück, wenn der Wert des angegebenen Eintrags keine Ganzzahl ist.

Beispiel Das folgende Beispiel gibt einen Ganzzahlwert für den Ausrichtungsabstand (Snap Distance) im Abschnitt My Extension der Voreinstellungen zurück. Wenn der Abschnitt My Extension oder der Eintrag Snap Distance nicht vorhanden ist, gibt die Funktion den Standardwert 0 zurück.

var snapDist; //Standardwert, wenn Eintrag nicht gefunden

snapDist = dreamweaver.getPreferenceInt("My Extension", "Snap Distance", 0);

dreamweaver.getPreferenceString()


Hinweis: Die Voreinstellungen für Sites sind erst ab Version 7.0.1 zugänglich. Überprüfen Sie dw.appVersion auf die korrekte Version, bevor Sie die Siteinformationen abrufen.

BeschreibungErmöglicht den Abruf eines String-Voreinstellungswerts, den Sie für eine Erweiterung gespeichert haben.

Argumentesection, key, default_value

• Das Argument section ist ein String mit dem Voreinstellungsabschnitt, der den Eintrag enthält.

• key ist ein String, der den abzurufenden Wert angibt.

• default_value ist der Standardwert, den Dreamweaver zurückgibt, wenn der Eintrag nicht gefunden werden konnte.

RückgabewerteDer angeforderte Voreinstellungs-String, oder, wenn dieser nicht gefunden werden konnte, der Standard-String.

Beispiel Das folgende Beispiel gibt den Stringwert für den Texteditor im Abschnitt My Extension der Voreinstellungen zurück. Wenn der Abschnitt My Extension oder der Eintrag Text Editor nicht vorhanden ist, gibt die Funktion den durch die Variable txtEditor festgelegten Standardwert zurück.

var txtEditor = getExternalTextEditor(); //Standardtexteditorwert setzen

txtEditor = dreamweaver.getPreferenceString("My Extension", "Text Editor", txtEditor);

dreamweaver.setPreferenceInt()


BeschreibungErmöglicht das Festlegen eines ganzzahligen Voreinstellungswerts für eine Erweiterung. Diese Einstellung wird in den Dreamweaver-Voreinstellungen gespeichert, wenn Dreamweaver nicht ausgeführt wird.


246

Argumentesection, key, new_value

• Das Argument section ist ein String mit der Voreinstellungskategorie, in der die Option festgelegt wird. Wenn die Kategorie nicht vorhanden ist, wird sie von Dreamweaver erstellt.

• key ist ein String, der die durch die Funktion festgelegte Kategorieoption angibt. Wenn die Option nicht vorhanden ist, wird sie von Dreamweaver erstellt.

• new_value ist eine Ganzzahl, die den Wert der Kategorieoption angibt.

Rückgabewertetrue, wenn erfolgreich, andernfalls false.

Beispiel Im folgenden Beispiel wird der Eintrag Snap Distance in der Kategorie My Extension der Voreinstellungen auf den Wert der Variablen snapDist gesetzt:

var snapDist = getSnapDistance();

if(snapDist > 0)

{

dreamweaver.setPreferenceInt("My Extension", "Snap Distance", snapDist);

}

dreamweaver.setPreferenceString()


Hinweis: Die Voreinstellungen für Sites sind erst ab Version 7.0.1 zugänglich. Überprüfen Sie dw.appVersion auf die korrekte Version, bevor Sie die Siteinformationen abrufen.

BeschreibungErmöglicht den Abruf eines String-Voreinstellungswerts für eine Erweiterung. Diese Einstellung wird in den Dream-weaver-Voreinstellungen gespeichert, wenn Dreamweaver nicht ausgeführt wird.

Argumentesection, key, new_value

• Das Argument section ist ein String mit der Voreinstellungskategorie, in der die Option festgelegt wird. Wenn die Kategorie nicht vorhanden ist, wird sie von Dreamweaver erstellt.

• key ist ein String, der die durch die Funktion festgelegte Kategorieoption angibt. Wenn die Kategorieoption nicht vorhanden ist, wird sie von Dreamweaver erstellt.

• new_value ist ein String, der den Wert der Kategorieoption angibt.

Rückgabewertetrue, wenn erfolgreich, andernfalls false.

Beispielvar txtEditor = getExternalTextEditor();

dreamweaver.setPreferenceString("My Extension", "Text Editor", txtEditor);


247

dreamweaver.showTargetBrowsersDialog()


BeschreibungDas Dialogfeld Zielbrowser wird angezeigt. Im Dialogfeld Zielbrowser können Benutzer angeben, welche Browserver-sionen von der Zielbrowser-Prüfungsfunktion verwendet werden sollen, um die Browserkompatibilität der aktuellen Seite zu überprüfen.

ArgumenteKeine

Rückgabewerte Keine

PfadfunktionenMit Pfadfunktionen lassen sich die Pfade zu verschiedenen Dateien und Ordnern auf der Festplatte eines Benutzers abrufen und bearbeiten. Unter anderem kann der Pfad zum Stammverzeichnis der Site des aktuellen Dokuments bestimmt werden und relative Pfade lassen sich in absolute URLs konvertieren.

dreamweaver.getConfigurationPath()


BeschreibungRuft den Pfad zum Dreamweaver-Ordner Configuration ab, ausgedrückt im URL-Format „file://“.

Informationen dazu, wie Dreamweaver in einer Umgebung mit mehreren Benutzern auf den jeweiligen Configuration-Ordner zugreift, finden Sie im Hilfemodul „Dreamweaver erweitern“ unter „C-Level-Erweiterbarkeit“.

ArgumenteKeine

RückgabewerteGibt den Pfad zu den Anwendungskonfigurationen zurück.

BeispielDiese Funktion ist dann nützlich, wenn andere Erweiterungsdateien referenziert werden, die alle im Ordner Configu-ration des Dreamweaver-Anwendungsordners gespeichert sind:

var sortCmd = dreamweaver.getConfigurationPath() + ¬

"/Commands/Sort Table.htm"

var sortDOM = dreamweaver.getDocumentDOM(sortCmd);


248

dreamweaver.getDocumentPath()

VerfügbarkeitDreamweaver 1.2

BeschreibungRuft den Pfad des angegebenen Dokuments ab, ausgedrückt im URL-Format „file://“. Dies ist äquivalent damit, dream-weaver.getDocumentDOM() aufzurufen und die Eigenschaft URL des Rückgabewerts zu lesen.

ArgumentesourceDoc

• Der Wert des Arguments sourceDoc muss entweder "document", "parent", "parent.frames[number]" oder "parent.frames['frameName']" sein. "document" legt das Dokument fest, das sich im Fokus befindet und die aktuelle Auswahl enthält. "parent" bestimmt das übergeordnete Frameset (wenn sich das momentan ausgewählte Dokument in einem Frame befindet) und mit "parent.frames[number]" und "parent.frames['frameName']" wird ein Dokument festgelegt, das sich in einem bestimmten Frame innerhalb des Framesets mit dem aktuellen Dokument befindet.

RückgabewerteWenn die Datei gespeichert wurde, ein String, der die URL des angegebenen Dokuments enthält; wenn die Datei nicht gespeichert wurde, ein leerer String.

dreamweaver.getSiteRoot()

VerfügbarkeitDreamweaver 1.2

BeschreibungRuft den lokalen Stammordner (wie im Dialogfeld Site-Definition festgelegt) für die Site des momentan ausgewählten Dokuments ab, ausgedrückt im URL-Format „file://“.

ArgumenteKeine

RückgabewerteEntweder ein String, der die URL des lokalen Stammordners der Site enthält, in dem die Datei gespeichert wurde, oder ein leerer String, wenn die Datei nicht mit einer Site verknüpft ist.

dreamweaver.getTempFolderPath()


BeschreibungRuft den vollständigen Pfad eines temporären Ordners ab, in dem Sie temporäre Dateien speichern können. Diese Funktion sucht im Ordner Configuration von Dreamweaver nach einem Ordner Temp. Wenn das System mehrere Benutzer unter-stützt, sucht es im Ordner Configuration des Benutzers. Ist kein Ordner Temp vorhanden, wird er von der Funktion erstellt. Nicht temporäre gemeinsam genutzte Dateien sollten im Ordner Configuration\Shared gespeichert werden.

ArgumenteKeine

RückgabewerteDer vollständige Ordnerpfad, ausgedrückt im URL-Format „file://“.


249

BeispielDie folgende Codezeile gibt den vollständigen Pfad für die angegebene Datei zurück. Die Funktion dw.getTempFol-derPath() fügt keinen Schrägstrich (/) am Ende des Pfads hinzu, im Gegensatz zu anderen Dreamweaver-Funktionen (wie z. B. dreamweaver.getSiteRoot()):

var myTempfile = dw.getTempFolderPath() + "/myTempFile.txt";

dreamweaver.relativeToAbsoluteURL()


BeschreibungDiese Funktion konvertiert eine relative URL über einen Bezugspunkt (entweder den Pfad zum aktuellen Dokument oder den Sitestamm) in eine absolute Pfadangabe im URL-Format „file://“.

ArgumentedocPath, siteRoot, relURL

• Das Argument docPath ist der Pfad zu einem Dokument auf dem Computer des Benutzers (z. B. das aktuelle Dokument), ausgedrückt im URL-Format „file://“, oder ein leerer String, wenn relURL relativ zum Stamm angegeben wurde.

• siteRoot ist der Pfad zum Sitestamm, ausgedrückt im URL-Format „file://“, oder ein leerer String, wenn relURL relativ zum Dokument angegeben wurde.

• relURL ist die zu konvertierende URL.

RückgabewerteEin absoluter URL-String. Der Rückgabewert wird wie in der folgenden Liste beschrieben generiert:

• Wenn relURL eine absolute URL ist, findet keine Konvertierung statt und der Rückgabewert ist identisch mit dem Wert von relURL.

• Wenn relURL relativ zu einem Dokument angegeben wurde, wird der Rückgabewert aus docPath + relURL zusammen-gesetzt.

• Wenn relURL relativ zum Stamm angegeben wurde, wird der Rückgabewert aus siteRoot + relURL zusammengesetzt.

Auswahlfunktionen Mit Auswahlfunktionen werden in geöffneten Dokumenten ausgewählte Bereiche abgerufen und festgelegt. Informationen über das Abrufen und Einstellen der Auswahl im Bedienfeld Site finden Sie unter „Sitefunktionen“ auf Seite 191.

dom.getSelectedNode()


BeschreibungRuft den ausgewählten Knoten ab. Die Verwendung dieser Funktion entspricht dem Abrufen der Funktion dom.getSel-ection() und dem Übergeben des Rückgabewerts an dom.offsetsToNode().

ArgumenteKeine


250

RückgabewerteDas Objekt vom Typ Tag, Text oder Kommentar, das den angegebenen Zeichenbereich vollständig enthält.

dom.getSelection()


BeschreibungRuft die Auswahl ab, die in Form von Zeichen-Offsets im Quellcode des Dokuments ausgedrückt wird.

Argumente{bAllowMultiple}

• Das optionale Argument bAllowMultiple ist ein Boolescher Wert, der angibt, ob die Funktion mehrere Offsets zurück-geben soll, wenn mehrere Tabellenzellen, Imagemap-Hotspots oder Ebenen ausgewählt sind.

Bei fehlendem Argument gilt der Standardwert false.

RückgabewerteBei einer einfachen Auswahl ein Array mit zwei Ganzzahlen. Die erste Ganzzahl ist der Zeichen-Offset zum Anfang der Auswahl. Die zweite Ganzzahl ist der Zeichen-Offset zum Ende der Auswahl. Wenn beide Zahlen übereinstimmen, handelt es sich bei der aktuellen Auswahl um eine Einfügemarke.

Bei einer komplexen Auswahl (mehrere Tabellenzellen, Ebenen oder Imagemap-Hotspots) ein Array mit 2n Ganzzahlen, wobei n die Anzahl der ausgewählten Elemente bezeichnet. Die erste Ganzzahl in jedem Wertepaar ist der Zeichen-Offset zum Anfang der Auswahl (einschließlich des einleitenden Tags vom Typ TD, DIV, SPAN, LAYER, ILAYER oder MAP). Die zweite Ganzzahl ist der Zeichen-Offset zum Ende der Auswahl (einschließlich der schließenden Tags vom Typ TD, DIV, SPAN, LAYER, ILAYER oder MAP). Wenn mehrere Tabellenzeilen ausgewählt sind, werden die Offsets aller Zellen in den einzelnen Zeilen zurückgegeben. Die Auswahl schließt niemals TR-Tags ein.

dom.nodeToOffsets()


BeschreibungRuft die Position eines bestimmten Knotens in der DOM-Struktur ab, ausgedrückt in Form von Zeichen-Offsets im Quellcode des Dokuments. Gültig für beliebige Dokumente auf einem lokalen Laufwerk.

Argumentenode

• Das Argument node muss ein Objekt des Typs Tag, Kommentar oder Textbereich sein, das einem Knoten in der von dreamweaver.getDocumentDOM() zurückgegebenen Struktur entspricht.

RückgabewerteEin Array mit zwei Ganzzahlen. Die erste Ganzzahl ist der Zeichen-Offset zum Anfang des Tags, Texts oder Kommentars. Die zweite Ganzzahl ist der Zeichen-Offset zum Ende des Knotens, vom Anfang des HTML-Dokuments.

BeispielMit dem folgenden Code wird das erste Bildobjekt im aktuellen Dokument ausgewählt:

var theDOM = dw.getDocumentDOM();

var theImg = theDOM.images[0];

var offsets = theDom.nodeToOffsets(theImg);

theDom.setSelection(offsets[0], offsets[1]);


251

dom.offsetsToNode()


BeschreibungRuft das Objekt in der DOM-Struktur ab, das den vollständigen Zeichenbereich zwischen den angegebenen Anfangs- und Endpunkten enthält. Gültig für beliebige Dokumente auf einem lokalen Laufwerk.

ArgumenteoffsetBegin, offsetEnd

• Das Argument offsetBegin gibt den Offset vom Anfang des Dokuments bis zum Anfang des Zeichenbereichs an, der einem Objekt in der DOM-Struktur entspricht.

• offsetEnd gibt den Offset vom Anfang des Dokuments bis zum Ende des Zeichenbereichs an, der einem Objekt in der DOM-Struktur entspricht.


BeispielBei dem folgenden Code wird eine Warnmeldung angezeigt, wenn es sich bei der Auswahl um ein Bild handelt:

var offsets = dom.getSelection();

var theSelection = dreamweaver.offsetsToNode(offsets[0], ¬

offsets[1]);

if (theSelection.nodeType == Node.ELEMENT_NODE && ¬

theSelection.tagName == 'IMG'){

alert('The current selection is an image.');

}

dom.selectAll()


BeschreibungMit dieser Funktion werden alle Objekte ausgewählt.

Hinweis: Im Regelfall wird mit dieser Funktion der gesamte Inhalt des aktiven Dokuments ausgewählt. In manchen Fällen (z. B., wenn sich die Einfügemarke in einer Tabelle befindet) wird nur ein Teil des aktiven Dokuments ausgewählt. Um bei der Auswahl das gesamte Dokument zu erfassen, verwenden Sie die Funktion dom.setSelection().

ArgumenteKeine

RückgabewerteKeine

dom.setSelectedNode()


BeschreibungSetzt den ausgewählten Knoten. Die Verwendung dieser Funktion entspricht dem Abrufen der Funktion dom.nodeToOffsets() und dem Übergeben des Rückgabewerts an dom.setSelection().


252

Argumentenode, {bSelectInside}, {bJumpToNode}

• Das Argument node ist ein Text-, Kommentar- oder Elementknoten im Dokument.

• Das optionale Argument bSelectInside ist ein Boolescher Wert, der angibt, ob sich die Auswahl auch auf innerHTML des Knotens erstrecken soll. Dieses Argument ist nur dann relevant, wenn node ein Elementknoten ist. Bei fehlendem Argument gilt der Standardwert false.

• Das optionale Argument bJumpToNode ist ein Boolescher Wert, der angibt, ob ein Bildlauf im Dokumentfenster durch-geführt werden soll, damit die Auswahl sichtbar wird. Bei fehlendem Argument gilt der Standardwert false.

RückgabewerteKeine

dom.setSelection()


BeschreibungStellt die Auswahl im Dokument ein.


• Als Argumente werden der Anfangs- und der Endpunkt für die neue Auswahl übergeben, ausgedrückt in Form von Zeichen-Offsets im Quellcode des Dokuments. Wenn beide Zahlen übereinstimmen, handelt es sich bei der neuen Auswahl um eine Einfügemarke. Wenn die neue Auswahl keine gültige HTML-Auswahl darstellt, wird sie durch Einbe-ziehung weiterer Zeichen zur ersten gültigen HTML-Auswahl erweitert. Wenn beispielsweise mit offsetBegin und offsetEnd der Bereich SRC="myImage.gif" innerhalb von <IMG SRC="myImage.gif"> definiert wird, wird die Auswahl so erweitert, dass das vollständige IMG-Tag enthalten ist.

RückgabewerteKeine

dreamweaver.getSelection() (veraltet)

VerfügbarkeitDreamweaver 2, in Version 3 abgelöst. Weitere Informationen finden Sie unter „dom.getSelection()“ auf Seite 250.

BeschreibungRuft die Auswahl im aktuellen Dokument ab, ausgedrückt in Form von Byte-Offsets im Quellcode des Dokuments.

ArgumenteKeine

RückgabewerteEin Array mit zwei Ganzzahlen. Die erste Ganzzahl bezeichnet den Byte-Offset für den Anfang der Auswahl, die zweite den Byte-Offset für das Ende der Auswahl. Wenn beide Zahlen übereinstimmen, handelt es sich bei der aktuellen Auswahl um eine Einfügemarke.


253

dreamweaver.nodeExists()


BeschreibungBestimmt, ob der Verweis auf den angegebenen Knoten noch gültig ist. Beim Schreiben von Erweiterungen kann es häufig vorkommen, dass Sie auf einen Knoten verweisen und dann eine Operation ausführen, die diesen Knoten löscht (z. B. durch Festlegen der Eigenschaft innerHTML oder outerHTML des übergeordneten Knotens). Mit dieser Funktion können Sie verifizieren, dass der Knoten nicht gelöscht wurde, bevor Sie versuchen, auf eine ihrer Eigenschaften oder Methoden zu verweisen. Der referenzierte Knoten muss sich nicht im aktuellen Dokument befinden.

Argumentenode

• Das Argument node ist der Name des zu überprüfenden Knotens.

RückgabewerteEin Boolescher Wert: true, wenn der Knoten vorhanden ist, andernfalls false.

Beispiel Im folgenden Beispiel wird der aktuelle Knoten abgerufen, die darin enthaltene Tabelle gesucht und später dw.nodeExists() aufgerufen, um zu überprüfen, ob der ursprüngliche Knoten noch vorhanden ist:

function applyFormatToSelectedTable(){

// aktuelle Auswahl abrufen

var selObj = dw.getDocumentDOM().getSelectedNode();

alternateRows(dwscripts.findDOMObject("presetNames").selectedIndex,

findTable());

// Stellen Sie, wenn möglich, die ursprüngliche Auswahl wieder her. Wählen Sie andernfalls nur die

// Tabelle.

var selArr;

if (dw.nodeExists(selObj))

selArr = dom.nodeToOffsets(selObj);

else

selArr = dom.nodeToOffsets(findTable());

dom.setSelection(selArr[0],selArr[1]);

}

dreamweaver.nodeToOffsets() (veraltet)

VerfügbarkeitDreamweaver 2, in 3 abgelöst von „dom.nodeToOffsets()“ auf Seite 250.

BeschreibungRuft die Position eines bestimmten Knotens in der DOM-Struktur ab, und zwar in Form von Byte-Offsets im Quellcode des Dokuments.

Argumentenode

• Das Argument node muss ein Objekt des Typs Tag, Kommentar oder Textbereich sein, das einem Knoten in der von dreamweaver.getDocumentDOM() zurückgegebenen Struktur entspricht.

RückgabewerteEin Array mit zwei Ganzzahlen. Die erste Ganzzahl bezeichnet den Byte-Offset für den Anfang des Tags, Textes oder Kommentars, die zweite den Byte-Offset für das Ende des Knotens.


254

dreamweaver.offsetsToNode() (veraltet)

VerfügbarkeitDreamweaver 2, in 3 abgelöst von „dom.offsetsToNode()“ auf Seite 251.

BeschreibungRuft das Objekt in der DOM-Struktur ab, das den vollständigen Zeichenbereich zwischen den angegebenen Anfangs- und Endpunkten enthält.


• Als Argumente werden der Anfangs- und Endpunkt eines Zeichenbereichs übergeben, ausgedrückt in Form von Byte-Offsets im Quellcode des Dokuments.


dreamweaver.selectAll()


BeschreibungFührt für das aktive Dokumentfenster oder das Bedienfeld Site einen Vorgang des Typs Alles auswählen durch. Beim Macintosh wirkt sich die Funktion auf das aktive Textfeld in einem Dialogfeld oder einem schwebenden Bedienfeld aus.

Hinweis: Wenn der Vorgang im aktiven Dokument durchgeführt wird, wird im Regelfall der gesamte Inhalt des aktiven Dokuments ausgewählt. In manchen Fällen (z. B., wenn sich die Einfügemarke innerhalb einer Tabelle befindet) wird jedoch nur ein Teil des aktiven Dokuments ausgewählt. Um bei der Auswahl das gesamte Dokument zu erfassen, verwenden Sie die Funktion dom.setSelection().

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canSelectAll()“ auf Seite 430.

dreamweaver.setSelection() (veraltet)

VerfügbarkeitDreamweaver 2, in 3 abgelöst von „dom.setSelection()“ auf Seite 252.

BeschreibungStellt die Auswahl im aktuellen Dokument ein. Mit dieser Funktion kann die Auswahl nur im aktuellen Dokument verschoben werden. Der Fokus kann nicht an ein anderes Dokument übergeben werden.


255


• Als Argumente werden der Anfangs- und der Endpunkt für die neue Auswahl übergeben, ausgedrückt in Form von Byte-Offsets im Quellcode des Dokuments. Wenn beide Zahlen übereinstimmen, handelt es sich bei der neuen Auswahl um eine Einfügemarke. Wenn die neue Auswahl keine gültige HTML-Auswahl darstellt, wird sie durch Einbeziehung weiterer Zeichen zur ersten gültigen HTML-Auswahl erweitert. Wenn beispielsweise mit offsetBegin und offsetEnd der Bereich SRC="myImage.gif" innerhalb von <IMG SRC="myImage.gif"> definiert wird, wird die Auswahl so erweitert, dass das vollständige IMG-Tag enthalten ist.

RückgabewerteKeine

Funktionen zur Behandlung von StringsMit Funktionen für Strings können Sie Informationen über Strings abrufen. Weiterhin lassen sich Strings von der Latin 1-Kodierung in plattformspezifische Kodierungen konvertieren und umgekehrt.

dreamweaver.doURLEncoding()


BeschreibungDiese Funktion konvertiert einen String und gibt einen als URL kodierten String zurück. Dazu werden alle Leerzeichen und Sonderzeichen durch angegebene Elemente ersetzt.

ArgumentestringToConvert

• Das Argument stringToConvert ist ein String mit der unkodierten URL, die die Funktion kodiert.

RückgabewerteEin als URL kodierter String

BeispielDas folgende Beispiel zeigt den Wert URL.value für "My URL-encoded string":

var URL = dw.doURLEncoding(theURL.value);

returns "My%20URL-encoded%20string"

dreamweaver.getTokens()


BeschreibungTeilt einen String in Tokens auf.


256

ArgumentesearchString, separatorCharacters

• Das Argument searchString ist der String, der in Tokens aufgeteilt werden soll.

• separatorCharacters sind die Zeichen, die das Ende eines Tokens darstellen. Trennzeichen in Strings, die in Hochkommata eingeschlossen sind, werden ignoriert. Wenn in separatorCharacters Leerraumzeichen (wie Tabstopp-Zeichen) enthalten sind, werden sie als Trennzeichen behandelt, als ob sie explizit definiert worden wären. Zwei oder mehr Leerraumzeichen werden als einfaches Trennzeichen behandelt.

RückgabewerteEin Array von Token-Strings.

BeispielDer folgende Aufruf der Funktion dw.getTokens() gibt die Tokens zurück, die darauf folgen:

dreamweaver.getTokens('foo("my arg1", 34)', '(),')

• foo

• "my arg 1"

• 34

dreamweaver.latin1ToNative()


BeschreibungKonvertiert einen in Latin 1-Kodierung vorliegenden String in die plattformspezifische Kodierung des jeweiligen Computers. Diese Funktion dient dazu, die Benutzerschnittstelle einer Erweiterungsdatei in einer anderen Sprache anzuzeigen.

Hinweis: Unter Windows hat dies keine Auswirkung, da Kodierungen in Windows ohnehin bereits auf Latin 1 basieren.


• Das Argument stringToConvert ist der String, der von der Latin 1-Kodierung in die plattformspezifische Kodierung konvertiert werden soll.

RückgabewerteDer konvertierte String

dreamweaver.nativeToLatin1()


BeschreibungKonvertiert einen in der plattformspezifischen Kodierung vorliegenden String in Latin 1.

Hinweis: Unter Windows hat dies keine Auswirkung, da Kodierungen in Windows ohnehin bereits auf Latin 1 basieren.


• Das Argument stringToConvert ist der String, der von der plattformspezifischen Kodierung in die Latin 1-Kodierung konvertiert werden soll.


257

RückgabewerteDer konvertierte String

dreamweaver.scanSourceString()


BeschreibungAnalysiert einen HTML-String und ermittelt die Tags, Attribute, Anweisungen und Textbereiche. scanSourceString() ruft für alle gefundenen Tags, Attribute, Anweisungen und Textbereiche eine Rückruf-Funktion auf, die Sie bereitstellen müssen. Dreamweaver bietet folgende Rückruf-Funktionen:

• openTagBegin()

• openTagEnd()

• closeTagBegin()

• closeTagEnd()

• directive()

• attribute()

• text()

Dreamweaver ruft diese sieben Rückruf-Funktionen in folgenden Fällen auf:

1 Dreamweaver ruft openTagBegin() für alle Anfangs-Tags auf (z. B. <font>, nicht jedoch </font>) und alle leeren Tags (wie <img> oder <hr>). Die Funktion openTagBegin() akzeptiert zwei Argumente: den Namen des Tags (wie "font" oder "img") und den Dokument-Offset. Letzteres entspricht der Byte-Anzahl, die im Dokument vor dem Anfang des Tags steht. Die Funktion gibt true zurück, wenn die Analyse fortgesetzt werden soll, und false, wenn die Analyse abgebrochen werden soll.

2 Nach der Ausführung von openTagBegin() ruft Dreamweaver für jedes HTML-Attribut die Funktion attribute() auf. Die Funktion attribute() akzeptiert zwei Argumente: einen String mit dem Namen des Attributs (z. B. "color" oder "src") und einen String mit dem Wert des Attributs (wie "#000000" oder "foo.gif"). Die Funktion attribute() gibt einen Booleschen Wert zurück, der angibt, ob die Analyse fortgesetzt werden soll.

3 Nachdem alle im Tag enthaltenen Attribute analysiert wurden, ruft Dreamweaver die Funktion openTagEnd() auf. Die Funktion openTagEnd() akzeptiert ein Argument: den Dokument-Offset, der der Anzahl der Byte entspricht, die im Dokument vor dem Ende des Anfangs-Tags auftreten. Sie gibt einen Booleschen Wert zurück, der angibt, ob die Analyse fortgesetzt werden soll.

4 Dreamweaver ruft closeTagBegin() für alle schließenden Tags auf (z. B. </font>). Diese Funktion akzeptiert zwei Argumente: den Namen des zu schließenden Tags (wie "font") und den Dokument-Offset. Letzteres entspricht der Byte-Anzahl, die im Dokument vor dem Anfang des schließenden Tags steht. Die Funktion gibt einen Booleschen Wert zurück, der angibt, ob die Analyse fortgesetzt werden soll.

5 Nach der Rückgabe der Funktion closeTagBegin() ruft Dreamweaver closeTagEnd() auf. Die Funktion closeTagEnd() akzeptiert ein Argument: den Dokument-Offset, der der Anzahl der Byte entspricht, die im Dokument vor dem Ende des Schluss-Tags auftreten. Sie gibt einen Booleschen Wert zurück, der angibt, ob die Analyse fortgesetzt werden soll.

6 Dreamweaver ruft die Funktion directive() für alle HTML-Kommentare sowie ASP-, JSP- und PHP-Skripts auf. Die Funktion directive() akzeptiert zwei Argumente: einen String mit der Anweisung und den Dokument-Offset. Letzteres entspricht der Anzahl der Byte, die im Dokument vor dem Ende des Schluss-Tags auftreten. Die Funktion gibt einen Booleschen Wert zurück, der angibt, ob die Analyse fortgesetzt werden soll.


258

7 Dreamweaver ruft die Funktion text() für alle Textbereiche im Dokument auf, das heißt für alle Bereiche, bei denen es sich weder um Tags noch um Anweisungen handelt. Diese Textbereiche sind nicht unbedingt im Benutzerdokument sichtbar, sondern sie können sich beispielsweise innerhalb eines Tags <title> oder <option> befinden. Die Funktion text() akzeptiert zwei Argumente: einen String mit dem Text und den Dokument-Offset. Letzteres entspricht der Byte-Anzahl, die im Dokument vor dem Ende des schließenden Tags steht. Die Funktion text() gibt einen Booleschen Wert zurück, der angibt, ob die Analyse fortgesetzt werden soll.

ArgumenteHTMLstr, parserCallbackObj

• Das Argument HTMLstr ist ein String mit Code.

• parserCallbackObj ist ein JavaScript-Objekt, das über eine oder mehrere der folgenden Methoden verfügt: openTag-Begin(), openTagEnd(), closeTagBegin(), closeTagEnd(), directive(), attribute() und text(). Damit eine optimale Leistung erzielt werden kann, sollte es sich bei parserCallbackObj um eine freigegebene Bibliothek handeln, die mit der Schnittstelle für die C-Level-Erweiterbarkeit definiert wurde. Die Leistung wird auch verbessert, wenn parserCallbackObj nur die tatsächlich benötigten Rückruf-Funktionen definiert.

RückgabewerteEin Boolescher Wert: true, wenn der Vorgang erfolgreich war, andernfalls false.

BeispielDie folgenden Schritte sind ein Beispiel für die Verwendung der Funktion dreamweaver.scanSourceString():

1 Erstellen Sie eine Implementierung für eine oder mehrere der sieben Rückruf-Funktionen.

2 Schreiben Sie ein Skript, das die Funktion dreamweaver.scanSourceString() aufruft.

3 Die Funktion dreamweaver.scanSourceString() übergibt einen String mit HTML und Verweisen an die Rückruf-Funktionen, die Sie geschrieben haben. Der HTML-String lautet beispielsweise "<font size=2>hallo</font>".

4 Dreamweaver analysiert diesen String und stellt fest, dass er ein font-Tag enthält. Daraufhin ruft Dreamweaver die Rückruf-Funktionen in folgender Reihenfolge auf:

• Die Funktion openTagBegin()

• Die Funktion attribute() (für das size-Attribut)

• Die Funktion openTagEnd()

• Die Funktion text() (für den String "hallo")

• Die Funktionen closeTagBegin() und closeTagEnd()

ÜbersetzungsfunktionenÜbersetzungsfunktionen werden entweder direkt auf Übersetzer oder auf die Ergebnisse von Übersetzungen angewendet. Es lassen sich Informationen über Übersetzer abrufen, Übersetzer ausführen und Inhalte von gesperrten Bereichen bearbeiten. Darüber hinaus kann festgelegt werden, dass beim Abrufen und Einstellen von Auswahl-Offsets die übersetzte Quelle verwendet werden soll.

dom.runTranslator()


BeschreibungDiese Funktion führt den angegebenen Übersetzer für das Dokument aus. Diese Funktion ist nur für das aktive Dokument gültig.


259

ArgumentetranslatorName

• Das Argument translatorName ist der Name des Übersetzers, wie er in den Voreinstellungen für die Übersetzung angegeben ist.

RückgabewerteKeine

dreamweaver.editLockedRegions()


BeschreibungMacht gesperrte Bereiche bearbeitbar bzw. nicht bearbeitbar, je nach dem Wert des Arguments. Standardmäßig sind gesperrte Bereiche nicht bearbeitbar. Wenn Sie versuchen, einen gesperrten Bereich zu bearbeiten, ohne ihn zuvor ausdrücklich mit dieser Funktion als bearbeitbar gekennzeichnet zu haben, wird ein Warnton ausgegeben, und die Änderung wird nicht akzeptiert.

Hinweis: Das Bearbeiten gesperrter Bereiche kann ungewollte Folgen für Bibliothekselemente und Vorlagen haben. Sie sollten diese Funktion daher nicht außerhalb von Datenübersetzern verwenden.

ArgumentebAllowEdits

• Das Argument bAllowEdits ist ein Boolescher Wert: true, wenn das Bearbeiten erlaubt ist, andernfalls false. Für gesperrte Bereiche wird nach Beendigung des aufrufenden Skripts automatisch wieder der Standardstatus (nicht bearbeitbar) hergestellt.

RückgabewerteKeine

dreamweaver.getTranslatorList()


BeschreibungDiese Funktion ruft eine Liste der installierten Übersetzer ab.

ArgumenteKeine

RückgabewerteEin Array von Strings, die die Namen der Übersetzer enthalten, wie sie in den Übersetzungsvoreinstellungen angezeigt werden.


260

dreamweaver.useTranslatedSource()


BeschreibungLegt die Werte fest, die von dom.nodeToOffsets() und dom.getSelection() zurückgegeben werden. Diese Werte werden von dom.offsetsToNode() und dom.setSelection() verwendet und stellen Offsets in den übersetzten Quellcode dar (der im DOM nach der Ausführung eines Übersetzers enthaltene HTML-Code), nicht für den nicht übersetzten Quellcode.

Hinweis: Diese Funktion ist nur bei Eigenschafteninspektor-Dateien relevant.

ArgumentebUseTranslatedSource

• Das Argument bUseTranslatedSource ist ein Boolescher Wert: true, wenn die Funktion Offsets im übersetzten Quellcode verwendet, oder false, wenn die Funktion den nicht übersetzten Quellcode verwendet.

Der Standardwert für das Argument lautet false. Für nachfolgende Aufrufe von dw.getSelection(), dw.setSelection(), dw.nodeToOffsets() und dw.offsetsToNode() wird nach Beendigung des Skripts, das dw.useTranslatedSource() aufge-rufen hat, automatisch der unübersetzte Quellcode verwendet, falls dw.useTranslatedSource() nicht bereits zuvor explizit mit dem Argument false aufgerufen wurde.

RückgabewerteKeine

XSLT-FunktionenXSLT-Funktionen verarbeiten XML-Dateien. Diese Funktionen rufen Informationen über XML-Dokumente ab, einschließlich des Schemabaums oder der Referenz auf ein XML-Dokument und fordern den Benutzer auf, das mit dem aktuellen XSLT-Dokument verbundene XML-Dokument anzugeben.

MMXSLT.getXML()


BeschreibungRuft einen XML-Quellstring für eine XML-Datei ab.

ArgumentexmlSourceURI

• Ein String, der einen URI zu einer XML-Datei darstellt. Dieser kann absolut (http oder https), site-bezogen oder dokumentbezogen sein.

RückgabewerteEin String, der die Inhalte der XML-Datei enthält.

Beispielvar xmlSource = MMXSLT.getXML(this.fileDataSetURL);


261

MMXSLT.getXMLSchema()


BeschreibungDiese Funktion liefert den Schemabaum der angegebenen XML-Datei.

ArgumenteschemaURI, {bRefresh}

• Das erforderliche Argument schemaURI ist ein String, der eine Referenz auf eine lokale oder Remote-XML-Datei darstellt.

• Das optionale Argument bRefresh ist ein Boolescher Wert. true erzwingt eine Aktualisierung des Schemas; false gibt eine Kopie des Schemas aus dem XML-Schema-Cache zurück. Der Standardwert ist false.

RückgabewerteEin String, der den XML-Schemabaum enthält.

BeispielIm folgenden Beispiel wird der Schemabaum aus dem XML-Schema-Cache für menus.xml abgerufen.

var theSchema = MMXSLT.getXMLSchema("file:///c:/Programdateien(Adobe/¬

Adobe Dreamweaver CS3/Configuration/Menus/menus.xml"");

MMXSLT.getXMLSourceURI()


BeschreibungDiese Funktion ruft eine Referenz auf das mit dem aktuellen XSLT-Dokument verbundene XML-Quelldokument ab.

ArgumentexsltfileURI, {bUseTempForRemote}

• Das Argument xsltfileURI ist ein String mit dem lokalen Datei-URI, der auf den Speicherort der XSL-Datei zeigt.

• Das optionale Argument bUseTempForRemote ist ein Boolescher Wert. true gibt eine Referenz auf die temporäre XML-Datei zurück (z. B. file:///C:/Dokumente und Einstellungen/Benutzername/Lokale Einstellungen/Temporary Internet Files/Content.IE5/GTSLQ9KZ/rss[1].xml), die heruntergeladen wird, wenn die ursprüngliche XML-Datei remote ist (z. B. http://myHost/rssfeed.xml); false gibt eine absolute Referenz zurück.

RückgabewerteEin String, der eine Referenz auf das mit dem aktuellen XSLT-Dokument verbundene XML-Quelldokument enthält. Handelt es sich bei der XML-Quellreferenz um eine Remote-Referenz, gibt die Funktion den heruntergeladenen Dateipfad zum temporären Speicherort zurück.

BeispielIm folgenden Beispiel wird die Referenz auf das mit c:\myxslt\myxsltdocument.xsl verbundene XML-Quelldokument abgerufen:

var theXMLSource = MMXSLT.getXMLSourceURI("file:///c:/myxslt/myxsltdocument.xsl");


262

MMXSLT.launchXMLSourceDialog()


BeschreibungDiese Funktion fordert den Benutzer auf, das mit dem aktuellen XSLT-Dokument verbundene XML-Quelldokument anzugeben. Der Benutzer kann entweder eine lokale oder eine Remote-Referenz auf ein XML-Dokument angeben.

Argumente{xsltfileURI, bUseTempForRemote, bAddSchemaReference}

• Das Argument xsltfileURI ist optional. Es ist ein String, der den lokalen Datei-URI bezeichnet, der auf den Speicherort der XSL-Datei zeigt. Bei fehlendem Argument gilt als Standardwert das aktuell geöffnete Dokument.

• Das optionale Argument bUseTempForRemote ist ein Boolescher Wert. true gibt eine Referenz auf die temporäre XML-Datei zurück (z. B. file:///C:/Dokumente und Einstellungen/Benutzername/Lokale Einstellungen/Temporary Internet Files/Content.IE5/GTSLQ9KZ/rss[1].xml), die heruntergeladen wird, wenn die ursprüngliche XML-Datei remote ist (z. B. http://myHost/rssfeed.xml); false gibt eine absolute Referenz zurück.

• Das Argument bAddSchemaReference ist optional. Es fügt eine Referenz in das aktuelle Dokument ein, die auf den XML-Quell-URI verweist, der im Dialogfeld XML-Quelle angegeben wurde. Bei fehlendem Argument gilt als Standardwert das aktuell geöffnete Dokument.

RückgabewerteEin String, der eine Referenz auf das mit dem aktuellen XSLT-Dokument verbundene XML-Quelldokument enthält. Handelt es sich bei der XML-Quellreferenz um eine Remote-Referenz, gibt die Funktion den heruntergeladenen Dateipfad zum temporären Speicherort zurück.

BeispielIm folgenden Beispiel wird das Dialogfenster XML-Quelle ohne Angabe von Werten gestartet:

MMXSLT.launchXMLSourceDialog()

263

Kapitel 15: Seiteninhalt

Die Seiteninhaltsfunktionen von Adobe® Dreamweaver® CS3 führen Operationen durch, die sich auf den Inhalt einer Webseite auswirken. Zu diesen Operationen zählen die Bearbeitung von Elementen im Bedienfeld Elemente, das Hinzu-fügen von Verhalten, das Ausschneiden und Einfügen von Elementen in die bzw. aus der Zwischenablage, die Anwendung von Vorlagen, das Einfügen von Codefragmenten, das Erstellen von Spry XML-Datensätzen, das erweiterte Bearbeiten von Spry-Widgets und anderen Widgets sowie das Einfügen von Widgets. In diesem Kapitel werden auch die Funktionen zur Browserkompatibilitätsprüfung beschrieben, mit deren Hilfe Benutzer Seitenlayouts erstellen können, die in verschiedenen Browsern verwendet werden können.


• „Funktionen des Bedienfelds „Elemente““ auf Seite 263

• „Verhaltensfunktionen“ auf Seite 272

• „Zwischenablagefunktionen“ auf Seite 279

• „Bibliotheks- und Vorlagenfunktionen“ auf Seite 284

• „Codefragmente (Bedienfeld), Funktionen“ auf Seite 289

• „Bearbeitungsfunktionen für Spry-Widgets“ auf Seite 292

• „Funktionen zum Einfügen von Spry-Widgets“ auf Seite 294

• „Funktionen für die Browserkompatibilitätsprüfung“ auf Seite 296

Funktionen des Bedienfelds „Elemente“Mit den Funktionen des Bedienfelds Elemente (als asset.Palette in der API programmiert) können Sie die Elemente im Bedienfeld verwalten und einsetzen (bei diesen Elementen kann es sich um Vorlagen, Bibliotheken, Bilder, Adobe Shockwave- und Adobe Flash-Inhalt, URLs, Farben und Skripts handeln).

dreamweaver.assetPalette.addToFavoritesFromDocument()


BeschreibungFügt der Favoritenliste das Element hinzu, das im Dokumentfenster ausgewählt ist. Diese Funktion kann nur für Bilder, Shockwave- und Flash-Dateien, Schriftfarben und URLs eingesetzt werden.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.addToFavoritesFromSiteAssets()



264

BeschreibungFügt der Favoritenliste die Elemente hinzu, die in der Siteliste ausgewählt sind, und weist jedem Element in der Favoriten-liste einen Kurznamen zu. Dadurch werden die Elemente nicht aus der Siteliste entfernt.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.addToFavoritesFromSiteWindow()


BeschreibungFügt der Favoritenliste die Elemente hinzu, die im Bedienfeld Site oder in der Sitemap ausgewählt sind. Diese Funktion kann nur für Bilder, Filme, Skripts, Shockwave- und Flash-Dateien sowie (bei der Sitemap) für URLs eingesetzt werden. Wenn andere Dateien oder Ordner ausgewählt sind, werden sie ignoriert.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.copyToSite()


BeschreibungKopiert ausgewählte Elemente in eine andere Site und fügt sie der Favoritenliste jener Site hinzu. Wenn es sich bei den Elementen nicht um Farben oder URLs, sondern um Dateien handelt, wird die jeweilige Datei in die andere Site kopiert.

ArgumentetargetSite

• Das Argument targetSite ist der Name der Ziel-Site, der vom Aufruf site.getSites() zurückgegeben wird.

RückgabewerteKeine

dreamweaver.assetPalette.edit()


BeschreibungBearbeitet ausgewählte Elemente mit dem primären externen Editor oder mit dem Steuerelement Custom Edit. Bei Farben wird die Farbauswahl eingeblendet. Bei URLs wird ein Dialogfeld eingeblendet, und der Benutzer wird aufgefordert, eine URL und einen Kurznamen einzugeben. Diese Funktion steht für die Siteliste der Farben und URLs nicht zur Verfügung.

ArgumenteKeine


265

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.assetPalette.canEdit()“ auf Seite 424.

dreamweaver.assetPalette.getSelectedCategory()


BeschreibungGibt die aktuell ausgewählte Kategorie zurück.

ArgumenteKeine

RückgabewerteDie aktuell ausgewählte Kategorie, wobei es sich um eine der folgenden handeln kann: "templates", "library", "images", "movies", "shockwave", "flash", "scripts", "colors" oder "urls".

dreamweaver.assetPalette.getSelectedItems()


BeschreibungGibt ein Array der ausgewählten Elemente im Bedienfeld Elemente (Siteliste oder Favoritenliste) zurück.

ArgumenteKeine

RückgabewerteEin Array aus drei Strings für jedes ausgewählte Element:

• Der name-String, bei dem es sich um den im Bedienfeld Elemente angezeigten Namen bzw. Dateinamen oder Kurznamen handelt.

• Der value-String, bei dem es sich um den vollständigen Verzeichnispfad, die URL oder den Farbwert handelt, abhängig vom jeweils ausgewählten Element.

• Der type-String, bei dem es sich um "folder" oder eine der folgenden Kategorien handelt: "templates", "library", "images", "movies", "shockwave", "flash", "scripts", "colors" oder "urls".

Hinweis: Wenn im Bedienfeld Elemente keine Auswahl getroffen wurde, gibt diese Funktion ein Array mit einem leeren String zurück.

BeispielWenn die Kategorie „urls“ lautet und in der Favoritenliste der Ordner „MyFolderName“ und die URL „MyFavoriteURL“ ausgewählt sind, gibt die Funktion Folgendes zurück:

items[0] = "MyFolderName"

items[1] = "//path/FolderName"

items[2] = "folder"

items[3] = "MyFavoriteURL"

items[4] = "http://www.MyFavoriteURL.com"

items[5] = "urls"


266

dreamweaver.assetPalette.getSelectedView()


BeschreibungZeigt an, welche Liste aktuell im Bedienfeld Elemente angezeigt wird.

ArgumenteKeine

RückgabewerteGibt einen String mit dem Wert "site" oder "favorites" zurück.

dreamweaver.assetPalette.insertOrApply()


BeschreibungFügt die ausgewählten Elemente ein oder wendet das Element auf die aktuelle Auswahl an. Wendet Vorlagen, Farben und URLs auf die Auswahl an und fügt URLs und andere Elemente an der Einfügemarke ein. Diese Funktion steht nur zur Verfügung, wenn ein Dokument geöffnet ist.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.assetPalette.canInsertOrApply()“ auf Seite 424.

dreamweaver.assetPalette.locateInSite()


BeschreibungWählt Dateien aus, die mit den im lokalen Bereich des Bedienfelds Site ausgewählten Elementen verknüpft sind. Diese Funktion kann für Farben und URLs nicht eingesetzt werden. Sie steht sowohl in der Siteliste als auch in der Favoritenliste zur Verfügung. Wenn ein Ordner in der Favoritenliste ausgewählt ist, wird er ignoriert.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.newAsset()



267

BeschreibungErstellt ein neues Element für die aktuelle Kategorie in der Favoritenliste. Bei Bibliotheken und Vorlagen wird eine neue, leere Bibliotheks- oder Vorlagendatei erstellt, die sofort benannt werden kann. Bei Farben wird die Farbauswahl einge-blendet. Bei URLs wird ein Dialogfeld eingeblendet, und der Benutzer wird aufgefordert, eine URL und einen Kurznamen einzugeben. Diese Funktion steht für Bilder, Filme, Shockwave- oder Flash-Dateien und Skripts nicht zur Verfügung.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.newFolder()


BeschreibungErstellt in der aktuellen Kategorie einen neuen Ordner und weist diesem Ordner den Standardnamen („untitled“) zu. Der Standardname wird in einem Textfeld angezeigt. Diese Funktion steht nur in der Favoritenliste zur Verfügung.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.recreateLibraryFrom Document()


BeschreibungErsetzt die nicht mehr empfohlene Funktion libraryPalette, recreateLibraryFromDocument(). Erstellt für die ausge-wählte Instanz eines Bibliothekselements im aktuellen Dokument eine LBI-Datei. Die Wirkung ist dieselbe, wie wenn Sie im Eigenschafteninspektor auf Neu erstellen klicken.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.refreshSiteAssets()


BeschreibungAnalysiert die Site, wechselt zur Siteliste und füllt die Liste aus.

ArgumenteKeine


268

RückgabewerteKeine

dreamweaver.assetPalette.removeFromFavorites()


BeschreibungEntfernt die ausgewählten Elemente aus der Favoritenliste. Die zugehörigen Dateien auf der Festplatte werden dabei jedoch nicht gelöscht, es sei denn, es handelt sich um Bibliotheken oder Vorlagen. Bei diesen beiden Kategorien wird der Benutzer zur Bestätigung aufgefordert, bevor die Datei gelöscht wird. Diese Funktion steht nur in der Favoritenliste oder für die Kategorien library und templates zur Verfügung.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.renameNickname()


BeschreibungErmöglicht die Bearbeitung eines Ordnernamens oder eines Dateikurznamens, indem der vorhandene Name in einem Textfeld angezeigt wird. Diese Funktion steht nur in der Favoritenliste oder für die Kategorien library und templates zur Verfügung.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.assetPalette.setSelectedCategory()


BeschreibungZeigt eine andere Kategorie an.

ArgumentecategoryType

• Das Argument categoryType kann eine der folgenden Kategorien sein: "templates", "library", "images", "movies", "shockwave", "flash", "scripts", "colors" oder "urls".

RückgabewerteKeine


269

dreamweaver.assetPalette.setSelectedView()


BeschreibungWechselt zwischen der Anzeige der Siteliste und der Favoritenliste.

ArgumenteviewType

• Beim Argument viewType handelt es sich um einen String, der "site" oder "favorites" lauten kann.

RückgabewerteKeine

dreamweaver.libraryPalette.deleteSelectedItem() (veraltet)

VerfügbarkeitDreamweaver 3, in Dreamweaver 4 abgelöst von „dreamweaver.assetPalette.setSelectedCategory()“ auf Seite 268 und einem darauffolgenden Aufruf von „dreamweaver.assetPalette.removeFromFavorites()“ auf Seite 268.

BeschreibungDiese Funktion entfernt das ausgewählte Bibliothekselement aus dem Bedienfeld Bibliothek und löscht die zugehörige LBI-Datei aus dem Ordner Library im Stamm der aktuellen Site. Instanzen des gelöschten Elements können immer noch auf Seiten der Site vorhanden sein.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.libraryPalette.getSelectedItem() (veraltet)

VerfügbarkeitDreamweaver 3, in 4 abgelöst von „dreamweaver.assetPalette.getSelectedItems()“ auf Seite 265.

BeschreibungDiese Funktion ruft den Pfad des ausgewählten Bibliothekselements ab.

ArgumenteKeine

RückgabewerteEin String mit dem Pfad des Bibliothekselements, ausgedrückt im URL-Format „file://“.

dreamweaver.libraryPalette.newFromDocument() (veraltet)

VerfügbarkeitDreamweaver 3, in Dreamweaver 4 abgelöst von „dreamweaver.assetPalette.setSelectedCategory()“ auf Seite 268 und einem darauffolgenden Aufruf von „dreamweaver.assetPalette.newAsset()“ auf Seite 266.

BeschreibungDiese Funktion erstellt basierend auf der Auswahl im aktuellen Dokument ein neues Bibliothekselement.


270

ArgumentebReplaceCurrent

• Das Argument bReplaceCurrent ist ein Boolescher Wert, der angibt, ob die Auswahl durch eine Instanz des neu erstellten Bibliothekselements ersetzt werden soll.

RückgabewerteKeine

dreamweaver.libraryPalette.recreateFromDocument() (veraltet)

VerfügbarkeitDreamweaver 3, in Dreamweaver 4 abgelöst von „dreamweaver.assetPalette.recreateLibraryFrom Document()“ auf Seite 267.

BeschreibungDiese Funktion erstellt für die ausgewählte Instanz eines Bibliothekselements im aktuellen Dokument eine LBI-Datei. Die Wirkung ist dieselbe, wie wenn Sie im Eigenschafteninspektor auf Neu erstellen klicken.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.libraryPalette.renameSelectedItem() (veraltet)

VerfügbarkeitDreamweaver 3; abgelöst in Dreamweaver 4 von „dreamweaver.assetPalette.setSelectedCategory()“ auf Seite 268 mit "library" als Argumentwert und einem darauffolgenden Aufruf von „dreamweaver.assetPalette.renameNickname()“ auf Seite 268.

BeschreibungDiese Funktion wandelt den Namen des ausgewählten Bibliothekselements in ein Textfeld um, in dem der Benutzer die Auswahl umbenennen kann.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.referencePalette.getFontSize()

Verfügbarkeit Dreamweaver 4.

Beschreibung Gibt die aktuelle Schriftgröße aus dem Anzeigebereich des Bedienfelds Referenz zurück.

Argumente Keine

Rückgabewerte Die relative Schriftgröße: small, medium oder large.


271

dreamweaver.referencePalette.setFontSize()

Verfügbarkeit Dreamweaver 4.

Beschreibung Ändert die Schriftgröße im Bedienfeld Referenz.

Argumente fontSize

• Das Argument fontSize ist eine der folgenden relativen Größen: small, medium oder large.

Rückgabewerte Keine

dreamweaver.templatePalette.deleteSelectedTemplate() (veraltet)

VerfügbarkeitDreamweaver 3; abgelöst in Dreamweaver 4 von „dreamweaver.assetPalette.setSelectedCategory()“ auf Seite 268 mit "templates" als Argumentwert und einem darauffolgenden Aufruf von „dreamweaver.assetPalette.removeFromFavo-rites()“ auf Seite 268.

BeschreibungDiese Funktion löscht die ausgewählte Vorlage aus dem Vorlagenordner.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.templatePalette.getSelectedTemplate() (veraltet)

VerfügbarkeitDreamweaver 3, in 4 abgelöst von „dreamweaver.assetPalette.getSelectedItems()“ auf Seite 265.

BeschreibungDiese Funktion ruft den Pfad der ausgewählten Vorlage ab.

ArgumenteKeine

RückgabewerteEin String mit dem Pfad der Vorlage, ausgedrückt im URL-Format „file://“.

dreamweaver.templatePalette.renameSelectedTemplate() (veraltet)

VerfügbarkeitDreamweaver 3; abgelöst in Dreamweaver 4 von „dreamweaver.assetPalette.setSelectedCategory()“ auf Seite 268 mit "templates" als Argumentwert und einem darauffolgenden Aufruf von „dreamweaver.assetPalette.renameNickname()“ auf Seite 268.


272

BeschreibungDiese Funktion wandelt den Namen der ausgewählten Vorlage in ein Textfeld um, in dem der Benutzer die Auswahl umbenennen kann.

ArgumenteKeine

RückgabewerteKeine

Verhaltensfunktionen Mit Verhaltensfunktionen können Sie einem Objekt Verhalten hinzufügen und daraus entfernen. Außerdem lassen sich die mit einem Objekt verknüpften Verhalten bestimmen, Informationen über die mit Verhalten verknüpften Objekte abrufen und vieles mehr. Die Methoden des Objekts dreamweaver.behaviorInspector gelten für die Auswahl im Bedienfeld Verhalten, nicht die im aktuellen Dokument.

dom.addBehavior()


BeschreibungFügt dem ausgewählten Element ein neues Ereignis-Aktion-Paar hinzu. Diese Funktion ist nur für das aktive Dokument gültig.

Argumenteevent, action, {eventBasedIndex}

• Das Argument event bezeichnet die JavaScript-Ereignisprozedur, die zum Verknüpfen des Verhaltens mit dem Element verwendet werden soll (beispielsweise onClick, onMouseOver oder onLoad).

• Beim Argument action handelt es sich um den Funktionsaufruf, der von applyBehavior() zurückgegeben wird, wenn die Aktion mit dem Bedienfeld Verhalten hinzugefügt wird, beispielsweise "MM_popupMsg('Hello World')".

• Das Argument eventBasedIndex (optional) bezeichnet die Position, an der diese Aktion hinzugefügt werden soll. Das Argument eventBasedIndex ist ein nullbasierter Index. Wenn mit dem angegebenen Ereignis bereits zwei Aktionen verknüpft sind und für eventBasedIndex der Wert 1 festgelegt wird, wird die Aktion zwischen den anderen beiden ausgeführt. Bei Auslassung dieses Arguments wird die Aktion nach allen anderen Aktionen ausgeführt, die für das Ereignis definiert sind.

RückgabewerteKeine

dom.getBehavior()


BeschreibungRuft die Aktion an der angegebenen Position innerhalb des jeweiligen Ereignisses ab. Diese Funktion wirkt sich auf die aktuelle Auswahl aus und ist nur für das aktive Dokument gültig.


273

Argumenteevent, {eventBasedIndex}

• Das Argument event bezeichnet die JavaScript-Ereignisprozedur, über die die Aktion mit dem Element verknüpft wird (beispielsweise onClick, onMouseOver oder onLoad).

• Das Argument eventBasedIndex (optional) bezeichnet die Position der abzurufenden Aktion. Wenn beispielsweise zwei Aktionen mit dem Ereignis verknüpft sind, bezeichnet 0 die erste und 1 die zweite Aktion. Bei Auslassung dieses Arguments gibt die Funktion alle Aktionen für das betreffende Ereignis zurück.

RückgabewerteEin String mit dem Funktionsaufruf (Beispiel: "MM_swapImage('document.Image1','document.Image1','foo.gif','#933292969950')") oder ein Array von Strings, wenn eventBasedIndex weggelassen wird.

dom.reapplyBehaviors()


BeschreibungÜberprüft, ob die Funktionen, die an dem betreffenden Knoten mit Verhaltensaufrufen verknüpft sind, sich im Bereich HEAD des Dokuments befinden. Wenn nicht, werden sie eingefügt.

ArgumenteelementNode

• Das Argument elementNode ist ein Elementknoten im aktuellen Dokument. Bei Auslassung des Arguments werden alle Elementknoten im Dokument auf verwaiste Verhaltenaufrufe überprüft.

RückgabewerteKeine

dom.removeBehavior()


BeschreibungEntfernt die Aktion an der angegebenen Position des jeweiligen Ereignisses. Diese Funktion wirkt sich auf die aktuelle Auswahl aus und ist nur für das aktive Dokument gültig.

Argumenteevent, {eventBasedIndex}

• Das Argument event bezeichnet die Ereignisprozedur, über die die Aktion mit dem Element verknüpft wird (beispiels-weise onClick, onMouseOver oder onLoad). Bei Auslassung des Arguments werden alle Aktionen vom Element entfernt.

• Das Argument eventBasedIndex (optional) bezeichnet die Position der zu entfernenden Aktion. Wenn beispielsweise zwei Aktionen mit dem Ereignis verknüpft sind, bezeichnet 0 die erste und 1 die zweite Aktion. Bei Auslassung dieses Arguments werden alle Aktionen für das betreffende Ereignis entfernt.

RückgabewerteKeine


274

dreamweaver.getBehaviorElement()


BeschreibungRuft das DOM-Objekt ab, das dem Tag entspricht, auf das das Verhalten angewendet wird. Diese Funktion ist nur für Verhaltensdateien gültig.

ArgumenteKeine

RückgabewerteEin DOM-Objekt oder null-Wert. In folgenden Fällen wird null zurückgegeben:

• Wenn das aktuelle Skript nicht im Zusammenhang mit dem Bedienfeld Verhalten ausgeführt wird

• Wenn mit dem Bedienfeld Verhalten ein Verhalten in einer Zeitleiste bearbeitet wird

• Wenn das momentan ausgeführte Skript von dreamweaver.popupAction() aufgerufen wurde.

• Wenn das Bedienfeld Verhalten ein Ereignis mit einem Hyperlink-Wrapper verknüpft, der noch nicht existiert

• Wenn diese Funktion außerhalb einer Aktionsdatei auftritt

BeispielMit der Funktion dreamweaver.getBehaviorElement() kann auf die gleiche Weise wie mit „dreamweaver.getBeha-viorTag()“ auf Seite 275 bestimmt werden, ob die ausgewählte Aktion für das ausgewählte HTML-Tag zulässig ist. Es werden hier aber zusätzliche Informationen über das Tag und seine Attribute bereitgestellt. Wie im folgenden Beispiel dargestellt, können Sie, wenn Sie eine Aktion schreiben, die nur auf einen Hyperlink (A HREF) angewendet werden kann, der nicht auf einen anderen Frame oder ein anderes Fenster verweist, getBehaviorElement() in der Initialisierungs-funktion für die Benutzerschnittstelle des Dialogfelds Parameter verwenden:

function initializeUI(){

var theTag = dreamweaver.getBehaviorElement();

var CANBEAPPLIED = (theTag.tagName == "A" && ¬

theTag.getAttribute("HREF") != null && ¬

theTag.getAttribute("TARGET") == null);

if (CANBEAPPLIED) {

// UI der Aktion anzeigen

} else {

// nützliche Meldung anzeigen, die dem Benutzer mitteilt,

// dass diese Aktion nur auf einen

// Hyperlink ohne bestimmtes Ziel angewendet werden kann

}

}

dreamweaver.getBehaviorEvent() (veraltet)

VerfügbarkeitDreamweaver 1.2; in 2.0 nicht mehr empfohlen, da Aktionen jetzt vor Ereignissen ausgewählt werden.

BeschreibungDiese Funktion ruft in einer Verhaltensaktionsdatei das Ereignis ab, das diese Aktion auslöst.

ArgumenteKeine


275

RückgabewerteEin String, der das Ereignis darstellt. Dies ist der gleiche String, der als Argument (event) an die Funktion canAcceptBe-havior() übergeben wird.

dreamweaver.getBehaviorTag()

VerfügbarkeitDreamweaver 1.2.

BeschreibungRuft den Quellcode des Tags ab, auf das das Verhalten angewendet wird. Diese Funktion ist nur in Aktionsdateien gültig.

ArgumenteKeine

RückgabewerteEin String mit dem Quellcode des Tags. Dies ist der gleiche String, der als Argument (HTMLelement) an die Funktion canAcceptBehavior() übergeben wird. Wenn diese Funktion außerhalb einer Aktionsdatei auftritt, wird ein leerer String zurückgegeben.

BeispielWenn Sie eine Aktion schreiben, die nur auf einen Hyperlink (A HREF) angewendet werden kann, können Sie die Funktion getBehaviorTag() in der Initialisierungsfunktion für die Benutzerschnittstelle des Dialogfelds Parameter verwenden, wie im folgenden Beispiel dargestellt:

function initializeUI(){

var theTag = dreamweaver.getBehaviorTag().toUpperCase();

var CANBEAPPLIED = (theTag.indexOf('HREF') != -1));

if (CANBEAPPLIED) {

// UI der Aktion anzeigen

} else {

// nützliche Meldung anzeigen, die dem Benutzer mitteilt,

// dass diese Aktion nur auf einen

// Hyperlink angewendet werden kann

}

}

dreamweaver.popupAction()


BeschreibungRuft das Dialogfeld Parameter für die betreffende Verhaltensaktion auf. Für den Benutzer ist die Wirkung dieselbe, als würde er die Aktion im Bedienfeld Verhalten im Popupmenü der Aktionen auswählen. Mit dieser Funktion können Erwei-terungsdateien, die nicht Aktionen sind, Verhalten mit Objekten im Benutzerdokument verknüpfen. Andere Bearbeitungs-vorgänge sind so lange gesperrt, bis der Benutzer das Dialogfeld schließt.

Hinweis: Diese Funktion kann innerhalb der Funktion objectTag() oder einem Skript in einer Befehlsdatei oder Eigenschaf-teninspektor-Datei aufgerufen werden.


276

ArgumenteactionName, {funcCall}

• Das Argument actionName ist der Name einer Datei im Ordner Configuration\Behaviors\Actions, die eine JavaScript-Verhaltensaktion enthält (zum Beispiel "Timeline/Play Timeline.htm").

• Das Argument funcCall (optional) ist ein String mit einem Funktionsaufruf für die in actionName angegebene Aktion (zum Beispiel "MM_playTimeline(...)"). Dieses Argument wird, falls angegeben, von der Funktion applyBehavior() in der Aktionsdatei bereitgestellt.

RückgabewerteDer Funktionsaufruf für die Verhaltensaktion. Wenn der Benutzer im Dialogfeld Parameter auf OK klickt, wird das Verhalten dem aktuellen Dokument hinzugefügt (die entsprechenden Funktionen stehen im Bereich HEAD, am Anfang des Bereichs BODY kommt eventuell HTML-Code hinzu, und auch andere Änderungen können vorgenommen werden). Der Funktionsaufruf (zum Beispiel "MM_playTimeline(...)") wird dem Dokument nicht hinzugefügt, sondern wird zum Rückgabewert dieser Funktion.

dreamweaver.behaviorInspector.getBehaviorAt()


BeschreibungRuft das Ereignis-Aktion-Paar an der angegebenen Position im Bedienfeld Verhalten ab.

ArgumentepositionIndex

• Das Argument positionIndex ist die Position der Aktion im Bedienfeld Verhalten. Die erste Aktion in der Liste befindet sich auf Position 0.

RückgabewerteEin Array mit zwei Elementen:

• Eine Ereignisprozedur

• Ein Funktionsaufruf bzw. eine JavaScript-Anweisung

BeispielWenn im Bedienfeld Verhalten die Liste wie abgebildet angezeigt wird (positionIndex ist nullbasiert), wird beim Aufruf von dreamweaver.behaviorInspector.getBehaviorAt(2) ein Array mit zwei Strings zurückgegeben: "onMouseOver" und "MM_changeProp('document.moon','document.moon','src','sun.gif',

dreamweaver.behaviorInspector.getBehaviorCount()


BeschreibungZählt die mit dem aktuell ausgewählten Element über Ereignisprozeduren verknüpften Aktionen.

ArgumenteKeine

RückgabewerteEine Ganzzahl für die Anzahl der Aktionen, die mit einem Element verknüpft sind. Dieser Wert entspricht der im Bedienfeld Verhalten angezeigten Anzahl von Aktionen und beinhaltet sowohl Dreamweaver-Verhaltensaktionen als auch benutzerdefinierten JavaScript-Code.


277

BeispielBeim Aufruf von dreamweaver.behaviorInspector.getBehaviorCount() für den ausgewählten Hyperlink <A HREF="javascript:setCookie()" onClick="MM_popupMsg('Es wurde ein Cookie gesetzt.');parent.right-

frame.location.href='aftercookie.html'"> wird der Wert 2 zurückgegeben.

dreamweaver.behaviorInspector.getSelectedBehavior()


BeschreibungRuft die Position der Aktion im Bedienfeld Verhalten ab.

ArgumenteKeine

RückgabewerteEine Ganzzahl für die Position der ausgewählten Aktion im Bedienfeld Verhalten, oder –1, wenn keine Aktion ausgewählt ist.

BeispielWenn im Bedienfeld Verhalten die erste Aktion ausgewählt ist, wie in der folgenden Abbildung dargestellt, wird beim Aufruf von dreamweaver.behaviorInspector.getSelectedBehavior() der Wert 0 zurückgegeben.

dreamweaver.behaviorInspector.moveBehaviorDown()


BeschreibungVerschiebt eine Verhaltensaktion für ein Ereignis in der Ausführungsreihenfolge nach unten.



RückgabewerteKeine


278

BeispielWenn das Bedienfeld Verhalten wie in der folgenden Abbildung dargestellt eingerichtet ist, werden durch den Aufruf von dreamweaver.behaviorInspector.moveBehaviorDown(2) die Positionen der Aktionen PreloadImages und Change Property beim Ereignis onMouseDown vertauscht. Der Aufruf von dreamweaver.behaviorInspector.moveBehaviorDown() für eine andere Position hat keine Wirkung, weil die Ereignisse onClick und onFocus jeweils mit nur einem Verhalten verknüpft sind und das Verhalten an Position 3 sich bereits an unterster Stelle der Gruppe onMouseDown befindet.

dreamweaver.behaviorInspector.moveBehaviorUp()


BeschreibungVerschiebt ein Verhalten für ein Ereignis in der Ausführungsreihenfolge nach oben.



RückgabewerteKeine

BeispielWenn das Bedienfeld Verhalten wie in der folgenden Abbildung dargestellt eingerichtet ist, werden durch den Aufruf von dreamweaver.behaviorInspector.moveBehaviorUp(3) die Positionen der Aktionen PreloadImages und Change Property beim Ereignis onMouseOver vertauscht. Der Aufruf von dreamweaver.behaviorInspector.moveBehaviorUp() für eine andere Position hat keine Wirkung, weil die Ereignisse onClick und onFocus jeweils mit nur einem Verhalten verknüpft sind und das Verhalten an Position 2 sich bereits an unterster Stelle der Gruppe onMouseDown befindet.


279

dreamweaver.behaviorInspector.setSelectedBehavior()


BeschreibungWählt die Aktion an der angegebenen Position im Bedienfeld Verhalten aus.


• Das Argument positionIndex ist die Position der Aktion im Bedienfeld Verhalten. Die erste Aktion in der Liste befindet sich an Position 0. Um die Auswahl aller Aktionen aufzuheben, definieren Sie für positionIndex den Wert –1. Die Angabe einer Position, für die keine Aktion definiert ist, ist gleichbedeutend mit dem Wert –1.

RückgabewerteKeine

BeispielWenn das Bedienfeld Verhalten wie in der folgenden Abbildung dargestellt eingerichtet ist, wird durch Aufruf der Funktion dreamweaver.behaviorInspector.setSelection(2) die mit dem Ereignis onMouseDown verknüpfte Aktion Change Property ausgewählt:

ZwischenablagefunktionenDie Zwischenablagefunktionen dienen zum Ausschneiden, Kopieren und Einfügen von Elementen. Beim Macintosh können sich einige der Zwischenablagefunktionen auch auf Textfelder in Dialogfeldern und schwebenden Bedienfeldern beziehen. Funktionen, die auf Textfelder angewendet werden können, sind sowohl als Methoden des Objekts dreamweaver als auch des Objekts DOM implementiert. Die dreamweaver-Version der Funktion wirkt sich dagegen stets auf die Auswahl im aktiven Fenster aus: auf das aktuelle Dokumentfenster, den Codeinspektor oder das Bedienfeld Site. Auf dem Macintosh kann die Funktion auch auf die Auswahl in einem Textfeld angewendet werden, wenn dies das aktuelle Feld ist. Die DOM-Version der Funktion wirkt sich dagegen stets auf die Auswahl im angegebenen Dokument aus.

dom.clipCopy()


BeschreibungKopiert die Auswahl in die Zwischenablage, einschließlich des HTML-Codes, der die Auswahl definiert.

ArgumenteKeine


280

RückgabewerteKeine

dom.clipCopyText()


BeschreibungKopiert den ausgewählten Text in die Zwischenablage. Eventuell vorhandener HTML-Code wird dabei ignoriert.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canClipCopyText()“ auf Seite 416.

dom.clipCut()


BeschreibungSchneidet die Auswahl aus und kopiert sie in die Zwischenablage, einschließlich des HTML-Codes, der die Auswahl definiert.

ArgumenteKeine

RückgabewerteKeine

dom.clipPaste()


BeschreibungFügt den Inhalt der Zwischenablage im aktuellen Dokument an der Einfügemarke bzw. anstelle der momentanen Auswahl ein. Wenn die Zwischenablage HTML-Code enthält, wird dieser entsprechend interpretiert.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canClipPaste()“ auf Seite 416.


281

BeispielWenn die Zwischenablage ABC Widgets enthält, führt ein Aufruf von dw.getDocumentDOM().clipPaste() zu folgendem Ergebnis:

dom.clipPasteText() (veraltet)

VerfügbarkeitDreamweaver 3. Abgelöst in Dreamweaver 8. Verwenden Sie stattdessen die Funktion dom.clipPaste("text").

BeschreibungFügt den Inhalt der Zwischenablage im aktuellen Dokument an der Einfügemarke bzw. anstelle der momentanen Auswahl ein. Es ersetzt alle Zeilenvorschubmarkierungen in der Zwischenablage durch BR-Tags. Wenn die Zwischenablage HTML-Code enthält, wird dieser nicht interpretiert. Spitze Klammern werden als < und > eingefügt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canClipPasteText()“ auf Seite 416.


282

BeispielWenn die Zwischenablage den Text <code>return true;</code> enthält, führt ein Aufruf von dw.getDocu-mentDOM().clipPasteText() zu folgendem Ergebnis:

dreamweaver.clipCopy()


BeschreibungKopiert die aktuelle Auswahl aus dem aktiven Dokumentfenster, Dialogfeld, schwebenden Bedienfeld oder Bedienfeld Site in die Zwischenablage.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canClipCopy()“ auf Seite 425.

dreamweaver.clipCut()


BeschreibungVerschiebt die aktuelle Auswahl aus dem aktiven Dokumentfenster, Dialogfeld, schwebenden Bedienfeld oder Bedienfeld Site in die Zwischenablage.

ArgumenteKeine

RückgabewerteKeine


283

EnablerWeitere Informationen finden Sie unter „dreamweaver.canClipCut()“ auf Seite 425.

dreamweaver.clipPaste()

VerfügbarkeitDreamweaver 3. In Dreamweaver 8 wurde das Argument strPasteOption hinzugefügt.

BeschreibungFügt den Inhalt der Zwischenablage in den Bereich ein, auf dem momentan der Fokus liegt (Dokumentfenster, Dialogfeld, schwebendes Bedienfeld oder Bedienfeld Site).

Argumente{strPasteOption}

• Das optionale Argument strPasteOption gibt an, welche Art von Einfügeoperation durchzuführen ist. Folgende Werte sind zulässig: "text", "structured", "basicFormat" und "fullFormat".

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canClipPaste()“ auf Seite 425.

BeispielDas folgende Beispiel fügt den Inhalt der Zwischenablage als Text ein:

dw.clipPaste("text");

dreamweaver.getClipboardText()


BeschreibungRuft den gesamten in der Zwischenablage gespeicherten Text ab.

Argumente{bAsText}

• Der optionale Boolesche Wert bAsText gibt an, ob der Inhalt der Zwischenablage als Text abgerufen wird. Wenn bAsText auf true gesetzt ist, wird der Inhalt der Zwischenablage als Text abgerufen. Wenn bAsText auf false gesetzt ist, wird die Formatierung des Inhalts beibehalten. Der Standardwert dieses Arguments lautet false.

RückgabewerteEin String mit dem Inhalt der Zwischenablage, falls diese Text enthält (auch HTML), andernfalls kein Rückgabewert.

BeispielWenn dreamweaver.getClipboardText() den String "text <b>bold</b> text" zurückgibt, gibt dreamweaver.getClip-boardText(true) Folgendes zurück: "text bold text".


284

Bibliotheks- und VorlagenfunktionenMit Bibliotheks- und Vorlagenfunktionen lassen sich Verknüpfungen zwischen Dokumenten und Vorlagen bzw. Biblio-thekselementen erstellen, aktualisieren und entfernen. Die Methoden des Objekts dreamweaver.libraryPalette gelten für die Auswahl der Bibliothekselemente im Bedienfeld Elemente und nicht im aktuellen Dokument. Entsprechend wirken sich die Methoden des Objekts dreamweaver.templatePalette auf die Auswahl der Vorlagenelemente im Bedienfeld Elemente aus.

dom.applyTemplate()


BeschreibungWendet eine Vorlage auf das aktive Dokument an. Wenn kein Argument übergeben wird, wird das Dialogfeld Vorlage auswählen eingeblendet. Diese Funktion ist nur für das aktive Dokument gültig.

Argumente{templateURL}, bMaintainLink

• Das Argument templateURL ist der Pfad zu einer Vorlage in der aktuellen Site, ausgedrückt im URL-Format „file://“.

• Das Argument bMaintainLink ist ein Boolescher Wert, der anzeigt, ob die Verknüpfung zur Originalvorlage beibehalten werden soll (true) oder nicht (false).

RückgabewerteKeine

Enabler Weitere Informationen finden Sie unter „dom.canApplyTemplate()“ auf Seite 415.

dom.detachFromLibrary()


BeschreibungLöst die ausgewählte Instanz eines Bibliothekselements von der zugehörigen LBI-Datei, indem die Sperr-Tags um die Auswahl entfernt werden. Diese Funktion hat die gleiche Wirkung wie die Schaltfläche Von Original trennen im Eigen-schafteninspektor.

ArgumenteKeine

RückgabewerteKeine

dom.detachFromTemplate()


BeschreibungLöst das aktuelle Dokument von der zugehörigen Vorlage.


285

ArgumenteKeine

RückgabewerteKeine

dom.getAttachedTemplate()


BeschreibungRuft den Pfad der Vorlage ab, die zum Dokument gehört.

ArgumenteKeine

RückgabewerteEin String mit dem Pfad der Vorlage, ausgedrückt im URL-Format „file://“.

dom.getEditableRegionList()


BeschreibungRuft eine Liste aller bearbeitbaren Bereiche im Body des Dokuments ab.

ArgumenteKeine

RückgabewerteEin Array von Elementknoten.

Beispiel„dom.getSelectedEditableRegion()“ auf Seite 286.

dom.getIsLibraryDocument()


BeschreibungBestimmt, ob es sich bei dem Dokument um ein Bibliothekselement handelt.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob das Dokument eine LBI-Datei ist.


286

dom.getIsTemplateDocument()


BeschreibungBestimmt, ob es sich bei dem Dokument um eine Vorlage handelt.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob das Dokument eine DWT-Datei ist.

dom.getSelectedEditableRegion()


BeschreibungWenn sich die Auswahl bzw. die Einfügemarke innerhalb eines bearbeitbaren Bereichs befindet, ruft diese Funktion die Position des bearbeitbaren Bereichs im Body des Dokuments ab.

ArgumenteKeine

RückgabewerteEin Index in das Array, das von dom.getEditbableRegionList() zurückgegeben wird. Weitere Informationen finden Sie unter „dom.getEditableRegionList()“ auf Seite 285.

BeispielMit dem folgenden Code wird ein Dialogfeld mit dem Inhalt des ausgewählten bearbeitbaren Bereichs angezeigt:


var edRegs = theDOM.getEditableRegionList();

var selReg = theDOM.getSelectedEditableRegion();

alert(edRegs[selReg].innerHTML);


287

dom.insertLibraryItem()


BeschreibungFügt eine Instanz eines Bibliothekselements in das Dokument ein.

ArgumentelibraryItemURL

• Das Argument libraryItemURL ist der Pfad zu einer LBI-Datei, ausgedrückt im URLFormat „file://“.

RückgabewerteKeine

dom.markSelectionAsEditable()


BeschreibungZeigt das Dialogfeld Neuer editierbarer Bereich an. Wenn der Benutzer auf Neuer Bereich klickt, wird die Auswahl als bearbeitbar markiert. Der vorhandene Text bleibt unverändert.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canMarkSelectionAsEditable()“ auf Seite 420.

dom.newEditableRegion()


BeschreibungZeigt das Dialogfeld Neuer editierbarer Bereich an. Wenn der Benutzer auf Neuer Bereich klickt, wird der Name des Bereichs in geschweiften Klammern ({ }) an der Einfügemarke im Dokument eingefügt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canMakeNewEditableRegion()“ auf Seite 420.


288

dom.removeEditableRegion()


BeschreibungEntfernt einen bearbeitbaren Bereich aus dem Dokument. Eventuell vorhandene Inhalte bleiben erhalten; nur die Markie-rungen für den bearbeitbaren Bereich werden entfernt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canRemoveEditableRegion()“ auf Seite 421.

dom.updateCurrentPage()


BeschreibungAktualisiert die Bibliothekselemente, Vorlagen oder beides im Dokument. Diese Funktion ist nur für das aktive Dokument gültig.

Argumente{typeOfUpdate}

• Das optionale Argument typeOfUpdate muss "library", "template" oder "both" lauten. Wenn das Argument wegge-lassen wird, lautet der Standardwert "both".

RückgabewerteKeine

dreamweaver.updatePages()


BeschreibungÖffnet das Dialogfeld Seiten aktualisieren und wählt die angegebenen Optionen aus.

Argumente{typeOfUpdate}

• Das optionale Argument typeOfUpdate muss "library", "template" oder "both" lauten, falls Sie es angegeben. Bei fehlendem Argument gilt als Standard "both".

RückgabewerteKeine


289

Codefragmente (Bedienfeld), FunktionenMit Dreamweaver können Web-Entwickler wiederverwendbare Codeblöcke im Bedienfeld Codefragmente bearbeiten, speichern und bei Bedarf abrufen.

Im Bedienfeld Codefragmente werden die einzelnen Codefragmente in einer CSN-Datei im Ordner Configuration\Snippets gespeichert. Die im Lieferumfang von Dreamweaver enthaltenen Codefragmente sind in den folgenden Ordnern gespeichert:

• Accessible

• Comments

• Content_tables

• Filelist.txt

• Footers

• Form_elements

• Headers

• Javascript

• Meta

• Navigation

• Text

Codefragment-Dateien sind XML-Dokumente. Sie können daher die Codierung in der XML-Direktive angeben, wie im folgenden Beispiel dargestellt:

<?XML version="1.0" encoding="utf-8">

Das folgende Beispiel zeigt eine Codefragment-Datei:

<snippet name="Detect Flash" description="VBscript to check for Flash ActiveX control" preview="code"

factory="true" type="wrap" >

<insertText location="beforeSelection">

<![CDATA[ ------- code --------- ]]>

</insertText>

<insertText location="afterSelection">

<![CDATA[ ------- code --------- ]]>

</insertText>

</snippet>

Codefragment-Tags in CSN-Dateien haben folgende Attribute:

Sie können die folgenden Methoden verwenden, um zu Ihren Erweiterungen Funktionen des Bedienfelds Codefragmente hinzuzufügen.

Attribut Beschreibung

name Name des Codefragments

description Beschreibung des Codefragments

preview Art der Vorschau: "code", wenn das Codefragment im Vorschaubereich angezeigt werden soll, oder "design", wenn das Codefragment als HTML im Vorschaubereich wiedergegeben werden soll.

type "wrap", wenn mit dem Codefragment eine Benutzerauswahl umbrochen wird; "block", wenn das Codefragment vor der Auswahl eingefügt werden soll.


290

dreamweaver.snippetPalette.getCurrentSnippetPath()


BeschreibungGibt den Pfad des Codefragments zurück, das aktuell im Bedienfeld Codefragmente ausgewählt ist.

ArgumenteKeine

RückgabewerteDer Pfad (relativ zum Codefragmente-Ordner) zum Codefragment, das im Bedienfeld Codefragmente ausgewählt ist. Gibt einen leeren String zurück, wenn kein Codefragment ausgewählt ist.

dreamweaver.snippetPalette.newFolder()


BeschreibungErstellt einen neuen Ordner mit dem Standardnamen untitled und zeigt diesen Namen in einem Textfeld an.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.snippetPalette.newSnippet()


BeschreibungÖffnet das Dialogfeld Codefragment einfügen und übergibt ihm den Fokus.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.snippetPalette.editSnippet()


BeschreibungÖffnet das Dialogfeld Codefragment bearbeiten, übergibt ihm den Fokus und aktiviert die Bearbeitungsfunktionen für das ausgewählte Element.

ArgumenteKeine


291

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.snippetpalette.canEditSnippet()“ auf Seite 439.

dreamweaver.snippetPalette.insert()


BeschreibungWendet das im Bedienfeld Codefragmente ausgewählte Codefragment auf die aktuelle Auswahl an.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.snippetpalette.canInsert()“ auf Seite 439.

dreamweaver.snippetPalette.insertSnippet()


BeschreibungFügt das angegebene Codefragment in die aktuelle Auswahl ein.

Argumentepath

• Ein String, der den Pfad zum Codefragment relativ zum Codefragmente-Ordner angibt.

RückgabewerteEin Boolescher Wert.

EnablerWeitere Informationen finden Sie unter „dreamweaver.snippetpalette.canInsert()“ auf Seite 439.

Beispiel Der folgende Aufruf von dw.snippetPalette.insertSnippet() fügt das Codefragment an der durch das Argument angegebenen Position in das aktuelle Dokument an der Einfügemarke ein:

dw.snippetPalette.insertSnippet('Text\\Different_Link_Color.csn');


292

dreamweaver.snippetPalette.rename()


BeschreibungAktiviert ein Textfeld um den ausgewählten Ordnernamen oder Datei-Kurznamen und aktiviert die Bearbeitungsfunk-tionen für das ausgewählte Element.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.snippetPalette.remove()


BeschreibungLöscht das ausgewählte Element oder den ausgewählten Ordner aus dem Bedienfeld Codefragmente und löscht die Datei von der Festplatte.

RückgabewerteKeine

Bearbeitungsfunktionen für Spry-WidgetsDreamweaver CS3 bietet erweiterte Bearbeitungsfunktionen für Spry-Widgets und andere dynamische Widgets.

element.getTranslatedAttribute()


BeschreibungDiese Funktion ist identisch mit der W3C-Funktion getAttribute(), gilt jedoch für übersetzte Attribute. Die Funktion element.getTranslatedAttribute() ruft einen Attributwert nach Namen ab.

Argumentename

• Das Argument name ist ein DOM-String, der den Namen des abzurufenden Attributs enthält.

RückgabewerteGibt den Namen des Attributs als DOM-String zurück. Wenn das Attribut keinen festgelegten Wert und auch keinen Standardwert hat, gibt diese Funktion einen leeren String zurück.


293

element.removeTranslatedAttribute()


BeschreibungDiese Funktion ist identisch mit der W3C-Funktion removeAttribute(), gilt jedoch für übersetzte Attribute. Die Funktion element.removeTranslatedAttribute() entfernt ein Attribut nach Namen. Wenn das Attribut einen Standardwert hat, wird ein Attribut mit dem Standardwert und dem entsprechenden Namespace-URI, dem lokalen Namen und Präfix, sofern vorhanden, angezeigt.

Argumentename

• Das Argument name ist ein DOM-String, der den Namen des zu entfernenden Attributs enthält.

RückgabewerteKeine

element.setTranslatedAttribute()


BeschreibungDiese Funktion ist identisch mit der W3C-Funktion setAttribute(), gilt jedoch für übersetzte Attribute. Die Funktion element.setTranslatedAttribute() fügt ein neues Attribut mit dem angegebenen Wert hinzu. Wenn ein Attribut mit dem angegebenen Namen bereits im Element vorhanden ist, wird der Wert zu dem im Argument value angegebenen Wert geändert.

Der Wert value ist ein einfacher String; er wird nicht analysiert, da er festgelegt wird. Deshalb wird jede im String enthaltene Syntax als einfacher Text behandelt und muss von der Implementierung entsprechende ausgeschaltet werden, wenn sie ausgeschrieben wird.

Um einen Attributwert zuzuweisen, der Syntax enthält, die als Entity-Referenz erkannt werden soll, müssen Sie einen Attr-Knoten plus ggf. Text- und EntityReference-Knoten erstellen, die entsprechenden Teilstruktur erstellen und setAttri-buteNode verwenden, um dieses als Wert des Attributs zuzuweisen.

Argumentename, value

• Das Argument name ist ein DOM-String, der den Namen des zu erstellenden oder zu ändernden Attributs enthält.

• Das Argument value ist ein DOM-String, der den für das Attribut festzulegenden Wert enthält.

RückgabewerteKeine

element.translatedClassName


BeschreibungDiese Funktion ist identisch mit der Funktion element.ClassName, gilt jedoch für das übersetzte className-Attribut.


294

element.translatedStyle


BeschreibungDiese Funktion ist identisch mit der Funktion element.style(), gilt jedoch für das übersetzte style-Attribut.

Beispielvar div1 = dom.getElementById("div1");

div1.translatedStyle.display = "none";

Funktionen zum Einfügen von Spry-WidgetsDreamweaver bietet die folgenden Funktionen, um das Einfügen von Spry-Widgets zu vereinfachen.

dom.addJavaScript()


BeschreibungDieses Funktion weist Dreamweaver an, einen JavaScript-Block entweder in den head-Bereich oder in den body-Bereich einzufügen. Beim Einfügen in den body-Bereich wird der JavaScript-Block direkt vor dem Tag </body> eingefügt. Wenn das Dokument dort bereits einen JavaScript-Block aufweist, fügt Dreamweaver kein neues <script>-Tag ein, sondern hängt "code" an den Inhalt des <script>s an.

Argumentecode, insideHead

• code ist ein String, der den JavaScript-Code enthält, der in die Seite eingefügt werden soll.

• insideHead ist ein Boolescher Wert, der angibt, ob der JavaScript-Block in den head-Bereich oder in den body-Bereich eingefügt werden soll. Der Standardwert ist true, womit der Code in den head-Bereich eingefügt wird. Beim Wert false wird der Code in den body-Bereich direkt vor dem </body>-Tag eingefügt. Dieses Argument ist optional.

RückgabewerteKeine

Beispielfunction objectTag(){...var dom = dw.getDocumentDOM();var id = dwscripts.getUniqueId("accordion");var code = "new Accordion('" + id + "',250,{duration:200,step:20})";dom.addJavaScript(code, false);

return retVal;}


295

dom.copyAssets()


BeschreibungAutoren von Erweiterungen können diese API verwenden, um externe abhängige Dateien in die Site des Benutzers zu kopieren und dem head-Bereich der Seite die erforderlichen Dateiverweise hinzuzufügen.

ArgumenteassetArray

Ein Array von JavaScript-Objekten. Jedes JavaScript-Objekt verfügt über die Felder "srcURL", "destURL", "referenceType", "useDefaultFolder" und "useRelativeSrc".

• "srcURL ist ein Pfad relativ zum Dreamweaver-Konfigurationsordner und verweist auf das vom Autor der Erweiterung zur Verfügung gestellte Element. Siehe Beschreibung von "useRelativeSrc" in diesem Abschnitt.

• "destURL ist ein Pfad relativ zum Elementordner einer Dreamweaver-Site und verweist auf den Speicherort, an den das Element kopiert werden soll. Dreamweaver erstellt standardmäßig einen Ordner Assets in einer Site und verwendet diesen als Standardordner für Elemente. Benutzer können diesen Element-Standardordner ändern, wenn sie eine Dreamweaver-Site definieren. Siehe Beschreibung von "useDefault" in diesem Abschnitt.

• "referenceType ist erforderlich, wenn der Autor der Erweiterung einen Dateiverweis in den head-Bereich einfügen möchte. Die gültigen Werte für "referenceType" lauten wie folgt:

• "link", um ein LINK-Tag für eine externe CSS-Datei einzufügen

• "import", um ein STYLE-Tag mit @import einzufügen

• "javascript", um ein SCRIPT-Tag mit type=text/javascript einzufügen

• "vbscript", um ein SCRIPT-Tag mit type=text/vbscript einzufügen

• "", um keinen Verweis in den head-Bereich einzufügen

• "useDefault" ist ein Boolescher Wert, der bestimmt, wie der in "destURL" festgelegte Wert interpretiert wird. Die Standardeinstellung ist true. Beim Wert true behandelt Dreamweaver "destURL" als Pfad relativ zum Spry-Element-ordner der Site. Beim Wert false ist "destURL" ein Pfad relativ zum Site-Stammordner.

• "useRelativeSrc" ist ein Boolescher Wert, der bestimmt, wie der in "destURL" festgelegte Wert interpretiert wird. Der Standardwert ist false. Beim Wert false wird "srcURL" als absoluter Pfad eingefügt, wenn "referenceType" angegeben wird.

RückgabewerteKeine

Beispielfunction objectTag(){...var dom = dw.getDocumentDOM();var assetList = new Array();var assetInfo = new AssetInfo("Objects/Ajax/Accordion.css", "Objects/Ajax/Accordion.css",

"Accordion.css", "link");assetList.push(assetInfo);assetInfo = new AssetInfo("Objects/Ajax/Accordion.js", "Accordion.js", "javascript");assetList.push(assetInfo);assetInfo = new AssetInfo("Objects/Ajax/Images", "Images", "");assetList.push(assetInfo);dom.copyAssets(assetList);return retVal;}


296

dom.getDefaultAssetFolder()


BeschreibungRuft den Standardordner für Elemente des Dokuments ab.

ArgumenteKeine

RückgabewerteEin String, der den Namen des Standard-Elementordners enthält.

Beispielfunction objectTag(){...var defaultAssetFolder = dom.getDefaultAssetFolder();...return retVal;}

Funktionen für die BrowserkompatibilitätsprüfungDie folgenden Funktionen erleichtern das Auffinden von Kombinationen von HTML und CSS, die Browserfehler auslösen können (weitere Informationen finden Sie im Kapitel „Die API für die Browserkompatibilitätsprüfung“ in Dreamweaver erweitern), sie können jedoch auch in anderen Erweiterungstypen (z. B. Befehle) verwendet werden.

Hinweis: Die Werte, die diese Funktionen zurückgegeben, stellen die Stile dar, die zurzeit in der Entwurfsansicht gelten. Wenn die Funktionen in Dateien als Teil der Browserkompatibilitätsprüfung verwendet werden, filtert Dreamweaver die Stile automatisch danach, wie die Zielbrowser sie lesen würden (z. B. Stile, die mit Star HTML definiert werden, müssen berück-sichtigt werden, wenn der Zielbrowser Internet Explorer 6 oder früher ist), diese Filterung findet jedoch nicht statt, wenn Sie die Funktionen nicht im Rahmen einer Browserkompatibilitätsprüfung verwenden.

elem.getComputedStyleProp()


BeschreibungRuft den Wert der angegebenen CSS-Eigenschaft ab, die zur Darstellung des angegebenen Elements verwendet wird, unabhängig davon, wo die Eigenschaft im CSS definiert ist. Die Länge wird in Pixeln angegeben (obwohl anders als in den Browsern „px“ nicht mit dem Wert angegeben wird).

ArgumentepropName, pseudoElt

• propName - der Name einer CSS-Eigenschaft (verwenden Sie keine Bindestriche, sondern gemischte Groß- und Klein-schreibung; "font-size" wird zum Beispiel "fontSize").

• pseudoElt - das CSS-Pseudoelement oder null, falls dieses nicht vorhanden ist.


297

RückgabewerteEin String, der den berechneten Wert dieser Eigenschaft enthält.

Hinweis: Numerische Werte werden ebenfalls als Strings zurückgegeben; um diese Werte in Berechnungen zu verwenden, konvertieren Sie sie mit parseInt() oder parseFloat() in Zahlen.

Beispielvar dom = dw.getDocumentDOM();

var myDiv = dom.getElementsByTagName('myDiv');

var float = myDiv.getComputedStyleProp("float");

if (float == "left")

alert("This div is floated left.");

window.getDeclaredStyle()


BeschreibungRuft die CSS-Stile ab, die für das angegebene Element deklariert wurden. Unterscheidet sich darin von der Funktion getComputedStyle(), dass nicht ausdrücklich deklarierte Stile undefiniert sind, und dass es tatsächliche Längenwerte wie im Stylesheet deklariert zurück gibt (zum Beispiel 20%, 0,8em) anstatt der berechneten Pixelwerte. Wenn bGetInherited den Wert false hat (dies ist die Standardvorgabe), unterscheidet sich getDeclaredStyle() auch insofern, dass nur die Stile, die direkt auf das Element angewendet werden, abgerufen werden; vom übergeordneten Element übernommene Stile sind nicht eingeschlossen.

Argumenteelt, pseudoElt, psuedoClassList, bGetInherited

• elt - ein Knoten in dem Dokument, dessen Stilinformationen gewünscht werden.

• pseudoElt - das CSS-Pseudoelement oder null, falls dieses nicht vorhanden ist.

• pseudoClassList - ein optionaler String, der aus durch Leerzeichen getrennten Pseudoklassen besteht.

• bGetInherited - ein optionaler Boolescher Wert, der angibt, ob von übergeordneten Elementen übernommene Stile einzuschließen sind (standardmäßig false).

RückgabewerteEin schreibgeschütztes Objekt mit Stileigenschaften, auf die anhand der Namen zugegriffen werden kann.

Beispielvar dom = dw.getDocumentDOM();var myDiv = dom.getElementById('myDiv');var props = window.getDeclaredStyle(myDiv);var marleft = "";var units = "";if (typeof(props.marginLeft) != "undefined"){

marleft = props.marginLeft;units = marleft.replace(/\d+/,""); // Ziffern entfernen, Einheiten behaltenalert(units); // sollte %, px, pt, em usw. anzeigen

}elsealert("no margin-left property has been set for myDiv.");


298

dom.getMinDisplayWidth()


BeschreibungRuft die Mindestbreite ab, die für einen Container auf Blockebene erforderlich ist, um den gesamten Inhalt anzuzeigen.

Hinweis: Die tatsächliche Breite des Containers kann kleiner sein, falls mithilfe von CSS ein Wert festgelegt ist, der kleiner ist als der von der Funktion dom.minDisplayWidth() zurückgegebene Wert.

Argumentecontainer

• container - das Container-Element, für das eine Mindestbreite erforderlich ist.

RückgabewerteEine Ganzzahl, die die kleinste Anzeigebreite des angegebenen Containers in Pixel darstellt oder -1, falls das Element kein Container ist oder seine Mindestbreite nicht bestimmt werden kann.

Beispielvar dom = dw.getDocumentDOM();var myDiv = dom.getElementById('myDiv');var props = window.getComputedStyle(myDiv);var minW = dom.getMinDisplayWidth(myDiv);var setW = props.width;

if (minW > setW)alert("Depending on the browser, your content will either be \n" +

"clipped, or the container will expand beyond its set width.");

dom.getBlockElements() elem.getBlockElements()


BeschreibungDurchsucht das Dokument (oder das Element) nach untergeordneten Elementen mit einem inhärenten oder angegebenen Anzeigewert 'block'.

ArgumenteKeine


Beispiel[...]var blocks = DOM.getBlockElements(); var dProps = null, children = null;for (var i=0; i < blocks.length; i++){

// deklarierte Stile abrufen, um zu sehen, ob Breite oder // Höhe ausdrücklich festgelegt wurden dProps = window.getDeclaredStyle(blocks[i]); // falls der Block untergeordnete Elemente hat, border-left und padding-bottom // aber keine Breite oder Höheif (blocks[i].hasChildNodes() && |

issueUtils.hasBorder(blocks[i],null,"left") && (parseFloat(blocks[i].getComputedStyleProp("padding-bottom")) > 0) && typeof(dProps.width) == "undefined" && typeof(dProps.height) == "undefined"){ children = blocks[i].getBlockElements();


299

var hasLayout = false; // untergeordnete Elemente auf Blockebene durchlaufen, um zu sehen, // ob für einige Breite oder Höhe definiert wurde. Breite oder Höhe für // ein untergeordnetes Element des äußeren Blocks verhindern den Fehler.

for (var j=0; j < children.length; j++){ dProps = window.getDeclaredStyle(children[j]); if (typeof(dProps.width) != "undefined" || typeof(dProps.height) != "undefined"){ hasLayout = true;

break;}

}[...]}

}[...]

dom.getInlineElements() elem.getInlineElements()


BeschreibungDurchsucht das Dokument (oder das Element) nach untergeordneten Elementen mit einem inhärenten oder angegebenen Anzeigewert 'inline'.

ArgumenteKeine


Beispiel[...]var DOM = dw.getDocumentDOM(); var inEls = DOM.body.getInlineElements(); var next = null, prev = null, parent = null;var props = null;

// in allen Inline-Elementen nach ersetzten Elementen suchen. // wenn keine ersetzten Elemente gefunden werden, nicht weitermachen. for (var i=0; i < inEls.length; i++){

if (inEls[i].tagName == 'IMG' || inEls[i].tagName == 'INPUT' || inEls[i].tagName == 'TEXTAREA' || inEls[i].tagName == 'SELECT' || inEls[i].tagName == 'OBJECT'){// etwas ausführen

}}[...]


300

dom.getHeaderElements() elem.getHeaderElements()


BeschreibungDurchsucht das Dokument (oder das Element) nach Header-Tags (H1 bis H6).

ArgumenteKeine


Beispielvar DOM = dw.getDocumentDOM(); var headers = DOM.getHeaderElements();

for (var i=0; i < headers.length; i++){alert(headers[i].tagName);

}

dom.getListElements() elem.getListElements()


BeschreibungDurchsucht das Dokument (oder das Element) nach geordneten Listen, ungeordneten Listen und Definitionslisten.

ArgumenteKeine


Beispiel[...] var DOM = dw.getDocumentDOM();// alle ungeordneten, geordneten und Definitionslisten-Elemente im Dokument abrufen.var lists = DOM.getListElements();var props = null;for (var i=0; i < lists.length; i++){

props = window.getDeclaredStyle(lists[i]);if ((props.cssFloat == "left" || props.cssFloat == "right") && props.overflow == "auto"){

// etwas ausführen}

}[...]


301

elem.isBlockElement()


BeschreibungÜberprüft, ob das Element einen inhärenten oder angegebenen Anzeigewert 'block' hat.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob es sich bei dem Objekt um ein Element auf Blockebene handelt.

Beispiel[...]

var DOM = dw.getDocumentDOM();

var blocks = DOM.body.getBlockElements();

var next = null;

for (var i=0; i < blocks.length; i++){

// next ist der Knoten direkt nach blocks[i]

next = blocks[i].nextSibling;

// wenn next nicht null ist UND next ein Elementknoten ist UND next ein Blockelement ist,

// haben wir den Test "zweites von zwei aufeinander folgenden Blockelementen" erfüllt.

if (next && (next.nodeType == 1) && next.isBlockElement()){

// etwas ausführen

}

}

[...]

elem.isInlineElement()


BeschreibungÜberprüft, ob das Element einen inhärenten oder angegebenen Anzeigewert 'inline' hat.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob es sich bei dem Objekt um ein Inline-Element handelt.

Beispiel[...]var DOM = dw.getDocumentDOM(); var floats = issueUtils.getFloats(DOM.body); var next = null; for (var i=0; i < floats.length; i++){

next = floats[i].nextSibling; // falls nextSibling von float ein Textknoten oder ein Inline-Element istif (next && (next.nodeType == Node.TEXT_NODE ||

(next.nodeType == Node.ELEMENT_NODE && next.isInlineElement()))){// etwas ausführen}

}[...]


302

elem.isHeaderElement()


BeschreibungÜberprüft, ob es sich bei dem Element um einen der folgenden Tags handelt: h1, h2, h3, h4, h5, h6.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob es sich bei dem Objekt um ein Header-Element handelt.

Beispiel[...]var DOM = dw.getDocumentDOM(); var floats = issueUtils.getFloats(DOM.body); var prev = null; // erstes float im Dokument ist nicht betroffen, deshalb // bei 1 starten. for (var i=1; i < floats.length; i++){

prev = floats[i].previousSibling; // falls es sich bei dem Element vor dem float um einen Header handelt, if (prev && prev.isHeaderElement()){// etwas ausführen}

}[...]

elem.isListElement()


BeschreibungÜberprüft, ob es sich bei dem Element um einen der folgenden Tags handelt: ul, ol, dl.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob es sich bei dem Objekt um ein Listenelement handelt.

Beispiel[...]var DOM = dw.getDocumentDOM(); var floats = issueUtils.getFloats(DOM.body); var prev = null, children = null; for (var i=0; i < floats.length; i++){

children = floats[i].childNodes;

for (var k=0; k < children.length; k++){ if (children[k].isListElement()){// etwas ausführen}

}}[...]

303

Kapitel 16: Dynamische Dokumente

Die dynamischen Dokumentfunktionen in Adobe® Dreamweaver® CS3 führen Operationen durch, die sich auf Webserver-Seiten beziehen. Zu diesen Operationen gehören die Rückgabe einer Eigenschaft für den ausgewählten Knoten im Bedienfeld Komponenten, das Abrufen einer Liste aller Datenquellen im Dokument des Benutzers, das Anzeigen von dynamischem Inhalt in der Entwurfsansicht, das Anwenden eines Serververhaltens auf ein Dokument und das Abrufen der Namen aller aktuell definierten Servermodelle.


• „Funktionen von Serverkomponenten“ auf Seite 303

• „Datenquellenfunktionen“ auf Seite 304

• „Extension Data Manager-Funktionen“ auf Seite 305

• „Live Data-Funktionen“ auf Seite 307

• „Serververhalten-Funktionen“ auf Seite 311

• „Servermodell-Funktionen“ auf Seite 313

Funktionen von Serverkomponenten Mit Serverkomponenten-Funktionen können Sie auf den Knoten zugreifen, der im Bedienfeld Komponenten in der Struk-turansicht Serverkomponenten aktuell ausgewählt ist. Mit diesen Funktionen können Sie auch die Ansicht der Kompo-nentenstruktur aktualisieren.

dreamweaver.serverComponents.getSelectedNode()


BeschreibungGibt die derzeit in der Strukturansicht Serverkomponenten ausgewählte Eigenschaft ComponentRec zurück.

ArgumenteKeine

RückgabewerteDie Eigenschaft ComponentRec.

dreamweaver.serverComponents.refresh()


BeschreibungAktualisiert die Ansicht der Komponentenstruktur.

ArgumenteKeine


304

RückgabewerteKeine

DatenquellenfunktionenDatenquellendateien werden im Ordner Configuration\DataSources gespeichert. Jedes Servermodell verfügt über einen eigenen Ordner: ASP.Net/C#, ASP.Net/VisualBasic, ASP/JavaScript, ASP/VBScript, ColdFusion, JSP und PHP/MySQL. In jedem Unterordner für die Servermodelle befinden sich HTML-und EDML-Dateien, die mit dem jeweiligen Servermodell in Zusammenhang stehen.

Weitere Informationen über die Verwendung von Datenquellen in Dreamweaver finden Sie unter „Datenquellen“ im Handbuch Dreamweaver erweitern.

dreamweaver.dbi.getDataSources


BeschreibungRuft die Funktion findDynamicSources() für alle Dateien im Ordner Configuration\DataSources auf. Mit dieser Funktion können Sie eine Liste aller Datenquellen im Dokument des Benutzers erstellen. Diese Funktion durchläuft alle Dateien im Ordner Configuration\DataSources, ruft in jeder Datei die Funktion findDynamicSources() auf, verbindet alle zurückgegebenen Arrays und gibt das verbundene Array der Datenquellen zurück.

ArgumenteKeine

RückgabewerteEin Array, das eine Gesamtliste aller Datenquellen enthält, die im Benutzerdokument vorhanden sind. Bei jedem Element im Array handelt es sich um ein Objekt. Alle Objekte verfügen über die folgenden Eigenschaften:

• Die Eigenschaft title ist der Beschriftungsstring, der rechts neben dem Symbol des übergeordneten Knotens angezeigt wird. Die Eigenschaft title wird immer definiert.

• Die Eigenschaft imageFile ist der Pfad der GIF-Datei für das Symbol, das den übergeordnete Knoten im Dialogfeld Dynamische Daten bzw. Dynamischer Text oder im Bedienfeld Bindungen darstellt. Die Eigenschaft imageFile wird immer definiert.

• Die Eigenschaft allowDelete ist optional. Wenn diese Eigenschaft auf false gesetzt wird und der Benutzer im Bedienfeld Bindungen auf diesen Knoten klickt, wird die Schaltfläche mit dem Minuszeichen (–) deaktiviert. Wird die Eigenschaft auf true gesetzt, wird die Schaltfläche mit dem Minuszeichen (–) aktiviert. Wenn die Eigenschaft nicht definiert wurde, wird die Schaltfläche mit dem Minuszeichen (–) aktiviert, wenn der Benutzer auf das Element klickt (so als ob die Eigenschaft auf true gesetzt wäre).

• Die Eigenschaft dataSource ist der Name der Datei, in der die Funktion findDynamicSources() definiert ist. Beispiels-weise setzt die Funktion findDynamicSources() in der Datei Session.htm, die sich im Ordner Configu-ration\DataSources\ASP_Js befindet, die Eigenschaft dataSource auf session.htm. Diese Eigenschaft wird immer definiert.

• Die Eigenschaft name bezeichnet den Namen des Serververhaltens, das zur Datenquelle dataSource gehört, sofern diese Datenquelle vorhanden ist. Die Eigenschaft name wird immer definiert, kann aber ein leerer String ("") sein, wenn kein Serververhalten mit der Datenquelle (z. B. einer Sitzungsvariablen) verknüpft ist.


305

dw.dbi.setExpanded()


BeschreibungLegt den ein ein- oder auszublenden Knoten fest.

Argumentedata-source-node-name, expanded

• data-source-node-name ist ein String, der den Namen der Datenquelle, die ein- oder ausgeblendet werden soll, angibt.

• expanded ist ein Boolescher Wert, der angibt, ob der Datensatzknoten eingeblendet oder ausgeblendet werden soll.

RückgabewerteKeine

Beispieldw.dbi.setExpanded(dsName, true); //blendet den Datenquellenknoten ein

Extension Data Manager-FunktionenDie in diesem Abschnitt beschriebenen APIs bilden den Extension Data Manager (EDM). Sie können auf die in den Gruppen- und Mitgliederdateien enthaltenen Daten programmtechnisch zugreifen und sie verändern, indem Sie diese Funktionen aufrufen. Der EDM arbeitet auf folgende Weise:

• Der EDM übernimmt die gesamte EDML-Datei-E/A für Gruppen- und Mitgliederdateien.

• Der EDM arbeitet als Servermodell-Filter, indem er für das aktuelle Servermodell alle Datenanforderungen ausführt.

dreamweaver.getExtDataValue()

VerfügbarkeitDreamweaver UltraDev 4

BeschreibungDiese Funktion ruft die Feldwerte für die angegebenen Knoten aus einer EDML-Datei ab.

Argumentequalifier(s)

• Das Argument qualifier(s) ist eine Liste variabler Länge aus den durch Kommas getrennten Knotenbezeichnern einschließlich Gruppen- oder Mitgliedsname, Teilblock (soweit vorhanden) und Feldname. Die Länge der Liste hängt von dem benötigten Informationsumfang ab.

RückgabewerteDreamweaver erwartet einen Feldwert. Ist kein Wert angegeben, gibt Dreamweaver den Standardwert zurück.

BeispielDas folgende Beispiel ruft den location-Attributwert für das Tag insertText des Mitglieds recordset_main auf:

dw.getExtDataValue("recordset_main", "insertText", "location");


306

dreamweaver.getExtDataArray()


BeschreibungDiese Funktion ruft ein Datenfeld mit Werten für die angegebenen Knoten aus einer EDML-Datei ab.

Argumentequalifier(s)

• Das Argument qualifier(s) ist eine Liste variabler Länge aus den durch Kommas getrennten Knotenbezeichnern einschließlich Gruppen- oder Mitgliedsname, Teilblock (soweit vorhanden) und Feldname.

RückgabewerteDreamweaver erwartet ein Array von Namen untergeordneter Knoten.

dreamweaver.getExtParticipants()


BeschreibungDiese Funktion ruft die Liste der Mitglieder aus einer EDML-Gruppendatei oder aus EDML-Mitgliederdateien ab.

Argumentevalue, qualifier(s)

• Das Argument value ist ein Eigenschaftenwert oder ist leer und wird ignoriert. Zum Beispiel dreamweaver.getExtPar-ticipants("", "participant");

• Das Argument qualifier(s) ist eine Liste mit variabler Länge aus den durch Kommas getrennten Knotenbezeichnern der benötigten Eigenschaft.

RückgabewerteDreamweaver erwartet ein Array mit Mitgliedernamen einer bestimmten Eigenschaft, die mit dem festgelegten Wert übereinstimmt (falls zutreffend).

dreamweaver.getExtGroups()


BeschreibungRuft aus einer EDML-Gruppendatei den Namen der Gruppe ab, die dem Namen des Serververhaltens entspricht.

Argumentevalue, qualifier(s)

• Das Argument value ist ein Eigenschaftenwert oder ist leer und wird ignoriert.

• Das Argument qualifier(s) ist eine Liste mit variabler Länge aus den durch Kommas getrennten Knotenbezeichnern der benötigten Eigenschaft.

RückgabewerteDreamweaver erwartet ein Array mit Gruppennamen einer bestimmten Eigenschaft, die mit dem festgelegten Wert übereinstimmt (falls zutreffend).


307

dreamweaver.refreshExtData()


BeschreibungLädt alle Datendateien der Erweiterung erneut.

Sie können mithilfe dieser Funktion einen Befehl zum erneuten Laden von Änderungen an Serververhalten-EDML-Dateien anlegen, ohne dass Dreamweaver neu gestartet werden muss.

ArgumenteKeine

RückgabewerteDreamweaver erwartet neu geladene Daten.

Live Data-FunktionenMit den folgenden Live Data-Funktionen können Sie die Menüfunktionalität simulieren:

• Die Funktion showLiveDataDialog() wird für das Menüelement Ansicht > Live Data-Einstellungen verwendet.

• Die Funktion setLiveDataMode() wird für die Menüelemente Ansicht > Live Data und Ansicht > Live Data aktuali-sieren verwendet.

• Die Funktion getLiveDataMode() legt fest, ob der Live Data-Modus aktiv ist.

Die restlichen Live Data-Funktionen können Sie bei der Implementierung der API-Übersetzungsfunktion liveDataTrans-lateMarkup() verwenden.

dreamweaver.getLiveDataInitTags()


BeschreibungGibt die Initialisierungs-Tags für das derzeit aktive Dokument zurück. Bei den Initialisierungs-Tags handelt es sich um die HTML-Tags, die der Benutzer im Dialogfeld Live Data-Einstellungen eingegeben hat. Diese Funktion wird normalerweise von der Übersetzerfunktion liveDataTranslateMarkup() aufgerufen, damit der Übersetzer die Tags an die Funktion liveDataTranslate() übergeben kann.

ArgumenteKeine

RückgabewerteEin String mit den Initialisierungs-Tags.

dreamweaver.getLiveDataMode()


BeschreibungBestimmt, ob das Live Data-Fenster derzeit sichtbar ist.


308

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Live Data-Fenster sichtbar ist, andernfalls false.

dreamweaver.getLiveDataParameters ()


BeschreibungRuft die als Live Data-Einstellungen abgegebenen URL-Parameter ab.

Im Live Data-Modus können Sie Webseiten in der Entwurfsphase anzeigen (als wären sie vom Anwendungsserver übersetzt und zurückgegeben worden). Da dynamische Inhalte für die Anzeige in der Entwurfsansicht generiert werden, können Sie Ihr Seitenlayout mit Live Data anzeigen und bei Bedarf anpassen.

Bevor Sie Live Data anzeigen, müssen Sie für alle URL-Parameter, auf die Sie in Ihrem Dokument verweisen, Live Data-Einstellungen eingeben. Hierdurch wird verhindert, dass der Webserver für Parameter, die sonst in der Simulation nicht definiert sind, Fehler zurückgibt.

Sie geben die URL-Parameter in Form von Name-Wert-Paaren ein. Wenn Sie in Serverskripts in Ihrem Dokument beispielsweise auf die URL-Variablen ID und Name verweisen, müssen Sie diese URL-Parameter definieren, bevor Sie Live Data anzeigen.

In Dreamweaver stehen zum Eingeben von Live Data-Einstellungen die folgenden Möglichkeiten zur Verfügung:

• Im Dialogfeld Live Data-Einstellungen, das Sie aus dem Menü Ansicht aufrufen können.

• Im Textfeld URL, das oberhalb des Dokuments angezeigt wird, wenn Sie in der Symbolleiste auf die Schaltfläche Live Data-Ansicht klicken.

Für die Parameter ID und Name können Sie die folgenden Paare eingeben:

ID 22

Name Samuel

Im Feld URL werden diese Parameter im gegebenen Beispiel wie folgt angezeigt:

http://someURL?ID=22&Name=Samuel

Mit dieser Funktion können Sie diese Live Data-Einstellung über JavaScript abrufen.

ArgumenteKeine

RückgabewerteEin Array, das die URL-Parameter für das aktuelle Dokument enthält. Das Array enthält eine gerade Anzahl von Parame-terstrings. Jeweils zwei Elemente bilden ein Name-Wert-Paar für den URL-Parameter. Die Elemente an gerader Position sind die Parameternamen, die Elemente an ungerader Position sind die Werte. Beispielsweise gibt getLiveDataPara-meters() für die Parameter ID und Name des vorhergehenden Beispiels das folgende Array zurück: ['ID','22','Name','Sandra'].

BeispielDas folgende Beispiel gibt die Parameter zurück, die als Live Data-Einstellungen angegeben sind, und speichert im paramsArray:

var paramsArray = dreamweaver.getLiveDataParameters();


309

dreamweaver.liveDataTranslate()


BeschreibungSendet ein ganzes HTML-Dokument an einen Anwendungsserver, fordert den Server zur Ausführung der Skripts im Dokument auf und gibt dann das resultierende HTML-Dokument zurück. Diese Funktion kann ausschließlich von einer Übersetzerfunktion liveDataTranslateMarkup() aufgerufen werden. andernfalls tritt ein Fehler auf. Die Funktion dream-weaver.liveDataTranslate() führt die folgenden Operationen aus:

• Das animierte Bild (in der Nähe der rechten Kante des Live Data-Fensters) wird wiedergegeben.

• Es wird auf eine Benutzereingabe gewartet. Wenn der Benutzer auf das Stopp-Symbol klickt, erfolgt die Rückgabe der Funktion sofort.

• Ein Argument, das aus einem einzelnen String besteht, wird von der aufrufenden Funktion entgegengenommen. (Bei diesem String handelt es sich normalerweise um den gesamten Quellcode des Benutzerdokuments. Dieser String wird auch im nächsten Vorgang verwendet.)

• Der HTML-String aus dem Benutzerdokument wird als temporäre Datei auf dem Live Data-Server gespeichert.

• Eine HTTP-Anforderung wird an den Live Data-Server gesendet, und zwar mit den Parametern, die im Dialogfeld Live Data-Einstellungen angegeben wurden.

• Die HTML-Antwort vom Live Data-Server wird entgegengenommen.

• Die temporäre Datei wird vom Live Data-Server entfernt.

• Die Wiedergabe des animierten Bildes wird gestoppt.

• Die HTML-Antwort wird an die aufrufende Funktion zurückgegeben.

ArgumenteString

• Ein einziger String, der normalerweise aus dem gesamten Quellcode des aktuellen Benutzerdokuments besteht.

RückgabewerteEin Objekt httpReply. Dieses Objekt ist identisch mit dem Wert, der von der Funktion MMHttp.getText() zurückgegeben wird. Wenn der Benutzer auf das Stopp-Symbol klickt, entspricht der Wert httpReply.statusCode des Rückgabewerts 200 (Status OK). Der Wert httpReply.data entspricht dem leeren String. Weitere Informationen zum httpReply-Objekt finden Sie unter „Die HTTP-API“ auf Seite 15.

dreamweaver.setLiveDataError()


BeschreibungDefiniert die Fehlermeldung, die angezeigt werden soll, wenn bei der Ausführung der Funktion liveDataTranslate-Markup() eines Übersetzers ein Fehler auftritt. Wenn das von Dreamweaver an liveDataTranslate() übergebene Dokument Fehler enthält, gibt der Server eine in HTML formatierte Fehlermeldung zurück. Sobald der Übersetzer (der Code, durch den liveDataTranslate() aufgerufen wurde) feststellt, dass der Server eine Fehlermeldung zurückgegeben hat, ruft er die Funktion setLiveDataError() auf, mit der die Fehlermeldung in Dreamweaver angezeigt wird. Diese Meldung wird erst angezeigt, wenn die Funktion liveDataTranslateMarkup() vollständig ausgeführt wurde. Dreamweaver zeigt die Beschreibung in einem Fehlerdialogfeld an. Die Funktion setLiveDataError() sollte ausschließlich von der Funktion liveDataTranslateMarkup() aufgerufen werden.


310

Argumentesource

• Das Argument source ist ein String mit Quellcode. Dieser Code wird analysiert und im Fehlerdialogfeld angezeigt.

RückgabewerteKeine

dreamweaver.setLiveDataMode()


BeschreibungSchaltet die Anzeige des Live Data-Fensters ein oder aus.

ArgumentebIsVisible

• Das Argument bIsVisible ist ein Boolescher Wert, der angibt, ob das Live Data-Fenster sichtbar sein soll. Wenn das Live Data-Fenster derzeit in Dreamweaver angezeigt wird und true an diese Funktion übergeben wird, hat dies die gleiche Wirkung wie das Klicken auf die Schaltfläche Aktualisieren.

RückgabewerteKeine

dreamweaver.setLiveDataParameters()


BeschreibungLegt die URL-Parameter, auf die Sie in Ihrem Dokument verweisen, zur Verwendung im Live Data-Modus fest.

Im Live Data-Modus können Sie Webseiten in der Entwurfsphase anzeigen (als wären sie vom Anwendungsserver übersetzt und zurückgegeben worden). Da dynamische Inhalte für die Anzeige in der Entwurfsansicht generiert werden, können Sie Ihr Seitenlayout mit Live Data anzeigen und bei Bedarf anpassen.

Bevor Sie Live Data anzeigen, müssen Sie für alle URL-Parameter, auf die Sie in Ihrem Dokument verweisen, Live Data-Einstellungen eingeben. Hierdurch wird verhindert, dass der Webserver für Parameter, die sonst in der Simulation nicht definiert sind, Fehler zurückgibt.

Sie geben die URL-Parameter in Form von Name-Wert-Paaren ein. Wenn Sie in Serverskripts in Ihrem Dokument beispielsweise auf die URL-Variablen ID und Name verweisen, müssen Sie diese URL-Parameter definieren, bevor Sie Live Data anzeigen.

Mit dieser Funktion können Sie Live Data-Werte über JavaScript festlegen.

ArgumenteliveDataString

• Das Argument liveDataString ist ein String, der die festzulegenden URL-Parameter in Name-Wert-Paaren enthält.

RückgabewerteKeine

Beispieldreamweaver.setLiveDataParameters(“ID=22&Name=Samuel”)


311

dreamweaver.showLiveDataDialog()


BeschreibungZeigt das Dialogfeld Live Data-Einstellungen an.

ArgumenteKeine

RückgabewerteKeine

Serververhalten-Funktionen Mit Serververhalten-Funktionen kann das Bedienfeld Serververhalten bearbeitet werden. Dieses Bedienfeld wird mit dem Befehl Fenster > Serververhalten aufgerufen. Mit diesen Funktionen können Sie alle Serververhalten auf einer Seite ermitteln, programmatisch ein neues Verhalten auf ein Dokument anwenden oder ein vorhandenes Verhalten modifi-zieren.

Hinweis: dw.serverBehaviorInspector kann mit dw.sbi abgekürzt werden.

dreamweaver.getParticipants()


BeschreibungDie JavaScript-Funktion dreamweaver.getParticipants() ruft eine Liste der Mitglieder aus dem Dokument des Benutzers ab. Dreamweaver sucht alle Mitglieder des Serververhaltens und speichert diese Listen. Diese Funktion wird meist zusammen mit der Funktion findServerBehaviors() zum Auffinden von Instanzen eines Verhaltens im Dokument des Benutzers verwendet. Weitere Informationen finden Sie unter „Serververhalten“ im Handbuch Dreamweaver erweitern.

ArgumenteedmlFilename

• Das Argument edmlFilename ist der Name der Gruppen- oder Mitgliederdatei mit den Namen der Mitglieder, die im Dokument des Benutzers gefunden werden sollen. Der String ist der Dateiname, ohne die Erweiterung .edml.

RückgabewerteDie Funktion gibt ein Array zurück, das alle Instanzen des angegebenen Mitglieds (bzw. bei Gruppendateien jede Instanz eines Mitglieds der Gruppe) enthält, die im Dokument des Benutzers angezeigt werden. Das Array enthält JavaScript-Objekte, wobei jedes dieser Elemente für je eine Instanz eines Mitglieds steht, das im Dokument des Benutzers gefunden wird. Das Array wird in der Reihenfolge sortiert, in der die Mitglieder im Dokument vorkommen. Jedes JavaScript-Objekt hat folgende Eigenschaften:

• participantNode ist ein Verweis auf den Knoten des Mitglieds im Dokument des Benutzers.

• participantName ist der Name der EDML-Datei des Mitglieds (ohne die .edml-Erweiterung).

• parameters ist ein JavaScript-Objekt, das alle Parameter-Wert-Paare speichert.

• matchRangeMin definiert das Zeichen-Offset vom Knoten des Mitglieds im Dokument bis zum Anfang des Mitgliedsin-halts.

• matchRangeMax ist eine Ganzzahl des Mitglieds, die das Offset vom Anfang des MitgliedsKnotens bis zum letzten Zeichen des Mitgliedsinhalts definiert.


312

dreamweaver.serverBehaviorInspector.getServerBehaviors()


BeschreibungRuft eine Liste aller Verhalten auf der Seite ab. Wenn Dreamweaver feststellt, dass die interne Liste der Serververhalten eventuell nicht mehr auf dem neuesten Stand ist, wird die Funktion findServerBehaviors() für alle derzeit installierten Verhalten aufgerufen. Jede Funktion gibt ein Array zurück. Dreamweaver verbindet alle diese Arrays zu einem einzigen Array und sortiert es in der Reihenfolge, in der die Objekte selectedNode der einzelnen Verhalten im Dokument angeordnet sind. Das verbundene Array wird intern in Dreamweaver gespeichert. Die Funktion getServerBehaviors() gibt einen Verweis auf das verbundene Array zurück.

ArgumenteKeine

RückgabewerteEin Array von JavaScript-Objekten. Bei Aufruf von findServerBehaviors() werden die Objekte im Array zurückgegeben. Sie werden in der Reihenfolge sortiert, in der sie im Bedienfeld Serververhalten angeordnet sind.

dreamweaver.popupServerBehavior()


BeschreibungWendet ein neues Serververhalten auf das Dokument an oder modifiziert ein vorhandenes Verhalten. Wenn der Benutzer Parameter für das Verhalten angeben muss, wird ein Dialogfeld eingeblendet.

Argumente{behaviorName or behaviorObject}

• Das optionale Argument behaviorName ist ein String mit dem Namen des Verhaltens, dem title-Tag einer Datei oder einem Dateinamen.

• Das optionale Argument behaviorObject ist ein Verhaltensobjekt.

Wenn Sie das Argument nicht angeben, führt Dreamweaver das derzeit ausgewählte Serververhalten aus. Handelt es sich beim Argument um den Namen eines Serververhaltens, fügt Dreamweaver dieses Verhalten in die Seite ein. Wenn das Argument einem der Objekte entspricht, die mit dem Array der Funktion getServerBehaviors() zurückgegeben wurden, wird ein Dialogfeld angezeigt, wodurch der Benutzer die Parameter für das Verhalten modifizieren kann.

RückgabewerteKeine


313

Servermodell-FunktionenIn Dreamweaver hat jedes Dokument einen zugehörigen Dokumenttyp. Bei dynamischen Dokumenttypen weist Dream-weaver zudem ein Servermodell zu (wie ASP-JS, ColdFusion oder PHP-MySQL).

Servermodelle gruppieren die Funktionen, die konkret bei einer bestimmten Servertechnologie zur Verfügung stehen. Je nach dem Servermodell, das zum Dokument gehört, werden unterschiedliche Serververhalten, Datenquellen und so weiter angezeigt.

Anhand der Servermodell-Funktionen können Sie Folgendes ermitteln: die derzeit definierten Servermodelle, Name, Sprache und Version des aktuellen Servermodells und ob das aktuelle Servermodell einen benannten Zeichensatz (wie UTF-8) unterstützt.

Hinweis: Dreamweaver liest alle Daten in der HTML-Datei des Servermodells und speichert diese Informationen, wenn das Servermodell zum ersten Mal geladen wird. Wenn eine Erweiterung dann Funktionen wie dom.serverModel.getServ-erName(), dom.serverModel.getServerLanguage(), und dom.serverModel.getServerVersion() aufruft, geben diese Funktionen die gespeicherten Werte zurück.

dom.serverModel.getAppURLPrefix()


BeschreibungGibt die URL des Site-Stammordners auf dem Testserver zurück. Dies ist die URL, die auch im Dialogfeld Site-Definition auf der Registerkarte Erweitert unter Testserver angegeben wird.

Bei der Kommunikation mit dem Testserver verwendet Dreamweaver HTTP (wie ein Browser). Dabei wird diese URL für den Zugriff auf den Site-Stammordner verwendet.

ArgumenteKeine

RückgabewerteEin String mit der URL des Anwendungsservers, der für Live Data- und Debug-Zwecke verwendet wird.

BeispielAngenommen, der Benutzer erstellt eine Site und gibt an, dass der Testserver sich auf dem lokalen Computer befindet und der Stammordner den Namen "employeeapp" hat. In diesem Fall wird bei einem Aufruf der Funktion dom.server-Model.getAppURLPrefix() der folgende String zurückgegeben: http://localhost/employeeapp/

dom.serverModel.getDelimiters()


BeschreibungHiermit kann der JavaScript-Code das Skript-Trennzeichen für die einzelnen Servermodelle abrufen. Auf diese Weise kann der Servermodell-Code getrennt von dem vom Benutzer erstellten Code verwaltet werden.

ArgumenteKeine


314

RückgabewerteEin Array von Objekten, wobei jedes Objekt die drei folgenden Eigenschaften enthält:

• startPattern ist ein regulärer Ausdruck, der dem Anfangstrennzeichen des Skripts entspricht.

• endPattern ist ein regulärer Ausdruck, der dem Schlusstrennzeichen des Skripts entspricht.

• participateInMerge ist ein Boolescher Wert, der angibt, ob der von den aufgelisteten Trennzeichen eingeschlossene Inhalt am Verbinden von Blöcken beteiligt sein soll (true) oder nicht (false).

dom.serverModel.getDisplayName()


BeschreibungRuft den Servermodellnamen ab, der in der Benutzeroberfläche angezeigt wird.

ArgumenteKeine

RückgabewerteEin String, dessen Wert der Name des Servermodells ist.

dom.serverModel.getFolderName()


BeschreibungRuft den Namen des Ordners ab, der innerhalb des Ordners Configuration für dieses Servermodell verwendet wird (z. B. im Unterordner ServerModels).

ArgumenteKeine

RückgabewerteEin String, dessen Wert der Name des Ordners ist.

dom.serverModel.getServerExtension() (veraltet)

VerfügbarkeitDreamweaver UltraDev 4; in Dreamweaver MX veraltet.

BeschreibungGibt die Standarddateierweiterung von Dateien zurück, die das aktuelle Servermodell verwenden. (Die Standarddateier-weiterung wird zuerst in der Liste aufgeführt.) Das Objekt serverModel wird auf das Servermodell der aktuell ausgewählten Site gesetzt, wenn derzeit kein Benutzerdokument ausgewählt ist.

ArgumenteKeine

RückgabewerteEin String, der die unterstützten Dateierweiterungen anzeigt.

315

dom.serverModel.getServerIncludeUrlPatterns()


BeschreibungGibt die folgende Liste mit Eigenschaften zurück, mit denen Sie auf Folgendes zugreifen können:

• Übersetzer-URL-Muster

• Dateiverweise

• Typ

ArgumenteKeine

RückgabewerteEine Objektliste mit je einem Objekt pro searchPattern. Jedes Objekt hat die drei folgenden Eigenschaften:

BeispielDas folgende Codefragment einer Mitgliederdatei veranschaulicht ein Übersetzer-Tag searchPatterns:

<searchPatterns whereToSearch="directive">

<searchPattern paramNames=",ssi_comment_includeUrl"><![CDATA[//i]]>

</searchPattern>

</searchPatterns>

Das Suchmuster enthält einen regulären JavaScript-Ausdruck, der zwei untergeordnete Übereinstimmungen angibt (beide sind in Klammern eingeschlossen). Die erste untergeordnete Übereinstimmung bezieht sich auf den Textstring file oder virtual. Die zweite untergeordnete Übereinstimmung ist ein Dateiverweis.

Für den Zugriff auf das Übersetzer-URL-Muster muss Ihr Code wie im folgenden Beispiel aussehen:

var serverModel = dw.getDocumentDOM().serverModel;

var includeArray = new Array();

includeArray = serverModel.getServerIncludeUrlPatterns();

Der Aufruf von serverModel.getServerIncludeUrlPatterns() gibt die drei folgenden Eigenschaften zurück:


pattern Ein regulärer JavaScript-Ausdruck, der im Feld searchPattern einer EDML-Datei angegeben wird, sofern die Datei den Kriterien entspricht. (Ein regulärer Ausdruck wird von zwei Schrägstrichen (//) begrenzt.)

fileRef Der 1-basierte Index der untergeordneten Übereinstimmung eines regulären Aus-drucks, die dem eingeschlossenen Dateiverweis entspricht.

type Der Teil des Wertes paramName, der übrig bleibt, nachdem das Suffix _includeUrl ent-fernt wurde. Dieser Typ wird dem type-Attribut des Tags <MM:BeginLock> zugewie-sen. Ein Beispiel finden Sie in der Datei Server Model SSI.htm im Ordner Configura-tion/Translators.

Eigenschaft Rückgabewert

pattern //i

fileRef 2

eingeben ssi_comment


316

dom.serverModel.getServerInfo()


BeschreibungGibt Informationen zurück, die sich konkret auf das aktuelle Servermodell beziehen. Diese Informationen sind in der HTML-Definitionsdatei des Servermodells definiert, die sich im Ordner Configuration\ServerModels befindet.

Sie können die Informationen in der HTML-Definitionsdatei bearbeiten bzw. zusätzliche Variablenwerte oder Funktionen in die Datei einfügen. Beispielsweise können Sie die Eigenschaften serverName, serverLanguage und serverVersion ändern. Die Funktion dom.serverModel.getServerInfo() gibt die Informationen zurück, die der Autor des Servermodells in die Definitionsdatei einfügt.

Hinweis: Die anderen Werte, die in den Servermodell-Standarddateien definiert sind, sind nur für die interne Verwendung vorgesehen.

serverName, serverLanguage und serverVersion sind besondere Eigenschaften, da Entwickler direkt auf diese Eigen-schaften zugreifen können, und zwar mithilfe der folgenden zugehörigen Funktionen:

• dom.serverModel.getServerName()

• dom.serverModel.getServerLanguage()

• dom.serverModel.getServerVersion()

ArgumenteKeine

RückgabewerteEin JavaScript-Objekt mit verschiedenen Informationen, die sich konkret auf das aktuelle Servermodell beziehen.

dom.serverModel.getServerLanguage() (veraltet)

VerfügbarkeitUltraDev 1; in Dreamweaver MX veraltet.

BeschreibungErmittelt das Servermodell, das zum Dokument gehört, und gibt diesen Wert zurück. Bei der Serversprache einer Site handelt es sich um den Wert, der im Dialogfeld Site-Definition auf der Registerkarte Anwendungsserver-Infos unter Standard-Skriptsprache angegeben ist. Um den Rückgabewert abzurufen, ruft diese Funktion die Funktion getServer-Language() in der Servermodell-API auf.

Hinweis: Die Liste Standard-Skriptsprache ist nur in Dreamweaver 4 und früheren Versionen vorhanden. In Dreamweaver MX oder höher enthält das Dialogfeld Site-Definition keine Liste der unterstützten Skriptsprachen. In Dream-weaverMX oder höher liest die Funktion dom.serverModel.getServerLanguage() außerdem die Eigenschaft serverLan-guage des Objekts, das bei einem Aufruf der Funktion getServerInfo() in der Servermodell-API zurückgegeben wird.

ArgumenteKeine

RückgabewerteEin String mit den unterstützten Skriptsprachen.


317

dom.serverModel.getServerName()

VerfügbarkeitDreamweaver 1, in Dreamweaver MX verbessert.

BeschreibungRuft das Servermodell ab, das zum Dokument gehört, und gibt diesen Wert zurück. Der Servername unterscheidet sich je nach Technologie (wie z. B. ASP.NET und JSP), unterscheidet sich jedoch nicht zwischen den Sprachen in der gleichen Servertechnologie (wie z. B. ASP.NET VB und ASP.NET C#). Zu den möglichen Werten gehören ASP, ASP.NET, ColdFusion, JSP und PHP.

Informationen zum Abrufen des mit dem Dokument verknüpften Servermodellnamens finden Sie unter „dom.server-Model.getDisplayName()“ auf Seite 314 oder „dom.serverModel.getFolderName()“ auf Seite 314.

Hinweis: In Dreamweaver MX oder höher liest dom.serverModel.getServerName() außerdem die Eigenschaft serverName des Objekts, das bei einem Aufruf der Funktion getServerInfo() in der Servermodell-API zurückgegeben wird.

ArgumenteKeine

RückgabewerteEin String, der den Servernamen enthält.

dom.serverModel.getServerSupportsCharset()


BeschreibungBestimmt, ob das zum Dokument gehörige Servermodell den benannten Zeichensatz unterstützt.

Hinweis: Sie können diese Funktion von der JavaScript-Ebene aus aufrufen. Zusätzlich ruft Dreamweaver diese Funktion auf, wenn der Benutzer die Codierung im Dialogfeld Eigenschaften der Seite ändert. Wenn das Servermodell die neue Zeichenco-dierung nicht unterstützt, gibt diese Funktion false zurück, und in Dreamweaver wird ein Warndialogfeld eingeblendet, in dem der Benutzer gefragt wird, ob die Konvertierung wirklich durchgeführt werden soll. Diese Situation tritt beispielsweise ein, wenn ein Benutzer versucht, ein ColdFusion 4.5-Dokument in UTF-8 zu konvertieren, da ColdFusion die UTF-8-Codierung nicht unterstützt.

ArgumentemetaCharSetString

• Das Argument metaCharSetString ist ein String, der einen bestimmten Zeichensatz angibt. Dieser Wert entspricht dem Wert des Attributs "charset=" des Tags meta, das zum Dokument gehört. Die Werte, die für ein bestimmtes Server-modell unterstützt werden, sind in der HTML-Definitionsdatei des Servermodells definiert. Diese Datei befindet sich im Ordner Configuration\ServerModels.

RückgabewerteEin Boolescher Wert: true, wenn das Servermodell den genannten Zeichensatz unterstützt, andernfalls false.


318

dom.serverModel.getServerVersion()

VerfügbarkeitDreamweaver 1, in Dreamweaver MX verbessert.

BeschreibungErmittelt das Servermodell, das zum Dokument gehört, und gibt diesen Wert zurück. Jedes Servermodell verfügt über die Funktion getVersionArray(), wie in der Servermodell-API definiert, die eine Tabelle mit Name-Version-Paaren zurückgibt.

Hinweis: In Dreamweaver liest dom.serverModel.getServerVersion() zunächst die Eigenschaft serverVersion des Objekts, das bei einem Aufruf der Funktion getServerInfo() in der Servermodell-API zurückgegeben wird. Wenn diese Eigenschaft nicht vorhanden ist, liest dom.serverModel.getServerVersion() die Eigenschaft aus der Funktion getVersion-Array().

Argumentename

• Das Argument name ist ein String, der den Namen des Servermodells angibt.

RückgabewerteEin String mit der Version des genannten Servermodells.

dom.serverModel.testAppServer()


BeschreibungPrüft, ob eine Verbindung zum Anwendungsserver hergestellt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob die Verbindung zum Anwendungsserver erfolgreich hergestellt werden konnte.

dreamweaver.getServerModels()


BeschreibungRuft die Namen aller derzeit definierten Servermodelle ab. Dies sind die gleichen Namen, die in der Benutzeroberfläche im Feld Servermodell des Dialogfelds Site-Definition angezeigt werden.

ArgumenteKeine

RückgabewerteEin String-Array. Jedes String-Element enthält den Namen eines derzeit definierten Servermodells.

319

Kapitel 17: Design

Mit den Designfunktionen in Adobe® Dreamweaver® CS3 lassen sich Vorgänge ausführen, die mit dem Entwurf des Erscheinungsbilds von Dokumenten zu tun haben. Darunter fallen die Anwendung bestimmter CSS-Stile (Cascading Stylesheet), das vertikale bzw. horizontale Teilen ausgewählter Frames, das Ausrichten ausgewählter Ebenen oder Hotspots, die Wiedergabe ausgewählter Plug-In-Inhalte, das Erstellen von Layoutzellen oder das Bearbeiten von Zeilen oder Spalten in einer Tabelle.


• „CSS-Layoutfunktionen“ auf Seite 319

• „Frame- und Frameset-Funktionen“ auf Seite 336

• „Ebenen- und Imagemap-Funktionen“ auf Seite 337

• „Funktionen für die Layout-Umgebung“ auf Seite 340

• „Layoutansicht-Funktionen“ auf Seite 344

• „Vergrößerungsfunktionen“ auf Seite 353

• „Funktionen und Eigenschaften für Hilfslinien“ auf Seite 355

• „Tabellenbearbeitungsfunktionen“ auf Seite 362

CSS-Layoutfunktionen Mit CSS-Funktionen werden CSS-Stile angewendet, entfernt, erstellt und gelöscht. Die Methoden des Objekts dream-weaver.cssRuleTracker gelten für die Auswahl im Bedienfeld CSS-Regelverfolgung des Auswahlinspektors. Die Methoden des Objekts dreamweaver.cssStylePalette gelten für die Auswahl im Bedienfeld CSS-Stile, nicht die im aktuellen Dokument.

dom.applyLayout()


BeschreibungWendet ein CSS-basiertes Layout auf das Dokument an. Der Hauptteil des Dokuments muss leer sein, und bei dem Dokument muss es sich um eine Seite handeln, auf die ein Layout angewendet werden kann. Das trifft zu auf:

• eine HTML-gestützte Seite, zum Beispiel HTML, XHTML, ColdFusion, PHP usw. (jedoch nicht CSS, XML, JavaScript usw.)

• eine Seite, bei der es sich nicht um ein Frameset oder eine Vorlageninstanz handelt (eine Vorlage selbst kann jedoch verwendet werden)

Argumentelayout-index, CSS, cssFileName, preventOverwrite

• layout-index ist ein ganzzahliger, nullbasierter Index, der das zu verwendende Layout angibt. Dies ist ein Index für die Liste der Layouts, der verwendet wird, um die Namen (layoutNames) und Beschreibungen (layoutDescriptions) in den entsprechenden Funktionen zurückzugeben.

• CSS gibt an, wo das CSS-Layout bereitgestellt werden soll. Folgende Werte sind möglich:

• „embed“ - das CSS in den Head-Bereich des Dokuments einbetten.

• „link“ - verknüpfen mit cssFileName.


320

• „create_and_link“ - CSS in cssFileName schreiben und Verknüpfung dazu herstellen.

• „import“- cssFileName importieren.

• „create_and_import“ - CSS in cssFileName schreiben und importieren.

• cssFileName ist der Name der CSS-Datei, die verknüpft oder importiert und ggf. erstellt werden soll.

• preventOverwrite ist ein Boolescher Wert: true: wenn eine neue CSS-Datei erstellt wird (schlägt fehl, wenn die Datei bereits vorhanden ist)false: die Datei überschreiben, falls sie bereits vorhanden ist

RückgabewerteEin Boolescher Wert: true: das Layout wurde erfolgreich angewendet false: das Layout wurde nicht erfolgreich angewendet

Beispieldw.getLayoutNames();


alert (theDOM.canApplyLayout());

if (theDOM.canApplyLayout())

theDOM.applyLayout(1, "embed");

else

alert("can't apply layout to this doc");

dom.canApplyLayout()


BeschreibungÜberprüft, ob ein CSS-basiertes Layout auf das Dokument angewendet werden kann. Es wird überprüft, ob der Hauptteil des Dokuments leer ist, und ob es sich um eine Seite handelt, auf die ein Layout angewendet werden kann. Das trifft zu auf:

• eine im Wesentliche HTML-gestützte Seite, zum Beispiel HTML, XHTML, ColdFusion, PHP usw. (jedoch nicht CSS, XML, JavaScript usw.)

• eine Seite, bei der es sich nicht um ein Frameset oder eine Vorlageninstanz handelt (eine Vorlage selbst kann jedoch verwendet werden)

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true: das Layout kann angewendet werdenfalse: das Layout kann nicht angewendet werden

dw.getFilesForLayout()


BeschreibungRuft die Pfade der Konfigurationsdateien für das angegebene Layout ab.

ArgumentelayoutIndex


321

• layoutIndex ist ein ganzzahliger, nullbasierter Index, der das Layout angibt. Dies ist ein Index für die Liste der Layouts, der verwendet wird, um die Namen (layoutNames) und Beschreibungen (layoutDescriptions) in den entsprechenden Funktionen zurückzugeben.

RückgabewerteEin Stringarray, der die vollständigen Pfade der HTML- und Vorschaubilddateien enthält (dies kann null sein).

dw.getLayoutNames()


BeschreibungRuft die Namen der verfügbaren CSS-basierten Layouts ab.

ArgumenteKeine

RückgabewerteEin Stringarray mit Layoutnamen.

dw.getLayoutDescriptions()


BeschreibungRuft die Beschreibungen der verfügbaren CSS-basierten Layouts ab.

ArgumenteKeine

RückgabewerteEin Stringarray mit Layoutbeschreibungen.

dom.applyCSSStyle()


BeschreibungWendet den angegebenen Stil auf das betreffende Element an. Diese Funktion ist nur für das aktive Dokument gültig.

ArgumenteelementNode, styleName, {classOrID}, {bForceNesting}

• Das Argument elementNode ist ein Elementknoten im DOM. Wenn für elementNode der Wert null oder ein leerer String (''") angegeben wird, wirkt die Funktion sich auf die aktuelle Auswahl aus.

• Das Argument styleName ist der Name eines CSS-Stils.

• Das optionale Argument classOrID ist das Attribut, mit dem der Stil angewendet werden soll (entweder "class" oder "id"). Wenn für das Argument elementNode der Wert null bzw. ein leerer String gilt und die Auswahl nicht exakt von einem Tag umschlossen wird, wird der Stil mit SPAN-Tags angewendet. Wenn es sich bei der Auswahl um eine Einfüge-marke handelt, wird der Stil heuristisch bestimmt.


322

• Das optionale Argument bForceNesting ist ein Boolescher Wert, der angibt, ob die Verschachtelung zulässig ist. Wenn bForceNesting angegeben wird, fügt Dreamweaver ein neues SPAN-Tag ein. Dabei wird nicht versucht, die vorhandenen Tags im Dokument zu modifizieren. Wenn dieses Argument nicht angegeben wird, gilt der Standardwert false.

RückgabewerteKeine

BeispielMit dem folgenden Code wird der Stil red auf die Auswahl angewendet. Dazu werden entweder SPAN-Tags um die Auswahl gelegt oder ein CLASS-Attribut wird auf das die Auswahl umschließende Tag angewendet:

var theDOM = dreamweaver.getDocumentDOM('document');

theDOM.applyCSSStyle('','red');

dom.getElementView()


BeschreibungDiese Funktion ruft für das im Dokument ausgewählte Element die Elementansicht auf. Handelt es sich um ein normales Element, sucht die Funktion getElementView() nach dem ersten Vorfahren des ausgewählten Elements, der entweder vollständig angezeigt wird oder verborgen ist.

ArgumenteKeine

RückgabewerteEin String, der den Status des ausgewählten Elements anzeigt. Folgende Werte sind zulässig:

• "hidden", wodurch angezeigt wird, dass das Element CSS-Eigenschaften besitzt, die bewirken, dass in der Entwurfsan-sicht Inhalte teilweise oder vollständig verborgen werden. Folgende CSS-Eigenschaften werden unterstützt:

• overflow: hidden, scroll oder auto

• display: none

• "full", wodurch angezeigt wird, dass das Element standardmäßig zwar "hidden" ist, momentan aber vollständig angezeigt wird, gemäß der Einstellung durch die Funktion setElementView("full").

• "normal", wodurch angezeigt wird, dass das Element weder verborgen ist ("hidden") noch vollständig angezeigt wird ("full").

BeispielIm folgenden Beispiel wird der Status des ausgewählten Elements auf "full" geändert, wenn es verborgen ("hidden") ist:


if (currentDOM && getElementView() == "hidden"){

currentDOM.setElementView("full");

}

dom.getShowDivBackgrounds()


BeschreibungDiese Funktion ruft den Zustand des visuellen Hilfsmittels Layoutblock-Hintergründe ab.


323

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Layoutblock-Hintergründe aktiviert sind, andernfalls false.

BeispielIm folgenden Beispiel wird überprüft, ob das visuelle Hilfsmittel Layoutblock-Hintergründe aktiviert ist. Ist das nicht der Fall, wird es aktiviert.


if (currentDOM.getShowDivBackgrounds() == false){

currentDOM.setShowDivBackgrounds(true);

}

dom.getShowDivBoxModel()


BeschreibungDiese Funktion ruft den Zustand des visuellen Hilfsmittels Layoutblock-Box-Modell ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Layoutblock-Box-Modell aktiviert ist, andernfalls false.

BeispielIm folgenden Beispiel wird überprüft, ob das visuelle Hilfsmittel Layoutblock-Box-Modell aktiviert ist. Ist das nicht der Fall, wird es aktiviert.


if (currentDOM.getShowDivBoxModel() == false){

currentDOM.setShowDivBoxModel(true);

}

dom.getShowDivOutlines()


BeschreibungDiese Funktion ruft den Zustand des visuellen Hilfsmittels Layoutblock-Konturen ab.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Layoutblock-Konturen aktiviert sind, andernfalls false.

BeispielIm folgenden Beispiel wird überprüft, ob das visuelle Hilfsmittel Layoutblock-Konturen aktiviert ist. Ist das nicht der Fall, wird es aktiviert.


324


if (currentDOM.getShowDivOutlines() == false){

currentDOM.setShowDivOutlines(true);

}

dom.removeCSSStyle()


BeschreibungEntfernt das Attribut CLASS oder ID vom angegebenen Element bzw. entfernt das SPAN-Tag, das das angegebene Element vollständig umschließt. Diese Funktion ist nur für das aktive Dokument gültig.

ArgumenteelementNode, {classOrID}

• Das Argument elementNode ist ein Elementknoten im DOM. Wenn für elementNode ein leerer String ('') angegeben wird, wirkt sich die Funktion auf die aktuelle Auswahl aus.

• Das optionale Argument classOrID ist das zu entfernende Attribut (entweder "class" oder "id"). Wenn das Argument classOrID nicht angegeben wird, gilt der Standardwert "class". Wenn kein CLASS-Attribut für das Argument elementNode definiert ist, wird das SPAN-Tag, der das Argument elementNode umgibt, entfernt.

RückgabewerteKeine

dom.resetAllElementViews()


BeschreibungDiese Funktion setzt die Elementansicht aller Elemente im Dokument auf die ursprüngliche Ansicht zurück, indem der gesamte intern generierte CSS-Code entfernt wird.

ArgumenteforceRefresh

• Das optionale Argument forceRefresh ist ein Boolescher Wert, der angibt, ob die Darstellung des gesamten Dokuments aktualisiert werden soll, wenn kein interner CSS-Code vorliegt. Der Wert true bewirkt eine Aktualisierung. Der Standardwert ist false.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird die Elementansicht aller Elemente im Dokument zurückgesetzt ohne eine Aktualisierung der Darstellung zu erzwingen.


currentDOM.resetAllElementViews(false);

dom.setElementView()



325

BeschreibungDiese Funktion setzt die Elementansicht für das im Dokument ausgewählte Element. Ist das ausgewählte Element "normal", sucht die Funktion setElementView() nach dem ersten Vorfahren des ausgewählten Elements, der vollständig anzeigt wird ("full") oder verborgen ist ("hidden").

ArgumenteAnsicht

• Das obligatorische Argument view ist ein String, der das zurzeit ausgewählte Element auf "full" oder "hidden" setzt. Ist das ausgewählte Element "normal", sucht die Funktion setElementView() nach dem ersten Vorfahren des ausge-wählten Elements, der vollständig anzeigt wird ("full") oder verborgen ist ("hidden"). Weitere Informationen hierzu finden Sie unter „dom.getElementView()“ auf Seite 322. Folgende Werte sind möglich:

• "full" – Entfernt den internen CSS-Code, durch den das Element vollständig angezeigt wurde, so dass das Element wieder seinen ursprünglichen Zustand annimmt.

• "hidden" – Wird das ausgewählte Element gerade verborgen, erzeugt Dreamweaver den erforderlichen CSS-Code, um den gesamten Inhalt anzuzeigen, und wendet dann den CSS-Code als internes Entwurfszeit-Stylesheet an.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dom.getElementView()“ auf Seite 322.

dom.setShowDivBackgrounds()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert das visuelle Hilfsmittel Layoutblock-Hintergründe.

Argumenteshow

• Das obligatorische Argument show ist ein Boolescher Wert, der angibt, ob die Layoutblock-Hintergründe aktiviert werden sollen. Wird show auf true gesetzt, werden die Layoutblock-Hintergründe aktiviert.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dom.getShowDivBackgrounds()“ auf Seite 322.

dom.setShowDivBoxModel()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert das visuelle Hilfsmittel Layoutblock-Box-Modell.

ArgumenteEinblenden


326

• Das obligatorische Argument show ist ein Boolescher Wert, der angibt, ob das Layoutblock-Box-Modell aktiviert werden sollen. Wird show auf true gesetzt, wird das visuelle Hilfsmittel Layoutblock-Box-Modell aktiviert.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dom.getShowDivBoxModel()“ auf Seite 323.

dom.setShowDivOutlines()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert das visuelle Hilfsmittel Layoutblock-Konturen.

ArgumenteEinblenden

• Das obligatorische Argument show ist ein Boolescher Wert, der angibt, ob die Layoutblock-Konturen aktiviert werden sollen. Wird show auf true gesetzt, werden die Layoutblock-Konturen aktiviert.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dom.getShowDivOutlines()“ auf Seite 323.

dreamweaver.cssRuleTracker.editSelectedRule()


BeschreibungErmöglicht es dem Benutzer, die aktuell ausgewählte Regel in der Regelverfolgung zu bearbeiten. Diese Funktion zeigt die ausgewählte Regel im CSS-Eigenschaftenraster und, falls erforderlich, das Eigenschaftenraster sowie die entsprechenden schwebenden Fenster an.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssRuleTracker.canEditSelectedRule()“ auf Seite 431.

dreamweaver.cssRuleTracker.newRule()


BeschreibungÖffnet das Dialogfeld Neuer CSS-Stil, in dem der Benutzer eine neue Regel erstellen kann.


327

ArgumenteKeine

RückgabewerteKeine

dreamweaver.cssStylePalette.applySelectedStyle()


BeschreibungWendet den ausgewählten Stil auf das derzeit aktive Dokument oder das damit verknüpfte Stylesheet an, abhängig von der Auswahl im Bedienfeld CSS-Stile.

Argumente{ pane }

• Das optionale Argument pane ist ein String, der den Bereich des Bedienfelds Stile beschreibt, auf den diese Funktion angewendet wird. Mögliche Werte sind: "stylelist", die Liste der Stile im Modus „Alle“, "cascade", die Liste anwend-barer, relevanter Regeln im Modus „Aktuell“, "summary", die Liste der Eigenschaften für die aktuelle Auswahl im Modus „Aktuell“, und "ruleInspector", die editierbare Liste bzw. das Raster mit den Eigenschaften im Modus „Aktuell“. Der Standardwert ist "stylelist".

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canApplySelectedStyle()“ auf Seite 432.

dreamweaver.cssStylePalette.attachStyleSheet()


BeschreibungBlendet ein Dialogfeld ein, in dem der Benutzer ein Stylesheet mit dem derzeit aktiven Dokument oder einem der daran angehängten Stylesheets verknüpfen kann, abhängig von der Auswahl im Bedienfeld CSS-Stile.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.cssStylePalette.deleteSelectedStyle()


BeschreibungLöscht den derzeit im Bedienfeld CSS-Stile ausgewählten Stil aus dem Dokument.

Argumente{ pane }


328


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canDeleteSelectedStyle()“ auf Seite 432.

dreamweaver.cssStylePalette.duplicateSelectedStyle()


BeschreibungDupliziert den Stil, der momentan im Bedienfeld CSS-Stile ausgewählt ist, und zeigt das Dialogfeld Duplizierter Stil an, in dem der Benutzer dem neuen Stil einen Namen oder einen Selektor zuweisen kann.

Argumente{ pane }


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canDuplicateSelectedStyle()“ auf Seite 432.

dreamweaver.cssStylePalette.editSelectedStyle()


BeschreibungÖffnet das Dialogfeld Stildefinition für den Stil, der im Bedienfeld CSS-Stile aktuell ausgewählt ist.

Argumente{ pane }


RückgabewerteKeine


329

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canEditSelectedStyle()“ auf Seite 433.

dreamweaver.cssStylePalette.editSelectedStyleInCodeview()


BeschreibungDiese Funktion wechselt in die Codeansicht und setzt den Mauszeiger auf den Code für den Stil, der gerade im Bedienfeld CSS-Stile ausgewählt ist.

Argumente{ pane }


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canEditSelectedStyleInCodeview()“ auf Seite 433.

dreamweaver.cssStylePalette.editStyleSheet()


BeschreibungÖffnet das Dialogfeld Stylesheet bearbeiten.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canEditStyleSheet()“ auf Seite 434.

dreamweaver.cssStylePalette.getDisplayStyles()


BeschreibungDiese Funktion bestimmt, ob CSS-Stile dargestellt werden. Der Standardwert ist true.

ArgumenteKeine


330

RückgabewerteEin Boolescher Wert: true, wenn CSS-Stile dargestellt werden, andernfalls false.

Beispielvar areStylesRendered = dw.cssStylePalette.getDisplayStyles();

dreamweaver.cssStylePalette.getMediaType()


BeschreibungRuft Zielmedientypen für die Darstellung ab. Der Standardmedientyp lautet "screen".

ArgumenteKeine

RückgabewerteEin String, der den Zielmedientyp angibt.

Beispielvar mediaType = dw.cssStylePalette.getMediaType();

dreamweaver.cssStylePalette.getSelectedStyle()

VerfügbarkeitDreamweaver 3; fullSelector verfügbar in Dreamweaver MX.

BeschreibungRuft den Namen des Stils ab, der im Bedienfeld CSS-Stile aktuell ausgewählt ist.

ArgumentefullSelector

• Das Argument fullSelector ist ein Boolescher Wert, der anzeigt, ob der vollständige Selektor oder nur die Klasse zurückgegeben werden soll. Gibt der Benutzer nichts an, wird nur der Klassenname zurückgegeben. Der Selektor p.class1 legt z. B. fest, dass der Stil auf alle p-Tags von class1, nicht aber auf das Tag div von class1 angewendet wird. Ohne das Argument fullSelector gibt die Funktion dreamweaver.cssStylePalette.getSelectedStyle() nur den Klassennamen class1 für den Selektor an. Das Argument fullSelector weist die Funktion an, p.class1 anstelle von class1 zurückzugeben.

RückgabewerteWenn das Argument fullSelector auf true gesetzt ist, gibt die Funktion den vollständigen Selektor zurück. Ist der Stylesheet-Knoten ausgewählt, wird ein leerer String zurückgegeben.

Wenn das Argument fullSelector auf false gesetzt oder ausgelassen wurde, wird ein String für den Klassennamen des ausgewählten Stils zurückgegeben. Wenn der ausgewählte Stil keine Klasse hat bzw. ein Stylesheet-Knoten ausgewählt wurde, wird ein leerer String zurückgegeben.

BeispielWenn wie abgebildet der Stil red ausgewählt ist, wird beim Aufruf der Funktion dw.cssStylePalette.getSelec-tedStyle() der String "red" zurückgegeben.


331

dreamweaver.cssStylePalette.getSelectedTarget() (veraltet)

VerfügbarkeitDreamweaver 3, in Dreamweaver MX nicht mehr empfohlen, weil das Bedienfeld CSS-Stile nicht mehr das Menü Anwenden auf enthält.

BeschreibungDiese Funktion ruft das Element ab, das im Popupmenü Anwenden auf oben im Bedienfeld CSS-Stile ausgewählt ist.

ArgumenteKeine

RückgabewerteEine nicht mehr empfohlene Funktion; gibt immer den Wert null zurück.

dreamweaver.cssStylePalette.getStyles()


BeschreibungRuft eine Liste aller class-Stile im aktiven Dokument ab. Wenn keine Argumente übergeben werden, werden die Klassenselektornamen zurückgegeben. Wenn das Argument bGetIDs den Wert true hat, werden ID-Selektornamen zurückgegeben. In jedem Fall gilt, dass der vollständige Selektorname zurückgegeben wird, wenn das Argument bGetFullSelector den Wert true hat.

Eine HTML-Datei kann z. B. den folgenden Code enthalten:

<Stil>

.test{ background:none };

p.foo{ background:none };

#bar {background:none };

div#hello p.world {background:none};

Die Aufrufe in der folgenden Tabelle geben die Werte in der Spalte „Ergebnis“ zurück.

Argumente{bGetIDs, bGetFullSelector}

• Das Argument bGetIDs ist optional. Wenn der Boolesche Wert des Arguments true ist, gibt die Funktion ID-Selektor-namen (jeweils der Teil nach dem „#“) zurück. Der Standardwert ist false.

• Das Argument bGetFullSelector ist optional. Wenn der Boolesche Wert des Arguments true ist, wird der vollständige Selektorstring und nicht nur der Name zurückgegeben. Der Standardwert ist false.

RückgabewerteEin Array von Strings mit den Namen aller class-Stile im Dokument.

Funktionsaufruf Ergebnis

dw.cssStylePalette.getStyles() foo,test,world

dw.cssStylePalette.getStyles(true) bar,hello

dw.cssStylePalette.getStyles(false, true) p.foo,.test,div#hello p.world

dw.cssStylePalette.getStyles(true, true) #bar,div#hello p.world


332

BeispielWenn das Bedienfeld CSS-Stile wie in der folgenden Abbildung dargestellt eingerichtet ist, wird durch Aufruf der Funktion dreamweaver.cssStylePalette.getStyles() ein Array mit den folgenden Strings zurückgegeben: "BreadcrumbEnd", "change", "doctitle", "heading" und "highlight":

dreamweaver.cssStylePalette.newStyle()


BeschreibungÖffnet das Dialogfeld Neuer Stil.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.cssStylePalette.renameSelectedStyle()


BeschreibungBenennt den Klassennamen in der ausgewählten Regel im Bedienfeld Stile sowie alle Instanzen des Klassenamens in der ausgewählten Regel um.

Argumente{ pane }


RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.cssStylePalette.canRenameSelectedStyle()“ auf Seite 434.


333

dreamweaver.cssStylePalette.setDisplayStyles()


BeschreibungDiese Funktion bestimmt, ob CSS-Stile dargestellt werden sollen und aktualisiert die Darstellung aller geöffneter Dokumente.

Argumentedisplay

• Das Argument display ist ein Boolescher Wert: true für eine Darstellung der CSS-Stille, andernfalls false.

RückgabewerteKeine

BeispielIm folgenden Beispiel wird die Darstellung von CSS-Stilen deaktiviert:

dw.cssStylePalette.setDisplayStyles(false);

dreamweaver.cssStylePalette.setMediaType()


BeschreibungRichtet Zielmedientypen für die Darstellung ein. Aktualisiert die Darstellung aller geöffneten Dokumente.

ArgumentemediaType

• Das Argument mediaType gibt den neuen Zielmedientyp an.

RückgabewerteKeine

Beispieldw.cssStylePalette.setMediaType("print");

dreamweaver.getBlockVisBoxModelColors()


BeschreibungDiese Funktion ruft die Farben für die Darstellung des Box-Modells für einen ausgewählten Block ab, wenn das visuelle Hilfsmittel Layoutblock-Box-Modell aktiviert ist.

ArgumenteKeine

RückgabewerteEin String-Array mit zwei Strings:

• marginColor, der hexadezimale Wert der RGB-Farbe in der Form #RRGGBB paddingColor, der hexadezimale Wert der RGB-Farbe in der Form #RRGGBB.


334

BeispielIm folgenden Beispiel werden die Werte der Rand- und der Auffüllungsfarbe überprüft. Ist keiner der Werte Weiß, werden beide auf Weiß gesetzt:

var boxColors = dreamweaver.getBlockVisBoxModelColors();

if ((boxColors[0] != "#FFFFFF") || (boxColors[1] != "#FFFFFF)){

currentDOM.setBlockVisBoxModelColors("#FFFFFF", "#FFFFFF");

}

dreamweaver.getBlockVisOutlineProperties()


BeschreibungDiese Funktion ruft die Kontureneigenschaften für die visuellen Hilfsmittel zur Blockvisualisierung ab.

ArgumenteforWhat

• Das obligatorische Argument forWhat ist ein String. Mögliche Werte sind "divs", "selectedDiv" oder "layers". Hat das Argument forWhat den Wert "divs", gibt die Funktion die verwendeten Eigenschaften für das visuelle Hilfsmittel zurück, das alle Layoutblöcke konturiert. Hat das Argument forWhat den Wert "selectedDiv", gibt die Funktion die verwendete Eigenschaften für das visuelle Hilfsmittel zurück, das ausgewählte Layoutblöcke konturiert. Der Wert layers beschreibt Ebenen.

RückgabewerteEin String-Array mit drei Strings:

• color, der hexadezimale Wert der RGB-Farbe in der Form #RRGGBB.

• width, die Breite in Pixel.

• style mit dem Wert "SOLID", "DOTTED", "DASHED" oder "OUTSET".

BeispielIm folgenden Beispiel werden die Kontureneigenschaften für "divs" abgerufen und der Konturenstil "SOLID" zugewiesen:

var outlineStyle = dw.getBlockVisOutlineProperties("divs");

if (outlineStyle[2] != "SOLID"){

dw.setBlockVisOutlineProperties("divs", outlineStyle[0], outlineStyle[1], "SOLID");

}

dreamweaver.getDivBackgroundColors()


BeschreibungDiese Funktion ruft die vom visuellen Hilfsmittel Layoutblock-Hintergründe verwendeten Farben ab.

ArgumenteKeine

RückgabewerteEin String-Array mit den 16 Farben, wobei jede Farbe den Hexadezimalwert der RGB-Farbe in der Form #RRGGBB reprä-sentiert.


335

BeispielIm folgenden Beispiel werden die vom visuellen Hilfsmittel Layoutblock-Hintergründe verwendeten Farben abgerufen:

var backgroundColors = dreamweaver.getDivBackgroundColors();

dreamweaver.setBlockVisOutlineProperties()


BeschreibungDiese Funktion setzt die Kontureneigenschaften für die visuellen Hilfsmittel zur Blockvisualisierung.

ArgumenteforWhat, color, width, {style}

• Das obligatorische Argument forWhat ist ein String, der angibt, wofür die angegebene Farbe und Breite verwendet werden. Mögliche Werte sind "divs", "selectedDiv" oder "layers". Ist der Wert "layers", werden die angegebene Farbe und Breite zum Konturieren aller Ebenen verwendet, wenn das visuelle Hilfsmittel Layoutblock-Konturen aktiviert ist. Ist der Wert "divs", werden die Argumente color und width verwendet, um alle div-Blöcke und anderen Layoutblöcke zu konturieren. Ist der Wert "selectedDiv", werden die Argumente color und width verwendet, um einen beliebigen ausgewählten div- oder Layoutblock zu konturieren.

• Das obligatorische Argument color ist ein String mit einem Hexadezimalwert, der die RGB-Farbe in der Form #RRGGBB beschreibt.

• Das obligatorische Argument width ist eine Ganzzahl, die die Stärke der Kontur in Pixel beschreibt.

• Das optionale Argument style ist ein String, der den Stil der Kontur beschreibt. Mögliche Werte sind "SOLID", "DOTTED", "DASHED" und "OUTSET". Der Wert "OUTSET" ist nur auf Ebenen anwendbar. Dieses Argument wird ignoriert, wenn das Argument forWhat den Wert "selectedDiv" besitzt.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dreamweaver.getBlockVisOutlineProperties()“ auf Seite 334.

dreamweaver.setDivBackgroundColors()


BeschreibungDiese Funktion setzt die vom visuellen Hilfsmittel Layoutblock-Hintergründe verwendeten Farben.

ArgumenteFarben

• Das obligatorische Argument colors ist ein String-Array mit allen Farben in ihrem Hexadezimalwert, und zwar in der Form #RRGGBB. Der Array muss 16 Farben enthalten.

RückgabewerteKeine

BeispielDas folgende Beispiel stellt sicher, dass nicht mehr als 16 Farben als div-Hintergrundfarben angegeben wurden. Ist das der Fall, werden die als Hintergrundfarben verwendeten Farben auf Graustufen gesetzt.


336


var divColors = currentDOM.getDivBackgroundColors("divs");

var shadesOfGray = new Array["#000000", "#111111", "#222222", "#333333",¬

"#444444", "#555555", "#666666", "#777777", "#888888", "#999999", ¬

"#AAAAAA", "#BBBBBB", "#CCCCCC", "#DDDDDD", "#EEEEEE", "#FFFFFF"]¬

var howManyColors = divColors.length;

if howManyColors <= 16{

for (var i = 0; i < howManyColors; i++)

{

currentDOM.setDivBackgroundColors("divs", shadeOfGray[i]);

}

Frame- und Frameset-FunktionenMit Frame- und Frameset-Funktionen werden folgende Aufgaben ausgeführt: Die Namen der Frames in einem Frameset können abgerufen werden, und Frames können geteilt werden.

dom.getFrameNames()


BeschreibungRuft eine Liste aller benannten Frames im Frameset ab.

ArgumenteKeine

RückgabewerteEin String-Array, in dem jeder String der Name eines Frames im aktuellen Frameset ist. Unbenannte Frames werden übergangen. Wenn keiner der Frames im Frameset benannt ist, wird ein leeres Array zurückgegeben.

BeispielFür ein Dokument mit vier Frames (von denen zwei benannt sind) wird bei Aufruf der Funktion dom.getFrameNames() beispielsweise ein Array mit den folgenden Strings zurückgegeben:

• "navframe"

• "main_content"

dom.isDocumentInFrame()


BeschreibungGibt an, ob das aktuelle Dokument innerhalb eines Framesets angezeigt wird.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Dokument sich in einem Frameset befindet, andernfalls false.


337

dom.saveAllFrames()


BeschreibungWenn ein Dokument ein Frameset ist oder sich in einem Frameset befindet, werden mit dieser Funktion alle Frames und Framesets aus dem Dokumentfenster gespeichert. Befindet sich das angegebene Dokument nicht in einem Frameset, wird mit dieser Funktion das Dokument gespeichert. Für Dokumente, die noch nicht gespeichert wurden, wird das Dialogfeld Speichern unter geöffnet.

ArgumenteKeine

RückgabewerteKeine

dom.splitFrame()


BeschreibungTeilt den ausgewählten Frame vertikal bzw. horizontal.

ArgumentesplitDirection

• Das Argument splitDirection ist ein String, der einem der folgenden Richtungsparameter entsprechen muss: "up", "down", "left" oder "right".

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canSplitFrame()“ auf Seite 423.

Ebenen- und Imagemap-Funktionen Mit Ebenen- und Imagemap-Funktionen lassen sich Ebenen und Imagemap-Hotspots ausrichten und in der Größe ändern und verschieben. In den Beschreibungen wird darauf hingewiesen, ob sich die jeweilige Funktion auf Ebenen oder auf Hotspots bezieht.

dom.align()


BeschreibungRichtet die ausgewählten Ebenen oder Hotspots links, rechts, oben oder unten aus.

ArgumentealignDirection


338

• Das Argument alignDirection ist ein String, der den Rand angibt, nach dem die Ebenen oder Hotspots ausgerichtet werden sollen ("left", "right", "top" oder "bottom").

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canAlign()“ auf Seite 415.

dom.arrange()


BeschreibungVerschiebt die betreffenden Hotspots in die angegebene Richtung.

ArgumentetoBackOrFront

• Mit dem Argument toBackOrFront wird die Richtung ausgedrückt, in die die Hotspots verschoben werden, nach vorne oder nach hinten.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canArrange()“ auf Seite 415.

dom.makeSizesEqual()


BeschreibungGleicht die ausgewählten Ebenen oder Hotspots in der Höhe oder/und in der Breite an. Für die Größe ist die zuletzt ausge-wählte Ebene oder der zuletzt ausgewählte Hotspot maßgeblich.

ArgumentebHoriz, bVert

• Das Argument bHoriz ist ein Boolescher Wert, der angibt, ob die Größe der Ebenen oder Hotspots in horizontaler Richtung geändert werden soll.

• Das Argument bVert ist ein Boolescher Wert, der angibt, ob die Größe der Ebenen oder Hotspots in vertikaler Richtung geändert werden soll.

RückgabewerteKeine

dom.moveSelectionBy()



339

BeschreibungVerschiebt die ausgewählten Ebenen bzw. Hotspots horizontal und vertikal um die angegebene Pixelanzahl.

Argumentex, y

• Das Argument x gibt an, um wie viele Pixel die Auswahl horizontal verschoben werden soll.

• Das Argument y gibt an, um wie viele Pixel die Auswahl vertikal verschoben werden soll.

RückgabewerteKeine

dom.resizeSelectionBy()


BeschreibungÄndert die Größe der aktuell ausgewählten Ebene bzw. des aktuell ausgewählten Hotspots.

Argumenteleft, top, bottom, right

• Das Argument left ist die neue Position der linken Ebenen- oder Hotspot-Begrenzung.

• Das Argument top ist die neue Position der oberen Ebenen- oder Hotspot-Begrenzung.

• Das Argument bottom ist die neue Position der unteren Ebenen- oder Hotspot-Begrenzung.

• Das Argument right ist die neue Position der rechten Ebenen- oder Hotspot-Begrenzung.

RückgabewerteKeine

BeispielWenn die ausgewählte Ebene die abgebildeten Abmessungen aufweist, werden beim Aufruf von dw.getDocu-mentDOM().resizeSelectionBy(–10,–30,30,10) die Positionseigenschaften Links auf 40, Oben auf 20, Breite auf 230 und Höhe auf 210 geändert.

dom.setLayerTag()


BeschreibungBestimmt das HTML-Tag, mit dem die ausgewählten Ebenen definiert werden.

ArgumentetagName

• Das Argument tagName muss "layer", "ilayer", "div" oder "span" lauten.

RückgabewerteKeine


340

Funktionen für die Layout-UmgebungDiese Funktionen beziehen sich auf die Einstellungen, die bei der Arbeit mit Dokumenten gelten. Quelle, Position und Transparenz des Tracing-Bilds lassen sich einstellen, die Anzeige des Rasters kann beeinflusst werden, und die Wiedergabe von Plug-Ins kann gestartet und gestoppt werden.

dom.getRulerOrigin()


BeschreibungRuft den Ursprung des Lineals ab.

ArgumenteKeine

RückgabewerteEin Array mit zwei Ganzzahlen. Der erste Wert enthält die x-Koordinate des Ursprungs, der zweite die y-Koordinate. Beide Werte sind in Pixel angegeben.

dom.getRulerUnits()


BeschreibungRuft die aktuellen Linealeinheiten ab.

ArgumenteKeine

RückgabewerteEin String, der einen der folgenden Werte enthält:

• "in"

• "cm"

• "px"

dom.getTracingImageOpacity()


BeschreibungRuft die Transparenzeinstellung für das Tracing-Bild des Dokuments ab.

ArgumenteKeine

RückgabewerteEin Wert zwischen 0 und 100 bzw. kein Rückgabewert, wenn keine Transparenz eingestellt ist.


341

Enabler Weitere Informationen finden Sie unter „dom.hasTracingImage()“ auf Seite 424.

dom.loadTracingImage()


BeschreibungÖffnet das Dialogfeld Bildquelle auswählen. Wenn der Benutzer ein Bild auswählt und auf OK klickt, wird das Dialogfeld Seiteneigenschaften mit dem Tracing-Bild angezeigt.

ArgumenteKeine

RückgabewerteKeine

dom.playAllPlugins()


BeschreibungGibt sämtliche Plug-In-Inhalte des Dokuments wieder.

ArgumenteKeine

RückgabewerteKeine

dom.playPlugin()


BeschreibungGibt den ausgewählten Plug-In-Inhalt wieder.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canPlayPlugin()“ auf Seite 421.

dom.setRulerOrigin()



342

BeschreibungStellt den Ursprung des Lineals ein.

ArgumentexCoordinate, yCoordinate

• Das Argument xCoordinate ist ein Wert in Pixel auf der horizontalen Achse.

• Das Argument yCoordinate ist ein Wert in Pixel auf der vertikalen Achse.

RückgabewerteKeine

dom.setRulerUnits()


BeschreibungStellt die aktuellen Linealeinheiten ein.

Argumenteunits

• Das Argument units muss "px", "in" oder "cm" lauten.

RückgabewerteKeine

dom.setTracingImagePosition()


BeschreibungVerschiebt die obere linke Ecke des Tracing-Bilds an die angegebene Position. Wenn keine Argumente angegeben werden, wird das Dialogfeld Position des Tracing-Bilds einstellen angezeigt.

Argumentex, y

• Das Argument x gibt die Anzahl der Pixel an, die die horizontale Koordinate angeben.

• Das Argument x gibt die Anzahl der Pixel an, die die vertikale Koordinate angeben.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.hasTracingImage()“ auf Seite 424.

dom.setTracingImageOpacity()


BeschreibungStellt die Transparenz des Tracing-Bilds ein.


343

ArgumenteopacityPercentage

• Das Argument opacityPercentage muss ein Wert zwischen 0 und 100 sein.

RückgabewerteKeine


BeispielMit dem folgenden Code wird die Transparenz des Tracing-Bilds auf 30 % gesetzt:

dw.getDocumentDOM().setTracingOpacity('30');

dom.snapTracingImageToSelection()


BeschreibungRichtet die obere linke Ecke des Tracing-Bilds an der oberen linken Ecke der aktuellen Auswahl aus.

ArgumenteKeine

RückgabewerteKeine


dom.stopAllPlugins()


BeschreibungStoppt die Wiedergabe von sämtlichen im Dokument enthaltenen Plug-In-Inhalten.

ArgumenteKeine

RückgabewerteKeine

dom.stopPlugin()


BeschreibungStoppt die Wiedergabe des ausgewählten Plug-In-Inhalts.


344

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob die Auswahl derzeit mit einem Plug-In wiedergegeben wird.

EnablerWeitere Informationen finden Sie unter „dom.canStopPlugin()“ auf Seite 423.

dreamweaver.arrangeFloatingPalettes()


BeschreibungVerschiebt die sichtbaren schwebenden Bedienfelder an ihre Standardpositionen.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.showGridSettingsDialog()


BeschreibungÖffnet das Dialogfeld Rastereinstellungen.

ArgumenteKeine

RückgabewerteKeine

Layoutansicht-FunktionenDiese Funktionen beziehen sich auf Vorgänge, mit denen die Layoutelemente in einem Dokument geändert werden. Sie steuern Einstellungen für Tabellen, Spalten und Zellen, einschließlich Position, Eigenschaften und Darstellung.

dom.addSpacerToColumn()


BeschreibungErstellt ein transparentes Platzhalterbild mit einer Höhe von einem Pixel am unteren Ende einer bestimmten Spalte in der derzeit ausgewählten Tabelle. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt oder wenn der Vorgang nicht erfolgreich ist, schlägt diese Funktion fehl.


345

ArgumentecolNum

• Das Argument colNum ist die Spalte, an deren unterem Ende das Platzhalterbild erstellt wird.

RückgabewerteKeine

dom.createLayoutCell()


BeschreibungErstellt an der angegebenen Position im aktuellen Dokument eine Layoutzelle mit den festgelegten Abmessungen. Die Zelle wird entweder innerhalb einer vorhandenen Layouttabelle oder unterhalb des vorhandenen Inhalts auf der Seite erstellt. Wenn die Zelle in einer vorhandenen Layouttabelle erstellt wird, darf sie keine anderen Layoutzellen oder verschachtelte Layouttabellen überlappen oder enthalten. Befindet sich das Rechteck nicht innerhalb einer vorhandenen Layouttabelle, versucht Dreamweaver, eine Layouttabelle für die neue Zelle zu erstellen. Durch diese Funktion wird das Dokument nicht in die Layoutansicht gebracht. Wenn die Zelle nicht erstellt werden kann, schlägt die Funktion fehl.

Argumenteleft, top, width, height

• left ist die x-Position des linken Zellrahmens.

• top ist die y-Position des oberen Zellrahmens.

• width ist die Breite der Zelle in Pixel.

• height ist die Höhe der Zelle in Pixel.

RückgabewerteKeine

dom.createLayoutTable()


BeschreibungErstellt an der angegebenen Position im aktuellen Dokument eine Layouttabelle mit den festgelegten Abmessungen. Die Tabelle wird entweder innerhalb einer vorhandenen Tabelle oder unterhalb des vorhandenen Inhalts auf der Seite erstellt. Wenn die Tabelle in einer vorhandenen Layouttabelle erstellt wird, darf sie keine anderen Layoutzellen oder verschachtelte Layouttabellen überlappen. Sie kann jedoch andere Layoutzellen oder verschachtelte Layouttabellen enthalten. Durch diese Funktion wird das Dokument nicht in die Layoutansicht gebracht. Wenn die Tabelle nicht erstellt werden kann, schlägt die Funktion fehl.

Argumenteleft, top, width, height

• left ist die x-Position des linken Tabellenrahmens.

• top ist die y-Position des oberen Tabellenrahmens.

• width ist die Breite der Tabelle in Pixel.

• height ist die Höhe der Tabelle in Pixel.

RückgabewerteKeine


346

dom.doesColumnHaveSpacer()


BeschreibungBestimmt, ob eine Spalte ein von Dreamweaver erstelltes Platzhalterbild enthält. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt, schlägt diese Funktion fehl.

ArgumentecolNum

• Das Argument colNum ist die Spalte, die auf ein Platzhalterbild überprüft wird.

Rückgabewertetrue, wenn die angegebene Spalte in der derzeit ausgewählten Tabelle ein von Dreamweaver erstelltes Platzhalterbild enthält; andernfalls false.

dom.doesGroupHaveSpacers()


BeschreibungBestimmt, ob die derzeit ausgewählte Tabelle eine Zeile mit von Dreamweaver erstellten Platzhalterbildern enthält. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt, schlägt diese Funktion fehl.

ArgumenteKeine

Rückgabewertetrue, wenn die Tabelle eine Zeile mit Platzhalterbildern enthält; andernfalls false.

dom.getClickedHeaderColumn()


BeschreibungWenn der Benutzer in der Kopfzeile einer Tabelle in der Layoutansicht auf eine Menüschaltfläche geklickt und dadurch das Kopfzeilenmenü der Tabelle aufgerufen hat, gibt diese Funktion den Index der Spalte zurück, auf die der Benutzer geklickt hat. Wenn das Kopfzeilenmenü der Tabelle nicht sichtbar ist, ist das Ergebnis undefiniert.

ArgumenteKeine

RückgabewerteEine Ganzzahl, die den Index der Spalte darstellt.

dom.getShowLayoutTableTabs()



347

BeschreibungBestimmt, ob das aktuelle Dokument in der Layoutansicht Registerkarten für Layouttabellen enthält.

ArgumenteKeine

Rückgabewertetrue, wenn das aktuelle Dokument in der Layoutansicht Registerkarten für Layouttabellen enthält; andernfalls false .

dom.getShowLayoutView()


BeschreibungBestimmt die Ansicht des aktuellen Dokuments, und zwar entweder die Layoutansicht oder die Standardansicht.

ArgumenteKeine

Rückgabewertetrue, wenn das aktuelle Dokument sich in der Layoutansicht befindet; false, wenn das Dokument sich in der Standardan-sicht befindet.

dom.isColumnAutostretch()


BeschreibungBestimmt, ob eine Spalte je nach Dokumentgröße automatisch vergrößert oder verkleinert werden soll. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt, schlägt diese Funktion fehl.

ArgumentecolNum

• Das Argument colNum ist die Spalte, die automatisch vergrößert bzw. verkleinert oder auf eine feste Breite eingestellt werden soll.

RückgabewerteGibt true wenn die Spalte am angegebenen Index in der derzeit ausgewählten Tabelle auf Automatisch strecken eingestellt ist; andernfalls false.

dom.makeCellWidthsConsistent()


BeschreibungDiese Funktion stellt die Breite der einzelnen Spalten in der derzeit ausgewählten Tabelle im HTML-Code so ein, dass sie der aktuell dargestellten Breite der Spalte entspricht. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt oder wenn der Vorgang nicht erfolgreich ist, schlägt diese Funktion fehl.

ArgumenteKeine


348

RückgabewerteKeine

dom.removeAllSpacers()


BeschreibungEntfernt alle von Dreamweaver erstellten Platzhalterbilder aus der derzeit ausgewählten Tabelle. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt oder wenn der Vorgang nicht erfolgreich ist, schlägt diese Funktion fehl.

ArgumenteKeine

RückgabewerteKeine

dom.removeSpacerFromColumn()


BeschreibungEntfernt das Platzhalterbild aus der angegebenen Spalte und löscht die Platzhalterzeile, wenn keine weiteren von Dream-weaver erstellten Platzhalterbilder mehr vorhanden sind. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt oder wenn der Vorgang nicht erfolgreich ist, schlägt diese Funktion fehl.

ArgumentecolNum

• Das Argument colNum ist die Spalte, aus der das Platzhalterbild entfernt werden soll.

RückgabewerteKeine

dom.setColumnAutostretch()


BeschreibungBewirkt, dass eine Spalte zwischen automatischer Größe und fester Breite wechselt. Wenn bAutostretch den Wert true hat, gilt für die Spalte am angegebenen Index in der derzeit ausgewählten Tabelle die Option Automatisch strecken; andernfalls ist die Spalte auf eine feste Breite entsprechend der aktuell dargestellten Breite eingestellt. Wenn es sich bei der aktuellen Auswahl nicht um eine Tabelle handelt oder wenn der Vorgang nicht erfolgreich war, schlägt diese Funktion fehl.

ArgumentecolNum, bAutostretch

• Das Argument colNum ist die Spalte, die automatisch vergrößert bzw. verkleinert oder auf eine feste Breite eingestellt werden soll.

• bAutostretch gibt an, ob für die Spalte das automatische Strecken gilt (true) oder ob sie eine feste Breite hat (false).


349

RückgabewerteKeine

dom.getShowBlockBackgrounds()


BeschreibungDiese Funktion ruft den Status des visuellen Hilfsmittels ab, das Hintergrundfarben für alle Blöcke oder div-Abschnitte erzwingt.

Argumenteallblocks

• Das obligatorische Argument allblocks ist ein Boolescher Wert. Setzen Sie seinen Wert auf true, wenn die Funktion nur auf div-Tags angewendet werden soll. Setzen Sie seinen Wert auf false, wenn die Funktion auf alle Blockelemente angewendet werden soll.

RückgabewerteEin Boolescher Wert: Wenn true, werden Hintergründe erzwungen, wenn false, werden keine Hintergründe erzwungen.

BeispielIm folgenden Beispiel wird zunächst geprüft, ob Hintergrundfarben für alle Blöcke erzwungen werden. Ist dies nicht der Fall, werden Hintergrundfarben für alle Blöcke erzwungen.


if (currentDOM.getShowBlockBackgrounds(false) == false){

currentDOM.setShowBlockBackgrounds(false);

}

dom.getShowBlockBorders()


BeschreibungDiese Funktion ruft den Status des visuellen Hilfsmittels ab, das Rahmen für alle Blöcke oder div-Abschnitte zeichnet.

Argumenteallblocks


RückgabewerteEin Boolescher Wert: wenn true, werden Rahmen angezeigt, wenn false, werden keine Rahmen angezeigt.

BeispielIm folgenden Beispiel wird überprüft, ob das visuelle Hilfsmittel Blockrahmens aktiviert ist. Ist das nicht der Fall, wird es aktiviert.


if (currentDOM.getShowBlockBorders(false) == false){

currentDOM.setShowBlockBorders(true);

}


350

dom.getShowBlockIDs()


BeschreibungDiese Funktion ruft den Status des visuellen Hilfsmittels ab, das ID und Klasseninformationen für alle Blöcke oder div-Abschnitte anzeigt.

Argumenteallblocks


RückgabewerteEin Boolescher Wert: Wenn true, werden IDs angezeigt, wenn false, werden IDs nicht angezeigt.

BeispielIm folgenden Beispiel wird geprüft, ob die Block-IDs angezeigt werden. Falls nicht werden sie angezeigt:


if (currentDOM.getShowBlockIDs(false) == false){

currentDOM.setShowBlockIDs(true);

}

dom.getShowBoxModel()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert das visuelle Hilfsmittel, das das vollständige Box-Modell des ausgewählten Blocks farblich darstellt.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird geprüft, ob das vollständige Box-Modell des ausgewählten Blocks in Farbe angezeigt wird. Ist dies nicht der Fall, wird es in Farbe angezeigt.


if (currentDOM.getShowBoxModel() == false){

currentDOM.setShowBoxModel(true);

}

dom.setShowBlockBackgrounds()



351

BeschreibungDiese Funktion aktiviert bzw. deaktiviert das visuelle Hilfsmittels, das Hintergrundfarben für alle Blöcke oder div-Abschnitte erzwingt.

Argumenteallblocks

• Das obligatorische Argument allblocks ist ein Boolescher Wert. Setzen Sie seinen Wert auf true, wenn die Funktion nur auf div-Tags angewendet werden soll. Setzen Sie seinen Wert auf false, wenn die Hintergrundfarbe auf alle Blockele-mente angewendet werden soll.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dom.getShowBlockBackgrounds()“ auf Seite 349.

dom.setShowBlockBorders()


BeschreibungDiese Funktion ruft den Status des visuellen Hilfsmittels ab, das Rahmen für alle Blöcke oder div-Abschnitte zeichnet.

Argumenteallblocks

• Das obligatorische Argument allblocks ist ein Boolescher Wert. Setzen Sie seinen Wert auf true, wenn Rahmen nur auf div-Tags angewendet werden soll. Setzen Sie seinen Wert auf false, wenn die Funktion auf alle Blockelemente angewendet werden soll.

RückgabewerteKeine

BeispielWeitere Informationen finden Sie unter „dom.getShowBlockBorders()“ auf Seite 349.

dom.setShowBlockIDs()


BeschreibungDiese Funktion aktiviert bzw. deaktiviert das visuelle Hilfsmittel, das die ID und Klasse für alle Blöcke oder div-Abschnitte anzeigt.

Argumenteallblocks


RückgabewerteKeine


352

BeispielWeitere Informationen finden Sie unter „dom.getShowBlockIDs()“ auf Seite 350.

dom.setShowBoxModel()


BeschreibungDiese Funktion setzt den Status des visuellen Hilfsmittels, das das vollständige Box-Modell des ausgewählten Blocks farblich darstellt.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true wenn das Box-Modell angezeigt wird, false, wenn es nicht angezeigt wird.

BeispielWeitere Informationen finden Sie unter „dom.getShowBoxModel()“ auf Seite 350.

dom.setShowLayoutTableTabs()


BeschreibungLegt fest, dass im aktuellen Dokument Registerkarten für Layouttabellen angezeigt werden, wenn das Dokument sich in der Layoutansicht befindet. Durch diese Funktion wird das Dokument nicht in die Layoutansicht gebracht.

ArgumentebShow

• Das Argument bShow gibt an, ob Registerkarten für Layouttabellen angezeigt werden sollen, wenn das aktuelle Dokument sich in der Layoutansicht befindet. Wenn für bShow der Wert true gilt, zeigt Dreamweaver Registerkarten an, gilt für bShow false, werden keine Registerkarten angezeigt.

RückgabewerteKeine

dom.setShowLayoutView()


BeschreibungBringt das aktuelle Dokument in die Layoutansicht, wenn bShow den Wert true hat.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert, der für das aktuelle Dokument zwischen der Layoutansicht und der Standardansicht wechselt. Wenn für bShow true gilt, wird das aktuelle Dokument in der Layoutansicht angezeigt, lautet bShow false, wird es in der Standardansicht angezeigt.


353

RückgabewerteKeine

VergrößerungsfunktionenMithilfe der Vergrößerungsfunktionen können Sie in der Entwurfsansicht die Ansicht vergrößern oder verkleinern.

dreamweaver.activeViewScale()


BeschreibungDiese Funktion kann eine veränderliche Gleitkommazahl abrufen oder setzen. Wenn Sie den Wert abrufen, gibt Dream-weaver den Vergrößerungsfaktor der aktiven Ansicht zurück wie sie im Vergrößerungskombinationsfeld erscheint, geteilt durch 100. 100 % beispielsweise entspricht 1,0; 50 % entspricht 0,5 usw. Wenn Sie umgekehrt den Wert setzen, setzt Dream-weaver den Wert im Vergrößerungskombinationsfeld. Zulässig sind Werte zwischen 0,06 und 64,00, das entspricht einem Vergrößerungsfaktor zwischen 6 % und 6400 %.

BeispielIm folgenden Beispiel wird der Vergrößerungsfaktor der aktiven Ansicht abgerufen und, wenn möglich, verkleinert, wenn der Vergrößerungsfaktor kleiner oder gleich 100 % ist:

if (canZoom() && dreamweaver.activeViewScale <= 1.0) {

zoomIn();

}

Im folgenden Beispiel wird der Vergrößerungsfaktor der aktiven Ansicht auf 50 % gesetzt:

dreamweaver.activeViewScale = 0.50;

dreamweaver.fitAll()


BeschreibungDiese Funktion vergrößert bzw. verkleinert die Anzeige so, dass das gesamte Dokument in die momentane Größe des Entwurfsfensters passt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canZoom()“ auf Seite 431.

Beispielif (canZoom()){

fitAll();

}


354

dreamweaver.fitSelection()


BeschreibungDiese Funktion vergrößert bzw. verkleinert die Anzeige so, dass das die aktuelle Auswahl in die momentane Größe des Entwurfsfensters passt.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canFitSelection()“ auf Seite 427.

Beispielif (canFitSeletion()){

fitSelection();

}

dreamweaver.fitWidth()


BeschreibungDiese Funktion vergrößert bzw. verkleinert die Anzeige so, dass das Dokument in seiner gesamten Breite in die momentane Größe des Entwurfsfensters passt.

ArgumenteKeine

RückgabewerteKeine



fitWidth();

}

dreamweaver.zoomIn()


BeschreibungDiese Funktion vergrößert die gerade aktive Entwurfsansicht. Als Vergrößerungsstufe wird der nächste voreingestellte Wert im Menü Vergrößerung verwendet. Gibt es keinen nächsten voreingestellten Wert, so hat diese Funktion keine Auswirkung.


355

ArgumenteKeine

RückgabewerteKeine



zoomIn();

}

dreamweaver.zoomOut()


BeschreibungDiese Funktion verkleinert die gerade aktive Entwurfsansicht. Als Vergrößerungsstufe wird der nächste voreingestellte Wert im Menü Vergrößerung verwendet. Gibt es keinen nächsten voreingestellten Wert, so hat diese Funktion keine Auswirkung.

ArgumenteKeine

RückgabewerteKeine



zoomOut();

}

Funktionen und Eigenschaften für HilfslinienMit den Funktionen und Eigenschaften für Hilfslinien lassen sich Hilfslinien anzeigen, bearbeiten und löschen, die den Benutzern ein Ausmessen und Anordnen der Elemente auf ihren HTML-Seiten erlauben.

dom.clearGuides()


BeschreibungDiese Funktion bestimmt, ob alle Hilfslinien im Dokument gelöscht werden sollen.

ArgumenteKeine


356

RückgabewerteKeine

BeispielIm folgenden Beispiel werden alle Hilfslinien im Dokument gelöscht, wenn das Dokument mindestens eine Hilfslinie besitzt:


if (currentDOM.hasGuides() == true) {

currentDOM.clearGuides();

}

dom.createHorizontalGuide()


BeschreibungDiese Funktion erstellt an der aktuellen Position im Dokument eine horizontale Hilfslinie.

Argumentelocation

• Das Argument location beschreibt die Position der Hilfslinie, wobei sowohl der Wert als auch die Einheit in einem String angegeben werden, und zwar ohne Leerzeichen zwischen Wert und Einheit. Zulässige Einheiten sind "px" für Pixel und "%" für Prozent. Für 10 Pixel geben Sie beispielsweise location = "10px" an und für 50 Prozent location = "50%".

RückgabewerteKeine

BeispielIm folgenden Beispiel wird an der aktuellen Position im Dokument eine horizontale Hilfslinie erstellt.


currentDOM.createHorizontalGuide("10px");

dom.createVerticalGuide()


BeschreibungDiese Funktion erstellt an der aktuellen Position im Dokument eine vertikale Hilfslinie.

Argumentelocation

• Das Argument location beschreibt die Position der Hilfslinie, wobei sowohl der Wert als auch die Einheit in einem String angegeben werden, und zwar ohne Leerzeichen zwischen Wert und Einheit. Zulässige Einheiten sind "px" für Pixel und "%" für Prozent. Für 10 Pixel geben Sie beispielsweise location = "10px" an und für 50 Prozent location = "50%".

RückgabewerteKeine


357

BeispielIm folgenden Beispiel wird an der aktuellen Position im Dokument eine vertikale Hilfslinie erstellt.


currentDOM.createVerticalGuide("10px");

dom.deleteHorizontalGuide()


BeschreibungDiese Funktion löscht die horizontale Hilfslinie an der angegebenen Position.

Argumentelocation

• Das Argument location ist ein String, der die Position im zu prüfenden Dokument angibt, wobei sowohl der Wert als auch die Einheit in einem String angegeben werden, und zwar ohne Leerzeichen zwischen Wert und Einheit. Zulässige Einheiten sind "px" für Pixel und "%" für Prozent. Für 10 Pixel geben Sie beispielsweise location = "10px" an und für 50 Prozent location = "50%".

RückgabewerteKeine

BeispielDas folgende Beispiel löscht die horizontale Hilfslinie an der angegebenen Position im Dokument:


if (currentDOM.hasHorizontalGuide("10px") == true) {

currentDOM.deleteHorizonalGuide("10px");

}

dom.deleteVerticalGuide()


BeschreibungDiese Funktion löscht die vertikale Hilfslinie an der angegebenen Position.

Argumentelocation


RückgabewerteKeine

BeispielDas folgende Beispiel löscht die vertikale Hilfslinie an der angegebenen Position im Dokument:


if (currentDOM.hasVerticalGuide("10px") == true) {

currentDOM.deleteVerticalGuide("10px");

}


358

dom.guidesColor


BeschreibungDiese veränderliche Farbeigenschaft bestimmt die Farbe der Hilfslinien im Dokument. Sie können diese Eigenschaft setzen und abrufen.

ArgumenteKeine

RückgabewerteKeine

BeispielDas folgende Beispiel färbt die Hilfslinien Grau.


if (currentDOM.guidesColor != "#444444"){

currentDOM.guidesColor = "#444444";

}

dom.guidesDistanceColor


BeschreibungDiese veränderliche Farbeigenschaft bestimmt die Farbe der Hilfslinien für die Abstandsanzeige. Sie können diese Eigen-schaft setzen und abrufen.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel erhalten die Hilfslinien für die Abstandsanzeigen die Farbe Grau:


if (currentDOM.guidesDistanceColor != "#CCCCCC"){

currentDOM.guidesDistanceColor = "#CCCCCC";

}

dom.guidesLocked


BeschreibungDiese veränderliche Boolesche Eigenschaft bestimmt, ob die Hilfslinien im Dokument gesperrt werden. Sie können diese Eigenschaft setzen und abrufen.

ArgumenteKeine


359

RückgabewerteKeine

BeispielDas folgende Beispiel sperrt Hilfslinien, wenn sie nicht gesperrt sind:


if (currentDOM.guidesLocked == false) {

currentDOM.guidesLocked = true;

}

dom.guidesSnapToElements


BeschreibungDiese veränderliche Boolesche Eigenschaft bestimmt, ob die Hilfslinien im Dokument an Elementen ausgerichtet werden. Sie können diese Eigenschaft setzen und abrufen.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel werden die Hilfslinien im Dokument an Elementen ausgerichtet:


if (currentDOM.guidesSnapToElements == false) {

currentDOM.guidesSnapToElements = true;

}

dom.guidesVisible


BeschreibungDiese veränderliche Boolesche Eigenschaft bestimmt, ob die Hilfslinien im Dokument sichtbar sind. Sie können diese Eigenschaft setzen und abrufen.

ArgumenteKeine

RückgabewerteKeine

BeispielDas folgende Beispiel aktiviert die Anzeige von Hilfslinien, wenn sie nicht sichtbar sind:

var currentDOM = dw.getDocumentDOM();if (currentDOM.guidesVisible == false) {

currentDOM.guidesVisible = true;}


360

dom.hasGuides()


BeschreibungDiese Funktion bestimmt, ob ein Dokument mindestens eine Hilfslinie besitzt. Sie können diese Eigenschaft setzen und abrufen.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel werden alle Hilfslinien im Dokument gelöscht, wenn das Dokument mindestens eine Hilfslinie besitzt:


if (currentDOM.hasGuides() == true) {


}

dom.hasHorizontalGuide()


BeschreibungDiese Funktion bestimmt, ob das Dokument an der angegebenen Position eine horizontale Hilfslinie besitzt.

Argumentelocation


RückgabewerteEin Boolescher Wert: true, wenn sich an der Position eine horizontale Hilfslinie befindet, andernfalls false.

BeispielIm folgenden Beispiel werden alle Hilfslinien im Dokument gelöscht, wenn das Dokument an der angegebenen Position eine horizontale Hilfslinie besitzt:


if (currentDOM.hasHorizontalGuide("10px") == true) {


}


361

dom.hasVerticalGuide()


BeschreibungDiese Funktion bestimmt, ob das Dokument an der aktuellen Position eine vertikale Hilfslinie besitzt.

Argumentelocation


RückgabewerteEin Boolescher Wert: true, wenn sich an der Position eine vertikale Hilfslinie befindet, andernfalls false.

BeispielIm folgenden Beispiel werden alle Hilfslinien im Dokument gelöscht, wenn das Dokument an der angegebenen Position eine vertikale Hilfslinie besitzt:


if (currentDOM.hasVerticalGuide("10px") == true) {


}

dom.snapToGuides


BeschreibungDiese veränderliche Boolesche Eigenschaft bestimmt, ob Elemente an den Hilfslinien im Dokument ausgerichtet werden. Sie können diese Eigenschaft setzen und abrufen.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel werden die Elemente im Dokument an den Hilfslinien ausgerichtet:


if (currentDOM.snapToGuides == false) {

currentDOM.snapToGuides = true;

}


362

TabellenbearbeitungsfunktionenMit Tabellenbearbeitungsfunktionen lassen sich Tabellenzeilen und -spalten hinzufügen und entfernen, Spaltenbreiten und Zeilenhöhen ändern, die Maßangaben von Pixel in Prozent ändern und umgekehrt sowie andere Standardaufgaben für Tabellen durchführen.

dom.convertWidthsToPercent()


BeschreibungDiese Funktion konvertiert alle WIDTH-Attribute in der aktuellen Tabelle von Pixel in Prozent.

ArgumenteKeine

RückgabewerteKeine

dom.convertWidthsToPixels()


BeschreibungDiese Funktion konvertiert alle WIDTH-Attribute in der aktuellen Tabelle von Prozent in Pixel.

ArgumenteKeine

RückgabewerteKeine

dom.decreaseColspan()


BeschreibungDiese Funktion verkleinert den Spaltenraum um 1.

ArgumenteKeine

RückgabewerteKeine

Enabler Weitere Informationen finden Sie unter „dom.canDecreaseColspan()“ auf Seite 417.


363

dom.decreaseRowspan()


BeschreibungDiese Funktion verkleinert den Zeilenraum um 1.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canDecreaseRowspan()“ auf Seite 417.

dom.deleteTableColumn()


BeschreibungDiese Funktion entfernt die ausgewählten Tabellenspalten.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canDeleteTableColumn()“ auf Seite 418.

dom.deleteTableRow()


BeschreibungDiese Funktion entfernt die ausgewählten Tabellenzeilen oder -spalten.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canDeleteTableRow()“ auf Seite 418.


364

dom.doDeferredTableUpdate()


BeschreibungWenn bei den allgemeinen Voreinstellungen die Option Schnellere Tabellenbearbeitung aktiviert ist, werden die zuletzt vorgenommenen Änderungen im Tabellenlayout angezeigt, ohne dass die Auswahl außerhalb der Tabelle bewegt wird. Diese Funktion hat keine Auswirkung, wenn die Option Schnellere Tabellenbearbeitung nicht aktiviert ist.

ArgumenteKeine

RückgabewerteKeine

dom.getShowTableWidths()


BeschreibungGibt an, ob die Tabellenbreite im Standardmodus oder erweiterten Tabellenmodus (Nicht-Layout-Modus) angezeigt wird. Informationen darüber, ob Dreamweaver Tabulatoren im Layoutmodus anzeigt, finden Sie unter „dom.getShowLayoutTableTabs()“ auf Seite 346.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Dreamweaver die Tabellenbreite im Standardmodus oder erweiterten Tabellenmodus anzeigt, andernfalls false.

dom.getTableExtent()


BeschreibungDiese Funktion ruft die Anzahl der Spalten und Zeilen in der ausgewählten Tabelle ab.

ArgumenteKeine

RückgabewerteEin Array mit zwei Ganzzahlen. Das erste Element gibt die Anzahl der Spalten an, das zweite Element die Anzahl der Zeilen. Ist keine Tabelle ausgewählt, wird kein Wert zurückgegeben.


365

dom.increaseColspan()


BeschreibungDiese Funktion vergrößert den Spaltenraum um 1.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canIncreaseColspan()“ auf Seite 419.

dom.increaseRowspan()


BeschreibungDiese Funktion vergrößert den Zeilenraum um 1.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canIncreaseRowspan()“ auf Seite 419.

dom.insertTableColumns()


BeschreibungDiese Funktion fügt die angegebene Anzahl Spalten in die aktuelle Tabelle ein.

ArgumentenumberOfCols, bBeforeSelection

• Das Argument numberOfCols ist die Anzahl der einzufügenden Spalten.

• Das Argument bBeforeSelection ist ein Boolescher Wert: true gibt an, dass die Spalten vor der Spalte eingefügt werden sollen, die die Auswahl enthält, andernfalls false.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canInsertTableColumns()“ auf Seite 419.


366

dom.insertTableRows()


BeschreibungDiese Funktion fügt die angegebene Anzahl Zeilen in die aktuelle Tabelle ein.

ArgumentenumberOfRows, bBeforeSelection

• Das Argument numberOfRows ist die Anzahl der einzufügenden Zeilen.

• Das Argument bBeforeSelection ist ein Boolescher Wert: true gibt an, dass die Zeilen vor der Zeile eingefügt werden sollen, die die Auswahl enthält, andernfalls false.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canInsertTableRows()“ auf Seite 420.

dom.mergeTableCells()


BeschreibungDiese Funktion verbindet die ausgewählten Tabellenzellen.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canMergeTableCells()“ auf Seite 421.

dom.removeAllTableHeights()


BeschreibungDiese Funktion entfernt alle HEIGHT-Attribute aus der ausgewählten Tabelle.

ArgumenteKeine

RückgabewerteKeine


367

dom.removeAllTableWidths()


BeschreibungDiese Funktion entfernt alle WIDTH-Attribute aus der ausgewählten Tabelle.

ArgumenteKeine

RückgabewerteKeine

dom.removeColumnWidth()


BeschreibungDiese Funktion entfernt alle WIDTH-Attribute aus einer einzelnen ausgewählten Spalte.

ArgumenteKeine

RückgabewerteKeine

dom.selectTable()


BeschreibungWählt eine ganze Tabelle aus.

ArgumenteKeine

RückgabewerteKeine

Enabler Weitere Informationen finden Sie unter „dom.canSelectTable()“ auf Seite 422.


368

dom.setShowTableWidths()


BeschreibungSchaltet die Anzeige der Tabellenbreiten im standardmäßigen oder erweiterten Tabellenmodus ein oder aus (Nicht-Layout-modus). Diese Funktion legt den Wert für das aktuelle Dokument und alle weiteren Dokumente fest, sowett nicht anders angegeben. Informationen über die Einstellung der Anzeige von Tabellen-Tabulatoren im Layoutmodus finden Sie unter „dom.setShowLayoutTableTabs()“ auf Seite 352.

ArgumentebShow

• Das Argument bShow ist ein Boolescher Wert, der angibt, ob Tabellenbreiten für Tabellen angezeigt werden sollen, wenn sich das aktuelle Dokument im standardmäßigen oder erweiterten Tabellenmodus befindet Wenn bShow true ist, zeigt Dreamweaver die Breiten an. Wenn bShow false ist, zeigt Dreamweaver die Breiten nicht an.

RückgabewerteKeine

dom.setTableCellTag()


BeschreibungDiese Funktion legt das Tag für die ausgewählte Zelle fest.

ArgumentetdOrTh

• Das Argument tdOrTh muss entweder "td" oder "th" sein.

RückgabewerteKeine

dom.setTableColumns()


BeschreibungDiese Funktion legt die Anzahl der Spalten in der ausgewählten Tabelle fest.

ArgumentenumberOfCols

• Das Argument numberOfCols ist die Anzahl der in der Tabelle festzulegenden Spalten.

RückgabewerteKeine


369

dom.setTableRows()


BeschreibungDiese Funktion legt die Anzahl der Zeilen in der ausgewählten Tabelle fest.

ArgumentenumberOfCols

• Das Argument numberOfRows ist die Anzahl der in der ausgewählten Tabelle festzulegenden Zeilen.

RückgabewerteKeine

dom.showInsertTableRowsOrColumnsDialog()


BeschreibungDiese Funktion öffnet das Dialogfeld Zeilen oder Spalten einfügen.

ArgumenteKeine

RückgabewerteKeine

Enabler„dom.canInsertTableColumns()“ auf Seite 419 oder „dom.canInsertTableRows()“ auf Seite 420.

dom.splitTableCell()


BeschreibungDiese Funktion teilt die aktuelle Tabellenzelle in die angegebene Anzahl Zeilen oder Spalten. Wenn eines oder beide Argumente ausgelassen werden, wird das Dialogfeld Zelle teilen angezeigt.

Argumente{colsOrRows}, {numberToSplitInto}

• Das optionale Argument colsOrRows muss entweder "columns" oder "rows" lauten.

• Das optionale Argument numberToSplitInto ist die Anzahl der Zeilen oder Spalten, in die die Zelle aufgeteilt werden soll.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canSplitTableCell()“ auf Seite 423.


370

371

Kapitel 18: Code

Mithilfe der Codefunktionen können Sie ein Dokument bearbeiten, das in der Codeansicht angezeigt wird. Sie haben die Möglichkeit, neue menu- oder function-Tags zu einem Menü mit Codehinweisen hinzuzufügen, Stringmuster zu suchen und zu ersetzen, die aktuelle Auswahl aus einem Dokument zu löschen, den gesamten oder ausgewählten Code zu löschen, Tags zu bearbeiten oder Syntaxformatierungen zum ausgewählten Code hinzuzufügen.


• „Codefunktionen“ auf Seite 371

• „Suchen- und Ersetzen-Funktionen“ auf Seite 374

• „Allgemeine Bearbeitungsfunktionen“ auf Seite 379

• „Druckfunktion“ auf Seite 393

• „Quick Tag Editor-Funktionen“ auf Seite 394

• „Codeansicht-Funktionen“ auf Seite 395

• „Tag-Editor- und Tag-Bibliothek-Funktionen“ auf Seite 410

CodefunktionenCodehinweise sind Menüs, die Adobe® Dreamweaver® CS3 einblendet, wenn Sie in der Codeansicht bestimmte Zeichen-muster eingeben. Codehinweise ermöglichen eine schnellere Eingabe, indem sie eine Liste der Strings anbieten, die das von Ihnen eingegebene Zeichenmuster vervollständigen. Wird der String, den Sie gerade eingeben möchten, im Menü angezeigt, können Sie diesen aus der Liste auswählen und die Eingabetaste bzw. den Zeilenschalter betätigen, um Ihre Eingabe zu ergänzen. Wenn Sie beispielsweise < eingeben, zeigt das Popupmenü eine Liste mit Tag-Namen an. Anstatt den Rest des Tag-Namens einzugeben, können Sie das Tag im Menü auswählen, um es in den Text einzufügen.

Sie können in Dreamweaver-Menüs Codehinweise hinzufügen, indem Sie sie in der Datei CodeHints.xml definieren. Informationen zur Datei CodeHints.xml finden Sie im Handbuch Dreamweaver erweitern.

Sie können Menüs mit Codehinweisen auch dynamisch über JavaScript hinzufügen, nachdem Dreamweaver den Inhalt der Datei CodeHints.xml geladen hat. JavaScript kann beispielsweise die Liste der Sitzungsvariablen im Bedienfeld Bindungen auffüllen. Mit demselben Code können Sie auch ein Menü mit Codehinweisen hinzufügen. Wenn ein Benutzer in der Codeansicht Session eingibt, zeigt Dreamweaver ein Menü mit Sitzungsvariablen an.

Sowohl die Datei CodeHints.xml als auch die JavaScript-API stellen eine Teilmenge des Codehinweise-Moduls bereit. Die gesamte Dreamweaver-Funktionalität ist darüber jedoch nicht verfügbar. Beispielsweise gibt es keine JavaScript-Funktion zum Einblenden der Farbauswahl. Somit kann Dreamweaver das Menü Attributwerte nicht über JavaScript darstellen. Sie können lediglich ein Menü mit Textelementen einblenden, mit dessen Hilfe Sie Text einfügen können.

Mit der Funktion für Codefarben können Sie Code-Farbstile festlegen sowie vorhandene Codefarben-Schemata bearbeiten oder neue erstellen. Sie können Code-Farbstile und -Schemata durch Bearbeitung der Datei Colors.xml und der Dateien mit den Codefarben-Schemata festlegen. Weitere Informationen zu diesen Dateien finden Sie im Handbuch Dreamweaver erweitern.

Die JavaScript-API für Codehinweise und Farbeinstellungen für Code besteht aus den folgenden Funktionen.

dreamweaver.codeHints.addMenu()



372

BeschreibungDefiniert in der Datei CodeHints.xml dynamisch neue menu-Tags. Ist bereits ein menu-Tag mit identischem Muster und Dokumenttyp vorhanden, fügt diese Funktion dem vorhandenen Menü Elemente hinzu.

ArgumentemenuGroupId, pattern, labelArray, {valueArray}, {iconArray}, {doctypes}, {casesensitive}

• Das Argument menuGroupId ist das ID-Attribut für eines der menugroup-Tags.

• Das Argument pattern ist das Musterattribut für das neue menu-Tag.

• Das Argument labelArray ist ein String-Array. Jeder String enthält den Text für ein einzelnes Menüelement des Popup-menüs.

• Das optionale Argument valueArray ist ein String-Array, das die gleiche Länge wie das Argument labelArray aufweisen muss. Wenn ein Benutzer im Popupmenü ein Element auswählt, wird der String aus diesem Array in das Benutzerdo-kument eingefügt. Sind der einzufügende String und die Menübeschriftung immer identisch, kann dieses Argument entfallen, d. h. den Wert null haben.

• Das optionale Argument iconArray ist entweder ein String oder ein String-Array. Handelt es sich um einen String, gibt dieser die URL für eine einzelne Bilddatei an, die Dreamweaver für alle Elemente im Menü verwendet. Handelt es sich um ein String-Array, muss dieses dieselbe Länge wie das Argument labelArray aufweisen. Jeder String enthält die URL für eine Bilddatei, relativ zum Dreamweaver-Ordner Configuration, die Dreamweaver als Symbol für das entspre-chende Menüelement verwendet. Wenn dieses Argument den Wert null hat, zeigt Dreamweaver das Menü ohne Symbole an.

• Das optionale Argument doctypes gibt an, dass dieses Menü nur für bestimmte Dokumenttypen aktiv ist. Sie können das Argument doctypes als eine durch Kommas getrennte Liste von Dokumenttyp-IDs angeben. Eine Liste der Dokumenttypen von Dreamweaver finden Sie in der Dreamweaver-Datei Configuration\Documenttypes\MMDocu-mentTypes.xml.

• Das optionale Argument casesensitive gibt an, ob bei dem Muster zwischen Groß- und Kleinschreibung unter-schieden werden soll. Die möglichen Werte von casesensitive sind die Booleschen Werte true und false. Bei Auslassung dieses Arguments wird der Wert standardmäßig auf false gesetzt. Wenn das Argument casesensitive den Wert true aufweist, wird das Menü Codehinweise nur dann angezeigt, wenn der vom Benutzer eingegebene Text genau dem vom Musterattribut angegebenen Muster entspricht. Wenn das Argument casesensitive den Wert false aufweist, wird das Menü auch angezeigt, wenn sich die Groß- und Kleinschreibung von Muster und Text unterscheiden.

RückgabewerteKeine

BeispielWenn der Benutzer eine Datensatzgruppe mit dem Namen „myRs“ erstellt, generiert der folgende Code ein Menü für myRS:

dw.codeHints.addMenu(

"CodeHints_object_methods", // Menü ist aktiviert, wenn Objektmethoden aktiviert sind.

"myRS.", // Menü einblenden, wenn Benutzer "myRS" eingibt.

new Array("firstName", "lastName"), // Elemente im Dropdownmenü für myRS

new Array("firstName", "lastName"), // der tatsächlich in das Dokument einzufügende Text

null, // keine Symbole für dieses Menü

"ASP_VB, ASP_JS"); // speziell für ASP-Dokumenttypen

dreamweaver.codeHints.addFunction()


BeschreibungDefiniert dynamisch ein neues function-Tag. Ist bereits ein function-Tag mit identischem Muster und Dokumenttyp vorhanden, ersetzt diese Funktion das vorhandene function-Tag.


373

ArgumentemenuGroupId, pattern, {doctypes}, {casesensitive}

• Das Argument menuGroupId ist das ID-Stringattribut eines menugroup-Tags.

• Das Argument pattern ist ein String, der das Musterattribut für das neue function-Tag angibt.

• Das optionale Argument doctypes gibt an, dass dieses Menü nur für bestimmte Dokumenttypen aktiv ist. Sie können das Argument doctypes als eine durch Kommas getrennte Liste von Dokumenttyp-IDs angeben. Eine Liste der Dokumenttypen von Dreamweaver finden Sie in der Dreamweaver-Datei Configuration\Documenttypes\MMDocu-mentTypes.xml.

• Das optionale Argument casesensitive gibt an, ob bei dem Muster zwischen Groß- und Kleinschreibung unter-schieden werden soll. Die möglichen Werte von casesensitive sind die Booleschen Werte true und false. Bei Auslassung dieses Arguments wird der Wert standardmäßig auf false gesetzt. Wenn das Argument casesensitive den Wert true aufweist, wird das Menü Codehinweise nur dann angezeigt, wenn der vom Benutzer eingegebene Text genau dem vom Musterattribut angegebenen Muster entspricht. Wenn casesensitive auf false gesetzt ist, wird das Menü auch eingeblendet, wenn sich die Groß- und Kleinschreibung von Muster und Text unterscheiden.

RückgabewerteKeine

Beispiel Im folgenden Beispiel für die Funktion dw.codeHints.addFunction() wird das Funktionsnamenmuster out.newLine() zur Codehinweise-Menügruppe CodeHints_Object_Methods hinzugefügt und nur für JSP-Dokumenttypen aktiviert:

dw.codeHints.addFunction(

"CodeHints_Object_Methods", "out.newLine()",

"JSP")

dreamweaver.codeHints.resetMenu()


BeschreibungSetzt das angegebene menu- oder function-Tag auf den Status zurück, den es unmittelbar nach dem Einlesen der Datei CodeHints.xml aufgewiesen hat. Ein Aufruf dieser Funktion hebt daher die Wirkung vorausgegangener Aufrufe von addMenu() und addFunction() auf.

ArgumentemenuGroupId, pattern, {doctypes}

Das Argument menuGroupId ist das ID-Stringattribut eines menugroup-Tags.

Das Argument pattern ist ein String, der das Musterattribut für das neue, zurückzusetzende menu- oder function-Tag angibt.

Das optionale Argument doctypes gibt an, dass dieses Menü nur für bestimmte Dokumenttypen aktiv ist. Sie können das Argument doctypes als eine durch Kommas getrennte Liste von Dokumenttyp-IDs angeben. Eine Liste der Dokument-typen von Dreamweaver finden Sie in der Dreamweaver-Datei Configuration\Documenttypes\MMDocument-Types.xml.

RückgabewerteKeine


374

BeispielIhr JavaScript-Code soll ein Menü mit Codehinweisen generieren, das benutzerdefinierte Sitzungsvariablen enthält. Immer wenn die Liste der Sitzungsvariablen geändert wird, muss dieser Code das Menü aktualisieren. Bevor der Code die neue Liste der Sitzungsvariablen in das Menü laden kann, muss er die alte Liste entfernen. Ein Aufruf dieser Funktion entfernt die alten Sitzungsvariablen.

dreamweaver.codeHints.showCodeHints()


BeschreibungDreamweaver ruft diese Funktion auf, wenn der Benutzer das Menüelement Bearbeiten > Codehinweise anzeigen aufruft. Die Funktion blendet das Menü Codehinweise in der Codeansicht nach der aktuellen Auswahl ein.

ArgumenteKeine

RückgabewerteKeine

BeispielIm folgenden Beispiel wird das Menü Codehinweise an der aktuellen Einfügemarke im Dokument aufgerufen, wenn es sich in der Codeansicht befindet.

dw.codeHints.showCodeHints()

dreamweaver.reloadCodeColoring()

BeschreibungLädt Farbeinstellungsdateien für Codes aus dem Dreamweaver-Ordner Configuration\CodeColoring.

ArgumenteKeine

RückgabewerteKeine

Beispieldreamweaver.reloadCodeColoring()

Suchen- und Ersetzen-FunktionenMit diesen Funktionen können Sie Suchen- und Ersetzen-Vorgänge durchführen. Es stehen sowohl grundlegende Funktionen zur Verfügung (z. B. zum Auffinden von Suchbegriffen) als auch komplexe Ersetzungsfunktionen, die keinen Benutzereingriff erfordern.

dreamweaver.findNext()

VerfügbarkeitDreamweaver 3, in Dreamweaver MX 2004 geändert.


375

BeschreibungFindet das nächste Vorkommen des Suchbegriffs, der zuvor mit der Funktion „dreamweaver.setUpFind()“ auf Seite 377 bzw. „dreamweaver.setUpComplexFind()“ auf Seite 376 oder vom Benutzer im Dialogfeld Suchen definiert wurde, und wählt den Suchbegriff im Dokument aus.

Argumente{bUseLastSetupSearch}

• Das optionale Argument bUseLastSetupSearch ist ein Boolescher Wert. Wenn bUseLastSetupSearch den Wert true aufweist (Standardeinstellung, wenn kein Argument angegeben ist), führt die Funktion eine Operation zum Weiter-suchen anhand der Parameter durch, die durch einen vorherigen Aufruf von dreamweaver.setupComplexFind() oder dreamweaver.setupComplexFindReplace() angegeben wurden. Wenn Sie bUseLastSetupSearch auf false setzen, ignoriert die Funktion die zuvor eingerichtete Suche und führt eine Suche nach der nächsten Instanz des Textes durch, der aktuell im Dokument ausgewählt ist.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canFindNext()“ auf Seite 426.

dreamweaver.replace()


BeschreibungÜberprüft, ob die aktuelle Auswahl mit den Suchkriterien übereinstimmt, die von „dreamweaver.setUpFindReplace()“ auf Seite 377, von „dreamweaver.setUpComplexFindReplace()“ auf Seite 376 oder vom Benutzer im Dialogfeld Ersetzen festgelegt wurden. Die Funktion ersetzt dann die Auswahl durch den von der Suchanforderung angegebenen Ersatztext.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.replaceAll()


BeschreibungErsetzt alle Bereiche im aktuellen Dokument, die den Suchkriterien entsprechen, die zuvor mit der Funktion „dream-weaver.setUpFindReplace()“ auf Seite 377 bzw. „dreamweaver.setUpComplexFindReplace()“ auf Seite 376 oder vom Benutzer im Dialogfeld Ersetzen festgelegt wurden, durch den angegebenen Ersatzinhalt.

ArgumenteKeine

RückgabewerteKeine


376

dreamweaver.setUpComplexFind()


BeschreibungBereitet eine erweiterte Text- oder Tag-Suche durch Laden der angegebenen XML-Abfrage vor.

ArgumentexmlQueryString

• Das Argument xmlQueryString ist ein String mit XML-Code, der mit dwquery eingeleitet wird und mit /dwquery abschließt. (So erhalten Sie einen String im richtigen Format: Erstellen Sie eine Abfrage im Dialogfeld Suchen, klicken Sie auf die Schaltfläche Abfrage speichern, öffnen Sie die Abfragedatei in einem Texteditor, und kopieren Sie den gesamten Bereich vom Anfang des Tags dwquery bis zum Ende des Tags /dwquery.)

Hinweis: Innerhalb einer Abfrage müssen bestimmte Sonderzeichen wie der umgekehrte Schrägstrich (\) ausgeschaltet werden. Wenn Sie einen umgekehrten Schrägstrich in einer Abfrage verwenden möchten, müssen Sie deshalb \\ schreiben.

RückgabewerteKeine

BeispielIn der ersten Zeile des folgenden Beispiels wird eine Tag-Suche mit dem aktuellen Dokument als Suchbereich vereinbart. In der zweiten Zeile wird der Suchvorgang ausgeführt.

dreamweaver.setUpComplexFind('<dwquery><queryparams matchcase="false" ¬

ignorewhitespace="true" useregexp="false"/><find>¬

<qtag qname="a"><qattribute qname="href" qcompare="=" qvalue="#">¬

</qattribute><qattribute qname="onMouseOut" qcompare="=" qvalue="" qnegate="true">¬

</qattribute></qtag></find></dwquery>');

dw.findNext();

dreamweaver.setUpComplexFindReplace()


BeschreibungBereitet eine erweiterte Text- oder Tag-Suche durch Laden der angegebenen XML-Abfrage vor.

ArgumentexmlQueryString

• Das Argument xmlQueryString ist ein String mit XML-Code, der mit dem Tag dwquery eingeleitet wird und mit dem Tag /dwquery abschließt. (So erhalten Sie einen String im richtigen Format: Erstellen Sie eine Abfrage im Dialogfeld Suchen, klicken Sie auf die Schaltfläche Abfrage speichern, öffnen Sie die Abfragedatei in einem Texteditor, und kopieren Sie den gesamten Bereich vom Anfang des Tags dwquery bis zum Ende des Tags /dwquery.)

Hinweis: Innerhalb einer Abfrage müssen bestimmte Sonderzeichen wie der umgekehrte Schrägstrich (\) ausgeschaltet werden. Wenn Sie einen umgekehrten Schrägstrich in einer Abfrage verwenden möchten, müssen Sie deshalb \\ schreiben.

RückgabewerteKeine

BeispielIn der ersten Anweisung des folgenden Beispiels wird eine Tag-Suche mit vier Dateien als Suchbereich vereinbart. In der zweiten Anweisung wird der Suchen/Ersetzen-Vorgang ausgeführt.


377

dreamweaver.setUpComplexFindReplace('<dwquery><queryparams ¬

matchcase="false" ignorewhitespace="true" useregexp="false"/>¬

<find><qtag qname="a"><qattribute qname="href" qcompare="=" qvalue="#">¬

</qattribute><qattribute qname="onMouseOut" ¬qcompare="=" qvalue="" qnegate="true">¬

</qattribute></qtag></find><replace action="setAttribute" param1="onMouseOut" ¬

param2="this.style.color='#000000';this.style.¬

fontWeight='normal'"/></dwquery>');

dw.replaceAll();

dreamweaver.setUpFind()


BeschreibungBereitet eine Text- oder HTML-Quellcode-Suche vor, indem die Suchparameter für einen anschließenden Vorgang vom Typ dreamweaver.findNext() definiert werden.

ArgumentesearchObject

Das Argument searchObject ist ein Objekt, für das die folgenden Eigenschaften definiert werden können:

• searchString ist der zu suchende Text.

• Die Eigenschaft searchSource ist ein Boolescher Wert, der angibt, ob der HTML-Quellcode durchsucht werden soll.

• Die optionale Eigenschaft {matchCase} ist ein Boolescher Wert, der angibt, ob bei der Suche zwischen Groß- und Klein-schreibung unterschieden werden soll. Wenn diese Eigenschaft nicht explizit angegeben wird, gilt der Standardwert false.

• Die optionale Eigenschaft {ignoreWhitespace} ist ein Boolescher Wert, der angibt, ob Unterschiede bei Leerräumen ignoriert werden sollen. Die Standardeinstellung für ignoreWhitespace lautet false, wenn der Wert der Eigenschaft useRegularExpressions true ist. Sie lautet true, wenn die Eigenschaft useRegularExpressions den Wert false aufweist.

• Die Eigenschaft {useRegularExpressions} ist ein Boolescher Wert, der angibt, ob die Eigenschaft searchString reguläre Ausdrücke enthält. Wenn diese Eigenschaft nicht explizit angegeben wird, gilt der Standardwert false.

RückgabewerteKeine

BeispielIm folgenden Code wird das Objekt searchObject auf drei verschiedene Weisen erstellt:

var searchParams;

searchParams.searchString = 'bgcolor="#FFCCFF"';

searchParams.searchSource = true;

dreamweaver.setUpFind(searchParams);

var searchParams = {searchString: 'bgcolor="#FFCCFF"', searchSource: true};

dreamweaver.setUpFind(searchParams);

dreamweaver.setUpFind({searchString: 'bgcolor="#FFCCFF"', searchSource: ¬true});

dreamweaver.setUpFindReplace()



378

BeschreibungBereitet eine Text- oder HTML-Quellcode-Suche vor, indem Suchparameter und Suchbereich für anschließende Vorgänge vom Typ dreamweaver.replace() oder dreamweaver.replaceAll() definiert werden.

ArgumentesearchObject

Das Argument searchObject ist ein Objekt, für das die folgenden Eigenschaften definiert werden können:

• Die Eigenschaft searchString ist der zu suchende Text.

• Die Eigenschaft replaceString ist der Text, der die Auswahl ersetzen soll.

• Die Eigenschaft searchSource ist ein Boolescher Wert, der angibt, ob der HTML-Quellcode durchsucht werden soll.

• Die optionale Eigenschaft {matchCase} ist ein Boolescher Wert, der angibt, ob bei der Suche zwischen Groß- und Klein-schreibung unterschieden werden soll. Wenn diese Eigenschaft nicht explizit angegeben wird, gilt der Standardwert false.

• Die optionale Eigenschaft {ignoreWhitespace} ist ein Boolescher Wert, der angibt, ob Unterschiede bei Leerräumen ignoriert werden sollen. Der Standardwert für die Eigenschaft ignoreWhitespace lautet false, wenn die Eigenschaft useRegularExpressions den Wert true hat. Der Standardwert lautet true, wenn die Eigenschaft useRegularExpres-sions den Wert false hat.

• Die Eigenschaft {useRegularExpressions} ist ein Boolescher Wert, der angibt, ob die Eigenschaft searchString reguläre Ausdrücke enthält. Wenn diese Eigenschaft nicht explizit angegeben wird, gilt der Standardwert false.

RückgabewerteKeine

BeispielIm folgenden Code wird das Objekt searchObject auf drei verschiedene Weisen erstellt:

var searchParams;

searchParams.searchString = 'bgcolor="#FFCCFF"';

searchParams.replaceString = 'bgcolor="#CCFFCC"';

searchParams.searchSource = true;

dreamweaver.setUpFindReplace(searchParams);

var searchParams = {searchString: 'bgcolor="#FFCCFF"', replaceString: 'bgcolor="#CCFFCC"',

searchSource: true};

dreamweaver.setUpFindReplace(searchParams);

dreamweaver.setUpFindReplace({searchString: 'bgcolor="#FFCCFF"',

replaceString: 'bgcolor="#CCFFCC"', searchSource: true});

dreamweaver.showFindDialog()


BeschreibungÖffnet das Dialogfeld Suchen.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canShowFindDialog()“ auf Seite 430.


379

dreamweaver.showFindReplaceDialog()


BeschreibungÖffnet das Dialogfeld Ersetzen.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canShowFindDialog()“ auf Seite 430.

Allgemeine BearbeitungsfunktionenMit diesen Funktionen können Sie im Dokumentfenster übliche Bearbeitungsaufgaben durchführen. Unter anderem lassen sich Text, HTML-Code und Objekte einfügen, Schrift- und Zeichen-Markups anwenden, ändern und entfernen sowie Tags und Attribute modifizieren.

dom.applyCharacterMarkup()


BeschreibungWendet das angegebene Zeichen-Markup auf die Auswahl an. Wenn die Auswahl eine Einfügemarke ist, wird das Zeichen-Markup auf nachfolgend eingegebenen Text angewendet.

ArgumentetagName

• Das Argument tagName ist der Tag-Name, der zu dem Zeichen-Markup gehört. Es muss sich um einen der folgenden Strings handeln: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" oder "var".

RückgabewerteKeine

dom.applyFontMarkup()


BeschreibungWendet auf die aktuelle Auswahl das Tag FONT mit dem angegebenen Attribut und dem dieser Auswahl entsprechenden Wert an.

Argumenteattribute, value

• Das Argument attribute muss "face", "size" oder "color" lauten.


380

• Das Argument value ist der Wert, der dem Attribut zugewiesen werden soll, beispielsweise "Arial, Helvetica, sans-serif", "5" oder "#FF0000".

RückgabewerteKeine

dom.deleteSelection()


BeschreibungLöscht die Auswahl im Dokument.

ArgumenteKeine

RückgabewerteKeine

dom.editAttribute()


BeschreibungZeigt die für die Bearbeitung des angegebenen Attributs geeignete Benutzerschnittstelle an. In der Regel handelt es sich dabei um ein Dialogfeld. Diese Funktion ist nur für das aktive Dokument gültig.

ArgumenteAttribut

• Bei attribute handelt es sich um einen String, der das zu bearbeitende Tag-Attribut angibt.

RückgabewerteKeine

dom.exitBlock()


BeschreibungBeendet den aktuellen Absatz bzw. Überschriftenblock und positioniert die Einfügemarke außerhalb von allen Blockele-menten.

ArgumenteKeine

RückgabewerteKeine


381

dom.getCharSet()


BeschreibungGibt das Attribut charset im Meta-Tag des Dokuments zurück.

ArgumenteKeine

RückgabewerteDie Kodierung des Dokuments. In einem Dokument mit der Kodierung Latin 1 wird beispielsweise iso-8859-1 zurückge-geben.

dom.getFontMarkup()


BeschreibungRuft für die aktuelle Auswahl im Tag FONT den Wert des angegebenen Attributs ab.

ArgumenteAttribut


RückgabewerteEin String mit dem Wert des angegebenen Attributs bzw. ein leerer String, wenn das Attribut nicht gesetzt ist.

dom.getLineFromOffset()


BeschreibungFindet die Zeilennummer eines bestimmten Zeichen-Offsets im Text (HTML- bzw. JavaScript-Code) der Datei.

Argumenteoffset

• Das Argument offset ist eine Ganzzahl, die die Zeichenposition ab dem Anfang der Datei angibt.

RückgabewerteEine Ganzzahl, die die Zeilennummer im Dokument angibt.

dom.getLinkHref()


BeschreibungRuft den Hyperlink ab, der die aktuelle Auswahl umgibt. Diese Funktion entspricht dem Durchlaufen der übergeordneten Elemente des aktuellen Knotens sowie der diesen Elementen übergeordneten Elemente, bis ein Hyperlink gefunden, und dann für diesen die Funktion getAttribute('HREF') aufgerufen wird.


382

ArgumenteKeine

RückgabewerteEin String mit dem Namen der verknüpften Datei, ausgedrückt im URL-Format „file://“.

dom.getLinkTarget()


BeschreibungRuft das Ziel des Hyperlinks ab, der die aktuelle Auswahl umgibt. Diese Funktion entspricht dem Durchlaufen der überge-ordneten Elemente des aktuellen Knotens sowie der diesen Elementen übergeordneten Elemente, bis ein Hyperlink gefunden, und dann für diesen die Funktion getAttribute('TARGET') aufgerufen wird.

ArgumenteKeine

RückgabewerteEin String mit dem Wert des Attributs TARGET für den Hyperlink bzw. ein leerer String, wenn kein Ziel angegeben ist.

dom.getListTag()


BeschreibungRuft den Stil der ausgewählten Liste ab.

ArgumenteKeine

RückgabewerteEin String mit dem Tag, das mit der Liste ("ul", "ol" oder "dl") verknüpft ist, oder ein leerer String, wenn kein Tag mit der Liste verknüpft ist. Dieser Wert wird immer in Kleinbuchstaben zurückgegeben.

dom.getTextAlignment()


BeschreibungRuft die Ausrichtung des Blocks ab, in dem die Auswahl enthalten ist.

ArgumenteKeine

RückgabewerteEin String mit dem Wert des mit dem Block verknüpften Attributs ALIGN oder ein leerer String, wenn das Attribut ALIGN für das Tag nicht gesetzt ist. Dieser Wert wird immer in Kleinbuchstaben zurückgegeben.


383

dom.getTextFormat()


BeschreibungRuft das Blockformat des ausgewählten Textes ab.

ArgumenteKeine

RückgabewerteEin String mit dem zugewiesenen Block-Tag (zum Beispiel "p", "h1", "pre" etc.) oder ein leerer String, wenn mit der Auswahl kein Block-Tag verknüpft ist. Dieser Wert wird immer in Kleinbuchstaben zurückgegeben.

dom.hasCharacterMarkup()


BeschreibungÜberprüft, ob die Auswahl bereits das angegebene Zeichen-Markup aufweist.

ArgumentemarkupTagName

• Das Argument markupTagName ist der Name des Tags, das überprüft wird. Es muss sich um einen der folgenden Strings handeln: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" oder "var".

RückgabewerteEin Boolescher Wert, der angibt, ob die gesamte Auswahl das betreffende Zeichen-Markup besitzt. Wenn nur ein Teil der Auswahl über das angegebene Markup verfügt, wird der Wert false zurückgegeben.

dom.indent()


BeschreibungWeist der Auswahl mit BLOCKQUOTE-Tags einen Einzug zu. Wenn die Auswahl ein Listenelement ist, weist ihm diese Funktion einen Einzug zu, indem das ausgewählte Element in eine verschachtelte Liste konvertiert wird. Diese verschach-telte Liste hat den gleichen Typ wie die äußere Liste und enthält mit der ursprünglichen Auswahl nur ein Element.

ArgumenteKeine

RückgabewerteKeine

dom.insertHTML()



384

BeschreibungFügt im Dokument an der Einfügemarke HTML-Inhalt ein.

ArgumentecontentToInsert, {bReplaceCurrentSelection}

• Das Argument contentToInsert ist der einzufügende Inhalt.

• Das optionale Argument bReplaceCurrentSelection ist ein Boolescher Wert, der angibt, ob der Inhalt die aktuelle Auswahl ersetzen soll. Wenn das Argument bReplaceCurrentSelection den Wert true aufweist, ersetzt der Inhalt die aktuelle Auswahl. Wenn der Wert false lautet, wird der Inhalt nach der aktuellen Auswahl eingefügt.

RückgabewerteKeine

BeispielDurch den folgenden Code wird der HTML-String <b>130</b> in das aktuelle Dokument eingefügt:


theDOM.insertHTML('<b>130</b>');

Das Ergebnis wird im Dokumentfenster angezeigt, wie in der folgenden Abbildung dargestellt:

dom.insertObject()


BeschreibungFügt das angegebene Objekt ein und fordert den Benutzer gegebenenfalls zur Eingabe von Parametern auf.

ArgumenteobjectName

• Das Argument objectName ist der Name eines Objekts im Ordner Configuration\Objects.

RückgabewerteKeine

BeispielEin Aufruf der Funktion dom.insertObject('Button') fügt nach der aktuellen Auswahl eine Formularschaltfläche in das aktive Dokument ein. Ist nichts ausgewählt, fügt diese Funktion die Schaltfläche an der aktuellen Einfügemarke ein.

Hinweis: Auch wenn Objektdateien in eigenen Ordnern gespeichert werden können, dürfen die Dateinamen jeweils nur einmal vorkommen. Wenn sich sowohl im Ordner Forms als auch im Ordner MyObjects eine Datei mit dem Namen Button.htm befindet, können diese beiden Dateien nicht unterschieden werden.

dom.insertText()



385

BeschreibungFügt im Dokument an der Einfügemarke Textinhalt ein.

ArgumentecontentToInsert, {bReplaceCurrentSelection}

• Das Argument contentToInsert ist der einzufügende Inhalt.

• Das optionale Argument bReplaceCurrentSelection ist ein Boolescher Wert, der angibt, ob der Inhalt die aktuelle Auswahl ersetzen soll. Wenn das Argument bReplaceCurrentSelection den Wert true aufweist, ersetzt der Inhalt die aktuelle Auswahl. Wenn der Wert false lautet, wird der Inhalt nach der aktuellen Auswahl eingefügt.

RückgabewerteKeine

BeispielDer folgende Code fügt den Text <b>130</b> in das aktuelle Dokument ein:

var theDOM = dreamweaver.getDocumentDOM();

theDOM.insertText('<b>130</b>');

Die Ergebnisse werden im Dokumentfenster angezeigt, wie in der folgenden Abbildung dargestellt:

dom.newBlock()


BeschreibungErstellt einen neuen Block mit dem gleichen Tag und den gleichen Attributen wie der Block, in dem die aktuelle Auswahl enthalten ist, oder erstellt einen neuen Absatz, wenn sich der Zeiger außerhalb aller Blöcke befindet.

ArgumenteKeine

RückgabewerteKeine

BeispielWenn sich die aktuelle Auswahl in einem zentrierten Absatz befindet, wird durch Aufruf der Funktion dom.newBlock() <p align="center"> nach dem aktuellen Absatz eingefügt.

dom.notifyFlashObjectChanged()


BeschreibungTeilt Dreamweaver mit, dass die aktuelle Flash-Objektdatei sich geändert hat. Dreamweaver aktualisiert die Vorschau und nimmt die erforderliche Größenanpassung vor, wobei das Breiten-/Höhenverhältnis der ursprünglichen Größe beibehalten wird. Diese Funktion wird beispielsweise von Flash-Text verwendet, um den Text in der Layoutansicht zu aktualisieren, wenn der Benutzer die Eigenschaften im Dialogfeld Befehl ändert.


386

ArgumenteKeine

RückgabewerteKeine

dom.outdent()


BeschreibungWeist der Auswahl einen hängenden Einzug zu.

ArgumenteKeine

RückgabewerteKeine

dom.removeCharacterMarkup()


BeschreibungEntfernt das angegebene Zeichen-Markup aus der Auswahl.

ArgumentetagName

• Das Argument tagName ist der Tag-Name, der zu dem Zeichen-Markup gehört. Es muss sich um einen der folgenden Strings handeln: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" oder "var".

RückgabewerteKeine

dom.removeFontMarkup()


BeschreibungEntfernt das angegebene Attribut und seinen Wert aus einem FONT-Tag. Wenn nach dem Entfernen des Attributs nur FONT übrigbleiben würde, wird auch das Tag FONT entfernt.

ArgumenteAttribut


RückgabewerteKeine


387

dom.removeLink()


BeschreibungEntfernt den Hyperlink aus der Auswahl.

ArgumenteKeine

RückgabewerteKeine

dom.resizeSelection()


BeschreibungÄndert die Größe des ausgewählten Objekts unter Verwendung der angegebenen Abmessungen.

ArgumentenewWidth, newHeight

• Das Argument newWidth gibt die neue Breite an, die die Funktion auf das ausgewählte Objekt anwendet.

• Das Argument newHeight gibt die neue Höhe an, die die Funktion auf das ausgewählte Objekt anwendet.

RückgabewerteKeine

dom.setAttributeWithErrorChecking()


BeschreibungSetzt das betreffende Attribut der aktuellen Auswahl auf den angegebenen Wert. Wenn der Typ des Werts nicht korrekt ist oder sich der Wert außerhalb des zulässigen Bereichs befindet, wird eine Meldung angezeigt. Diese Funktion ist nur für das aktive Dokument gültig.

Argumenteattribute, value

• Das Argument attribute gibt das für die aktuelle Auswahl festzulegende Attribut an.

• Das Argument value gibt den Wert für das Attribut an.

RückgabewerteKeine

dom.setLinkHref()



388

BeschreibungMacht aus der Auswahl einen Hyperlink oder ändert den URL-Wert des HREF-Tags, das die aktuelle Auswahl einschließt.

ArgumentelinkHREF

• Das Argument linkHREF ist die den Hyperlink enthaltende URL (Pfad relativ zum Dokument oder zum Stamm bzw. absolute URL). Wenn dieses Argument ausgelassen wird, wird das Dialogfeld HTML-Datei auswählen angezeigt.

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canSetLinkHref()“ auf Seite 422.

dom.setLinkTarget()


BeschreibungStellt das Ziel des Hyperlinks ein, der die aktuelle Auswahl umgibt. Diese Funktion entspricht dem Durchlaufen der überge-ordneten Elemente des aktuellen Knotens sowie der diesen Elementen übergeordneten Elemente, bis ein Hyperlink gefunden, und dann für diesen die Funktion setAttribute('TARGET') aufgerufen wird.

Argumente{linkTarget}

• Das optionale Argument linkTarget ist ein String, der einen Framenamen, ein Fenster oder eines der reservierten Ziele angibt ("_self", "_parent", "_top" oder "_blank"). Wenn das Argument ausgelassen wird, wird das Dialogfeld Ziel einstellen eingeblendet.

RückgabewerteKeine

dom.setListBoxKind()


BeschreibungWechselt die Art des AUSWÄHLEN-Menüs.

Argumentekind

• Das Argument kind muss entweder "menu" oder "list box" sein.

RückgabewerteKeine

dom.showListPropertiesDialog()



389

BeschreibungÖffnet das Dialogfeld Listeneigenschaften.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dom.canShowListPropertiesDialog()“ auf Seite 422.

dom.setListTag()


BeschreibungStellt den Stil der ausgewählten Liste ein.

ArgumentelistTag

• Das Argument listTag ist das Tag, das zur Liste gehört. Es muss sich um "ol", "ul", "dl" oder einen leeren String handeln.

RückgabewerteKeine

dom.setTextAlignment()


BeschreibungSetzt das Attribut ALIGN des Blocks, der die Auswahl enthält, auf den angegebenen Wert.

ArgumentealignValue

• Das Argument alignValue muss "left", "center" oder "right" sein.

RückgabewerteKeine

dom.setTextFieldKind()


BeschreibungLegt das Format des ausgewählten Textfelds fest.

ArgumentefieldType

• Das Argument fieldType muss "input", "textarea" oder "password" sein.


390

RückgabewerteKeine

dom.setTextFormat()


BeschreibungLegt das Blockformat des ausgewählten Textes fest.

ArgumenteblockFormat

• Das Argument blockFormat ist ein String, der eines der folgenden Formate angibt: "" (kein Format), "p", "h1", "h2", "h3", "h4", "h5", "h6" oder "pre".

RückgabewerteKeine

dom.showFontColorDialog()


BeschreibungÖffnet das Dialogfeld Farbe.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.deleteSelection()


BeschreibungLöscht die Auswahl im aktiven Dokument bzw. im Bedienfeld Site. Beim Macintosh wird das aktive Textfeld in einem Dialogfeld bzw. einem schwebenden Bedienfeld gelöscht.

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canDeleteSelection()“ auf Seite 425.


391

dreamweaver.editFontList()


BeschreibungÖffnet das Dialogfeld Schriftartliste bearbeiten.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.getFontList()


BeschreibungRuft eine Liste aller Schriftartgruppen ab, die im Eigenschafteninspektor für Text und im Dialogfeld Stildefinition angezeigt werden.

ArgumenteKeine

RückgabewerteEin Array von Strings mit den einzelnen Elementen der Schriftartliste.

BeispielBei der Standardinstallation von Dreamweaver wird beim Aufruf der Funktion dreamweaver.getFontList() ein Array mit den folgenden Elementen zurückgegeben:

• "Arial, Helvetica, sans-serif"

• "Times New Roman, Times, serif"

• "Courier New, Courier, mono"

• "Georgia, Times New Roman, Times, serif"

• "Verdana, Arial, Helvetica, sans-serif"

dreamweaver.getFontStyles()


BeschreibungGibt die Stile zurück, die von einer angegebenen TrueType-Schriftart unterstützt werden.

ArgumentefontName

• Das Argument fontName ist ein String, der den Namen der Schriftart enthält.


392

RückgabewerteEin Array mit drei Booleschen Werten, die angeben, welche Stile die Schriftart unterstützt. Der erste Wert gibt an, ob die Schriftart Fettdruck, unterstützt, der zweite Wert definiert die Unterstützung für Kursivschrift und der dritte Wert die Unterstützung für Fett und Kursiv.

dreamweaver.getKeyState()


BeschreibungBestimmt, ob die angegebene Taste gedrückt ist.

Argumentekey

• Das Argument key muss einen der folgenden Werte aufweisen: "Cmd", "Ctrl", "Alt" oder "Shift". Bei Windows beziehen sich "Cmd" und "Ctrl" auf die Taste <Strg>. Beim Macintosh bezeichnet "Alt" die Wahltaste.

RückgabewerteEin Boolescher Wert, der angibt, ob die betreffende Taste gedrückt ist.

BeispielMit dem folgenden Code wird vor der Durchführung eines Vorgangs überprüft, ob die Umschalttaste und die Taste <Strg> (Windows) bzw. die Umschalt- und Befehlstaste (Macintosh) gedrückt sind:

if (dw.getKeyState("Shift") && dw.getKeyState("Cmd")){

// Ausführungscode

}

dreamweaver.getNaturalSize()


BeschreibungGibt die Breite und die Höhe eines grafischen Objekts zurück.

Argumenteurl

• Das Argument url zeigt auf ein grafisches Objekt, dessen Abmessungen gesucht werden. Dreamweaver muss dieses Objekt unterstützen (GIF, JPEG, PNG, Flash und Shockwave). Als Argument für die Funktion getNaturalSize() muss eine absolute, auf eine lokale Datei zeigende URL angegeben werden; relative URLs sind nicht zulässig.

RückgabewerteEin Array mit zwei Ganzzahlen, wobei die erste Ganzzahl die Breite des Objekts und die zweite dessen Höhe definiert.

dreamweaver.getSystemFontList()


BeschreibungGibt eine Schriftartliste für das System zurück. Mit dieser Funktion können entweder alle Schriftarten oder nur TrueType-Schriften abgerufen werden. Diese Schriftarten sind für das Objekt „Flash-Text“ erforderlich.


393

ArgumentefontTypes

• Das Argument fontTypes ist ein String, der entweder "all" oder "TrueType" enthält.

RückgabewerteEin Array von Strings, die alle Schriftartnamen enthalten. Wenn keine Schriftarten gefunden werden, wird der Wert null zurückgegeben.

DruckfunktionMit der Druckfunktion kann der Benutzer Code aus der Codeansicht drucken.

dreamweaver.printCode()


BeschreibungUnter Windows druckt diese Funktion den gesamten Code oder ausgewählte Codeabschnitte aus der Codeansicht. Unter Mac OS druckt diese Funktion den gesamten Code oder einen Seitenbereich des Codes.

ArgumenteshowPrintDialog, document

• Das Argument showPrintDialog ist entweder true oder false. Wenn dieses Argument den Wert true hat, zeigt die Funktion dreamweaver.PrintCode() in Windows das Dialogfeld Drucken an, in dem der Benutzer angeben kann, ob der gesamte Text oder eine Textauswahl gedruckt werden soll. Auf dem Macintosh zeigt dreamweaver.PrintCode() das Dialogfeld Drucken an, in dem der Benutzer angeben kann, ob der gesamte Text oder ein Seitenbereich gedruckt werden soll.

Wenn das Argument den Wert false hat, verwendet dreamweaver.PrintCode() die bisherige Auswahl des Benutzers. Der Standardwert ist true.

• Das Argument document ist das DOM (Dokumentobjektmodell) des zu druckenden Dokuments. Informationen zum Abrufen des DOM für ein Dokument finden Sie unter „dreamweaver.getDocumentDOM()“ auf Seite 231.

RückgabewerteEin Boolescher Wert: true, wenn der Code gedruckt werden kann, andernfalls false.

Beispiel Im folgenden Beispiel wird dw.PrintCode() aufgerufen, um das Dialogfeld Drucken für das Dokument des Benutzers zu öffnen. Wenn die Funktion den Wert false zurückgibt, zeigt der Code eine Warnung an, um den Benutzer zu informieren, dass der Druckvorgang nicht ausgeführt werden kann.

var theDOM = dreamweaver.getDocumentDOM("document");

if(!dreamweaver.PrintCode(true, theDOM))

{

alert(“Unable to execute your print request!”);

}


394

Quick Tag Editor-FunktionenDie Quick Tag Editor-Funktionen werden auf Tags angewendet, die sich entweder innerhalb der aktuellen Auswahl befinden oder diese umgeben. Tags können aus der Hierarchie entfernt und ausgewählte Bereiche in neue Tags einge-schlossen werden. Außerdem kann der Quick Tag Editor aufgerufen werden, mit dem sich spezifische Attribute des Tags bearbeiten lassen.

dom.selectChild()


BeschreibungWählt ein der aktuellen Auswahl untergeordnetes Objekt aus. Diese Funktion ist äquivalent dazu, im Tag-Selektor am unteren Rand des Dokumentfensters das nächste Tag rechts auszuwählen.

ArgumenteKeine

RückgabewerteKeine

dom.selectParent()


BeschreibungWählt das der aktuellen Auswahl übergeordnete Objekt aus. Diese Funktion ist äquivalent dazu, im Tag-Selektor am unteren Rand des Dokumentfensters das nächste Tag links auszuwählen.

ArgumenteKeine

RückgabewerteKeine

dom.stripTag()


BeschreibungEntfernt das die aktuelle Auswahl umgebende Tag, belässt jedoch den Inhalt. Wenn die Auswahl mehr als ein oder überhaupt kein Tag enthält, wird eine Fehlermeldung ausgegeben.

ArgumenteKeine

RückgabewerteKeine


395

dom.wrapTag()


BeschreibungLegt das angegebene Tag um die aktuelle Auswahl. Wenn die Auswahl nicht ausgeglichen ist, wird eine Fehlermeldung ausgegeben.

ArgumentestartTag

• Das Argument startTag ist die Quelle, die zum öffnenden Tag gehört.

RückgabewerteKeine

BeispielMit dem folgenden Code wird ein Hyperlink um die aktuelle Auswahl gelegt:


var theSel = theDOM.getSelectedNode();

if (theSel.nodeType == Node.TEXT_NODE){theDOM.wrapTag('<a href="foo.html">');

}

dreamweaver.showQuickTagEditor()


BeschreibungZeigt für die aktuelle Auswahl den Quick Tag Editor an.

Argumente{nearWhat}, {mode}

• Das optionale nearWhat-Argument, falls vorhanden, muss entweder "selection" oder "tag selector" lauten. Bei fehlendem Argument gilt als Standard "selection".

• Das optionale Argument mode, falls vorhanden, muss "default", "wrap", "insert" oder "edit" lauten Falls für mode der Wert "default" gewählt oder das Argument ausgelassen wurde, wird der Modus für die aktuelle Auswahl heuristisch bestimmt. Das Argument mode wird ignoriert, wenn für nearWhat "tag selector" angegeben wurde.

RückgabewerteKeine

Codeansicht-FunktionenZu den Codeansicht-Funktionen gehören Bearbeitungsvorgänge am Quellcode eines Dokuments (sowie ihre Auswir-kungen auf die Entwurfsansicht). Mit den Funktionen in diesem Abschnitt können Sie den Codeansichten in einer geteilten Dokumentansicht oder dem Fenster des Codeinspektors Navigationssteuerelemente hinzufügen.


396

dom.formatRange()


BeschreibungWendet auf einen angegebenen Zeichenbereich in der Codeansicht die automatische Syntaxformatierung von Dream-weaver an, gemäß den Einstellungen im Dialogfeld Voreinstellungen > Codeformat.

ArgumentestartOffset, endOffset

• Das Argument startOffset ist eine Ganzzahl, die den Beginn des angegebenen Bereichs als Offset ab dem Anfang des Dokuments darstellt.

• Das Argument endOffset ist eine Ganzzahl, die das Ende des angegebenen Bereichs als Offset ab dem Anfang des Dokuments darstellt.

RückgabewerteKeine

dom.formatSelection()


BeschreibungWendet auf den ausgewählten Inhalt die automatische Syntaxformatierung von Dreamweaver an, gemäß den Einstellungen im Dialogfeld Voreinstellungen > Codeformat. (Entspricht dem Befehl Befehle > Quellenformatierung auf Auswahl anwenden.)

ArgumenteKeine

RückgabewerteKeine

dom.getShowNoscript()


BeschreibungRuft den aktuellen Status der Inhaltsoption noscript ab (aus der Menüoption Ansicht > Noscript-Inhalt). Das noscript-Tag (standardmäßig aktiviert) kennzeichnet Skriptinhalt, der im Browser wiedergegeben oder (optional) nicht wiederge-geben werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Inhalt des Tags noscript zurzeit gerendert wird, andernfalls false.


397

dom.getAutoValidationCount()


BeschreibungRuft die Anzahl der Fehler, Warnungen und Informationsmeldungen für die letzte automatische Prüfung (auch als Inline-Prüfung bezeichnet) ab. Zurzeit wird bei der automatischen Prüfung nur eine Zielbrowser-Prüfung durchgeführt (siehe „dom.runValidation()“ auf Seite 240).

Hinweis: Diese Funktion gibt nur die Ergebnisse zurück, die zurzeit im Ergebnisfenster des Dokuments angezeigt werden. Um sicherzustellen, dass die Zählungen aktuell sind, können Sie dom.runValidation() vor dem Aufrufen dieser Funktion aufrufen.

ArgumenteKeine

RückgabewerteEin Objekt mit den folgenden Eigenschaften:

• Der Eigenschaft numError, wobei es sich um die Anzahl der Fehler handelt

• Der Eigenschaft numWarning, wobei es sich um die Anzahl der Warnungen handelt

• Der Eigenschaft numInfo, wobei es sich um die Anzahl der Informationsmeldungen handelt

BeispieltheDom = dw.getDocumentDOM();

theDom.runValidation();

theDom.getAutoValidationCount();

dom.isDesignViewUpdated()


BeschreibungBestimmt, ob der Inhalt der Entwurfsansicht und der Textansicht bei den Dreamweaver-Vorgängen, die einen gültigen Dokumentstatus erfordern, synchronisiert wird.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Entwurfsansicht (WYSIWIG) mit dem Text in der Textansicht synchronisiert wird, andernfalls false.

dom.isSelectionValid()


BeschreibungBestimmt, ob eine Auswahl gültig ist, d. h., ob sie gegenwärtig mit der Entwurfsansicht synchronisiert ist oder vor dem Einleiten einer Operation verschoben werden muss.


398

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn es sich bei der aktuellen Auswahl um gültigen Code handelt, andernfalls false, wenn das Dokument nicht synchronisiert wurde, da die Auswahl nicht aktualisiert ist.

dom.setShowNoscript()


BeschreibungAktiviert oder deaktiviert die Inhaltsoption noscript (entspricht der Verwendung der Menüoption Ansicht > Noscript-Inhalt). Das noscript-Tag (standardmäßig aktiviert) kennzeichnet Skriptinhalt, der im Browser wiedergegeben oder (optional) nicht wiedergegeben werden kann.

Argumente{bShowNoscript}

• Das optionale Argument bShowNoscript ist ein Boolescher Wert, der angibt, ob der Inhalt des Tags noscript gerendert werden soll: true, wenn der Inhalt des Tags noscript gerendert werden soll, andernfalls false.

RückgabewerteKeine

dom.source.arrowDown()


BeschreibungVerschiebt die Einfügemarke in der Codeansicht des Dokuments zeilenweise nach unten. Wenn bereits ein Bereich ausge-wählt wurde, wird die Auswahl durch diese Funktion zeilenweise erweitert.


• Das optionale Argument nTimes gibt die Anzahl der Zeilen an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.

• Das optionale Argument bShiftIsDown ist ein Boolescher Wert, der angibt, ob der Inhalt ausgewählt wurde. Wenn bShiftIsDown den Wert true hat, wird Inhalt ausgewählt.

RückgabewerteKeine

dom.source.arrowLeft()


BeschreibungVerschiebt die Einfügemarke in der aktuellen Zeile der Codeansicht nach links. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion nach links erweitert.


399


• Das optionale Argument nTimes gibt die Anzahl der Zeichen an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.


RückgabewerteKeine

dom.source.arrowRight()


BeschreibungVerschiebt die Einfügemarke in der aktuellen Zeile der Codeansicht nach rechts. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion nach rechts erweitert.


• Das optionale Argument nTimes gibt die Anzahl der Zeichen an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.


RückgabewerteKeine

dom.source.arrowUp()


BeschreibungVerschiebt die Einfügemarke in der Codeansicht des Dokuments zeilenweise nach oben. Wenn bereits ein Bereich ausge-wählt wurde, wird die Auswahl durch diese Funktion zeilenweise erweitert.


• Das Argument nTimes gibt die Anzahl der Zeilen an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.

• Das Argument bShiftIsDown ist ein Boolescher Wert, der angibt, ob der Inhalt ausgewählt wurde. Wenn bShiftIsDown den Wert true hat, wird Inhalt ausgewählt.

RückgabewerteKeine

dom.source.balanceBracesTextview()



400

BeschreibungBei dieser Funktion handelt es sich um eine Erweiterung der Codeansicht, die ausgeglichene Klammern ermöglicht. Sie können die Funktion dom.source.balanceBracesTextView() aufrufen, um die aktuelle Auswahl oder die aktuelle Einfü-gemarke ab dem Beginn der umgebenden, von Klammern eingeschlossenen Anweisung bis zum Ende der Anweisung zu erweitern. Auf diese Weise können die folgenden Zeichen ausgeglichen werden: [], {} und (). Bei darauf folgenden Aufrufen der Funktion wird die Auswahl durch weitere verschachtelte Interpunktionsstufen erweitert.

ArgumenteKeine

RückgabewerteKeine

dom.source.endOfDocument()


BeschreibungPlatziert die Einfügemarke in der Codeansicht am Ende des aktuellen Dokuments. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion bis zum Ende des Dokuments erweitert.

ArgumentebShiftIsDown


RückgabewerteKeine

dom.source.endOfLine()


BeschreibungPlatziert die Einfügemarke am Ende der aktuellen Zeile. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion bis zum Ende der aktuellen Zeile erweitert.



RückgabewerteKeine

dom.source.endPage()



401

BeschreibungVerschiebt die Einfügemarke an das Ende der aktuellen Seite oder an das Ende der nächsten Seite (wenn die Einfügemarke sich bereits am Seitenende befindet). Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion seitenweise erweitert.


• Das optionale Argument nTimes gibt die Anzahl der Seiten an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.


RückgabewerteKeine

dom.source.getCurrentLines()


BeschreibungGibt die Zeilennummern für die angegebenen Offset-Positionen ab dem Anfang des Dokuments zurück.

ArgumenteKeine

RückgabewerteDie Zeilennummern für die aktuelle Auswahl.

dom.source.getSelection()

BeschreibungRuft die Auswahl im aktuellen Dokument ab, ausgedrückt in Form von Zeichen-Offsets im HTML-Quellcode des Dokuments.

ArgumenteKeine

RückgabewerteZwei Ganzzahlen, die Offsets ab dem Anfang des Quelldokuments darstellen. Die erste Ganzzahl bezeichnet den Anfang der Auswahl, die zweite das Ende der Auswahl. Wenn die beiden Zahlen identisch sind, handelt es sich bei der Auswahl um eine Einfügemarke. Enthält das Quelldokument keine Auswahl, gilt für beide Zahlen der Wert –1.

dom.source.getLineFromOffset()


BeschreibungSetzt einen Offset in das Quelldokument.

ArgumenteKeine


402

RückgabewerteDie zugehörige Zeilennummer oder –1, wenn der Offset negativ ist oder über das Dateiende hinauszeigt.

dom.source.getText()


BeschreibungGibt den String zwischen den angegebenen Offsets im Quelldokument zurück.

ArgumentestartOffset, endOffset

• Das Argument startOffset ist eine Ganzzahl, die den Offset ab dem Anfang des Dokuments angibt.

• Das Argument endOffset ist eine Ganzzahl, die das Ende des Dokuments angibt.

RückgabewerteEin String mit dem Text, der im Quellcode zwischen den Offsets start und end steht.

dom.source.getValidationErrorsForOffset()


BeschreibungGibt eine Liste der Prüfungsfehler am angegebenen Offset zurück oder sucht vom Offset aus nach dem nächsten Fehler. Wenn keine gefunden werden, wird null zurückgegeben.

Argumenteoffset, {searchDirection}

• Das Argument offset ist eine Zahl, die den Offset im Code angibt, für den die Funktion Fehler zurückgibt.

• Das optionale Argument searchDirection ist ein String, der "empty", "forward" oder "back" angibt. Wenn angegeben, sucht die Funktion vom entsprechenden Offset aus rückwärts oder vorwärts bis zu den nächsten Zeichen, die Fehler aufweisen, und gibt diese zurück. Wenn nicht angegeben, sucht die Funktion nur nach Fehlern am entsprechenden Offset.

RückgabewerteEin Objekt-Array oder der Wert null. Jedes Objekt im Array hat folgende Eigenschaften:

• Das Objekt message ist ein String, der die Fehlermeldung enthält.

• Das Objekt floaterName ist ein String, der den Namen des Ergebnisfensters enthält. Sie können diesen Wert an die Funktionen showResults() oder setFloaterVisibility() übergeben.

• Das Objekt floaterIndex ist ein Index der Elemente in der Ergebnisliste für schwebende Fenster.

• Das Objekt start ist der öffnende Index des unterstrichenen Codes.

• Das Objekt end ist der schließende Index des unterstrichenen Codes.

Hinweis: Die zurückgegebenen Indizes für schwebende Fenster sollten nicht gespeichert werden, da sie sich regelmäßig ändern, beispielsweise wenn Dokumente geöffnet und geschlossen werden.

BeispielDas folgende Beispiel ruft getValidationErrorsForOffset() auf, um nach Fehlern am Offset der aktuellen Auswahl zu suchen. Wenn die Funktion einen Fehler zurückgibt, ruft der Code die Funktion alert() auf, um dem Benutzer eine Fehlermeldung anzuzeigen.


403

var offset = dw.getDocumentDOM().source.getSelection()[0];

var errors = dw.getDocumentDOM().source.getValidationErrorsForOffset(offset);

if ( errors && errors.length > 0 )

alert( errors[0].message );

dom.source.indentTextview()


BeschreibungVerschiebt den in der Codeansicht ausgewählten Text um einen Tabulatorstopp nach rechts.

ArgumenteKeine

RückgabewerteKeine

dom.source.insert()


BeschreibungFügt den angegebenen String in den Quellcode ein, und zwar am definierten Offset ab dem Anfang der Quelldatei. Wenn der Offset nicht größer oder gleich Null ist, schlägt der Einfügevorgang fehl und die Funktion gibt false zurück.

Argumenteoffset, string

• Das Argument offset ist der Offset ab dem Anfang der Datei, in die der String eingefügt werden soll.

• string ist der einzufügende String.


dom.source.nextWord()


BeschreibungVerschiebt die Einfügemarke in der Codeansicht an den Anfang des nächsten Wortes (oder der nächsten Wörter, falls angegeben). Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion nach rechts erweitert.


• Das optionale Argument nTimes gibt die Anzahl der Wörter an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.


RückgabewerteKeine


404

dom.source.outdentTextview()


BeschreibungVerschiebt den in der Codeansicht ausgewählten Text um einen Tabulatorstopp nach links.

ArgumenteKeine

RückgabewerteKeine

dom.source.pageDown()


BeschreibungVerschiebt die Einfügemarke in der Codeansicht des Dokuments seitenweise nach unten. Wenn bereits ein Bereich ausge-wählt wurde, wird die Auswahl durch diese Funktion seitenweise erweitert.




RückgabewerteKeine

dom.source.pageUp()


BeschreibungVerschiebt die Einfügemarke in der Codeansicht des Dokuments seitenweise nach oben. Wenn bereits ein Bereich ausge-wählt wurde, wird die Auswahl durch diese Funktion seitenweise erweitert.




RückgabewerteKeine


405

dom.source.previousWord()


BeschreibungVerschiebt die Einfügemarke in der Codeansicht an den Anfang des vorigen Wortes (oder der nächsten Wörter, falls angegeben). Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion nach links erweitert.


• Das optionale Argument nTimes gibt die Anzahl der Wörter an, um die die Einfügemarke bewegt werden soll. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.


RückgabewerteKeine

dom.source.replaceRange()


BeschreibungErsetzt den Textbereich, der sich in der Codeansicht zwischen startOffset und endOffset befindet, durch einen String. Wenn startOffset größer als endOffset ist oder wenn es sich bei einem der Offsets nicht um eine positive Ganzzahl handelt, hat diese Funktion keine Wirkung. In diesem Fall wird false zurückgegeben. Wenn der Wert für endOffset die Anzahl der Zeichen in der Datei übersteigt, wird der Bereich zwischen startOffset und dem Ende der Datei ersetzt. Wenn die Werte für startOffset und endOffset beide die Anzahl der Zeichen in der Datei übersteigen, wird der Text am Ende der Datei eingefügt.

ArgumentestartOffset, endOffset, string

• Das Argument startOffset ist der Offset, der den Anfang des zu ersetzenden Bereichs angibt.

• endOffset ist der Offset, der das Ende des zu ersetzenden Bereichs angibt.

• string ist der einzufügende String.


dom.source.scrollEndFile()


BeschreibungFührt in der Codeansicht einen Bildlauf zum Ende des Dokuments aus, ohne dabei die Einfügemarke zu verschieben.

ArgumenteKeine


406

RückgabewerteKeine

dom.source.scrollLineDown()


BeschreibungFührt in der Codeansicht zeilenweise einen Bildlauf nach unten aus, ohne dabei die Einfügemarke zu verschieben.

ArgumentenTimes

• Das Argument nTimes gibt die Anzahl der Zeilen für den Bildlauf an. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.

RückgabewerteKeine

dom.source.scrollLineUp()


BeschreibungFührt in der Codeansicht zeilenweise einen Bildlauf nach oben aus, ohne dabei die Einfügemarke zu verschieben.

ArgumentenTimes

• Das Argument nTimes gibt die Anzahl der Zeilen für den Bildlauf an. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.

RückgabewerteKeine

dom.source.scrollPageDown()


BeschreibungFührt in der Codeansicht seitenweise einen Bildlauf nach unten aus, ohne dabei die Einfügemarke zu verschieben.

ArgumentenTimes

• Das Argument nTimes gibt die Anzahl der Seiten für den Bildlauf an. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.

RückgabewerteKeine


407

dom.source.scrollPageUp()


BeschreibungFührt in der Codeansicht seitenweise einen Bildlauf nach oben aus, ohne dabei die Einfügemarke zu verschieben.

ArgumentenTimes

• Das Argument nTimes gibt die Anzahl der Seiten für den Bildlauf an. Wenn nTimes nicht angegeben wird, gilt der Standardwert 1.

RückgabewerteKeine

dom.source.scrollTopFile()


BeschreibungFührt in der Codeansicht einen Bildlauf zum Anfang des Dokuments aus, ohne dabei die Einfügemarke zu verschieben.

ArgumenteKeine

RückgabewerteKeine

dom.source.selectParentTag()


BeschreibungBei dieser Funktion handelt es sich um eine Erweiterung der Codeansicht, die ausgeglichene Tags ermöglicht. Sie können die Funktion dom.source.selectParentTag() aufrufen, um die aktuelle Auswahl oder die aktuelle Einfügemarke ab dem umgebenden Anfangs-Tag bis zum Schluss-Tag zu erweitern. Bei darauffolgenden Aufrufen der Funktion wird die Auswahl bis zu weiteren umgebenden Tags erweitert, bis keine umschließenden Tags mehr vorhanden sind.

ArgumenteKeine

RückgabewerteKeine

dom.source.setCurrentLine()



408

BeschreibungPlatziert die Einfügemarke am Anfang der angegebenen Zeile. Wenn das Argument lineNumber keine positive Ganzzahl ist, gibt die Funktion den Wert false zurück. Die Funktion ist in diesem Fall wirkungslos. Wenn der Wert für lineNumber die Anzahl der Zeilen im Quelldokument übersteigt, wird die Einfügemarke am Anfang der letzten Zeile platziert.

ArgumentelineNumber

• Das Argument lineNumber ist die Zeile, an deren Anfang die Einfügemarke platziert wird.


dom.source.startOfDocument()


BeschreibungPlatziert die Einfügemarke in der Codeansicht am Anfang des Dokuments. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion bis zum Anfang des Dokuments erweitert.



RückgabewerteKeine

dom.source.startOfLine()


BeschreibungPlatziert die Einfügemarke am Anfang der aktuellen Zeile. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion bis zum Anfang der aktuellen Zeile erweitert.



RückgabewerteKeine

dom.source.topPage()



409

BeschreibungVerschiebt die Einfügemarke an den Anfang der aktuellen Seite oder an den Anfang der vorherigen Seite, wenn die Einfü-gemarke sich bereits am Anfang einer Seite befindet. Wenn bereits ein Bereich ausgewählt wurde, wird die Auswahl durch diese Funktion seitenweise erweitert.




RückgabewerteKeine

dom.source.wrapSelection()


BeschreibungFügt den Text für startTag vor der aktuellen Auswahl und den Text für endTag nach der aktuellen Auswahl ein. Die Funktion wählt dann den gesamten Bereich zwischen den eingefügten Tags aus, die Tags eingeschlossen. Wenn es sich bei der aktuellen Auswahl um eine Einfügemarke handelt, platziert die Funktion die Einfügemarke zwischen startTag und endTag. (startTag und endTag müssen nicht unbedingt Tags sein, es kann sich um jeden beliebigen Text handeln.)

ArgumentestartTag, endTag

• Das Argument startTag ist der Text, der am Anfang der Auswahl eingefügt werden soll.

• endTag ist der Text, der am Ende der Auswahl eingefügt werden soll.

RückgabewerteKeine

dom.synchronizeDocument()


BeschreibungSynchronisiert die Entwurfs- und Codeansicht.

ArgumenteKeine

RückgabewerteKeine


410

Tag-Editor- und Tag-Bibliothek-FunktionenMit Tag-Editoren können Sie neue Tags einfügen, vorhandene Tags bearbeiten und auf Referenzinformationen zu Tags zugreifen. Mit der Tag-Auswahl können Benutzer ihre Tags anordnen, um häufig verwendete Tags schneller auswählen zu können. Die im Lieferumfang von Dreamweaver enthaltenen Tag-Bibliotheken speichern Informationen über Tags, die in standardisierten Markup-Sprachen und den am meisten verbreiteten Tag-basierten Skriptsprachen verwendet werden. Die JavaScript-Tag-Editor-, Tag-Auswahl- und Tag-Bibliothek-Funktionen verwenden Sie, wenn Sie in Ihren Erweiterungen auf Tag-Editoren und Tag-Bibliotheken zugreifen oder damit arbeiten müssen.

dom.getTagSelectorTag()


BeschreibungDiese Funktion gibt den DOM-Knoten für das Tag zurück, das derzeit in der Tag-Selektorleiste am unteren Rand des Dokumentfensters ausgewählt ist.

ArgumenteKeine

RückgabewerteDer DOM-Knoten für das derzeit ausgewählte Tag; null, wenn kein Tag ausgewählt ist.

dreamweaver.popupInsertTagDialog()


BeschreibungDiese Funktion überprüft die VTM-Dateien, um festzustellen, ob ein Tag-Editor für das Tag definiert wurde. Ist dies der Fall, wird der Editor für dieses Tag eingeblendet, der das Start-Tag übernimmt. Andernfalls wird das Start-Tag unverändert in das Benutzerdokument eingefügt.

Argumentestart_tag_string

Ein String für das Start-Tag, der einen der folgenden Anfangswerte enthält:

• Ein Tag, wie beispielsweise <input>

• Ein Tag mit Attributen, wie <input type='text'>

• Eine Direktive, wie <%= %>.

RückgabewerteEin Boolescher Wert: true, wenn etwas in das Dokument eingefügt wird; false, falls dies nicht zutrifft.

dreamweaver.popupEditTagDialog()


BeschreibungIst ein Tag ausgewählt, öffnet diese Funktion den entsprechenden Tag-Editor, sodass Sie das Tag bearbeiten können.


411

ArgumenteKeine

RückgabewerteKeine

EnablerWeitere Informationen finden Sie unter „dreamweaver.canPopupEditTagDialog()“ auf Seite 428.

dreamweaver.showTagChooser()


BeschreibungDiese Funktion zeigt das Dialogfeld Tag-Auswahl im Vordergrund an und aktiviert es.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.showTagLibraryEditor()


BeschreibungDiese Funktion öffnet den Tag-Bibliothek-Editor.

ArgumenteKeine

RückgabewerteKeine

dreamweaver.tagLibrary.getTagLibraryDOM()


BeschreibungMit der URL einer Datei des Typs Dateiname.vtm als Argument gibt diese Funktion das DOM für diese Datei zurück, sodass ihr Inhalt bearbeitet werden kann. Diese Funktion sollte nur aufgerufen werden, wenn der Tag-Bibliothek-Editor aktiv ist.

ArgumentefileURL

• Das Argument fileURL ist die URL einer Datei des Typs Dateiname.vtm , relativ zum Ordner Configuration\Tag Libraries, wie im folgenden Beispiel dargestellt: "HTML/img.vtm"

RückgabewerteEin DOM-Zeiger auf eine neue oder bereits vorhandene Datei im Ordner TagLibraries.


412

dreamweaver.tagLibrary.getSelectedLibrary()


BeschreibungIst im Tag-Bibliothek-Editor ein Bibliotheksknoten ausgewählt, gibt diese Funktion den Bibliotheksnamen zurück.

ArgumenteKeine

RückgabewerteEin String mit dem Namen der Bibliothek, die im Tag-Bibliothek-Editor derzeit ausgewählt ist; wenn keine Bibliothek ausgewählt ist, wird ein leerer String zurückgegeben.

dreamweaver.tagLibrary.getSelectedTag()


BeschreibungIst derzeit ein Attributknoten ausgewählt, gibt diese Funktion den Namen des Tags zurück, das das Attribut enthält.

ArgumenteKeine

RückgabewerteEin String mit dem Namen des Tags, das im Tag-Bibliothek-Editor derzeit ausgewählt ist; wenn kein Tag ausgewählt ist, wird ein leerer String zurückgegeben.

dreamweaver.tagLibrary.importDTDOrSchema()


BeschreibungDiese Funktion importiert eine DTD-Datei oder eine Schemadatei von einem entfernten Server in die Tag-Bibliothek.

ArgumentefileURL, Prefix

• Das Argument fileURL ist der Pfad zur DTD- oder Schemadatei im lokalen URLFormat.

• Das Argument Prefix ist der Präfix-String, der allen Tags in dieser Tag-Bibliothek hinzugefügt wird.

RückgabewerteName der importierten Tag-Bibliothek.

dreamweaver.tagLibrary.getImportedTagList()


BeschreibungDiese Funktion generiert eine Liste mit taginfo-Objekten aus einer importierten Tag-Bibliothek.


413

Argumentelibname

• Das Argument libname ist der Name der importierten Tag-Bibliothek.

RückgabewerteArray von tagInfo-Objekten.

Ein taginfo-Objekt enthält Informationen über ein einzelnes Tag, das in der Tag-Bibliothek enthalten ist. In einem tagInfo-Objekt sind die folgenden Eigenschaften definiert:

• Die Eigenschaft tagName, wobei es sich um einen String handelt.

• Die Eigenschaft attributes, wobei es sich um ein Array von Strings handelt. Jeder String enthält den Namen eines Attributs, das für dieses Tag definiert ist.

Beispiel:Im folgenden Beispiel wird dargestellt, wie durch Verwendung der Funktion dw.tagLibrary.getImportedTagList() ein Tag-Array aus der Bibliothek libName abgerufen wird:

// "fileURL" und "prefix" wurden vom Benutzer eingegeben

// Tag-Bibliothek anweisen, DTD/Schema zu importieren

var libName = dw.tagLibrary.importDTDOrSchema(fileURL, prefix);

// Tag-Array für diese Bibliothek abrufen

// dies ist das Objekt 'TagInfo'

var tagArray = dw.tagLibrary.getImportedTagList(libName);

// Jetzt liegt ein Array von tagInfo-Objekten vor,

// aus denen Informationen abgerufen werden können. Diese Information stammt aus dem ersten Objekt.

// Hinweis: Es wird davon ausgegangen, dass sich im Array mindestens ein TagInfo befindet.

var firstTagName = tagArray[0].name;

var firstTagAttributes = tagArray[0].attributes;

// Zu beachten ist, dass firstTagAttributes ein Array von Attributen ist.


414

415

Kapitel 19: Enabler

Die Enabler-Funktionen von Adobe® Dreamweaver® CS3 legen fest, ob eine andere Funktion im aktuellen Kontext eine bestimmte Operation durchführen kann. In den Funktionsbeschreibungen werden die allgemeinen Bedingungen erläutert, unter denen die jeweilige Funktion den Wert true zurückgibt. Die Beschreibungen sind jedoch nicht als vollständig anzusehen, und bestimmte Fälle, in denen die betreffende Funktion den Wert false zurückgibt, sind eventuell nicht erfasst.

Enabler-FunktionenDie Enabler-Funktionen in der JavaScript-API umfassen die folgenden Funktionen.

dom.canAlign()


BeschreibungÜberprüft, ob die Vorgänge Linksbündig, Rechtsbündig, Oben ausrichten bzw. Unten ausrichten ausgeführt werden können.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob zwei oder mehr Ebenen oder Hotspots ausgewählt sind.

dom.canApplyTemplate()


BeschreibungÜberprüft, ob der Vorgang Auf Seite anwenden ausgeführt werden kann. Diese Funktion ist nur für das aktive Dokument gültig.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob es sich beim Dokument nicht um ein Bibliothekselement oder eine Vorlage handelt und ob die Auswahl sich nicht innerhalb des NOFRAMES-Tags befindet.

dom.canArrange()


BeschreibungÜberprüft, ob der Vorgang In Vordergrund stellen bzw. In den Hintergrund verschieben ausgeführt werden kann.


416

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob ein Hotspot ausgewählt ist.

dom.canClipCopyText()


BeschreibungÜberprüft, ob der Vorgang Als Text kopieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die öffnenden und schließenden Offsets der Auswahl unterscheiden, andernfalls false, um anzugeben, dass nichts ausgewählt wurde.

dom.canClipPaste()


BeschreibungÜberprüft, ob der Vorgang Kopieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Zwischenablage Elemente enthält, die in Dreamweaver eingefügt werden können, andernfalls false.

dom.canClipPasteText()


BeschreibungÜberprüft, ob der Vorgang Als Text einfügen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Zwischenablage Inhalt enthält, der in Dreamweaver eingefügt werden kann, andern-falls false.


417

dom.canConvertLayersToTable()


BeschreibungÜberprüft, ob der Vorgang Ebenen in Tabellen konvertieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich der gesamte Inhalt im Abschnitt BODY des Dokuments in Ebenen befindet, andern-falls false.

dom.canConvertTablesToLayers()


BeschreibungÜberprüft, ob der Vorgang Tabellen in Ebenen konvertieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich der gesamte Inhalt des Abschnitts BODY des Dokuments in Tabellen befindet und das Dokument nicht auf einer Vorlage basiert, andernfalls false.

dom.canDecreaseColspan()


BeschreibungÜberprüft, ob der Vorgang Spaltenbreite verringern ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die aktuelle Zelle über das Attribut COLSPAN verfügt und der Wert dieses Attributs größer oder gleich 2 ist, andernfalls false.

dom.canDecreaseRowspan()


BeschreibungÜberprüft, ob der Vorgang Zeilenbreite verringern ausgeführt werden kann.


418

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die aktuelle Zelle über das Attribut ROWSPAN verfügt und der Wert dieses Attributs größer oder gleich 2 ist, andernfalls false.

dom.canDeleteTableColumn()


BeschreibungÜberprüft, ob der Vorgang Spalte löschen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Einfügemarke sich in einer Zelle befindet oder wenn die Zelle bzw. Spalte ausgewählt ist, andernfalls false.

dom.canDeleteTableRow()


BeschreibungÜberprüft, ob der Vorgang Zeile löschen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Einfügemarke sich in einer Zelle befindet oder wenn die Zelle bzw. Zeile ausgewählt ist, andernfalls false.

site.canEditColumns()

BeschreibungPrüft, ob eine Site vorhanden ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn eine Site vorhanden ist, andernfalls false.


419

dom.canEditNoFramesContent()


BeschreibungÜberprüft, ob der Vorgang NoFrames-Inhalt bearbeiten ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn es sich bei dem aktuellen Dokument um ein Frameset handelt oder es sich in einem Frameset befindet, andernfalls false.

dom.canIncreaseColspan()


BeschreibungÜberprüft, ob der Vorgang Spaltenbreite erhöhen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich Zellen rechts neben der aktuellen Zelle befinden, andernfalls false.

dom.canIncreaseRowspan()


BeschreibungÜberprüft, ob der Vorgang Zeilenbreite erhöhen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich Zellen unterhalb der aktuellen Zelle befinden, andernfalls false.

dom.canInsertTableColumns()


BeschreibungÜberprüft, ob der Vorgang Spalten einfügen ausgeführt werden kann.

ArgumenteKeine


420

RückgabewerteEin Boolescher Wert: true, wenn sich die Auswahl innerhalb einer Tabelle befindet; false, wenn es sich bei der Auswahl um eine vollständige Tabelle handelt oder die Auswahl sich nicht in einer Tabelle befindet.

dom.canInsertTableRows()


BeschreibungÜberprüft, ob der Vorgang Zeilen einfügen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die Auswahl innerhalb einer Tabelle befindet; false, wenn es sich bei der Auswahl um eine vollständige Tabelle handelt oder die Auswahl sich nicht in einer Tabelle befindet.

dom.canMakeNewEditableRegion()


BeschreibungÜberprüft, ob der Vorgang Neuer bearbeitbarer Bereich ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn es sich beim aktuellen Dokument um eine Vorlage handelt (DWT-Datei).

dom.canMarkSelectionAsEditable()


BeschreibungÜberprüft, ob der Vorgang Auswahl bearbeitbar machen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn eine Auswahl vorhanden ist und das aktuelle Dokument eine DWT-Datei ist, andernfalls false.


421

dom.canMergeTableCells()


BeschreibungÜberprüft, ob der Vorgang Zellen verbinden ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn es sich bei der Auswahl um eine Gruppe benachbarter Zellen handelt, andernfalls false.

dom.canPlayPlugin()


BeschreibungÜberprüft, ob der Vorgang Abspielen ausgeführt werden kann. Diese Funktion ist nur für das aktive Dokument gültig.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Auswahl mit einem Plug-In wiedergegeben werden kann.

dom.canRedo()


BeschreibungÜberprüft, ob der Vorgang Wiederherstellen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Schritte wiederhergestellt werden müssen, andernfalls false.

dom.canRemoveEditableRegion()


BeschreibungÜberprüft, ob der Vorgang Markierung als bearbeitbaren Bereich aufheben ausgeführt werden kann.

ArgumenteKeine


422

RückgabewerteEin Boolescher Wert: true, wenn es sich beim aktuellen Dokument um eine Vorlage handelt, andernfalls false.

dom.canSelectTable()


BeschreibungÜberprüft, ob der Vorgang Tabelle auswählen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die Einfügemarke oder die Auswahl innerhalb einer Tabelle befindet, andernfalls false.

dom.canSetLinkHref()


BeschreibungÜberprüft, ob der Hyperlink um die aktuelle Auswahl geändert oder gegebenenfalls ein Hyperlink erstellt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn es sich bei der Auswahl um ein Bild oder Text handelt, oder wenn sich die Einfügemarke in einem Hyperlink befindet, andernfalls false. Für eine Textauswahl wird der Eigenschafteninspektor für Text angezeigt.

dom.canShowListPropertiesDialog()


BeschreibungBestimmt, ob das Dialogfeld Listeneigenschaften angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die Auswahl innerhalb eines LI-Tags befindet, andernfalls false.


423

dom.canSplitFrame()


BeschreibungÜberprüft, ob der Vorgang Frame links teilen (bzw. rechts, oben oder unten teilen) ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die Auswahl in einem Frame befindet, andernfalls false.

dom.canSplitTableCell()


BeschreibungÜberprüft, ob der Vorgang Zelle teilen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Einfügemarke sich in einer Tabellenzelle befindet oder wenn die Auswahl eine Tabel-lenzelle ist, andernfalls false.

dom.canStopPlugin()


BeschreibungÜberprüft, ob der Vorgang Stopp ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Auswahl zurzeit mit einem Plug-In wiedergegeben wird, andernfalls false.

dom.canUndo()


BeschreibungÜberprüft, ob der Vorgang Rückgängig ausgeführt werden kann.

ArgumenteKeine


424

RückgabewerteEin Boolescher Wert: true, wenn Schritte wiederhergestellt werden müssen, andernfalls false.

dom.hasTracingImage()


BeschreibungÜberprüft, ob das Dokument ein Tracing-Bild enthält.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Dokument über ein Tracing-Bild verfügt, andernfalls false.

dreamweaver.assetPalette.canEdit()


BeschreibungAktiviert die Menüeinträge im Bedienfeld Elemente zur Bearbeitung.

ArgumenteKeine

RückgabewerteGibt einen Booleschen Wert zurück: true, wenn das Element bearbeitet werden kann, andernfalls false. Für Farben und URLs in der Siteliste wird false zurückgegeben. Für mehrere ausgewählte Farben und URLs in der Favoritenliste wird ebenfalls false zurückgegeben.

dreamweaver.assetPalette.canInsertOrApply()


BeschreibungBestimmt, ob die ausgewählten Elemente eingefügt oder angewendet werden können. Gibt true oder false zurück, sodass die Menüeinträge zum Einfügen oder Anwenden aktiviert oder deaktiviert werden können.

ArgumenteKeine

RückgabewerteGibt einen Booleschen Wert zurück: true, wenn die ausgewählten Elemente eingefügt oder angewendet werden können; false, wenn es sich bei der aktuellen Seite um eine Vorlage handelt und die aktuelle Kategorie Vorlagen lautet. Die Funktion gibt auch dann den Wert false zurück, wenn kein Dokument geöffnet ist oder wenn ein Bibliothekselement im Dokument ausgewählt ist und die aktuelle Kategorie Bibliothek lautet.


425

dreamweaver.canClipCopy()



ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Inhalt ausgewählt ist, der in die Zwischenablage kopiert werden kann, andernfalls false.

dreamweaver.canClipCut()


BeschreibungÜberprüft, ob der Vorgang Ausschneiden ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Inhalt ausgewählt ist, der ausgeschnitten und in die Zwischenablage eingefügt werden kann, andernfalls false.

dreamweaver.canClipPaste()



ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Zwischenablage Inhalt enthält, der in das aktuelle Dokument oder in das aktive Fenster des Bedienfelds Site eingefügt werden kann (beim Macintosh ein Textfeld in einem schwebenden Bedienfeld oder Dialogfeld), andernfalls false.

dreamweaver.canDeleteSelection()


BeschreibungÜberprüft, ob die aktuelle Auswahl gelöscht werden kann. Je nachdem, auf welchem Fenster sich der Fokus befindet, findet der Löschvorgang im Dokumentfenster oder im Bedienfeld Site bzw. beim Macintosh in einem Textfeld eines Dialogfelds oder eines schwebenden Bedienfelds statt.


426

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die öffnenden und schließenden Offsets für die Auswahl unterscheiden, was auf eine Auswahl hinweist; false, wenn die Offsets identisch sind, was darauf hinweist, dass nur eine Einfügemarke vorhanden ist.

dreamweaver.canExportCSS() (veraltet)


BeschreibungÜberprüft, ob der Vorgang CSS-Stile exportieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Dokument Class-Stile enthält, die im HEAD-Abschnitt definiert sind, andernfalls false.

dreamweaver.canExportTemplateDataAsXML()


BeschreibungÜberprüft, ob Dreamweaver das aktuelle Dokument als XML exportieren kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn für das aktuelle Dokument ein Exportvorgang ausgeführt werden kann; false, falls dies nicht zutrifft.

Beispiel Im folgenden Beispiel wird dw.canExportTemplateDataAsXML() aufgerufen, um festzustellen, ob Dreamweaver das aktuelle Dokument im XML-Format exportieren kann; bei der Rückgabe von true wird dw.ExportTemplateDataAsXML() zum Exportieren aufgerufen:

if(dreamweaver.canExportTemplateDataAsXML())

{

dreamweaver.exportTemplateDataAsXML("file:///c|/dw_temps/mytemplate.txt")}

dreamweaver.canFindNext()


BeschreibungÜberprüft, ob der Vorgang Weitersuchen ausgeführt werden kann.


427

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn bereits ein Suchmuster festgelegt wurde, andernfalls false.

dreamweaver.canFitSelection()


BeschreibungÜberprüft, ob einer aktiven Entwurfsansicht etwas ausgewählt worden ist, was bedeutet, dass fitSelection() aufgerufen werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn in einer aktiven Entwurfsansicht etwas ausgewählt worden ist, andernfalls false.

dreamweaver.canOpenInFrame()


BeschreibungÜberprüft, ob der Vorgang Öffnen in Frame ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich die Auswahl oder Einfügemarke in einem Frame befindet, andernfalls false.

dreamweaver.canPasteSpecial()


BeschreibungÜberprüft, ob der Vorgang Inhalte einfügen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn sich in der Zwischenablage Text, HTML-Code oder Dreamweaver-HTML-Code befindet und sich der Fokus auf der Codeansicht, Entwurfsansicht oder dem Codeinspektor befindet, andernfalls false.


428

dreamweaver.canPlayRecordedCommand()


BeschreibungÜberprüft, ob der Vorgang Aufgezeichneten Befehl abspielen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn ein aktives Dokument und ein zuvor aufgezeichneter Befehl, der wiedergegeben werden kann, vorhanden sind, andernfalls false.

dreamweaver.canPopupEditTagDialog()


BeschreibungÜberprüft, ob es sich bei der aktuellen Auswahl um ein Tag handelt und ob das Menü Tag bearbeiten aktiv ist.

ArgumenteKeine

RückgabewerteDer Name des gerade ausgewählten Tags oder null, wenn kein Tag ausgewählt ist.

dreamweaver.canRedo()


BeschreibungÜberprüft, ob der Vorgang Wiederherstellen im aktuellen Kontext ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob Vorgänge rückgängig gemacht werden können.

dreamweaver.canRevertDocument()


BeschreibungÜberprüft, ob der Vorgang Wiederherstellen (der zuletzt gespeicherten Version) ausgeführt werden kann.


429


• Das Argument documentObject ist das Objekt am Stamm der DOM-Struktur eines Dokuments (der von dream-weaver.getDocumentDOM() zurückgegebene Wert).

RückgabewerteEin Boolescher Wert, der angibt, ob das Dokument ungespeichert ist und ob eine gespeicherte Version des Dokuments auf einem lokalen Laufwerk vorhanden ist.

dreamweaver.canSaveAll()


BeschreibungÜberprüft, ob der Vorgang Alles speichern ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob ungespeicherte Dokumente geöffnet sind.

dreamweaver.canSaveDocument()


BeschreibungÜberprüft, ob beim angegebenen Dokument der Vorgang Speichern ausgeführt werden kann.


• Das Argument documentObject ist der Stamm der DOM-Struktur eines Dokuments (der von dreamweaver.getDocu-mentDOM() zurückgegebene Wert).

RückgabewerteEin Boolescher Wert, der angibt, ob das Dokument ungespeicherte Änderungen enthält.

dreamweaver.canSaveDocumentAsTemplate()


BeschreibungÜberprüft, ob beim angegebenen Dokument der Vorgang Als Vorlage speichern ausgeführt werden kann.



RückgabewerteEin Boolescher Wert, der angibt, ob das Dokument als Vorlage gespeichert werden kann.


430

dreamweaver.canSaveFrameset()


BeschreibungÜberprüft, ob beim angegebenen Dokument der Vorgang Frameset speichern ausgeführt werden kann.



RückgabewerteEin Boolescher Wert, der angibt, ob es sich bei dem Dokument um ein Frameset mit ungespeicherten Änderungen handelt.

dreamweaver.canSaveFramesetAs()


BeschreibungÜberprüft, ob beim angegebenen Dokument der Vorgang Frameset speichern unter ausgeführt werden kann.



RückgabewerteEin Boolescher Wert, der angibt, ob es sich beim aktuellen Dokument um ein Frameset handelt.

dreamweaver.canSelectAll()


BeschreibungÜberprüft, ob der Vorgang Alles auswählen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob der Vorgang Alles auswählen ausgeführt werden kann.

dreamweaver.canShowFindDialog()


BeschreibungÜberprüft, ob der Vorgang Suchen ausgeführt werden kann.


431

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der true ist, wenn ein Bedienfeld Site oder ein Dokumentfenster geöffnet ist. Diese Funktion gibt den Wert false zurück, wenn sich die Auswahl im Bereich HEAD befindet.

dreamweaver.canUndo()


BeschreibungÜberprüft, ob der Vorgang Rückgängig im aktuellen Kontext ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob Vorgänge rückgängig gemacht werden können.

dreamweaver.canZoom()


BeschreibungPrüft, ob eine Entwurfsansicht aktiv ist, was bedeutet, dass grundlegende Vergrößerungsbefehle angewendet werden können.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn eine Entwurfsansicht aktiv ist, andernfalls false.

dreamweaver.cssRuleTracker.canEditSelectedRule()


BeschreibungÜberprüft, ob der Eigenschaftenraster-Editor auf die ausgewählte Regel angewendet werden kann. Da das Eigenschaften-raster Regeln in gesperrten Dateien anzeigen kann, gewährleistet der Rückgabewert true nicht, dass die Regel geändert werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Eigenschaftenraster-Editor auf die ausgewählte Regel angewendet werden kann, andernfalls false.


432

Beispiel Der folgende Code überprüft, ob die Enabler-Funktion auf den Wert true gesetzt wurde, bevor die Bearbeitung der ausge-wählten Regel zugelassen wird:

if(dw.cssRuleTracker.canEditSelectedRule()){

dw.cssRuleTracker.editSelectedRule();

}

dreamweaver.cssStylePalette.canApplySelectedStyle()


BeschreibungÜberprüft das aktuelle Dokument, um zu ermitteln, ob der ausgewählte Stil angewendet werden kann.

Argumente{ pane }


RückgabewerteEin Boolescher Wert: true, wenn der ausgewählte Stil einen Class-Selektor hat, andernfalls false.

dreamweaver.cssStylePalette.canDeleteSelectedStyle()


BeschreibungÜberprüft die aktuelle Auswahl, um zu ermitteln, ob der ausgewählte Stil gelöscht werden kann.

Argumente{ pane }


RückgabewerteEin Boolescher Wert: true, wenn die Auswahl gelöscht werden kann, andernfalls false.

dreamweaver.cssStylePalette.canDuplicateSelectedStyle()


BeschreibungÜberprüft das aktuelle Dokument, um zu ermitteln, ob der ausgewählte Stil dupliziert werden kann.


433

Argumente{ pane }


RückgabewerteEin Boolescher Wert: true, wenn der ausgewählte Stil dupliziert werden kann, andernfalls false.

dreamweaver.cssStylePalette.canEditSelectedStyle()


BeschreibungÜberprüft das aktuelle Dokument, um zu ermitteln, ob der ausgewählte Stil bearbeitet werden kann.

Argumente{ pane }


RückgabewerteEin Boolescher Wert: true, wenn der ausgewählte Stil bearbeitet werden kann, andernfalls false.

dreamweaver.cssStylePalette.canEditSelectedStyleInCodeview()


BeschreibungÜberprüft das aktuelle Dokument, um zu ermitteln, ob der ausgewählte Stil in der Codeansicht bearbeitet werden kann.

Argumente{ pane }


RückgabewerteEin Boolescher Wert: true, wenn der ausgewählte Stil bearbeitet werden kann, andernfalls false.


434

dreamweaver.cssStylePalette.canEditStyleSheet()


BeschreibungÜberprüft das aktuelle Dokument, um zu ermitteln, ob es Stylesheet-Elemente enthält, die bearbeitet werden können.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true wenn es sich bei der Auswahl um einen Stylesheet-Knoten oder eine Stildefinition innerhalb eines Stylesheet-Knotens handelt und das Stylesheet weder versteckt noch dieses Dokument ist; false, wenn die Auswahl versteckt ist oder es sich um dieses Dokument handelt.

dreamweaver.cssStylePalette.canRenameSelectedStyle()


BeschreibungÜberprüft das aktuelle Dokument, um zu ermitteln, ob der ausgewählte Stil umbenannt werden kann.

Argumente{ pane }


RückgabewerteEin Boolescher Wert: true, wenn der ausgewählte Stil umbenannt werden kann, andernfalls false.

dreamweaver.isRecording()


BeschreibungBestimmt, ob gerade ein Befehl aufgezeichnet wird.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob ein Befehl aufgezeichnet wird.


435

dreamweaver.htmlStylePalette.canEditSelection()


BeschreibungÜberprüft, ob die Auswahl im Bedienfeld HTML-Stile bearbeitet, gelöscht oder dupliziert werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Dreamweaver die Auswahl im Bedienfeld HTML-Stile bearbeiten, löschen oder dupli-zieren kann; false, wenn kein Stil oder einer der Lösch-Stile ausgewählt ist.

dreamweaver.resultsPalette.canClear()


BeschreibungÜberprüft, ob der Inhalt des Bedienfelds Ergebnisse gelöscht werden kann, das gerade aktiv ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Inhalt gelöscht werden kann, andernfalls false.

dreamweaver.resultsPalette.canCopy()


BeschreibungÜberprüft, ob das aktuelle Ergebnisfenster eine kopierte Meldung als Inhalt anzeigen kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn der Inhalt angezeigt werden kann, andernfalls false.

dreamweaver.resultsPalette.canCut()


BeschreibungÜberprüft, ob das aktuelle Ergebnisfenster eine „Ausgeschnitten“-Meldung als Inhalt anzeigen kann.

ArgumenteKeine


436


dreamweaver.resultsPalette.canPaste()


BeschreibungÜberprüft, ob das aktuelle Ergebnisfenster eine „Eingefügt“-Meldung als Inhalt anzeigen kann.

ArgumenteKeine


dreamweaver.resultsPalette.canOpenInBrowser()


BeschreibungÜberprüft, ob der aktuelle Bericht in einem Browser angezeigt werden kann.

ArgumenteKeine


dreamweaver.resultsPalette.canOpenInEditor()


BeschreibungÜberprüft, ob der aktuelle Bericht in einem Editor angezeigt werden kann.

ArgumenteKeine


dreamweaver.resultsPalette.canSave()


BeschreibungÜberprüft, ob für das aktuelle Bedienfeld das Dialogfeld Speichern aufgerufen werden kann. Derzeit unterstützen die Bedienfelder Site-Berichte, Zielbrowser-Prüfung, Überprüfung und Hyperlink-Prüfer das Dialogfeld Speichern.


437

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Dialogfeld Speichern angezeigt werden kann, andernfalls false.

dreamweaver.resultsPalette.canSelectAll()


BeschreibungÜberprüft, ob die Nachricht Alles auswählen an das Fenster im Fokus gesendet wird.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Nachricht Alles auswählen gesendet werden kann, andernfalls false.

dreamweaver.siteSyncDialog.canCompare()


BeschreibungDiese Funktion prüft, ob das Kontextmenü Compare (Vergleichen) im Dialogfeld Site Synchronize (Site-Synchroni-sation) angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Kontextmenü Compare (Vergleichen) im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann, andernfalls false.

dreamweaver.siteSyncDialog.canMarkDelete()


BeschreibungDiese Funktion prüft, ob das Kontextmenü Aktion in Löschen ändern im Dialogfeld Site Synchronize (Site-Synchroni-sation) angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Kontextmenü Aktion in Löschen ändern im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann, andernfalls false.


438

dreamweaver.siteSyncDialog.canMarkGet()


BeschreibungDiese Funktion prüft, ob das Kontextmenü Aktion in Abrufen ändern im Dialogfeld Site Synchronize (Site-Synchroni-sation) angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Kontextmenü Aktion in Abrufen ändern im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann, andernfalls false.

dreamweaver.siteSyncDialog.canMarkIgnore()


BeschreibungDiese Funktion prüft, ob das Kontextmenü Change Action to Ignore (Aktion in Ignorieren ändern) im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Kontextmenü Change Action to Ignore (Aktion in Ignorieren ändern) im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann, andernfalls false.

dreamweaver.siteSyncDialog.canMarkPut()


BeschreibungDiese Funktion prüft, ob das Kontextmenü Aktion in Bereitstellen ändern im Dialogfeld Site Synchronize (Site-Synchro-nisation) angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Kontextmenü Aktion in Bereitstellen ändern im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann, andernfalls false.


439

dreamweaver.siteSyncDialog.canMarkSynced()


BeschreibungDiese Funktion prüft, ob das Kontextmenü Change Action to Synced (Aktion in Synchronisiert ändern) im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Kontextmenü Change Action to Synchronisiert (Aktion in Synchronisiert ändern) im Dialogfeld Site Synchronize (Site-Synchronisation) angezeigt werden kann, andernfalls false.

dreamweaver.snippetpalette.canEditSnippet()


BeschreibungÜberprüft, ob Sie das gerade ausgewählte Element bearbeiten können, und gibt true bzw. false zurück, sodass Sie Menüelemente zum Bearbeiten aktivieren oder deaktivieren können.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Sie das gerade ausgewählte Element bearbeiten können, andernfalls false.

dreamweaver.snippetpalette.canInsert()


BeschreibungÜberprüft, ob Sie das ausgewählte Element einfügen oder anwenden können, und gibt true bzw. false zurück, sodass Sie Menüelemente zum Einfügen oder Anwenden aktivieren oder deaktivieren können.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Sie das gerade ausgewählte Element einfügen oder anwenden können, andernfalls false.

site.browseDocument()


BeschreibungÖffnet alle ausgewählten Dokumente in einem Browserfenster. Dies ist mit dem Befehl Vorschau im Browser identisch.


440

ArgumentebrowserName

• Das Argument browserName ist der Name des Browsers, wie in den Voreinstellungen für Vorschau in Browser definiert. Wenn dieses Argument ausgelassen wird, wird standardmäßig der Primärbrowser verwendet.

RückgabewerteKeine

site.canAddLink()


BeschreibungÜberprüft, ob der Vorgang Mit [vorhandener / neuer] Datei verknüpfen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das ausgewählte Dokument in der Sitemap eine HTML-Datei ist, andernfalls false.

site.canChangeLink()


BeschreibungÜberprüft, ob der Vorgang Hyperlink ändern ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn eine HTML- oder Flash-Datei mit der ausgewählten Datei in der Sitemap verknüpft ist, andernfalls false.

site.canCheckIn()


BeschreibungÜberprüft, ob der Vorgang Einchecken ausgeführt werden kann.

ArgumentesiteOrURL

• Das Argument siteOrURL muss das Schlüsselwort site sein, damit die Funktion sich auf die Auswahl im Bedienfeld Site auswirkt, oder eine URL, wenn es sich um eine einzelne Datei handelt.


441

RückgabewerteEin Boolescher Wert: true, wenn die folgenden Bedingungen zutreffen, andernfalls false:

• Eine entfernte Site ist definiert.

• Falls sich der Fokus auf einem Dokumentfenster befindet: ob die Datei in der lokalen Site gespeichert wurde. Falls sich der Fokus auf dem Bedienfeld Site befindet: ob Dateien bzw. Ordner ausgewählt sind.

• Die Funktion Einchecken/Auschecken ist für die Site deaktiviert.

site.canCheckOut()


BeschreibungBestimmt, ob für die angegebenen Dateien der Vorgang Auschecken ausgeführt werden kann.

ArgumentesiteOrURL


RückgabewerteEin Boolescher Wert: true, wenn alle der folgenden Bedingungen zutreffen, andernfalls false:

• Eine entfernte Site ist definiert.

• Falls sich der Fokus auf einem Dokumentfenster befindet: die Datei gehört zu einer lokalen Site und ist noch nicht ausge-checkt. Falls sich der Fokus auf dem Bedienfeld Site befindet: Dateien bzw. Ordner sind ausgewählt und mindestens eine der ausgewählten Dateien ist noch nicht ausgecheckt.

• Die Funktion Einchecken/Auschecken ist für die Site deaktiviert.

site.canCloak()


BeschreibungÜberprüft, ob Dreamweaver einen Cloaking-Vorgang ausführen kann.

ArgumentesiteOrURL

• Das Argument siteOrURL muss das Schlüsselwort site sein, wenn sich canCloak() auf die Auswahl im Bedienfeld Site auswirken soll, oder die URL eines bestimmten Ordners, wenn sich canCloak() auf den angegebenen Ordner und dessen Inhalt auswirken soll.

RückgabewerteEin Boolescher Wert: true, wenn Dreamweaver den Cloaking-Vorgang für die aktuelle Site oder den angegebenen Ordner ausführen kann, andernfalls false.


442

site.canCompareFiles()


BeschreibungDiese Funktion prüft, ob Dreamweaver für die ausgewählten Dateien die Vergleichsfunktion durchführen kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn zwei Dateien (eine lokale und eine Remote-Datei, zwei lokale Dateien oder zwei Remote-Dateien) ausgewählt sind, andernfalls false.

site.canConnect()


BeschreibungÜberprüft, ob eine Verbindung zur entfernten Site hergestellt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die richtige Remote-Site als FTP-Site angegeben ist, andernfalls false.

site.canDisplaySyncInfoForFile()

VerfügbarkeitDreamweaver CS3

BeschreibungÜberprüft, ob der Vorgang displaySyncInfoForFile ausgeführt werden kann.

Argumentepath, 'site'

• path ist die URL zu einer lokalen Datei.

• 'site' gibt an, dass die Funktion die im Bedienfeld Site ausgewählte Datei verwendet.

RückgabewerteGibt true zurück, wenn in der lokalen Dateiansicht eine Datei ausgewählt ist (falls 'site' der Parameter ist), oder wenn der übergebene Pfad Teil einer Site ist. Andernfalls wird false zurückgegeben.

site.canFindLinkSource()


BeschreibungÜberprüft, ob der Vorgang Hyperlink-Quelle suchen ausgeführt werden kann.


443

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, dass es sich bei dem in der Sitemap ausgewählten Hyperlink nicht um die Homepage handelt.

site.canGet()


BeschreibungÜberprüft, ob der Vorgang Abrufen ausgeführt werden kann.

ArgumentesiteOrURL


RückgabewerteWenn das Argument site lautet: Ein Boolescher Wert, der angibt, ob Dateien bzw. Ordner im Bedienfeld Site ausgewählt sind und ob eine Remote-Site definiert ist. Wenn als Argument eine URL übergeben wird: Ein Boolescher Wert, der angibt, ob das Dokument zu einer Site gehört, für die eine Remote-Site definiert ist.

site.canLocateInSite()


BeschreibungBestimmt, ob der Vorgang Auf lokaler Site/Auf entfernter Site lokalisieren (je nach Argument) ausgeführt werden kann.

ArgumentelocalOrRemote, siteOrURL

• Das Argument localOrRemote muss entweder local oder remote sein.


RückgabewerteEiner der folgenden Werte:

• Wenn das erste Argument das Schlüsselwort local ist und als zweites Argument eine URL übergeben wird: Ein Boole-scher Wert, der angibt, ob das Dokument zu einer Site gehört.

• Wenn das erste Argument das Schlüsselwort remote ist und als zweites Argument eine URL übergeben wird: Ein Boole-scher Wert, der angibt, ob das Dokument zu einer Site gehört, für die eine Remote-Site definiert ist und, falls es sich um einen Server des Typs Lokal/Netzwerk handelt, ob das Laufwerk angemeldet wurde.

• Wenn das zweite Argument das Schlüsselwort site ist: Ein Boolescher Wert, der angibt, ob beide Fensterbereiche Site-Dateien (nicht die Sitemap) enthalten und die Auswahl und das Argument in gegenüberliegenden Bereichen liegen.


444

site.canMakeEditable()


BeschreibungÜberprüft, ob der Vorgang Schreibschutz deaktivieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn Dreamweaver die Operation Schreibschutz deaktivieren durchführen kann; false, wenn eine oder mehrere der ausgewählten Dateien gesperrt sind.

site.canMakeNewFileOrFolder()


BeschreibungÜberprüft, ob im Bedienfeld Site der Vorgang Neue Datei bzw. Neuer Ordner ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn im ausgewählten Bereich des Bedienfelds Site Dateien sichtbar sind, andernfalls false.

site.canOpen()


BeschreibungÜberprüft, ob die im Bedienfeld Site gerade ausgewählten Dateien bzw. Ordner geöffnet werden können.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn im Bedienfeld Site Dateien oder Ordner ausgewählt sind, andernfalls false.

site.canPut()


BeschreibungÜberprüft, ob der Vorgang Bereitstellen ausgeführt werden kann.


445

ArgumentesiteOrURL


RückgabewerteEiner der folgenden Werte:

• Wenn das Argument das Schlüsselwort site ist, wird der Wert true zurückgegeben, wenn Dateien bzw. Ordner im Bedienfeld Site ausgewählt sind und eine Remote-Site definiert wurde, andernfalls false.

• Wenn als Argument eine URL übergeben wird, wird der Wert true zurückgegeben, wenn das Dokument zu einer Site gehört, für die eine Remote-Site definiert ist, andernfalls wird false zurückgegeben.

site.canRecreateCache()


BeschreibungÜberprüft, ob der Vorgang Sitecache neu erstellen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Option Mit Cache Hyperlink-Updates beschleunigen für die aktuelle Site aktiviert ist.

site.canRefresh()


BeschreibungÜberprüft, ob der Vorgang Lokal/Entfernte aktualisieren ausgeführt werden kann.

ArgumentelocalOrRemote

• Das Argument localOrRemote muss entweder das Schlüsselwort local oder remote sein.

Rückgabewertetrue, wenn localOrRemote auf local gesetzt ist; andernfalls wird ein Boolescher Wert zurückgegeben, der angibt, ob eine Remote-Site definiert ist.

site.canRemoveLink()


BeschreibungÜberprüft, ob der Vorgang Hyperlink entfernen ausgeführt werden kann.

ArgumenteKeine


446

RückgabewerteEin Boolescher Wert, der angibt, ob eine HTML- oder Flash-Datei mit der in der Sitemap ausgewählten Datei über einen Hyperlink verknüpft ist.

site.canSetLayout()


BeschreibungÜberprüft, ob der Vorgang Layout ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Sitemap sichtbar ist, andernfalls false.

site.canSelectAllCheckedOutFiles()


BeschreibungBestimmt, ob die Option Ein-/Auschecken für die aktuelle Site aktiviert ist.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn das Ein- und Auschecken für die Site zulässig ist, andernfalls false.

site.canSelectNewer()


BeschreibungÜberprüft, ob der Vorgang Neuere auswählen [lokal / entfernt] ausgeführt werden kann.

ArgumentelocalOrRemote

• Das Argument localOrRemote muss entweder das Schlüsselwort local oder remote sein.

RückgabewerteEin Boolescher Wert, der angibt, ob das Dokument zu einer Site gehört, für die eine entfernte Site definiert ist.


447

site.canShowPageTitles()


BeschreibungBestimmt, ob der Vorgang Seitentitel anzeigen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn die Sitemap sichtbar ist, andernfalls false.

site.canSynchronize()


BeschreibungÜberprüft, ob der Vorgang Synchronisieren ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert, der angibt, ob eine entfernte Site definiert ist.

site.canUncloak()


BeschreibungÜberprüft, ob ein Cloaking deaktivieren-Vorgang ausgeführt werden kann.

ArgumentesiteOrURL

• Das Argument siteOrURL muss das Schlüsselwort site sein, wenn sich canUncloak() auf die Auswahl im Bedienfeld Site auswirken soll, oder die URL eines bestimmten Ordners, wenn sich canUncloak() auf den angegebenen Ordner und dessen Inhalt auswirken soll.

RückgabewerteEin Boolescher Wert: true, wenn Dreamweaver die Uncloaking-Operation auf die aktuelle Site oder den angegebenen Ordner anwenden kann, andernfalls false.

site.canUndoCheckOut()


BeschreibungÜberprüft, ob der Vorgang Auschecken rückgängig ausgeführt werden kann.


448

ArgumentesiteOrURL


RückgabewerteEin Boolescher Wert: true, wenn die angegebene Datei oder mindestens eine der ausgewählten Dateien ausgecheckt wurde.

site.canViewAsRoot()


BeschreibungÜberprüft, ob der Vorgang Als Stammordner anzeigen ausgeführt werden kann.

ArgumenteKeine

RückgabewerteEin Boolescher Wert: true, wenn es sich bei der angegebenen Datei um eine HTML- oder Flash-Datei handelt, andernfalls false.

449

Index

Aabgelöste Funktionen 4

dreamweaver.canExportCSS() 426dreamweaver.exportCSS() 230dreamweaver.exportEditableRegion

sAsXML() 230dreamweaver.libraryPalette.recreate

FromDocument() 270dreamweaver.libraryPalette.rename

SelectedItem() 270abrufen

aktuelles DOM 231benannte Verbindungsobjekte 46

activateApp() 108activeViewScale() 353addBehavior() 272addDebugContextData() 145addItem() 140addJavaScript() 294addLinkToExistingFile() 196addLinkToNewFile() 197addResultItem() 136addSpacerToColumn() 344Aktualisieren

Schlüssel-Wert-Paare in Design Notes-Dateien 27

aktualisierenMenüs 133

Akustische Warnung 109align() 337Als Befehl speichern (Dialogfeld) 123an den Anfang des Dokuments 131Anmeldeinformationen, RDS 52, 55anordnen

Hotspots 338schwebende Bedienfelder 344

Ansichtauswählen 172bestimmen 172sichtbar 175

Ansichten 64anwenden, Stile 321Anwendungen

auswählen 106Dateien öffnen 106

AnwendungsfunktionenBridge-Kommunikation 113externe 101globale 109

Anzahl ausgecheckter Dateien 91anzeigen

Tastencodes 132visuelle Hilfsmittel 147

API für Datei-E/ADWfile.copy() 7DWfile.createFolder() 8DWfile.exists() 8DWfile.getAttributes() 9DWfile.getCreationDate() 10DWfile.getCreationDateObj() 10DWfile.getModificationDate() 9DWfile.getModificationDateObj()

11DWfile.getSize() 11DWfile.listFolder() 11DWfile.read() 12DWfile.remove() 12DWfile.setAttributes() 13DWfile.write() 14Informationen 7

API für DatenbankenInformationen 43MMDB.deleteConnection() 45MMDB.getColdFusionDsnList() 45MMDB.getColumnAndTypeList()

57MMDB.getColumnList() 57MMDB.getColumns() 58MMDB.getColumnsOfTable() 59MMDB.getConnection() 46MMDB.getConnectionList() 47MMDB.getConnectionName() 47MMDB.getConnectionString() 48MMDB.getDriverName() 48MMDB.getDriverUrlTemplateList()

49MMDB.getLocalDsnList() 49MMDB.getPassword() 50MMDB.getPrimaryKeys() 59MMDB.getProcedures() 60MMDB.getRdsPassword() 50MMDB.getRdsUserName() 50MMDB.getRemoteDsnList() 51MMDB.getRuntimeConnectionTyp

e() 51MMDB.getSPColumnList() 61MMDB.getSPColumnListNamedPa

rams() 62MMDB.getSPParameters() 62

MMDB.getSPParamsAsString() 63MMDB.getTables() 64MMDB.getUserName() 52MMDB.getViews() 64MMDB.hasConnectionWithName()

52MMDB.needToPromptForRdsInfo(

) 52MMDB.needToRefreshColdFusion

DsnList() 53MMDB.popupConnection() 53MMDB.setRdsPassword() 54MMDB.setRdsUserName() 54MMDB.showColdFusionAdmin()

54MMDB.showConnectionMgrDialog

() 54MMDB.showOdbcDialog() 55MMDB.showRdsUserDialog() 55MMDB.showRestrictDialog() 55MMDB.showResultset() 65MMDB.showSPResultset() 66MMDB.showSPResultsetNamedPar

ams() 66MMDB.testConnection() 56Verbindungsfunktionen 45Zugriffsfunktionen 56

API für Dialogfeld „Datenbankverbindung“

applyConnection() 72Definitionsdateien 74findConnection() 71Include-Dateien, generierte 73Informationen 70inspectConnection() 72

API für Flash-ObjekteInformationen 40SWFFile.createFile() 40SWFFile.getNaturalSize() 41SWFFile.getObjectType() 42SWFFile.readFile() 42

API für HTTPInformationen 15MMHttp.clearServerScriptsFolder()

15MMHttp.clearTemp() 16MMHttp.getFile() 17MMHttp.getFileCallback() 18MMHttp.getTextCallback() 19MMHttp.postText() 19

INDEX 450

MMHttp.postTextCallback() 20API für JavaBeans

Informationen 77MMJB.getClasses() 77MMJB.getClassesFromPackage() 80MMJB.getErrorMessage() 80MMJB.getEvents() 78MMJB.getMethods() 79MMJB.getProperties() 77

API zur Integration der Quellcodeverwaltung

Informationen 81SCS_AfterGet() 99SCS_AfterPut() 99SCS_BeforeGet() 98SCS_BeforePut() 98SCS_canCheckin() 96SCS_canCheckout() 95SCS_canConnect() 95SCS_canDelete() 97SCS_canGet() 95SCS_canNewFolder() 97SCS_canPut() 96SCS_canRename() 97SCS_CanUndoCheckout() 96SCS_Checkin() 89SCS_Checkout() 90SCS_Connect() 82SCS_Delete() 86SCS_Disconnect() 83SCS_Get() 85SCS_GetAgentInfo() 82SCS_GetCheckoutName() 89SCS_GetConnectionInfo() 87SCS_GetDesignNotes() 93SCS_GetErrorMessage() 92SCS_GetErrorMessageLength() 91SCS_GetFileCheckoutList() 91SCS_GetFolderList() 84SCS_GetFolderListLength() 84SCS_GetMaxNoteLength() 93SCS_GetNewFeatures() 88SCS_GetNoteCount() 92SCS_GetNumCheckedOut() 91SCS_GetNumNewFeatures() 88SCS_GetRootFolder() 83SCS_GetRootFolderLength() 83SCS_IsConnected() 83SCS_IsRemoteNewer() 94SCS_ItemExists() 87SCS_NewFolder() 86SCS_Put() 85SCS_Rename() 86

SCS_SetDesignNotes() 94SCS_SiteDeleted() 87SCS_SiteRenamed() 88SCS_UndoCheckout() 90

API zur Integration von FireworksbringDWToFront() 33bringFWToFront() 33execJsInFireworks() 34getJsResponse() 34Informationen 33mayLaunchFireworks() 35optimizeInFireworks() 35validateFireworks() 36

API-TypenDatei-E/A 7Datenbank 43Design Notes 23Dialogfeld „Datenbankverbindung“

70Flash-Objekte 40HTTP 15Integration der

Quellcodeverwaltung 82Integration von Fireworks 33Java Beans 77

applyCharacterMarkup() 379applyComment() 187applyConnection() 72applyCSSStyle() 321applyFontMarkup() 379applyLayout() 319applySelectedStyle() 327applyTemplate() 284arrange() 338arrangeFloatingPalettes() 344arrowDown() 127, 398arrowLeft() 127, 398arrowRight() 127, 399arrowUp() 128, 399assetPalette.addToFavoritesFromDo

cument() 263assetPalette.addToFavoritesFromSite

Assets() 263assetPalette.addToFavoritesFromSite

Window() 264assetPalette.canEdit() 424assetPalette.canInsertOrApply() 424assetPalette.copyToSite() 264assetPalette.edit() 264assetPalette.getSelectedCategory()

265assetPalette.getSelectedItems() 265assetPalette.getSelectedView() 266assetPalette.insertOrApply() 266

assetPalette.locateInSite() 266assetPalette.newAsset() 266assetPalette.newFolder() 267assetPalette.recreateLibraryFromDoc

ument() 267assetPalette.refreshSiteAssets() 267assetPalette.removeFromFavorites()

268assetPalette.renameNickname() 268assetPalette.setSelectedCategory()

268assetPalette.setSelectedView() 269attachExternalStylesheet() 327Attribute

abrufen 9Codefragment-Tag 289von Dateien festlegen 13

auf vorhergehendes Wort 131aufgezeichnete Befehle 119Aufzeichnung

Schritte 119stoppen 120

ausblenden, Symbolleiste 157auschecken, Dateien 90

Anzahl der Benutzer 91rückgängig machen 90

auschecken, Namen 89ausrichten

Ebenen 337Tracing-Bilder 343

Auswahl 171löschen 380

auswählen, Verlaufsschritte 123Auswahlfunktionen

im Bedienfeld Site 191in geöffneten Dokumenten 249

BbackspaceKey() 128balanceBracesTextView() 399Bedienfelder

Inhalt löschen 136Meldungen 137

beenden, Dreamweaver 109beep() 109, 111, 192, 219Befehle

aufgezeichnete 119ausführen 225

Befehle (Menü), Funktionen 224Beim Einfügen von Objekten Dialog

anzeigen 109benannte Prozeduren 62benannte Verbindungen 48

Prozeduren 60

INDEX 451

Benutzer, Auschecken von Dateien 91

Benutzernamen 52Namen auschecken 89RDS 50, 54, 55

bereitstellen, Dateien 85, 99Berichte

im Bedienfeld Ergebnisse 134Berichtfunktionen 191Beschränken (Dialogfeld) 55Bibliotheks- und

Vorlagenfunktionen 284Bild ab 130Bild auf 130Bildeditor 107Blöcke

farblich darstellen 349, 351IDs 350, 351Rahmen 349, 351

Box-Modelle farblich darstellen 350Bridge-Kommunikationsfunktionen

113BridgeTalk

bringToFront() 113send() 114suppressStartupScreen() 114

bringAttentionToFloater() 173bringDWToFront() 33bringFWToFront() 33bringToFront() 113browseDocument() 101, 439browseForFileURL() 227browseForFolderURL() 228browseInBridge() 115Browser

Liste 102Primär- 104Sekundär- 104URL öffnen 101Zielbrowser 134Zielbrowser-Prüfung durchführen

239

CcanAddLinkToFile() 440canAlign() 415canApplyLayout() 320canApplyTemplate() 415canArrange() 415canChangeLink() 440canCheckIn() 440canCheckOut() 441canClear() 435canClipCopy() 425

canClipCopyText() 416canClipCut() 425canClipPaste() 416, 425canClipPasteText() 416canCloak() 441canConnect() 442canConvertLayersToTable() 417canConvertTablesToLayers() 417canCopy() 435canCut() 435canDecreaseColspan() 417canDecreaseRowspan() 417canDeleteTableColumn() 418canDeleteTableRow() 418canDisplaySyncInfoForFile() 442canEditColumns() 418canEditNoFramesContent() 419canEditSelectedRule() 431canEditSelection() 435canExportCSS() 426canExportTemplateDataAsXML()

426canFindLinkSource() 442canFindNext() 426canGet() 443canIncreaseColspan() 419canIncreaseRowspan() 419canInsertTableColumns() 419canInsertTableRows() 420canLocateInSite() 443canMakeEditable() 444canMakeNewEditableRegion() 420canMakeNewFileOrFolder() 444canMarkSelectionAsEditable() 420canMergeTableCells() 421canOpen() 444canOpenInBrowser() 436canOpenInEditor() 436canOpenInFrame() 427canPaste() 436canPlayPlugin() 421canPlayRecordedCommand() 428canPopupEditTagDialog() 428canPut() 444canRecreateCache() 445canRedo() 421, 428canRefresh() 445canRemoveEditableRegion() 421canRemoveLink() 445canRevertDocument() 428canSave() 436canSaveAll() 429canSaveDocument() 429

canSaveDocumentAsTemplate() 429canSaveFrameset() 430canSaveFramesetAs() 430canSelectAll() 430, 437canSelectAllCheckedOutFiles() 446canSelectNewer() 446canSelectTable() 422canSetLayout() 446canSetLinkHref() 422canShowFindDialog() 430canShowListPropertiesDialog() 422canSplitFrame() 423canSplitTableCell() 423canStopPlugin() 423canSynchronize() 447canUncloak() 447canUndo() 423, 431canUndoCheckOut() 447canViewAsRoot() 448cascade() 173Cascading Stylesheets in HTML-

Markup konvertieren 223changeLink() 197changeLinkSitewide() 197checkIn() 197checkLinks() 198checkOut() 198checkSpelling() 238checkTargetBrowsers() 199, 239cleanupXHTML() 225clear() 136clearGuides() 355clearServerScriptsFolder() 15clearSteps() 120clearTemp() 16clipCopy() 279, 282clipCopyText() 280clipCut() 280, 282clipPaste() 280, 283clipPasteText() 281cloak() 199, 200closeDocument() 228CloseNotesFile() 28Codeansicht 172

automatischer Einzug 147farbliche Darstellung der Syntax 151ungültiger HTML-Code 147wechseln in die 329Zeilennummern 150, 156Zeilenumbruch 152, 158

Codefarben 374Codefragmente (Bedienfeld),

Funktionen 289

INDEX 452

Codefragment-Tag, Attribute 289Codefunktionen

Codeansicht 395Codefragmente (Bedienfeld) 289Codehinweise und farbliche

Darstellung 371codeHints.addFunction() 372codeHints.addMenu() 371codeHints.resetMenu() 373codeHints.showCodeHints() 374Codehinweise 371Codeinspektor

automatischer Einzug 161farbliche Darstellung der Syntax 160ungültiger HTML-Code 160, 161Zeilennummern 160Zeilenumbruch 161, 162

ColdFusion Component Explorer 204, 205, 208

ColdFusion-Administrator 54ColdFusion-Datenquellen 53ColdFusion-Datenquellennamen 45collapseFullTag() 183collapseSelectedCodeFragment()

181collapseSelectedCodeFragmentInver

se() 182, 185collpaseSelectedCodeFragment()

184columns

Größe bestimmen 348compare() 194compareFiles() 193Configuration, Ordnerpfad 247Configuration/Temp (Ordner) 16,

17, 18Connection Manager 47, 53, 54connection_includefile.edml 74convertActiveContent() 126convertLayersToTable() 223convertNextActiveContent() 126convertTablesToLayers() 223convertToXHTML() 226convertWidthsToPercent() 362convertWidthsToPixels() 362Copy() 137copy() 7copyAssets() 295copySteps() 120createDocument() 228createFolder() 8createHorzontalGuide() 356createLayoutCell() 345createLayoutTable() 345

createResultsWindow() 139createVerticalGuide() 356createXHTMLDocument() 229createXMLDocument() 230CSS- in HTML-Markup

konvertieren 223cssRuleTracker.canEditSelectedRule(

) 431CSS-Stil-Funktionen 319cssStyle.canEditSelectedStyle() 433cssStylePalette.canApplySelectedStyl

e() 432cssStylePalette.canDeleteSelectedStyl

e() 432cssStylePalette.canEditStyleSheet()

434cut() 137

DDarstellung

Stile 329data-Eigenschaft von httpReply-

Objekten 15Dateibearbeitungsfunktionen 225Dateien

Anzahl der Benutzer, die ausgecheckt haben 91

Attribute 13Attribute abrufen 9auschecken 90Auschecken rückgängig machen 90ausgecheckte 91bereitstellen 85, 99connection_includefile.edml 74Dateifragmente 289einchecken 89, 99entfernen 12Ergebnisfenster 143erstellen (HTML-Dateien) 228erstellen (Nicht-HTML-Dateien) 14erstellen (XHTML-Dateien) 229erstellen (XML-Dateien) 230Erstellungszeit 10generierte Include-Datei 73Größe 11Hilfe 105in der angegebenen Anwendung

öffnen 106in eingereichten Ordner 84Inhalt lesen und in einen String

schreiben 12Inhalt speichern von 18, 19kopieren 7lesen 12löschen 16, 86

mit angegebenem Bildeditor öffnen 107

Primäreditor 104Quellcode-Verwaltungssysteme 84,

85schreiben 14speichern 17, 18Strings schreiben in 14umbenennen 86verarbeiten 144vergleichen 193Vorhandensein prüfen 8, 87Zeitpunkt der Änderung 9zuletzt geöffnete 232

Datei-URLin den lokalen Dateipfad

konvertieren 24in den lokalen Laufwerkspfad

konvertieren 26, 31Datenbanken

Ansichten 64API für Datenbanken 43API für Dialogfeld „Verbindung“ 70Verbindungsfunktionen 45Verbindungstyp-Definitionsdateien

74Zugriffsfunktionen 56

Datenbank-Konnektivität, Übersicht 69

Datenbank-Konnektivitäts-API. Siehe API für Dialogfeld „Datenbankverbindung“

Datenbankverbindungen 53Benutzernamen 52Kennwörter 50löschen 45Vorhandensein prüfen 52

Datenbankverbindungsfunktionen (MMDB) 45

Datenbankverbindungstyp-Definitionsdateien 74

Daten-Manager 305Datenquellen

ColdFusion 53ODBC 55

Datenquellennamen in ColdFusion 45

dbi.setExpanded() 305decreaseColspan() 362decreaseRowspan() 363defineSites() 200Definitionsdatei für den

Verbindungstyp 74deleteConnection() 45deleteHorizontalGuide() 357deleteKey() 128

INDEX 453

deleteSelectedItem() 269deleteSelectedStyle() 327deleteSelectedTemplate() 271deleteSelection() 200, 380, 390deleteTableColumn() 363deleteTableRow() 363deleteVerticalGuide() 357deployFilesToTestingServerBin()

201description (Attribut) 289Design Notes

API für C 27Dateistruktur 23Länge 93Quellcode-Verwaltungssysteme 93,

94Design Note-Schlüssel 92Design Notes-Dateien

Anzahl an Schlüssel-Wert-Paaren 29

öffnen 26, 31schließen 28Schlüssel 25, 28Schlüssel abrufen 24Schlüssel entfernen 27, 32Schlüssel-Wert-Paare 24Schlüssel-Wert-Paare erstellen 27,

32Site-Stamm 25, 30speichern 23

Design Notes-FunktionenMMNotes.close() 23MMNotes.filePathToLocalURL()

24MMNotes.get() 24MMNotes.getKeyCount() 24MMNotes.getKeys() 25MMNotes.getSiteRootForFile() 25MMNotes.getVersionName() 25MMNotes.getVersionNum() 26MMNotes.localURLToFilePath()

26Designfunktionen 319detachFromLibrary() 284detachFromTemplate() 284Dialogfelder

Als Befehl speichern 123Als Vorlage speichern 237Befehlsliste bearbeiten 224Beschränken 55Bildquelle auswählen 341ColdFusion-Administrator 54Connection Manager 54Dynamische Daten 110

Dynamischer Text 110Ebenen in Tabelle konvertieren 223Editierbare Bereiche als XML

exportieren 230Ersetzen 379externen Editor auswählen 106Inhalte einfügen 111Neuer CSS-Stil 326Neuer Stil 332Neues Dokument 233ODBC-Datenquellen-

Administrator 55Öffnen in Frame 235Ordner wählen 228Rastereinstellungen 344Seiteneigenschaften 241Site-Definition 145Speichern unter 236, 237Stildefinition 328Stile als CSS-Datei exportieren 230Stylesheet bearbeiten 329Suchen 378System-ODBC-Administration 55Tabellen in Ebenen konvertieren

224Tag-Auswahl 112Über 110Voreinstellungen 106, 109, 111Zielbrowser 247

displaySyncInfoForFile() 201div-Abschnitte

farblich darstellen 349, 351IDs 350, 351Rahmen 349, 351

doDeferredTableUpdate() 364doesColumnHaveSpacer() 346doesGroupHaveSpacers() 346Dokumentauswahl im Fokus 171Dokumente

Anfang des Dokuments 131erstellen 228, 233öffnen 233, 234schließen 228speichern 236überprüfen 240wiederherstellen 235

Dokumentfunktionen, globale 238Dokumentinformationen 231dom

addBehavior() 272addJavaScript() 294addSpacerToColumn() 344align() 337applyCharacterMarkup() 379

applyCSSStyle() 321applyFontMarkup() 379applyLayout() 319applyTemplate() 284arrange() 338arrowDown() 127arrowLeft() 127arrowRight() 127arrowUp() 128backspaceKey() 128canAlign() 415canApplyLayout() 320canApplyTemplate() 415canArrange() 415canClipCopyText() 416canClipPaste() 416canClipPasteText() 416canConvertLayersToTable() 417canConvertTablesToLayers() 417canDecreaseColspan() 417canDecreaseRowspan() 417canDeleteTableColumn() 418canDeleteTableRow() 418canEditNoFramesContent() 419canIncreaseColspan() 419canIncreaseRowspan() 419canInsertTableColumns() 419canInsertTableRows() 420canMakeNewEditableRegion() 420canMarkSelectionAsEditable() 420canMergeTableCells() 421canPlayPlugin() 421canRedo() 421canRemoveEditableRegion() 421canSelectTable() 422canSetLinkHref() 422canShowListPropertiesDialog() 422canSplitFrame() 423canSplitTableCell() 423canStopPlugin() 423canUndo() 423checkSpelling() 238checkTargetBrowsers() 239cleanupXHTML() 225clearGuides() 355clipCopy() 279clipCopyText() 280clipCut() 280clipPaste() 280clipPasteText() 281collapseSelectedCodeFragment()

181

INDEX 454

collapseSelectedCodeFragmentInverse() 182

convertActiveContent() 126convertLayersToTable() 223convertNextActiveContent() 126convertTablesToLayers() 223convertToXHTML() 226convertWidthsToPercent() 362convertWidthsToPixels() 362copyAssets() 295createHorizontalGuide() 356createLayoutCell() 345createLayoutTable() 345createVerticalGuide() 356decreaseColspan() 362decreaseRowspan() 363deleteHorizontalGuide() 357deleteKey() 128deleteSelection() 380deleteTableColumn() 363deleteTableRow() 363deleteVerticalGuide() 357detachFromLibrary() 284detachFromTemplate() 284doDeferredTableUpdate() 364doesColumnHaveSpacer() 346doesGroupHaveSpacers() 346editAttribute() 380endOfDocument() 129endOfLine() 129exitBlock() 380expandAllCodeFragments() 182expandSelectedCodeFragments()

183forceToolbarUpdate() 166formatRange() 396formatSelection() 396getAttachedTemplate() 285getAutoValidationCount() 397getBehavior() 272getBlockElements() 298getCharSet() 381getClickedHeaderColumn() 346getDefaultAssetFolder() 296getEditableRegionList() 285getEditNoFramesContent() 146getElementView() 322getFocus() 171getFontMarkup() 381getFrameNames() 336getHeaderElements() 300getHideAllVisualAids() 147getInlineElements() 299

getIsLibraryDocument() 285getIsTemplateDocument() 286getIsXHTMLDocument() 227getLineFromOffset() 381getLinkHref() 381getLinkTarget() 382getListElements() 300getListTag() 382getMinDisplayWidth() 298getOpenPathName() 186getParseMode() 239getPreventLayerOverlaps() 147getRulerOrigin() 340getRulerUnits() 340getSelectedEditableRegion() 286getSelectedNode() 249getSelection() 250getShowAutoIndent() 147getShowBlockBackgrounds() 349getShowBlockBorders() 349getShowBlockIDs() 350getShowBoxModel() 350getShowDivBackgrounds() 322getShowDivBoxModel() 323getShowDivOutlines() 323getShowFrameBorders() 148getShowGrid() 148getShowHeadView() 148getShowHiddenCharacters() 186getShowImageMaps() 149getShowInvalidHTML() 149getShowInvisibleElements() 149getShowLayerBorders() 150getShowLayoutTableTabs() 346getShowLayoutView() 347getShowLineNumbers() 150getShowNoscript() 396getShowRulers() 150getShowSyntaxColoring() 151getShowTableBorders() 151getShowTableWidths() 364getShowToolbar() 151getShowToolbarIconLabels() 166getShowTracingImage() 152getShowWordWrap() 152getSnapToGrid() 152getTableExtent() 364getTagSelectorTag() 410getTextAlignment() 382getTextFormat() 383getToolbarIdArray() 167getToolbarItemValue() 167getToolbarLabel() 168

getToolbarVisibility() 168getTracingImageOpacity() 340getView() 172getWindowTitle() 172guidesColor() 358guidesDistanceColor() 358guidesLocked 358guidesSnapToElements 359guidesVisible 359hasCharacterMarkup() 383hasGuides 360hasHorizontalGuide() 360hasTracingImage() 424hasVerticalGuide() 361hideInfoMessagePopup() 239increaseColspan() 365increaseRowspan() 365indent() 383insertFiles() 107insertFlashElement() 40, 124insertHTML() 383insertLibraryItem() 287insertObject() 384insertTableColumns() 365insertTableRows() 366insertText() 384isColumnAutostretch() 347isDesignViewUpdated() 397isDocumentInFrame() 336isSelectionValid() 397loadTracingImage() 341makeCellWidthsConsistent() 347makeSizesEqual() 338markSelectionAsEditable() 287mergeTableCells() 366moveSelectionBy() 338newBlock() 385newEditableRegion() 287nextParagraph() 129nextWord() 130nodeToOffsets() 250notifyFlashObjectChanged() 385offsetsToNode() 251outdent() 386pageDown() 130pageUp() 130playAllPlugins() 341playPlugin() 341previousParagraph() 131previousWord() 131reapplyBehaviors() 273redo() 117removeAllSpacers() 348

INDEX 455

removeAllTableHeights() 366removeAllTableWidths() 367removeBehavior() 273removeCharacterMarkup() 386removeColumnWidth() 367removeCSSStyle() 324removeEditableRegion() 288removeFontMarkup() 386removeLink() 387removeSpacerFromColumn() 348resetAllElementViews() 324resizeSelection() 387resizeSelectionBy() 339runTranslator() 258runValidation() 240saveAllFrames() 337selectAll() 251selectChild() 394selectParent() 394selectTable() 367serverModel.getAppURLPrefix()

313serverModel.getDelimiters() 313serverModel.getDisplayName() 314serverModel.getFolderName() 314serverModel.getServerExtension()

314serverModel.getServerIncludeUrlPa

tterns() 315serverModel.getServerInfo() 316serverModel.getServerLanguage() -

abgelöst 316serverModel.getServerName() 317serverModel.getServerSupportsChar

set() 317serverModel.getServerVersion()

318serverModel.testAppServer() 318setAttributeWithErrorChecking()

387setColumnAutostretch() 348setEditNoFramesContent() 153setElementView() 324setHideAllVisualAids() 153setLayerTag() 339setLinkHref() 387setLinkTarget() 388setListBoxKind() 388setListTag() 389setPreventLayerOverlaps() 153setRulerOrigin() 341setRulerUnits() 342setSelectedNode() 251setSelection() 252setShowBlockBackgrounds() 350

setShowBlockBorders() 351setShowBlockIDs() 351setShowBoxModel() 352setShowDivBackgrounds() 325setShowDivBoxModel() 325setShowDivOutlines() 326setShowFrameBorders() 154setShowGrid() 154setShowHeadView() 154setShowHiddenCharacters() 187setShowImageMaps() 155setShowInvalidHTML() 155setShowInvisibleElements() 155setShowLayerBorders() 156setShowLayoutTableTabs() 352setShowLayoutView() 352setShowLineNumbers() 156setShowNoscript() 398setShowRulers() 156setShowSyntaxColoring() 157setShowTableBorders() 157setShowTableWidths() 368setShowToolbar() 157setShowToolbarIconLabels() 169setShowTracingImage() 158setShowWordWrap() 158setSnapToGrid() 158setTableCellTag() 368setTableColumns() 368setTableRows() 369setTextAlignment() 389setTextFieldKind() 389setTextFormat() 390setToolbarItemAttribute() 169setToolbarPosition() 170setToolbarVisibility() 170setTracingImageOpacity() 342setTracingImagePosition() 342setView() 172showFontColorDialog() 390showInfoMessagePopup() 241showInsertTableRowsOrColumnsDi

alog() 369showListPropertiesDialog() 388showPagePropertiesDialog() 241snapToGuides() 361snapTracingImageToSelection()

343source.applyComment() 187source.arrowDown() 398source.arrowLeft() 398source.arrowRight() 399source.arrowUp() 399

source.balanceBracesTextView() 399

source.endOfDocument() 400source.endOfLine() 400source.endPage() 400source.getCurrentLines() 401source.getLineFromOffset() 401source.getSelection() 401source.getText() 402source.getValidationErrorsForOffse

t() 402source.indentTextView() 403source.insert() 403source.nextWord() 403source.outdentTextView() 404source.pageDown() 404source.pageUp() 404source.previousWord() 405source.refreshVariableCodeHints()

188source.removeComment() 188source.replaceRange() 405source.scrollEndFile() 405source.scrollLineDown() 406source.scrollLineUp() 406source.scrollPageDown() 406source.scrollPageUp() 407source.scrollTopFile() 407source.selectParentTag() 407source.setCurrentLine() 407source.startOfDocument() 408source.startOfLine() 408source.topPage() 408source.wrapSelection() 409splitFrame() 337splitTableCell() 369startOfDocument() 131startOfLine() 132stopAllPlugins() 343stopPlugin() 343stripTag() 394synchronizeDocument() 409undo() 117updateCurrentPage() 288wrapTag() 395

DOM abrufen 231doURLDecoding() 242doURLEncoding() 255Dreamweaver

beenden 109in den Vordergrund stellen 33

dreamweaveractivateApp() 108activeViewScale() 353

INDEX 456

arrangeFloatingPalettes() 344assetPalette.addToFavoritesFromDo

cument() 263assetPalette.addToFavoritesFromSit

eAssets() 263assetPalette.addToFavoritesFromSit

eWindow() 264assetPalette.canEdit() 424assetPalette.canInsertOrApply()

424assetPalette.copyToSite() 264assetPalette.edit() 264assetPalette.getSelectedCategory()

265assetPalette.getSelectedItems() 265assetPalette.getSelectedView() 266assetPalette.insertOrApply() 266assetPalette.locateInSite() 266assetPalette.newAsset() 266assetPalette.newFolder() 267assetPalette.recreateLibraryFromDo

cument() 267assetPalette.refreshSiteAssets() 267assetPalette.removeFromFavorites()

268assetPalette.renameNickname() 268assetPalette.setSelectedCategory()

268assetPalette.setSelectedView() 269beep() 109, 111, 192, 219behaviorInspector (Objekt) 272behaviorInspector.getBehaviorAt()

276behaviorInspector.getBehaviorCoun

t() 276behaviorInspector.getSelectedBehav

ior() 277behaviorInspector.moveBehaviorDo

wn() 277behaviorInspector.moveBehaviorUp

() 278behaviorInspector.setSelectedBehavi

or() 279bringAttentionToFloater() 173browseDocument() 101browseForFileURL() 227browseForFolderURL() 228canClipCopy() 425canClipCut() 425canClipPaste() 425canExportCSS() - veraltet 426canExportTemplateDataAsXML()

426canFindNext() 426canOpenInFrame() 427canPlayRecordedCommand() 428

canPopupEditTagDialog() 428canRedo() 428canRevertDocument() 428canSaveAll() 429canSaveDocument() 429canSaveDocumentAsTemplate()

429canSaveFrameset() 430canSaveFramesetAs() 430canSelectAll() 430canShowFindDialog() 430canUndo() 431cascade() 173clipCopy() 282clipCut() 282clipPaste() 283closeDocument() 228codeHints.addFunction() 372codeHints.addMenu() 371codeHints.resetMenu() 373codeHints.showCodeHints() 374compareFiles() 193createDocument() 228createResultsWindow() 139createXHTMLDocument() 229createXMLDocument() 230cssRuleTracker.canEditSelectedRule

() 431cssRuleTracker.editSelectedRule()

326cssRuleTracker.newRule() 326cssStyle.canEditSelectedStyle() 433cssStylePalette (Objekt) 319cssStylePalette.applySelectedStyle()

327cssStylePalette.canApplySelectedStyl

e() 432cssStylePalette.canDeleteSelectedSty

le() 432cssStylePalette.canDuplicateSelected

Style() 432cssStylePalette.canEditStyleSheet()

434cssStylePalette.deleteSelectedStyle()

327cssStylePalette.duplicateSelectedStyl

e() 328cssStylePalette.editSelectedStyle()

328cssStylePalette.editSelectedStyleInC

odeview() 329cssStylePalette.editStyleSheet() 329cssStylePalette.getDisplayStyles()

329, 333cssStylePalette.getMediaType() 330

cssStylePalette.getSelectedStyle() 330

cssStylePalette.getSelectedTarget() 331

cssStylePalette.getStyles() 331cssStylePalette.newStyle() 332cssStylePalette.setMediaType() 333dbi.getDataSources() 304deleteSelection() 390doURLDecoding() 242doURLEncoding() 255editCommandList() 224editFontList() 391editLockedRegions() 259exportCSS() - veraltet 230exportEditableRegionsAsXML() -

veraltet 230exportTemplateDataAsXML() 231findNext() 374fitAll() 353fitSelection 354fitWidth() 354getActiveWindow() 173getBehaviorElement() 274getBehaviorEvent() 274getBehaviorTag() 275getBlockVisBoxModelColors() 333getBlockVisOutlineProperties() 334getBrowserList() 102getClipboardText() 283getConfigurationPath() 247getDivBackgroundColors() 334getDocumentDOM() 231getDocumentList() 174getDocumentPath() 248getElementRef() 242getExtDataArray() 306getExtDataValue() 305getExtensionEditorList() 102getExternalTextEditor() 103getExtGroups() 306getExtParticipants() 306getFlashPath() 103getFloaterVisibility() 174getFocus() 175getFontList() 391getFontStyles() 391getHideAllFloaters() 159getKeyState() 392getLiveDataInitTags() 307getLiveDataMode() 307getLiveDataParameters () 308getMenuNeedsUpdating() 133getNaturalSize() 392

INDEX 457

getNewDocumentDOM() 232getObjectRefs() 243getObjectTags() 244getParticipants() 311getPreferenceInt() 244getPreferenceString() 245getPrimaryBrowser() 104getPrimaryExtensionEditor() 104getPrimaryView() 175getRecentFileList() 232getRedoText() 118getSecondaryBrowser() 104getSelection() 252getServerModels() 318getShowDialogsOnInsert() 109getShowStatusBar() 159getSiteRoot() 248getSnapDistance() 176getSystemFontList() 392getTempFolderPath() 248getTokens() 255getTranslatorList() 259getUndoText() 118historyPalette (Objekt) 117historyPalette.clearSteps() 120historyPalette.getSelectedSteps()

121, 123historyPalette.getStepCount() 121historyPalette.getStepsAsJavaScript(

) 122historyPalette.getUndoState() 122,

124historyPalette.replaySteps() 122historyPalette.saveAsCommand()

123htmlInspector.collapseFullTag()

183htmlInspector.collapseSelectedCode

Fragment() 184htmlInspector.collapseSelectedCode

FragmentInverse() 185htmlInspector.expandAllCodeFrag

ments() 185htmlInspector.expandSelectedCode

Fragments() 185htmlInspector.getShowAutoIndent(

) 159htmlInspector.getShowHiddenChar

acters() 189htmlInspector.getShowHighlightInv

alidHTML() 160htmlInspector.getShowLineNumber

s() 160htmlInspector.getShowSyntaxColori

ng() 160

htmlInspector.getShowWordWrap() 161

htmlInspector.setShowAutoIndent() 161

htmlInspector.setShowHiddenCharacters() 189

htmlInspector.setShowHighlightInvalidHTML() 161

htmlInspector.setShowLineNumbers() 162

htmlInspector.setShowSyntaxColoring() 162

htmlInspector.setShowWordWrap() 162

htmlStylePalette.canEditSelection() 435

importXMLIntoTemplate() 233isRecording() 434isReporting() 191latin1ToNative() 256libraryPalette (Objekt) 284libraryPalette.deleteSelectedItem()

269libraryPalette.getSelectedItem() 269libraryPalette.newFromDocument()

269libraryPalette.recreateFromDocume

nt() 270libraryPalette.renameSelectedItem()

270liveDataTranslate() 309loadSitesFromPrefs() 193mapKeyCodeToChar() 132minimizeRestoreAll() 176nativeToLatin1() 256newDocument() 233newFromTemplate() 233nodeExists() 253nodeToOffsets() 253notifyMenuUpdated() 133objectPalette.getMenuDefault() 124objectPalette.setMenuDefault() 125offsetsToNode() 254openDocument() 234openDocumentFromSite() 234openInFrame() 234openWithApp() 106openWithBrowseDialog() 106openWithExternalTextEditor() 106openWithImageEditor() 107playRecordedCommand() 118popupAction() 275popupCommand() 224popupEditTagDialog() 410popupInsertTagDialog() 410popupServerBehavior() 312

PrintCode() 393printDocument() 108quitApplication() 109redo() 119referencePalette.getFontSize() 270referencePalette.setFontSize() 271refreshExtData() 307relativeToAbsoluteURL() 249releaseDocument() 235reloadCodeColoring() 374reloadMenus() 134reloadObjects() 125replace() 375replaceAll() 375resultsPalette.canClear() 435resultsPalette.canCopy() 435resultsPalette.canCut() 435resultsPalette.canOpenInBrowser()

436resultsPalette.canOpenInEditor()

436resultsPalette.canPaste() 436resultsPalette.canSave() 436resultsPalette.canSelectAll() 437resultsPalette.clear() 136resultsPalette.Copy() 137resultsPalette.cut() 137resultsPalette.debugWindow.addDe

bugContextData() 145resultsPalette.openInBrowser() 138resultsPalette.openInEditor() 138resultsPalette.paste() 137resultsPalette.save() 138resultsPalette.selectAll() 139resultsPalette.siteReports.addResultI

tem() 136revealDocument() 108revertDocument() 235runCommand() 225saveAll() 236saveDocument() 236saveDocumentAs() 237saveDocumentAsTemplate() 237saveFrameset() 237saveFramesetAs() 238saveSitesToPrefs() 194scanSourceString() 257selectAll() 254serverBehaviorInspector.getServerB

ehaviors() 312serverComponents.getSelectedNode

() 303serverComponents.refresh() 303setActiveWindow() 176

INDEX 458

setBlockVisOutlineProperties() 335setDivBackgroundColors() 335setFloaterVisibility() 177setHideAllFloaters() 163setLiveDataError() 309setLiveDataMode() 310setLiveDataParameters() 310setPreferenceInt() 245setPreferenceString() 246setPrimaryView() 178setShowStatusBar() 163setSnapDistance() 178setUpComplexFind() 376setUpComplexFindReplace() 376setUpFind() 377setUpFindReplace() 377showAboutBox() 110showDynamicData() 110showFindDialog() 378showFindReplaceDialog() 379showGridSettingsDialog() 344showLiveDataDialog() 311showPreferencesDialog() 111showProperties() 178showQuickTagEditor() 395showReportsDialog() 191showResults() 135showTagChooser() 112, 411showTagLibraryEditor() 411showTargetBrowsersDialog() 247siteSyncDialog.compare() 194siteSyncDialog.markDelete() 194siteSyncDialog.markGet() 195siteSyncDialog.markIgnore() 195siteSyncDialog.markPut() 195siteSyncDialog.markSynced() 196siteSyncDialog.toggleShowAllFiles()

196snippetPalette.editSnippet() 290snippetPalette.getCurrentSnippetPat

h() 290snippetPalette.insert() 291snippetPalette.insertSnippet() 291snippetPalette.newFolder() 290snippetPalette.newSnippet() 290snippetPalette.remove() 292snippetPalette.rename() 292startRecording() 119stopRecording() 119stylePalette.attachExternalStylesheet

() 327tagLibrary.getImportedTagList()

412tagLibrary.getSelectedLibrary() 412

tagLibrary.getSelectedTag() 412tagLibrary.getTagLibraryDOM()

411tagLibrary.importDTDOrSchema()

412templatePalette (Objekt) 284templatePalette.deleteSelectedTemp

late() 271templatePalette.getSelectedTemplat

e() 271templatePalette.renameSelectedTem

plate() 271tileHorizontally() 179tileVertically() 179toggleFloater() 179undo() 120updatePages() 288updateReference() 180useTranslatedSource() 260validateFlash() 107zoomIn() 354zoomOut() 355

Dreamweaver in den Vordergrund stellen 33

DSNs, ODBC 49, 51duplicateSelectedStyle() 328duplizieren, Stile 328dw

browseInBridge() 115dbi.setExpanded() 305getFilesForLayout() 320getLayoutDescriptions() 321getLayoutNames() 321registerIdleHandler() 112revokeIdleHandler() 113

DWfile.copy() 7DWfile.createFolder() 8DWfile.exists() 8DWfile.getAttributes() 9DWfile.getCreationDate() 10DWfile.getCreationDateObj() 10DWfile.getModificationDate() 9DWfile.getModificationDateObj()

11DWfile.getSize() 11DWfile.listFolder() 11DWfile.read() 12DWfile.remove() 12DWfile.setAttributes() 13DWfile.write() 14DWfile-DLL 7Dynamische Daten (Dialogfeld) 110Dynamischer Text (Dialogfeld) 110

EEbenen 339

ausrichten 337Größe bestimmen 338, 339HTML-Tag 339verschieben 339

Ebenen in Tabellen konvertieren 223Ebenen-Funktionen 337editAttribute() 380editColumns() 202editCommandList() 224editFontList() 391editLockedRegions() 259Editoren, Liste 102editSelectedRule() 326editSelectedStyle() 328editSnippet() 290editStyleSheet() 329EDML-Dateifunktionen 305Eigenschaften, JavaBeans 78, 79, 80einblenden, Symbolleiste 157einchecken, Dateien 89, 99eindeutiger Bezeichner 59eine Seite nach oben 130Einfügeleiste

Menüs 125Objekte neu laden 125

Einfügemarke 130an den Anfang der Zeile 132an den Anfang des Dokuments 131an den Anfang des nächsten

Absatzes 129auf vorhergehendes Wort 131eine Seite nach unten 130Ende der Zeile 129Ende des Dokuments 129in den vorhergehenden Absatz 131nächstes Wort 130verschieben 127, 128

einfügen 111Flash-Elemente 39, 124String ins Dokument 110Tags 112

eingereichte Ordner, Dateien 84Einzug 147, 161elem

getBlockElements() 298getComputedStyleProp() 296getHeaderElements() 300getInlineElements() 299getListElements() 300isBlockElement() 301isHeaderElement() 302

INDEX 459

isInlineElement() 301isListElement() 302

elementgetTranslatedAttribute() 292getTranslatedClassName 293removeTranslatedAttribute() 293setTranslatedAttribute() 293translatedStyle 294

Elemente (Bedienfeld), Funktionen 263

Enabler-Funktionen, Beschreibung 415

endOfDocument() 129, 400endOfLine() 129, 400endPage() 400Entf (Taste) 128entfernen

ID-Strings 124Platzhalter 348Stile 324

entfernte Funktionen 4Entwurfsansicht

einblenden/ausblenden 172sichtbar 172

Ereignisse, JavaBeans 78Ergebnisfenster

abrufen, Anzahl der Elemente 141abrufen, Array mit Elementen 141abrufen, Index des ausgewählten

Elements 141ausgewähltes Element definieren

143erstellen 139Funktionen 134hinzufügen 140neuen Ergebniseintrag hinzufügen

136processFile() aufrufen 142Schaltflächen definieren 142Spaltenbreiten 142Titel 143verarbeiten, Dateien 143, 144

Ergebnissätze 61, 62, 65, 66Ergebnisse (Bedienfeldgruppe) 134Ergebnisse (schwebendes

Bedienfeld) 135Errata 4erstellen

Dokumente 228Ergebnisfenster 139Ordner 8, 86XML-Dateien 230, 231

execJsInFireworks() 34exists() 8

exitBlock() 380expandAllCodeFragments() 182, 185expandSelectedCodeFragments()

183, 185exportCSS() - veraltet 230exportEditableRegionsAsXML() -

veraltet 230exportSite() 202exportTemplateDataAsXML() 231Extension Data Manager 305externer Texteditor 103, 106

Ffarblich darstellen

Blöcke 349, 351Box-Modelle 333, 350, 352Code 371, 374div-Abschnitte 349, 351Hilfslinien 358Layoutblock-Hintergründe 334

farbliche Darstellung der Syntax 162Favoritenliste

Elemente entfernen aus 268hinzufügen 263, 264

Fehlermeldungen 91Java Beans 78Länge in Quellcode-

Verwaltungssystemen 91Quellcode-Verwaltungssysteme 92

Fensterals Symbol darstellen 176überlappende 173

Fensterfunktionen 171FilePathToLocalURL() 28findConnection() 71findLinkSource() 203findNext() 374Fireworks

in den Vordergrund stellen 33JavaScript ausführen 34JavaScript übergeben an 34Optimierungssitzung 35Version 36

Fireworks in den Vordergrund stellen 33

fitall() 353fitSelection() 354fitWidth() 354Flash MX, Version bestimmen 107Flash, Pfad zu 103Flash-Elemente einfügen 39, 124Flash-Inhalt, natürliche Größe 41Flash-Objekt-Dateien

generieren 40

lesen 42Flash-Objekttyp 42font-Tag 379forceToolbarUpdate() 166formatRange() 396formatSelection() 396Formulare senden 19, 20Frame- und Frameset-Funktionen

336Frames

Liste 336teilen 337

Framesets 336speichern 337

FTP-Protokollierung 134Funktionen

abgelöst in CS3 4allgemeine Bearbeitung 379Ausblenden von Code 180Auswahl 249Bedienfeld für Codefragmente 289Bericht 191Bibliothek und Vorlage 284Browserkompatibilitätsprüfung 296Code 371Codeansicht 395Codeansicht-Symbolleiste 186command 224CSS-Layout 319Dateibearbeitung 225Dateiinhalte weitergeben 19Datenquelle 304Druck 393Ebenen und Imagemap 337Elemente (Bedienfeld) 263Enabler 415Ergebnisfenster 134Extension Data Manager 305externe Anwendung 101Frame und Frameset 336globale Anwendung 109globales Dokument 238Hilfslinien 355Konvertierung 223Layoutansicht 344Layout-Umgebung 340Live Data 307menu 133neu in Dreamweaver CS3 2Objekte einfügen 124path 247Quick Tag Editor 394Serverkomponenten 303

INDEX 460

Servermodell 313Serververhalten 311site 191Spry-Widgets

bearbeiten 292

einfügen 294suchen/ersetzen 374Symbolleiste 166Tabellenbearbeitung 362Tag-Bibliothek 410Tag-Editor 410Tastatur 126translation 258umschalten 146Vergrößerung 353Verhalten 272Verlauf 117window 171XSLT 260Zeichenfolgenbearbeitung 255Zwischenablage 279

Funktionen für die Browserkompatibilitätsprüfung 296

Funktionen für die Layout-Umgebung 340

Funktionen für externe Anwendungen 101

Funktionen zum Einfügen von Objekten 124

Funktionen, Quellcode-Verwaltungssysteme 88

FWLaunch.bringDWToFront() 33FWLaunch.bringFWToFront() 33FWLaunch.execJsInFireworks() 34FWLaunch.getJsResponse() 34FWLaunch.mayLaunchFireworks()

35FWLaunch.optimizeInFireworks()

35FWLaunch.validateFireworks() 36

Ggemeinsam genutzte MMNotes-

BibliothekVersionsname 25, 30Versionsnummer 26, 31

generieren, Flash-Objektdateien 40geöffnete Dokumente, Liste 174Geräusche 109gespeicherte Prozeduren 61, 62, 66

Ergebnisse anzeigen 66Informationen 56Parameter abrufen für 63parameters 63

Spalten abrufen 61, 62get() 204getActiveWindow() 173getAppServerAccessType() 204getAppServerPathToFiles() 205getAppURLPrefix() 313getAppURLPrefixForSite() 205getAttachedTemplate() 285getAttributes() 9getAutoValidationCount() 397getBehavior() 272getBehaviorAt() 276getBehaviorCount() 276getBehaviorElement() 274getBehaviorEvent() 274getBehaviorTag() 275getBlockElements() 298getBlockVisBoxModelColors() 333getBlockVisOutlineProperties() 334getBrowserList() 102getCharSet() 381getCheckOutUser() 206getCheckOutUserForFile() 206getClasses() 77getClassesFromPackage() 80getClickedHeaderColumn() 346getClipboardText() 283getCloakingEnabled() 206getColdFusionDsnList() 45getColumnAndTypeList() 57getColumnList() 57getColumns() 58getColumnsOfTable() 59getComputedStyleProp() 296getConfigurationPath() 247getConnection() 46getConnectionList() 47getConnectionName() 47getConnectionState() 207getConnectionString() 48getCreationDate() 10getCreationDateObj() 10getCurrentLines() 401getCurrentSite() 207getDataSources() 304getDeclaredStyle() 297getDefaultAssetFolder() 296getDelimiters() 313getDisplayName() 314getDivBackgroundColors() 334getDocumentDOM() 231getDocumentList() 174getDocumentPath() 248

getDriverName() 48getDriverUrlTemplateList() 49getDynamicBindings() 44getEditableRegionList() 285getEditNoFramesContent() 146getElementRef() 242getErrorMessage() 80getEvents() 78getExtDataArray() 306getExtDataValue() 305getExtensionEditorList() 102getExternalTextEditor() 103getExtGroups() 306getExtParticipants() 306getFile() 17getFileCallback() 18getFilesForLayout() 320getFlashPath() 103getFloaterVisibility() 174getFocus() 171, 175, 207getFolderName() 314getFontList() 391getFontMarkup() 381getFontStyles() 391getFrameNames() 336getHeaderElements() 300getHideAllFloaters() 159getHideAllVisualAids() 147getImportedTagList() 412getInlineElements() 299getIsLibraryDocument() 285getIsTemplateDocument() 286getIsXHTMLDocument() 227getItem() 134, 141getItemCount() 134, 141getJsResponse() 34getKeyState() 392getLayoutDescriptions() 321getLayoutNames() 321getLineFromOffset() 381, 401getLinkHref() 381getLinkTarget() 382getLinkVisibility() 208getListElements() 300getListTag() 382getLiveDataInitTags() 307getLiveDataMode() 307getLiveDataParameters () 308getLocalDsnList() 49getLocalPathToFiles() 208getMediaType() 330getMenuDefault() 124getMenuNeedsUpdating() 133

INDEX 461

getMethods() 79getMinDisplayWidth() 298getModificationDate() 9getModificationDateObj() 11getNaturalSize() 392getNewDocumentDOM() 232GetNote() 28GetNoteLength() 29GetNotesKeyCount() 29GetNotesKeys() 29getObjectRefs() 243getObjectTags() 244getOpenpathName() 186getParseMode() 239getParticipants() 311getPassword() 50getPreferenceInt() 244getPreferenceString() 245getPreventLayerOverlaps() 147getPrimaryBrowser() 104getPrimaryExtensionEditor() 104getPrimaryKeys() 59getPrimaryView() 175getProcedures() 60getProperties() 77getRdsPassword() 50getRdsUserName() 50getRecentFileList() 232getRedoText() 118getRemoteDsnList() 51getRulerOrigin() 340getRulerUnits() 340getRuntimeConnectionType() 51getSecondaryBrowser() 104getSelectedBehavior() 277getSelectedEditableRegion() 286getSelectedItem() 134, 269getSelectedLibrary() 412getSelectedNode() 249, 303getSelectedSteps() 121getSelectedStyle() 330getSelectedTag() 412getSelectedTarget() 331getSelectedTemplate() 271getSelection() 208, 250, 252, 401getServerBehaviors() 312getServerExtension() 314getServerIncludeUrlPatterns() 315getServerInfo() 316getServerLanguage() - veraltet 316getServerModels() 318getServerName() 317getServerSupportsCharset() 317

getServerVersion() 318getShowAutoIndent() 147getShowBlockBackgrounds() 349getShowBlockBorders() 349getShowBlockIDs() 350getShowBoxModel() 350getShowDependents() 163getShowDialogsOnInsert() 109getShowFrameBorders() 148getShowGrid() 148getShowHeadView() 148getShowHiddenCharacters() 186,

189getShowHiddenFiles() 164getShowImageMaps() 149getShowInvalidHTML() 149getShowInvisibleElements() 149getShowLayerBorders() 150getShowLayoutTableTabs() 346getShowLayoutView() 347getShowLineNumbers() 150getShowNoscript() 396getShowPageTitles() 164getShowRulers() 150getShowStatusBar() 159getShowSyntaxColoring() 151getShowTableBorders() 151getShowTableWidths() 364getShowToolbar() 151getShowToolbarIconLabels() 166getShowToolTips() 164getShowTracingImage() 152getShowWordWrap() 152getSiteForURL() 208getSiteRoot() 248GetSiteRootForFile() 30getSites() 209getSize() 11getSnapDistance() 176getSnapToGrid() 152getSPColumnList() 61getSPColumnListNamedParams()

62getSPParameters() 62getSPParamsAsString() 63getStepCount() 121getStepsAsJavaScript() 122getStyles() 331getSystemFontList() 392getTableExtent() 364getTables() 64getTagLibraryDOM() 411getTagSelectorTag() 410

getTempFolderPath() 248getText() 402getTextAlignment() 382getTextCallback() 19getTextFormat() 383getTokens() 255getToolbarIdArray() 167getToolbarItemValue() 167getToolbarLabel() 168getToolbarVisibility() 168getTracingImageOpacity() 340getTranslatedAttribute() 292getTranslatedClassName 293getTranslatorList() 259getUndoState() 122getUndoText() 118getUserName() 52getValidationErrorsForOffset() 402GetVersionName() 30GetVersionNum() 31getView() 172getViews() 64getWindowTitle() 172getXML() 260getXMLSchema() 261getXMLSourceURI() 261globale Anwendungsfunktionen 109globale Dokumentfunktionen 238Größe

Flash-Inhalt 41von Dateien 11

Größe bestimmenEbenen 338, 339Hotspots 339

Gruppe von Dateien 98, 99guidesColor() 358guidesDistanceColor() 358guidesLocked 358guidesSnapToElements 359guidesVisible 359

HhasCharacterMarkup() 383hasConnectionWithName() 52hasGuides() 360hasHorizontalGuide() 360hasTracingImage() 424hasVerticalGuide() 361hideInfoMessagePopup() 239Hilfedateien öffnen 105Hilfslinien

sperren 358verwenden 355

INDEX 462

Hilfslinienfunktionen 355Hotspot-Funktionen 337Hotspots

anordnen 338Größe bestimmen 338, 339verschieben 339

HTMLCascading Stylesheets 223einfügen 383konvertieren in XHTML 226neue Dokumente erstellen 228Tag 339ungültigen Code anzeigen 149Verbindungen 72

htmlInspector.collapseFullTag() 183htmlInspector.collapseSelectedCode

Fragment() 184htmlInspector.collapseSelectedCode

FragmentInverse() 185htmlInspector.expandAllCodeFragm

ents( 185htmlInspector.expandSelectedCodeF

ragments() 185htmlInspector.getShowAutoIndent()

159htmlInspector.getShowHiddenChara

cters() 189htmlInspector.getShowHighlightInv

alidHTML() 160htmlInspector.getShowLineNumbers

() 160htmlInspector.getShowSyntaxColori

ng() 160htmlInspector.getShowWordWrap()

161htmlInspector.setShowAutoIndent()

161htmlInspector.setShowHiddenChara

cters() 189htmlInspector.setShowHighlightInva

lidHTML() 161htmlInspector.setShowLineNumbers

() 162htmlInspector.setShowSyntaxColori

ng() 162htmlInspector.setShowWordWrap()

162HTTP-Sendevorgang 19, 20Hyperlink-Prüfer 134

IID-Strings entfernen 124Imagemap-Funktionen 337importDTDOrSchema() 412importSite() 209importXMLIntoTemplate() 233in den vorhergehenden Absatz 131

Include-Dateiengenerierte 73Verbindungstyp-Definition 74

increaseColspan() 365increaseRowspan() 365indent() 383indentTextView() 403InfoPrefs-Struktur 30Informationen über Dokumente 231Inhalte einfügen (Dialogfeld) 111insert() 291, 403insertFiles() 107insertFlashElement() 40, 124insertHTML() 383insertLibraryItem() 287insertObject() 384insertSnippet() 291insertTableColumns() 365insertTableRows() 366insertText() 384inspectConnection() 72invertSelection() 210isBlockElement() 301isCloaked() 210isColumnAutostretch() 347isDesignViewUpdated() 397isDocumentInFrame() 336isHeaderElement() 302isInlineElement() 301isListElement() 302isRecording() 434isReporting() 191isSelectionValid() 397itemInfo-Struktur 84

JJava Beans

Ereignisse 78Fehlermeldungen 78Klassen 77Klassennamen 77

JavaBeansEigenschaften 78, 79Klassen überprüfen 78, 79Methoden 79Schreibschutz für Eigenschaften 79,

80JavaScript

an Fireworks übergeben 34in Fireworks ausführen 34

JavaScript an Fireworks übergeben 34

JavaScript-Entsprechung, Verlaufsschritte 122

JDBC-Treiber 48, 49JDBC-Verbindungen 48

KKennwörter

Datenbankverbindung 50Datenbankverbindungen 50RDS 50, 54, 55

Klassen, JavaBeans überprüfen 78, 79Klassennamen, JavaBeans- 77Kommentare anwenden 187Konfigurationsdateien 7Konfigurationsdateien des Benutzers

7Konnektivität, Übersicht 69Kontureneigenschaften 334, 335Konventionen in der

Dokumentation 4konvertieren

Datei-URL in lokalen Laufwerkspfad 26, 28, 31

lokalen Dateipfad in site-relativen URI 192

lokalen Laufwerkspfad in eine Datei-URL 24

site-relativen URI in lokalen Dateipfad 193

von Pixel in Prozentangaben 362von Prozent in Pixel 362

konvertieren in XHTML 226Konvertierungsfunktionen 223kopieren

Auswahl 279Dateien 7Verlaufsschritte 120

Kopiert 279

Llatin1ToNative() 256Laufzeitverbindungstypen 51launchXMLSourceDialog() 262Layoutansicht 347, 352Layoutansicht-Funktionen 344lesen, Flash-Objekt-Datei 42Lineal

Einheiten 340Ursprung 340

ListenBrowser 102geöffnete Dokumente 174mit Editoren 102zuletzt geöffneter Dateien 232

listFolder() 11Live Data-Funktionen 307

INDEX 463

liveDataTranslate() 309loadSitesFromPrefs() 193loadTracingImage() 341LocalURLToFilePath() 31locateInSite() 210lokalen Dateipfad in site-relativen

URI konvertieren 192, 193lokaler Laufwerkspfad

aus Datei-URL konvertieren 26in Datei-URL konvertieren 24, 28

lokaler Stammordner 248löschen

Auswahl 380Datenbankverbindungen 45Ordner 15Stile 327

löschen, Bedienfeld Verlauf 120

MmakeCellWidthsConsistent() 347makeEditable() 211makeNewDreamweaverFile() 211makeNewFolder() 211makeSizesEqual() 338mapKeyCodeToChar() 132markDelete() 194markGet() 195markIgnore() 195markPut() 195markSelectionAsEditable() 287markSynced() 196mayLaunchFireworks() 35Menüelemente

Auschecken rückgängig 96Einchecken 96Löschen 97Neuer Ordner 97Rückgängig 120Umbenennen 97Wiederholen 120

MenüfunktionenBefehle (Menü) 224Menüs optimieren und neu laden

133mit Live Data-Funktionen

simulieren 307Menüs

Abrufen 95aktualisieren 133Auschecken 95Bereitstellen 96Einfügeleiste 125neu laden 134Verbindung herstellen 95

menus.xml (Datei) 134mergeTableCells() 366Methoden, JavaBeans- 79minimieren, Fenster 176minimizeRestoreAll() 176MMDB.deleteConnection() 45MMDB.getColdFusionDsnList() 45MMDB.getColumnAndTypeList()

57MMDB.getColumnList() 57MMDB.getColumns() 58MMDB.getColumnsOfTable() 59MMDB.getConnection() 46MMDB.getConnectionList() 47MMDB.getConnectionName() 47MMDB.getConnectionString() 48MMDB.getDriverName() 48MMDB.getDriverUrlTemplateList()

49MMDB.getLocalDsnList() 49MMDB.getPassword() 50MMDB.getPrimaryKeys() 59MMDB.getProcedures() 60MMDB.getRdsPassword() 50MMDB.getRdsUserName() 50MMDB.getRemoteDsnList() 51MMDB.getRuntimeConnectionType

() 51MMDB.getSPColumnList() 61MMDB.getSPColumnListNamedPar

ams() 62MMDB.getSPParameters() 62MMDB.getSPParamsAsString() 63MMDB.getTables() 64MMDB.getUserName() 52MMDB.getViews() 64MMDB.hasConnectionWithName()

52MMDB.needToPromptForRdsInfo()

52MMDB.needToRefreshColdFusionD

snList() 53MMDB.popupConnection() 53MMDB.setRdsPassword() 54MMDB.setRdsUserName() 54MMDB.showColdFusionAdmin()

54MMDB.showConnectionMgrDialog(

) 54MMDB.showOdbcDialog() 55MMDB.showRdsUserDialog() 55MMDB.showRestrictDialog() 55MMDB.showResultset() 65MMDB.showSPResultset() 66

MMDB.showSPResultsetNamedParams() 66

MMDB.testConnection() 56MMHttp.clearServerScriptsFolder()

15MMHttp.clearTemp() 16MMHttp.getFile() 17MMHttp.getFileCallback() 18MMHttp.getTextCallback() 19MMHttp.postText() 19MMHttp.postTextCallback() 20MMJB.getClasses() 77MMJB.getClassesFromPackage() 80MMJB.getErrorMessage() 80MMJB.getEvents() 78MMJB.getMethods() 79MMJB.getProperties() 77MMNotes DLL 23MMNotes.open() 26MMNotes.remove() 27MMNotes.set() 27MMNotes-Objekt 23MMXSLT.getXML() 260MMXSLT.getXMLSchema() 261MMXSLT.getXMLSourceURI() 261MMXSLT.launchXMLSourceDialog(

) 262moveBehaviorDown() 277moveBehaviorUp() 278moveSelectionBy() 338

Nnächster Absatz 129nächstes Wort 130name-Attribut 289Namen

auschecken 89Quellcode-Verwaltungssystem 82von Spalten 59

nativeToLatin1() 256needToPromptForRdsInfo() 52needToRefreshColdFusionDsnList()

53neu laden 374

Objekte auf der Einfüge-Leiste 125neue Dokumente 233Neue Funktionen in Dreamweaver

CS3 2newBlock() 385newDocument() 233newEditableRegion() 287newFromDocument() 269newFromTemplate() 233newHomePage() 212

INDEX 464

newRule() 326newSite() 212newSnippet() 290newStyle() 332nextParagraph() 129nextWord() 130, 403nodeExists() 253nodeToOffsets() 250, 253_notes folder 23notifyFlashObjectChanged() 385notifyMenuUpdated() 133

OObjekttyp, Flash 42ODBC-Administration 55ODBC-DSNs 49, 51öffnen

Dateien in der angegebenen Anwendung 106

Dateien mit angegebenem Bildeditor 107

Design Notes-Dateien 26, 31Dokumente 233, 234Dokumente in externem Texteditor

106Hilfedateien 105

offsetsToNode() 251, 254open() 26, 212openDocument() 234openDocumentFromSite() 234openInBrowser() 138openInEditor() 138openInFrame() 234OpenNotesFile() 31OpenNotesFilewithOpenFlags() 31openWithApp() 106openWithBrowseDialog() 106openWithExternalTextEditor() 106openWithImageEditor() 107optimieren, XHTML-Dokumente

225Optimierungssitzung, Fireworks 35optimizeInFireworks() 35Optionen, Beim Einfügen von

Objekten Dialog anzeigen 109Ordner

_mmServerScripts 15Attribute abrufen 9bereitstellen 85Configuration/Temp 16, 17, 18einchecken 89entfernen 15erstellen 8, 86Inhalt 11

Konfiguration 7löschen 86Quellcode-Verwaltungssystem 84, 85Quellcode-Verwaltungssystem ein-

und auschecken 90Vorhandensein prüfen 87

outdent() 386outdentTextView() 404

PpageDown() 130, 404pageUp() 130, 404Pakete, JavaBeans-Klassen 77Parameter von gespeicherten

Prozeduren 63paste() 137Pfade

Configuration-Ordner 247Dokumentpfade 248Sekundärbrowser 104temporärer Ordner 248zur Flash-Anwendung 103

Pfadfunktionen 247Platzhalter

entfernen 348erstellen 344

playAllPlugins() 341playPlugin() 341playRecordedCommand() 118Plug-In-Inhalte

stoppen 343wiedergeben 341

Plug-In-Inhalte wiedergeben 341popupAction() 275popupCommand() 224popupConnection() 53popupEditTagDialog() 410popupInsertTagDialog() 410popupServerBehavior() 312postText() 19postTextCallback() 20preview (Attribut) 289previousParagraph() 131previousWord() 131, 405Primärbrowser 104Primärschlüssel 59PrintCode() 393printDocument() 108Prozeduren, benannte

Verbindungen 60prüfen, Rechtschreibung 238prüfen, Verbindungsstrings 56Prüfmethode 134put() 213

QQuellcode-Prüfung 134Quellcode-Verwaltungssysteme 89

Dateien 85Dateien bereitstellen 85Dateien löschen 86Design Notes 93, 94Design Note-Schlüssel 92eingereichte Ordner 84Fehlermeldungen 92gelöschte Sites 87Gruppe von Dateien 98, 99Kommentar hinzufügen 98Länge des Stammordnernamens 83Länge von Design Notes 93Namen 82Namen auschecken 89neue Funktionen 88Ordner erstellen 86Ordnerelemente 84Remote-Dateien 94Stammordnernamen 83umbenannte Sites 88umbenennen, Dateien 86verbinden mit 82Verbindung trennen 83Verbindungen 87Verbindungen prüfen 83Versionen 82Vorhandensein von Dateien

überprüfen 87quitApplication() 109

RRahmen 349

Blöcke 351div-Abschnitte 351

RDSAnmeldeinformationen 52, 55Benutzernamen 50, 54Kennwörter 50, 54

read() 12reapplyBehaviors() 273Rechtschreibung prüfen 238recreateCache() 213recreateFromDocument() 270redo() 117, 119referencePalette.getFontSize() 270referencePalette.setFontSize() 271refresh() 213, 303refreshExtData() 307refreshVariableCodeHints() 188registerIdleHandler() 112

INDEX 465

relativeToAbsoluteURL() 249releaseDocument() 235reloadCodeColoring() 374reloadMenus() 134reloadObjects() 125Remote-Dateien 94remoteIsValid() 214remove()

(dreamweaver.snippetPalette.remove) 292

remove() (DWfile.remove) 12remove() (MMNotes.remove) 27removeAllSpacers() 348removeAllTableHeights() 366removeAllTableWidths() 367removeBehavior() 273removeCharacterMarkup() 386removeColumnWidth() 367removeComment() 188removeCSSStyle() 324removeEditableRegion() 288removeFontMarkup() 386removeLink() 214, 387RemoveNote() 32removeSpacerFromColumn() 348removeTranslatedAttribute() 293rename() 292renameSelectedItem() 270renameSelectedTemplate() 271renameSelection() 214replace() 375replaceAll() 375replaceRange() 405replaySteps() 122resizeSelection() 387resizeSelectionBy() 339resultsPalette.canClear() 435resultsPalette.canCopy() 435resultsPalette.canCut() 435resultsPalette.canOpenInBrowser()

436resultsPalette.canOpenInEditor()

436resultsPalette.canPaste() 436resultsPalette.canSave() 436resultsPalette.canSelectAll() 437resultsPalette.clear() 136resultsPalette.Copy() 137resultsPalette.cut() 137resultsPalette.debugWindow.addDeb

ugContextData() 145resultsPalette.openInBrowser() 138resultsPalette.openInEditor() 138resultsPalette.paste() 137

resultsPalette.save() 138resultsPalette.selectAll() 139resultsPalette.siteReports.addResultIt

em() 136resWin.addItem() 140resWin.addResultItem() 136resWin.getItem() 141resWin.setCallbackCommands()

142resWin.setColumnWidths() 142resWin.setFileList() 143resWin.setTitle() 143resWin.startProcessing() 144resWin.stopProcessing() 144revealDocument() 108revertDocument() 235revokeIdleHandler() 113rückgängig machen 118, 119, 120,

124Status 122Wiederherstellen 117

rückgängig, Auschecken von Dateien 90

Rücktaste drücken 128Ruft 118runCommand() 225runTranslator() 258runValidation() 215, 240

Ssave() 138saveAll() 236saveAllFrames() 337saveAsCommand() 123saveAsImage() 215saveDocument() 236saveDocumentAs() 237saveDocumentAsTemplate() 237saveFrameset() 237saveFramesetAs() 238saveSitesToPrefs() 194scanSourceString() 257schließen

Design Notes-Dateien 23, 28Dokumente 228

Schlüsselaus Design Notes-Dateien entfernen

27in Design Notes 24in Design Notes-Dateien 25, 28-Liste 29Primär- 59Werte abrufen 29

Schlüssel aus Design Notes-Dateien entfernen 32

Schlüssel-Wert-PaareAnzahl 29erstellen 32in Design Notes-Dateien 24in Design Notes-Dateien erstellen

27Schreibberechtigung für Dateien 13schreibgeschützte Dateien 13Schritte

im Bedienfeld Verlauf 121speichern 123

schwebende Bedienfelder anordnen 344

Schwebende Bedienfelder, Funktionen 171

scrollEndFile() 405scrollLineDown() 406scrollLineUp() 406scrollPageDown() 406scrollPageUp() 407scrollTopFile() 407SCS_AfterPut() 99SCS_BeforeGet() 98SCS_BeforePut() 98SCS_canCheckin() 96SCS_canCheckout() 95SCS_canConnect() 95SCS_canDelete() 97SCS_canGet() 95SCS_canNewFolder() 97SCS_canPut() 96SCS_canRename() 97SCS_CanUndoCheckout() 96SCS_Checkin() 89SCS_Checkout() 90SCS_Connect() 82SCS_Delete() 86SCS_Disconnect() 83SCS_Get() 85SCS_GetAgentInfo() 82SCS_GetCheckoutName() 89SCS_GetConnectionInfo() 87SCS_GetDesignNotes() 93SCS_GetErrorMessage() 92SCS_GetErrorMessageLength() 91SCS_GetFileCheckoutList() 91SCS_GetFolderList() 84SCS_GetFolderListLength() 84SCS_GetMaxNoteLength() 93SCS_GetNewFeatures() 88SCS_GetNoteCount() 92SCS_GetNumCheckedOut() 91

INDEX 466

SCS_GetNumNewFeatures() 88SCS_GetRootFolder() 83SCS_GetRootFolderLength() 83SCS_IsConnected() 83SCS_IsRemoteNewer() 94SCS_ItemExists() 87SCS_NewFolder() 86SCS_Put() 85SCS_Rename() 86SCS_SetDesignNotes() 94SCS_SiteDeleted() 87SCS_SiteRenamed() 88SCS_UndoCheckout() 90SCS-API. Siehe API zur Integration

der QuellcodeverwaltungSeiteninhaltsfunktionen 263Sekundärbrowser 104SELECT 57selectAll() 139, 215, 251, 254selectChild() 394selectHomePage() 216selectNewer() 216selectParent() 394selectParentTag() 407selectTable() 367send() 114senden

Daten 19Text 20

ServerVerhaltensfunktionen 311

Server-Debugging 144Komponentenfunktionen 303

serverdebuginfo (Tag) 145set() 27setActiveWindow() 176setAsHomePage() 217setAttributes() 13setAttributeWithErrorChecking()

387setBlockVisOutlineProperties() 335setCallbackCommands() 142setCloakingEnabled() 217setColumnAutostretch() 348setColumnWidths() 142setConnectionState() 217setCurrentLine() 407setCurrentSite() 218setDivBackgroundColors() 335setEditNoFramesContent() 153setExpanded() 305setFileList() 143

setFloaterVisibility() 177setFocus() 218setHideAllFloaters() 163setHideAllVisualAids() 153setLayerTag() 339setLayout() 218setLinkHref() 387setLinkTarget() 388setLinkVisibility() 219setListBoxKind() 388setListTag() 389setLiveDataError() 309setLiveDataMode() 310setLiveDataParameters() 310setMediaType() 333setMenuDefault() 125SetNote() 32setPreferenceInt() 245setPreferenceString() 246setPreventLayerOverlaps() 153setPrimaryView() 178setRdsPassword() 54setRdsUserName() 54setRulerOrigin() 341setRulerUnits() 342setSelectedBehavior() 279setSelectedItem() 134setSelectedNode() 251setSelectedSteps() 123setSelection() 219, 252, 254setShowBlockBackgrounds() 350setShowBlockBorders() 351setShowBlockIDs() 351setShowBoxModel() 352setShowDependents() 165setShowFrameBorders() 154setShowGrid() 154setShowHeadView() 154setShowHiddenCharacters() 187,

189setShowHiddenFiles() 165setShowImageMaps() 155setShowInvalidHTML() 155setShowInvisibleElements() 155setShowLayerBorders() 156setShowLayoutTableTabs() 352setShowLayoutView() 352setShowLineNumbers() 156setShowNoscript() 398setShowPageTitles() 165setShowRulers() 156setShowStatusBar() 163setShowSyntaxColoring() 157

setShowTableBorders() 157setShowTableWidths() 368setShowToolbar() 157setShowToolbarIconLabels() 169setShowToolTips() 166setShowTracingImage() 158setShowWordWrap() 158setSnapDistance() 178setSnapToGrid() 158setTableCellTag() 368setTableColumns() 368setTableRows() 369setTextAlignment() 389setTextFieldKind() 389setTextFormat() 390setTitle() 143setToolbarItemAttribute() 169setToolbarPosition() 170setToolbarVisibility() 170setTracingImageOpacity() 342setTracingImagePosition() 342setTranslatedAttribute() 293setUndoState() 124setUpComplexFind() 376setUpComplexFindReplace() 376setUpFind() 377setUpFindReplace() 377setView() 172showAboutBox() 110showColdFusionAdmin() 54showConnectionMgrDialog() 54showDynamicData() 110showFindDialog() 378showFindReplaceDialog() 379showFontColorDialog() 390showGridSettingsDialog() 344showInfoMessagePopup() 241showInsertTableRowsOrColumnsDi

alog() 369showListPropertiesDialog() 388showLiveDataDialog() 311showOdbcDialog() 55showPagePropertiesDialog() 241showPreferencesDialog() 111showProperties() 178showQuickTagEditor() 395showRdsUserDialog() 55showReportsDialog() 191showRestrictDialog() 55showResults() 135showResultset() 65showSPResultset() 66showSPResultsetNamedParams() 66

INDEX 467

showTagChooser() 112, 411showTagLibraryEditor() 411showTargetBrowsersDialog() 247sichtbar 172sichtbare Dateien 13Site

canViewAsRoot() 448displaySyncInfoForFile() 201selectNewer() 216setShowPageTitles() 165setShowToolTips() 166

siteaddLinkToExistingFile() 196addLinkToNewFile() 197browseDocument() 439canAddLinkToFile() 440canChangeLink() 440canCheckIn() 440canCheckOut() 441canCloak() 441canConnect() 442canDisplaySyncInfoForFile() 442canEditColumns() 418canFindLinkSource() 442canGet() 443canLocateInSite() 443canMakeEditable() 444canMakeNewFileOrFolder() 444canOpen() 444canPut() 444canRecreateCache() 445canRefresh() 445canRemoveLink() 445canSelectAllCheckedOutFiles() 446canSelectNewer() 446canSetLayout() 446canSynchronize() 447canUncloak() 447canUndoCheckOut() 447changeLink() 197changeLinkSitewide() 197checkIn() 197checkLinks() 198checkOut() 198checkTargetBrowsers() 199cloak() 199, 200defineSites() 200deleteSelection() 200deployFilesToTestingServerBin()

201editColumns() 202exportSite() 202findLinkSource() 203

get() 204getAppServerAccessType() 204getAppServerPathToFiles() 205getAppURLPrefixForSite() 205getCheckOutUser() 206getCheckOutUserForFile() 206getCloakingEnabled() 206getConnectionState() 207getCurrentSite() 207getFocus() 207getLinkVisibility() 208getLocalPathToFiles() 208getSelection() 208getShowDependents() 163getShowHiddenFiles() 164getShowPageTitles() 164getShowToolTips() 164getSiteForURL() 208getSites() 209importSite() 209invertSelection() 210isCloaked() 210locateInSite() 210makeEditable() 211makeNewDreamweaverFile() 211makeNewFolder() 211newHomePage() 212newSite() 212open() 212put() 213recreateCache() 213refresh() 213remoteIsValid() 214removeLink() 214renameSelection() 214runValidation() 215saveAsImage() 215selectAll() 215selectHomePage() 216setAsHomePage() 217setCloakingEnabled() 217setConnectionState() 217setCurrentSite() 218setFocus() 218setLayout() 218setLinkVisibility() 219setSelection() 219setShowDependents() 165setShowHiddenFiles() 165synchronize() 220uncloak() 220uncloakAll() 220undoCheckOut() 221

viewAsRoot() 221site root, Design Notes-Dateien 25,

30Site, Auswahlfunktionen im

Bedienfeld 191Site, Informationen für alle Sites 193Site-Berichte 134Sitefunktionen 191Sites

gelöschte 87lokaler Stammordner 248umbenannte 88

siteSyncDialog.compare() 194siteSyncDialog.markDelete() 194siteSyncDialog.markGet() 195siteSyncDialog.markIgnore() 195siteSyncDialog.markPut() 195siteSyncDialog.markSynced() 196siteSyncDialog.toggleShowAllFiles()

196snapToGuides() 361snapTracingImageToSelection() 343snippetPalette.getCurrentSnippetPat

h() 290snippetPalette.newFolder() 290source.applyComment() 187source.refreshVariableCodeHints()

188source.removeComment() 188Spalten 57, 58, 59

aus Anweisungen abrufen 57aus gespeicherten Prozeduren

abrufen 61, 62aus Tabellen abrufen 59-breiten im Ergebnisfenster 142Ergebnissätze 61, 62Größe bestimmen 347in SQL SELECT 57Namen 59Typen 57

Spaltenraum verkleinern 362speichern

Design Notes-Dateien 23Dokumente 236Verlaufsschritte 123

sperren, Hilfslinien 358splitFrame() 337splitTableCell() 369Spry

Widget-Bearbeitungsfunktionen 292

Widget-Funktionen einfügen 294SQL SELECT 57SQL-Anweisungen 65

Ergebnisse anzeigen 65

INDEX 468

Spalten abrufen 57Stammordnernamen 83Standardansicht 347startOfDocument() 131, 408startOfLine() 132, 408startProcessing() 144startRecording() 119statusCode-Eigenschaft 15Stile

anwenden 321, 327Darstellung 329, 333duplizieren 328entfernen 324Liste 331löschen 327Namen abrufen 330umbenennen 332

stopAllPlugins() 343stoppen

Aufzeichnung 120Plug-In-Inhalte 343

stopPlugin() 343stopProcessing() 144stopRecording() 119Strings

Dateiinhalt 12in Dateien schreiben 14

stripTag() 394Stylesheets 327Suche 134suppressStartupScreen() 114SWFFile.createFile() 40SWFFile.getNaturalSize() 41SWFFile.getObjectType() 42SWFFile.readFile() 42Symbolleiste einblenden 157Symbolleistenfunktionen 166synchronize() 220synchronizeDocument() 409Systemton 109

TTabellen

Datenbank- 64in Ebenen konvertieren 223Layout 345Liste abrufen 64Platzhalter in 344, 346Spalten 58, 59Spalten abrufen 59

Tabellen anzeigen 64Tabellenbearbeitungsfunktionen

362

Tag-Auswahl (Dialogfeld) 112Tag-Editor- und Tag-Bibliothek-

Funktionen 410Tags

Ebenen 339einfügen 112font 379

Tastaturfunktionen 126Tasten

Bild ab 130Bild auf 130Entf 128Rücktaste 128

Tastencode in Zeichen umsetzen 132teilen, Frames 337testAppServer() 318testConnection() 56Text

abrufen 118Bearbeitungsaktion 118senden 20

Texteditor, externer 103tileHorizontally() 179tileVertically() 179toggleFloater() 179toggleShowAllFiles() 196topPage() 408Tracing-Bilder

ausrichten 343Transparenz 340

translatedStyle 294Transparenz, Tracing-Bild 340Treiber, JDBC- 48, 49Treibernamen 48Trennen der Verbindung zum

Quellcode-Verwaltungssystem 83

type (Attribut) 289Typen, Spalten- 57typografische Konventionen 4

UÜber (Dialogfeld) 110überlappende Dokumentfenster 173Übersetzungsfunktionen 258umbenannte Sites 88umbenennen

Dateien 86Stile 332

Umschaltfunktionen 146uncloak() 220uncloakAll() 220undo() 117, 120undoCheckOut() 221

ungültiger HTML-Code 147, 149, 161

updateCurrentPage() 288updatePages() 288updateReference() 180URLs

absolute Datei-URL 249Dateien speichern von 17, 18Dateiinhalt speichern von 18Daten senden an 19dekodieren 242im Browser öffnen 101relative 249zur Flash-Anwendung 103

useTranslatedSource() 260

VvalidateFireworks() 36validateFlash() 107validieren, Dokumente 240verarbeiten, Dateien 143, 144verbinden mit Quellcode-

Verwaltungssystemen 82Verbindungen 53

definieren 72finden 71HTML-Code erzeugen 72JDBC 48Liste abrufen 47, 56Quellcode-Verwaltungssysteme 83,

87spezifischen Namen abrufen 47

Verbindungs-Definitionsdatei 74Verbindungsnamen 47Verbindungsobjekte 46

Eigenschaften 71Verbindungsstrings 47, 48

Test 56Verbindungstypen

erstellen 69Laufzeit 51

Verbindungsverwaltung, Datenbank 45

vergleichen, Remote- und lokale Dateien 94

Vergrößerung 353Vergrößerungsfaktor der Ansicht

353Vergrößerungsfunktionen 353Verhaltensfunktionen 272

Server- 311verkleinern

Spaltenraum 362Zeilenraum 363

INDEX 469

Verlauf (Bedienfeld) 120, 121Schritte im 121

Verlaufsfunktionen 117Verlaufsschritte

auswählen 123JavaScript-Äquivalent 122kopieren 120wiedergeben 122

verschiebenEbenen 339Einfügemarke 127, 128Hotspots 339

VersionenFireworks 36Flash MX 107Quellcode-Verwaltungssystem 82

Versionsname, gemeinsam genutzte Bibliothek MMNotes 25, 30

Versionsnummer, gemeinsam genutzte Bibliothek MMNotes 26, 31

versteckte Dateien 13viewAsRoot() 221Visuelle Hilfsmittel

Layoutblock-Box-Modell 323visuelle Hilfsmittel 147, 152, 334, 335

Layoutblock-Box-Modell 325, 333Layoutblock-Hintergründe 322,

325, 334Layoutblock-Konturen 323, 326

VordergrundDreamweaver im 33Fireworks im 33

Voreinstellungen (Dialogfeld) 111Vorhandensein,

Datenbankverbindungen 52Vorlagen- und

Bibliotheksfunktionen 284

WWarnung 109Webseiteninhaltsfunktionen 263Widgets, Spry

Bearbeitungsfunktionen 292Einfügefunktionen 294

wiedergebenaufgezeichnete Befehle 119Plug-In-Inhalte 341

wiedergeben, Verlaufsschritte 122wiederherstellen

Auschecken 90Dokumente 235

Wiederherstellen von Arbeitsschritten 117

window.getDeclaredStyle() 297

wrapSelection() 409wrapTag() 395write() 14

XXHTML

Dokument testen 227erstellen 229konvertieren in 226optimieren 225

XHTML-Dokumente optimieren 225

XML-DateienDateifragmente 289erstellen 230importieren 233

ZZeilenanfang 132Zeilennummern 150, 156, 160, 162Zeilenraum verkleinern 363Zeilenumbruch 158, 161, 162Zeitpunkt

der Dateierstellung 10letzte Dateiänderung 9

Zielbrowser-Prüfung durchführen 239

zoomIn() 354zoomOut() 355Zwischenablagefunktionen 279

INDEX 470

DREAMWEAVER API-REFERENZHANDBUCH - help.adobe.com · Dreamweaver sowie Details zur Flash-Objekt-API...

Documents

Transcript of DREAMWEAVER API-REFERENZHANDBUCH - help.adobe.com · Dreamweaver sowie Details zur Flash-Objekt-API...