DREAMWEAVER 8 - Éditeur HTML MACROMEDIA - Notice d'utilisation et mode d'emploi gratuit

Type de produit	Logiciel de création et d'édition de sites Web (éditeur HTML)
Marque	Macromedia
Modèle	Dreamweaver 8
Version	8
Langue de l'interface	Français (et multilingue via traduction)
Fonctions principales	Édition HTML/CSS, intégration Fireworks & Flash, gestion de bases de données, API extensible (JavaScript, C), Design Notes, contrôle de source, modèles et bibliothèques
API disponibles	API fichiers, HTTP, Design Notes, Fireworks, Flash, bases de données, connectivité bases de données, JavaBeans, intégration source
Compatibilité	Windows 2000/XP, Mac OS X
Nouveautés version 8	Fonctions CSS avancées, mode de mise en forme, zoom, guides, fractionnement de code, barre d'outils mode Code
Formats de sortie	HTML, XHTML, ASP, ASP.NET, PHP, ColdFusion, JSP
Entretien et nettoyage	Mise à jour par patchs ; pas de nettoyage physique
Sécurité	Gestion des paramètres de site et contrôle d'accès via Design Notes et contrôle de source
Pièces détachées et réparabilité	Non applicable (logiciel) ; extensions disponibles via API

FOIRE AUX QUESTIONS - DREAMWEAVER 8 MACROMEDIA

Quels sont les prérequis système pour Dreamweaver 8 ?

Dreamweaver 8 fonctionne sous Windows 2000/XP ou Mac OS X. Aucune configuration détaillée n'est fournie dans la notice, mais un processeur rapide et 512 Mo de RAM sont recommandés.

Dreamweaver 8 est-il compatible avec les versions antérieures ?

Oui, Dreamweaver 8 prend en charge les projets créés avec Dreamweaver MX et versions ultérieures. Les fichiers de configuration sont conservés dans un dossier utilisateur.

Comment installer Dreamweaver 8 ?

L'installation se fait via un programme d'installation standard. La notice d'utilisation n'est pas disponible en français dans sa version d'origine, mais vous pouvez demander une traduction via le site notice-facile.com.

Quelles sont les principales nouveautés de Dreamweaver 8 ?

Dreamweaver 8 introduit des fonctions CSS avancées (rendu Internet Explorer), le mode de mise en forme avec visualisation des blocs, le zoom, les guides, le fractionnement de code et une barre d'outils de code enrichie.

Dreamweaver 8 permet-il de travailler avec des bases de données ?

Oui, Dreamweaver 8 inclut une API de base de données et une API de connectivité qui permettent de se connecter à des bases de données et de générer des connexions pour ASP, PHP, ColdFusion, etc.

Comment étendre les fonctionnalités de Dreamweaver 8 ?

Dreamweaver 8 dispose d'API JavaScript et C pour créer des extensions : objets, commandes, comportements, panneaux flottants, etc. La notice fournit une documentation complète des API.

Dreamweaver 8 peut-il s'intégrer à Fireworks et Flash ?

Oui, via les API FWLaunch et Flash, Dreamweaver peut communiquer avec Fireworks et Flash pour optimiser des images, insérer des éléments Flash, etc.

Comment gérer les notes de conception (Design Notes) ?

Les Design Notes sont des fichiers XML stockant des paires clé/valeur pour chaque document. Dreamweaver utilise l'API MMNotes pour les lire et les écrire. Elles permettent de conserver des commentaires, des sources, etc.

Est-ce que Dreamweaver 8 supporte le contrôle de source ?

Oui, via l'API d'intégration de commande source, Dreamweaver peut s'intégrer à des systèmes de gestion de versions comme CVS ou SourceSafe.

Comment obtenir de l'aide supplémentaire pour Dreamweaver 8 ?

Vous pouvez consulter le forum d'extensibilité de Macromedia à l'adresse www.macromedia.com/go/extending_newsgrp. La notice mentionne également un centre de support pour les errata.

MODE D'EMPLOI DREAMWEAVER 8 MACROMEDIA

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breeze, Captivate, Central, ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite, FlashPaper, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev et WebHelp sont soit des marques de commerce, soit des marques déposées de Macromedia, Inc. qui peuvent être déposées aux États-Unis ou sous toute autre juridiction. Les autres noms de produits, logos, graphiques, mises en page, titres, mots ou phrases mentionnés dans cette publication peuvent être des marques, des marques de service ou des noms de marque apparentant à Macromedia, Inc. ou à d'autres entités et peuvent être déposées dans certains pays, états ou provinces.

Informations de tiers

Ce manuel contient des liens vers des sites Web tiers qui ne sont pas contrôlés par Macromedia et Macromedia ne peut en aucun cas être tenu responsable du contenu de ces sites. Si vous accédez à l'un de ces sites, vous le faites à vos propres risques. Macromedia propose ces liens dans un but pratique uniquement et ne peut en aucun cas endosser ou accepter la responsabilité du contenu de ces sites tiers.

Navigateur Opera * Copyright © 1995-2002 Opera Software ASA et ses fournisseurs. Tous droits réservés.

Copyright © 2005 Macromedia, Inc. Tous droits réservés. Le présent manuel ne doit faire l'objet d'aucune copie, photocopie, reproduction, traduction ou conversion sous quelque forme que ce soit, électronique ou lisible par machine, sans le consentement écrit de Macromedia, Inc. Nonobstant ce qui précède, le propriétaire ou l'utilisateur autorisé d'une copie valide du logiciel avec lequel le présent manuel a été fourni peut imprimer un exemplaire de ce manuel, à partir d'une version électronique de celui-ci, aux fins exclusives d'apprendre à utiliser ledit logiciel, pour autant qu'aucune partie du manuel ne soit imprimée, reproduite, distribuée, revendue ou transmise à toute autre fin, y compris de manière non exhaustive des fins commerciales telles que la vente d'exemplaires de cette documentation ou la fourniture de services d'assistance payants.

Remerciements

Gestion du projet : Charles Nadeau, Robert Berry

Réduction : Anne Sandstrom

Mise en forme : Anne Szabla, John Hammett

Gestion de la production et de l'édition : Patrice O'Neill et Rosana Francescato

Conception et production : Adam Barnett, Aaron Begley, Paul Benkman, John Francis, Geeta Karmarkar, Paul Rangel, Arena Reed, Mario Reynoso

Gestion de la localisation : Melissa Baerwald

Remerciements particuliers à Jay London, Raymond Lim, Alain Dumesny, Masayo Noda, Kristin Conradi, Yuko Yagi, ainsi qu'à tous les membres des équipes techniques et d'assurance qualité de Dreamweaver.

Première édition : septembre 2005

Macromedia, Inc.

601 Townsend St.

San Francisco, CA 94103

Table des matières

Arrière-plan 8 Extension de Dreamweaver 8 Ressources supplémentaires pour les créateurs d'extensions. 8 Nouvelles fonctions de Dreamweaver 8 9 Fonctions supprimées 14 Errata. 14 Conventions utilisées dans ce manuel. 14

Chapitre 1: API d'e/s des fichiers. 17

Accès aux fichiers de configuration 17 L'API d'E/S des fichiers 17

Chapitre 2: API HTTP 29

Fonctionnement de l'API HTTP 29 L'API HTTP 30

Chapitre 3: API de design notes. 39

Fonctionnement de Design Notes 39 API JavaScript de Design Notes 40 API C de Design Notes 46

Chapitre 4: intégration de fireworks. 55

L'API FWLaunch 55

Chapitre 5: intégration de flash. 63

Fonctionnement des éléments Flash 63 Insertion des éléments Flash 64 L'API des objets Flash 65

Chapitre 6: API de base de données 71

Fonctionnement de l'API de bases de données 71

Fonctions de connexion à une base de données 72

Fonctions d'accès à la base de données 89

Chapitre 7: API de connectivité à une base de données. 105

Développement d'un nouveau type de connexion 105

L'API de connexion. 107

Fichier inclus génére 111

Fichier de définition pour votre type de connexion 113

Chapitre 8: API JavaBeans 117

L'API JavaBeans 117

Chapitre 9: API d'intégration de commande source. 123

Fonctionnement de l'intégration des commandes source avec

Dreamweaver 124

Ajout d'une fonctionnalité de système de commande source......125

Fonctions obligatoires de l'API d'intégration de commande source 125

Fonctions facultatives de l'API d'intégration de commande source 132

Activateurs 143

Chapitre 10 : Application 153

Fonctions relatives aux applications externes. 153

Fonctions globales relatives aux applications 162

Chapitre 11 : Espace de travail. 167

Fonctions relatives à l'historique 167

Fonctions d'insertion d'objets 177

Fonctions relatives au clavier 179

Fonctions relatives aux menus 188

Fonctions de la fenêtre de résultats 189

Fonctions de bascule 205

Fonctions relatives aux barres d'outils 229

Fonctions relatives aux fenêtres. 236

Fonctions relatives au fractionnement des codes 249

Fonctions relatives aux barres d'outils du mode Code 257

Chapitre 12: Site. 263

Fonctions relatives aux rapports 263

Chapitre 13 : Document 307

Fonctions relatives aux conversions 307

Fonctions relatives aux commandes 308

Fonctions relatives aux manipulations de fichiers 310

Fonctions globales relatives aux documents 330

Fonctions relatives aux chemins 342

Fonctions relatives à la sélection 346

Fonctions de manipulation de chaînes 354

Fonctions relatives à la traduction 359

Fonctions XSLT 361

Chapitre 14 : Contenu de page 365

Fonctions du panneau Actifs 365

Fonctions relatives aux comportements 379

Fonctions relatives au Presse-papiers. 390

Fonctions relatives aux éléments de bibliothèque et aux modèles. 396

Fonctions du panneau Fragments de code 402

Chapitre 15 : Documents dynamiques 407

Fonctions de composants de serveur 407

Fonctions relatives aux sources de données 408

Fonctions de l'Extension Data Manager 409

Fonctions Live data 412

Fonctions relatives aux comportements de serveur 418

Fonctions de modèle de serveur 420

Chapitre 16 : Conception 431

Fonctions CSS. 431

Fonctions relatives aux cadres et aux yeux de cadres. 454

Fonctions relatives aux calques et aux cartes graphiques 456

Fonctions d'environnement de mise en forme. 459

Fonctions relatives au mode de Mise en forme 467

Fonctions relatives aux zooms 479

Propriétés et fonctions du guide 483

Fonctions de modification des tableaux 494

Chapitre 17: Code. 507 Fonctions de code. 507 Fonctions relatives à la recherche et au remplacement 512 Fonctions de modifications générales 519 Fonction relative à l'impression 539 Fonctions relatives à Quick Tag Editor 540 Fonctions relatives au mode Code 543 Fonctions de l'éditeur de balises et de la bibliothèque de balises..563

Chapitre 18: Activateurs 569

Activateurs 569

Index 617

Le Guide des API de Dreamweaver déscrit deux interfaces de programmation d'applications (API) qui vous permettent d'effectuer diverses tâches de prise en charge lorsque vous développez des extensions Macromedia Dreamweaver 8 et ajoutez des codes de programme à vos pages Web Dreamweaver. Ces deux API sont l'API des utilisaires et l'API JavaScript. L'API des utilisaires contient des sous-ensembles de fonctions liées qui permettent d'effectuer des types de tâches spécifique. Il comprend les sous-ensembles suivants :

l'API d'E/S des fichiers, qui permet un accès en lecture et en écriture aux fichiers du système local; l'API HTTP, qui permet d'envoyer et de recevoir des informations à partir d'un serveur Web; l'API de Design Notes, qui permet de stocker et d'extraire les notes relatives aux documents; l'API d'intégration de Fireworks, qui permet de communiquer avec Macromedia Fireworks; l'intégration Flash, qui contient des informations concernant l'ajout d'éléments Flash à l'interface utilisateur Dreamweaver et sur l'API des objets Flash (qui permet de créer des objets pour le contenu Macromedia Flash); l'API de base de données, qui permet d'accéder aux informations stockées dans les bases de données et de générer les connexions à ces bases de données; l'API de connectivité à une base de données, qui permet de créer un nouveau type de connexion et les boîtes de dialogue correspondantes pour les modèles de serveur nouveaux et existants; l'API JavaBeans, qui extrait les noms de classe, les méthodes, les propriétés et les événements définis pour JavaBeans; l'API d'intégration de contrôle source, qui permet d'écrire des bibliothèques partagées, pour étendre la fonction Archiver/Extraire de Dreamweaver.

L'API JavaScript permet d'effectuer plusieurs tâches mineures généralement effectuées par l'utilisateur lors de la création ou de la modification de documents Dreamweaver. Ces fonctions d'API sont regroupées selon les parties de l'interface utilisée de Dreamweaver auxquelles elles se rapportent. Ainsi, l'API JavaScript comprend les fonctions relatives à l'espace de travail, aux documents, à la conception, etc. Ces fonctions vous permettent d'effectuer des tâches telles que : ouvrir un nouveau document, obtenir ou définir une taille de police, trouver l'occurrence d'une chaîne de recherche en code HTML, afficher une barre d'outils, etc.

Arrière-plan

Ce manuel suppose une bonne maîtrise de Dreamweaver, HTML, XML, de la programmation JavaScript et, le cas échéant, de la programmation C. Pour rédiger vos propres extensions afin de créer des applications Web, vous devez connaître les langages de script côté serveur et au moins l'une des plates-formes suivantes : Active Server Pages (ASP), ASP.NET, PHP: Hypertext Preprocessor (PHP), ColdFusion ou Java Server Pages (JSP).

Extension de dreamweaver

Pour en savoir plus sur la plate-forme Dreamweaver et l'API permettant de développer des extensions de Dreamweaver, voir Extension de Dreamweaver. Le manuel Extension de Dreamweaver déscrit les fonctions des API que Dreamweaver appelle pour implémenter les objets, menus, panneaux flottants, comportements de serveur, etc., qui forment les diverses fonctionnalités de Dreamweaver. Ces API permettent d'ajouter des objets, des menus, des panneaux flottants et d'autres fonctions au produit. Extension de Dreamweaver explique également comment personnelier Dreamweaver en modifierant et en ajoutant des balises à divers fjichiers HTML et XML, de façon à ajouter des types d' éléments, des éléments de menus, etc.

Ressources supplémentaires pour les créateurs d'extensions

Pour entrer en contact avec d'autres développeurs, vous pouvez rejoindre le forum de discussion consacré à l'extensibilité de Dreamweaver. Pour ce faire, il vous suffit de vous rendre à l'adresse suivante: www.macromedia.com/go/extending_newsgrp.

Nouvelles fonctions de dreamweaver 8

Les fonctions suivantes ont été ajoutées à l'API JavaScript de Dreamweaver 8. Les en-têtes désignent les chapitres et les sections qui contiennent les nouvelles fonctions :

Application

Les fonctions suivantes (fonctions globales relatives aux applications) ont été ajoutées au chapitre Application.

Application globale

dreamweaver.showPasteSpecialDialog(), page 165 dreamweaver.showPreferencesDialog(), page 165 (nouvel argument ajouté)

Espace de travail

Les nouvelles fonctions Fenêtre, Fractionnement de code et barre d'outils du mode Code ci-dessous ont été ajoutées au chapitre Espace de travail.

Fenêtre

dreamweaver.cascade(), page 239 (prise en charge supplémentaire pour Macintosh) dreamweaver.tileHorizontally(), page 246 (prise en charge supplémentaire pour Macintosh) dreamweaver.tileVertically(), page 247 (prise en charge supplémentaire pour Macintosh)

Fractionnement de code

domcollapseFullTag(), page 249 dom-collapseSelectedCodeFragment(), page 250 dom-collapseSelectedCodeFragmentInverse(), page 251 dom expandAllCodeFragments(), page 252 dom expandSelectedCodeChunks(), page 252 dreamweaver.htmlInspector-collapseFullTag(), page 253 dreamweaver.htmlInspector-collapseSelectedCodeFragment(), page 254 dreamweaver.htmlInspector-collapseSelectedCodeFragmentInverse(), page 255 dreamweaver.htmlInspector expandAllCodeFragments(), page 255

dreamweaver.htm1Inspector expandSelectedCodeFragments(), page 256

Barre d'outils du mode code

dom. getOpenPathName(), page 257 dom. getShowHiddenCharacters(), page 257 dom. setShowHiddenCharacters(), page 258 dom. source. applyComment(), page 258 dom. source. removeComment(), page 259 dreamweaver. html Inspector. getShowHiddenCharacters(), page 260 dreamweaver. htmlInspector. setShowHiddenCharacters(), page261

Les nouvelles fonctions suivantes (fonctions relatives aux sites) ont été ajoutées au chapitre Site.

dom.getSiteURLPrefixFromDoc(), page 264 dom.localPathToSiteRelative(), page 265 dom.siteRelativeToLocalPath(), page 265 dreamweaver.compareFiles(), page 266 dreamweaver.siteSyncDialog(compare(), page 268 dreamweaver.siteSyncDialog_markDelete(), page 268 dreamweaver.siteSyncDialog_markGet(), page 269 dreamweaver.siteSyncDialog_emarkIgnore(), page 269 dreamweaver.siteSyncDialog_markPut(), page 269 dreamweaver.siteSyncDialog_markSynced(), page 270 site.compareFiles(), page 275 site.getAppURLPrefixForSite(), page 282 site.getSiteURLPrefix(), page 288 site.serverActivity(), page 298 site.siteRelativeToLocalPath(), page 302

Les nouvelles fonctions suivantes (fonctions relatives aux manipulations de fichiers) ont été ajoutées au chapitre Document.

Manipulation de fichiers

dreamweaver.getNewDocumentDOM(), page 321 (nouvel argument ajouté) MMXSLT.getXMLSchema(), page 362 MMXSLT.getXMLSourceURI(), page 362 MMXSLT.launchXMLSourceDialog(), page 363

Les nouvelles fonctions suivantes (fonctions relatives au Presse-papiers) ont été ajoutées au chapitre Page.

Presse-papiers

dreamweaver clipPaste(), page 394 (nouvel argument ajouté)

Conception

Les nouvelles fonctions CSS, mode Mise en forme et Zoom ci-dessous ont été ajoutées au chapitre Conception :

■ cssStylePalette. getInternetExplorerRendering(), page 431 ■ cssStylePalette. setInternetExplorerRendering(), page432 dom. getElementView(), page 433 dom. getShowDivBackgrounds(), page 434 dom. getShowDivBoxModel(), page 435 dom. getShowDivOutlines(), page 435 dom. resetAllElementViews(), page436 dom. setElementView(), page437 dom. setShowDivBackgrounds(), page 438 dom. setShowDivBoxModel(), page438 dom. setShowDivOutlines(), page 439

dreamweaver. cssStylePalette. applySelectedStyle(), page 440 (nouvel argument ajoute) dreamweaver. cssStylePalette deleteSelectedStyle(), page 441 (nouvel argument ajoute) dreamweaver. cssStylePalette. duplicateSelectedStyle(), page 442 (nouvel argument ajoute) dreamweaver. cssStylePalette_editSelectedStyle(), page 443 (nouvel argument ajoute) dreamweaver. cssStylePalette_editSelectedStyleInCodeview(), page443 dreamweaver. cssStylePalette. getDisplayStyles(), page444 dreamweaver. cssStylePalette. renameSelectedStyle(), page448 dreamweaver. cssStylePalette. setDisplayStyles(), page449 dreamweaver. getBlockVisBoxModelColors(), page 450 dreamweaver. getBlockVisOutlineProperties(), page 451 dreamweaver. getDivBackgroundColors(), page 451 dreamweaver. setBlockVisOutlineProperties(), page452 dreamweaver. setDivBackgroundColors(), page453

Mode de mise en forme

dom. getShowBlockBackgrounds(), page 474 dom. getShowBlockBorders(), page 474 dom. getShowBlockIDs(), page 475 dom. getShowBoxModel(), page 476 dom. setShowBlockBackgrounds(), page 476 dom. setShowBlockBorders(), page 477 dom. setShowBlockIDs(), page477 dom. setShowBoxModel(), page478

dreamweaver. activeViewScale(), page 479 dreamweaver. fitAll(), page 480 dreamweaver. fitSelection(), page 481 dreamweaver. fitWidth(), page 481 dreamweaverzoomIn(), page482

dreamweaverzoomOut(), page482

Guide

dom. clearGuides(), page483 dom. createHorizontalGuide(), page 484 dom. createVerticalGuide(), page485 dom deleteHorizontalGuide(), page 486 dom(deleteVerticalGuide(), page486 domassium, page 487 domassium, page 488 domassium, page 488 domassium, page 489 domassium, page 489 dom. hasGuides(), page 491 dom. hasHorizontalGuide(), page 491 dom. hasVerticalGuide(), page 492

Activateurs

Les nouvelles fonctions suivantes ont été ajoutées au chapitre Activateurs.

dreamweaver. canFitSelection(), page 586 dreamweaver. canPasteSpecial(), page 586 dreamweaver. canZoom(), page 592 dreamweaver. cssStylePalette. canApplySelectedStyle(), page 593 (nouvel argument ajouté) dreamweaver. cssStylePalette. canDeleteSelectedStyle(), page 593 (nouvel argument ajouté) dreamweaver. cssStylePalette. canDuplicateSelectedStyle(), page 594 (nouvel argument ajouté) dreamweaver. cssStylePalette. canEditSelectedStyle(), page 595 (nouvel argument ajouté) dreamweaver. cssStylePalette. canEditSelectedStyleInCodeview(), page 595 dreamweaver. cssStylePalette. canRenameSelectedStyle(), page 596 dreamweaver. siteSyncDialog. canCompare(), page 600 dreamweaver. siteSyncDialog. canMarkDelete(), page 601

dreamweaver. siteSyncDialog. canMarkGet(), page 601 dreamweaver. siteSyncDialog. canMarkIgnore(), page 602 dreamweaver. siteSyncDialog. canMarkPut(), page 602 dreamweaver. siteSyncDialog. canMarkSynced(), page 603 site. canCompareFiles(), page 607

Fonctions supprimées

Les fonctions suivantes ont été supprimées de l'API Dreamweaver 8, car les fonctions associées ont été supprimées du produit.

Errata

Vous trouverez une liste des problèmes connus dans la section Extensibility (Extension) du centre de support de Dreamweaver (www.macromedia.com/go/extending_errata).

Conventions utilisées dans ce manuel

Ce manuel utilise les conventions typographiques suivantes :

• La police de code indique des fragments de code et des constantes d'API, notamment des noms de classe, des noms de méthodes, des noms de fonctions, des noms de type, des scripts, des instructions SQL et des noms de balises et d'attributs HTML et XML. La police de code en italique identifie les éléments replacables dans le code. Le symbole de continuation () indique qu'une longue ligne de code a été fractionnée sur deux lignes ou plus. En raison des limites de marge du format de ce manuel, une ligne de code continue doit ici être coupée. Lorsque vous copiez les lignes de code, supprimez le symbole de continuation et entrez-les comme une seule ligne.
• Les accolades ({}) placées avant et après un argument de fonction indiquent que cet argument est facultatif. Le nom des fonctions ayant le préfixe dreamweaver.nomfonc peut être abrégé en dw.nomfonc lorsque vous écrivez le code. Ce manuel utilise le préfixe dreamweaver. complet dans les définitions de fonctions et dans l'index. Toutefois, dans de nombreux exemples, le préfixe dw. est utilisé.

Conventions de noms utilisées dans ce manuel :

• Vous — le développement responsable de la réduction des extensions L'utilisateur — la personne utilisant Dreamweaver

PARTIE1 API D'utilitaire

Etudiez les fonctions utilisables de Macromedia Dreamweaver 8 qui vous permettent d'accéder aux fichiers locaux ainsi qu'aux fichiers placés sur un site, de travailler avec des objets Macromedia Fireworks et Macromedia Flash, de gérer des connexions aux bases de données, de créer des types de connexion aux bases de données, d'accéder aux composants JavaBeans et d'intégrer Dreamweaver à divers systèmes de commande source.

Chapitre 1: API d'E/S des fichiers. 17 Chapitre 2: API HTTP. 29 Chapitre 3 : API de Design Notes. 39 Chapitre 4: Intégration de Fireworks. 55 Chapitre 5: Intégration de Flash 63 Chapitre 6: API de base de données. 71 Chapitre 7: API de connectivité à une base de données. 105 Chapitre 8: API JavaBeans. 117 Chapitre 9: API d'intégration de commande source 123

Macromedia Dreamweaver 8 inclut une bibliothèque partagée C, appelée DWfile, qui donne aux auteurs d'objets, de commandes, de comportements, de traducteurs de données, de panneaux flottants et d'inspecteurs de propriétés la possibilité de lire et d'écrire des fichiers sur le système de fichiers local. Ce chapitre décrit l'API d'entrée/sortie des fichiers et son utilisation.

Pour obtenir des informations générales sur la façon dont les bibliothèques C interagissent avec l'interpréteur JavaScript dans Dreamweaver, voir Extensibilité de niveau C dans le manuel Extension de Dreamweaver.

Accès aux fichiers de configuration

Sur les plates-formes Microsoft Windows 2000, Windows XP et Mac OS X, les utilisateurs disposent de leur propre copie des fichiers de configuration. Chaque fois que Dreamweaver écrit dans un fichier de configuration, il le fait dans le dossier Configuration de l'utilisateur. De même, lorsqu'il lit un fichier de configuration, Dreamweaver commence par rechercher ce fichier dans le dossier Configuration de l'utilisateur, puis dans le dossier Configuration de l'application. Les fonctions DWfile précédent de la même manière. En d'autres termes, si une extension lit ou écrit un fichier dans le dossier Configuration de l'application, elle se reporte aussi au dossier Configuration de l'utilisateur. Pour plus d'informations sur les dossiers Configuration dans un environnement multiutilisateur, voir Extension de Dreamweaver.

L'api d'e/s des fichiers

Toutes les fonctions de l'API d'E/S des fichiers sont des méthodes associées à l'objet DWfile.

Disponibilité

Dreamweaver 3.

Description

Cette fonction copie le fichier spécifique vers un nouvel emplacement.

Arguments

originalURL, copyURL

L'argument originalURL, exprime sous la forme d'une URL de type file://, représente le fichier que vous souhaitez copier. L'argument copyURL, exprime sous la forme d'une URL de type file://, représente l'emplacement où vous souhaitez enregistrer le fichier copie.

Valeurs renvoyées

Valeur booléenne : true si la copie réussit et false dans le cas contraire.

Le code suivant copie un fichier appelé myconfig.cfg vers myconfig Backup.cfg :

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

Disponibilité

Dreamweaver 2.

Description

Cette fonction crée un dossier à l'emplacement spécifique.

Arguments

folderURL

L'argument folderURL, exprime sous la forme d'une URL de type file://, représente l'emplacement auquel vous souhaitez créer le dossier.

Valeurs renvoyées

Valeur booléenne : true si la création du dossier a réussi et false dans le cas contraire.

Le code suivant tente de créer un dossier nommé tempFolder à la racine du lecteur C et affiche un message d'avertissement indiquant si l'opération a réussi.

var folderURL = "file://c///tempFolderer"; if (DWfile.createFolderer(folderURL)){ alert("Created " ^+ folderURL); }else{ alert("Unable to create" ^+ folderURL); }

Disponibilité

Dreamweaver 2.

Description

Cette fonction vérifie l'existence du fichier spécifique.

Arguments

fileURL

L'argument fileURL, exprimé sous la forme d'une URL de type file://, représente le fichier requis.

Valeurs renvoyées

Valeur booléenne: true si le fichier existe et false dans le cas contraire.

Le code suivant recherche le fichier mydata. txt et affiche un message d'avertissement indiquant à l'utilisateur si le fichier existe :

var fileURL = "file://c|/temp/mydata. txt"; if (DWfile_exists(fileURL)){ alert(fileURL ^+ "exists!"); }else{ alert(fileURL ^+ " does not exist."); }

Disponibilité

Dreamweaver 2.

Description

Cette fonction obtient les attributs du fichier ou dossier spécifique.

Arguments

fileURL

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier ou dossier dont vous souhaitez les attributs.

Valeurs renvoyées

Chaîne représentant les attributs du fichier ou du dossier spécifique. Si le fichier ou le dossier n'existe pas, cette fonction renvoie la valeur null. Les caractères suivants de la chaîne représentent les attributs :

R signifie lecture seule. D signifie dossier. H signifie masqué. S indique un fichier ou dossier système.

Le code suivant obtient les attributs du fichier mydata. txt et affiche un message d'alerte si le fichier est en lecture seule :

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

Disponibilité

Dreamweaver 2.

Description

Cette fonction renvoie l'heure à laquelle le fichier a été modifié pour la dernière fois.

Arguments

fileURL

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier dont vous vérifiez l'heure de la dernière modification.

Valeurs renvoyées

Chaîne qui contient un nombre hexadecimal représentant le nombre d'unités de temps écoulées depuis une base de temps donnée. La signification exacte des unités de temps et de la base de temps dépend de la plate-forme ; sous Windows, par exemple, une unité de temps est égale à 100 ns et la base de temps est le 1er janvier 1600.

Comme la valeur renvoyée par cette fonction n'est pas une date et une heure identifiables et qu'elle dépend de la plate-forme employée, il est utile d'appeler la fonction deux fois pour comparer les valeurs renvoyées. L'exemple de code suivant renvoie les dates de modification des fichiers file1.txt et file2.txt et affiche un message d'advertisement indiquant le fichier le plus récent :

var file1 = "file:///c|/temp/file1.txt";  
var file2 = "file:///c|/temp/file2.txt";  
var timel = DWfile.getModificationDate(file1);  
var time2 = DWfile.getModificationDate(file2);  
if (timel == time2) {  
    alert("file1 and file2 were saved at the same time");  
} else if (timel < time2) {  
    alert("file1 older than file2");  
} else {  
    alert("file1 is newer than file2");  
} 

Disponibilité

Dreamweaver 4.

Description

Cette fonction renvoie l'heure à laquelle le fichier a été créé.

Arguments

fileURL

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier dont vous vérifiez l'heure de création.

Valeurs renvoyées

Chaîne qui contient un nombre hexadécimal représentant le nombre d'unités de temps écoulées depuis une base de temps donnée. La signification exacte des unités de temps et de la base de temps dépend de la plate-forme ; sous Windows, par exemple, une unité de temps est égale à 100 ns et la base de temps est le 1er janvier 1600.

Vous pouvez appeler cette fonction ainsi que la fonction DWfile.getModificationDate() pour un fichier afin de comparer les dates de modification et de création :

Cette fonction obtient l'objet JavaScript représentant l'heure de création du fichier.

Arguments

fileURL

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier dont vous vérifiez l'heure de création.

Valeurs renvoyées

Obtient un objet de date JavaScript représentant la date et l'heure de création du fichier spécifique.

Disponibilité

Dreamweaver MX.

Description

Cette fonction obtient l'objet de date JavaScript représentant l'heure de la dernière modification du fichier.

Arguments

fileURL

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier dont vous vérifiez l'heure de modification la plus récente.

Valeurs renvoyées

Obtient un objet de date JavaScript représentant la date et l'heure de la dernière modification du fichier spécifique.

Disponibilité

Dreamweaver MX.

Description

Cette fonction obtient la taille du fichier spécifique.

Arguments

fileURL

L'argument fileURL, exprimé sous la forme d'une URL de type file://, représente le fichier dont vous vérifiez la taille.

Valeurs renvoyées

Nombre entier qui représente la taille réelle du fichier spécifique, exprimée en octets.

Disponibilité

Dreamweaver 2.

Description

Cette fonction obtient une liste du contenu du dossier spécifique.

Arguments

folderURL, {constraint}

L'argument folderURL est le dossier dont vous souhaitez Brokerir le contenu, exprimé sous la forme d'une URL de type file:// et d'un masque de fichier facultatif composé de caractères génériques. Les caractères génériques valides sont les astérisques (*), qui représentent un ou plusieurs caractères, et les points d'interrogation (?), qui représentent un seul caractère. L'argument constraint, s'il est fourni, doit être soit "files" (renvoyer uniquement les fichiers), soit "directories" (renvoyer uniquement les dossiers). Si cet argument n'est pas spécifique, la fonction renvoie aussi bien des fichiers que des dossiers.

Valeurs renvoyées

Tableau de chaînes représentant le contenu du dossier.

Le code suivant obtient une liste de tous les fichiers texte (TXT) du dossier C:/Temp et affiche la liste dans un message d'advertisement.

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

Disponibilité

Dreamweaver 2.

Description

Cette fonction lit le contenu du fichier spécifique dans une chaîne.

Arguments

fileURL

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier que vous souhaitez dire.

Valeurs renvoyées

Soit une chaîne indiquant le contenu du fichier, soit la valeur null si la lecture échoue.

Le code suivant lit le fichier mydata. txt et, s'il réussit, affiche un message d'advertisement renfermant le contenu du fichier :

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

Disponibilité

Dreamweaver 3.

Description

Cette fonction permet de supprimer le fichier spécifique.

Arguments

fileURL

L'argument fileURL, exprimé sous la forme d'une URL de type file://, représente le fichier que vous souhaitez supprimer.

Valeurs renvoyées

Valeur booléenne : true si l'opération réussit et false dans le cas contraire.

L'exemple suivant utilise la fonction DWfile.getAttributes() pour déterminer si le fichier est accessible en lecture seule et la fonction confirm() pour afficher à l'utilisateur une boîte de dialogue de type Oui/Non :

function deleteFile(){ var delAnyway = false; var selIndex = document. formmenu. selectedIndex; var selFile = document. formmenuoptions[selIndex]. value; if (DWfile. getAttributes(selFile). indexOf('R') ! = -1) { delAnyway = confirm('This file is read-only. Delete anyway?'); if (delAnyway){ DWfile. remove(selFile); } }

Disponibilité

Dreamweaver MX.

Description

Cette fonction définit les attributs système d'un fichier donné.

Arguments

fileURL, strAttrs

L'argument fileURL, exprime sous la forme d'une URL de type file://, identifie le fichier dont vous définissez les attributs. L'argument strAttrs spécifie les attributs système du fichier identifié par l'argument fileURL. Le tableau suivant décrit les valeurs d'attribut valides et leur signification :

Valeur d'attribut	Description
R	Accessible en lecture seule
W	Accessible en écriture (annule R)
H	Masqué
V	Visible (annule H)

Les valeurs acceptables pour la chaîne strAttrs sont : R, W, H, V, RH, RV, WH ou WV.

N'utilisez pas R et W conjointement, car ces attributs s'excluent l'un l'autre. Si vous les associez, R perd tout son sens et le fichier est défini comme étant accessible en écriture (W). N'utilisez pas H et V conjointement, car ils s'excluent aussi l'un l'autre. Si vous les associez, H perd tout son sens et le fichier est défini comme étant visible (V).

Si vous spécifiez l'attribut H ou V sans indiquer d'attribut de lecture/écriture R ou W, l'attribut de lecture/écriture existant pour le fichier reste inchangé. De même, si vous spécifiez l'attribut R ou W sans spécifier un attribut de visibilité H ou V, l'attribut de visibilité existant pour le fichier reste inchangé.

Valeurs renvoyées

Aucune.

Disponibilité

Dreamweaver 2.

Description

Cette fonction rédige la chaîne spécifiée dans le fichier spécifique. Si le fichier spécifique n'existe pas, il est créé.

Arguments

fileURL, text, {mode}

L'argument fileURL, exprime sous la forme d'une URL de type file://, représente le fichier dans lequel vous écrivez une chaîne. L'argument text est la chaîne qui doit être écrite. L'argument mode, s'il est fourni, doit être "append". Si cet argument est omis, le contenu du fichier est écrasé par la chaîne.

Valeurs renvoyées

Valeur booléenne : true si l'écriture de la chaîne dans le fichier a réussi et false dans le cas contraire.

Le code suivant tente d'écrire la chaîne "xxxx" dans le fichier mydata. txt et affiche un message d'avertissement si l'opération d'écriture réussit. Il essaie ensuite d'annexer la chaîne "aaa" au fichier et affiche un deuxième message d'avertissement si cette opération réussit. Après l'exécution de ce script, le fichier mydata. txt contient uniquement le texte xxxaaa.

var fileURL = "file:////c///temp/mydata. txt"; if (DWfile.write(fileURL, "xxx")){ alert("Wrote xxx to" + fileURL); } if (DWfile.write(fileURL, "aaa", "append")){ alert("Appended aaa to" + fileURL); }

Les extensions ne fonctionnent pas uniquement dans le système de fichiers local. Macromedia Dreamweaver 8 permet d'échanger des informations avec un serveur web via le protocole HTTP (Hypertext Transfer Protocol). Ce chapitre décrit l'API HTTP et son utilisation.

Fonctionnement de l'api HTTP

Toutes les fonctions de l'API HTTP sont des méthodes associées à l'objet MMHttp. La plupart d'entre elles acceptent au moins une URL comme argument et la plupart renvoient un objet. Le port par défaut pour les arguments URL est 80. Pour spécifier un port différent, ajoutez deux points (:) et le numéro de port à la suite de l'URL, comme dans l'exemple suivant :

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

Pour les fonctions qui renvoient un objet, cet objet possède deux propriétés : statusCode et data.

La propriété statusCode indique l'état de l'opération; les valeurs possibles sont notamment :

200: Status OK (état OK) 400: Requête incompréhensible 404: URL demandée introuvable 405: Le serveur ne prend pas en charge la méthode demandée 500: Erreur de serveur inconnue 503: Capacité du serveur atteinte

Pour obtenir une liste complète des codes d'état pour votre serveur, consultez votre fournisseur d'accès Internet ou votre administrateur système.

La valeur de la propriété data varie selon la fonction; les valeurs possibles sont spécifiées dans les listes des fonctions individuelles.

Les fonctions qui reçoivent un object ont également une version de rappel (« callback »). Les fonctions de rappel permettent aux autres fonctions de s'exécuter pendant que le serveur Web traite une requête HTTP. Ceci est utile si vous effectuez plusieurs requêtes HTTP à partir de Dreamweaver. La version de rappel d'une fonction transmet directement son ID et sa valeur de renvoi à la fonction spécifiée sous forme de premier argument.

L'api HTTP

Cette section présente en détail les fonctions qui sont des méthodes de l'objet MMHttp.

Disponibilité

Dreamweaver MX.

Description

Supprime le dossier _mmServerScripts (et tous ses fichiers) sous le dossier racine du site en cours, qu'il soit local ou distant. Le dossier _mmServerScripts se trouve dans le dossier Configuration/Connections/Scripts/server-model1_mmDBScripts.

Arguments

serverScriptsfolder

L'argument serverScriptsfolder est une chaîne qui nomme un dossier donné, en liaison avec le dossier Configuration du serveur d'application, à partir duquel vous pouvez extraire et supprimer les scripts de serveur.

Valeurs renvoyées

Un objet représentant la réponse du serveur. La propriété data de cet objet est une chaîne englobant le contenu des scripts supprimés. Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé.

Le code suivant, dans un fichier de commandes de menu du dossier Configuration/Menu, supprime tous les fichiers du dossier _mmServerScripts lorsque celle-ci est appelée depuis un menu :

<!-- MENU-LOCATION=NONE -->
<html>
<head>
<TITLE>Clear Server Scripts</TITLE>
<SCRIPT SRC="ClearServerScripts.js"></SCRIPT>

<SCRIPT LANGUAGE="javascript">  
</SCRIPT>  
<body onLoad="MMHttp.clearServerScriptsFolder()">  
</body>  
</html> 

Description

Cette fonction supprime tous les fichiers du dossier Configuration/Temp situé dans le dossier de l'application Dreamweaver.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Le code suivant, lorsqu'il est enregistré dans un fichier du dossier Configuration/Shutdown, supprime tous les fichiers du dossier Configuration/Temp lorsque l'utilisateur quitte

Dreamweaver :

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

Description

Cette fonction obtient le fichier situé à l'URL spécifique et l'enregistre dans le dossier Configuration/Temp situé dans le dossier de l'application Dreamweaver. Dreamweaver crée automatiquement des sous-dossiers qui reproduisent la structure de dossiers du serveur; par exemple, si le fichier spécifique est dans www.dreamcentral.com/people/index.html, Dreamweaver enregistre le fichier index.html dans le sous-dossier People du dossier www.dreamcentral.com.

Arguments

URL{prompt}{saveURL}{titleBarLabel}

L'argument URL est une URL absolue sur un serveur web; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP. L'argument facultatif prompt est une valeur booléenne spécifique s'il faut inviter l'utilisateur à enregistrer le fichier. Si saveURL est en dehors du dossier Configuration/Temp, une valeur de prompt égale à false n'est pas prise en compte pour des raisons de sécurité. L'argument facultatif saveURL est l'emplacement sur le disque dur de l'utilisateur où le fichier doit être enregistré, exprimé sous la forme d'une URL de type file://. Si l'argument prompt a pour valeur true ou si saveURL est en dehors du dossier Configuration/Temp, l'utilisateur peut remplacer saveURL dans la boîte de dialogue d'enregistrement. L'argument facultatif titleBarLabel est le libellé qui doit figurer dans la barre de titre de la boîte de dialogue d'enregistrement.

Valeurs renvoyées

Un objet représentant la réponse du serveur. La propriété data de cet objet est une chaîne contenant l'emplacement où le fichier a été enregistré, exprimée sous la forme d'une URL de type file://. Normalement, la propriété statusCode de l'objet contient le code d'état envoyé par le serveur. Toutefois, si une erreur de disque se produit lors de l'enregistrement du fichier sur le lecteur local, la propriété statusCode contient un entier représentant l'un des codes d'erreur suivants en cas d'échéance de l'opération :

1: Erreur inconnue 2: Fichier introuvable 3: Chemin non valide 4: La limite du nombre de fichiers ouverts est atteinte 5: Accès refusé 6: Identificateur de fichier non valide 7: Impossible de supprimer le réseau de travail en cours 8: Plus d'entries de dossier 9: Erreur lors de la définition du pointeur de fichier 10: Erreur matérielle 11: Violation de partage 12: Violation de verrouillage 13: Disque saturé

14: End of file reached (fin du fichier atteinte)

Le code suivant obtient un fichier HTML, enregistre tous les fichiers dans le dossier Configuration/Temp, puis ouvre la copie locale du fichier HTML dans un navigateur :

var httpReply = MMHttp. getFile("http://www. dreamcentral. com/~people/profiles/scott. html", false); if (httpReply. statusCode == 200) { var saveLoc = httpReply. data; dw. browseDocument(saveLoc); }

Description

Cette fonction obtient le fichier situé à l'URL spécifique, l'enregistre dans le dossier Configuration/Temp du dossier de l'application Dreamweaver, puis appelle la fonction spécifique avec l'ID et le résultat de la requête. Lorsque le fichier est enregistré locally, Dreamweaver create automatiquement des sous-dossiers qui reproduisent la structure de dossiers du serveur; par exemple, si le fichier spécifique est dans www.dreamcentral.com/people/index.html, Dreamweaver enregistre le fichier index.html dans le sous-dossier People du dossier www.dreamcentral.com.

Arguments

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

L'argument callbackFunction est le nom de la fonction JavaScript à appeler lorsque la requête HTTP est terminée. L'argument URL est une URL absolue sur un serveur web; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP. L'argument facultatif prompt est une valeur booléenne spécifique s'il faut inviter l'utilisateur à enregistrer le fichier. Si l'argument saveURL spécifie un emplacement en dehors du dossier Configuration/Temp, une valeur de prompt égale à false n'est pas prise en compte pour des raisons de sécurité. L'argument facultatif saveURL est l'emplacement sur le disque dur de l'utilisateur ou le fichier doit être enregistré, exprimé sous la forme d'une URL de type file://. Si l'argument prompt a pour valeur true ou si saveURL est en dehors du dossier Configuration/Temp, l'utilisateur peut remplacer saveURL dans la boîte de dialogue d'enregistrement.

L'argument facultatif titleBarLabel est le libellé qui doit figurer dans la barre de titre de la boîte de dialogue d'enregistrement.

Valeurs renvoyées

Un objet représentant la réponse du serveur. La propriété data de cet objet est une chaîne contenant l'emplacement où le fichier a été enregistré, exprimée sous la forme d'une URL de type file://. Normalement, la propriété statusCode de l'objet contient le code d'état envoyé par le serveur. Toutefois, si une erreur disque se produit lors de l'enregistrement du fichier sur le lecteur local, la propriété statusCode contient un nombre entier représentant un code d'erreur. Voir MMHttp.getText() pour une liste des codes d'erreur possibles.

Disponibilité

Macromedia Dreamweaver UltraDev 4, améliorée dans la version Dreamweaver MX.

Description

Extrait le contenu du document situé à l'URL spécifique.

Arguments

URL, {serverScriptsFolder}

L'argument URL est une URL absolue sur un serveur web. Si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP. L'argument serverScriptsFolder est une chaîne facultative qui nomme un dossier spécifique, lié au dossier Configuration du serveur d'application, à partir duquel vous souhaitez extraire les scripts de serveur. Pour extraire les scripts, Dreamweaver utilise le protocole de transfert approprié (par exemple FTP, WebDAV ou Remote File System). Dreamweaver copie ces fichiers dans le sous-dossier _mmServerScripts dans le dossier racine du site en cours.

Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé.

Disponibilité

Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.

Description

Extrait le contenu du document situé à l'URL spécifique et le transmet à la fonction spécifique.

Arguments

callbackFunc, URL, {serverScriptsFolder}

L'argument callbackFunc est la fonction JavaScript à appeler lorsque la requête HTTP est terminée. L'argument URL est une URL absolue sur un serveur web ; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP. L'argument serverScriptsFolder est une chaîne facultative qui nomme un dossier spécifique, lié au dossier Configuration du serveur d'application, à partir duquel vous souhaitez extraire les scripts de serveur. Pour extraire les scripts, Dreamweaver utilise le protocole de transfert approprié (par exemple FTP, WebDAV ou Remote File System). Dreamwe[...] extrait ces fichiers et les transmet à la fonction identifiée par callbackFunc.

Si une erreur survient, Dreamweaver MX la consigne dans la propriété statusCode de l'objet renvoyé.

Disponibilité

Dreamweaver UltraDev 4, améliorée dans la version Dreamweaver MX.

Description

Exécute un envoi HTTP des données définies à l'URL spécifique. En règle générale, les données associées à une opération d'envoi se présentent sous la forme de texte code en formulaire, mais il peut s'agir de tout type de données que le serveur peut accepter.

Arguments

URL, dataToPost, {contentType}, {serverScriptsFolder}

L'argument URL est une URL absolue sur un serveur web; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP. L'argument dataToPost représente les données à envoyer. Si le troisième argument est "application/x-www-form-urlencoded" ou s'il n'est pas spécifique, dataToPost doit être codé en formulaire conformément à la section 8.2.1 de la Specification RFC 1866 (disponible à l'adresse www.faqs.org/rfcs/rfc1866.html). L'argument facultatif contentType est le type de contenu des données à envoyer. S'il n'est pas spécifique, il prend par défaut la valeur "application/x-www-form-urlencoded".

L'argument serverScriptsFolder est une chaîne facultative qui nomme un dossier spécifique, lié au dossier Configuration du serveur d'application, vers lequel vous souhaitez envoyer les données. Pour envoyer les données, Dreamweaver utilise le protocole de transfert approprié (par exemple FTP, WebDAV ou Remote File System).

Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé.

Dans l'exemple suivant d'appel de la fonction MMHttp.postText(), supposons qu'un développeur a placé le fichier myScripts.cfm dans un dossier nommé DeployScripts, qui se trouve dans le dossier Configuration sur l'ordinateur local :

Voici ce qui se produit lorsque Dreamweaver effectue cet appel de fonction :

1. Le fichier myScripts.cfm du dossier Configuration/DeployScripts de l'ordinateur local est copié dans un autre dossier nommé DeployScripts, qui constitue un sous-dossier du dossier racine du site Web ultraqa8. Pour déployer les fichiers, Dreamweaver utilise le protocole spécifique dans les propriétés de configuration du site.
2. Dreamweaver utilise le protocole HTTP pour envoyer les données arg1=Foo vers le serveur Web.
3. En réponse à la requête d'envoi, le serveur Web sur ultraqa8 exécute le script myScripts.cfm à l'aide des données arg1.

Disponibilité

Dreamweaver UltraDev 4, améliorée dans la version Dreamweaver MX.

Description

Exécute un envoi HTTP du texte à l'URL spécifique et transmet la réponse du serveur à la fonction spécifique. En règle générale, les données associées à une opération d'envoi se présentent sous la forme de texte codé en formulaire, mais il peut s'agir de tout type de données que le serveur peut accepter.

Arguments

callbackFunc, URL, dataToPost, {ContentType}, {serverScriptsFolder}

L'argument callbackFunc est le nom de la fonction JavaScript à appeler lorsque la requête HTTP est terminée. L'argument URL est une URL absolue sur un serveur web; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP. L'argument dataToPost représente les données à envoyer. Si le troisième argument est « application/x-www-form-urlencoded » ou s'il n'est pas spécifique, data doit être codé en formulaire conformément à la section 8.2.1 de la Specification RFC 1866 (disponible à l'adresse www.faqs.org/rfcs/rfc1866.html). L'argument facultatif contentType correspond au type de contenu des données à envoyer. S'il n'est pas spécifique, il prend par défaut la valeur "application/x-www-form-urlencoded". L'argument serverScriptsFolder est une chaîne facultative. Il nomme un dossier donné, en liaison avec le dossier Configuration du serveur d'application sur lequel vous pouvez envoyer les données. Pour envoyer les données, Dreamweaver utilise le protocole de transfert approprié (par exemple FTP, WebDAV ou Remote File System). Dreamweaver extrait ces données et les transmet à la fonction identifiée par callbackFunc.

Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé.

Macromedia Dreamweaver 8, Macromedia Fireworks et Macromedia Flash permettent aux concepteurs et développeurs de sites Web de stocker et de récapituler des informations complémentaires sur les documents (telles que des commentaires de révision, des notes de modification ou le fichier source d'un document GIF ou JPEG) dans des fichiers appelés Design Notes.

MMNotes est une bibliothèque C partagée qui permet aux auteurs d'extensions de lire et d'écrire dans les fichiers Design Notes. À l'instar de la bibliothèque partagée DWfile, MMNotes possède une API JavaScript qui permet d'appeler les fonctions contenues dans la bibliothèque à partir d'objets, de commandes, de comportements, de panneaux flottants, d'inspecteurs de propriétés et de traducteurs de données.

MMNotes possède également une API C qui donne à d'autres applications la possibilité de lire et d'écrire dans les fichiers Design Notes. La bibliothèque partagée MMNotes peut être utilisée indépendamment de Dreamweaver, que celui-ci soit installé ou non.

Pour plus d'informations sur l'utilisation de la fonctionnalité Design Notes dans Dreamweaver, voir le manuel Utilisation de Dreamweaver.

Chaque fichier Design Notes stocke des informations relatives à un seul document. Si un fichier Design Notes est associé à un ou plusieurs documents dans un dossier, Dreamweaver crée un sous-dossier _notes pour y stocker les fichiers Design Notes. Le dossier _notes et les fichiers Design Notes qu'il contient ne sont pas visibles dans la fenêtre Site, mais ils s'affichent dans le Finder Macintosh ou dans l'Explorateur Windows. Un nom de fichier Design Notes est composé du nom du fichier principal suivi de l'extension .mno. Par exemple, le fichier Design Notes associé à avocado8.gif est avocado8.gif.mno.

Les fichiers Design Notes sont des fichiers XML stockant des informations sous la forme d'une série de paires clé/valeur. La clé décrit le type des informations stockées et la valeur représente les informations. Les clés sont limitées à 64 caractères.

L'exemple suivant illustre le fichier Design Notes associé au fichier 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> 

Toutes les fonctions de l'API JavaScript de Design Notes sont des méthodes associées à l'objet MMNotes.

Description

Cette fonction ferme le fichier Design Notes spécifique et enregistre les modifications éventuelles. Si toutes les paires clé/valeur ont été supprimées, Dreamweaver supprime le fichier Design Notes. S'il s'agit du dernier fichier Design Notes dans le dossier _notes, Dreamweaver supprime également le dossier.

Appelez toujours la fonction MMNotes().close() une fois le travail sur les Design Notes terminé, afin que Dreamweaver écrive sur le fichier.

Arguments

fileHandle

L'argument fileHandle est l'identificateur de fichier renvoyé par la fonction MMNotes_open().

Valeurs renvoyées

Aucune.

Voir MMNotes. set(), page 45.

Description

Cette fonction convertit le chemin d'accès du lecteur local spécifique en une URL de type file://.

Arguments

drivePath

L'argument drivePath est une chaîne contenant le chemin d'accès complet du lecteur.

Valeurs renvoyées

Une chaîne contenant l'URL de type file:// du fichier spécifique.

Un appel à la fonction MMNotes.filePathToLocalURL('C:/sites/webdev/index.htm') renvoie "file:///c|sites/webdev/index.htm".

Description

Cette fonction obtient la valeur de la clé spécifiée dans le fichier Design Notes indiqué.

Arguments

fileHandle, keyName

L'argument fileHandle est l'identificateur de fichier renvoyé par MMNotes_open(). L'argument keyName est une chaîne contenant le nom de la clé.

Valeurs renvoyées

Une chaîne contenant la valeur de la clé.

Voir MMNotes. getKeys(), page 42.

Description

Cette fonction obtient le nombre de paires clé/valeur du fichier Design Notes spécifique.

Arguments

fileHandle

L'argument fileHandle est l'identificateur de fichier renvoyé par la fonction MMNotes_open().

Valeurs renvoyées

Un nombre entier représentant le nombre de paires clé/valeur du fichier Design Notes spécifique.

Description

Cette fonction obtient une liste de toutes les clés d'un fichier Design Notes.

Arguments

fileHandle

L'argument fileHandle est l'identificateur de fichier renvoyé par la fonction MMNotes_open().

Valeurs renvoyées

Un tableau de chaînes, chacune d'elles contenant le nom d'une clé.

Le code suivant peut être utilisé dans un panneau flottant personnalisé afin d'afficher les informations Design Notes relatives au document actif :

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 += theKeys[i] + " = " + theValue + "\n"; } document. theForm. bigTextField. value = noteString; // always close noteHandle MMNotes. close(noteHandle);

Description

Cette fonction détermine la racine du site pour le fichier Design Notes spécifique.

Arguments

fileURL

L'argument fileURL, exprimé sous la forme d'une URL de type file://, est le chemin d'un fichier local.

Valeurs renvoyées

Une chaîne contenant le chemin du dossier racine local pour le site, exprimée sous la forme d'une URL de type file://, ou une chaîne vide si Dreamweaver n'est pas installé ou si le fichier Design Notes se trouve en dehors de tout site défini par Dreamweaver. Cette fonction recherche tous les sites définis dans Dreamweaver.

Description

Cette fonction obtient le nom de version de la bibliothèque partagée MMNotes indiquant l'application qui l'a implémentée.

Arguments

Aucun.

Valeurs renvoyées

Une chaîne contenant le nom de l'application qui a implémenté la bibliothèque partagée MMNotes.

L'appel de la fonction MMNotes.getVersionName() à partir d'une commande, d'un objet, d'un comportement, d'un inspecteur de propriétés, d'un panneau flottant ou d'un traducteur de données Dreamweaver renvoie "Dreamweaver". L'appel de la fonction

MMNotes getVersionName() à partir de Fireworks renvoie également la valeur

"Dreamweaver" étant donné que Fireworks utilise la même version de la bibliothèque (celle qui a été créée par l'équipe technique de Dreamweaver).

Description

Cette fonction obtient le nombre de version de la bibliothèque partagée MMNotes.

Arguments

Aucun.

Valeurs renvoyées

Une chaîne contenant le numéro de version.

Description

Cette fonction convertit l'URL de type file:// spécifiée en un chemin d'accès du lecteur local.

Arguments

fileURL

L'argument fileURL, exprimé sous la forme d'une URL de type file://, est le chemin d'un fichier local.

Valeurs renvoyées

Une chaîne contenant le chemin d'accès du lecteur local pour le fichier spécifique.

Un appel à la fonction MMNotes.localURLToFilePath('file:///MacintoshHD/images/moon.gif') renvoie "MacintoshHD: images: moon.gif".

Description

Cette fonction ouvre le fichier Design Notes associé au fichier spécifique ou crée un fichier Design Notes s'il n'en existe pas.

Arguments

filePath, {bForceCreate}

L'argument filePath, exprime sous la forme d'une URL de type file://, est le chemin du fichier principal auquel le fichier Design Notes est associé. L'argument bForceCreate est une valeur booléenne indiquant si la note doit être créée même si la fonctionnalité Design Notes est désactivée pour le site ou si l'argument filePath n'est associé à chaque site.

Valeurs renvoyées

L'identificateur du fichier Design Notes ou zéro (0) si le fichier n'a pas été ouvert ni créé.

Voir MMNotes. set(), page 45.

Description

Cette fonction supprime la clé spécifique (et sa valeur) du fichier Design Notes indiqué.

Arguments

fileHandle, keyName

L'argument fileHandle est l'identificateur de fichier renvoyé par la fonction MMNotes_open(). L'argument keyName est une chaîne contenant le nom de la clé à supprimer.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

Description

Cette fonction crée ou met à jour une paire clé/valeur dans un fichier Design Notes.

Arguments

fileHandle, keyName, valueString

L'argument fileHandle est l'identificateur de fichier renvoyé par la fonction MMNotes_open(). L'argument keyName est une chaîne contenant le nom de la clé. L'argument valueString est une chaîne contenant la valeur.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi; false indique un échec.

L'exemple suivant ouvre le fichier Design Notes associé à un fichier situé sur le site dreamcentral appelé peakhike99/index.html, ajoute une nouvelle paire clé/valeur, modifie la valeur d'une clé existante, puis ferme le fichier de Design Notes.

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); }

Outre l'API JavaScript, la bibliothèque partagée MMNotes affiche une API C permettant aux autres applications de créer des fichiers Design Notes. Il n'est pas nécessaire d'appeler les fonctions C directement si vous utilisez la bibliothèque partagée MMNotes dans Dreamweaver; les versions JavaScript de ces fonctions les appellent pour vous.

Cette section décrit ces fonctions, leurs arguments et les valeurs qu'elles renvoient. Les définitions de toutes les fonctions et de tous les types de données sont disponibles dans le fichier MMInfo.h du dossier Extending/c_files dans le dossier de l'application Dreamweaver.

Description

Cette fonction ferme le fichier Design Notes spécifique et enregistre les modifications éventuelles. Si toutes les paires clé/valeur ont été supprimées du fichier Design Notes, Dreamweaver supprime ce dernier. Dreamweaver supprime le dossier _notes lorsque le dernier fichier Design Notes est supprimé.

Arguments

FileHandle noteHandle

• L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile().

Valeurs renvoyées

Aucune.

Description

Cette fonction convertit le chemin d'accès du lecteur local spécifique en une URL de type file://.

Arguments

L'argument drivePath est une chaîne contenant le chemin d'accès complet du lecteur. L'argument localURLBuf est la zone de mémoire tampon où l'URL de type file:// est stockée. L'argument localUrlMaxLen est la taille maximale de localUrlBuf.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

L'argument localURLBuf reçoit la valeur de l'URL de type file://.

Description

Cette fonction obtient la valeur de la clé spécifiée dans le fichier Design Notes indiqué.

Arguments

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

L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile(). L'argument keyName[64] est une chaîne contenant le nom de la clé. L'argument valueBuf est la zone de mémoire tampon où la valeur est stockée. L'argument valueBufLength est le nombre entier renvoyé par GetNoteLength(noteHandle, keyName), indiquant la longueur maximale de la mémoire tampon des valeurs.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

L'argument valueBuf reçoit la valeur de la clé.

Le code suivant obtient la valeur de la clé comments dans le fichier Design Notes associé au fichier welcome.html :

FileHandle noteHandle = OpenNotesFile("file://c//sites/avocado8/\niwjs/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); }

Description

Cette fonction obtient la longueur de la valeur associée à la clé spécifiée.

Arguments

FileHandle noteHandle, const char keyName[64]

L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile(). L'argument keyName[64] est une chaîne contenant le nom de la clé.

Valeurs renvoyées

Un nombre entier représentant la longueur de la valeur.

Voir BOOL GetNote(), page 47.

Description

Cette fonction obtient le nombre de paires clé/valeur du fichier Design Notes spécifique.

Arguments

FileHandle noteHandle

L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile().

Valeurs renvoyées

Un nombre entier représentant le nombre de paires clé/valeur du fichier Design Notes spécifique.

Description

Cette fonction renvoie une liste de toutes les clés d'un fichier Design Notes.

Arguments

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

L'argument noteHandle est l'identificateur de fichier renvoyé par OpenNotesFile().

L'argument keyBufArray[64] est le tableau en mémoire tampon où les clés sont stockées. L'argument keyArrayMaxLen est le nombre entier renvoyé par GetNotesKeyCount(noteHandle), indiquant le nombre maximum d'éléments contenus dans le tableau en mémoire tampon des clés.

Valeurs renvoyées

Valeur booléenne: true indique que l'opération a réussi; false indique un échec. L'argument keyBufArray reçoit les noms de clé.

Le code suivant imprime les noms de clé et les valeurs de toutes les clés du fichier Design Notes associé au fichier welcome.html :

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

Description

Cette fonction détermine la racine du site pour le fichier Design Notes spécifique.

Arguments

const char*filePath, char* siteRootBuf, int siteRootBufMaxLength, {InfoPrefs* infoPrefs} 

L'argument filePath est l'URL de type file:// du fichier dont vous souhaitez obtenir la racine du site. L'argument siteRootBuf est la zone de mémoire tampon où la racine du site est stockée.

L'argument siteRootBufMaxLen est la taille maximale de la mémoire tampon liée référencée par siteRootBuf. L'argument facultatif infoPrefs est une referrer à un struct dans lequel les préférences du site sont stockées.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

L'argument siteRootBuf recoit l'adresse de la mémoire tampon qui stocke la racine du site. Si vous spécifiez l'argument infoPrefs, la fonction renvoie également les préférences de Design Notes pour le site. Le struct InfoPrefs possède deux variables : bUseDesignNotes et bUploadDesignNotes, toutes deux de type BOOL.

Description

Cette fonction renvoie le nom de version de la bibliothèque partagée MMNotes indiquant l'application qui l'a implémentée.

Arguments

char* versionNameBuf, int versionNameBufMaxLen

L'argument versionNameBuf est la zone de mémoire tampon où le nom de version est stocké. L'argument versionNameBufMaxLen est la taille maximale de la mémoire tampon référencée par versionNameBuf.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec. Dreamweaver stocke Dreamweaver dans l'argument versionNameBuf.

Description

Cette fonction renvoie le numéro de version de la bibliothèque partagée MMNotes, ce qui vous permet de savoir si certaines fonctions sont disponibles.

Arguments

char* versionNumBuf, int versionNumBufMaxLen

L'argument versionNumBuf est la zone de mémoire tampon où le numéro de version est stocké. L'argument versionNumBufMaxLen est la taille maximale de la mémoire tampon référencée par versionNumBuf.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

L'argument versionNumBuf stocke le numéro de version.

Description

Cette fonction convertit l'URL de type file:// spécifiée en un chemin d'accès du lecteur local.

Arguments

L'argument localURL, exprimé sous la forme d'une URL de type file://, est le chemin d'un fichier local. L'argument drivePathBuf est la zone de mémoire tampon où le chemin d'accès du lecteur local est stocké. L'argument drivePathMaxLen est la taille maximale de la mémoire tampon liée réferencée par drivePathBuf.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

L'argument drivePathBuf reçoit le chemin de fichier local.

Description

Cette fonction ouvre le fichier Design Notes associé au fichier spécifique ou crée un fichier

Design Notes s'il n'en existe pas.

Arguments

const char* localFileURL, {BOOLE bForceCreate}

L'argument localFileURL, exprime sous la forme d'une URL de type file://, est une chaîne contenant le chemin du fichier principal auquel le fichier Design Notes est associé.

L'argument bForceCreate est une valeur booléenne indiquant si le fichier Design Notes doit être créé même si la fonctionnalité Design Notes est désactivée pour le site ou si le chemin spécifique par l'argument localFileURL n'est associé à chaque site.

Description

Cette fonction ouvre le fichier Design Notes associé au fichier spécifique ou créé un fichier Design Notes s'il n'en existe pas. Vous pouvez ouvrir le fichier en mode lecture seule.

Arguments

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

L'argument localFileURL, exprime sous la forme d'une URL de type file://, est une chaîne contenant le chemin du fichier principal auquel le fichier Design Notes est associé. L'argument bForceCreate est une valeur booléenne indiquant si le fichier Design Notes doit être créé même si la fonctionnalité Design Notes est désactivée pour le site ou si le chemin n'est associé à aucun site. La valeur par défaut est false. Cet argument est facultatif, mais vous ne devez le définir si vous spécifiez le troisième argument. L'argument facultatif bReadOnly est une valeur booléenne indiquant si le fichier doit être ouvert en mode lecture seule. La valeur par défaut est false. Vous pouvez spécifier l'argument bReadOnly disponible à partir de la version 2 du fichier MMNotes.dll.

Description

Cette fonction supprime la clé spécifiée (et sa valeur) du fichier Design Notes indiqué.

Arguments

FileHandle noteHandle, const char keyName[64]

L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile(). L'argument keyName[64] est une chaîne contenant le nom de la clé à supprimer.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi ; false indique un échec.

Description

Cette fonction crée ou met à jour une paire clé/valeur dans un fichier Design Notes.

Arguments

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

L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile(). L'argument keyName[64] est une chaîne contenant le nom de la clé. L'argument valeur est une chaîne contenant la valeur.

Valeurs renvoyées

Valeur booléenne : true indique que l'opération a réussi; false indique un échec.

FWLaunch est une bibliothèque C partagée qui donne aux auteurs d'objets, de commandes, de comportements et d'inspecteurs de propriétés la possibilité de communiquer avec Macromedia Fireworks. À l'aide de FWLaunch, vous rédigez du code JavaScript pour ouvrir l'interface utilisée (IU) de Fireworks et fournissez des commandes à Fireworks via son propre API JavaScript, au sujet duquel vous trouverez plus d'informations dans le manuel Extension de Fireworks. Pour des informations générales sur l'interaction des bibliothèques C avec l'interpréteur JavaScript dans Macromedia Dreamweaver 8, voir Extension de Dreamweaver pour plus de détails sur les extensions C.

L'api fwlunch

L'objet FWLaunch permet aux extensions d'ouvrir Fireworks, d'exécuter des opérations Fireworks à l'aide de l'API JavaScript de Fireworks et de renvoyer les valeurs à Dreamweaver. Ce chapitre décrit l'API de communication FWLaunch et son utilisation.

Cette fonction affiche Dreamweaver au premier plan.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Cette fonction permet d'afficher Fireworks au premier plan s'il est en cours d'exécution.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Disponibilité

Dreamweaver 3, Fireworks 3

Description

Cette fonction transmet l'élément JavaScript spécifique (ou une référence à un fichier JavaScript) à Fireworks en vue de son execution.

Arguments

javascriptOrFileURL

L'argument javascriptOrFileURL, exprime sous la forme d'une URL de type file://, est soit une chaîne de JavaScript littéral, soit le chemin d'accès d'un fichier JavaScript.

Valeurs renvoyées

Un objet cookie si le code JavaScript a été transmis avec succès ou un code d'erreur non nul indiquant que l'une des erreurs suivantes s'est produite :

• Utilisation non valide, ce qui indique que le chemin du fichier JS ou JSF n'est pas valide ou que l'argument javascriptOrFileURL est spécifique comme ayant la valeur null ou comme une chaîne vide.
• Erreur d'E/S de fichier, ce qui indique que Fireworks ne peut pas créer de fichier response car le disque est saturé.
• Erreur de notification de Dreamweaver ; l'utilisateur n'exécute pas une version valide de Dreamweaver (version 3 ou ultérieure).
• Erreur de lancement de Fireworks, ce qui indique que la fonction n'ouvre pas une version valide de Fireworks (version 3 ou ultérieure). L'utilisateur a annulé l'opération.

Disponibilité

Dreamweaver 3, Fireworks 3

Description

Cette fonction détermine si Fireworks est toujours en train d'exécuter le code JavaScript qui lui a été transmis par la fonction FWLaunch. execJsInFireworks(), que l'exécution du script se soit terminée avec succès ou qu'une erreur se soit produite.

Arguments

progressTrackerCookie

L'argument progressTrackerCookie est l'objet cookie renvoyé par la fonction FWLaunch. execJsInFireworks().

Valeurs renvoyées

Une chaîne contenant le résultat du script transmis à FWLaunch. execJsInFireworks() si l'opération se termine avec succès, la valeur null si Fireworks est toujours en train d'exécuter le code JavaScript, ou un code d'erreur non nul indiquant que l'une des erreurs suivantes s'est produite :

Utilisation non valide, ce qui indique qu'une erreur JavaScript s'est produite pendant que Fireworks exécutait le script. - Erreur d'E/S de fichier, ce qui indique que Fireworks ne peut pas créer de fichier response car le disque est saturé. - Erreur de notification de Dreamweaver; l'utilisateur n'exécute pas une version valide de Dreamweaver (version 3 ou ultérieure). - Erreur de lancement de Fireworks, ce qui indique que la fonction n'ouvre pas une version valide de Fireworks (version 3 ou ultérieure). L'utilisateur a annulé l'opération.

Le code suivant transmet la chaîne "prompt('Please enter your name:')" à la fonction

FWLaunch.execJsInFireworks(), puis il vérifie le résultat :

var progressCookie = FWLaunch. execJsInFireworks("prompt('Please enter your name:'))"); var doneFlag = false; while (! doneFlag){ // check for completion every 1/2 second setTimeout('checkForCompletion(),500); } function checkForCompletion(){ if (progressCookie ! = null){ var response = FWLaunchsResponse(progressCookie); if (response ! = null){ if (typeof(response) "number") { // error or user-cancel, time to close the window // and let the user know we got an error window. close(); alert("An error occurred."); }else{ // got a valid response! alert("Nice to meet you," + response); window. close(); } doneFlag = true; }

Cette fonction détermine s'il est possible d'ouvrir une session d'optimisation de Fireworks.

Arguments

Aucun.

Valeurs renvoyées

Une valeur booléenne indiquant si la plate-forme est Windows ou Macintosh; sur Macintosh, la valeur indique si une autre session d'optimisation de Fireworks est déjà en cours d'exécution.

Disponibilité

Dreamweaver 2, Fireworks 2.

Description

Cette fonction ouvre une session d'optimisation de Fireworks pour l'image spécifiée.

Arguments

docURL, imageURL, {targetWidth}, {targetHeight}

L'argument docURL est le chemin d'accès du document actif, exprimé sous la forme d'une URL de type file://. L'argument imageURL est le chemin de l'image sélectionnée. Si le chemin est relatif, sa référence sera le chemin spécifique dans l'argument docURL. L'argument targetWidth (facultatif) définit la largeur par rapport à laquelle l'image doit être redimensionnée. L'argument targetHeight (facultatif) définit la hauteur par rapport à laquelle l'image doit être redimensionnée.

Valeurs renvoyées

Zéro (0) si une session d'optimisation de Fireworks a été lancée avec succès pour l'image spécifique; sinon, un code d'erreur non nul indiquant que l'une des erreurs suivantes s'est produite :

Utilisation non valide, ce qui indique que l'argument docURL, l'argument imageURL, ou les deux, ont été spécifiés comme étant null ou sous forme d'une chaîne vide. - Erreur d'E/S de fichier, ce qui indique que Fireworks ne peut pas créer de fichier réponse car le disque est saturé. - Erreur de notification de Dreamweaver; l'utilisateur n'exécute pas une version valide de Dreamweaver (version 2 ou ultérieure). - Erreur lors du démarrage de Fireworks, ce qui indique que la fonction n'ouvre pas une version valide de Fireworks (version 2 ou ultérieure). L'utilisateur a annulé l'opération.

Disponibilité

Dreamweaver 2, Fireworks 2.

Description

Cette fonction recherche la version spécifiée de Fireworks sur le disque dur de l'utilisateur.

Arguments

{versionNumber}

L'argument versionNumber est un nombre à virgule flottante supérieur ou égal à 2; il est facultatif et représente la version requise de Fireworks. Si cet argument n'est pas défini, il prend par défaut la valeur 2.

Valeurs renvoyées

Une valeur booléenne indiquant si la version spécifique de Fireworks a été trouvée.

Le code suivant vérifie si Fireworks est installé :

La commande suivante demande à Fireworks d'inviter l'utilisateur à entrer son nom, puis renvoie le nom à Dreamweaver.

<html>
<head>
<title>Prompt in Fireworks</title>
<meta http-equiv="Content-Type" content="text/html; - 
paragraph=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 = FWLaunchvalidateFireworks(3.0); if (! isFireworks3) { alert("You must have Fireworks 3.0 or later to use this command"); return; } // Tell Fireworks to execute the prompt() method. gProgressTrackerCookie = FWLaunch. execJsInFireworks\~ ("prompt('Please enter your name:'))"; // null means it wasn't launched, a number means an error code if (gProgressTrackerCookie == null || typeof(gProgressTrackerCookie) == "number") { window. close(); alert("an error occurred"); gProgressTrackerCookie = null; } else { // bring Fireworks to the front FWLaunchbringFWToFront(); // start the checking to see if Fireworks is done yet checkOneMoreTime(); } function checkOneMoreTime() { // Call checkJsResponse() every 1/2 second to see if Fireworks // is done yet windowsetTimeout("checkJsResponse();", 500); } function checkJsResponse() { var response = null; // The user clicked the cancel button, close the window if (gCancelClicked) { window. close(); alert("cancel clicked"); } else { // We're still going, ask Fireworks how it's doing if (gProgressTrackerCookie != null) response = FWLaunch. getJsResponse(gProgressTrackerCookie);