Adobe Dreamweaver CS4 Manuel utilisateur

ADOBE DREAMWEAVER CS4
Référence des API
®
®
©2008 Adobe Systems Incorporated. Tous droits réservés.
Copyright
Guide des API d'Adobe® Dreamweaver® CS4 pour Windows® et Mac OS
Si le présent guide est distribué avec un logiciel sous contrat de licence de l’utilisateur final, ce guide, de même que le logiciel dont il traite, est cédé sous licence
et ne peut être copié ou utilisé que conformément à cette licence. Sauf autorisation spécifiée dans la licence, aucune partie de cette publication ne peut être
reproduite, enregistrée sur un système de recherche ou transmise sous quelque forme ou par quelque moyen que ce soit (enregistrement électronique, mécanique
ou autre), sans l’autorisation écrite préalable d’Adobe Systems Incorporated. Notez que le contenu de ce manuel est protégé par des droits d’auteur, même s’il
n’est pas distribué avec un logiciel accompagné d’un contrat de licence pour l’utilisateur final. Les informations contenues dans ce guide sont fournies à titre
informatif uniquement ; elles sont susceptibles d’être modifiées sans préavis et ne doivent pas être interprétées comme étant un engagement de la part
d’Adobe Systems Incorporated. Adobe Systems Incorporated n’accepte aucune responsabilité quant aux erreurs ou inexactitudes pouvant être contenues dans
le présent guide.
Nous attirons votre attention sur le fait que les illustrations ou images que vous pouvez être amené à incorporer à vos projets peuvent être protégées par des
droits d’auteur. L’inclusion non autorisée de tels éléments dans vos nouveaux travaux peut constituer une violation des droits du détenteur du copyright. Veuillez
vous assurer que vous obtenez toute autorisation nécessaire auprès du détenteur du copyright. Toute référence à des noms de sociétés dans les modèles types
n’est utilisée qu’à titre d’exemple et ne fait référence à aucune société réelle.
Adobe, le logo Adobe, ColdFusion, Dreamweaver, Fireworks, Flash, Photoshop et Shockwave sont des marques déposées ou des marques commerciales d'Adobe
Systems Incorporated aux Etats-Unis.
Java est une marque ou une marque déposée de Sun Microsystems, Inc. aux Etats-Unis et/ou dans d’autres pays. Windows est une marque ou une marque
déposée de Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays. Macintosh et Mac OS sont des marques commerciales d'Apple Computer, Inc.,
déposées aux Etats-Unis et dans d'autres pays. Toutes les autres marques citées sont la propriété de leurs détenteurs respectifs.
This work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit
http://creativecommons.org/licenses/by-nc/3.0/us/
Ce produit inclut des logiciels développés par Apache Software Foundation (http://www.apache.org/).
Le format GIF© (Graphics Interchange Format) fait l'objet d'un copyright appartenant CompuServe Incorporated.
GIF est une marque de service de CompuServe Incorporated.
Technologie de compression audio MPEG Layer-3 utilisée sous licence de Fraunhofer IIS et Thomson Multimedia (http://www.mp3licensing.com). Vous n'êtes
pas autorisé à utiliser les données audio MP3 compressées fournies avec le Logiciel pour les diffusions en temps réel ou en direct. Si vous nécessitez un décodeur
MP3 pour ce type de diffusion, vous devez acquérir une licence pour cette technologie MP3.
Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com)
La vidéo dans Flash Player reposent sur la technologie vidéo On2 TrueMotion. © 1992-2005 On2 Technologies, Inc. Tous droits réservés. http://www.on2.com.
Ce produit est fourni avec un logiciel développé par le groupe OpenSymphony (http://www.opensymphony.com/)
La technologie de compression et de décompression vidéo Sorenson Spark™ est cédée sous licence par Sorenson Media, Inc.
The Proximity/Merriam-Webster Inc./Franklin Electronic Publishers Inc. Database © 1990/1994 Merriam-Webster Inc./Franklin Electronic Publishers Inc., ©
1994. All Rights Reserved. Proximity Technology Inc. The Proximity/Merriam-Webster Inc./Franklin Electronic Publishers Inc. © 1990 Williams Collins Sons
& Co. Ltd. © 1997 - All rights reserved Proximity Technology Inc. © 1990 Williams Collins Sons & Co. Ltd. © 1990 - All rights reserved Proximity Technology
Inc. © Oxford University Press © 2000. All rights reserved Proximity Technology Inc. © 1990 IDE a.s. © 1990 - All rights reserved Proximity Technology Inc.
This product includes software developed by Fourthought, Inc. (http://www.fourthought.com).
This product includes software developed by CollabNet (http://www.Collab.Net/).
Adobe Systems Incorporated, 345 Park Avenue, San Jose, Californie 95110, Etats-Unis d'Amérique.
Avertissements à l’attention des utilisateurs finaux du gouvernement des Etats-Unis. Le logiciel et la documentation sont des « Commercial Items » (articles
commerciaux), selon la définition de ces termes dans l'article 48 C.F.R. §2.101, composés d'un « Commercial Computer Software » (logiciel commercial) et d'une
« Commercial Computer Software Documentation » (documentation), selon la définition de ces termes dans l'article 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202,
selon le cas. Conformément aux documents 48 C.F.R. §12.212 ou 48 C.F.R. §§227.7202-1 à 227.7202-4, le cas échéant, le Logiciel informatique commercial et la
Documentation du Logiciel informatique commercial ne sont conférés en licence aux utilisateurs finals du Gouvernement des Etats-Unis (a) que sous la forme
d'Articles commerciaux et (b) exclusivement avec les droits qui sont accordés à tout autre utilisateur final conformément aux conditions générales ci-incluses.
Les droits non publiés sont réservés conformément aux lois des Etats-Unis en matière de copyright. Adobe Systems Incorporated, 345 Park Avenue, San Jose,
CA 95110-2704, Etats-Unis d'Amérique. Pour les utilisateurs finals du Gouvernement des Etats-Unis, Adobe s'engage à respecter toutes les lois en vigueur en
matière d'égalité, dont, le cas échéant, les dispositions du Executive Order 11246, tel qu'amendé, Section 402 de la loi Vietnam Era Veterans Readjustment
Assistance Act de 1974 (38 USC 4212), et la Section 503 de la loi Rehabilitation Act de 1973, telle qu'amendée, ainsi que les dispositions des documents 41 CFR
parties 60-1 à 60-60, 60-250 et 60-741. La clause d'action positive et les réglementations figurant dans la phrase qui précède seront incorporées par référence.
iii
Sommaire
Chapitre 1 : Introduction
A propos des extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Extension de Dreamweaver
........................................................................................... 1
Ressources supplémentaires pour les créateurs d'extensions
Nouvelles fonctions de Dreamweaver CS4
Fonctions supprimées
................................................................................................. 4
Conventions utilisées dans ce manuel
.................................................................................. 6
Chapitre 2 : API d'E/S des fichiers
A propos des dossiers de configuration
A propos de l'API d'E/S des fichiers
Chapitre 3 : API HTTP
Fonctionnement de l'API HTTP
L'API HTTP
............................................................ 2
.............................................................................. 2
................................................................................ 7
..................................................................................... 7
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Chapitre 4 : API de Design Notes
Fonctionnement des Design Notes
L'API JavaScript de Design Notes
L'API C de Design Notes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Chapitre 5 : Intégration de Fireworks
L'API FWLaunch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Chapitre 6 : Intégration de Flash
L'API des objets Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Fonctions des panneaux et des boîtes de dialogue de Flash
Chapitre 7 : Intégration de Photoshop
Fonctionnement des objets dynamiques
L'API des objets dynamiques
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Chapitre 8 : API de base de données
Fonctionnement de l'API de base de données
Fonctions de connexion à une base de données
Fonctions d'accès à la base de données
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Chapitre 9 : API de connectivité à une base de données
Sélection d'un nouveau type de connexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Création d'un nouveau type de connexion
L'API de connexion
Fichier inclus généré
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Fichier de définition pour votre type de connexion
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
RÉFÉRENCE DES API DE DREAMWEAVER CS4 iv
Sommaire
Chapitre 10 : API d'intégration de commande source
Fonctionnement de l'intégration des commandes source avec Dreamweaver
Ajout d'une fonctionnalité de système de commande source
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Fonctions requises de l'API d'intégration de commande source
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Fonctions facultatives de l'API d'intégration de commande source
Activateurs
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Chapitre 11 : Application
Fonctions relatives aux applications externes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Fonctions globales relatives aux applications
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Fonctions de communication avec Bridge
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Chapitre 12 : Espace de travail
Fonctions d'historique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Fonctions d'insertion d'objets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Fonctions relatives au clavier
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Fonctions relatives aux menus
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Fonctions de la fenêtre de résultats
Fonctions de bascule
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Fonctions relatives aux barres d'outils
Fonctions relatives aux fenêtres
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Fonctions de la barre d'information
Fonctions des fichiers apparentés
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Fonctions du mode Fractionnement vertical
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Fonctions relatives au fractionnement des codes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Fonctions relatives aux barres d'outils du mode Code
Fonctions des couleurs
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Chapitre 13 : Site
Fonctions relatives aux rapports
Fonctions relatives aux sites
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Chapitre 14 : Document
Fonctions relatives aux conversions
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Fonctions relatives aux commandes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Fonctions relatives aux manipulations de fichiers
Fonctions relatives à l'ensemble d'un document
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Fonctions relatives aux chemins
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Fonctions relatives à la sélection
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Fonctions de manipulation de chaînes
Fonctions relatives à la traduction
Fonctions XSLT
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Chapitre 15 : Contenu de page
Fonctions du panneau Actifs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Fonctions relatives aux comportements
Presse-papiers, fonctions
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Fonctions relatives aux éléments de bibliothèque et aux modèles
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
RÉFÉRENCE DES API DE DREAMWEAVER CS4 v
Sommaire
Fonctions du panneau Fragments de code
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Fonctions de modification de widgets Spry
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Insertion de fonctions relatives aux widgets Spry
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Fonctions de vérification de la compatibilité avec les navigateurs
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Chapitre 16 : Documents dynamiques
Fonctions de composants de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Fonctions relatives aux sources de données
Fonctions de l'Extension Data Manager
Fonctions Live data
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Fonctions relatives au mode En direct
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Fonctions relatives aux comportements de serveur
Fonctions de modèle de serveur
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
Chapitre 17 : Création
Fonctions relatives aux mises en forme CSS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Fonctions relatives aux cadres et aux jeux de cadres
Fonctions relatives aux calques et aux cartes d'images
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
Fonctions d'environnement de mise en forme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Fonctions relatives au mode de Mise en forme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Fonctions relatives aux zooms
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Propriétés et fonctions de repère
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Fonctions de modification des tableaux
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Chapitre 18 : Code
Fonctions de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Fonctions relatives à la recherche et au remplacement
Fonctions de modifications générales
Fonction relative à l'impression
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
Fonctions relatives à Quick Tag Editor
Fonctions relatives au mode Code
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Fonctions de l'éditeur de balises et de la bibliothèque de balises
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Chapitre 19 : Activateurs
Fonctions d'activateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Index
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
1
Chapitre 1 : Introduction
Le Guide des API de Adobe Dreamweaver CS4 décrit les interfaces de programmation d'applications (API) qui vous
permettent d'effectuer diverses tâches de prise en charge lorsque vous développez des extensions Adobe®
Dreamweaver® CS4 et ajoutez des codes de programme à vos pages Web Dreamweaver. Les API comprennent l'API
JavaScript principale, qui permet d'accéder à la plupart des fonctionnalités essentielles de Dreamweaver. Les
fonctionnalités essentielles de Dreamweaver sont à peu près tout ce qui peut être effectué via un menu, et bien plus
encore. Il s'agit aussi de diverses API utilitaires destinées à des tâches aussi courantes que la lecture de fichiers et leur
écriture, le transfert d'informations à l'aide de HTTP et la communication avec Fireworks et Flash.
L'API JavaScript vous permet d'exécuter un large éventail de tâches plus réduites. L'utilisateur exécute nombre de ces
tâches lorsqu'il crée ou modifie des documents Dreamweaver. Ces fonctions d'API sont regroupées selon les parties de
l'interface utilisateur de Dreamweaver auxquelles elles se rapportent. Ainsi, l'API JavaScript comprend les fonctions
relatives à l'espace de travail, aux documents, à la conception, etc. Les fonctions de l'API permettent de réaliser
quelques-unes des tâches suivantes, et bien plus encore :
• Ouverture d'un nouveau document
• Obtention ou définition d'une taille de police
• Recherche de l'occurrence d'une chaîne de recherche dans le code HTML
• Activation de la visibilité d'une barre d'outils
A propos des extensions
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), Adobe 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écrit les fonctions des API que
Dreamweaver appelle pour implémenter les objets, menus, panneaux flottants, comportements de serveur, etc., qui
composent 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
personnaliser Dreamweaver en modifiant et en ajoutant des balises à différents fichiers HTML et XML, de façon à
ajouter des éléments de menus ou des types de documents, etc.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 2
Introduction
Ressources supplémentaires pour les créateurs
d'extensions
Pour entrer en contact avec d'autres développeurs d'extensions, rejoignez le forum de discussion consacré à
l'extensibilité de Dreamweaver. Vous trouverez ce forum à l'adresse
http://www.adobe.com/cfusion/webforums/forum/categories.cfm?forumid=12&catid=190&entercat=y.
Nouvelles fonctions de Dreamweaver CS4
Les nouvelles fonctions suivantes ont été ajoutées à l'API JavaScript de Dreamweaver CS4. Les en-têtes désignent les
chapitres et les sections qui contiennent les nouvelles fonctions :
Documents dynamiques
Les fonctions suivantes ont été ajoutées au chapitre Documents dynamiques.
Fonctions relatives au mode En direct
• « dom.getDesignViewMode() » à la page 341
• « dom.setDesignViewMode() » à la page 342
• « dom.getLiveViewUsingServer() » à la page 342
• « dom.setLiveViewUsingServer() » à la page 342
• « dom.getLiveViewDefaultsToUsingServer() » à la page 343
• « dom.getLiveViewDependentsUsingServer() » à la page 343
• « dom.setLiveViewDependentsUsingServer() » à la page 343
• « dom.showLiveViewParamatersDialog() » à la page 344
• « dom.browser.getSelection() » à la page 344
• « dom.browser.getStatusText() » à la page 344
• « dom.browser.getWindow() » à la page 345
• « browserEle.loadHTML() » à la page 345
Intégration de Photoshop
Les fonctions suivantes ont été ajoutées au chapitre Intégration de Photoshop.
API des objets dynamiques
• « dreamweaver.assetPalette.canUpdateSmartObjectFromOriginal() » à la page 54
• « dreamweaver.assetPalette.updateSmartObjectFromOriginal() » à la page 55
• « dreamweaver.getSmartObjectState() » à la page 55
• « dreamweaver.getSmartObjectOriginalWidth() » à la page 56
• « dreamweaver.getImageWidth() » à la page 56
• « dreamweaver.getImageHeight() » à la page 56
RÉFÉRENCE DES API DE DREAMWEAVER CS4 3
Introduction
• « dreamweaver.resolveOriginalAssetFileURLToAbsoluteLocalFilePath() » à la page 57
• « dreamweaver.canUpdateSmartObjectFromOriginal() » à la page 57
• « dreamweaver.updateSmartObjectFromOriginal() » à la page 57
Espace de travail
Les fonctions suivantes ont été ajoutées au chapitre Espace de travail.
Fonctions des fichiers apparentés
• « dreamweaver.getRelatedFiles() » à la page 196
• « dreamweaver.openRelatedFile() » à la page 197
• « dreamweaver.getActiveRelatedFilePath() » à la page 197
Fonctions de la barre d'information
• « dom.showInfoBar() » à la page 195
• « dom.hideInfoBar() » à la page 196
Fonctions du mode Fractionnement vertical
• « dreamweaver.getSplitViewOrientation() » à la page 197
• « dreamweaver.setSplitViewOrientation() » à la page 198
• « dreamweaver.getPrimaryView() » à la page 198
• « dreamweaver.setPrimaryView() » à la page 199
• « dom.isRelatedFileViewOpen() » à la page 199
Fonctions relatives aux barres d'outils
• « dreamweaver.reloadToolbars() » à la page 184
Intégration de Flash
Les fonctions suivantes ont été ajoutées au chapitre Intégration de Flash.
Fonctions des panneaux et des boîtes de dialogue de Flash
• « dreamweaver.flash.newControl() » à la page 45
• « dreamweaver.flash.requestStateChange() » à la page 47
• « dreamweaver.flash.controlEvent() » à la page 48
• « dreamweaver.flash.setMenu() » à la page 50
• « dreamweaver.flash.evalScript() » à la page 51
• « dreamweaver.flash.executeScript() » à la page 52
• « dreamweaver.flash.controlExists » à la page 53
RÉFÉRENCE DES API DE DREAMWEAVER CS4 4
Introduction
Site
Les fonctions suivantes ont été ajoutées au chapitre Sites.
• « site.getLocalRootURL() » à la page 231
• « site.getSiteRootForURL() » à la page 232
Document
Les fonctions suivantes ont été ajoutées au chapitre Document.
• « dom.getSelectorsDefinedInStylesheet() » à la page 274
• « dreamweaver.absoluteURLToDocRelative() » à la page 270
Code
Les fonctions suivantes ont été ajoutées au chapitre Code.
• « dom.source.doCodeNavItem() » à la page 446
Fonctions supprimées
Les fonctions suivantes ont été supprimées de l'API Dreamweaver CS4 car les fonctions associées ont été supprimées
du produit.
site.setShowPageTitles()
site.removeLink()
site.canShowPageTitles()
site.invertSelection()
site.getShowPageTitles()
site.selectHomePage()
site.setShowHiddenFiles()
site.newHomePage()
site.getShowHiddenFiles()
site.setLayout()
site.setShowDependents()
dom.createLayoutCell()
site.getShowDependents()
dom.createLayoutTable()
site.canFindLinkSource()
dom.setColumnAutostretch()
site.findLinkSource()
dom.isColumnAutostretch()
site.viewAsRoot()
dom.doesColumnHaveSpacer()
site.setAsHomePage()
dom.doesGroupHaveSpacer()
site.canSetLayout()
dom.addSpacerToColumn()
site.canRemoveLink()
dom.removeSpacerFromColumn()
site.canChangeLink()
dom.removeAllSpacers()
site.canAddLink()
dom.makeCellWidthsConsistent()
site.addLinkToNewFile()
dom.insertFlashElement()
site.getLinkVisibility()
dreamweaver.exportCSS() (supprimée dans CS3)
RÉFÉRENCE DES API DE DREAMWEAVER CS4 5
Introduction
site.setLinkVisibility()
dreamweaver.canExportCSS() (supprimée dans
CS3)
site.saveAsImage()
dreamweaver.libraryPalette.deleteSelectedItem()
(supprimée dans Dreamweaver 4)
dreamweaver.libraryPalette.get
SelectedItem() (supprimée dans
Dreamweaver 4)
dreamweaver.libraryPalette.newFromDocument()
(supprimée dans Dreamweaver 4)
dreamweaver.libraryPalette.recr dreamweaver.libraryPalette.renameSelectedItem()
eateFromDocument()
(supprimée dans Dreamweaver 4)
(supprimée dans Dreamweaver
4)
dreamweaver.libraryPalette.del
eteSelectedTemplate()
(supprimée dans Dreamweaver
4)
dreamweaver.libraryPalette.getSelectedTemplate()
(supprimée dans Dreamweaver 4)
dreamweaver.libraryPalette.ren
ameSelectedTemplate()
(supprimée dans Dreamweaver
4)
dreamweaver.getBehaviorEvent() (supprimée dans
Dreamweaver 2)
dreamweaver.clipPasteText()
(supprimée dans Dreamweaver
8)
dreamweaver.popupCommand() (supprimée dans
Dreamweaver 3)
dom.serverModel.getServerLan
guage() (supprimée dans
Dreamweaver MX)
dom.serverModel.getServerExtension() (supprimée
dans Dreamweaver MX)
dreamweaver.getObjectRefs()
(supprimée dans Dreamweaver
3)
dreamweaver.getObjectTags() (supprimée dans
Dreamweaver 3)
dreamweaver.getSelection()
(supprimée dans Dreamweaver
3)
dreamweaver.nodeToOffsets() (supprimée dans
Dreamweaver 3)
dreamweaver.offsetsToNode()
(supprimée dans Dreamweaver
3)
dreamweaver.setSelection() (supprimée dans
Dreamweaver 3)
dreamweaver.exportEditableRe
gionsAsXML() (supprimée dans
Dreamweaver MX)
dreamweaver.cssStylePalette.getSelectedTarget()
(supprimée dans Dreamweaver MX)
MMDB.getDriverUrlTemplateLis
t() (supprimée dans
Dreamweaver MX)
Pour plus d'informations sur ces API supprimées, voir Guide des API de Dreamweaver CS3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 6
Introduction
Conventions utilisées dans ce manuel
Conventions typographiques
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 remplaçables 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 dénomination
Ce manuel utilise les conventions de dénomination suivantes :
• Vous — le développeur responsable de la rédaction des extensions
• L'utilisateur — la personne utilisant Dreamweaver
7
Chapitre 2 : API d'E/S des fichiers
Adobe® Dreamweaver® CS4 comprend 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 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.
A propos des dossiers 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. Lorsque 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 procè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.
A propos de 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.
DWfile.copy()
Disponibilité
Dreamweaver 3.
Description
Cette fonction copie le fichier spécifié vers un nouvel emplacement.
Arguments
originalURL, copyURL
• L'argument originalURL, exprimé sous la forme d'une URL de type file://, représente le fichier que vous souhaitez
copier.
• L'argument copyURL, exprimé sous la forme d'une URL de type file://, représente l'emplacement où vous souhaitez
enregistrer le fichier copié.
Valeurs renvoyées
Valeur booléenne, true si la copie réussit, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 8
API d'E/S des fichiers
Exemple
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);
DWfile.createFolder()
Disponibilité
Dreamweaver 2.
Description
Cette fonction crée un dossier à l'emplacement spécifié.
Arguments
folderURL
• L'argument folderURL, exprimé sous la forme d'une URL de type file://, représente l'emplacement dans lequel vous
souhaitez créer le dossier.
Valeurs renvoyées
Valeur booléenne : true si le dossier est bien créé, false en cas d'échec.
Exemple
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|/tempFolder";
if (DWfile.createFolder(folderURL)){
alert("Created " + folderURL);
}else{
alert("Unable to create " + folderURL);
}
DWfile.exists()
Disponibilité
Dreamweaver 2.
Description
Cette fonction vérifie l'existence du fichier spécifié.
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, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 9
API d'E/S des fichiers
Exemple
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.");
}
DWfile.getAttributes()
Disponibilité
Dreamweaver 2.
Description
Cette fonction obtient les attributs du fichier ou dossier spécifié.
Arguments
fileURL
• L'argument fileURL, exprimé sous la forme d'une URL de type file://, représente le fichier ou dossier dont vous
souhaitez obtenir les attributs.
Valeurs renvoyées
Chaîne représentant les attributs du fichier ou du dossier spécifié. 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.
Exemple
Le code suivant obtient les attributs du fichier mydata.txt et affiche un message d'avertissement 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!");
}
DWfile.getModificationDate()
Disponibilité
Dreamweaver 2.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 10
API d'E/S des fichiers
Description
Cette fonction renvoie l'heure à laquelle le fichier a été modifié pour la dernière fois.
Arguments
fileURL
• L'argument fileURL, exprimé 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 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 1 janvier 1600.
Exemple
Comme la valeur renvoyée par cette fonction n'est pas une date et une heure identifiables et qu'elle dépend de la plateforme 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'avertissement
indiquant le fichier le plus récent :
var file1 = "file:///c|/temp/file1.txt";
var file2 = "file:///c|/temp/file2.txt";
var time1 = DWfile.getModificationDate(file1);
var time2 = DWfile.getModificationDate(file2);
if (time1 == time2){
alert("file1 and file2 were saved at the same time");
}else if (time1 < time2){
alert("file1 older that file2");
}else{
alert("file1 is newer than file2");
}
DWfile.getCreationDate()
Disponibilité
Dreamweaver 4.
Description
Cette fonction renvoie l'heure à laquelle le fichier a été créé.
Arguments
fileURL
• L'argument fileURL, exprimé 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 1 janvier 1600.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 11
API d'E/S des fichiers
Exemple
Vous pouvez appeler cette fonction ainsi que la DWfile.getModificationDate() pour un fichier afin de comparer
les dates de modification et de création :
var file1 = "file:///c|/temp/file1.txt";
var time1 = DWfile.getCreationDate(file1);
var time2 = DWfile.getModificationDate(file1);
if (time1 == time2){
alert("file1 has not been modified since it was created");
}else if (time1 < time2){
alert("file1 was last modified on " + time2);
}
DWfile.getCreationDateObj()
Disponibilité
Dreamweaver MX.
Description
Cette fonction obtient l'objet JavaScript représentant l'heure de création du fichier.
Arguments
fileURL
• L'argument fileURL, exprimé 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 Date JavaScript représentant la date et l'heure de création du fichier spécifié.
DWfile.getModificationDateObj()
Disponibilité
Dreamweaver MX.
Description
Cette fonction obtient l'objet Date JavaScript représentant l'heure de la dernière modification du fichier.
Arguments
fileURL
• L'argument fileURL, exprimé 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 Date JavaScript représentant la date et l'heure de la dernière modification du fichier spécifié.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 12
API d'E/S des fichiers
DWfile.getSize()
Disponibilité
Dreamweaver MX.
Description
Cette fonction obtient la taille du fichier spécifié.
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écifié, exprimée en octets.
DWfile.listFolder()
Disponibilité
Dreamweaver 2.
Description
Cette fonction obtient une liste du contenu du dossier spécifié.
Arguments
folderURL, {constraint}
• L'argument folderURL est le dossier dont vous souhaitez obtenir 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écifié, la fonction renvoie aussi
bien des fichiers que des dossiers.
Valeurs renvoyées
Tableau de chaînes représentant le contenu du dossier.
Exemple
Le code suivant obtient une liste de tous les fichiers texte (TXT) du dossier C:/Temp et affiche la liste dans un message
d'avertissement.
var folderURL = "file:///c|/temp";
var fileMask = "*.txt";
var list = DWfile.listFolder(folderURL + "/" + fileMask, "files");
if (list){
alert(folderURL + " contains: " + list.join("\n"));
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 13
API d'E/S des fichiers
DWfile.read()
Disponibilité
Dreamweaver 2.
Description
Cette fonction lit le contenu du fichier spécifié dans une chaîne.
Arguments
fileURL
• L'argument fileURL, exprimé sous la forme d'une URL de type file://, représente le fichier que vous souhaitez lire.
Valeurs renvoyées
Soit une chaîne indiquant le contenu du fichier, soit la valeur null si la lecture échoue.
Exemple
Le code suivant lit le fichier mydata.txt et, s'il réussit, affiche un message d'avertissement renfermant le contenu du
fichier :
var fileURL = "file:///c|/temp/mydata.txt";
var str = DWfile.read(fileURL);
if (str){
alert(fileURL + " contains: " + str);
}
DWfile.remove()
Disponibilité
Dreamweaver 3.
Description
Cette fonction permet de supprimer le fichier spécifié.
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, false dans le cas contraire.
Exemple
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 :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 14
API d'E/S des fichiers
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()
Disponibilité
Dreamweaver MX.
Description
Cette fonction définit les attributs système d'un fichier donné.
Arguments
fileURL, strAttrs
• L'argument fileURL, exprimé 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
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.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 15
API d'E/S des fichiers
DWfile.write()
Disponibilité
Dreamweaver 2.
Description
Cette fonction écrit la chaîne spécifiée dans le fichier spécifié. Si le fichier spécifié n'existe pas, il est créé.
Arguments
fileURL, text, {mode}
• L'argument fileURL, exprimé sous la forme d'une URL de type file://, représente le fichier dans lequel vous écrivez
une chaîne.
Remarque : Si le chemin d'accès contient des espaces, cette fonction n'écrira pas les fichiers.
• L'argument text indique la chaîne que la fonction doit écrire.
• L'argument mode, s'il est fourni, doit être append. Si cet argument est omis, la chaîne écrase le contenu du fichier.
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.
Exemple
Le code suivant tente d'écrire la chaîne xxx 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);
}
16
Chapitre 3 : API HTTP
Les extensions ne fonctionnent pas uniquement dans le système de fichiers local. Adobe® Dreamweaver® 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 : Etat OK
• 400 : Demande inintelligible
• 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 renvoient un objet 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.
MMHttp.clearServerScriptsFolder()
Disponibilité
Dreamweaver MX.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 17
API HTTP
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/servermodel/_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é.
Exemple
Le code suivant, dans un fichier de commandes de menu du dossier Configuration/Menus, 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>
MMHttp.clearTemp()
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.
Exemple
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 :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 18
API HTTP
<html>
<head>
<title>Clean Up Temp Files on Shutdown</title>
</head>
<body onLoad="MMHttp.clearTemp()">
</body>
</html>
MMHttp.getFile()
Description
Cette fonction obtient le fichier situé à l'URL spécifiée 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écifié 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écifiant 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é 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'échec 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épertoire de travail en cours
• 8 : Plus d'entrées de dossier
RÉFÉRENCE DES API DE DREAMWEAVER CS4 19
API HTTP
• 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 : Fin du fichier atteinte
Exemple
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 (Boolean == 200){
var saveLoc = httpReply.data;
dw.browseDocument(saveLoc);
}
MMHttp.getFileCallback()
Description
Cette fonction obtient le fichier situé à l'URL spécifiée, l'enregistre dans le dossier Configuration/Temp du dossier de
l'application Dreamweaver, puis appelle la fonction spécifiée avec l'ID et le résultat de la requête. Lorsque le fichier est
enregistré localement, Dreamweaver crée automatiquement des sous-dossiers qui reproduisent la structure de dossiers
du serveur ; par exemple, si le fichier spécifié 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écifiant 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 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.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 20
API HTTP
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é 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.getFile() » à la page 18 pour une liste des codes d'erreur possibles.
MMHttp.getText()
Disponibilité
Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.
Description
Extrait le contenu du document situé à l'URL spécifiée.
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é.
MMHttp.getTextCallback()
Disponibilité
Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.
Description
Extrait le contenu du document situé à l'URL spécifiée et le transmet à la fonction spécifiée.
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). Dreamweaver extrait ces fichiers et les transmet à la fonction identifiée par callbackFunc.
Si une erreur se produit, Dreamweaver MX la consigne dans la propriété statusCode de l'objet renvoyé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 21
API HTTP
MMHttp.postText()
Disponibilité
Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.
Description
Exécute un envoi HTTP des données définies à l'URL spécifiée. 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
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-wwwform-urlencoded" ou s'il n'est pas spécifié, dataToPost doit être codé en formulaire conformément à la section
8.2.1 de la spécification 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écifié, 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é.
Exemple
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 :
MMHttp.postText(
"http://ultraqa8/DeployScripts/myScripts.cfm",
"arg1=Foo",
"application/x-www-form-urlencoded",
"Configuration/DeployScripts/"
)
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écifié 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.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 22
API HTTP
MMHttp.postTextCallback()
Disponibilité
Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.
Description
Exécute un envoi HTTP du texte à l'URL spécifiée et transmet la réponse du serveur à la fonction spécifiée. 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-wwwform-urlencoded" ou s'il n'est pas spécifié, data doit être codé en formulaire conformément à la section 8.2.1 de
la spécification 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écifié, 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 voulez 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é.
23
Chapitre 4 : API de Design Notes
Adobe® Dreamweaver® , Adobe® Fireworks® et Adobe® Flash® offrent aux concepteurs et développeurs Web une méthode
permettant de stocker et de récupérer des informations supplémentaires sur les documents. Ces informations sont
stockées dans des fichiers baptisés « Design Notes ». Il peut s'agir d'informations supplémentaires sur les documents,
comme des commentaires de relecture, des notes de modification ou le fichier source d'une image GIF ou JPEG.
Pour plus d'informations sur l'utilisation de la fonctionnalité Design Notes dans Dreamweaver, consultez le manuel
Utilisation de Dreamweaver.
Fonctionnement des Design Notes
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>
L'API JavaScript de Design Notes
Toutes les fonctions de l'API JavaScript de Design Notes sont des méthodes associées à l'objet MMNotes. MMNotes
est une bibliothèque C partagée qui permet aux auteurs d'extensions de lire et d'écrire dans les fichiers Design Notes.
Tout comme la bibliothèque partagée DWfile, MMNotes comprend une API JavaScript qui permet d'appeler les
fonctions. Ces fonctions sont appelées à partir d'objets, de commandes, de comportements, de panneaux flottants,
d'inspecteurs Propriétés et de traducteurs de données dans la bibliothèque. La bibliothèque partagée MMNotes peut
être utilisée indépendamment de Dreamweaver, que celui-ci soit installé ou non.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 24
API de Design Notes
MMNotes.close()
Description
Cette fonction ferme le fichier Design Notes spécifié 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.
Remarque : Appelez toujours la fonction MMNotes.close() une fois le travail sur les Design Notes terminé, afin que
Dreamweaver écrive dans le fichier.
Arguments
fileHandle
• L'argument fileHandle est l'identificateur de fichier renvoyé par la fonction MMNotes.open().
Valeurs renvoyées
Aucune.
Exemple
Voir « MMNotes.set() » à la page 28.
MMNotes.filePathToLocalURL()
Description
Cette fonction convertit le chemin d'accès du lecteur local spécifié 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écifié.
Exemple
Un appel à la fonction MMNotes.filePathToLocalURL('C:/sites/webdev/index.htm') renvoie
"file:///c|sites/webdev/index.htm".
MMNotes.get()
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é.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 25
API de Design Notes
Valeurs renvoyées
Une chaîne contenant la valeur de la clé.
Exemple
Voir « MMNotes.getKeys() » à la page 25.
MMNotes.getKeyCount()
Description
Cette fonction obtient le nombre de paires clé/valeur du fichier Design Notes spécifié.
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écifié.
MMNotes.getKeys()
Description
Cette fonction renvoie 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é.
Exemple
Le code suivant peut être utilisé dans un panneau flottant personnalisé afin d'afficher les informations Design Notes
relatives au document actif :
var
var
var
var
for
noteHandle = MMNotes.open(dw.getDocumentDOM().URL);
theKeys = MMNotes.getKeys(noteHandle);
noteString = "";
theValue = "";
(var i=0; i < theKeys.length; i++){
theValue = MMNotes.get(noteHandle,theKeys[i]);
noteString +=0theKeys[i] + " = " theValue + "\n";
}
document.theForm.bigTextField.value = noteString;
// always close noteHandle
MMNotes.close(noteHandle);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 26
API de Design Notes
MMNotes.getSiteRootForFile()
Description
Cette fonction détermine la racine du site pour le fichier Design Notes spécifié.
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é 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.
MMNotes.getVersionName()
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
Aucun.
Valeurs renvoyées
Une chaîne contenant le nom de l'application qui a implémenté la bibliothèque partagée MMNotes.
Exemple
L'appel de la fonction MMNotes.getVersionName() à partir d'une commande, d'un objet, d'un comportement, d'un
inspecteur 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).
MMNotes.getVersionNum()
Description
Cette fonction obtient le numéro de version de la bibliothèque partagée MMNotes.
Arguments
Aucun.
Valeurs renvoyées
Une chaîne contenant le numéro de version.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 27
API de Design Notes
MMNotes.localURLToFilePath()
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écifié.
Exemple
Un appel à la fonction MMNotes.localURLToFilePath('file:///MacintoshHD/images/moon.gif') renvoie
"MacintoshHD:images:moon.gif".
MMNotes.open()
Description
Cette fonction ouvre le fichier Design Notes associé au fichier spécifié ou crée un fichier Design Notes s'il n'en existe pas.
Arguments
filePath, {bForceCreate}
• L'argument filePath, exprimé 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é à aucun site.
Valeurs renvoyées
L'identificateur du fichier Design Notes ou zéro (0) si le fichier n'a pas été ouvert ni créé.
Exemple
Voir « MMNotes.set() » à la page 28.
MMNotes.remove()
Description
Cette fonction supprime la clé spécifiée (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.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 28
API de Design Notes
Valeurs renvoyées
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire.
MMNotes.set()
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 si l'opération a réussi, false dans le cas contraire.
Exemple
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
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);
}
L'API C de Design Notes
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.
void CloseNotesFile()
Description
Cette fonction ferme le fichier Design Notes spécifié 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é.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 29
API de Design Notes
Arguments
noteHandle
• L'argument noteHandle est l'identificateur de fichier renvoyé par la fonction OpenNotesFile().
Valeurs renvoyées
Aucune.
BOOL FilePathToLocalURL()
Description
Cette fonction convertit le chemin d'accès du lecteur local spécifié en une URL de type file://.
Arguments
const char* drivePath, char* localURLBuf, int localURLMaxLen
• 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 si l'opération a réussi, false dans le cas contraire. L'argument localURLBuf reçoit la valeur
de l'URL de type file://.
BOOL GetNote()
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 si l'opération a réussi, false dans le cas contraire. L'argument valueBuf reçoit la valeur de la clé.
Exemple
Le code suivant obtient la valeur de la clé comments dans le fichier Design Notes associé au fichier welcome.html :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 30
API de Design Notes
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()
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.
Exemple
Voir « BOOL GetNote() » à la page 29.
int GetNotesKeyCount()
Description
Cette fonction obtient le nombre de paires clé/valeur du fichier Design Notes spécifié.
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écifié.
BOOL GetNotesKeys()
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().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 31
API de Design Notes
• 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 si l'opération a réussi, false dans le cas contraire. L'argument keyBufArray reçoit les noms
de clé.
Exemple
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);
BOOL GetSiteRootForFile()
Description
Cette fonction détermine la racine du site pour le fichier Design Notes spécifié.
Arguments
const char*filePath, char*siteRootBuf, intsiteRootBufMaxLen, {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 référencée par siteRootBuf.
• L'argument facultatif infoPrefs est une référence à un struct dans lequel les préférences du site sont stockées.
Valeurs renvoyées
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument siteRootBuf reçoit 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. La structure InfoPrefs possède deux variables : bUseDesignNotes et
bUploadDesignNotes, toutes deux de type BOOL.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 32
API de Design Notes
BOOL GetVersionName()
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, intversionNameBufMaxLen
• 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 si l'opération a réussi, false dans le cas contraire. Dreamweaver stocke "Dreamweaver" dans
l'argument versionNameBuf.
BOOL GetVersionNum()
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, intversionNumBufMaxLen
• 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 si l'opération a réussi, false dans le cas contraire. L'argument versionNumBuf stocke le
numéro de version.
BOOL LocalURLToFilePath()
Description
Cette fonction convertit l'URL de type file:// spécifiée en un chemin d'accès du lecteur local.
Arguments
const char* localURL, char* drivePathBuf, int drivePathMaxLen
• 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 référencée par drivePathBuf.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 33
API de Design Notes
Valeurs renvoyées
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument drivePathBuf reçoit le chemin
de fichier local.
FileHandle OpenNotesFile()
Description
Cette fonction ouvre le fichier Design Notes associé au fichier spécifié ou crée un fichier Design Notes s'il n'en existe pas.
Arguments
const char* localFileURL, {BOOL bForceCreate}
• L'argument localFileURL, exprimé 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écifié par l'argument localFileURL n'est
associé à aucun site.
FileHandle OpenNotesFilewithOpenFlags()
Description
Cette fonction ouvre le fichier Design Notes associé au fichier spécifié ou crée 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, exprimé 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 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.
BOOL RemoveNote()
Description
Cette fonction supprime la clé spécifiée (et sa valeur) du fichier Design Notes indiqué.
Arguments
FileHandlenoteHandle, 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.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 34
API de Design Notes
Valeurs renvoyées
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire.
BOOL SetNote()
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 value est une chaîne contenant la valeur.
Valeurs renvoyées
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire.
35
Chapitre 5 : Intégration de Fireworks
FWLaunch est une bibliothèque C partagée qui permet aux auteurs d'objets, de commandes, de comportements et
d'inspecteurs Propriétés de communiquer avec Adobe® Fireworks®. A l'aide de FWLaunch, vous rédigez du code
JavaScript pour ouvrir l'interface utilisateur de Fireworks et fournissez des commandes à Fireworks via sa propre API
JavaScript, au sujet duquel vous trouverez plus d'informations dans Extension de Fireworks. Pour obtenir des
informations générales sur l'interaction des bibliothèques avec l'interpréteur JavaScript dans Adobe® Dreamweaver®
CS4 et pour plus de détails sur les extensions C, voir Extension de Dreamweaver.
L'API FWLaunch
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.
FWLaunch.bringDWToFront()
Disponibilité
Dreamweaver 3, Fireworks 3.
Description
Cette fonction affiche Dreamweaver au premier plan.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
FWLaunch.bringFWToFront()
Disponibilité
Dreamweaver 3, Fireworks 3.
Description
Cette fonction permet d'afficher Fireworks au premier plan s'il est en cours d'exécution.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 36
Intégration de Fireworks
FWLaunch.execJsInFireworks()
Disponibilité
Dreamweaver 3, Fireworks 3.
Description
Cette fonction transmet l'élément JavaScript spécifié (ou une référence à un fichier JavaScript) à Fireworks en vue de
son exécution.
Arguments
javascriptOrFileURL
• L'argument javascriptOrFileURL, exprimé 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écifié 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 réponse car le disque est saturé.
• Erreur informant Dreamweaver que l'utilisateur n'exécute pas une version valide de Dreamweaver (version 3 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 3 ou ultérieure).
• L'utilisateur a annulé l'opération.
FWLaunch.getJsResponse()
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().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 37
Intégration de Fireworks
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 réponse car le disque est saturé.
• Erreur informant Dreamweaver que l'utilisateur n'exécute pas une version valide de Dreamweaver (version 3 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 3 ou ultérieure).
• L'utilisateur a annulé l'opération.
Exemple
Le code suivant transmet la chaîne "prompt('Please enter your name:')" à FWLaunch.execJsInFireworks()
et 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 = FWLaunch.getJsResponse(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;
}
}
}
FWLaunch.mayLaunchFireworks()
Disponibilité
Dreamweaver 2, Fireworks 2.
Description
Cette fonction détermine s'il est possible d'ouvrir une session d'optimisation de Fireworks.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 38
Intégration de Fireworks
Arguments
Aucun.
Valeurs renvoyées
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.
FWLaunch.optimizeInFireworks()
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écifié 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écifiée; 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 informant Dreamweaver que 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.
FWLaunch.validateFireworks()
Disponibilité
Dreamweaver 2, Fireworks 2.
Description
Cette fonction recherche la version spécifiée de Fireworks sur le disque dur de l'utilisateur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 39
Intégration de Fireworks
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écifiée de Fireworks a été trouvée.
Exemple
Le code suivant vérifie si Fireworks est installé :
if (FWLaunch.validateFireworks(6.0)){
alert("Fireworks 6.0 or later is installed.");
}else{
alert("Fireworks 6.0 is not installed.");
}
Un exemple simple de communication FWLaunch
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; ¬
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;
}
// 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
RÉFÉRENCE DES API DE DREAMWEAVER CS4 40
Intégration de Fireworks
if (gProgressTrackerCookie == null || ¬
typeof(gProgressTrackerCookie) == "number") {
window.close();
alert("an error occurred");
gProgressTrackerCookie = null;
} else {
// bring Fireworks to the front
FWLaunch.bringFWToFront();
// 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
window.setTimeout("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);
if (response == null) {
// still waiting for a response, call us again in 1/2 a
// second
checkOneMoreTime();
} else if (typeof(response) == "number") {
// if the response was a number, it means an error occurred
// the user cancelled in Fireworks
window.close();
alert("an error occurred.");
} else {
// got a valid response!This return value might not
// always be a useful one, since not all functions in
// Fireworks return a string, but we know this one does,
// so we can show the user what we got.
window.close();
FWLaunch.bringDWToFront();// bring Dreamweaver to the front
RÉFÉRENCE DES API DE DREAMWEAVER CS4 41
Intégration de Fireworks
alert("Nice to meet you, " + response + "!");
}
}
}
</script>
</head>
<body>
<form>
<table width="313" nowrap>
<tr>
<td>This command asks Fireworks to execute the prompt() ¬
function. 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>
42
Chapitre 6 : Intégration de Flash
Adobe® Dreamweaver® prend en charger l'API d'objet Flash, qui s'appuie sur le modèle Flash Generator pour créer de
nouveaux objets Flash. La section L'API des objets Flash fournit des détails sur la création d'objets Flash (fichiers SWF)
à partir de modèles Flash Generator (fichiers SWT).
Pour plus d'informations sur l'ajout de contenu Flash à des objets ou des commandes Dreamweaver, voir Extension de
Dreamweaver.
L'API des objets Flash
L'API des objets Flash permet aux développeurs d'extensions de construire des objets pour créer des fichiers SWF
simples via Flash Generator. Cette API fournit un moyen de définir des paramètres dans un modèle Flash Generator
pour réaliser un fichier SWF ou d'image. Elle permet de créer de nouveaux objets Flash mais aussi de lire et de
manipuler des objets Flash existants.
Le fichier de modèle Flash Generator SWT contient toutes les informations indispensables à la construction d'un
fichier d'objet Flash. Ces fonctions d'API permettent de créer un fichier SWF (ou un fichier d'image) à partir d'un
fichier SWT. Le fichier SWF est créé en remplaçant les paramètres du fichier SWT par des valeurs réelles. Pour plus
d'informations sur Flash, consultez le manuel correspondant. Les fonctions suivantes sont des méthodes de l'objet
SWFFile.
SWFFile.createFile()
Description
Cette fonction génère un nouveau fichier d'objet Flash à partir du modèle et du tableau des paramètres spécifiés. Elle
crée également des versions GIF, PNG, JPEG et MOV du titre si les noms de fichier sous ces formats sont précisés.
Pour pouvoir spécifier un paramètre facultatif placé après des paramètres facultatifs que vous ne voulez pas spécifier,
vous devez insérer des chaînes vides dans ces paramètres. Par exemple, si vous souhaitez spécifier un fichier PNG, mais
pas de fichier GIF, vous devez insérer une chaîne vide avant de spécifier le nom du fichier PNG.
Arguments
templateFile, templateParams, swfFileName, {gifFileName}, {pngFileName}, {jpgFileName}, {movFileName},
{generatorParams}
• L'argument templateFile est le chemin d'accès du fichier modèle, exprimé sous la forme d'une URL de type file://. Il
peut s'agir d'un fichier SWT.
• L'argument templateParams est un tableau de paires nom/valeur dans lequel les noms identifient les paramètres du
fichier SWT et les valeurs correspondent à la définition que vous voulez leur attribuer. Pour que Dreamweaver
puisse reconnaître un fichier SWF comme objet Flash, le premier paramètre doit être "dwType". Sa valeur doit être
une chaîne représentant le nom du type d'objet, telle que "Flash Text".
• L'argument swfFileName, exprimé sous forme d'une URL de type file://, correspond au nom de fichier de sortie d'un
fichier SWF ou d'une chaîne vide à ignorer.
• L'argument gifFileName, exprimé sous forme d'une URL de type file://, correspond au nom de fichier de sortie d'un
fichier GIF. Cet argument est facultatif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 43
Intégration de Flash
• L'argument pngFileName, exprimé sous forme d'une URL de type file://, correspond au nom de fichier de sortie
d'un fichier PNG. Cet argument est facultatif.
• L'argument jpgFileName, exprimé sous forme d'une URL de type file://, correspond au nom de fichier de sortie d'un
fichier JPEG. Cet argument est facultatif.
• L'argument movFileName, exprimé sous forme d'une URL de type file://, correspond au nom de fichier de sortie
d'un fichier QuickTime. Cet argument est facultatif.
• L'argument generatorParams est un tableau de chaînes représentant les indicateurs facultatifs de la ligne de
commande de Generator. Cet argument est facultatif. Les éléments de données de toutes les balises doivent le suivre
dans le tableau. Les indicateurs couramment utilisés sont répertoriés dans le tableau suivant :
Indicateur
d'option
Données
Description
Exemple
-defaultsize
Largeur,
hauteur
Définit la taille de l'image de sortie en
fonction des largeur et hauteur
indiquées.
"defaultsize",
"640", "480"
-exactFit
Aucun
Etend le contenu de l'image de sortie
pour qu'il s'adapte exactement à la taille
de sortie indiquée.
"-exactFit"
Valeurs renvoyées
Chaîne qui contient l'une des valeurs suivantes :
•
"noError" signifie que l'appel s'est déroulé sans anomalie.
•
"invalidTemplateFile" signifie que le fichier de modèle choisi était incorrect ou introuvable.
•
"invalidOutputFile" signifie qu'au moins un des noms de fichier de sortie spécifiés était incorrect.
•
"invalidData" signifie qu'une ou plusieurs des paires nom/valeur de l'argument templateParams étaient
incorrectes.
•
"initGeneratorFailed" signifie que Generator n'a pas pu être initialisé.
•
"outOfMemory" signifie que l'opération n'a pas pu se terminer correctement faute de mémoire.
•
"unknownError" signifie qu'une erreur inconnue s'est produite.
Exemple
Le code JavaScript suivant crée un fichier objet Flash de type "myType", qui remplace toutes les occurrences de la
chaîne "text" à l'intérieur du fichier de modèle par la chaîne "Hello World". Il crée un fichier GIF et un fichier SWF.
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()
Description
Cette fonction renvoie la taille naturelle de tout contenu Flash non compressé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 44
Intégration de Flash
Arguments
fileName
• L'argument fileName, exprimé sous la forme d'une URL de type file://, correspond au chemin d'accès au contenu
Flash.
Valeurs renvoyées
Un tableau contenant deux éléments qui représentent la largeur et la hauteur du contenu Flash non compressé ou une
valeur null si le fichier n'est pas un fichier Flash non compressé.
SWFFile.getObjectType()
Description
Cette fonction renvoie le type d'objet Flash, c'est-à-dire la valeur transmise dans le paramètre dwType lorsque le fichier
a été créé par la fonction SWFFile.createFile().
Arguments
fileName
• L'argument fileName, exprimé sous la forme d'une URL de type file://, correspond au chemin d'accès à un fichier
d'objet Flash. Il s'agit généralement d'un fichier SWF.
Valeurs renvoyées
Une chaîne représentant le type d'objet ou contenant la valeur null si le fichier n'est pas un fichier d'objet Flash ou s'il
est introuvable.
Exemple
Le code suivant vérifie si le fichier test.swf est un objet Flash de type myType :
if ( SWFFile.getObjectType("file:///MyMac/test.swf") == "myType" ){
alert ("This is a myType object.");
}else{
alert ("This is not a myType object.");
}
SWFFile.readFile()
Description
Cette fonction lit un fichier d'objet Flash.
Arguments
fileName
• L'argument fileName, exprimé sous la forme d'une URL de type file://, correspond au chemin d'accès à un fichier
d'objet Flash.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 45
Intégration de Flash
Valeurs renvoyées
Un tableau de chaînes dans lequel le premier élément est le chemin d'accès complet du fichier modèle SWT. Les
chaînes suivantes représentent les paramètres (paires nom/valeur) de l'objet. Dans le tableau, chaque nom est suivi de
sa valeur. La première paire nom/valeur est "dwType", suivie par sa valeur. La fonction renvoie une valeur null si le
fichier est introuvable ou s'il ne s'agit pas d'un fichier d'objet Flash.
Exemple
L'appel du code var params = SWFFile.readFile("file:///MyMac/test.swf") renvoie les valeurs suivantes
dans le tableau des paramètres :
"file:///MyMac/test.swt"
"dwType"
"myType"
"text"
"Hello World"
// template file used to create this .swf file
// first parameter
// first parameter value
// second parameter
// second parameter value
Fonctions des panneaux et des boîtes de dialogue de
Flash
Les API suivantes permettent d'ajouter des fichiers SWF dans les panneaux et les boîtes de dialogue.
dreamweaver.flash.newControl()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet de créer un contrôle Flash. Elle est prise en référence plus tard par l'intermédiaire du paramètre
controlID. Le contrôle affiche le fichier Flash (.swf) spécifié par le chemin d'accès SWF. Le contrôle possède une
position et une taille spécifiées dans le paramètre defaultGeometry.
Remarque : Dreamweaver affiche les contrôles Flash lorsque vous appelez flash.requestStateChange. Dreamweaver
affiche les contrôles de boîte de dialogue newControl ; il n'est pas nécessaire d'appeler flash.requestStateChange.
Arguments
controlID, controlType, controlData
• L'argument controlID est une valeur de chaîne.
• L'argument controlType spécifie si le panneau est une extension standard ("standard"), une extension standard
approuvée ("trusted") ou une extension plus (toute autre valeur). S'il s'agit d'une extension plus, la valeur est un
identificateur connu spécifiquement de l'application hôte et qui indique le type d'intégration personnalisée requise.
Si l'application ne comprend pas le type d'intégration personnalisée, elle renvoie une erreur.
•
controlData est un objet. Voici quelques-unes des propriétés essentielles de cet argument :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 46
Intégration de Flash
Propriété
Description
controlData.swfUTF8Path
Emplacement du fichier SWF. Cette
propriété, obligatoire, est transmise
sous la forme d'une chaîne de
caractères Unicode, car tous les
caractères dans JavaScript sont en
format Unicode.
Valeurs
Valeurs admises pour
controlData.windowType
•
qui suit ce tableau énumère
les spécifications pour cette
valeur.
•
{controlData.scriptPath
}
Chemin d'accès au fichier .js contenant
les fonctions à exécuter depuis .swf à
l'aide d'un appel d'interface externe.
Cette propriété est facultative. Si vous
voulez effectuer un rappel dans le code
JavaScript de Dreamweaver à partir du
fichier .swf au moyen d'une interface
externe, vous pouvez fournir un fichier
.js contenant des fonctions que vous
pourrez ensuite appeler depuis le
fichier .swf. Pour plus d'informations,
voir l'appel
dw.flash.executeScript.
controlData.defaultGeom
etry
Les valeurs defaultGeometry sont
représentées sous la forme de
coordonnées d'écran à partir du coin
supérieur gauche de l'écran. Cette
propriété est obligatoire.
Object /*!< default creation
geometry, including
positioning */
{ topleftx: Number, toplefty:
Number, width: Number,
height: Number }
Le tableau suivant énumère les spécifications de PanelWindow :
PanelWindow.Le tableau
ModalDialogWindow
RÉFÉRENCE DES API DE DREAMWEAVER CS4 47
Intégration de Flash
Options
Type
Descriptions
name
Chaîne
Le nom du panneau qui s'affiche dans l'onglet. Si vous ne le
précisez pas, il est nommé « UNDEFINED ». Tous les noms de
panneaux sont en majuscules. Vous ne pouvez pas les convertir
en minuscules.
{controlData.minSize}
Objet
minSize ne s'applique qu'aux contrôles de type
PanelWindow. Cette option détermine la taille minimale à
laquelle le panneau peut être réduit. Cette option est
facultative. Si la valeur minSize n'est pas précisée, elle utilise
par défaut la largeur et la hauteur définies dans
defaultGeometry. Il est dès lors impossible de
redimensionner le panneau.
{ width: Number, height: Number }
{controlData.maxSize}
Objet
maxSize ne s'applique qu'aux contrôles de type
PanelWindow. Cette option est facultative. Cette option
détermine la taille maximale à laquelle le panneau peut être
agrandi. Si la valeur maxSize n'est pas précisée, elle utilise par
défaut la largeur et la hauteur définies dans
defaultGeometry. Il est dès lors impossible de
redimensionner le panneau.
{ width: Number, height: Number }
{iconPathNormal}
Chaîne
Chemin d'accès à l'icône qui doit être employée dans le
panneau flottant lorsqu'il est réduit en icône. Cette option est
facultative.
{iconPathRollOver}
Chaîne
Chemin d'accès à l'icône qui doit être employée dans le
panneau flottant lorsqu'il est réduit en icône et que l'utilisateur
le survole. Cette option est facultative.
{iconPathDisable}
Chaîne
Chemin d'accès à l'icône qui doit être employée dans le
panneau flottant lorsqu'il est réduit en icône et désactivé. Cette
option est facultative.
Valeurs renvoyées
L'un des codes de réussite ou d'erreur suivants :
• Le code PlugPlugErrorCode_success indique que la création du contrôle a réussi.
• Le code PlugPlugErrorCode_extensionRegistrationFailed indique que vous n'avez pas réussi à enregistrer
le contrôle.
dreamweaver.flash.requestStateChange()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction modifie l'état du panneau flottant identifié par uniqueID pour l'extension possédant l'ID extensionID.
Arguments
controlID, stateChange, stateData
• L'argument controlID est une valeur de chaîne.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 48
Intégration de Flash
• L'argument stateChange est une chaîne qui peut avoir l'une des valeurs suivantes :
Valeur
Description
Move
Modification d'origine, mais pas de taille
Resize
Nouvelle taille et éventuellement nouvelle origine
Show
Visibilité uniquement, mais pas de modifications géométriques
Hide
Visibilité uniquement, mais pas de modifications géométriques
Minimize
Similaire à hide, mais explique la raison du masquage.
Restore
Similaire à show, mais explique la raison de l'affichage.
Ouvrir
La fenêtre est créée et son extension est chargée.
Close
L'extension contenue est déchargée.
• Les valeurs de l'argument stateData sont des chaînes, comme le montre le tableau suivant :
Valeur de
Valeur de stateData
stateChange
Move
eventData = { topleftx: Number, toplefty: Number }
Resize
eventData = { width: Number, height: Number }
Valeurs renvoyées
Le tableau suivant contient les valeurs renvoyées, qui sont des chaînes :
Valeur
Description
RequestPosted
Un événement ou une commande d'exécution de la demande a été placé en file
d'attente dans l'application hôte.
RequestComplete
L'application hôte a terminé la demande.
RequestFailed
L'application hôte a tenté de terminer la demande, mais a échoué.
RequestDenied
L'application hôte a refusé la demande, généralement parce qu'elle ne prend pas en
charge l'action demandée.
Exemple
controlData = {};
controlData.defaultGeometry = {topleftx : 100, toplefty : 100, width : 200, height : 200 };
controlData.minSize = {width : 100; height : 100 };
controlData.maxSize = {width : 300; height : 300 };
var swfPath = dw.getConfigurationPath();
swfPath += '/flash/PhotoAlbum.swf';
controlData.swfUTF8Path = swfPath;
// open the window
flash.requestStateChange("com.adobe.extension.foo","Open",controlData.defaultGeometry);
dreamweaver.flash.controlEvent()
Disponibilité
Dreamweaver CS4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 49
Intégration de Flash
Description
Cette fonction permet de transmettre des événements à un contrôle Flash. Les appels d'événements sont transmis sous
la forme d'une chaîne XML qui capture la fonction et les paramètres appropriés. La chaîne XML capture la fonction à
démarrer dans le fichier SWF.
Arguments
inControlID, inXMLString
• L'argument inControlID est une chaîne.
• L'argument inXMLString est une chaîne. Transmettez le inXMLString suivant pour appeler la fonction dans le
fichier Flash flashCallback et transmettez une chaîne unique, 'Hello', en tant qu'argument.
<invoke name="flashCallback" returntype="xml">
<arguments>
<string>Hello</string>
</arguments>
</invoke>
Valeurs renvoyées
Renvoie une chaîne XML.
Exemple
L'exemple suivant appelle la fonction flashCallback depuis JavaScript. Dans cet exemple, vous transmettre le nom
de la fonction de rappel et ses arguments sous la forme d'une chaîne XML.
var xmlString = '<invoke name="flashCallback" returntype="xml">
<arguments>
<string>Hello</string>
</arguments>
</invoke>';
Dans cet exemple, vous utilisez dw.flash.controlEvent pour effectuer un rappel dans le fichier Flash (.swf) :
dw.flash.controlEvent('Flickr', xmlString);
Les arguments suivants sont utilisés dans cette fonction :
•
Flickr, qui est l'ID de l'extension transmis lorsque le contrôle .swf a été créé avec dw.flash.newControl.
• La chaîne XML contenant la fonction de rappel et les arguments.
L'exemple suivant est la mise en oeuvre de la fonction flashcallback implémentée dans flashcallback.mxml. Dans
l'exemple suivant, ajoutez la fonction flashcallback. Cette fonction doit être appelée à partir d'applications externes.
public function initApp():void {
ExternalInterface.addCallback("flashCallback",flashCallback);
}
Cette fonction est rappelée depuis l'extérieur du fichier Flash (.swf).
Remarque : Veillez à appeler ExternalInterface.addCallback ("flashCallback",flashCallback) avant de
tenter d'appeler cette fonction.
public function flashCallback(inputStr:String):String
{
out.text += inputStr + " got flashCallback!\n";
return "it worked!";
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 50
Intégration de Flash
dreamweaver.flash.setMenu()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet de fournir des commandes de survol pour les extensions de type "PanelWindow".
Arguments
inControlID, inMenuPosition, inMenu
•
inControlID est un ID d'extension. L'appel de la fonction influe sur le menu de survol d'un panneau ouvert qui
héberge l'extension. Si cet argument n'est pas défini, l'appel influe sur les menus principaux de l'application.
•
inMenuPosition est une chaîne qui décrit où les commandes données doivent être placées.
• Si cette chaîne n'est pas définie, un menu entier est remplacé.
• Si cette chaîne concerne un panneau, toute la zone définissable par l'utilisateur du menu de survol est remplacée.
L'application réserve certains éléments de survol fixes.
• Si cette chaîne concerne l'application, tout le sous-menu Contrôles par défaut du menu Fenêtre est remplacé.
• Si cette chaîne est une chaîne XML dans un schéma restant à déterminer pour la définition de sections de menus,
ce formulaire est fourni pour une compatibilité future.
•
inMenu équivaut à MenuItem. Cet argument indique une liste de commandes qui sont ajoutées à l'emplacement
indiqué dans le menu. Il remplace tout élément antérieur qui a été ajouté à cet endroit par un appel précédent.
Valeurs renvoyées
L'un des codes de réussite ou d'erreur suivants :
• Le code PlugPlugErrorCode_success indique une réussite.
• Le code PlugPlugErrorCode_extensionMenuCreationFailed indique que la création du menu de l'extension a
échoué.
• Le code PlugPlugErrorCode_unknown indique que la fonction a échoué pour une raison inconnue.
Exemple
L'exemple suivant sert à configurer le menu :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 51
Intégration de Flash
function initializeMenuItem(menuID, menuName,extensionID, submenu)
{
var menuItem = {};
menuItem.menuId = menuID; //!< unique menu ID, if NULL menu is disabled
menuItem.nameUtf8 = menuName; //!< Item title, if "---" item is a separator
menuItem.extensionId = extensionID; //!< optional extension ID, used for panels only
menuItem.submenu = submenu; //!< if non-NULL, this is a submenu
return menuItem;
}
function setupMenu()
{
var menuItems = new Array();
menuItems.push(initializeMenuItem('id1','Call .swf
ActionScript',undefined,undefined));
menuItems.push(initializeMenuItem('id0','---',undefined,undefined));
menuItems.push(initializeMenuItem('id2','Call Dw JavaScript',undefined,undefined));
dw.flash.setMenu('Flickr',controlID,menuItems);
}
Remarque : Spécifiez une fonction nommée "onSelectMenuItem" dans le fichier JavaScript indiqué dans le
scriptPath de l'objet transmis à newControl.
onSelectMenuItem est un gestionnaire d'élément de menu. Il est appelé avec l'ID de menu correspondant lorsqu'une
commande est sélectionnée depuis le menu de survol de l'objet flottant.
L'exemple suivant spécifie la définition du gestionnaire de rappel dans « Configuration/flash/Flickr.js » :
function onSelectMenuItem(menuID)
{
if (menuID == 'id1') {
var flashCallbackString = '<invoke name= " flash Callback"
returntype="xml">
<arguments><string>Hello</string></arguments></invoke>';
dw.flash.control Event('Flickr', flashCallbackString);
return("PlugPlugRequestCompleted");
} else {
alert ( ' You selected: menuID = ' + menuID);
return ( " PlugPlugRequestCompleted");
}
}
dreamweaver.flash.evalScript()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction sert à appeler une fonction JavaScript dans l'un des buts suivants :
• Exécution d'une fonction JavaScript définie dans le fichier de script associé à l'extension (pour les extensions CSXS)
• Le fichier .js défini dans le paramètre scriptPath pour les extensions non basées sur CSXS.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 52
Intégration de Flash
Arguments
controlID, javascript function call
•
controlID est l'ID de l'extension qui doit exécuter le script. Cet ID doit correspondre à l'ID spécifié comme
premier paramètre de dw.flash.newControl().
• L'argument d'appel de fonction JavaScript permet à l'utilisateur d'appeler une fonction avec n'importe quel nombre
de paramètres.
Valeurs renvoyées
Valeur booléenne, true si l'exécution de la fonction a réussi et false dans le cas contraire. dans le cas contraire.
dreamweaver.flash.executeScript()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction sert à exécuter des fonctions dans un fichier .js. Le code ActionScript dans le fichier .swf démarre la
fonction dreamweaver.flash.executeScript().
Arguments
javascript function call
Remarque : Définissez un chemin d'accès au fichier .js contenant les fonctions que vous voulez appeler.
Valeurs renvoyées
Chaîne XML qui se sérialise en un objet ActionScript.
Exemple
L'exemple suivant contient un fichier d'exemple, Sample.mxml, ainsi qu'une fonction JavaScript dans un fichier
JavaScript, Sample.js.
private function executeScript():void
{
if(ExternalInterface.available)
{
out.text += "SwfCalledHost\n";
var scriptText:String = "helloWorld('scott');\n";
var resultStr:Object =
ExternalInterface.call("dw.flash.executeScript",scriptText);
out.text += "Result: " + resultStr.strResult + '\n';
}
}
Le fichier JavaScript suivant contient une fonction JavaScript helloWorld() qui est appelée depuis le fichier .swf.
Cette fonction emploie l'appel dw.getAppLanguage() pour renvoyer un code à cinq lettres de la langue dans laquelle
Dreamweaver s'exécute dans Sample.js.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 53
Intégration de Flash
function helloWorld(nameStr)
{
alert('hello ' + nameStr);
var appLanguage = dw.getAppLanguage();
var returnStr = '<object><property id="strResult"><string>Language: ' + appLanguage
+ '</string></property></object>'
alert(returnStr);
return (returnStr);
}
Voir aussi
« dreamweaver.flash.newControl() » à la page 45
dreamweaver.flash.controlExists
Disponibilité
Dreamweaver CS4.
Description
Cette fonction sert à vérifier l'existence des contrôles. Les contrôles PanelWindow sont enregistrés entre
les lancements de Dreamweaver.
Arguments
controlID
Valeurs renvoyées
Valeur booléenne : true si le contrôle a déjà été créé et false dans le cas contraire.
54
Chapitre 7 : Intégration de Photoshop
Adobe® Dreamweaver CS4® facilite une intégration compacte avec Adobe® Photoshop®. L'utilisateur peut insérer des
images Photoshop sous la forme d'objets dynamiques dans Dreamweaver. La fonctionnalité Objets dynamiques met
automatiquement à jour les images dans Dreamweaver si des modifications sont apportées aux images d'origine à
l'aide de Photoshop.
Fonctionnement des objets dynamiques
Les images Photoshop sont insérées dans Dreamweaver sous la forme d'objets dynamiques. Les objets dynamiques
restent liés aux images Photoshop d'origine. Lorsqu'un utilisateur modifie l'image dans Photoshop, il peut voir une
image mise à jour dans Dreamweaver. Un objet dynamique possède un état spécifique, qui résulte principalement de
la connexion de l'image Web à son fichier d'actif initial. L'utilisateur peut déterminer visuellement l'état d'un objet
dynamique. L'état de synchronisation d'un objet dynamique est indiqué par le badge Sync.
L'API des objets dynamiques
Les fonctions des objets dynamiques traitent des opérations relatives à l'intégration de Dreamweaver et de Photoshop.
Ces fonctions permettent d'effectuer les opérations suivantes :
• Récupération de l'état d'une image
• Récupération de la hauteur et de la largeur d'une image
dreamweaver.assetPalette.canUpdateSmartObjectFromOriginal()
Disponibilité
Dreamweaver CS4.
Description
Activateur : Cette fonction vérifie si un objet dynamique, sur lequel on peut émettre la commande Mettre à jour depuis
l'original, est sélectionné dans le panneau actif.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la commande Mettre à jour depuis l'original peut être appliquée à la sélection actuelle.
false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 55
Intégration de Photoshop
dreamweaver.assetPalette.updateSmartObjectFromOriginal()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction recrée l'image Web sélectionnée sur la base du contenu actuel du fichier source d'origine connecté.
Arguments
Aucun.
Valeurs renvoyées
Aucun.
dreamweaver.getSmartObjectState()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction renvoie l'état d'une image Web en termes de fonctionnalités d'objets dynamiques.
Arguments
URL locale absolue d'une image Web.
Valeurs renvoyées
L'état de l'objet dynamique sous la forme d'une valeur numérique, comme :
Valeur
numérique
Description
-10
Erreur inconnue
0
Pas d'objet dynamique.
1
Synchronisé avec le contenu du fichier d'actif d'origine.
100
Image Web modifiée après la dernière synchronisation.
200
Actif d'origine modifié après la dernière synchronisation.
+2
Les dimensions de l'actif d'origine diffèrent des attributs de largeur et de hauteur
dans le code HTML.
+4
Les dimensions de l'image Web diffèrent des attributs de largeur et de hauteur
dans le code HTML.
10
Impossible d'accéder au fichier d'actif d'origine.
20
Impossible d'accéder au fichier d'image Web.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 56
Intégration de Photoshop
dreamweaver.getSmartObjectOriginalWidth()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction évalue et renvoie la largeur en pixels du fichier d'actif d'origine d'un objet dynamique.
Arguments
URL locale absolue de l'image Web.
Valeurs renvoyées
Largeur en pixels du fichier d'actif d'origine.
dreamweaver.getImageWidth()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction évalue et renvoie la largeur en pixels d'une image.
Arguments
URL locale absolue d'une image Web.
Valeurs renvoyées
Largeur en pixels de l'image.
dreamweaver.getImageHeight()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction évalue et renvoie la hauteur en pixels d'une image.
Arguments
URL locale absolue d'une image Web.
Valeurs renvoyées
Hauteur en pixels de l'image.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 57
Intégration de Photoshop
dreamweaver.resolveOriginalAssetFileURLToAbsoluteLocalFilePath()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction résout un chemin d'accès de fichier à un fichier d'accès d'origine (tel que stocké dans les Design Notes).
Le chemin peut être vide, relatif au site ou absolu.
Arguments
URL locale absolue ou relative au site de l'image Web. Cette URL est requise pour la résolution du site.
Valeurs renvoyées
Chemin d'accès absolu au fichier local.
dreamweaver.canUpdateSmartObjectFromOriginal()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction spécifie si un objet dynamique peut être mis à jour à partir de son fichier d'actif d'origine.
Arguments
Etat numérique de l'objet dynamique ImageManipulatorSettings : GetSmartObjectStatus() renvoie cet état.
Valeurs renvoyées
Valeur booléenne : true si l'état autorise une mise à jour à partir de l'image d'origine, false
dans le cas contraire.
dreamweaver.updateSmartObjectFromOriginal()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction met à jour une image Web sur la base du contenu actuel d'un fichier source d'origine.
Arguments
URL locale absolue d'une image Web.
Valeurs renvoyées
Aucun.
58
Chapitre 8 : API de base de données
Les fonctions de l'API de base de données permettent de gérer les connexions aux bases de données et d'accéder aux
informations stockées dans ces dernières. L'API de base de données est divisée en deux fonctions distinctes : gestion
des connexions aux bases de données et accès aux connexions de bases de données.
Les fonctions de l'API de base de données sont utilisées au moment de la conception, lorsque les utilisateurs
développent leurs applications Web, et non au moment de l'exécution, c'est-à-dire lorsque l'application Web est
déployée.
Il est possible d'utiliser ces fonctions dans n'importe quelle extension. En fait, les API de comportement de serveur, de
format des données et de source de données de Adobe® Dreamweaver® CS4 utilisent toutes ces fonctions de base de
données.
Fonctionnement de l'API de base de données
L'exemple suivant illustre la façon dont la fonction de comportement de serveur, getDynamicBindings(), est définie
pour Recordset.js. Cet exemple utilise la fonction MMDB.getColumnAndTypeList() :
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;
// remove SQL comments
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;
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 59
API de base de données
Fonctions de connexion à une base de données
Les fonctions de connexion à une base de données vous permettent d'établir et de gérer toutes les connexions, y
compris les connexions ADO de Dreamweaver, ColdFusion et JDBC.
Ces fonctions interagissent avec le Gestionnaire de connexions uniquement ; elles n'accèdent pas aux bases de
données. Pour les fonctions qui accèdent aux bases de données, voir « Fonctions d'accès à la base de données » à la
page 71.
Dans le cadre de la gestion des connexions de bases de données, vous pouvez obtenir le nom d'utilisateur et le mot de
passe afin d'accomplir des activités telles que :
• Etablissement d'une connexion à une base de données
• Ouverture d'une boîte de dialogue de connexion à une base de données
MMDB.deleteConnection()
Disponibilité
Dreamweaver MX.
Description
Cette fonction permet de supprimer la connexion à la base de données nommée.
Arguments
connName
• L'argument connName est le nom de la connexion à la base de données tel qu'il est spécifié dans le Gestionnaire de
connexions. Cet argument identifie la connexion à la base de données à supprimer en fonction de son nom.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant supprime une connexion à une base de données :
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();
}
}
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 60
API de base de données
MMDB.getColdFusionDsnList()
Disponibilité
Dreamweaver UltraDev 4.
Description
Cette fonction extrait les noms des sources de données (DSN) ColdFusion du serveur du site, en utilisant les fonctions
getRDSUserName() et getRDSPassword().
Arguments
Aucun.
Valeurs renvoyées
Tableau contenant les DSN ColdFusion définis sur le serveur pour le site en cours.
MMDB.getConnection()
Disponibilité
Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.
Description
Extrait un objet de connexion nommé.
Arguments
name
• L'argument name est une variable de chaîne qui spécifie le nom de la connexion à laquelle vous souhaitez faire
référence.
Valeurs renvoyées
Référence à un objet de connexion nommé. Les objets de connexion ont les propriétés suivantes :
Propriété
Description
name
Nom de connexion
type
Indique, si useHTTP a pour valeur false, quel fichier DLL utiliser pour se
connecter à une base de données en exécution.
string
Chaîne de connexion ADO d'exécution ou URL JDBC
dsn
DSN ColdFusion
driver
Pilote JDBC d'exécution
username
Nom d'utilisateur d'exécution
password
Mot de passe d'exécution
useHTTP
Chaîne qui contient la valeur true ou false, indiquant si vous devez utiliser un
pilote distant (connexion HTTP) au moment de la conception ou un pilote local
(DLL).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 61
API de base de données
Propriété
Description
includePattern
Expression régulière utilisée pour trouver l'instruction d'inclusion de fichier sur la
page pendant Live Data et Aperçu dans le navigateur
variables
Tableau de noms de variables de pages et leurs valeurs correspondantes, utilisé
pendant Live Data et Aperçu dans le navigateur
catalog
Utilisé pour restreindre les métadonnées qui apparaissent (pour plus
d'informations, voir « MMDB.getProcedures() » à la page 74)
schema
Utilisé pour restreindre les métadonnées qui apparaissent (pour plus
d'informations, voir « MMDB.getProcedures() » à la page 74)
filename
Nom de fichier de boîte de dialogue qui était utilisé pour créer la connexion
Remarque : Il s'agit des propriétés standard implémentées par Dreamweaver. Les développeurs peuvent définir leurs
propres types de connexion et ajouter de nouvelles propriétés à cet ensemble standard, ou bien fournir un ensemble
différent de propriétés.
MMDB.getConnectionList()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de toutes les chaînes de connexion définies dans le Gestionnaire de connexions.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes, chaque chaîne correspondant au nom d'une connexion tel qu'il apparaît dans le Gestionnaire de
connexions.
Exemple
La fonction MMDB.getConnectionList() peut renvoyer les chaînes ["EmpDB", "Test", "TestEmp"].
MMDB.getConnectionName()
Disponibilité
Dreamweaver UltraDev 1.
Description
Extrait un nom de connexion correspondant à la chaîne de connexion spécifiée. Cette fonction est utile lorsque vous
devez resélectionner un nom de connexion dans l'interface utilisateur (UI) à partir des données de la page.
Si vous avez une chaîne de connexion faisant référence à deux pilotes différents, vous pouvez spécifier à la fois la chaîne
de connexion et le pilote correspondant au nom de connexion que vous souhaitez obtenir. Par exemple, vous pourriez
avoir deux connexions :
• Connexion 1 possède les propriétés suivantes :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 62
API de base de données
ConnectionString="jdbc:inetdae:velcro-qa-5:1433?database=pubs"
DriverName="com.inet.tds.TdsDriver"
• Connexion 2 possède les propriétés suivantes :
ConnectionString="jdbc:inetdae:velcro-qa-5:1433?database=pubs"
DriverName="com.inet.tds.TdsDriver2"
Les chaînes de connexion de Connexion 1 et Connexion 2 sont identiques. Connexion 2 établit une connexion avec
une version plus récente de TdsDriver. Vous devez transmettre le nom du pilote à cette fonction pour définir
complètement le nom de connexion que vous souhaitez obtenir.
Arguments
connString, {driverName}
• connString est la chaîne de connexion qui extrait le nom de la connexion.
• L'argument facultatif driverName définit l'argument connString de manière plus précise.
Valeurs renvoyées
Chaîne de nom de connexion correspondant à la chaîne de connexion.
Exemple
Le code suivant renvoie la chaîne "EmpDB" :
var connectionName = MMDB.getConnectionName ¬
("dsn=EmpDB;uid=;pwd=");
MMDB.getConnectionString()
Disponibilité
Dreamweaver UltraDev 1.
Description
Extrait la chaîne de connexion associée à la connexion nommée.
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
Valeurs renvoyées
Chaîne de connexion qui correspond à la connexion nommée.
Exemple
Le code var connectionString = MMDB.getConnectionString ("EmpDB") renvoie différentes chaînes pour une
connexion ADO ou JDBC.
• Pour une connexion ADO, la chaîne suivante peut renvoyer :
"dsn=EmpDB;uid=;pwd=";
• Pour une connexion JDBC, la chaîne suivante peut renvoyer :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 63
API de base de données
"jdbc:inetdae:192.168.64.49:1433?database=pubs&user=JoeUser&¬
password=joesSecret"
MMDB.getDriverName()
Disponibilité
Dreamweaver UltraDev 1.
Description
Extrait le nom du pilote associé à la connexion spécifiée. Seules les connexions JDBC ont des noms de pilote.
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
Valeurs renvoyées
Chaîne contenant le nom du pilote.
Exemple
L'instruction MMDB.getDriverName ("EmpDB"); peut renvoyer la chaîne suivante :
"jdbc/oracle/driver/JdbcOracle"
MMDB.getLocalDsnList()
Disponibilité
Dreamweaver UltraDev 4.
Description
Extrait les DSN ODBC définis dans le système de l'utilisateur.
Arguments
Aucun.
Valeurs renvoyées
Tableau contenant les DSN ODBC définis sur le système de l'utilisateur.
MMDB.getPassword()
Disponibilité
Dreamweaver UltraDev 1.
Description
Extrait le mot de passe utilisé pour la connexion spécifiée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 64
API de base de données
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
Valeurs renvoyées
Une chaîne de mot de passe associée au nom de connexion.
Exemple
L'instruction MMDB.getPassword ("EmpDB"); peut renvoyer "joessecret".
MMDB.getRDSPassword()
Disponibilité
Dreamweaver UltraDev 4.
Description
Extrait le mot de passe Remote Development Services (RDS) (à utiliser avec les connexions ColdFusion).
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant le mot de passe RDS.
MMDB.getRDSUserName()
Disponibilité
Dreamweaver UltraDev 4.
Description
Extrait le nom d'utilisateur RDS (à utiliser avec les connexions ColdFusion).
Arguments
Aucun.
Valeurs renvoyées
Une chaîne contenant le nom d'utilisateur RDS.
MMDB.getRemoteDsnList()
Disponibilité
Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 65
API de base de données
Description
Extrait les DSN ODBC du serveur de site. Les fonctions getRDSUserName() et getRDSPassword() sont utilisées
lorsque le modèle de serveur du site en cours est ColdFusion. Cette fonction offre aux développeurs la possibilité de
spécifier une chaîne de paramètre URL à annexer à l'URL Remote Connectivity générée par
MMDB.getRemoteDsnList(). Si le développeur fournit une chaîne de paramètre, cette fonction la transmet aux scripts
de connectivité HTTP.
Arguments
{urlParams}
• L'argument facultatif urlParams est une chaîne contenant une liste d'expressions nom=valeur, séparées par des
esperluettes (&). Les valeurs ne doivent pas être entourées de guillemets. Certains caractères, tels que l'espace dans
la valeur Hello World, doivent être codés. Voici un exemple d'argument valide que vous pouvez transmettre dans
MMDB.getRemoteDsnList(): a=1&b=Hello%20World
Valeurs renvoyées
Renvoie un tableau contenant les DSN ODBC définis sur le serveur pour le site en cours.
MMDB.getRuntimeConnectionType()
Disponibilité
Dreamweaver UltraDev 1.
Description
Renvoie le type de connexion d'exécution du nom de connexion spécifié.
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
Valeurs renvoyées
Chaîne correspondant au type de connexion. Cette fonction peut renvoyer l'une des valeurs suivantes : "ADO",
"ADODSN", "JDBC" ou "CFDSN".
Exemple
Le code suivant renvoie la chaîne "ADO" pour une connexion ADO :
var connectionType = MMDB.getRuntimeConnectionType ("EmpDB")
MMDB.getUserName()
Disponibilité
Dreamweaver UltraDev 1.
Description
Renvoie un nom d'utilisateur pour la connexion spécifiée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 66
API de base de données
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
Valeurs renvoyées
Chaîne de nom d'utilisateur associée au nom de connexion.
Exemple
L'instruction MMDB.getUserName ("EmpDB"); peut renvoyer "amit".
MMDB.hasConnectionWithName()
Disponibilité
Dreamweaver UltraDev 4.
Description
Détermine l'existence de la connexion d'un nom donné.
Arguments
name
• name est le nom de la connexion.
Valeurs renvoyées
Renvoie une valeur booléenne : true indique l'existence d'une connexion ayant le nom spécifié et false indique le
contraire.
MMDB.needToPromptForRdsInfo()
Disponibilité
Dreamweaver MX.
Description
Cette fonction détermine si Dreamweaver doit ouvrir la boîte de dialogue des informations de connexion RDS.
Arguments
bForce
• L'argument bForce est une valeur booléenne ; true indique que l'utilisateur ayant précédemment annulé la boîte de
dialogue RDS doit toujours être invité à saisir les informations de connexion RDS.
Valeurs renvoyées
Valeur booléenne : true indique que l'utilisateur doit être invité à saisir les informations de connexion RDS ; false
indique le contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 67
API de base de données
MMDB.needToRefreshColdFusionDsnList()
Disponibilité
Dreamweaver MX.
Description
Ordonne au Gestionnaire de connexions de vider la mémoire cache et d'extraire la liste des sources des données
ColdFusion du serveur d'application la prochaine fois qu'un utilisateur demande la liste.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
MMDB.popupConnection()
Disponibilité
Dreamweaver MX.
Description
Cette fonction lance une boîte de dialogue de connexion. Cette fonction a les trois signatures suivantes :
• Si la liste d'arguments ne comporte que dialogFileName (une chaîne), popupConnection() provoque le lancement
de la boîte de dialogue de connexion dans Dreamweaver, pour que vous puissiez y définir une nouvelle connexion.
• Si la liste d'arguments ne comporte que connRec (une référence de connexion), popupConnection() provoque le
lancement de la boîte de dialogue de connexion en mode d'édition dans Dreamweaver, pour que vous puissiez y
modifier la connexion nommée. Dans ce mode, la zone de texte du nom s'affiche en grisé.
• Si la liste d'arguments ne comporte que connRec et la valeur booléenne bDuplicate, popupConnection() provoque
le lancement de la boîte de dialogue en mode dupliqué dans Dreamweaver. Dans ce mode, la zone de texte du nom
s'affiche en grisé et les propriétés restantes sont copiées pour définir une connexion dupliquée.
Arguments
dialogFileName ou connRec ou connrec, bDuplicate
• dialogFileName est une chaîne qui contient le nom d'un fichier HTML résidant dans le dossier
Configuration/Connections/server-model. Ce fichier HTML définit la boîte de dialogue qui crée une connexion. Ce
fichier doit déployer trois fonctions d'API JavaScript : findConnection(), inspectConnection() et
applyConnection(). En général, vous créez un fichier JavaScript qui implémente ces fonctions, puis vous intégrez
ce fichier au fichier HTML. Pour plus d'informations sur la création d'une connexion, voir « API de connectivité à
une base de données » à la page 83.
• connRec est une référence à un objet de connexion existant.
• bDuplicate est une valeur booléenne.
Valeurs renvoyées
Aucune. La boîte de dialogue de connexion définie s'ouvre.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 68
API de base de données
MMDB.setRDSPassword()
Disponibilité
Dreamweaver UltraDev 4.
Description
Définit le mot de passe RDS.
Arguments
password
• password est une chaîne contenant le mot de passe RDS.
Valeurs renvoyées
Aucune.
MMDB.setRDSUserName()
Disponibilité
Dreamweaver UltraDev 4.
Description
Définit le nom d'utilisateur RDS.
Arguments
username
• L'argument username est le nom d'un utilisateur RDS valide.
Valeurs renvoyées
Aucune.
MMDB.showColdFusionAdmin()
Disponibilité
Dreamweaver MX.
Description
Affiche la boîte de dialogue ColdFusion Administrator.
Arguments
Aucun.
Valeurs renvoyées
Aucune. La boîte de dialogue ColdFusion Administrator s'affiche.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 69
API de base de données
MMDB.showConnectionMgrDialog()
Disponibilité
Dreamweaver UltraDev 1.
Description
Affiche la boîte de dialogue Gestionnaire de connexions.
Arguments
Aucun.
Valeurs renvoyées
Aucune. La boîte de dialogue Gestionnaire de connexions s'affiche.
MMDB.showOdbcDialog()
Disponibilité
Dreamweaver UltraDev 4 (Windows uniquement).
Description
Affiche la boîte de dialogue d'administration ODBC système ou Administrateur de source de données ODBC.
Arguments
Aucun.
Valeurs renvoyées
Aucune. La boîte de dialogue d'administration ODBC système ou Administrateur de source de données ODBC
apparaît.
MMDB.showRdsUserDialog()
Disponibilité
Dreamweaver UltraDev 4.
Description
Affiche la boîte de dialogue demandant le nom d'utilisateur et du mot de passe RDS.
Arguments
username, password
• username est le nom d'utilisateur initial.
• password est le mot de passe initial.
Valeurs renvoyées
Objet contenant les nouvelles valeurs dans les propriétés username et password. Si l'une des propriétés n'est pas
définie, ceci indique que l'utilisateur a annulé la boîte de dialogue.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 70
API de base de données
MMDB.showRestrictDialog()
Disponibilité
Dreamweaver UltraDev 4.
Description
Affiche la boîte de dialogue Restreindre.
Arguments
catalog, schema
• catalog est la valeur de catalogue initiale.
• L'argument schema est la valeur de schéma initiale.
Valeurs renvoyées
Objet contenant les nouvelles valeurs dans les propriétés catalog et schema. Si l'une des propriétés n'est pas définie,
ceci indique que l'utilisateur a annulé la boîte de dialogue.
MMDB.testConnection()
Disponibilité
Dreamweaver UltraDev 4.
Description
Teste les paramètres de connexion. Affiche une boîte de dialogue modale qui décrit les résultats.
Arguments
serverPropertiesArray
Cette fonction attend un seul argument, un objet de tableau contenant les valeurs de la liste suivante adaptées au
modèle de serveur en cours. Pour les propriétés qui ne s'appliquent pas à la connexion testée, laissez-les vides ("").
• type indique, lorsque useHTTP est une valeur false, quelle DLL utiliser pour se connecter à une base de données
au moment de la conception, pour tester les paramètres de connexion.
• string est la chaîne de connexion ADO ou l'URL JDBC.
• dsn est le nom de la source de données.
• driver est le pilote JDBC.
• username est le nom d'utilisateur.
• L'argument password est le mot de passe.
• L'argument useHTTP est une valeur booléenne. Une valeur true spécifie que Dreamweaver doit utiliser une
connexion HTTP au moment de la conception ; dans le cas contraire, Dreamweaver utilise une DLL.
Valeurs renvoyées
Valeur booléenne, true si le test de connexion est réussi, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 71
API de base de données
Fonctions d'accès à la base de données
Les fonctions d'accès à la base de données vous permettent de faire une recherche dans la base de données.
L'accès aux informations de base de données permet par exemple d'extraire les métadonnées qui décrivent le schéma
ou la structure d'une base de données. Ces métadonnées incluent des informations telles que les noms des tables, des
colonnes, des procédures stockées et des affichages. Vous pouvez également afficher les résultats de l'exécution d'une
requête de base de données ou d'une procédure stockée. Lorsque vous accédez à une base de données par le biais de
cette API, vous utilisez des instructions SQL (Structured Query Language).
Pour l'ensemble des fonctions qui gèrent une connexion à une base de données, voir « Fonctions de connexion à une
base de données » à la page 59.
La liste suivante décrit certains des arguments communs à toutes les fonctions disponibles :
• La plupart des fonctions d'accès à une base de données utilisent un nom de connexion comme argument. Pour
obtenir une liste des noms de connexion valides, utilisez le Gestionnaire de connexions ou la fonction
MMDB.getConnectionList(). Cette dernière vous permet d'obtenir par programmation une liste de tous les noms
de connexion.
• Les procédures stockées exigent souvent des paramètres. Vous pouvez spécifier des valeurs de paramètre pour les
fonctions d'accès à la base de données de deux façons. En premier lieu, vous pouvez fournir un tableau de valeurs
de paramètre (paramValuesArray). Si vous ne spécifiez que des valeurs de paramètre, celles-ci doivent être dans
l'ordre dans lequel la procédure stockée les demande. Spécifiez ensuite les valeurs de paramètre pour fournir un
tableau des noms de paramètre (paramNameArray). Vous pouvez utiliser la fonction
MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée. Si vous fournissez des noms
de paramètres, les valeurs spécifiées dans paramValuesArray doivent être dans l'ordre dans lequel les noms ont été
spécifiés dans paramNameArray.
MMDB.getColumnAndTypeList()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de colonnes et leurs types respectifs d'une déclaration SQL SELECT exécutée.
Arguments
connName, déclaration
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument statement est la déclaration SQL SELECT à exécuter.
Valeurs renvoyées
Un tableau de chaînes qui représente une liste de colonnes (et leur type) qui correspondent à la déclaration SELECT,
ou bien une erreur si la déclaration SQL n'est pas valide ou si la connexion n'a pas pu s'établir.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 72
API de base de données
Exemple
Le code var columnArray = MMDB.getColumnAndTypeList("EmpDB","Select * from Employees") renvoie le
tableau de chaînes suivant :
columnArray[0]
columnArray[1]
columnArray[2]
columnArray[3]
columnArray[4]
columnArray[5]
=
=
=
=
=
=
"EmpName"
"varchar"
"EmpFirstName"
"varchar"
"Age"
"integer"
MMDB.getColumnList()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait la liste de colonnes d'une déclaration SQL SELECT exécutée.
Arguments
connName, déclaration
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument statement est la déclaration SQL SELECT à exécuter.
Valeurs renvoyées
Un tableau de chaînes qui représente une liste de colonnes correspondant à la déclaration SELECT, ou une erreur si la
déclaration SQL n'est pas valide ou si la connexion n'a pas pu s'établir.
Exemple
Le code var columnArray = MMDB.getColumnList("EmpDB","Select * from Employees") renvoie le tableau
de chaînes suivant :
columnArray[0] = "EmpName"
columnArray[1] = "EmpFirstName"
columnArray[2] = "Age"
MMDB.getColumns()
Disponibilité
Dreamweaver MX, arguments mis à jour dans MX 2004.
Description
Renvoie un tableau d'objets qui décrivent les colonnes de la table spécifiée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 73
API de base de données
Arguments
connName, tableName
• L'argument connName est le nom de la connexion. Cette valeur identifie la connexion qui contient la chaîne que
Dreamweaver doit utiliser pour établir une connexion de base de données à une source de données active.
• tableName est la table à interroger.
Valeurs renvoyées
Un tableau d'objets, à raison d'un objet par colonne. Chaque objet définit les trois propriétés suivantes pour la colonne
à laquelle il est associé.
Nom de propriété
Description
name
Nom de la colonne (par exemple, price)
datatype
Type de données de la colonne (par exemple, small money)
definedsize
Taille définie de la colonne (par exemple, 8)
nullable
Indique si la colonne peut contenir des valeurs null
Exemple
L'exemple suivant utilise MMDB.getColumns() pour définir la valeur du texte de l'infobulle :
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))
{
// it already is a num
typename = dwscripts.getDBColumnTypeAsString(typename, databaseType);
}
var tooltiptext = typename;
}
MMDB.getColumnsOfTable()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de toutes les colonnes de la table spécifiée.
Arguments
connName, tableName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument tableName est le nom d'une table de la base de données désignée par l'argument connName.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 74
API de base de données
Valeurs renvoyées
Un tableau de chaînes dont chaque chaîne est le nom d'une colonne de la table.
Exemple
L'instruction MMDB.getColumnsOfTable ("EmpDB","Employees"); renvoie les chaînes suivantes :
["EmpID", "FirstName", "LastName"]
MMDB.getPrimaryKeys()
Disponibilité
Dreamweaver MX.
Description
Renvoie les noms de colonne qui s'associent pour former la clé primaire de la table nommée. Une clé primaire sert
d'identificateur unique pour une ligne de base de données et se compose d'une colonne minimum.
Arguments
connName, tableName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument tableName est le nom de la table pour laquelle vous souhaitez restituer l'ensemble des colonnes
comprenant la clé primaire de cette table.
Valeurs renvoyées
Tableau de chaînes. Le tableau contient une chaîne pour chaque colonne comprenant la clé primaire.
Exemple
L'exemple suivant renvoie la clé primaire de la table spécifiée.
var connName
var tableName
var primaryKeys
= componentRec.parent.parent.parent.name;
= componentRec.name;
= MMDB.getPrimaryKeys(connName,tableName);
MMDB.getProcedures()
Disponibilité
Dreamweaver MX.
Description
Cette fonction renvoie un tableau d'objets de procédure associés à une connexion nommée.
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 75
API de base de données
Valeurs renvoyées
Un tableau d'objets de procédure dans lequel chaque objet de procédure a les trois propriétés suivantes :
Nom de propriété
Description
schema
Nom du schéma associé à l'objet.
Cette propriété identifie l'utilisateur associé à la procédure stockée dans la base de
données SQL et à laquelle accède la fonction getProcedures(). La base de données
à laquelle accède cette fonction dépend du type de connexion.
catalog
•
Pour les connexions ODBC, la source de données ODBC définit la base de données. Le
DSN est spécifié par la propriété dsn dans l'objet de connexion (connName) que vous
transmettez à la fonction getProcedures().
•
Pour les connexion à la BD OLE, la chaîne de connexion donne un nom à la base de
données.
Nom du catalogue associé à l'objet (qualificatif de propriétaire).
La valeur de la propriété catalog est définie par un attribut du pilote de la BD OLE. Cet
attribut du pilote définit une propriété user.database par défaut à utiliser lorsque la
chaîne de connexion à la BD OLE n'indique pas de base de données.
procedure
Nom de la procédure.
Remarque : Dreamweaver se connecte à la base de données et en extrait toutes les tables chaque fois que vous modifiez
un jeu d'enregistrements. Si la base de données contient de nombreuses tables, la procédure de leur extraction par
Dreamweaver sur certains systèmes peut prendre beaucoup de temps. Si votre base de données contient un schéma ou un
catalogue, vous pouvez l'utiliser pour limiter le nombre d'éléments de base de données que Dreamweaver récupère au
moment de la conception. Pour commencer, créez un schéma ou un catalogue dans votre application de base de données
de façon à pouvoir ensuite l'appliquer dans Dreamweaver. Consultez la documentation de votre système de base de
données ou consultez votre administrateur système.
Exemple
Le code suivant extrait une liste de procédures :
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);
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 76
API de base de données
MMDB.getSPColumnList()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de colonnes de jeu de résultats générées par un appel à la procédure stockée spécifiée.
Arguments
connName, statement, paramValuesArray
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument statement est le nom de la procédure stockée qui renvoie le jeu de résultats lorsqu'elle est exécutée.
• L'argument paramValuesArray est un tableau contenant une liste de valeurs tests de paramètre au moment de la
conception. Spécifiez les valeurs de paramètre dans l'ordre attendu par la procédure stockée. Vous pouvez utiliser
la fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée.
Valeurs renvoyées
Tableau de chaînes représentant la liste des colonnes. Cette fonction renvoie une erreur lorsque l'instruction SQL ou
la chaîne de connexion est incorrecte.
Exemple
Le code suivant peut renvoyer une liste de colonnes de jeux de résultats générées à partir de la procédure stockée
exécutée, getNewEmployeesMakingAtLeast :
var paramValueArray = new Array("2/1/2000", "50000")
var columnArray = MMDB.getSPColumnList("EmpDB", ¬
"getNewEmployeesMakingAtLeast", paramValueArray)
The following values return:
columnArray[0] = "EmpID", columnArray[1] = "LastName", ¬
columnArray[2] ="startDate", columnArray[3] = "salary"
MMDB.getSPColumnListNamedParams()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de colonnes de jeu de résultats générées par un appel à la procédure stockée spécifiée.
Arguments
connName, statement, paramNameArray, paramValuesArray
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument statement est le nom de la procédure stockée qui renvoie le jeu de résultats lorsqu'elle est exécutée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 77
API de base de données
• L'argument paramNameArray est un tableau contenant une liste de noms de paramètres. Vous pouvez utiliser la
fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée.
• L'argument paramValuesArray est un tableau contenant une liste de valeurs tests de paramètre au moment de la
conception. Vous pouvez spécifier si oui ou non la procédure requiert des paramètres pendant l'exécution. Si vous
avez fourni des noms de paramètre dans paramNameArray, spécifiez les valeurs de paramètre dans l'ordre dans
lequel leurs noms apparaissent dans paramNameArray. Si vous n'avez pas indiqué paramNameArray, spécifiez les
valeurs dans l'ordre attendu par la procédure stockée.
Valeurs renvoyées
Tableau de chaînes représentant la liste des colonnes. Cette fonction renvoie une erreur lorsque l'instruction SQL ou
la chaîne de connexion est incorrecte.
Exemple
Le code suivant peut renvoyer une liste de colonnes de jeux de résultats générées à partir de la procédure stockée
exécutée, getNewEmployeesMakingAtLeast :
var paramNameArray = new Array("startDate", "salary")
var paramValueArray = new Array("2/1/2000", "50000")
var columnArray = MMDB.getSPColumnListNamedParams("EmpDB", ¬
"getNewEmployeesMakingAtLeast", paramNameArray, paramValueArray)
Les valeurs suivantes sont retournées :
columnArray[0] = "EmpID", columnArray[1] = "LastName",¬
columnArray[2] ="startDate", columnArray[3] = "salary"
MMDB.getSPParameters()
Disponibilité
Dreamweaver MX.
Description
Cette fonction renvoie un tableau d'objets de paramètre pour une procédure nommée.
Arguments
connName, procName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument procName est le nom de la procédure.
Valeurs renvoyées
Tableau d'objets de paramètre, chacun d'entre eux spécifiant l'ensemble de propriétés suivant :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 78
API de base de données
Nom de la propriété
Description
name
Nom du paramètre (par exemple, @@lolimit)
datatype
Type de données du paramètre (par exemple, smallmoney)
direction
Direction du paramètre :
1 : Le paramètre est utilisé uniquement pour l'entrée.
2 : Le paramètre est utilisé uniquement pour la sortie. Dans ce cas, vous
transmettez le paramètre par référence et la méthode place une valeur dedans.
Vous pouvez utiliser la valeur une fois la méthode renvoyée.
3 : Le paramètre est utilisé pour l'entrée et la sortie.
4 : Le paramètre contient une valeur de retour.
Exemple
L'exemple suivant extrait les objets de paramètre pour la procédure spécifiée et crée une infobulle pour chaque objet
qui utilise ses propriétés.
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()
Disponibilité
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une chaîne délimitée par des virgules et contenant la liste des paramètres pris par la procédure
stockée.
Arguments
connName, procName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument procName est le nom de la procédure stockée.
Valeurs renvoyées
Chaîne délimitée par virgules contenant la liste des paramètres requis par la procédure stockée. Les noms, la direction
et le type de données des paramètres sont inclus, séparés par des points-virgules (;).
Exemple
Le code MMDB.getSPParamsAsString ("EmpDB","getNewEmployeesMakingAtLeast") peut renvoyer une chaîne
de nom de formulaire startDate;direction:in;datatype:date, salary;direction:in;datatype:integer.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 79
API de base de données
Dans cet exemple, la procédure stockée getNewEmployeesMakingAtLeast a deux paramètres: startDate et Salary.
Pour startDate, la direction est in et le type de données est date. Pour salary, la direction est in et le type de
données est date.
MMDB.getTables()
Disponibilité
Dreamweaver UltraDev 1.
Description
Extrait une liste de toutes les tables définies pour la base de données spécifiée. Chaque objet de table possède trois
propriétés : table, schema et catalog.
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
Valeurs renvoyées
Tableau d'objets possédant chacun trois propriétés : table, schema et catalog. Table est le nom de la table. Schema
est le nom du schéma qui contient la table. Catalog est le catalogue qui contient la table.
Exemple
L'instruction MMDB.getTables ("EmpDB"); pourrait produire un tableau de deux objets. Les propriétés du premier
objet peuvent ressembler à l'exemple suivant :
object1[table:"Employees", schema:"personnel", catalog:"syscat"]
Les propriétés du second objet peuvent ressembler à l'exemple suivant :
object2[table:"Departments", schema:"demo", catalog:"syscat2"]
MMDB.getViews()
Disponibilité
Dreamweaver UltraDev 4.
Description
Extrait une liste de tous les modes d'affichage définis pour la base de données spécifiée. Chaque objet mode d'affichage
a les propriétés catalog, schema et view.
Arguments
connName
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 80
API de base de données
Valeurs renvoyées
Tableau d'objets de mode possédant chacun trois propriétés : catalog, schema et view. Catalog ou schema permet
de restreindre/filtrer le nombre de modes d'affichage rattachés à un nom de schéma individuel ou à un nom de
catalogue défini comme faisant partie des informations de connexion.
Exemple
L'exemple suivant renvoie les modes pour une valeur de connexion donnée, CONN_LIST.getValue() :
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()
Disponibilité
Dreamweaver UltraDev 1.
Description
Affiche une boîte de dialogue contenant les résultats de l'exécution de la déclaration SQL spécifiée. La boîte de dialogue
contient une grille dont l'en-tête reflète les informations de colonnes qui décrivent le jeu de résultats. Si la chaîne de
connexion ou l'instruction SQL n'est pas valide, une erreur apparaît. Cette fonction valide l'instruction SQL.
Arguments
connName, SQLstatement
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument SQLstatement désigne l'instruction SQL SELECT.
Valeurs renvoyées
Aucune. Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte.
Exemple
Le code suivant affiche le résultat de l'instruction SQL exécutée :
MMDB.showResultset("EmpDB","Select EmpName,EmpFirstName,Age ¬
from Employees")
RÉFÉRENCE DES API DE DREAMWEAVER CS4 81
API de base de données
MMDB.showSPResultset()
Disponibilité
Dreamweaver UltraDev 1.
Description
Affiche une boîte de dialogue contenant les résultats de l'exécution de la procédure stockée spécifiée. La boîte de
dialogue contient une grille dont l'en-tête reflète les informations de colonne qui décrivent le jeu de résultats. Si la
chaîne de connexion ou la procédure stockée n'est pas valide, une erreur apparaît. Cette fonction valide la procédure
stockée.
Arguments
connName, procName, paramValuesArray
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument procName est le nom de la procédure stockée à exécuter.
• L'argument paramValuesArray est un tableau contenant une liste de valeurs tests de paramètre au moment de la
conception. Spécifiez les valeurs de paramètre dans l'ordre attendu par la procédure stockée. Vous pouvez utiliser
la fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée.
Valeurs renvoyées
Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte, sinon, elle ne
renvoie rien.
Exemple
Le code suivant affiche le résultat de la procédure stockée exécutée :
var paramValueArray = new Array("2/1/2000", "50000")
MMDB.showSPResultset("EmpDB", "getNewEmployeesMakingAtLeast", ¬
paramValueArray)
MMDB.showSPResultsetNamedParams()
Disponibilité
Dreamweaver UltraDev 1.
Description
Affiche une boîte de dialogue contenant le jeu de résultats de la procédure stockée spécifiée. La boîte de dialogue
contient une grille dont l'en-tête reflète les informations de colonne qui décrivent le jeu de résultats. Si la chaîne de
connexion ou la procédure stockée n'est pas valide, une erreur apparaît. Cette fonction valide la procédure stockée.
Cette fonction diffère de MMDB.showSPResultset(), car vous pouvez spécifier les valeurs de paramètre par leur nom,
au lieu de l'ordre attendu par la procédure stockée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 82
API de base de données
Arguments
connName, procName, paramNameArray, paramValuesArray
• connName est un nom de connexion spécifié dans le Gestionnaire de connexions. Il identifie la chaîne de connexion
que Dreamweaver doit utiliser pour connecter la base de données à une source de données active.
• L'argument procName est le nom de la procédure stockée qui renvoie le jeu de résultats lorsqu'elle est exécutée.
• L'argument paramNameArray est un tableau contenant une liste de noms de paramètres. Vous pouvez utiliser la
fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée.
• L'argument paramValuesArray est un tableau contenant une liste de valeurs tests de paramètre au moment de la
conception.
Valeurs renvoyées
Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte, sinon, elle ne
renvoie rien.
Exemple
Le code suivant affiche le résultat de la procédure stockée exécutée :
var paramNameArray = new Array("startDate", "salary")
var paramValueArray = new Array("2/1/2000", "50000")
MMDB.showSPResultsetNamedParams("EmpDB","getNewEmployees¬
MakingAtLeast", paramNameArray, paramValueArray)
83
Chapitre 9 : API de connectivité à une base
de données
En tant que développeur, vous pouvez créer de nouveaux types de connexion et les boîtes de dialogue correspondantes
pour les modèles de serveur nouveaux et existants de Adobe® Dreamweaver®. L'utilisateur peut ensuite créer un objet
de connexion lors de la configuration d'un site afin d'entamer la création de pages. Pour créer un objet de connexion,
l'utilisateur doit tout d'abord sélectionner le type de connexion spécifique que vous avez créé.
Sélection d'un nouveau type de connexion
L'utilisateur peut sélectionner votre nouveau type de connexion de plusieurs manières :
• Dans le panneau Application, l'utilisateur peut cliquer sur le bouton Plus (+) et sélectionner Jeu d'enregistrements.
Dans la boîte de dialogue Jeu d'enregistrements, il peut agrandir la fenêtre de la liste Connexion.
• Il peut cliquer sur le bouton Plus (+) et sélectionner Nom de la source de données dans l'onglet Base de données du
panneau Bases de données.
Création d'un nouveau type de connexion
Les étapes suivantes expliquent le processus de création d'un nouveau type de connexion :
1 Définissez la mise en forme de la boîte de dialogue de connexion.
Créez un fichier HTML mettant en forme l'interface utilisateur de votre boîte de dialogue de connexion. Donnez
un nom à ce fichier en utilisant le nom de la connexion (par exemple myConnection.htm). Pour plus
d'informations sur la création d'une boîte de dialogue, voir Bien démarrer avec Dreamweaver.
Assurez-vous que ce fichier HTML contient bien une référence au fichier de mise en œuvre JavaScript défini à
l'étape 2, Créez un fichier JavaScript mettant en œuvre au moins les éléments suivants, comme le montre l'exemple
suivant :
<head>
<script SRC="../myConnectionImpl.js"></script>
</head>
Stockez ce fichier HTML, qui définit votre boîte de dialogue de connexion, dans le dossier
Configuration/Connections/modèle_serveur/plate-forme (où la plate-forme est Windows ou Macintosh).
Par exemple, la boîte de dialogue de connexion ADO par défaut pour un document ASP JavaScript sur une plateforme Windows est stockée dans le dossier ASP_Js/Win et est intitulée Connection_ado_conn_string.htm.
Remarque : Pendant l'exécution, Dreamweaver établit de manière dynamique la liste des types de connexion
disponibles dans l'ensemble des boîtes de dialogue présentes dans le dossier ASP_Js/Win.
Le dossier Configuration/ServerModels contient des fichiers HTML qui définissent chaque modèle de serveur.
Chaque fichier HTML contient la fonction getServerModelFolderName() qui renvoie le nom du dossier associé
au modèle de serveur. L'exemple suivant indique la fonction pour le type de document ASP JavaScript :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 84
API de connectivité à une base de données
function getServerModelFolderName()
{
return "ASP_JS";
}
Vous pouvez également consulter le fichier MMDocumentTypes.xml, situé dans le dossier
Configuration/DocumentTypes, pour déterminer la correspondance entre les modèles de serveur et les types de
documents.
2 Créez un fichier JavaScript qui implémente au moins les éléments suivants :
Elément
Description
Exemples
Un ensemble de variables
Chaque variable définit une propriété
de connexion spécifique.
Type de connexion, nom de la
source de données, etc.
Un ensemble de boutons
Tous les boutons apparaissent dans la
boîte de dialogue de connexion.
Tester, Aide, etc. (OK et Annuler
sont automatiquement inclus)
Fonctions de
connectivité
Ensemble, ces fonctions définissent
l'API de connectivité.
•
findConnection()
•
applyConnection()
•
inspectConnection()
Vous pouvez choisir n'importe quel nom pour ce fichier de mise en œuvre, mais il doit comporter une extension
.js (par exemple, myConnectionImpl.js). Vous pouvez stocker ce fichier de mise en œuvre sur votre ordinateur local
ou distant. Si vous le souhaitez, vous pouvez également le stocker dans le sous-dossier approprié du dossier
Configuration/Connections.
Remarque : Le fichier HTML défini à l'étape 1, Définissez la mise en forme de la boîte de dialogue de connexion, doit
contenir ce fichier de mise en œuvre du type de connexion.
Ces deux étapes constituent les conditions minimales pour créer une nouvelle boîte de dialogue de connexion, sauf si
vous avez besoin de définir des paramètres de connexion autres que ceux fournis dans le fichier standard
connection_includefile.edml.
Remarque : Le titre de la boîte de dialogue que voit l'utilisateur se trouve dans la balise title, spécifiée dans le
document HTML.
Les fonctions répertoriées dans la section suivante permettent de créer une boîte de dialogue de connexion. En plus
d'implémenter les appels pour la génération des fichiers inclus réservés à l'utilisateur, vous pouvez enregistrer votre
type de connectivité dans la section du modèle de serveur du fichier XML de connexion.
Pour plus d'informations sur l'API de connectivité à une base de données, associée à la création d'une nouvelle
connexion, voir « Fonctions de connexion à une base de données » à la page 59.
L'API de connexion
Pour créer un nouveau type de connexion, y compris la boîte de dialogue avec laquelle les utilisateurs interagissent,
vous devez implémenter les trois fonctions suivantes : findConnection(), inspectConnection() et
applyConnection(). Vous devez rédiger ces trois fonctions et les inclure dans le fichier de mise en œuvre JavaScript
associé à votre nouveau type de connexion (voir Etape 2, Créez un fichier JavaScript qui implémente au moins les
éléments suivants :).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 85
API de connectivité à une base de données
La fonction applyConnection() renvoie une source HTML dans un fichier inclus. Vous trouverez des exemples de
source HTML dans la section « Fichier inclus généré » à la page 87. La fonction findConnection() prend la source
HTML et en extrait les propriétés. Vous pouvez mettre en œuvre findConnection() pour utiliser les modèles de
recherche dans les fichiers XML afin d'extraire les informations renvoyées à partir de applyConnection(). Si vous
souhaitez voir un exemple de ce type de mise en œuvre, étudiez les deux fichiers JavaScript suivants :
• Le fichier connection_ado_conn_string.js se trouve dans le dossier Configuration/Connections/ASP_Js.
• Le fichier connection_common.js se trouve dans le dossier Configuration/Connections/Shared.
Lorsque l'utilisateur ouvre un site, Dreamweaver parcourt tous les fichiers dans le dossier Connections, les ouvre et
transmet leur contenu à la fonction findConnection(). Si le contenu d'un fichier correspond aux critères d'une
connexion valide, findConnection() renvoie un objet de connexion. Dreamweaver répertorie ensuite tous les objets
de connexion dans le panneau Explorateur de base de données.
Lorsque l'utilisateur ouvre une boîte de dialogue de connexion et choisit de créer une nouvelle connexion ou de
dupliquer ou encore de modifier une connexion existante, Dreamweaver déclenche la fonction
inspectConnection() et retransmet le même objet de connexion créé par findConnection(). Ce processus permet
à Dreamweaver de renseigner la boîte de dialogue en utilisant les informations de connexion.
Lorsque l'utilisateur clique sur OK dans une boîte de dialogue de connexion, Dreamweaver déclenche la fonction
applyConnection() pour construire la page HTML, placée dans le fichier inclus de connexion résidant dans le
dossier Configuration/Connections. La fonction applyConnection() renvoie une chaîne vide qui indique une erreur
dans l'un des champs. La boîte de dialogue ne doit pas être fermée. Le fichier inclus a un type d'extension de fichier par
défaut pour le modèle de serveur en cours.
Lorsque l'utilisateur ajoute à une page un comportement de serveur qui utilise la connexion, tel qu'un jeu
d'enregistrements ou une procédure stockée, Dreamweaver ajoute une instruction à la page qui comprend le fichier
inclus de connexion.
findConnection()
Disponibilité
Dreamweaver UltraDev 4.
Description
Dreamweaver appelle cette fonction pour détecter une connexion dans la source HTML spécifiée et analyser les
paramètres de la connexion. Si le contenu de ce fichier source respecte les critères permettant une connexion valide,
findConnection() renvoie un objet de connexion ; dans le cas contraire, cette fonction renvoie une valeur null.
Argument
htmlSource
L'argument htmlSource est la source HTML d'une connexion.
Valeurs renvoyées
Objet de connexion qui fournit les valeurs d'une combinaison particulière de propriétés répertoriées dans le tableau
suivant. Les propriétés pour lesquelles cette fonction renvoie une valeur dépendent du type de document.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 86
API de connectivité à une base de données
Propriété
Description
name
Nom de la connexion.
type
Si useHTTP est false, indique quelle DLL doit être utilisée pour la connexion à
des bases de données au moment de l'exécution.
string
Chaîne de connexion d'exécution. Pour ADO, il s'agit d'une chaîne de paramètres
de connexion ; pour JDBC, il s'agit d'une URL de connexion.
dsn
Nom de la source de données utilisé pour les connexions de d'exécution ODBC
ou Cold Fusion
driver
Nom d'un pilote JDBC utilisé pendant l'exécution
username
Nom d'utilisateur employé pour la connexion d'exécution.
password
Mot de passe utilisé pour la connexion d'exécution.
designtimeString
Chaîne de connexion au moment de la conception (voir string).
designtimeDsn
Nom de la source de données au moment de la conception (voir dsn)
designtimeDriver
Nom d'un pilote JDBC utilisé au moment de la conception
designtimeUsername
Nom de l'utilisateur employé pour la connexion au moment de la conception.
designtimePassword
Mot de passe utilisé pour la connexion au moment de la conception.
designtimeType
Type de connexion utilisée au moment de la conception.
usesDesigntimeInfo
En cas de valeur false, Dreamweaver utilise les propriétés d'exécution au
moment de la conception ; dans le cas contraire, Dreamweaver utilise les
propriétés au moment de la conception.
useHTTP
Chaîne contenant true ou false ; true indique d'utiliser la connexion HTTP
au moment de la conception, et false d'utiliser une DLL.
includePattern
Expression régulière utilisée pour trouver l'instruction d'inclusion de fichier sur la
page pendant Live Data et Aperçu dans le navigateur.
variables
Objet ayant une propriété pour chaque variable de page définie sur sa valeur
correspondante. Cet objet est utilisé pendant Live Data et Aperçu dans le
navigateur.
catalog
Chaîne contenant un identificateur de base de données qui restreint la quantité
de métadonnées qui apparaissent.
schema
Chaîne contenant un identificateur de base de données qui restreint la quantité
de métadonnées qui apparaissent.
filename
Nom de la boîte de dialogue utilisée pour créer la connexion.
Si une connexion n'est pas trouvée dans htmlSource, une valeur null est renvoyée.
Remarque : Les développeurs peuvent ajouter des propriétés personnalisées (par exemple, métadonnées) à la source
HTML, qui renvoie applyConnection() avec les propriétés standard.
inspectConnection()
Disponibilité
Dreamweaver UltraDev 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 87
API de connectivité à une base de données
Description
Dreamweaver appelle cette fonction pour initialiser les données de la boîte de dialogue pour définir une connexion
lorsque l'utilisateur modifie une connexion existante. Ce processus permet à Dreamweaver de renseigner la boîte de
dialogue en utilisant les informations de connexion appropriées.
Argument
paramètres
L'argument parameters est le même objet que celui qui est renvoyé par la fonction findConnection().
Valeurs renvoyées
Aucune.
applyConnection()
Disponibilité
Dreamweaver UltraDev 4.
Description
Dreamweaver déclenche cette fonction lorsque l'utilisateur clique sur OK dans la boîte de dialogue de connexion. La
fonction applyConnection() génère la source HTML pour une connexion. Dreamweaver écrit le HTML dans le
fichier inclus Configuration/Connections/nom-connexion.ext, où nom-connexion est le nom de votre connexion (voir
« Création d'un nouveau type de connexion » à la page 83) et .ext est l'extension par défaut associée au modèle de
serveur.
Arguments
Aucun.
Valeurs renvoyées
Source HTML pour une connexion. Dreamweaver ferme également la boîte de dialogue de connexion. Si une erreur
de validation d'un champ se produit, applyConnection() affiche un message d'erreur et renvoie une chaîne vide pour
indiquer que la boîte de dialogue doit rester ouverte.
Fichier inclus généré
Le fichier inclus que applyConnection() génère déclare toutes les propriétés d'une connexion. Le nom du fichier
inclus est le nom de la connexion. Il possède l'extension définie pour le modèle de serveur associé au site actuel.
Remarque : Les connexions étant partagées, définissez la valeur allowMultiple sur false. Elle garantit que le fichier
de connexion n'est inclus qu'une fois dans le document. En outre, elle garantit que le script de serveur reste sur la page si
d'autres comportements de serveur l'utilisent.
Vous trouverez quelques exemples de fichiers inclus que applyConnection() génère pour divers modèles de serveur
par défaut illustrés dans les sections suivantes.
Remarque : Pour créer un format de fichier inclus de connexion, définissez un nouveau fichier de mappage EDML,
similaire à connection_includefile.edml, comme l'explique la section « Fichier de définition pour votre type de
connexion » à la page 88.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 88
API de connectivité à une base de données
ASP JavaScript
Le fichier inclus ASP et JavaScript doit être nommé MyConnection1.asp, où MyConnection1 est le nom de la
connexion. L'exemple suivant est un fichier inclus pour une chaîne de connexion ADO :
<%
// Filename="Connection_ado_conn_string.htm"
// Type="ADO"
// HTTP="true"
// Catalog=""
// Schema=""
var MM_MyConnection1_STRING = "dsn=pubs";
%>
Le fichier du comportement de serveur inclut cette connexion en utilisant l'instruction d'inclusion de fichier relative,
comme le montre l'exemple suivant :
<!--#include file="../Connections/MyConnection1.asp"-->
ColdFusion
Lorsque vous utilisez UltraDev 4 ColdFusion, Dreamweaver s'appuie sur un fichier inclus ColdFusion pour extraire
une liste des sources de données.
Remarque : Avec Dreamweaver ColdFusion standard, Dreamweaver ignore tous les fichiers inclus et utilise les RDS pour
récupérer la liste des sources de données à partir de ColdFusion.
Le fichier inclus UltraDev 4 ColdFusion doit être nommé MyConnection1.cfm, où MyConnection1 est le nom de votre
connexion. L'exemple suivant illustre le fichier inclus pour une connexion ColdFusion à un tableau de produits :
<!-- FileName="Connection_cf_dsn.htm" "dsn=products" -->
<!-- Type="ADO" -->
<!-- Catalog="" -->
<!-- Schema="" -->
<!-- HTTP="false" -->
<CFSET MM_MyConnection1_DSN
= "products">
<CFSET MM_MyConnection1_USERNAME
= "">
<CFSET MM_Product_USERNAME
= "">
<CFSET MM_MyConnection1_PASSWORD
= "">
Le fichier du comportement de serveur inclut cette connexion en utilisant l'instruction cfinclude, comme le montre
l'exemple suivant :
<cfinclude template="Connections/MyConnection1.cfm">
Fichier de définition pour votre type de connexion
Pour tous les modèles de serveur, il existe un fichier connection_includefile.edml qui définit le type de connexion et
associe les propriétés définies dans le fichier inclus aux éléments de l'interface Dreamweaver.
Par défaut, Dreamweaver fournit des fichiers de définition, un pour chacun des modèles de serveur prédéfinis, comme
l'illustre le tableau suivant.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 89
API de connectivité à une base de données
Modèle de serveur
Sous-dossier du dossier Configuration/Connections
ASP JavaScript
ASP_Js
ASP.NET CSharp
ASP.NET_Csharp
ASP.NET VBScrip
ASP.NET_VB
ASP VBScript
ASP_Vbs
ColdFusion
ColdFusion
JavaServer Page
JSP
PHP MySql
PHP_MySql
Dreamweaver utilise les paramètres quickSearch et searchPattern pour reconnaître les blocs de connexion et le
paramètre insertText afin de créer des blocs de connexion. Pour plus d'informations sur les balises et les attributs
EDML et sur les modèles de recherche d'expression régulière, voir « Comportements de serveur » dans Extension de
Dreamweaver.
Remarque : Si vous changez le format de votre fichier inclus ou si vous définissez un fichier inclus pour un nouveau
modèle de serveur, vous devez associer les paramètres de connexion avec l'interface utilisateur de Dreamweaver, Live
Data et Aperçu dans le navigateur. L'exemple suivant de fichier EDML, associé au modèle de serveur ASP JS par défaut,
met en correspondance toutes les variables de page de connexion avec leurs valeurs dynamiques respectives avant
d'envoyer la page au serveur. Pour plus d'informations sur EDML et les modèles de recherche d'expression régulière, voir
« Comportements de serveur » dans Extension de Dreamweaver.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 90
API de connectivité à une base de données
<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>
Les expressions d'un fichier EDML, telles que @@filename@@ dans cet exemple, associent les valeurs du fichier inclus
avec les propriétés d'un objet de connexion. Les propriétés des objets de connexion sont définies dans le fichier de mise
en œuvre JavaScript.
Toutes les boîtes de dialogue de connexion par défaut de Dreamweaver utilisent le fichier de correspondance
connection_includefile.edml. Pour permettre à Dreamweaver de trouver ce fichier, son nom est défini dans le fichier
de mise en œuvre JavaScript, comme le montre l'exemple suivant :
var PARTICIPANT_FILE = "connection_includefile";
Lors de la création d'un type de connexion personnalisée, vous pouvez utiliser n'importe quel fichier de
correspondance dans vos boîtes de dialogue personnalisées. Si vous créez un fichier de correspondance, vous pouvez
utiliser un nom différent de connection_includefile pour votre fichier EDML. Si vous utilisez un autre nom, vous devez
l'utiliser dans votre fichier de mise en œuvre JavaScript lorsque vous indiquez la valeur assignée à la variable
PARTICIPANT_FILE comme le montre l'exemple suivant :
var PARTICIPANT_FILE = "myConnection_mappingfile";
91
Chapitre 10 : API d'intégration de
commande source
L'API d'intégration de commande source permet de rédiger des bibliothèques partagées. Ces API vous permettent
d'étendre la fonctionnalité Archivage/Extraction d'Adobe® Dreamweaver® à l'aide de systèmes de commande source
(tels que Sourcesafe ou CVS).
Vos bibliothèques doivent prendre en charge un minimum de fonctions API pour que Dreamweaver puisse être
intégré au système de commande source. En outre, vos bibliothèques doivent se trouver dans le dossier Program
Files/Adobe/Adobe Dreamweaver CS4/Configuration/SourceControl.
Lorsque vous démarrez Dreamweaver, celui-ci charge toutes les bibliothèques. Il détermine les fonctionnalités prises
en charge par chaque bibliothèque en appelant la fonction GetProcAddress() pour chaque API. Si une adresse
n'existe pas, Dreamweaver suppose que la bibliothèque ne prend pas en charge l'API. Si l'adresse existe, Dreamweaver
utilise la version de la fonction qui se trouve dans la bibliothèque pour prendre en charge la fonctionnalité. Lorsqu'un
utilisateur Dreamweaver définit ou modifie un site, puis choisit l'onglet SCS du serveur Web, les choix correspondant
aux DLL s'affichent dans l'onglet. Ces choix s'affichent en plus des éléments standard de l'onglet. Ces DLL sont
chargées depuis le dossier Program Files/Adobe/Adobe Dreamweaver CS4/Configuration/SourceControl.
Pour créer un menu Site > Commande source auquel vous pouvez ajouter des éléments personnalisés, ajoutez le code
suivant. Ajoutez le code dans le menu Site, dans le fichier menus.xml :
<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>
Fonctionnement de l'intégration des commandes
source avec Dreamweaver
Lorsqu'un utilisateur Dreamweaver choisit des fonctions de connexion au serveur, de transfert de fichiers ou de Design
Notes, Dreamweaver appelle la version de la DLL de la fonction API correspondante (Connect(), Disconnect(),
Get(), Put(), Checkin(), Checkout(), Undocheckout() et Synchronize()). La DLL est responsable de la gestion
de la requête, notamment de l'affichage des boîtes de dialogue qui rassemblent les informations ou qui permettent à
l'utilisateur d'interagir avec la DLL. La DLL affiche également des informations ou des messages d'erreur.
Le système de commande source peut éventuellement prendre en charge les Design Notes et la fonction
d'archivage/extraction. Pour activer les Design Notes dans les systèmes de commande source, l'utilisateur
Dreamweaver doit choisir l'onglet Design Notes dans la boîte de dialogue Modifier les sites et cocher la case qui permet
d'activer cette fonctionnalité (cette procédure s'applique également aux systèmes FTP et de réseau local). Si le système
de commande source ne prend pas en charge les Design Notes et que l'utilisateur souhaite les utiliser, Dreamweaver
transporte les fichiers Design Note (.mno) pour gérer les Design Notes (de la même façon qu'avec les systèmes FTP et
de réseau local).
Les fonctions d'archivage et d'extraction sont traitées différemment ; si le système de commande source les prend en
charge, l'utilisateur ne peut pas éviter leur utilisation dans la boîte de dialogue Design Notes. Si l'utilisateur essaie de
court-circuiter le système de commande source, un message d'erreur s'affiche.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 92
API d'intégration de commande source
Ajout d'une fonctionnalité de système de commande
source
Pour ajouter une fonctionnalité de système de commande source à Dreamweaver, rédigez un gestionnaire
GetNewFeatures qui renvoie un jeu d'éléments de menu et les fonctions C correspondantes. Si, par exemple, vous
rédigez une bibliothèque Sourcesafe et que vous souhaitez permettre aux utilisateurs de Dreamweaver de consulter
l'historique d'un fichier, vous pouvez rédiger un gestionnaire GetNewFeatures qui renvoie l'élément de menu
Historique et le nom de la fonction C history. Ainsi, sous Windows, si un utilisateur clique avec le bouton droit de
la souris sur un fichier, l'élément Historique s'affiche dans le menu. Si l'utilisateur choisit alors l'élément de menu
Historique, Dreamweaver appelle la fonction correspondante, qui se charge de transmettre les fichiers sélectionnés à
la DLL. La DLL affiche ensuite la boîte de dialogue Historique, ce qui permet à l'utilisateur d'interagir avec elle de la
même façon que Sourcesafe.
Fonctions requises de l'API d'intégration de commande
source
L'API d'intégration de commande source comporte des fonctions obligatoires et facultatives. Les fonctions
répertoriées dans cette section sont obligatoires.
bool SCS_GetAgentInfo()
Description
Demande à la DLL de renvoyer son nom et sa description, qui sont affichés dans la boîte de dialogue Modifier les sites.
Le nom apparaît dans le menu déroulant Accès (par exemple, Sourcesafe, WebDav, Perforce) et la description s'affiche
juste en dessous du menu.
Arguments
char name[32], char version[32], char description[256], const char *dwAppVersion
• name est le nom du système de commande source. Ce nom s'affiche dans la zone de liste modifiable permettant de
sélectionner un système de commande source, dans l'onglet Commande source de la boîte de dialogue Modifier les
sites. Le nom du ne doit pas compter plus de 32 caractères.
• version est une chaîne qui indique la version de la DLL. La version apparaît dans l'onglet Commande source de la
boîte de dialogue Modifier les sites. La version ne doit pas compter plus de 32 caractères.
• description est une chaîne qui décrit le système de commande source. La description apparaît dans l'onglet
Commande source de la boîte de dialogue Modifier les sites. La description ne doit pas compter plus de 256
caractères.
• dwAppVersion est une chaîne qui décrit la version de Dreamweaver appelant la DLL. La DLL peut utiliser cette
chaîne pour déterminer la version et la langue de Dreamweaver.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 93
API d'intégration de commande source
bool SCS_Connect()
Description
Connecte l'utilisateur à son système de commande source. Si la DLL ne dispose pas d'informations de connexion, elle
doit afficher une boîte de dialogue invitant l'utilisateur à entrer des informations, et elle doit stocker les données pour
une utilisation ultérieure.
Arguments
void **connectionData, const char siteName[64]
• connectionData est un descripteur des données que l'agent souhaite recevoir de Dreamweaver lorsqu'il appelle
d'autres fonctions API.
• L'argument siteName est une chaîne qui pointe vers le nom du site. Le nom du site ne doit pas compter plus de 64
caractères.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Disconnect()
Description
Déconnecte l'utilisateur du système de commande source.
Arguments
void *connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_IsConnected()
Description
Détermine l'état de la connexion.
Arguments
void *connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 94
API d'intégration de commande source
int SCS_GetRootFolderLength()
Description
Renvoie la longueur du nom du dossier racine.
Arguments
void *connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Nombre entier qui indique la longueur du nom du dossier racine. Si la fonction renvoie < 0, Dreamweaver considère
cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est prise en charge.
bool SCS_GetRootFolder()
Description
Renvoie le nom du dossier racine.
Arguments
void *connectionData, char remotePath[], const int folderLen
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est une mémoire tampon dans laquelle est enregistré le chemin distant complet du dossier racine.
• folderLen est un nombre entier qui indique la longueur de l'argument remotePath. Il s'agit de la valeur renvoyée par
la fonction GetRootFolderLength.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
int SCS_GetFolderListLength()
Description
Renvoie le nombre d'éléments dans le dossier transmis.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le chemin d'accès et le nom complets du dossier distant dont la DLL vérifie le nombre d'éléments.
Valeurs renvoyées
Nombre entier qui indique le nombre d'éléments dans le dossier en cours. Si la fonction renvoie < 0, Dreamweaver
considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est prise en charge.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 95
API d'intégration de commande source
bool SCS_GetFolderList()
Description
Renvoie une liste de fichiers et de dossiers dans le dossier transmis, notamment des informations pertinentes telles que
la date de modification, la taille et si l'élément est un dossier ou un fichier.
Arguments
void *connectionData, const char *remotePath, itemInfo itemList[ ], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le nom du chemin d'accès au dossier distant dont la DLL vérifie le nombre d'éléments.
• L'argument itemList est une liste pré-allouée de structures itemInfo :
name
char[256]
nom de fichier ou de dossier
isFolder
bool
true si c'est un dossier, false si c'est un fichier
month
int
Composant mois de la date de modification, de 1 à 12
day
int
Composant jour de la date de modification, de 1 à 31
year
int
Composant année de la date de modification, 1900+
hour
int
Composant heure de la date de modification, de 0 à 23
minutes
int
Composant minute de la date de modification, de 0 à 59
seconds
int
Composant seconde de la date de modification, de 0 à 59
type
char[256]
Type de fichier (s'il n'est pas défini par la DLL, Dreamweaver
utilise l'extension de fichier pour déterminer le type, comme il
le fait à présent)
size
int
En octets
• numItems est le nombre d'éléments alloués à l'argument itemList (renvoyé par la fonction
GetFolderListLength).
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Get()
Description
Extrait une liste de fichiers ou de dossiers et les stocke localement.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePathList est une liste des fichiers ou dossiers distants à extraire, exprimée sous la forme de noms et de
chemins d'accès complets.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 96
API d'intégration de commande source
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Put()
Description
Place une liste de fichiers ou de dossiers locaux dans le système de commande source.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument localPathList est la liste des noms de fichiers locaux ou des chemins de fichiers à placer dans le système
de commande source.
• L'argument remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers distants.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_NewFolder()
Description
Crée un nouveau dossier.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le chemin d'accès complet du dossier distant que la DLL crée.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Delete()
Description
Supprime une liste de fichiers ou de dossiers du système de commande source.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 97
API d'intégration de commande source
Arguments
void *connectionData, const char *remotePathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument remotePathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers distants à
supprimer.
• numItems est le nombre d'éléments dans remotePathList.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Rename()
Description
Renomme ou déplace un fichier ou un dossier selon les valeurs spécifiées dans les arguments oldRemotePath et
newRemotePath. Ainsi, si les valeurs de oldRemotePath et newRemotePath sont respectivement "$/folder1/file1" et
"$/folder1/renamefile1", le fichier file1 se voit attribuer le nouveau nom renamefile1 et reste dans le dossier
folder1.
Si les valeurs de oldRemotePath et de newRemotePath sont respectivement "$/folder1/file1" et
"$/folder1/subfolder1/file1", le fichier file1 est alors déplacé dans le sous-dossier subfolder1.
Pour savoir si l'invocation de cette fonction constitue un déplacement ou l'attribution d'un nouveau nom, vérifiez les
chemins parents des deux valeurs d'entrée ; s'ils sont identiques, il s'agit de l'opération « renommer ».
Arguments
void *connectionData, const char *oldRemotePath, const char *newRemotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• oldRemotePath est le nom du chemin d'accès au fichier ou dossier distant à renommer.
• newRemotePath est le nom du chemin d'accès au nouveau fichier ou dossier distant.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_ItemExists()
Description
Détermine si un fichier ou un dossier existe sur le serveur.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le chemin d'accès d'un fichier ou d'un dossier distant.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 98
API d'intégration de commande source
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Fonctions facultatives de l'API d'intégration de
commande source
L'API d'intégration de commande source comporte des fonctions obligatoires et facultatives. Les fonctions
répertoriées dans cette section sont facultatives.
bool SCS_GetConnectionInfo()
Description
Affiche une boîte de dialogue qui permet à l'utilisateur de modifier ou de définir les informations de connexion du site.
N'établit pas la connexion. Cette fonction est appelée lorsque l'utilisateur clique sur le bouton Paramètres dans la
section Infos distantes de la boîte de dialogue Modifier les sites.
Arguments
void **connectionData, const char siteName[64]
• L'argument connectionData est un descripteur des données que l'agent veut recevoir de Dreamweaver lorsqu'il
appelle d'autres fonctions API.
• L'argument siteName est une chaîne qui pointe vers le nom du site. Ce nom ne peut pas comporter plus de 64
caractères.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_SiteDeleted()
Description
Informe la DLL que le site a été supprimé ou qu'il n'est plus lié à ce système de commande source. Cette fonction
indique au système de commande source qu'il peut supprimer les informations persistantes du site.
Arguments
const char siteName[64]
• L'argument siteName est une chaîne qui pointe vers le nom du site. Ce nom ne peut pas comporter plus de 64
caractères.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 99
API d'intégration de commande source
bool SCS_SiteRenamed()
Description
Notifie à la DLL que l'utilisateur a renommé le site, pour qu'il puisse mettre à jour les informations persistantes
relatives à ce site.
Arguments
const char oldSiteName[64], const char newSiteName[64]
• oldSiteName est une chaîne qui pointe vers le nom initial du site, avant qu'il ne soit renommé. Ce nom ne peut pas
comporter plus de 64 caractères.
• newSiteName est une chaîne qui pointe vers le nouveau nom du site, après qu'il a été renommé. Ce nom ne peut pas
comporter plus de 64 caractères.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
int SCS_GetNumNewFeatures()
Description
Renvoie le nombre de nouvelles fonctions à ajouter à Dreamweaver (comme Historique de fichier, Différences, etc.).
Arguments
Aucun.
Valeurs renvoyées
Nombre entier qui indique le nombre de nouvelles fonctionnalités à ajouter à Dreamweaver. Si la fonction renvoie <
0, Dreamweaver considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle
est prise en charge.
bool SCS_GetNewFeatures()
Description
Renvoie une liste d'éléments à ajouter aux menus principaux et contextuels de Dreamweaver. Par exemple, la DLL
Sourcesafe peut ajouter Historique et Différences de fichiers au menu principal.
Arguments
char menuItemList[][32], scFunction functionList[], scFunction enablerList[], const int numNewFeatures
• menuItemList est une liste de chaînes complétée par la DLL et indiquant les éléments à ajouter aux menus
principaux et contextuels. Chaque chaîne peut contenir 32 caractères maximum.
• L'argument functionList est renseigné par la DLL ; il indique les routines de la DLL à appeler lorsque l'utilisateur
choisit l'élément de menu correspondant.
• L'argument enablerList est renseigné par la DLL ; il indique les routines de la DLL à appeler lorsque Dreamweaver
a besoin de déterminer si l'élément de menu correspondant est activé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 100
API d'intégration de commande source
• L'argument numNewFeatures est le nombre d'éléments ajoutés par la DLL ; cette valeur est récupérée en appelant
la fonction GetNumNewFeatures().
La signature de fonction suivante définit les fonctions et les activateurs transmis par appel de la fonction
SCS_GetNewFeatures() dans les arguments functionlist et enablerList.
bool (*scFunction)(void *connectionData, const char *remotePathList[],
const char *localPathList[], const int numItems)
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_GetCheckoutName()
Description
Renvoie le nom d'extraction de l'utilisateur en cours. Si le système de commande source ne prend pas en charge cette
fonction et que l'utilisateur a activé l'extraction, la fonction utilise la fonctionnalité interne d'archivage et d'extraction
de Dreamweaver qui transporte les fichiers LCK depuis et vers le système de commande source.
Arguments
void *connectionData, char checkOutName[64], char emailAddress[64]
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• checkOutName est le nom de l'utilisateur en cours.
• emailAddress est l'adresse électronique de l'utilisateur en cours.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Checkin()
Description
Archive une liste de fichiers ou de dossiers locaux dans le système de commande source. La DLL doit configurer le
fichier en lecture seule. Si le système de commande source ne prend pas en charge cette fonction et que l'utilisateur a
activé l'extraction, la fonction utilise la fonctionnalité interne d'archivage et d'extraction de Dreamweaver qui
transporte les fichiers LCK depuis et vers le système de commande source.
Arguments
void *connectionData, const char *localPathList[], const char *remotePathList[], bool successList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument localPathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers locaux à archiver.
• L'argument remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers distants.
• successList est une liste de valeurs booléennes complétée par la DLL pour permettre à Dreamweaver de connaître
les fichiers dont l'archivage a réussi.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 101
API d'intégration de commande source
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_Checkout()
Description
Extrait une liste de fichiers ou de dossiers locaux du système de commande source. La DLL se charge d'accorder les
droits d'accès en écriture au fichier. Si le système de commande source ne prend pas en charge cette fonction et que
l'utilisateur a activé l'extraction, la fonction utilise la fonctionnalité interne d'archivage et d'extraction de Dreamweaver
qui transporte les fichiers LCK depuis et vers le système de commande source.
Arguments
void *connectionData, const char *localPathList[], const char *remotePathList[], bool successList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument remotePathList est une liste de noms de chemin d'accès aux fichiers et aux dossiers distant à extraire.
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux.
• successList est une liste de valeurs booléennes complétée par la DLL pour permettre à Dreamweaver de connaître
les fichiers dont l'extraction a réussi.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_UndoCheckout()
Description
Annule l'état d'extraction d'une liste de fichiers ou de dossiers. La DLL doit configurer le fichier en lecture seule. Si le
système de commande source ne prend pas en charge cette fonction et que l'utilisateur a activé l'extraction, la fonction
utilise la fonctionnalité interne d'archivage et d'extraction de Dreamweaver qui transporte les fichiers LCK depuis et
vers le système de commande source.
Arguments
void *connectionData, const char *localPathList[], const char *remotePathList[], bool successList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePathList est une liste de chemins aux fichiers ou dossiers distants dont l'extraction doit être annulée.
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux.
• successList est une liste de valeurs booléennes complétée par la DLL pour permettre à Dreamweaver de connaître
les fichiers dont l'extraction a été annulée avec succès.
• L'argument numItems est le nombre d'éléments dans chaque liste.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 102
API d'intégration de commande source
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
int SCS_GetNumCheckedOut()
Description
Renvoie le nombre d'utilisateurs dont un fichier a été extrait.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le nom du chemin d'accès au fichier ou dossier distant à vérifier pour connaître le nombre
d'utilisateurs ayant procédé à son extraction.
Valeurs renvoyées
Nombre entier qui représente le nombre de personnes disposant du fichier extrait. Si la fonction renvoie < 0,
Dreamweaver considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est
prise en charge.
bool SCS_GetFileCheckoutList()
Description
Renvoie une liste d'utilisateurs dont un fichier a été extrait. Si cette liste est vide, c'est que personne n'a de fichier extrait.
Arguments
void *connectionData, const char *remotePath, char checkOutList[][64], char emailAddressList[][64], const int
numCheckedOut
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le nom du chemin d'accès au fichier ou dossier distant à vérifier pour connaître le nombre
d'utilisateurs ayant procédé à son extraction.
• checkOutList est une liste de chaînes qui correspond aux utilisateurs disposant du fichier extrait. Chaque chaîne ne
doit pas avoir plus de 64 caractères.
• emailAddressList est une liste de chaînes correspondant aux adresses électroniques des utilisateurs. Chaque adresse
ne doit pas dépasser 64 caractères.
• numCheckedOut est le nombre de personnes qui ont le fichier extrait. Il est renvoyé par GetNumCheckedOut().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 103
API d'intégration de commande source
int SCS_GetErrorMessageLength()
Description
Renvoie la longueur du message d'erreur interne en cours de la DLL. Permet d'allouer la mémoire tampon transmise
dans la fonction GetErrorMessage(). Cette fonction doit être appelée uniquement si une fonction d'API renvoie la
valeur false ou <0, ce qui indique un échec.
Arguments
void *connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Nombre entier représentant la longueur du message d'erreur.
bool SCS_GetErrorMessage()
Description
Renvoie le dernier message d'erreur. Si vous implémentez getErrorMessage(), Dreamweaver l'appelle à chaque fois
qu'une de vos fonctions d'API renvoie false.
Si une routine renvoie -1 ou false, cela indique qu'un message d'erreur doit être disponible.
Arguments
void *connectionData, char errorMsg[], const int *msgLength
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• errorMsg est une chaîne pré-allouée de la DLL dans laquelle vient se placer le message d'erreur.
• msgLength est la longueur de la mémoire tampon représentée par l'argument errorMsg[].
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
int SCS_GetNoteCount()
Description
Renvoie le nombre de clés Design Note pour le chemin de dossier ou de fichier distant spécifié. Si cela n'est pas pris en
charge par le système de commande source, Dreamweaver obtient ces informations du fichier compagnon MNO.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 104
API d'intégration de commande source
• remotePath est le nom du chemin d'accès au fichier ou dossier distant dont la DLL vérifie le nombre de Design
Notes jointes.
Valeurs renvoyées
Nombre entier qui indique le nombre de Design Notes associées au fichier. Si la fonction renvoie < 0, Dreamweaver
considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est prise en charge.
int SCS_GetMaxNoteLength()
Description
Renvoie la longueur de la Design Note la plus longue pour le fichier ou le dossier spécifié. Si cette fonction n'est pas
prise en charge par le système de commande source, Dreamweaver obtient ces informations du fichier MNO.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le nom du chemin d'accès au fichier ou dossier distant dont la DLL vérifie la Design Note la plus
longue.
Valeurs renvoyées
Nombre entier qui indique la taille de la Design Note la plus longue associée au fichier. Si la fonction renvoie < 0,
Dreamweaver considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est
prise en charge.
bool SCS_GetDesignNotes()
Description
Récupère des paires clé-valeur des méta-informations pour le fichier ou le dossier spécifié. Si cette fonction n'est pas
prise en charge par le système de commande source, Dreamweaver récupère ces informations depuis fichier MNO.
Arguments
void *connectionData, const char *remotePath, char keyList[][64], char *valueList[], bool showColumnList[], const int
noteCount, const int noteLength
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le nom du chemin d'accès au fichier ou dossier distant dont la DLL vérifie le nombre d'éléments.
• L'argument keyList est une liste de clés de Design Note, comme "Status".
• valueList est une liste de valeurs de Design Note correspondant aux clés de Design Note, comme "Awaiting
Signoff".
• L'argument showColumnList est une liste de valeurs booléennes correspondant aux clés de Design Note, qui
indiquent si Dreamweaver peut afficher une clé sous forme de colonne dans le panneau Site.
• L'argument noteCount correspond au nombre de Design Notes jointes à un fichier ou dossier ; cette valeur est
renvoyée par la fonction GetNoteCount().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 105
API d'intégration de commande source
• L'argument noteLength est la longueur maximale d'une Design Note ; cette valeur est renvoyée par la fonction
GetMaxNoteLength().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_SetDesignNotes()
Description
Enregistre les paires clé-valeur dans les méta-informations du fichier ou du dossier spécifié. Cela remplace le jeu de
méta-informations du fichier. Si cette fonction n'est pas prise en charge par le système de commande source,
Dreamweaver enregistre les Design Notes dans des fichiers MNO.
Arguments
void *connectionData, const char *remotePath, const char keyList[][64], const char *valueList[], bool showColumnList[],
const int noteCount, const int noteLength
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est le nom du chemin d'accès au fichier ou dossier distant dont la DLL vérifie le nombre d'éléments.
• L'argument keyList est une liste de clés de Design Note, comme "Status".
• valueList est une liste de valeurs de Design Note correspondant aux clés de Design Note, comme "Awaiting
Signoff".
• L'argument showColumnList est une liste de valeurs booléennes correspondant aux clés de Design Note, qui
indiquent si Dreamweaver peut afficher une clé sous forme de colonne dans le panneau Site.
• L'argument noteCount correspond au nombre de Design Notes jointes à un fichier ou dossier ; ce nombre permet
à la DLL de connaître la taille des listes spécifiées. Si noteCount a pour valeur 0, toutes les Design Notes sont
supprimées du fichier.
• L'argument noteLength est la longueur de la Design Note la plus longue pour le fichier ou le dossier spécifié.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_IsRemoteNewer()
Description
Vérifie chaque chemin distant spécifié pour voir si la copie distante est plus récente. Si cette fonction n'est pas prise en
charge par le système de commande source, Dreamweaver utilise son algorithme interne isRemoteNewer.
Arguments
void *connectionData, const char *remotePathList[], constchar*localPathList[], int remoteIsNewerList[], const int
numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 106
API d'intégration de commande source
• remotePathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers à comparer pour connaître ceux
dotés des états les plus récents.
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux.
• remoteIsNewerList est une liste de nombres entiers complétée par la DLL pour permettre à Dreamweaver
d'identifier le fichier le plus récent du côté distant. Les valeurs suivantes sont admises : 1 indique que la version
distante est la plus récente ; -1 indique que la version locale est la plus récente ; 0 indique que les deux versions sont
identiques.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Activateurs
Si les activateurs facultatifs ne sont pas pris en charge par le système de commande source ou que l'application n'est
pas connectée au serveur, Dreamweaver détermine le moment où les éléments de menu sont activés, en fonction des
informations dont il dispose concernant les fichiers distants.
bool SCS_canConnect()
Description
Indique si l'élément de menu Connecter doit être activé.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_canGet()
Description
Indique si l'élément de menu Acquérir doit être activé.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePathList est une liste de noms de chemin d'accès aux fichiers et aux dossier distant à obtenir.
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux.
• L'argument numItems est le nombre d'éléments dans chaque liste.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 107
API d'intégration de commande source
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_canCheckout()
Description
Indique si l'élément de menu Extraire doit être activé.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument remotePathList est une liste de noms de chemin d'accès aux fichiers et aux dossiers distant à extraire.
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_canPut()
Description
Indique si l'élément de menu Placer doit être activé.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• localPathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers à placer dans le système de
commande source.
• remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers à placer dans le système
de commande source.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_canCheckin()
Description
Indique si l'élément de menu Archiver doit être activé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 108
API d'intégration de commande source
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument localPathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers locaux à archiver.
• L'argument remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers distants.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_CanUndoCheckout()
Description
Indique si l'élément de menu Annuler l'extraction doit être activé.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument remotePathList est une liste de noms de chemin d'accès aux fichiers et aux dossiers distant à extraire.
• localPathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers locaux à placer dans le système
de commande source.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_canNewFolder()
Description
Indique si l'élément de menu Nouveau dossier doit être activé.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePath est une liste de noms de chemin d'accès aux fichiers ou aux dossiers distants que l'utilisateur a
sélectionné pour indiquer l'emplacement de création du nouveau dossier.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 109
API d'intégration de commande source
bool SCS_canDelete()
Description
Indique si l'élément de menu Supprimer doit être activé.
Arguments
void *connectionData, const char *remotePathList[], const int numItems
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• L'argument remotePathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers distants à
supprimer.
• L'argument numItems est le nombre d'éléments dans chaque liste.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_canRename()
Description
Indique si l'élément de menu Renommer doit être activé.
Arguments
void *connectionData, const char *remotePath
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
• remotePathList est une liste des noms de chemin d'accès aux fichiers ou aux dossiers distants qui peuvent être
renommés.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
bool SCS_BeforeGet()
Description
Dreamweaver appelle cette fonction avant d'acquérir ou d'extraire un ou plusieurs fichiers. Cette fonction permet à la
DLL d'effectuer une opération sur un groupe de fichiers, telle que l'ajout d'un commentaire d'extraction.
Arguments
*connectionData
• L'argument *connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 110
API d'intégration de commande source
Exemple
Pour acquérir un groupe de fichiers, Dreamweaver effectue des appels vers la DLL dans l'ordre suivant :
SCS_BeforeGet(connectionData);
SCS_Get(connectionData,remotePathList1,localPathList1,successList1);
SCS_Get(connectionData,remotePathList2,localPathList2,successList2);
SCS_Get(connectionData,remotePathList3,localPathList3,successList3);
SCS_AfterGet(connectionData);
bool SCS_BeforePut()
Description
Dreamweaver appelle cette fonction avant de placer ou d'archiver un ou plusieurs fichiers. Cette fonction permet à la
DLL d'effectuer une opération sur un groupe de fichiers, telle que l'ajout d'un commentaire d'archivage.
Arguments
*connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Exemple
Pour acquérir un groupe de fichiers, Dreamweaver effectue des appels vers la DLL dans l'ordre suivant :
SCS_BeforePut(connectionData);
SCS_Put(connectionData,localPathList1,remotePathList1,successList1);
SCS_Put(connectionData,localPathList2,remotePathList2,successList2);
SCS_Put(connectionData,localPathList3,remotePathList3,successList3);
SCS_AfterPut(connectionData);
bool SCS_AfterGet()
Description
Dreamweaver appelle cette fonction après avoir acquis ou extrait un ou plusieurs fichiers. Cette fonction permet à la
DLL d'effectuer n'importe quelle opération après l'acquisition ou l'extraction d'un lot, telle que la création d'une boîte
de dialogue de résumé.
Arguments
*connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 111
API d'intégration de commande source
Exemple
Voir « bool SCS_BeforeGet() » à la page 109.
bool SCS_AfterPut()
Description
Dreamweaver appelle cette fonction après avoir placé ou archivé un ou plusieurs fichiers. Cette fonction permet à la
DLL d'effectuer n'importe quelle opération après le placement ou l'archivage d'un lot, telle que la création d'une boîte
de dialogue de résumé.
Arguments
*connectionData
• L'argument connectionData est un pointeur vers les données de l'agent transférées à Dreamweaver pendant l'appel
de la fonction Connect().
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Exemple
Voir « bool SCS_BeforePut() » à la page 110.
112
Chapitre 11 : Application
Les fonctions relatives aux applications effectuent des opérations ayant trait à la façon dont Adobe® Dreamweaver®
interagit avec d'autres applications ou des tâches Dreamweaver indépendantes des documents individuels (définition
des préférences ou fermeture de Dreamweaver, par exemple).
Fonctions relatives aux applications externes
Ces fonctions permettent d'effectuer des opérations relatives aux applications, telles que Adobe® Flash®, aux
navigateurs et aux éditeurs externes, définis respectivement dans les catégories Aperçu dans le navigateur et Editeurs
externes des Préférences. Elles permettent d'obtenir des informations sur les applications externes et d'ouvrir des
fichiers dans ces applications.
dreamweaver.browseDocument()
Disponibilité
Dreamweaver 2, améliorée dans les versions 3 et 4.
Description
Ouvre l'URL spécifiée dans le navigateur spécifié.
Arguments
fileName, {browser}
• L'argument fileName correspond au nom du fichier à ouvrir, exprimé sous la forme d'une absolue.
• L'argument browser définit un navigateur. Cet argument peut être le nom d'un navigateur tel qu'il est défini dans
la catégorie Aperçu dans le navigateur des Préférences ou être primary ou secondary. Si l'argument est omis,
l'URL est ouverte dans le navigateur principal de l'utilisateur.
Remarque : Certains navigateurs ne sont pas en mesure de trouver un fichier dont l'URL contient une ancre («
Configuration/ExtensionHelp/browseHelp.htm#helpyou », par exemple).
Valeurs renvoyées
Aucune.
Exemple
La fonction suivante utilise la fonction dreamweaver.browseDocument() pour ouvrir la page d'accueil Adobe dans
un navigateur :
function goToadobe(){
dreamweaver.browseDocument('http://www.adobe.com/');
}
Dans Dreamweaver 4, vous pouvez faire en sorte que cette opération ouvre le document dans Microsoft Internet
Explorer à l'aide du code suivant :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 113
Application
function goToadobe(){
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.adobe.com/',theBrowser);
}
Pour plus d'informations sur la fonction dreamweaver.getBrowserList(), consultez la section
« dreamweaver.getBrowserList() » à la page 113.
dreamweaver.getBrowserList()
Disponibilité
Dreamweaver 3.
Description
Obtient la liste des navigateurs définis dans le sous-menu Fichier > Aperçu dans le navigateur.
Arguments
Aucun.
Valeurs renvoyées
Tableau contenant autant de paires de chaînes que de navigateurs définis. La première chaîne de la paire représente le
nom du navigateur et la seconde son emplacement sur l'ordinateur de l'utilisateur, exprimé sous la forme d'une URL
de type file://. Si aucun navigateur n'est défini, la fonction ne renvoie rien.
dreamweaver.getExtensionEditorList()
Disponibilité
Dreamweaver 3
Description
Obtient la liste des éditeurs définis dans la catégorie Editeurs externes des préférences pour le fichier spécifié.
Arguments
fileURL
• L'argument fileURL peut être une URL complète de type file://, un nom de fichier ou une extension de fichier (point
compris).
Valeurs renvoyées
Tableau contenant autant de paires de chaînes que d'éditeurs définis. La première chaîne de la paire représente le nom
de l'éditeur et la seconde son emplacement sur l'ordinateur de l'utilisateur, exprimé sous la forme d'une URL de type
file://. Si aucun éditeur n'est défini dans les préférences, la fonction renvoie un tableau contenant une chaîne vide.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 114
Application
Exemple
Un appel à la fonction dreamweaver.getExtensionEditorList(".gif") pourrait renvoyer un tableau contenant
les chaînes suivantes :
•
"Fireworks 3"
•
"file:///C|/Program Files/Adobe/Fireworks 3/Fireworks 3.exe"
dreamweaver.getExternalTextEditor()
Disponibilité
Dreamweaver 4.
Description
Obtient le nom de l'éditeur de texte externe actuellement configuré.
Arguments
Aucun.
Valeurs renvoyées
Une chaîne contenant le nom de l'éditeur de texte approprié pour l'interface utilisateur et non le chemin entier.
dreamweaver.getFlashPath()
Disponibilité
Dreamweaver MX.
Description
Obtient le chemin d'accès complet de l'application FlashMX sous la forme d'une URL de fichier.
Arguments
Aucun.
Valeurs renvoyées
Tableau contenant deux éléments. Elément [0] est une chaîne contenant le nom de l'éditeur FlashMX. Elément [1] est
une chaîne contenant le chemin de l'application Flash sur l'ordinateur local, exprimé sous la forme d'une URL de type
file://. Si Flash n'est pas installé, la fonction ne renvoie rien.
Exemple
L'exemple suivant appelle la fonction dw.getFlashPath() pour obtenir le chemin d'accès à l'application Flash et
transmettre ce dernier sous la forme d'une URL de type file:// à la fonction dw.openWithApp() afin d'ouvrir le
document avec Flash :
var myDoc = dreamweaver.getDocumentDOM();
if (dreamweaver.validateFlash()) {
var flashArray = dreamweaver.getFlashPath();
dreamweaver.openWithApp(myDoc.myForm.swfFilePath, flashArray[1]);
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 115
Application
dreamweaver.getPrimaryBrowser()
Disponibilité
Dreamweaver 3.
Description
Obtient le chemin du navigateur principal.
Arguments
Aucun.
Valeurs renvoyées
Une chaîne contenant le chemin d'accès au navigateur principal sur l'ordinateur de l'utilisateur, exprimé sous la forme
d'une URL de type file://, ou rien, si aucun navigateur principal n'est défini.
dreamweaver.getPrimaryExtensionEditor()
Disponibilité
Dreamweaver 3.
Description
Obtient l'éditeur principal associé au fichier spécifié.
Arguments
fileURL
• L'argument fileURL correspond au chemin d'accès au fichier à ouvrir, exprimé sous la forme d'une URL de type
file://.
Valeurs renvoyées
Tableau contenant une paire de chaînes. La première chaîne de la paire représente le nom de l'éditeur et la seconde son
emplacement sur l'ordinateur de l'utilisateur, exprimé sous la forme d'une URL de type file://. Si aucun éditeur
principal n'est défini, la fonction renvoie un tableau contenant une chaîne vide.
dreamweaver.getSecondaryBrowser()
Disponibilité
Dreamweaver 3.
Description
Obtient le chemin du navigateur secondaire.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 116
Application
Valeurs renvoyées
Une chaîne contenant le chemin d'accès au navigateur secondaire sur l'ordinateur de l'utilisateur, exprimé sous la
forme d'une URL de type file://, ou rien, si aucun navigateur secondaire n'est défini.
dreamweaver.openHelpURL()
Disponibilité
Dreamweaver MX.
Description
Ouvre le fichier d'aide spécifié dans le visualisateur d'aide du système d'exploitation.
Dreamweaver affiche le contenu de l'aide dans le visualisateur d'aide standard du système d'exploitation plutôt que
dans un navigateur. L'aide est au format HTML, mais elle peut être lue par HTML Help sous Windows ou Help Viewer
sur MacOs X.
L'aide complète est contenue dans les quatre types de fichiers suivants. Pour plus d'informations sur les fichiers d'aide,
consultez la documentation de votre système d'exploitation.
• Manuel d'aide
Le manuel d'aide se compose de fichiers d'aide HTML, d'images et d'index. Sous Windows, le manuel d'aide est un
fichier portant l'extension .chm. Sur Macintosh, le manuel d'aide est undossier.
Les fichiers du manuel d'aide se trouvent dans le dossier d'aide de Dreamweaver.
• Fichier help.xml
Le fichier help.xml établit des correspondances entre les ID et le nom des manuels d'aide. Par exemple, le code XML
ci-dessous établit une correspondance entre l'ID du manuel d'aide de Dreamweaver et le nom des fichiers contenant
cette aide, sous Windows comme sur Macintosh :
<?xml version = "1.0" ?> <help-books><book-id id="DW_Using" winmapping="UsingDreamweaver.chm" mac-mapping="Dreamweaver Help"/> </help-books>
Chaque entrée book-id comporte les attributs suivants :
• L'attribut id correspond à l'ID de manuel utilisé dans les fichiers help.map et HelpDoc.js.
• L'attribut win-mapping correspond au nom du manuel Windows, "UsingDreamweaver.chm" dans cet
exemple.
• L'attribut mac-mapping correspond au nom du manuel Macintosh, soit "Dreamweaver
Help" dans cet
exemple.
• Fichier help.map
Le fichier help.map établit une correspondance entre un ID de contenu de l'aide et un manuel d'aide spécifique.
Dreamweaver utilise le fichier help.map pour rechercher un contenu d'aide spécifique lorsqu'il appelle l'aide
directement.
• Fichier helpDoc.js
Le fichier helpDoc.js vous permet d'établir une correspondance entre des noms de variables que vous pouvez
utiliser à la place de l'ID du manuel et de la chaîne de page. Le fichier helpDoc.js établit une correspondance entre
un ID de contenu et une page HTML dans un manuel d'aide spécifique. Dreamweaver utilise le fichier helpDoc.js
lorsqu'il appelle l'aide à partir de JavaScript.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 117
Application
Arguments
bookID.
• L'argument obligatoire bookID se présente au format suivant : ID:page
L'attribut ID correspond à l'ID de manuel bookID de l'entrée figurant dans le fichier help.xml qui indique le fichier
renfermant l'aide à afficher. L'attribut page de l'entrée identifie la page à afficher. Les pages sont référencées dans
le fichier help.map.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite et false si Dreamweaver ne peut pas ouvrir le fichier spécifié dans le
visualisateur d'aide.
Exemple
openHelpURL("DW_Using:index.htm");
dreamweaver.openWithApp()
Disponibilité
Dreamweaver 3.
Description
Ouvre le fichier spécifié dans l'application spécifiée.
Arguments
fileURL, appURL
• L'argument fileURL correspond au chemin d'accès au fichier à ouvrir, exprimé sous la forme d'une URL de type
file://.
• L'argument appURL correspond au chemin d'accès à l'application dans laquelle ouvrir le fichier, exprimé sous
forme d'une URL de type file://.
Valeurs renvoyées
Aucune.
dreamweaver.openWithBrowseDialog()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Sélectionner un éditeur externe pour permettre à l'utilisateur de sélectionner l'application
dans laquelle ouvrir le fichier spécifié.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 118
Application
Arguments
fileURL
• L'argument fileURL correspond au chemin d'accès au fichier à ouvrir, exprimé sous la forme d'une URL de type
file://.
Valeurs renvoyées
Aucune.
dreamweaver.openWithExternalTextEditor()
Disponibilité
Dreamweaver 3.
Description
Ouvre le document actif dans l'éditeur de texte externe défini dans la section Editeurs externes de la boîte de dialogue
Préférences.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.openWithImageEditor()
Disponibilité
Dreamweaver 3.
Description
Ouvre le fichier nommé dans l'éditeur d'image spécifié.
Remarque : Cette fonction lance un mécanisme spécial d'intégration Adobe Fireworks qui renvoie les informations au
document actif lorsque Fireworks est spécifié comme éditeur d'image. Pour éviter les erreurs lorsqu'aucun document n'est
actif, n'appelez jamais cette fonction à partir du panneau Site.
Arguments
fileURL, appURL
• L'argument fileURL correspond au chemin d'accès au fichier à ouvrir, exprimé sous la forme d'une URL de type
file://.
• L'argument appURL correspond au chemin d'accès à l'application dans laquelle ouvrir le fichier, exprimé sous
forme d'une URL de type file://.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 119
Application
dreamweaver.validateFlash()
Disponibilité
Dreamweaver MX.
Description
Détermine si FlashMX (ou une version ultérieure) est installé sur l'ordinateur local.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si Flash MX (ou une version ultérieure) est installé sur l'ordinateur et false s'il ne l'est pas.
dom.insertFiles()
Disponibilité
Dreamweaver CS3.
Description
Insère un ou plusieurs fichiers dans le document actuel au point d'insertion en cours ou à la place de la sélection
actuelle, et invite l'utilisateur à définir des paramètres si nécessaire.
Arguments:
strFiles
• L'argument strFiles est une chaîne qui spécifie les chemins et les noms des fichiers à insérer. Plusieurs noms de
fichiers peuvent être transmis à cette fonction.
Valeurs renvoyées
Aucune
dreamweaver.activateApp()
Disponibilité
Dreamweaver CS3.
Description
Fait passer l'application spécifiée au premier plan.
Arguments:
applicationID
• applicationID est une chaîne qui indique quelle application activer, par exemple, dreamweaver.
Valeurs renvoyées
Aucune
RÉFÉRENCE DES API DE DREAMWEAVER CS4 120
Application
dreamweaver.printDocument()
Disponibilité
Dreamweaver CS3.
Description
Exécute l'équivalent de la commande Fichier > Imprimer le code de Dreamweaver sur le fichier requis.
Arguments:
fileName
• L'argument fileName est une chaîne qui contient le nom du fichier à imprimer, exprimé sous la forme d'une URL.
Valeurs renvoyées
Aucune
dreamweaver.revealDocument()
Disponibilité
Dreamweaver CS3.
Description
Rend Dreamweaver actif pour le système d'exploitation et, si le fichier spécifié est ouvert dans Dreamweaver, affiche
Dreamweaver au premier plan.
Arguments:
fileName
• fileName est une chaîne qui contient le nom du fichier à afficher, exprimé sous la forme d'une URL.
Valeurs renvoyées
Aucune
Fonctions globales relatives aux applications
Ces fonctions agissent sur l'ensemble d'une application. Elles permettent d'effectuer des tâches comme quitter une
application ou accéder aux préférences.
dreamweaver.beep()
Disponibilité
Dreamweaver MX.
Description
Crée un bip système.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 121
Application
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant appelle la fonction dw.beep() pour attirer l'attention de l'utilisateur sur un message affiché par la
fonction alert() :
beep(){
if(confirm("Is your order complete?")
{
dreamweaver.beep();
alert("Click OK to submit your order");
}
}
dreamweaver.getShowDialogsOnInsert()
Disponibilité
Dreamweaver 3.
Description
Vérifie si l'option Afficher la boîte de dialogue lors de l'insertion d'objets est activée dans la catégorie Général des
préférences.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne qui indique si cette option est activée.
dreamweaver.quitApplication()
Disponibilité
Dreamweaver 3.
Description
Quitte Dreamweaver lorsque l'exécution du script appelant cette fonction prend fin.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 122
Application
dreamweaver.showAboutBox()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue A propos de.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.showDynamicDataDialog()
Disponibilité
Dreamweaver UltraDev 1.
Description
Affiche la boîte de dialogue Données dynamiques ou Texte dynamique, puis attend que l'utilisateur ferme la boîte de
dialogue. Si l'utilisateur clique sur OK, la fonction showDynamicDataDialog() renvoie une chaîne à insérer dans le
document de l'utilisateur. Cette chaîne est renvoyée par la fonction API de la source des données, c'est-à-dire
generateDynamicDataRef(), et est transmise à la fonction API du format de données, formatDynamicDataRef().
La valeur renvoyée par formatDynamicDataRef() est la même que celle renvoyée par la fonction
showDynamicDataDialog().
Arguments
source, {title}.
• L'argument source est une chaîne contenant le code source qui représente l'objet de données dynamique. Il s'agit de
la même chaîne que celle renvoyée après un appel précédent de la même fonction. Cette fonction utilise le contenu
de l'argument source pour initialiser toutes les commandes de la boîte de dialogue afin qu'elles apparaissent
exactement telles qu'elles étaient au moment où l'utilisateur a cliqué sur OK pour créer cette chaîne.
Dreamweaver transmet cette chaîne à la fonction inspectDynamicDataRef() pour déterminer si la chaîne
correspond à l'un des nœuds de l'arborescence. Si la chaîne correspond à un nœud, celui-ci est sélectionné lorsque
la boîte de dialogue réapparaît. Vous pouvez également transmettre une chaîne vide qui n'initialise pas la boîte de
dialogue. Par exemple, aucune boîte de dialogue n'est initialisée lorsqu'elle est utilisée pour créer un nouvelélément.
• L'argument title, qui est facultatif, est une chaîne qui contient le texte à afficher dans la barre de titre de la boîte de
dialogue. S'il n'est pas défini, Dreamweaver affiche Données dynamiques dans la barre de titre.
Valeurs renvoyées
Chaîne qui représente l'objet de données dynamique, si l'utilisateur clique sur OK.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 123
Application
dreamweaver.showPasteSpecialDialog()
Disponibilité
Dreamweaver 8.
Description
Affiche la boîte de dialogue Collage spécial. Si l'utilisateur clique sur OK, la fonction showPasteSpecialDialog()
effectue le collage.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
dw.showPasteSpecialDialog();
dreamweaver.showPreferencesDialog()
Disponibilité
Dreamweaver 3. Ajout de l'argument strCategory dans Dreamweaver 8. Mis à jour dans CS4.
Description
La fonction ouvre la boîte de dialogue Préférences.
Arguments
{strCategory}
• L'argument facultatif strCategory doit être l'une des chaînes suivantes pour ouvrir la catégorie correspondante de
la boîte de dialogue Préférences : general, accessibility, "html colors" (pour la catégorie Coloration du
code), "html format" (pour la catégorie Format du code), "code hints", "html rewriting" (pour la catégorie
Correction du code), copyPaste , "css styles", "file compare", "external editors" (pour la catégorie
Types de fichiers/Editeurs), fonts, highlighting, "invisible elements", layers,"new document",
floaters (pour la catégorie Panneaux), browsers, (pour la catégorie Aperçu dans le navigateur), "site ftp"
(pour la catégorie Site), "status bar" et validator. Si Dreamweaver ne reconnaît pas dans l'argument un nom
de volet valide, la boîte de dialogue ouvre le dernier volet actif. Il en va de même si aucun argument n'est défini.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant ouvre la boîte de dialogue Préférences et sélectionne la catégorie Coloration du code :
dw.showPreferencesDialog("html colors");
RÉFÉRENCE DES API DE DREAMWEAVER CS4 124
Application
dreamweaver.showTagChooser()
Disponibilité
Dreamweaver MX.
Description
Active ou désactive l'affichage de la boîte de dialogue Sélecteur de balise afin que les utilisateurs insèrent des balises en
mode Code. La fonction affiche la boîte de dialogue Sélecteur de balise au-dessus de toutes les autres fenêtres
Dreamweaver. Si la boîte de dialogue n'est pas visible, la fonction l'ouvre, l'affiche au premier plan et en fait l'élément
actif. Si le sélecteur de balise est visible, la fonction masque la boîte de dialogue.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dw.registerIdleHandler()
Disponibilité
Dreamweaver CS3.
Description
Cette fonction enregistre une fonction JavaScript à appeler de façon périodique au cours du temps de traitement
inactif.
Arguments
id, idleFunction, interval
• L'argument id est une chaîne unique permettant d'identifier la tâche d'inactivité à enregistrer. Pour assurer que cet
argument soit unique, ajoutez à cet ID un préfixe correspondant à un identificateur unique. Par exemple, vous
voudrez peut-être qu'un bip sonore soit émis toutes les 5 secondes, mais pas appeler la tâche "beep", parce qu'il est
possible que quelqu'un d'autre ait créé une tâche portant le même nom. Un nom plus approprié serait par exemple
"acme_beep_task", un nom unique fournissant également un contexte.
• L'argument idleFunction est la fonction JavaScript à appeler au cours du temps de traitement inactif.
• L'argument interval est le nombre de secondes entre les appels de la fonction idleFunction, soumis à la
disponibilité du temps d'inactivité.
Valeurs renvoyées
Valeur booléenne indiquant si la tâche d'inactivité a été enregistrée correctement.
Exemple
L'exemple suivant entraîne l'émission par le système d'un bip sonore toutes les 5 secondes :
dw.registerIdleHandler("acme_beep_task", function() { dw.beep();}, 5);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 125
Application
dw.revokeIdleHandler()
Disponibilité
Dreamweaver CS3.
Description
Cette fonction supprime une tâche d'inactivité précédemment générée par la fonction registerIdleHandler.
L'objectif est de fournir un moyen de supprimer une tâche d'inactivité enregistrée précédemment. Si une tâche
d'inactivité est censée rester active jusqu'à ce que l'application soit fermée, il n'est pas nécessaire d'appeler cette
fonction. Si c'est le cas, la tâche d'inactivité est supprimée automatiquement avant la fermeture de l'application.
Arguments
id
• L'id est une chaîne unique permettant d'identifier la tâche d'inactivité enregistrée à supprimer. Il s'agit du même ID
qui a été utilisé initialement pour enregistrer la tâche.
Valeurs renvoyées
Valeur booléenne indiquant si la tâche d'inactivité a été supprimée correctement.
Exemple
L'exemple suivant supprime la tâche d'inactivité nommée "dw_beep_task" de la file d'attente des tâches d'inactivité :
dw.revokeIdleHandler("acme_beep_task");
Fonctions de communication avec Bridge
Les fonctions de communication avec Bridge permettent la communication entre Dreamweaver et l'application
Bridge. Cette communication permet notamment à l'utilisateur de rechercher facilement des fichiers dans Bridge à
partir de Dreamweaver.
BridgeTalk.bringToFront()
Disponibilité
Dreamweaver CS3.
Description
Fait de l'application spécifiée le processus de premier plan en appelant la fonction BridgeTalk::bringToFront().
Arguments
applicationID
• L'argument applicationID est une chaîne, par exemple, bridge ou dreamweaver, qui indique quelle application
activer.
Valeurs renvoyées
Aucune
RÉFÉRENCE DES API DE DREAMWEAVER CS4 126
Application
Exemple
Cet exemple illustre la façon dont Dreamweaver implémente la fonction browseInBridge(). Vous créez d'abord une
instance BridgeTalk, puis vous définissez les deux propriétés les plus importantes : target et body. <target> est
l'application cible. Dans le cas présent, il suffit de l'application Bridge. Son identificateur est bridge. <body> est le
message à envoyer. En règle générale, <body> est un script que l'application cible peut comprendre et exécuter après
l'avoir reçu. La fonction send() est appelée pour envoyer la propriété <body> à la propriété <target>.
if (!JSBridge.isRunning('bridge'))
{
var bt = new BridgeTalk;
var scriptSavePath = browsePath.replace(/['"\\]/g, "\$&");
var script = "app.document.thumbnail = new Thumbnail(decodeURI('" + scriptSavePath + "'));";
// Send the script to bridge and give it 10 sec to launch before assuming an error.
bt.target = "bridge";
bt.body = script;
result = bt.send(10);
}
if (result)
BridgeTalk.bringToFront('bridge');
Bridgetalk.send()
Disponibilité
Dreamweaver CS3.
Description
Etablit la communication avec l'application Bridge.
Arguments:
timeout
• L'argument timeout est un attribut qui définit l'intervalle de délai d'attente, en secondes.
Valeurs renvoyées
Une valeur booléenne indiquant si la communication avec l'application Bridge a réussi (True = réussi, False =
échoué).
Exemple
result = bridgeTalk.send(10);
BridgeTalk.suppressStartupScreen()
Disponibilité
Dreamweaver CS3.
Description
Recherche -nostartupscreen dans les options de lancement afin de déterminer si la fenêtre modale doit être
supprimée après le démarrage.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 127
Application
Valeurs renvoyées
Valeur booléenne indiquant si les écrans de démarrage doivent être supprimés.
dw.browseInBridge()
Disponibilité
Dreamweaver CS3.
Description
Vous permet de parcourir des fichiers dans Bridge à partir de Dreamweaver. La fonction dw.browseInBridge()
démarre l'application Bridge. Si Bridge est déjà en cours d'exécution, dw.browseInBridge bascule vers l'application
Bridge.
Arguments:
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si le script de navigation a été envoyé à l'application Bridge correctement (true = réussi,
false = échoué).
128
Chapitre 12 : Espace de travail
Les fonctions de l'API de l'espace de travail créent des éléments dans l'espace de travail Adobe® Dreamweaver® ou
effectuent des actions dessus. Elles permettent d'effectuer les tâches suivantes :
• répétition d'étapes figurant dans le panneau Historique ;
• placement d'un objet dans la barre Insertion ;
• navigation à l'aide de fonctions de clavier ;
• rechargement de menus ;
• manipulation de fenêtres de résultats autonomes ou intégrées ;
• Définition d'options
• positionnement d'une barre d'outils ;
• obtention ou définition du focus.
Fonctions d'historique
Ces fonctions permettent d'annuler, de refaire, d'enregistrer et de lire toutes les étapes qui s'affichent dans le panneau
Historique. Par étape, on entend une modification apportée à un document (ou à une sélection dans le document)
pouvant être reproduite. Les méthodes de l'objet dreamweaver.historyPalette permettent de contrôler ou d'agir
sur la sélection dans le panneau Historique et non dans le document actif.
dom.redo()
Disponibilité
Dreamweaver 3.
Description
Répète l'étape qui vient juste d'être annulée dans le document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canRedo() » à la page 470.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 129
Espace de travail
dom.undo()
Disponibilité
Dreamweaver 3.
Description
Annule l'étape qui vient d'être exécutée dans le document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canUndo() » à la page 473.
dreamweaver.getRedoText()
Disponibilité
Dreamweaver 3.
Description
Obtient le texte associé à l'opération de modification à répéter si l'utilisateur choisit Edition > Répéter ou s'il appuie
sur Ctrl+Y (Windows) ou sur Commande+Y (Macintosh).
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant le texte associé à l'opération de modification à répéter.
Exemple
Si la dernière action de l'utilisateur a consisté à mettre le texte sélectionné en gras, un appel à la fonction
dreamweaver.getRedoText() renvoie "Repeat Apply Bold".
dreamweaver.getUndoText()
Disponibilité
Dreamweaver 3.
Description
Obtient le texte associé à l'opération de modification à annuler si l'utilisateur choisit Edition > Annuler ou s'il appuie
sur Ctrl+Z (Windows) ou sur Commande+Z (Macintosh).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 130
Espace de travail
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant le texte associé à l'opération de modification à annuler.
Exemple
Si la dernière action de l'utilisateur a consisté à appliquer un style CSS (cascading style sheet) à un texte sélectionné,
un appel à la fonction dreamweaver.getUndoText() renvoie "Undo Apply <span>".
dreamweaver.playRecordedCommand()
Disponibilité
Dreamweaver 3.
Description
Exécute la commande mémorisée dans le document actif.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canPlayRecordedCommand() » à la page 477.
dreamweaver.redo()
Disponibilité
Dreamweaver 3.
Description
Répète l'étape qui vient juste d'être annulée dans la fenêtre de document, la boîte de dialogue, le panneau flottant ou le
panneau Site en cours.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canRedo() » à la page 478.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 131
Espace de travail
dreamweaver.startRecording()
Disponibilité
Dreamweaver 3.
Description
Démarre la mémorisation des étapes dans le document actif ; la commande précédemment mémorisée est
immédiatement éliminée.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.isRecording() » à la page 485 (doit retourner une valeur false).
dreamweaver.stopRecording()
Disponibilité
Dreamweaver 3.
Description
Arrête la mémorisation sans intervention de l'utilisateur.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.isRecording() » à la page 485 (doit retourner une valeur true).
dreamweaver.undo()
Disponibilité
Dreamweaver 3.
Description
Annule l'étape précédente dans la fenêtre de document, la boîte de dialogue, le panneau flottant ou le panneau Site
actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 132
Espace de travail
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canUndo() » à la page 473.
dreamweaver.historyPalette.clearSteps()
Disponibilité
Dreamweaver 3.
Description
Efface toutes les étapes du panneau Historique et désactive les éléments de menu Annuler et Rétablir.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.historyPalette.copySteps()
Disponibilité
Dreamweaver 3.
Description
Copie les étapes spécifiées de l'historique dans le Presse-papiers. Dreamweaver prévient l'utilisateur de la possibilité de
conséquences inattendues au cas où les étapes spécifiées contiendraient une action impossible à reproduire.
Arguments
arrayOfIndices
• L'argument arrayOfIndices est un tableau d'index de position dans le panneau Historique.
Valeurs renvoyées
Chaîne qui contient le code JavaScript correspondant aux étapes spécifiées de l'historique.
Exemple
L'exemple suivant copie les quatre premières étapes dans le panneau Historique :
dreamweaver.historyPalette.copySteps([0,1,2,3]);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 133
Espace de travail
dreamweaver.historyPalette.getSelectedSteps()
Disponibilité
Dreamweaver 3.
Description
Détermine quelle section du panneau Historique est sélectionnée.
Arguments
Aucun.
Valeurs renvoyées
Tableau qui contient les index de position de toutes les étapes sélectionnées. La première position est la position0
(zéro).
Exemple
Si la deuxième, la troisième et la quatrième étapes sont sélectionnées dans le panneau Historique, comme le montre la
figure ci-après, un appel à la fonction dreamweaver.historyPalette.getSelectedSteps() renvoie [1,2,3] :
dreamweaver.historyPalette.getStepCount()
Disponibilité
Dreamweaver 3.
Description
Obtient le nombre d'étapes figurant dans le panneau Historique.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 134
Espace de travail
Arguments
Aucun.
Valeurs renvoyées
Nombre entier qui représente le nombre d'étapes répertoriées actuellement dans le panneau Historique.
dreamweaver.historyPalette.getStepsAsJavaScript()
Disponibilité
Dreamweaver 3.
Description
Obtient l'équivalent JavaScript des étapes sélectionnées.
Arguments
arrayOfIndices
• L'argument arrayOfIndices est un tableau d'index de position dans le panneau Historique.
Valeurs renvoyées
Chaîne qui contient le code JavaScript correspondant aux étapes spécifiées de l'historique.
Exemple
Si les trois étapes indiquées dans l'illustration ci-après sont sélectionnées dans le panneau Historique, un appel à la
fonction dreamweaver.historyPalette.getStepsAsJavaScript(dw.historyPalette.getSelectedSteps())
renvoie "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" :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 135
Espace de travail
dreamweaver.historyPalette.getUndoState()
Disponibilité
Dreamweaver 3.
Description
Obtient l'état d'annulation en cours.
Arguments
Aucun.
Valeurs renvoyées
La position du marqueur d'annulation dans le panneau Historique.
dreamweaver.historyPalette.replaySteps()
Disponibilité
Dreamweaver 3.
Description
Réexécute les étapes spécifiées de l'historique dans le document actif. Dreamweaver prévient l'utilisateur de la
possibilité de conséquences inattendues dans le cas où les étapes spécifiées contiendraient une action qui ne peut pas
être reproduite.
Arguments
arrayOfIndices
• L'argument arrayOfIndices est un tableau d'index de position dans le panneau Historique.
Valeurs renvoyées
Chaîne qui contient le code JavaScript correspondant aux étapes spécifiées de l'historique.
Exemple
Un appel à la fonction dreamweaver.historyPalette.replaySteps([0,2,3]) réexécute la première, la troisième
et la quatrième étapes dans le panneau Historique.
dreamweaver.historyPalette.saveAsCommand()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Enregistrer comme commande et permet à l'utilisateur d'enregistrer les étapes spécifiées
sous forme de commande. Dreamweaver prévient l'utilisateur de la possibilité de conséquences inattendues dans le cas
où les étapes spécifiées contiendraient une action qui ne peut pas être reproduite.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 136
Espace de travail
Arguments
arrayOfIndices
• L'argument arrayOfIndices est un tableau d'index de position dans le panneau Historique.
Valeurs renvoyées
Chaîne qui contient le code JavaScript correspondant aux étapes spécifiées de l'historique.
Exemple
L'exemple suivant enregistre la quatrième, la sixième et la huitième étapes du panneau Historique comme une
commande :
dreamweaver.historyPalette.saveAsCommand([3,5,7]);
dreamweaver.historyPalette.setSelectedSteps()
Disponibilité
Dreamweaver 3.
Description
Sélectionne les étapes spécifiées dans le panneau Historique.
Arguments
arrayOfIndices
• La fonction arrayOfIndices est un tableau d'index de position dans le panneau Historique. Si aucun argument n'est
défini, aucune étape n'est sélectionnée.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant sélectionne la première, la deuxième et la troisième étapes dans le panneau Historique :
dreamweaver.historyPalette.setSelectedSteps([0,1,2]);
dreamweaver.historyPalette.setUndoState()
Disponibilité
Dreamweaver 3.
Description
Effectue le nombre d'annulations et de répétitions nécessaires pour arriver à l'état d'annulation spécifié.
Arguments
undoState
• L'argument undoState correspond à l'objet renvoyé par la fonction
dreamweaver.historyPalette.getUndoState().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 137
Espace de travail
Valeurs renvoyées
Aucune.
Fonctions d'insertion d'objets
Les fonctions d'insertion d'objets permettent d'effectuer des tâches ayant trait aux objets de la barre Insertion ou du
menu Insertion.
dreamweaver.objectPalette.getMenuDefault()
Disponibilité
Dreamweaver MX 2004.
Description
Extrait la chaîne d'ID de l'élément par défaut pour le menu associé.
Arguments
menuId
• L'argument menuId correspond à la chaîne définissant le menu dans le fichier insertbar.xml.
Valeurs renvoyées
Valeur de la chaîne définissant l'ID de l'élément par défaut.
Exemple
L'exemple suivant attribue l'objet par défaut actif du menu Support à la variable defID :
var defId = dw.objectPalette.getMenuDefault("DW_Media");
dreamweaver.objectPalette.setMenuDefault()
Disponibilité
Dreamweaver MX 2004.
Description
Définit l'objet par défaut d'un menu déroulant. L'icône de l'objet par défaut représente le menu déroulant spécifié dans
la barre Insertion. L'utilisateur peut cliquer sur l'objet par défaut pour l'insérer ou cliquer sur la flèche figurant en
regard pour ouvrir le menu déroulant correspondant afin d'afficher les autres objets de ce menu. Dreamweaver
prendra en compte la nouvelle valeur par défaut la prochaine fois que l'utilisateur ouvrira Dreamweaver ou utilisera la
commande Recharger extensions.
Arguments
menuId, defaultId.
• L'argument menuId correspond à la chaîne définissant le menu dans le fichier insertbar.xml.
• L'argument defaultId correspond à la chaîne définissant le nouvel objet par défaut dans le champ insertbar.xml.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 138
Espace de travail
Valeurs renvoyées
Valeur booléenne : true si la configuration de la nouvelle valeur par défaut réussit et false dans le cas contraire.
Exemple
L'exemple suivant définit l'objet Flash en qualité d'objet par défaut pour le menu Support :
dw.objectPalette.setMenuDefault("DW_Media", "DW_Flash");
dreamweaver.reloadObjects()
Disponibilité
Dreamweaver MX 2004.
Description
Recharge tous les objets de la barre Insertion. Cette fonction revient à maintenir la touche Ctrl (Windows) ou Alt
(Macintosh) enfoncée tout en cliquant dans le menu des catégories de la barre Insertion et à sélectionner l'option de
menu Recharger extensions.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le chargement des objets a réussi et false dans le cas contraire.
dom.convertActiveContent()
Disponibilité
Dreamweaver CS3.
Description
Convertit tout le contenu actif du document donné.
Arguments
forceUpdate
• L'argument forceUpdate est une valeur booléenne qui indique si les paramètres de préférence de l'utilisateur
doivent être remplacés (true, = remplacer). Cet argument est facultatif.
Valeurs renvoyées
Une valeur booléenne true si l'ensemble du contenu actif a été converti correctement. Renvoie false si une partie du
contenu actif qui devait être converti ne l'a pas été, par exemple, des balises d'objet se trouvant dans une région
verrouillée d'une instance de modèle.
Exemple
if( !dom.convertActiveContent(true) ) {
alert(dw.loadString("ActiveContent/notAllConverted"));
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 139
Espace de travail
dom.convertNextActiveContent()
Disponibilité
Dreamweaver CS3.
Description
Indique qu'un script sera créé pour la prochaine balise d'objet qui sera insérée (pour le reste de l'action de modification
en cours, action qui n'est pas annulable). Cette fonction vous permet d'utiliser une extension de tiers pour générer le
script approprié pour le contenu actif spécifique.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
dom.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>\");
Fonctions relatives au clavier
Les fonctions relatives au clavier émulent les opérations de déplacement au sein d'un document effectuées à l'aide des
touches de direction RET.ARR, SUPPR., PG.PREC et PG.SUIV. Parallèlement aux fonctions générales, telles que
arrowLeft() (équivalent à la touche de direction GAUCHE) et backspaceKey() (équivalent à la touche RET.ARR),
Dreamweaver propose également des méthodes permettant d'accéder soit au mot ou paragraphe suivant ou précédent,
soit au début ou à la fin d'une ligne ou d'un document.
dom.arrowDown()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion vers le bas du nombre de lignes spécifié.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument nTimes correspond au nombre de fois où le point d'insertion doit se déplacer vers le bas. Si cet
argument n'est pas défini, il prend par défaut la valeur 1.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 140
Espace de travail
• L'argument bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet argument n'est
pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.arrowLeft()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion vers la gauche du nombre de colonnes spécifié.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de fois où le point d'insertion doit se déplacer vers la gauche.
Si cet argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.arrowRight()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion vers la droite du nombre de colonnes spécifié.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de fois où le point d'insertion doit se déplacer vers la droite.
Si cet argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 141
Espace de travail
dom.arrowUp()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion vers le haut du nombre de lignes spécifié.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de fois où le point d'insertion doit se déplacer vers le haut. Si
cet argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.backspaceKey()
Disponibilité
Dreamweaver 3.
Description
Cette fonction revient à appuyer sur la touche RET.ARR un nombre de fois donné. Le résultat obtenu diffère selon qu'il
y ait une sélection en cours ou simplement un point d'insertion.
Arguments
{nTimes}
• Facultatif, l'argument nTimes correspond au nombre de fois qu'une opération de retour arrière doit avoir lieu. Si
l'argument n'est pas défini, il prend par défaut la valeur 1.
Valeurs renvoyées
Aucune.
dom.deleteKey()
Disponibilité
Dreamweaver 3.
Description
Cette fonction revient à appuyer sur la touche SUPPR. un nombre de fois donné. Le résultat obtenu diffère selon qu'il
y ait une sélection en cours ou simplement un point d'insertion.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 142
Espace de travail
Arguments
{nTimes}
• Facultatif, l'argument nTimes correspond au nombre de fois qu'une opération de suppression doit avoir lieu. Si
l'argument n'est pas défini, il prend par défaut la valeur 1.
Valeurs renvoyées
Aucune.
dom.endOfDocument()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion à la fin du document, dans la fenêtre active (selon le cas, après le dernier contenu visible
dans la fenêtre de document ou après la balise HTML de fermeture dans l'inspecteur de code).
Arguments
{bShiftIsDown}
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si l'argument
n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.endOfLine()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion à la fin de la ligne.
Arguments
{bShiftIsDown}
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si l'argument
n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 143
Espace de travail
dom.nextParagraph()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion au début du paragraphe suivant ou saute plusieurs paragraphes si l'argument nTimes est
supérieur à 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de paragraphes suivants que le point d'insertion doit sauter.
Si cet argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet argument n'est
pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.nextWord()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion au début du mot suivant ou saute plusieurs mots si l'argument nTimes est supérieur à 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de mots suivants que le point d'insertion doit sauter. Si cet
argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.pageDown()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion d'une page vers le bas (équivalent à la touche PG.SUIV).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 144
Espace de travail
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de pages suivantes que le point d'insertion doit sauter. Si cet
argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.pageUp()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion d'une page vers le haut (équivalent à la touche PG.PREC).
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de pages précédentes que le point d'insertion doit sauter. Si
cet argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.previousParagraph()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion au début du paragraphe précédent ou saute plusieurs paragraphes si l'argument nTimes
est supérieur à 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de paragraphes précédents que le point d'insertion doit sauter.
Si cet argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 145
Espace de travail
Valeurs renvoyées
Aucune.
dom.previousWord()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion au début du mot précédent ou saute plusieurs mots si l'argument nTimes est supérieur à 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l'argument nTimes correspond au nombre de mots précédents que le point d'insertion doit sauter. Si cet
argument n'est pas défini, il prend par défaut la valeur 1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.startOfDocument()
Disponibilité
Dreamweaver 3.
Description
Déplace le point d'insertion au début du document (selon le cas, avant le premier contenu visible dans la fenêtre de
document ou avant la balise HTML d'ouverture dans l'inspecteur de code).
Arguments
{bShiftIsDown}
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si l'argument
n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dom.startOfLine()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 146
Espace de travail
Description
Déplace le point d'insertion au début de la ligne.
Arguments
{bShiftIsDown}
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si l'argument
n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
dreamweaver.mapKeyCodeToChar()
Disponibilité
Dreamweaver 4.
Description
Convertit un code de touche tel qu'il est indiqué dans le champ keyCode de l'objet événement en caractère. Vous devez
vérifier si le code de touche est une touche spéciale, telle que les touches ORIG, PG. SUIV, etc. S'il ne s'agit pas d'une
touche spéciale, cette méthode peut être utilisée pour traduire le code en code de caractère affichable à l'utilisateur.
Arguments
keyCode.
• L'argument keyCode est le code de touche à traduire en caractère.
Valeurs renvoyées
Renvoie le code de caractère si la correspondance a réussi. Renvoie 0 dans le cas contraire.
Fonctions relatives aux menus
Ces fonctions permettent d'optimiser et de recharger les menus dans Dreamweaver. Les fonctions
dreamweaver.getMenuNeedsUpdating() et dreamweaver.notifyMenuUpdated() sont spécialement conçues pour
empêcher l'exécution de routines de mise à jour superflues sur les menus dynamiques intégrés à Dreamweaver. Pour
plus d'informations, voir « dreamweaver.getMenuNeedsUpdating() » à la page 146 et
« dreamweaver.notifyMenuUpdated() » à la page 147.
dreamweaver.getMenuNeedsUpdating()
Disponibilité
Dreamweaver 3.
Description
Vérifie si le menu spécifié doit être mis à jour.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 147
Espace de travail
Arguments
menuId
• L'argument menuId est une chaîne contenant la valeur de l'attribut id de l'élément de menu, tel qu'il est défini dans
le fichier menus.xml.
Valeurs renvoyées
Valeur booléenne qui indique si le menu doit être mis à jour. Cette fonction renvoie la valeur false uniquement si la
fonction dreamweaver.notifyMenuUpdated() a été appelée avec cet argument menuId et si la valeur renvoyée par
menuListFunction n'a pas changé. Pour plus d’informations, voir « dreamweaver.notifyMenuUpdated() » à la
page 147.
dreamweaver.notifyMenuUpdated()
Disponibilité
Dreamweaver 3.
Description
Prévient Dreamweaver lorsque le menu spécifié doit être mis à jour.
Arguments
menuId, menuListFunction.
• L'argument menuId est une chaîne contenant la valeur de l'attribut id de l'élément de menu, tel qu'il est défini dans
le fichier menus.xml.
• L'argument menuListFunction doit être l'une des chaînes suivantes : "dw.cssStylePalette.getStyles()",
"dw.getDocumentDOM().getFrameNames()", "dw.getDocumentDOM().getEditableRegionList",
"dw.getBrowserList()", "dw.getRecentFileList()", "dw.getTranslatorList()", "dw.getFontList()",
"dw.getDocumentList()", "dw.htmlStylePalette.getStyles()" ou "site.getSites()".
Valeurs renvoyées
Aucune.
dreamweaver.reloadMenus()
Disponibilité
Dreamweaver 3.
Description
Recharge la structure de menus à partir du fichier menus.xml du dossier Configuration.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 148
Espace de travail
Fonctions de la fenêtre de résultats
Les fonctions de la fenêtre de résultats vous permettent de dialoguer avec les panneaux intégrés du groupe de panneaux
Résultats ou de créer une fenêtre indépendante contenant des colonnes de données formatées.
Groupe de panneaux Résultats intégré
Ces fonctions produisent l'affichage dans le groupe de panneaux Résultats. Le groupe de panneaux Résultats présente
des panneaux à onglets sur les recherches, la validation de la source, les rapports au niveau du site, la vérification de
compatibilité avec les navigateurs, le débogage de serveur, les connexions FTP et les vérifications de liens.
Panneaux enfants spécifiques
Les panneaux enfants suivants sont des fenêtres de résultats intégrées qui existent toujours dans l'interface
Dreamweaver et auxquelles il est possible d'accéder directement.
•
dreamweaver.resultsPalette.siteReports
•
dreamweaver.resultsPalette.validator
•
dreamweaver.resultsPalette.bcc
Ces panneaux étant des fenêtres de résultats, vous pouvez utiliser les méthodes suivantes, définies pour les fenêtres de
résultats indépendantes :
•
getItem()
•
getItemCount()
•
getSelectedItem()
•
setSelectedItem()
Pour plus d'informations sur l'utilisation des méthodes resWin, voir « Fenêtre de résultats indépendante » à la
page 153.
Panneau enfant actif
Les fonctions API générales suivantes s'appliquent au panneau enfant actif. Certains panneaux enfants peuvent ignorer
certaines de ces fonctions. Si le panneau enfant actif ne prend pas la fonction en charge, l'appel n'a aucun effet.
dreamweaver.showResults()
Disponibilité
Dreamweaver MX 2004.
Description
Ouvre le panneau flottant de résultats spécifié et sélectionne l'élément.
Remarque : Cette fonction est uniquement prise en charge dans les fenêtres Validation, Vérification de compatibilité avec
les navigateurs et les panneaux Rapports du site du groupe de panneaux de résultats.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 149
Espace de travail
Arguments
floaterName, floaterIndex
• L'argument floaterName est une chaîne indiquant le panneau flottant de résultats à ouvrir. Les valeurs autorisées
sont 'validation' ou 'reports'.
• L'argument floaterIndex est un nombre ou une chaîne. Utilisez un nombre pour spécifier l'index d'un élément à
sélectionner dans le panneau de résultats. Utilisez une chaîne pour spécifier l'URL d'un document. Dans le cas d'une
URL, la fonction sélectionne le premier élément visible de ce document.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant vérifie la présence d'erreurs au début de la sélection en cours dans le document. Si des erreurs sont
détectées, elles sont affichées dans la fenêtre spécifiée (floaterName) du panneau de résultats. Dans le cas contraire,
il ouvre la fenêtre Vérification de compatibilité avec les navigateurs du panneau de résultats et affiche le premier
élément visible du document.
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);
dreamweaver.resultsPalette.siteReports.addResultItem()
Disponibilité
Dreamweaver 4.
Description
Ajoute une nouvelle entrée dans le panneau Rapports du site, en fonction des informations figurant dans le fichier
traité par la fonction processfile().
Cette fonction est uniquement disponible dans le rappel processFile() d'un rapport de site. Pour plus
d'informations sur les rapports de site, consultez la rubrique « Rapports » dans Extension de Dreamweaver.
Arguments
strFilePath, strIcon, strDisplay, strDesc, {iLineNo}, {iStartSel}, {iEndSel}
• L'argument strFilePath est le chemin d'accès complet à l'URL du fichier à traiter.
• L'argument strIcon est le chemin d'accès à l'icône à utiliser. Pour afficher une icône intégrée, utilisez une valeur
comprise entre 1 et 10 plutôt que le chemin d'accès complet à l'icône (utilisez la valeur 0 pour n'afficher aucune
icône). L'illustration ci-dessous indique les icônes correspondant aux chiffres allant de 1 à 10 :
• L'argument strDisplay est la chaîne à afficher à l'utilisateur dans la première colonne de la fenêtre de résultats
(généralement le nom de fichier).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 150
Espace de travail
• L'argument strDesc est la description qui accompagne l'entrée.
• L'argument iLineNo est le nombre de lignes figurant dans le fichier (facultatif).
• L'argument iStartSel indique le début du décalage dans le fichier (facultatif, mais s'il est présent, il faut également
utiliser l'argument iEndSel).
• L'argument iEndSel indique la fin du décalage dans le fichier (obligatoire si l'argument iStartSel est utilisé).
Valeurs renvoyées
Aucune.
dreamweaver.resultsPalette.clear()
Disponibilité
Dreamweaver MX.
Description
Efface le contenu du panneau actif.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canClear() » à la page 486.
dreamweaver.resultsPalette.Copy()
Disponibilité
Dreamweaver MX.
Description
Envoie un message copié à la fenêtre active (souvent utilisé pour la fenêtre de connexion FTP).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canCopy() » à la page 486.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 151
Espace de travail
dreamweaver.resultsPalette.cut()
Disponibilité
Dreamweaver MX.
Description
Envoie un message coupé à la fenêtre active (souvent utilisé pour la fenêtre de connexion FTP).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canCut() » à la page 486.
dreamweaver.resultsPalette.Paste()
Disponibilité
Dreamweaver MX.
Description
Envoie un message collé à la fenêtre active (souvent utilisé pour la fenêtre de connexion FTP).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canPaste() » à la page 487.
dreamweaver.resultsPalette.openInBrowser
Disponibilité
Dreamweaver MX.
Description
Envoie un rapport (Rapports de site, Vérification du navigateur cible, Validation et Vérificateur de lien) vers le
navigateur par défaut.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 152
Espace de travail
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canOpenInBrowser() » à la page 487.
dreamweaver.resultsPalette.openInEditor()
Disponibilité
Dreamweaver MX.
Description
Saute à la ligne sélectionnée pour les rapports spécifiques (Rapports du site, Vérification du navigateur cible,
Validation et Vérificateur de lien) et ouvre le document dans l'éditeur.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canOpenInEditor() » à la page 487.
dreamweaver.resultsPalette.save()
Disponibilité
Dreamweaver MX.
Description
Ouvre la boîte de dialogue Enregistrer pour une fenêtre qui prend en charge la fonction Enregistrer (Rapports du site,
Vérification du navigateur cible, Validation et Vérificateur de lien).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canSave() » à la page 488.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 153
Espace de travail
dreamweaver.resultsPalette.selectAll()
Disponibilité
Dreamweaver MX.
Description
Envoie une commande Sélectionner tout vers la fenêtre active.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.resultsPalette.canSelectAll() » à la page 488.
Fenêtre de résultats indépendante
La fonction dreamweaver.createResultsWindow() crée une fenêtre de résultats.
dreamweaver.createResultsWindow()
Disponibilité
Dreamweaver 4.
Description
Crée une nouvelle fenêtre de résultats et renvoie une référence d'objet JavaScript à la fenêtre.
Arguments
strName, arrColumns
• L'argument strName est la chaîne à utiliser pour le titre de la fenêtre.
• L'argument arrColumns est un tableau de noms de colonnes à utiliser dans le contrôle de liste.
Valeurs renvoyées
Référence d'objet à la fenêtre créée.
resWin.addItem()
Disponibilité
Dreamweaver 4.
Description
Ajoute un nouvel élément à la fenêtre de résultats.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 154
Espace de travail
Remarque : Utilisez uniquement les fenêtres de résultats indépendantes créées à l'aide de
« dreamweaver.createResultsWindow() » à la page 153. La fonction resWin.addItem() ne peut pas être utilisée avec les
fenêtres de résultats intégrées, notamment avec les fenêtres Validation, Vérifier la compatibilité avec les navigateurs ou
Rapports du site.
Arguments
resultWindowObj, strIcon, strDesc, itemData, iStartSel, iEndSel, colNdata
• L'argument resultWindowObj correspond à l'objet renvoyé par la fonction createResultsWindow().
• L'argument strIcon est une chaîne indiquant le chemin d'accès à l'icône à utiliser. Pour afficher une icône intégrée,
utilisez une valeur comprise entre 1 et 10 plutôt que le chemin d'accès complet à l'icône. Utilisez la valeur 0 pour
n'afficher aucune icône. L'illustration ci-dessous indique les icônes correspondant aux chiffres allant de 1 à 10 :
• L'argument strDesc correspond à la description détaillée de l'élément. Indiquez "0" s'il n'y a pas dedescription.
• L'argument itemData est une chaîne qui peut vous servir à stocker des données particulières relatives à l'élément à
ajouter (numéro de ligne du document, par exemple).
• L'argument iStartSel indique le début du décalage de la sélection dans le fichier. Entrez la valeur null s'il n'y a pas
de décalage.
• L'argument iEndSel indique la fin du décalage de la sélection dans le fichier. Entrez la valeur null s'il n'y a pas de
décalage.
• L'argument colNdata est un tableau de chaînes qui contient les données de chaque colonne (par exemple, tableau
de 3 chaînes s'il existe 3 colonnes).
Valeurs renvoyées
Valeur booléenne : true si l'élément a été ajouté, false dans le cas contraire.
Exemple
L'exemple suivant crée une fenêtre de résultats du nom de resWin dont les colonnes s'intitulent Frodo, Sam et Gollum.
L'appel de la fonction resWin.addItem() ajoute une icône de dossier ainsi que les trois chaînes (msg1, msg2 et msg3)
dans les trois colonnes définies pour la fenêtre.
var resWin = dw.createResultsWindow("Test Window", ["Frodo", "Sam", "Gollum"]);
resWin.addItem(resWin, "3", "Description", null, null, null, ["msg1", "msg2", "msg3"]);
resWin.getItem()
Disponibilité
Dreamweaver 4.
Description
Extrait un tableau d'éléments qui incluent le nom de la commande qui a ajouté l'élément et les mêmes chaînes que
celles transmises à la fonction addItem().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 155
Espace de travail
Arguments
itemIndex
• L'argument itemIndex correspond à l'index de l'élément dont les données doivent être extraites.
Valeurs renvoyées
Tableau de chaînes. Le premier élément du tableau correspond au nom de la commande qui a ajouté l'élément ; les
autres éléments correspondent aux mêmes chaînes que celles transmises à la fonction addItem().
resWin.getItemCount()
Disponibilité
Dreamweaver 4.
Description
Extrait le nombre d'éléments contenus dans la liste.
Arguments
Aucun.
Valeurs renvoyées
Le nombre d'éléments contenus dans la liste.
resWin.getSelectedItem()
Disponibilité
Dreamweaver 4.
Description
Extrait l'index de l'élément sélectionné.
Arguments
Aucun.
Valeurs renvoyées
L'index de l'élément sélectionné.
resWin.setButtons()
Disponibilité
Dreamweaver 4.
Description
Définit les boutons spécifiés par l'argument arrButtons.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 156
Espace de travail
Arguments
cmdDoc, arrButtons
• L'argument cmdDoc est un objet document représentant la commande utilisée pour appeler la fonction. Les
commandes doivent utiliser le mot clé this.
• L'argument arrButtons est un tableau de chaînes correspondant au texte du bouton et au code JavaScript à exécuter
lorsque l'utilisateur clique sur le bouton en question. Cet argument fonctionne de la même manière que la fonction
commandButtons() pour les commandes. Vous ne pouvez définir que deux boutons dans la fenêtre.
Valeurs renvoyées
Aucune.
resWin.setCallbackCommands()
Disponibilité
Dreamweaver 4.
Description
Indique à la fenêtre de résultats sur quelles commandes la méthode processFile() doit être appelée. Si cette fonction
n'est pas appelée, la commande qui a créé la fenêtre de résultats est appelée.
Arguments
arrCmdNames.
• L'argument arrCmdNames est un tableau de noms de commandes sur lesquelles appeler la fonction
processFile().
Valeurs renvoyées
Aucune.
resWin.setColumnWidths()
Disponibilité
Dreamweaver 4.
Description
Définit la largeur de chaque colonne.
Arguments
arrWidth.
• L'argument arrWidth est un tableau de nombres entiers représentant les largeurs à utiliser pour chaque colonne de
la commande.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 157
Espace de travail
resWin.setFileList()
Disponibilité
Dreamweaver 4.
Description
Indique à la fenêtre de résultats une liste de fichiers, de dossiers ou des deux sur lesquels appeler un ensemble de
commandes à traiter.
Arguments
arrFilePaths, bRecursive.
• L'argument arrFilePaths est un tableau de chemins de fichier ou de dossier à répéter.
• L'argument bRecursive est une valeur booléenne indiquant si la répétition doit être récurrente (true) ou non
(false).
Valeurs renvoyées
Aucune.
resWin.setSelectedItem()
Disponibilité
Dreamweaver 4.
Description
Définit l'élément sélectionné sur l'élément spécifié par itemIndex.
Arguments
itemIndex
• L'index de l'élément à sélectionner contenu dans la liste.
Valeurs renvoyées
L'index de l'ancien élément sélectionné
resWin.setTitle()
Disponibilité
Dreamweaver 4.
Description
Définit le titre de la fenêtre.
Arguments
strTitle.
• L'argument strTitle est le nouveau titre du panneau flottant.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 158
Espace de travail
Valeurs renvoyées
Aucune.
resWin.startProcessing()
Disponibilité
Dreamweaver 4.
Description
Lance le traitement du fichier.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
resWin.stopProcessing()
Disponibilité
Dreamweaver 4.
Description
Arrête le traitement du fichier.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Débogage de serveur
Dreamweaver peut solliciter des fichiers à partir d'Adobe ColdFusion et afficher la réponse dans son navigateur
incorporé. Lorsque le serveur renvoie la réponse, Dreamweaver recherche un paquet de XML ayant une signature
connue, dans la réponse. Si Dreamweaver trouve XML avec cette signature, il traite XML et affiche les informations
contenues dans une commande d'arborescence. Cette arborescence affiche des informations sur les éléments suivants :
• l'ensemble des modèles, balises personnalisées et fichiers inclus utilisés pour créer la page CFM rendue ;
• les exceptions ;
• les requêtes SQL ;
• les requêtes d'objets ;
• les variables ;
• la plage de tracé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 159
Espace de travail
En outre, le panneau Débogage du serveur peut afficher des données de débogage provenant d'autres modèles de
serveur. Pour configurer Dreamweaver afin que le programme débogue les autres modèles de serveur, utilisez la
fonction dreamweaver.resultsPalette.debugWindow.addDebugContextData().
dreamweaver.resultsPalette.debugWindow.addDebugContextData()
Disponibilité
Dreamweaver MX.
Description
Interprète un fichier XML personnalisé renvoyé du serveur spécifié dans la boîte de dialogue Définition du site. Le
contenu du fichier XML affiche les données de l'arborescence dans le panneau Débogage du serveur, pour que vous
puissiez utiliser le panneau Débogage du serveur en vue d'évaluer le contenu généré par le serveur à partir des
différents modèles de serveur.
Arguments
treedata.
• L'argument treedata est la chaîne XML renvoyée par le serveur. La chaîne XML doit utiliser la mise en forme
suivante :
server debug node
Noeud racine pour les données XML de débogage
debugnode
Correspond à tous les nœuds
context
Nom de l'élément qui apparaît dans la liste de
contexte
icon
Icône à utiliser pour le nœud d'arborescence
name
Nom à afficher
value
Valeur à afficher
timestamp
Uniquement applicable au nœud de contexte
Les chaînes suivantes sont facultatives :
jumptoline
Etablit un lien vers un numéro de ligne spécifique
template
Nom de la partie du fichier de modèle de l'URL
path
Chemin du fichier à partir du serveur
line number
Numéro de ligne dans le fichier
start position
Début du décalage de caractères dans la ligne
end position
Fin du décalage de caractères dans la ligne
Par exemple :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 160
Espace de travail
<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>
Valeurs renvoyées
Aucune.
Fonctions de bascule
Ces fonctions permettent d'obtenir et de définir un certain nombre d'options qui peuvent être activées ou désactivées.
dom.getEditNoFramesContent()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Modifier > Jeu de cadres > Modifier le contenu sans cadres.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le contenu de NOFRAMES est l'affichage actif et false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 161
Espace de travail
dom.getHideAllVisualAids()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si les assistances visuelles sont définies comme étant masquées.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true pour définir les assistances visuelles comme étant masquées et false dans le cas contraire.
dom.getPreventLayerOverlaps()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Empêcher le chevauchement des calques.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true pour activer l'option Empêcher le chevauchement des calques et false dans le cas contraire.
dom.getShowAutoIndent()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si l'option de retrait automatique est activée dans la fenêtre de document en mode Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la mise en retrait automatique est activée, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 162
Espace de travail
dom.getShowFrameBorders()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Bordures de cadre.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les bordures de cadre sont visibles, false dans le cas contraire.
dom.getShowGrid()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Grille > Afficher.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la grille est visible, false dans le cas contraire.
dom.getShowHeadView()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Contenu de l'en-tête.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le contenu de l'en-tête est visible, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 163
Espace de travail
dom.getShowInvalidHTML()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si le code HTML incorrect est actuellement en surbrillance dans la fenêtre de document en
mode Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le code HTML incorrect est en surbrillance et false dans le cas contraire.
dom.getShowImageMaps()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Cartes graphiques.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les cartes graphiques sont visibles, false dans le cas contraire.
dom.getShowInvisibleElements()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Eléments invisibles.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les marqueurs d'éléments invisibles sont visibles, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 164
Espace de travail
dom.getShowLayerBorders()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Bordures de calque.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les bordures de calque sont visibles, false dans le cas contraire.
dom.getShowLineNumbers()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si les numéros de ligne sont affichés en mode Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les numéros de ligne sont visibles, false dans le cas contraire.
dom.getShowRulers()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Règles > Afficher.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les règles sont visibles, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 165
Espace de travail
dom.getShowSyntaxColoring()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si l'option de coloration de la syntaxe est activée dans la fenêtre dedocument en mode Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la coloration de la syntaxe est activée, false dans le cas contraire.
dom.getShowTableBorders()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Bordures de tableau.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les bordures de tableau sont visibles, false dans le cas contraire.
dom.getShowToolbar()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si la barre d'outils est visible.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la barre d'outils est visible, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 166
Espace de travail
dom.getShowTracingImage()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Tracé de l'image > Afficher.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si l'option est activée, false dans le cas contraire.
dom.getShowWordWrap()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si l'option de retour automatique à la ligne est activée dans la fenêtre de document en mode
Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le renvoi des mots à la ligne est activé, false dans le cas contraire.
dom.getSnapToGrid()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Grille > Aligner sur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si l'option d'alignement sur la grille est activée, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 167
Espace de travail
dom.setEditNoFramesContent()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Modifier > Jeu de cadres > Modifier le contenu sans cadres.
Arguments
bEditNoFrames.
• L'argument bEditNoFrames est une valeur booléenne : true active l'option Modifier le contenu sans cadres, tandis
que false la désactive.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canEditNoFramesContent() » à la page 467.
dom.getHideAllVisualAids()
Disponibilité
Dreamweaver 4.
Description
Cette fonction désactive l'affichage de l'ensemble des bordures, cartes graphiques et éléments invisibles, quel que soit
leur paramètre individuel dans le menu Affichage.
Arguments
bSet.
• L'argument bSet est une valeur booléenne : true pour masquer les assistances visuelles et false dans le cas
contraire.
Valeurs renvoyées
Aucune.
dom.getPreventLayerOverlaps()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Empêcher le chevauchement des calques.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 168
Espace de travail
Arguments
bPreventLayerOverlaps.
• L'argument bPreventLayerOverlaps est une valeur booléenne: true
active l'option Empêcher le
chevauchement des calques, tandis que false la désactive.
Valeurs renvoyées
Aucune.
dom.getShowFrameBorders()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Bordures de cadre.
Arguments
bShowFrameBorders.
• L'argument bShowFrameBorders est une valeur booléenne : true active l'option Bordures de cadre et false la
désactive.
Valeurs renvoyées
Aucune.
dom.getShowGrid()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Grille > Afficher.
Arguments
bShowGrid.
• L'argument bShowGrid est une valeur booléenne: true
tandis que false la désactive.
Valeurs renvoyées
Aucune.
dom.getShowHeadView()
Disponibilité
Dreamweaver 3.
active l'option Affichage > Grille > Afficher,
RÉFÉRENCE DES API DE DREAMWEAVER CS4 169
Espace de travail
Description
Cette fonction active ou désactive l'option Affichage > Contenu de l'en-tête.
Arguments
bShowHead.
• L'argument bShowHead est une valeur booléenne : true active l'option Contenu de l'en-tête, tandis que false la
désactive.
Valeurs renvoyées
Aucune.
dom.getShowInvalidHTML()
Disponibilité
Dreamweaver 4.
Description
Cette fonction active ou désactive la mise en surbrillance du code HTML incorrect dans la fenêtre de document en
mode Code.
Cette fonction détermine si le code HTML incorrect est actuellement en surbrillance.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true indique que la mise en surbrillance du code HTML incorrect est
visible, et false qu'elle ne l'est pas.
Valeurs renvoyées
Aucune.
dom.getShowImageMaps()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Cartes graphiques.
Arguments
bShowImageMaps.
• L'argument bShowImageMaps est une valeur booléenne : true active l'option Cartes graphiques, tandis que false
la désactive.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 170
Espace de travail
dom.getShowInvisibleElements()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Eléments invisibles.
Arguments
bViewInvisibleElements.
• L'argument bViewInvisibleElements est une valeur booléenne : true active l'option Eléments invisibles, tandis que
false la désactive.
Valeurs renvoyées
Aucune.
dom.getShowLayerBorders()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Bordures de calque.
Arguments
bShowLayerBorders.
• L'argument bShowLayerBorders est une valeur booléenne : true active l'option Bordures de calque, tandis que
false la désactive.
Valeurs renvoyées
Aucune.
dom.setShowLineNumbers()
Disponibilité
Dreamweaver 4.
Description
Cette fonction affiche ou masque les numéros de ligne dans la fenêtre de document en mode Code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true signifie que les numéros de ligne sont visibles et false qu'ils ne
le sont pas.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 171
Espace de travail
Valeurs renvoyées
Aucune.
dom.setShowRulers()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Règles > Afficher.
Arguments
bShowRulers.
• L'argument bShowRulers est une valeur booléenne : true active l'option Afficher, tandis que false la désactive.
Valeurs renvoyées
Aucune.
dom.setShowSyntaxColoring()
Disponibilité
Dreamweaver 4.
Description
Cette fonction active ou désactive la coloration de la syntaxe dans la fenêtre de document en mode Code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true signifie que la coloration de la syntaxe est visible et false qu'elle
ne l'est pas.
Valeurs renvoyées
Aucune.
dom.setShowTableBorders()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Bordures de tableau.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 172
Espace de travail
Arguments
bShowTableBorders.
• L'argument bShowTableBorders est une valeur booléenne : true active l'option Bordures de tableau, tandis que
false la désactive.
Valeurs renvoyées
Aucune.
dom.setShowToolbar()
Disponibilité
Dreamweaver 4.
Description
Cette fonction affiche ou masque la barre d'outils.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true signifie que la barre d'outils est visible et false qu'elle ne l'est pas.
Valeurs renvoyées
Aucune.
dom.setShowTracingImage()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Tracé de l'image > Afficher.
Arguments
bShowTracingImage.
• L'argument bShowTracingImage est une valeur booléenne : true active l'option Afficher, tandis que false la
désactive.
Valeurs renvoyées
Aucune.
dom.setShowWordWrap()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 173
Espace de travail
Description
Cette fonction active ou désactive l'option Retour à la ligne dans la fenêtre de document en mode Code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true signifie que le renvoi des mots à la ligne est activé et false qu'il
ne l'est pas.
Valeurs renvoyées
Aucune.
dom.setSnapToGrid()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Grille > Aligner sur.
Arguments
bSnapToGrid.
• L'argument bSnapToGrid est une valeur booléenne : true active l'option Aligner sur, tandis que false la désactive.
Valeurs renvoyées
Aucune.
dreamweaver.getHideAllFloaters()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Détermine si tous les panneaux, ancrés ou flottants, sont masqués. Le résultat n'influe pas sur la visibilité de la barre
Insertion. Les composants suivants ne sont pas considérés comme masqués :
• Panneaux fermés
• Groupes d'onglets réduits
• Panneaux réduits
Remarque : Le résultat n'influe pas sur la barre Insertion, mais bien sur le panneau Insertion.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si tous les panneaux sont masqués, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 174
Espace de travail
dreamweaver.getShowStatusBar()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Affichage > Barre d'état.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la barre d'état est visible, false dans le cas contraire.
dreamweaver.htmlInspector.getShowAutoIndent()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si l'option de retrait automatique est activée dans l'inspecteur de code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la mise en retrait automatique est activée, false dans le cas contraire.
dreamweaver.htmlInspector.getShowInvalidHTML()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si le code HTML incorrect est actuellement en surbrillance dans l'inspecteurde code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le code HTML incorrect est en surbrillance et false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 175
Espace de travail
dreamweaver.htmlInspector.getShowLineNumbers()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si les numéros de ligne sont affichés dans l'inspecteur de code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les numéros de ligne sont visibles, false dans le cas contraire.
dreamweaver.htmlInspector.getShowSyntaxColoring()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si l'option de coloration de la syntaxe est activée dans l'inspecteur de code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la coloration de la syntaxe est activée, false dans le cas contraire.
dreamweaver.htmlInspector.getShowWordWrap()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine si l'option de retour à la ligne est activée dans l'inspecteur de code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le renvoi des mots à la ligne est activé, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 176
Espace de travail
dreamweaver.htmlInspector.setShowAutoIndent()
Disponibilité
Dreamweaver 4.
Description
Cette fonction active ou désactive l'option de retrait automatique dans l'inspecteur de code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true active la mise en retrait automatique, tandis que false la
désactive.
Valeurs renvoyées
Aucune.
dreamweaver.htmlInspector.setShowInvalidHTML()
Disponibilité
Dreamweaver 4.
Description
Cette fonction active ou désactive la mise en surbrillance du code HTML incorrect dans l'inspecteur de code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true indique que la mise en surbrillance du code HTML incorrect est
visible, et false qu'elle ne l'est pas.
Valeurs renvoyées
Aucune.
dreamweaver.htmlInspector.setShowLineNumbers()
Disponibilité
Dreamweaver 4.
Description
Cette fonction affiche ou masque les numéros de ligne dans l'inspecteur de code en mode Code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true signifie que les numéros de ligne sont visibles et false qu'ils ne
le sont pas.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 177
Espace de travail
Valeurs renvoyées
Aucune.
dreamweaver.htmlInspector.setShowSyntaxColoring()
Disponibilité
Dreamweaver 4.
Description
Cette fonction active ou désactive la coloration de la syntaxe dans l'inspecteur de code en mode Code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true signifie que la coloration de la syntaxe est visible et false qu'elle
ne l'est pas.
Valeurs renvoyées
Aucune.
dreamweaver.htmlInspector.setShowWordWrap()
Disponibilité
Dreamweaver 4.
Description
Cette fonction active ou désactive l'option Retour à la ligne dans l'inspecteur de code.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true active le retour à la ligne automatique, tandis que false le
désactive.
Valeurs renvoyées
Aucune.
dreamweaver.setHideAllFloaters()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Cette fonction affiche ou masque tous les panneaux. Elle n'influe pas sur la barre Insertion.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 178
Espace de travail
Arguments
bShowFloatingPalettes
• L'argument bShowFloatingPalettes est une valeur booléenne : true masque tous les panneaux et false les
affiche. Lorsqu'un panneau est visible, l'envoi de false entraîne l'affichage de tous les panneaux restants. Lorsque
vous les panneaux sont visibles, l'envoi de false est sans effet.
Remarque : Cette commande ne masque aucun panneau, sauf s'ils sont tous visibles. Dès lors, l'envoi de true lorsqu'un
panneau est visible est sans effet.
Valeurs renvoyées
Aucune.
dreamweaver.setShowStatusBar()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Affichage > Barre d'état.
Arguments
bShowStatusBar.
• L'argument bShowStatusBar est une valeur booléenne : true active l'option Barre d'état, tandis que false la
désactive.
Valeurs renvoyées
Aucune.
site.getShowToolTips()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient l'état en cours de l'option Infobulles.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true lorsque les infobulles sont visibles dans le panneau Site et false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 179
Espace de travail
site.setShowToolTips()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active ou désactive l'option Infobulles.
Arguments
bShowToolTips.
• L'argument bShowToolTips est une valeur booléenne : true active l'option Infobulles, tandis que false la désactive.
Valeurs renvoyées
Aucune.
Fonctions relatives aux barres d'outils
Les fonctions JavaScript suivantes vous permettent d'obtenir et de définir l'affichage des barres d'outils et de leurs
étiquettes, de vous procurer les étiquettes des éléments de barre d'outils dans la fenêtre en cours, de positionner les
barres d'outils et d'obtenir leur ID. Pour plus d'informations sur la création ou la modification des barres d'outils,
consultez la rubrique « Barres d'outils » dans l'aide Extension de Dreamweaver.
dom.getShowToolbarIconLabels()
Disponibilité
Dreamweaver MX.
Description
Cette fonction détermine si les étiquettes des boutons sont visibles dans la fenêtre de document actuelle. Dreamweaver
affiche toujours les étiquetts des commandes qui ne sont pas des boutons, si elles sont définies.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les étiquettes des boutons sont visibles dans la fenêtre de document active et false dans le
cas contraire.
Exemple
L'exemple suivant permet d'afficher les étiquettes des boutons :
var dom = dw.getDocumentDom();
if (dom.getShowToolbarIconLabels() == false)
{
dom.setShowToolbarIconLabels(true);
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 180
Espace de travail
dom.getToolbarIdArray()
Disponibilité
Dreamweaver MX.
Description
Cette fonction renvoie un tableau contenant les ID de toutes les barres d'outils de l'application. Utilisez la fonction
dom.getToolbarIdArray() pour désactiver toutes les barres d'outils et pouvoir ainsi les repositionner en ne rendant
visibles que certaines d'entre elles.
Arguments
Aucun.
Valeurs renvoyées
Tableau de tous les ID de barre d'outils.
Exemple
L'exemple suivant stocke le tableau des ID de barre d'outils dans la variable tb_ids :
var tb_ids = new Array();
tb_ids = dom.getToolbarIdArray();
dom.getToolbarItemValue()
Disponibilité
Dreamweaver MX 2004.
Description
Obtient la valeur de l'élément de barre d'outils spécifié.
Arguments
toolbarID, itemID.
• L'argument toolbarID est une chaîne indiquant l'ID de la barre d'outils contenant l'élément pour lequel vous
souhaitez obtenir une valeur.
• L'argument itemID est une chaîne qui indique l'ID de l'élément pour lequel vous souhaitez obtenir une valeur.
Valeurs renvoyées
Une chaîne représentant la valeur de l'élément de barre d'outils.
Exemple
L'exemple de fonction receiveArguments() suivant figure dans une commande de barre d'outils qui régit le
comportement d'un champ de texte Size ; il obtient la valeur du champ Size sous la forme d'un argument, puis lit la
valeur du champ Units afin de générer une valeur valide pour la fonction de propriété CSS font-size :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 181
Espace de travail
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()
Disponibilité
Dreamweaver MX.
Description
Cette fonction obtient l'étiquette de la barre d'outils spécifiée. Utilisez la fonction dom.getToolbarLabel() pour les
menus qui affichent ou masquent des barres d'outils.
Arguments
toolbar_id
• L'argument toolbar_id est l'ID de la barre d'outils, qui correspond à la valeur de l'attribut ID de la balise toolbar
définie dans le fichier toolbars.xml.
Valeurs renvoyées
La chaîne de nom label qui est affectée à la balise toolbar comme attribut.
Exemple
L'exemple suivant stocke l'étiquette de myEditbar dans la variable label :
var label = dom.getToolbarLabel("myEditbar");
dom.getToolbarVisibility()
Disponibilité
Dreamweaver MX.
Description
Cette fonction renvoie une valeur booléenne qui indique si la barre d'outils spécifiée dans l'argument toolbar_id est
visible.
Arguments
toolbar_id
• L'argument toolbar_id est la chaîne d'ID affectée à la barre d'outils.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 182
Espace de travail
Valeurs renvoyées
Valeur booléenne : true si la barre d'outils est visible et false si la barre d'outils n'est pas visible ou n'existe pas.
Exemple
L'exemple suivant vérifie si la barre d'outils myEditbar est visible dans la fenêtre de document, puis stocke cette valeur
dans la variable retval :
var retval = dom.getToolbarVisibility("myEditbar");
return retval;
dom.setToolbarItemAttribute()
Disponibilité
Dreamweaver MX 2004.
Description
Modifie une valeur parmi les trois attributs image ou l'attribut tooltip d'un élément de la barre d'outils.
Arguments
toolbarID, toolbarItemId, attrName, attrValue
• L'argument toolbarID est une chaîne qui indique l'ID de la barre d'outils.
• L'argument toolbarItemId est une chaîne qui indique l'ID de l'élément de la barre d'outils.
• L'argument attrName est une chaîne qui indique le nom de l'attribut à définir. Les valeurs autorisées sont 'image',
'overImage', 'disabledImage' et 'tooltip'.
• L'argument attrValue est une chaîne qui indique la valeur à définir.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant appelle dom.setToolbarItemAttribute() trois fois pour définir les attributs image, imageOver
et tooltip de l'élément MyButton sur la barre d'outils portant l'ID DW_Toolbar_Main :
var dom = dw.getDocumentDOM();
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()
Disponibilité
Dreamweaver MX.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 183
Espace de travail
Description
Cette fonction ordonne à Dreamweaver s'afficher les étiquettes des boutons qui en possèdent. Dreamweaver affiche
toujours les étiquettes des commandes qui ne sont pas des boutons, si elles sont définies.
Arguments
bShow.
• L'argument bShow est une valeur booléenne : true affiche les étiquettes des boutons et false les masque.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant indique à Dreamweaver d'afficher les étiquettes des boutons sur les barres d'outils :
dom.setShowToolbarIconLabels(true);
dom.setToolbarPosition()
Disponibilité
Dreamweaver MX.
Description
Cette fonction déplace la barre d'outils spécifiée à la position indiquée.
Remarque : Il est impossible de déterminer la position actuelle d'une barre d'outils.
Arguments
toobar_id, position, relative_to
• L'argument toolbar_id est l'ID de la barre d'outils, qui correspond à la valeur de l'attribut ID de la balise toolbar
définie dans le fichier toolbars.xml.
• L'argument position indique l'endroit où Dreamweaver place la barre d'outils par rapport aux autres barres d'outils.
Les valeurs possibles de l'argument position sont décrites dans la liste suivante :
•
top correspond à la position par défaut. La barre d'outils apparaît en haut de la fenêtre de document.
•
below force la barre d'outils à s'afficher au début de la ligne, juste sous la barre d'outils spécifiée par l'attribut
relative_to. Dreamweaver signale une erreur si la barre d'outils ne trouve pas la barre spécifiée par relative_to.
•
floating affiche la barre d'outils au-dessus du document, en mode flottant. Dreamweaver place
automatiquement la barre d'outils de sorte qu'elle soit décalée par rapport aux autres barres d'outils flottantes.
Sur Macintosh, floating est traité de la même façon que top.
• relative_to="toolbar_id" est requis si position spécifie below. Dans les autres cas, cet argument est ignoré.
Indique l'ID de la barre d'outils en dessous de laquelle cette barre d'outils doit être placée.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant place myEditbar en dessous de la barre d'outils myPicturebar :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 184
Espace de travail
dom.setToolbarPosition("myEditbar", "below", "myPicturebar");
dom.setToolbarVisibility()
Disponibilité
Dreamweaver MX.
Description
Cette fonction affiche ou masque la barre d'outils spécifiée.
Arguments
toolbar_id, bShow
• L'argument toolbar_id est l'ID de la barre d'outils, qui correspond à la valeur de l'attribut ID de la balise toolbar
définie dans le fichier toolbars.xml.
• L'argument bShow est une valeur booléenne qui indique si la barre d'outils doit être affichée ou masquée. Si bShow
a pour valeur true, la fonction dom.setToolbarVisibility() rend la barre d'outils visible. Si bShow a pour
valeur false, la fonction dom.setToolbarVisibility() rend la barre d'outils invisible.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant vérifie si la barre d'outils myEditbar est visible dans la fenêtre de document. Si ce n'est pas le cas, il
l'affiche :
var dom = dw.getDocumentDOM();
if(dom != null && dom.getToolbarVisibility("myEditbar") == false)
{
dom.setToolbarVisibility("myEditbar", true);
{
dreamweaver.reloadToolbars()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction recharge toutes les barres d'outils JavaScript dans le dossier Configuration/Toolbars.
Arguments
{resetToDefault}
• L'argument resetToDefault est une valeur booléenne qui indique s'il faut lire la visibilité et la position par défaut
pour chaque barre d'outils à partir du fichier toolbars.xml. Si sa valeur est false ou si elle n'est pas fournie, les
positions et visibilités des barres d'outils sont préservées lors du rechargement. Cet argument est facultatif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 185
Espace de travail
Valeurs renvoyées
Aucune.
Fonctions relatives aux fenêtres
Ces fonctions permettent d'agir sur la fenêtre de document et sur les panneaux flottants. Elles permettent d'afficher et
de masquer les panneaux flottants, de déterminer la partie active de la fenêtre de document et de définir le document
actif. Pour les opérations relatives au panneau Site, consultez la section « Fonctions relatives aux sites » à la page 213.
Remarque : Certaines fonctions de cette section fonctionnent uniquement sous Windows. Leur description indique si tel
est le cas.
dom.getFocus()
Disponibilité
Dreamweaver 3.
Description
Cette fonction détermine quelle partie du document est actuellement active.
Arguments
Aucun.
Valeurs renvoyées
L'une des chaînes suivantes :
• la chaîne "head" si la zone HEAD est active ;
• la chaîne "body" si la zone BODY ou NOFRAMES est active ;
• la chaîne "frameset" si un jeu de cadres ou l'un des cadres qui le composent est sélectionné ;
• la chaîne "none" si la zone active ne figure pas dans le document (si elle se trouve dans l'inspecteur Propriétés ou
dans un autre panneau flottant, par exemple).
dom.getView()
Disponibilité
Dreamweaver 4, mise à jour dans CS4.
Description
Cette fonction détermine quel mode est visible.
Arguments
Aucun.
Valeurs renvoyées
design, code, split ou "split code", selon le mode d'affichage visible.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 186
Espace de travail
dom.getWindowTitle()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient le titre de la fenêtre contenant le document.
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant le texte qui apparaît entre les balises TITLE du document, ou rien si le document ne figure pas dans
une fenêtre ouverte.
dom.setView()
Disponibilité
Dreamweaver 4, mise à jour dans CS4.
Description
Cette fonction affiche ou masque le mode Création ou Code pour produire un affichage contenant uniquement le
mode Création ou Code ou les deux.
Arguments
viewString
• L'argument viewString est le mode d'affichage à produire. Il doit s'agir d'une des valeurs suivantes : design, code,
split ou "split code".
Valeurs renvoyées
Aucune.
dreamweaver.bringAttentionToFloater()
Disponibilité
Dreamweaver MX.
Description
Place au premier plan le panneau ou l'inspecteur spécifié et attire l'attention sur cet élément en le faisant clignoter
(fonctionnalité légèrement différente de dw.toggleFloater()).
Arguments
floaterName.
• L'argument floaterName correspond au nom de la fenêtre, du panneau ou de l'inspecteur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 187
Espace de travail
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant ouvre le panneau Actifs et le fait clignoter :
dw.bringAttentionToFloater("library");
dreamweaver.cascade()
Disponibilité
Dreamweaver MX (Windows uniquement), Dreamweaver8 (prise en charge supplémentaire pour Macintosh).
Description
Affiche en cascade les fenêtres de document en commençant dans l'angle supérieur gauche et en décalant légèrement
chaque fenêtre par rapport à la précédente.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant affiche les documents ouverts en cascade :
dw.cascade()
dreamweaver.getActiveWindow()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient le document figurant dans la fenêtre active.
Arguments
Aucun.
Valeurs renvoyées
Objet document correspondant au document qui figure dans la fenêtre active ou, si le document figure dans un cadre,
objet document correspondant au jeu de cadres.
dreamweaver.getDocumentList()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 188
Espace de travail
Description
Cette fonction renvoie la liste de tous les documents ouverts.
Arguments
Aucun.
Valeurs renvoyées
Tableau d'objets document, chacun correspondant à une fenêtre de document ouverte. Si une fenêtre de document
contient un jeu de cadres, l'objet document désigne le jeu de cadres et non le contenu des cadres.
dreamweaver.getFloatersVisible()
Disponibilité
Description
Détermine si un panneau, ancré ou flottant, est visible. Le résultat n'influe pas sur les éléments suivants :
• Visibilité de la barre Insertion
• Panneaux fermés
Remarque : Le résultat n'influe pas sur la barre Insertion, mais bien sur le panneau Insertion.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si un panneau est visible et false dans le cas contraire.
dreamweaver.getFloaterVisibility()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Cette fonction vérifie si le panneau ou l'inspecteur spécifié est visible.
Arguments
floaterName
• L'argument floaterName est le nom du panneau flottant. Si floaterName ne correspond à aucun nom de panneau
intégré, Dreamweaver recherche dans le dossier Configuration/Floaters un fichier appelé floaterName.htm, où
floaterName correspond au nom d'un panneau flottant.
Les valeurs de floaterName pour les panneaux intégrés sont les chaînes se trouvant à droite des noms de panneaux
dans la liste suivante :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 189
Espace de travail
Actifs = "assets"
Comportements = "behaviors"
Liaisons = "data bindings"
Inspecteur de code = "html"
Composants = "server components"
Styles CSS = "css styles"
Bases de données = "databases"
Cadres = "frames"
Historique = "history"
Barre Insertion = "objects"
Calques = "layers"
Bibliothèque = "library"
Vérificateur de liens (Résultats) = "linkchecker"
Propriétés = "properties"
Référence = "reference"
Rapports (Résultats) = "reports"
Recherche (Résultats) = "search"
Inspecteur de sélections = "selection inspector"
Comportements de serveur = "server behaviors"
Site = "site"
Fichiers du site = "site files"
Fragments de code = "snippets"
Vérification de la compatibilité avec les navigateurs = "bcc"
Validation (Résultats) = "validation"
Valeurs renvoyées
Valeur booléenne : true si le panneau flottant est visible et se trouve au premier plan, false si ce n'est pas le cas ou
que Dreamweaver ne trouve pas de panneau flottant nommé floaterName.
dreamweaver.getFocus()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine la partie de l'application actuellement active.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 190
Espace de travail
Arguments
bAllowFloaters.
• L'argument bAllowFloaters est une valeur booléenne : true si la fonction doit renvoyer le nom du panneau
flottant (si un panneau flottant est actif) et false dans le cas contraire.
Valeurs renvoyées
L'une des chaînes suivantes :
• la chaîne "document" si la fenêtre de document est active ;
• la chaîne "site" si le panneau Site est actif ;
• la chaîne "textView" si le mode Texte est actif ;
• la chaîne "html" si l'inspecteur de code est actif ;
• la chaîne floaterName, si bAllowFloaters a pour valeur true et si un panneau flottant est actif, floaterName
correspondant à "objects", "properties", "launcher", "library", "css styles", "html styles",
"behaviors", "timelines", "layers", "frames", "templates" ou "history" ;
• la chaîne "none" (Macintosh) si aucune fenêtre de document ni le panneau Site ne sont ouverts.
dreamweaver.getPrimaryView()
Disponibilité
Dreamweaver 4.
Description
Cette fonction détermine le mode d'affichage défini comme mode principal (au premier plan).
Arguments
Aucun.
Valeurs renvoyées
Les chaînes "design" ou "code", selon le mode visible ou le volet situé au premier plan dans un affichage à deux
volets.
dreamweaver.getSnapDistance()
Disponibilité
Dreamweaver 4.
Description
Cette fonction renvoie la distance d'alignement en pixels.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 191
Espace de travail
Valeurs renvoyées
Nombre entier représentant la distance d'alignement en pixels. La distance par défaut est 10 pixels ; 0 indique que la
fonction d'alignement est désactivée.
dreamweaver.minimizeRestoreAll()
Disponibilité
Dreamweaver 4.
Description
Cette fonction réduit en icône ou restaure toutes les fenêtres dans Dreamweaver.
Arguments
bMinimize
• L'argument bMinimize est une valeur booléenne : true si les fenêtres doivent être réduites et false si les fenêtres
réduites doivent être agrandies.
Valeurs renvoyées
Aucune.
dreamweaver.getActiveWindow()
Disponibilité
Dreamweaver 3.
Description
Cette fonction active la fenêtre contenant le document spécifié.
Arguments
documentObject, {bActivateFrame}
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document (c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM()).
• Facultatif, l'argument bActivateFrame n'est applicable que lorsque documentObject se trouve à l'intérieur d'un jeu
de cadres. L'argument bActivateFrame est une valeur booléenne : true active le cadre qui contient le document
ainsi que la fenêtre qui contient le jeu de cadres ; false dans le cas contraire.
Valeurs renvoyées
Aucune.
dreamweaver.setFloaterVisibility()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 192
Espace de travail
Description
Cette fonction indique s'il faut rendre visible un panneau flottant ou un inspecteur spécifique.
Arguments
floaterName, bIsVisible
• L'argument floaterName est le nom du panneau flottant. Si l'argument floaterName ne correspond pas à l'un des
noms de panneau flottant réservés, Dreamweaver recherche dans le dossier Configuration/Floaters un fichier
nommé floaterName.htm. Si Dreamweaver ne trouve aucun panneau flottant portant le nom floaterName, cette
fonction n'a aucun effet.
Les valeurs de floaterName pour les panneaux intégrés sont les chaînes se trouvant à droite des noms de panneaux
dans la liste suivante :
Actifs = "assets"
Comportements = "behaviors"
Liaisons = "data sources"
Inspecteur de code = "html"
Composants = "server components"
Styles CSS = "css styles"
Bases de données = "databases"
Cadres = "frames"
Historique = "history"
Styles HTML = "html styles"
Barre Insertion = "objects"
Calques = "layers"
Bibliothèque = "library"
Vérificateur de liens (Résultats) = "linkchecker"
Propriétés = "properties"
Référence = "reference"
Rapports (Résultats) = "reports"
Recherche (Résultats) = "search"
Comportements de serveur = "server behaviors"
Site = "site"
Fichiers du site = "site files"
Fragments de code = "snippets"
Inspecteur de balises = "tag inspector"
Vérification de la compatibilité avec les navigateurs = "bcc"
Modèles = "templates"
Validation (Résultats) = "validation"
RÉFÉRENCE DES API DE DREAMWEAVER CS4 193
Espace de travail
• L'argument bIsVisible est une valeur booléenne indiquant si le panneau flottant doit être visible.
Valeurs renvoyées
Aucune.
dreamweaver.setPrimaryView()
Disponibilité
Dreamweaver 4.
Description
Cette fonction affiche le mode spécifié en haut de la fenêtre de document.
Arguments
viewString.
• L'argument viewString correspond au mode à afficher en haut de la fenêtre de document ; il peut avoir l'une des
valeurs suivantes : "design" ou "code".
Valeurs renvoyées
Aucune.
dreamweaver.setSnapDistance()
Disponibilité
Dreamweaver 4.
Description
Cette fonction définit la distance d'alignement en pixels.
Arguments
snapDistance.
• L'argument snapDistance est un nombre entier représentant la distance d'alignement en pixels. La valeur par défaut
est 10 pixels. Saisissez 0 pour désactiver la fonction d'alignement.
Valeurs renvoyées
Aucune.
dreamweaver.showProperties()
Disponibilité
Dreamweaver 3.
Description
Cette fonction rend l'inspecteur Propriétés visible et l'active.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 194
Espace de travail
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.tileHorizontally()
Disponibilité
Dreamweaver MX (Windows uniquement), Dreamweaver8 (prise en charge supplémentaire pour Macintosh).
Description
Organise les fenêtres de document en mosaïque horizontale en les plaçant les unes à côté des autres sans qu'elles ne se
chevauchent. Ce processus revient au partage vertical de l'espace de travail.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant affiche les documents ouverts en mosaïque horizontale :
dw.tileHorizontally()
dreamweaver.tileVertically()
Disponibilité
Dreamweaver MX (Windows uniquement), Dreamweaver8 (prise en charge supplémentaire pour Macintosh).
Description
Organise les fenêtres de documents en mosaïque verticale en les plaçant les unes derrière les autres sans qu'elles ne se
chevauchent. Ce processus revient au partage horizontal de l'espace de travail.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant affiche les documents ouverts en mosaïque verticale :
dw.tileVertically()
RÉFÉRENCE DES API DE DREAMWEAVER CS4 195
Espace de travail
dreamweaver.toggleFloater()
Disponibilité
Dreamweaver 3.
Description
Cette fonction affiche, masque ou place au premier plan le panneau ou l'inspecteur spécifié.
Remarque : Cette fonction n'a de sens que dans le fichier menus.xml. Pour afficher, placer au premier plan ou masquer
un panneau flottant, utilisez la fonction dw.setFloaterVisibility().
Arguments
floaterName.
• L'argument floaterName correspond au nom de la fenêtre. Si le nom de la fenêtre flottante est reference, l'état de
visibilité du panneau Référence peut être mis à jour par l'utilisateur dans le mode Code. Tous les autres panneaux
effectuent un suivi continu de la sélection, mais le panneau Référence n'analyse la sélection dans le mode Code que
lorsque l'utilisateur lance un suivi.
Valeurs renvoyées
Aucune.
dreamweaver.updateReference()
Disponibilité
Dreamweaver 4.
Description
Cette fonction met à jour le panneau flottant Référence. Si le panneau flottant Référence n'est pas visible,
dw.updateReference() l'affiche et le met à jour.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Fonctions de la barre d'information
La barre d'information sert à afficher des messages d'erreur sans interrompre les activités. Les fonctions suivantes de
la barre d'information servent à masquer ou à afficher la barre d'information contenant des messages d'erreur.
dom.showInfoBar()
Disponibilité
Dreamweaver CS4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 196
Espace de travail
Description
Cette fonction affiche la barre d'information contenant le message transmis. Si la barre d'information est déjà affichée,
son contenu est mis à jour en fonction du nouveau message transmis. Si aucun message n'est transmis, une erreur JS
se produit.
Arguments
Message.
Valeurs renvoyées
Aucun.
dom.hideInfoBar()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction masque la barre d'information.
Arguments
Aucun.
Valeurs renvoyées
Aucun.
Fonctions des fichiers apparentés
Les fonctions des fichiers apparentés facilitent le travail des codeurs en leur offrant un accès aisé aux fichiers auxiliaires
et apparentés qu'ils utilisent fréquemment.
dreamweaver.getRelatedFiles()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction renvoie la liste de tous les fichiers apparentés. Les fichiers apparentés peuvent être des documents
enfants, des fichiers HTML source et des fichiers source générés.
Arguments
Valeur booléenne qui spécifie les noms d'affichage du document parent et des fichiers source générés.
• La valeur true permet d'afficher HTML source et Source générée dans le menu.
• La valeur false permet d'afficher le nom réel des fichiers apparentés dans le menu.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 197
Espace de travail
Valeurs renvoyées
Tableau de chaînes qui contient tous les fichiers apparentés analysés sous la forme d'URL locales absolues.
dreamweaver.openRelatedFile()
Disponibilité
Dreamweaver CS4.
Description
Affiche le fichier apparenté sélectionné dans le mode Code du document actuel.
Arguments
Chaîne qui est l'URL locale absolue du fichier.
Valeurs renvoyées
Aucun.
dreamweaver.getActiveRelatedFilePath()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction obtient le chemin d'accès complet du fichier apparenté ouvert.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui est l'URL locale absolue du fichier apparenté.
Fonctions du mode Fractionnement vertical
Les fonctions du mode Fractionnement vertical permettent l'affichage côte à côte des modes Code et Création ou Code
et Mise en forme du code. Ces fonctions permettent aussi à l'utilisateur de choisir une orientation horizontale ou
verticale des modes Fractionné et Code fractionné, et de basculer entre celles-ci.
dreamweaver.getSplitViewOrientation()
Disponibilité
Dreamweaver CS4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 198
Espace de travail
Description
Cette fonction affiche l'orientation actuelle du mode Fractionné. L'orientation peut être obtenue même si l'affichage
n'est pas fractionné. Dans ce cas, la valeur renvoyée indique l'orientation si l'affichage Fractionné ou Code fractionné
est activé.
Arguments
Aucun.
Valeurs renvoyées
Valeur de chaîne qui définit l'orientation. Renvoie la valeur vertical ou horizontal en fonction de l'orientation
actuelle.
dreamweaver.setSplitViewOrientation()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction modifie l'orientation actuelle du mode Fractionné. L'orientation peut être modifiée même si l'affichage
n'est pas fractionné. Dans ce cas, l'argument indique l'orientation la prochaine fois que l'affichage Fractionné ou Code
fractionné sera activé.
Arguments
Valeur de chaîne qui indique l'orientation. Utilisez vertical ou horizontal pour indiquer l'orientation. Cet
argument est requis.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false si une erreur se produit.
dreamweaver.getPrimaryView()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction obtient le nom du mode d'affichage principal. En mode Fractionné ou Code fractionné, le mode
principal est la fenêtre supérieure ou de gauche, en fonction de l'orientation du mode Fractionné.
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant le nom du mode d'affichage principal, qui peut être l'une des valeurs suivantes :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 199
Espace de travail
Valeur
Description
code
L'affichage principal est la fenêtre Code.
design
L'affichage principal est la fenêtre Création.
related file
L'affichage principal est la fenêtre des fichiers apparentés. Cette valeur est renvoyée
lorsque l'affichage utilisé pour le document est Code fractionné et qu'un fichier
apparenté a été ouvert.
dreamweaver.setPrimaryView()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction modifie le mode d'affichage principal. En mode Fractionné ou Code fractionné, le mode principal est
la fenêtre supérieure ou de gauche, en fonction de l'orientation du mode Fractionné.
Arguments
Chaîne contenant le nom du mode d'affichage principal, qui peut être l'une des valeurs suivantes :
Valeur
Description
code
L'affichage principal est la fenêtre Code.
design
L'affichage principal est la fenêtre Création.
related file
L'affichage principal est la fenêtre des fichiers apparentés. Cette
valeur est utilisée lorsque l'affichage utilisé pour le document est
Code fractionné et qu'un fichier apparenté a été ouvert.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
dom.isRelatedFileViewOpen()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction détermine si l'affichage contient une fenêtre de fichiers apparentés.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si une fenêtre de fichiers apparentés est ouverte, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 200
Espace de travail
Fonctions relatives au fractionnement des codes
Ces fonctions vous permettent de fractionner et d'étendre visuellement des codes. Vous pouvez fractionner ou étendre
des sélections arbitraires de codes, ou des fragments situés entre les balises d'ouverture et de fermeture. Bien que les
fonctions de fractionnement de code existent dans le dom comme dans htmlInspector, les plages réduites sont
identiques dans le mode Code et dans Cold Inspector.
dom.collapseFullTag()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si l'élément sélectionné se trouve dans une seule paire de balises d'ouverture et de fermeture
ou s'il contient une seule paire de balises d'ouverture et de fermeture en mode Code. Le cas échéant, la fonction
fractionne le fragment de code qui commence immédiatement avant la balise d'ouverture et se termine après la balise
de fermeture ; dans le cas contraire, elle ne fait rien.
Arguments
allowCodeFragmentAdjustment
• L'argument obligatoire allowCodeFragmentAdjustment est une valeur booléenne. Si défini sur true, cet argument
n'a aucun effet actuellement ou bien le même effet que la valeur false. Si défini sur false, Dreamweaver
fractionne le code qui commence immédiatement avant la balise d'ouverture et se termine immédiatement après la
balise de fermeture, sans le modifier.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant fractionne le fragment de code qui commence juste avant la balise d'ouverture et se termine juste
après la balise de fermeture dans la sélection en cours du mode Code :
var currentDOM = dw.getDocumentDOM();
currentDOM.collapseFullTag(false);
dom.collapseFullTagInverse()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si l'élément sélectionné se trouve dans une seule paire de balises d'ouverture et de fermeture
ou s'il contient une seule paire de balises d'ouverture et de fermeture en mode Code. Le cas échéant, elle fractionne le
code qui précède la balise d'ouverture et le code qui suit la balise de fermeture ; dans le cas contraire, elle ne fait rien.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 201
Espace de travail
Arguments
allowAdjustmentOfCodeFragments
• L'argument obligatoire allowAdjustmentOfCodeFragments est une valeur booléenne. Si défini sur true,
Dreamweaver ajuste les limites du code situé avant la balise de d'ouverture et du code situé après la balise de
fermeture pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement en cours. Si
défini sur false, Dreamweaver fractionne les fragments de code qui se trouvent avant la balise d'ouverture et après
la balise de fermeture, exactement comme indiqué par la sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant ajuste les limites du code avant la balise d'ouverture et après la balise de fermeture pour effectuer un
fractionnement intelligent qui conserve la mise en retrait et l'espacement :
var currentDOM = dw.getDocumentDOM();
currentDOM.collapseFullTagInverse(true);
dom.collapseSelectedCodeFragment()
Disponibilité
Dreamweaver 8.
Description
Fractionne le code sélectionné en mode Code. Si la sélection est déjà réduite, cette fonction ne fait rien.
Arguments
allowCodeFragmentAdjustment
• allowCodeFragmentAdjustment est une valeur booléenne obligatoire. Si défini sur true, Dreamweaver modifie les
limites de la sélection en cours pour effectuer un fractionnement intelligent et conserver la mise en retrait et
l'espacement en cours. Si défini sur false, Dreamweaver fractionne le fragment de code actuellement sélectionné,
exactement comme indiqué par la sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant fractionne le fragment de code sélectionné en mode Code sans le modifier :
var currentDOM = dw.getDocumentDOM();
currentDOM.collapseSelectedCodeFragment(false);
dom.collapseSelectedCodeFragmentInverse()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 202
Espace de travail
Description
Fractionne toutes les portions de code avant et après le code sélectionné en mode Code.
Arguments
allowAdjustmentOfCodeFragments
• L'argument obligatoire allowAdjustmentOfCodeFragments est une valeur booléenne. Si défini sur true,
Dreamweaver ajuste les limites du code situé avant et après la sélection en cours pour effectuer un fractionnement
intelligent qui conserve la mise en retrait et l'espacement en cours. Si défini sur false, Dreamweaver fractionne le
fragment de code exactement comme indiqué par la sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant modifie puis fractionne toutes les portions de code situées avant et après le code sélectionné en
mode Code :
var currentDOM = dw.getDocumentDOM();
currentDOM.collapseSelectedCodeFragmentInverse(true);
dom.expandAllCodeFragments()
Disponibilité
Dreamweaver 8.
Description
Etend tous les fragments de code réduits en mode Code, y compris les fragments de code réduits imbriqués.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant étend toutes les portions de code réduit en mode Code :
var currentDOM = dw.getDocumentDOM();
currentDOM.expandAllCodeFragments();
dom.expandSelectedCodeFragments()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 203
Espace de travail
Description
Etend tous les fragments de code réduits dans la sélection en cours en mode Code. Si la sélection est déjà étendue, cette
fonction ne fait rien.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant étend toutes les portions de code réduit dans la sélection en cours en mode Code :
var currentDOM = dw.getDocumentDOM();
currentDOM.expandSelectedCodeFragments();
dreamweaver.htmlInspector.collapseFullTag()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si l'élément sélectionné se trouve dans une seule paire de balises d'ouverture et de fermeture
ou s'il contient une seule paire de balises d'ouverture et de fermeture dans l'inspecteur de code. Le cas échéant, la
fonction fractionne le fragment de code qui commence immédiatement avant la balise d'ouverture et se termine après
la balise de fermeture ; dans le cas contraire, elle ne fait rien.
Arguments
allowACodeFragmentAdjustment
• L'argument obligatoire allowCodeFragmentAdjustment est une valeur booléenne. Si défini sur true, cet argument
n'a aucun effet actuellement ou bien le même effet que la valeur false. Si défini sur false, Dreamweaver
fractionne le code qui commence immédiatement avant la balise d'ouverture et se termine immédiatement après la
balise de fermeture, sans le modifier.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant fractionne le fragment de code qui commence juste avant la balise d'ouverture et se termine juste
après la balise de fermeture dans la sélection en cours de l'inspecteur de code :
dreamweaver.htmlInspector.collapseFullTag(false);
dreamweaver.htmlInspector.collapseFullTagInverse()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 204
Espace de travail
Description
Cette fonction détermine si l'élément sélectionné se trouve dans une seule paire de balises d'ouverture et de fermeture
ou s'il contient une seule paire de balises d'ouverture et de fermeture dans l'inspecteur de code. Le cas échéant, elle
fractionne le code situé avant la balise d'ouverture et le code situé après la balise de fermeture ; dans le cas contraire,
elle ne fait rien.
Arguments
allowAdjustmentOfCodeFragments
• L'argument obligatoire allowAdjustmentOfCodeFragments est une valeur booléenne. Si défini sur true,
Dreamweaver ajuste les limites du code situé avant la balise de d'ouverture et du code situé après la balise de
fermeture pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement existants. Si
défini sur false, Dreamweaver fractionne le code situé avant la balise d'ouverture et le code situé après la balise de
fermeture, sans le modifier.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant effectue un fractionnement intelligent sur les sections de code qui apparaissent avant la balise
d'ouverture et après la balise de fermeture de la sélection en cours :
dreamweaver.htmlInspector.collapseFullTagInverse(true);
dreamweaver.htmlInspector.collapseSelectedCodeFragment()
Disponibilité
Dreamweaver 8.
Description
Fractionne le code sélectionné dans l'inspecteur de code. Si la sélection est déjà réduite, cette fonction ne fait rien.
Arguments
allowCodeFragmentAdjustment
• allowCodeFragmentAdjustment est une valeur booléenne obligatoire. Si défini sur true, Dreamweaver modifie la
sélection en cours pour effectuer un fractionnement intelligent et conserver la mise en retrait et l'espacement
existants. Si défini sur false, Dreamweaver fractionne le fragment de code actuellement sélectionné, exactement
comme indiqué par la sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant modifie puis fractionne le code sélectionné dans l'inspecteur de code :
dreamweaver.htmlInspector.collapseSelectedCodeFragment(true);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 205
Espace de travail
dreamweaver.htmlInspector.collapseSelectedCodeFragmentInverse()
Disponibilité
Dreamweaver 8.
Description
Cette fonction fractionne toutes les portions de code avant et après le code sélectionné dans l'inspecteur de code. Si la
sélection est déjà réduite, cette fonction ne fait rien.
Arguments
allowAdjustmentOfCodeFragments
• L'argument obligatoire allowAdjustmentOfCodeFragments est une valeur booléenne. Si défini sur true,
Dreamweaver ajuste les limites des sections de code situé avant et après la sélection en cours pour effectuer un
fractionnement intelligent qui conserve la mise en retrait et l'espacement en cours. Si défini sur false,
Dreamweaver fractionne les sections de code exactement comme indiqué par la sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant fractionne toutes les portions de code avant et après le code sélectionné dans l'inspecteur de code,
exactement comme indiqué par la sélection :
dreamweaver.htmlInspector.collapseSelectedCodeFragmentInverse(false);
dreamweaver.htmlInspector.expandAllCodeFragments()
Disponibilité
Dreamweaver 8.
Description
Etend tous les fragments de code réduits dans l'inspecteur de code, y compris les fragments de code réduits imbriqués.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant étend toutes les portions de code réduit dans l'inspecteur de code :
dreamweaver.htmlInspector.expandAllCodeFragments();
RÉFÉRENCE DES API DE DREAMWEAVER CS4 206
Espace de travail
dreamweaver.htmlInspector.expandSelectedCodeFragments()
Disponibilité
Dreamweaver 8.
Description
Etend tous les fragments de code réduits dans la sélection en cours de l'inspecteur de code. Si la sélection est déjà
étendue, cette fonction ne fait rien.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant étend toutes les portions de code réduit dans la sélection en cours de l'inspecteur de code :
dreamweaver.htmlInspector.expandSelectedCodeFragments();
Fonctions relatives aux barres d'outils du mode Code
Ces fonctions permettent d'insérer du texte, de supprimer des commentaires, d'afficher ou de masquer les caractères
spéciaux utilisés pour les espaces blancs en mode Code et d'obtenir le chemin d'accès du document actif.
Remarque : Il existe deux barres d'outils de codage, l'une pour le mode Code et l'autre pour l'inspecteur ed code. Les deux
sont personnalisées dans le ficher Configuration/Toolbars/toolbars.xml.
dom.getOpenPathName()
Disponibilité
Dreamweaver 8.
Description
Cette fonction obtient le chemin de fichier absolu du document ouvert.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui correspond au chemin de fichier absolu du document ouvert.
Exemple
L'exemple suivant assigne la chaîne contenant le chemin d'accès du document actuellement ouvert à la variable
fileName :
var fileName = dom.getOpenPathName();
RÉFÉRENCE DES API DE DREAMWEAVER CS4 207
Espace de travail
dom.getShowHiddenCharacters()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si les caractères spéciaux utilisés pour les espaces blancs sont affichés dans la fenêtre de
document en mode Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les caractères masqués sont affichés, false dans le cas contraire.
Exemple
L'exemple suivant désactive l'affichage des caractères spéciaux utilisés pour les espaces blancs lorsque l'affichage de ces
caractères est activé :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowHiddenCharacters()){
currentDOM.setShowHiddenCharacters(false);
}
dom.setShowHiddenCharacters()
Disponibilité
Dreamweaver 8.
Description
Cette fonction affiche ou masque les caractères spéciaux utilisés pour les espaces blancs dans l'inspecteur de code en
mode Code.
Voir « dom.getShowHiddenCharacters() » à la page 207 pour un exemple.
Arguments
show
• L'argument obligatoire show est une valeur booléenne qui indique s'il faut afficher les caractères masqués.
Valeurs renvoyées
Aucune.
dom.source.applyComment()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 208
Espace de travail
Description
Insère le texte spécifié dans l'argument beforeText avant la sélection en cours et le texte spécifié dans l'argument
afterText après la sélection en cours. La fonction étend ensuite la sélection en cours de manière à inclure le texte ajouté.
Cependant, s'il n'y a pas de sélection, la fonction ne sélectionne aucun élément. Si la valeur du texte spécifié dans
l'argument afterText est null, la fonction insère le texte spécifié dans l'argument beforeText au début de chaque ligne
dans la sélection en cours.
Arguments
beforeText, afterText
• L'argument beforeText est obligatoire. Il indique le texte à insérer au début de la sélection, ou, si la valeur de
l'argument afterText est null, il indique le texte à insérer au début de chaque ligne dans la sélection.
• Facultatif, l'argument afterText indique le texte à insérer à la fin de la sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant transforme la sélection en cours en un commentaire HTML :
dw.getDocumentDOM().source.applyComment('<!--', '-->')
dom.source.refreshVariableCodeHints()
Disponibilité
Dreamweaver CS3.
Description
Analyse à nouveau la page à la recherche de variables et d'associations de classe correspondantes. Cette fonction recrée
le moteur d'état des couleurs et la liste de variables.
Arguments
bSyncDoc
• Il s'agit d'une valeur booléenne. La valeur par défaut est false. Si la valeur est définie sur true, le mode Création
est synchronisé avec le mode Code.
Valeurs renvoyées
Aucune.
Exemple
dom.source.refreshVariableCodeHints();
dom.source.removeComment()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 209
Espace de travail
Description
Cette fonction supprime des commentaires. Si vous n'indiquez aucun argument, elle supprime tous les types de
commentaires de la sélection en cours, à l'exception des inclusions côté serveur et des commentaires spécifiques
Dreamweaver. En cas de commentaires imbriqués, elle supprime uniquement le commentaire externe. S'il n'y a pas de
sélection en cours, elle supprime uniquement le premier commentaire de la ligne sur laquelle se trouve le curseur. Si
vous indiquez des arguments, la fonction supprime uniquement les commentaires correspondant aux valeurs
spécifiées dans les arguments beforeText et afterText, même si les commentaires correspondants sont imbriqués dans
d'autres types de commentaires.
Arguments
beforeText, afterText
• L'argument beforeText est facultatif. Il indique le texte permettant d'identifier le début du commentaire à supprimer
dans la sélection, ou, si la valeur de l'argument afterText est null, il indique le type de commentaire de ligne à
supprimer de la sélection en cours.
• Facultatif, l'argument afterText indique le texte permettant d'identifier la fin du commentaire à supprimer dans la
sélection.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant supprime un commentaire HTML :
dw.getDocumentDOM().source.removeComment('<!--', '-->')
dreamweaver.htmlInspector.getShowHiddenCharacters()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si les caractères spéciaux utilisés pour les espaces blancs sont affichés dans l'inspecteur de
code en mode Code.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les caractères masqués sont affichés, false dans le cas contraire.
Exemple
L'exemple suivant désactive l'affichage des caractères spéciaux utilisés pour les espaces blancs dans l'inspecteur de code
lorsque l'affichage de ces caractères est activé :
if (dreamweaver.htmlinspector.getShowHiddenCharacters()){
dreamweaver.htmlinspector.setShowHiddenCharacters(false);
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 210
Espace de travail
dreamweaver.htmlInspector.setShowHiddenCharacters()
Disponibilité
Dreamweaver 8.
Description
Cette fonction affiche ou masque les caractères spéciaux utilisés pour les espaces blancs dans l'inspecteur de code en
mode Code.
Arguments
show
• L'argument obligatoire show est une valeur booléenne qui indique s'il faut afficher les caractères masqués utilisés
pour les espaces blancs.
Valeurs renvoyées
Valeur booléenne : true si les caractères masqués sont affichés, false dans le cas contraire.
Exemple
Voir « dreamweaver.htmlInspector.getShowHiddenCharacters() » à la page 209.
Fonctions des couleurs
Les fonctions des couleurs suivantes vous permettent de vérifier que les extensions possèdent le même habillage que
l'interface utilisateur de l'application.
dreamweaver.getPanelColor()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction obtient les couleurs des panneaux de l'interface utilisateur de l'application. Vous pouvez employer ces
couleurs pour les panneaux des extensions. Cette fonction vous permet de vérifier que les couleurs des panneaux des
extensions sont assorties aux couleurs des panneaux de l'interface utilisateur de l'application.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes de taille 4 avec les valeurs suivantes :
• Rouge
• Vert
• Bleu
RÉFÉRENCE DES API DE DREAMWEAVER CS4 211
Espace de travail
• Transparence Alpha
Exemple
var panelColorArray = dw.getPanelColor();
Les valeurs renvoyées pour cet exemple sont :
•
panelColorArray[0] : Rouge
•
panelColorArray[1] : Vert
•
panelColorArray[2] : Bleu
•
panelColorArray[3] : Alpha
dreamweaver.getAppBarColor()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction obtient les couleurs de la barre d'application de l'interface utilisateur. Vous pouvez employer ces
couleurs pour les barres des extensions. Cette fonction vous permet de vérifier que les couleurs des barres des
extensions sont assorties aux couleurs des barres de l'interface utilisateur de l'application.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes de taille 4 avec les valeurs suivantes :
• Rouge
• Vert
• Bleu
• Transparence Alpha
Exemple
var appBarColorArray = dw.getAppBarColor();
Les valeurs renvoyées pour cet exemple sont :
•
appBarColorArray[0] : Rouge
•
appBarColorArray[1] : Vert
•
appBarColorArray[2] : Bleu
•
appBarColorArray[3] : Alpha
212
Chapitre 13 : Site
Les fonctions relatives aux sites de Adobe® Dreamweaver® CS4 effectuent des tâches ayant trait à la gestion d'un site
Web. Il peut s'agir de personnaliser un rapport, de définir un nouveau site, d'archiver ou d'extraire des fichiers, de
valider un site, etc.
Fonctions relatives aux rapports
Ces fonctions permettent d'accéder aux fonctionnalités de création de rapports et notamment de lancer, de contrôler
et de personnaliser le processus de création de rapports. Pour plus d'informations, consultez la rubrique « Rapports »
dans l'aide Extension de Dreamweaver.
dreamweaver.isReporting()
Disponibilité
Dreamweaver 4.
Description
Vérifie si un processus de création de rapport est en cours.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si un processus est en cours d'exécution, false dans le cas contraire.
dreamweaver.showReportsDialog()
Disponibilité
Dreamweaver 4.
Description
Ouvre la boîte de dialogue Rapports.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 213
Site
Fonctions relatives aux sites
Ces fonctions permettent d'effectuer des opérations sur les fichiers de site. Elles permettent d'effectuer les tâches
suivantes :
• créer des liens entre fichiers ;
• obtenir, placer, archiver et extraire des fichiers ;
• sélectionner et désélectionner des fichiers ;
• créer et supprimer des fichiers ;
• obtenir des informations sur les sites définis par l'utilisateur ;
• importer et exporter les informations du site.
dom.getSiteURLPrefixFromDoc()
Disponibilité
Dreamweaver 8.
Description
Cette fonction obtient le préfixe de l'URL du site qui est extrait de l'adresse HTTP définie dans la section Infos locales
de la boîte de dialogue Définition du site.
Arguments
Aucun.
Valeurs renvoyées
Chaîne indiquant le préfixe de l'URL du site.
Exemple
L'exemple suivant obtient le préfixe de l'URL du site pour le document actif :
var currentDOM = dw.getDocumentDOM();
var sitePrefix = dom.getSiteURLPrefixFromDoc();
dom.localPathToSiteRelative()
Disponibilité
Dreamweaver 8.
Description
Cette fonction convertit un chemin d'accès de fichier local en une référence d'URI relative au site.
Arguments
localFilePath
• L'argument obligatoire localFilePath est une chaîne contenant le chemin d'accès à un fichier local sur votre
ordinateur local.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 214
Site
Valeurs renvoyées
Chaîne indiquant l'URI relative du site.
Exemple
L'exemple suivant renvoie "/myWebApp/myFile.cfm", en fonction de vos mappages de site et de l'adresse HTTP
spécifiée dans la section Infos locales de la boîte de dialogue Définition du site.
var siteRelativeURI = site.localPathToSiteRelative("C:\Inetpub\wwwroot\siteA\myFile.cfm")
dom.siteRelativeToLocalPath()
Disponibilité
Dreamweaver 8.
Description
Cette fonction convertit une référence d'URI relative au site en un chemin d'accès de fichier local.
Arguments
siteRelativeURI
• L'argument obligatoire siteRelativeURI est une chaîne contenant l'URI relative du site.
Valeurs renvoyées
Chaîne indiquant le chemin d'accès à un fichier local sur votre ordinateur local.
Exemple
L'exemple suivant
var filePath = siteRelativeToLocalPath("/myWebApp/myFile.xml");
renvoie "C:\Inetpub\wwwroot\siteA\myFile.xml", en fonction de vos mappages de site et de l'adresse HTTP
spécifiée dans la section Infos locales de la boîte de dialogue Définition du site.
dreamweaver.compareFiles()
Disponibilité
Dreamweaver 8.
Description
Cette fonction lance l'outil de comparaison de fichiers installé par l'utilisateur dans la section Diff de la boîte de
dialogue Préférences.
Arguments
file1, file2
• L'argument obligatoire file1 est une chaîne contenant le chemin d'accès complet au premier fichier à comparer.
• L'argument obligatoire file2 est une chaîne contenant le chemin d'accès complet au second fichier à comparer.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 215
Site
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant compare deux fichiers, red.htm et blue.htm :
dw.compareFiles(hc:\data\red.htm", "e:\data\blue.htm");
dreamweaver.loadSitesFromPrefs()
Disponibilité
Dreamweaver 4.
Description
Charge les informations du site pour tous les sites de la base de registres du système (Windows) ou du fichier de
préférences Dreamweaver (Macintosh) dans Dreamweaver. Si un site est connecté à un serveur distant lorsque cette
fonction est appelée, il est automatiquement déconnecté.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.saveSitesToPrefs()
Disponibilité
Dreamweaver 4.
Description
Enregistre toutes les informations pour chaque site que l'utilisateur a défini dans la base de registres du système
(Windows) ou le fichier de préférences Dreamweaver (Macintosh).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.siteSyncDialog.compare()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 216
Site
Description
Cette fonction exécute l'application de comparaison de fichiers spécifiée dans la Catégorie de comparaison de fichiers
de la boîte de dialogue Préférences pour comparer les fichiers sélectionnés sur les sites distants ou locaux.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.siteSyncDialog.canCompare() » à la page 488.
dreamweaver.siteSyncDialog.markDelete()
Disponibilité
Dreamweaver 8.
Description
Cette fonction bascule l'action des éléments sélectionnés sur Supprimer dans la boîte de dialogue Synchronisation du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.siteSyncDialog.canMarkDelete() » à la page 489.
dreamweaver.siteSyncDialog.markGet()
Disponibilité
Dreamweaver 8.
Description
Cette fonction bascule l'action des éléments sélectionnés sur Acquérir dans la boîte de dialogue Synchronisation du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.siteSyncDialog.canMarkGet() » à la page 489.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 217
Site
dreamweaver.siteSyncDialog.markIgnore()
Disponibilité
Dreamweaver 8.
Description
Cette fonction bascule l'action des éléments sélectionnés sur Ignorer dans la boîte de dialogue Synchronisation du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.siteSyncDialog.canMarkIgnore() » à la page 489.
dreamweaver.siteSyncDialog.markPut()
Disponibilité
Dreamweaver 8.
Description
Cette fonction bascule l'action des éléments sélectionnés sur Placer dans la boîte de dialogue Synchronisation du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.siteSyncDialog.canMarkPut() » à la page 490.
dreamweaver.siteSyncDialog.markSynced()
Disponibilité
Dreamweaver 8.
Description
Cette fonction bascule l'action des éléments sélectionnés sur Synchroniser dans la boîte de dialogue Synchronisation
du site.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 218
Site
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.siteSyncDialog.canMarkSynced() » à la page 490.
dreamweaver.siteSyncDialog.toggleShowAllFiles()
Disponibilité
Dreamweaver 8.
Description
Cette fonction permet d'afficher les fichiers que Dreamweaver considère comme identiques sur les sites distants et
locaux dans la boîte de dialogue d'aperçu Synchroniser le site. Si la fonction est appelée alors que la case à cocher
Afficher tous les fichiers est activée, elle la désactive ; inversement, si la case à cocher Afficher tous les fichiers est
désactivée, elle l'active.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.addLinkToExistingFile()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Sélectionner fichier HTML pour permettre à l'utilisateur de sélectionner un fichier, puis
crée un lien entre ce dernier et le document sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.changeLinkSitewide()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Modifier le lien au niveau du site.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 219
Site
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.changeLink()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Sélectionner fichier HTML pour permettre à l'utilisateur de sélectionner le nouveau fichier
à associer au lien.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.checkIn()
Disponibilité
Dreamweaver 3.
Description
Archive les fichiers sélectionnés et traite les fichiers dépendants de l'une des façons suivantes :
• Si l'utilisateur a activé l'option Invite lors de Placer/Archiver dans les préférences, catégorie FTP du site, la boîte de
dialogue Fichiers dépendants s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Oui, les fichiers dépendants sont téléchargés et aucune boîte de dialogue ne s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Non, les fichiers dépendants ne sont pas transmis et aucune boîte de dialogue ne s'affiche.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé "site", indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Fichiers, soit l'URL d'un fichier.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 220
Site
Activateur
Voir « site.canCheckIn() » à la page 491.
site.checkLinks()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Vérificateur de lien et vérifie les liens dans les fichiers spécifiés.
Arguments
scopeOfCheck.
• L'argument scopeOfCheck définit l'étendue de la vérification des liens. Il doit avoir pour valeur "document",
"selection" ou "site".
Valeurs renvoyées
Aucune.
site.checkOut()
Disponibilité
Dreamweaver 3.
Description
Extrait les fichiers sélectionnés et traite les fichiers dépendants de l'une des façons suivantes :
• Si l'utilisateur a activé l'option Invite lors de Acquérir/Extraire dans les préférences, catégorie FTP du site, la boîte
de dialogue Fichiers dépendants s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Oui, les fichiers dépendants sont téléchargés et aucune boîte de dialogue ne s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Non, les fichiers dépendants ne sont pas téléchargés et aucune boîte de dialogue ne s'affiche.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé "site", indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Fichiers, soit l'URL d'un fichier.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canCheckOut() » à la page 492.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 221
Site
site.checkTargetBrowsers()
Disponibilité
Dreamweaver 3.
Description
Vérifie le navigateur cible des documents sélectionnés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.cloak()
Disponibilité
Dreamweaver MX.
Description
Voile la sélection en cours dans le panneau Fichiers ou le dossier spécifié.
Arguments
siteOrURL
L'argument siteOrURL doit contenir l'une des deux valeurs suivantes :
• le mot-clé "site", qui indique si cloak() doit envelopper la sélection dans le panneau Fichiers ;
• l'URL d'un dossier particulier, qui indique si cloak() doit envelopper le dossier spécifié et tout son contenu.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canCloak() » à la page 492.
site.compareFiles()
Disponibilité
Dreamweaver 8.
Description
Cette fonction lance l'application d'intégration d'outil Diff pour comparer deux fichiers.
Arguments
url
RÉFÉRENCE DES API DE DREAMWEAVER CS4 222
Site
L'argument obligatoire url doit contenir l'une des deux valeurs suivantes :
• le mot-clé "site", qui indique si compare() doit agir sur la sélection dans le panneau Fichiers ;
• l'URL d'un fichier local à comparer avec sa version distante.
Valeurs renvoyées
Valeur booléenne : true si la comparaison a réussi, false dans le cas contraire.
Activateur
Voir « site.canCompareFiles() » à la page 493.
Exemple
L'exemple suivant compare les fichiers sélectionnés dans le panneau Fichiers avec leurs versions distantes :
site.compareFiles("site");
site.defineSites()
Disponibilité
Dreamweaver 3.
Description
La fonction ouvre la boîte de dialogue Définition du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.deleteSelection()
Disponibilité
Dreamweaver 3.
Description
Supprime les fichiers sélectionnés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 223
Site
site.deployFilesToTestingServerBin()
Disponibilité
Dreamweaver MX.
Description
Place le ou les fichiers spécifiés dans le dossier bin du serveur d'évaluation. Si aucun paramètre relatif au déploiement
des fichiers de prise en charge n'est défini pour le site en cours, cette fonction lance la boîte de dialogue Déployer les
fichiers de prise en charge sur le serveur d'évaluation.
Arguments
filesToDeploy
• L'argument filesToDeploy correspond à un tableau de noms de fichiers que Dreamweaver déploiera.
Valeurs renvoyées
Valeur booléenne, true si le déploiement des fichiers a réussi et false dans le cas contraire.
Exemple
Cet exemple déploie les fichiers image1.jpg et script1.js dans le dossier bin du serveur d'évaluation :
site.deployFilesToTestingServerBin("image1.jpg", "script1.js");
site.displaySyncInfoForFile()
Disponibilité
Dreamweaver CS3.
Description
Présente une boîte de dialogue contenant les heures d'évaluation, locales et distantes, du fichier correspondant au
paramètre transmis. Ces informations sont stockées dans le fichier de synchronisation dwsync.xml.
La boîte de dialogue affiche quatre heures différentes :
• L'heure locale ordinateur distant, qui indique pour le fichier local, l'horodatage de la dernière commande placer ou
acquérir sur le serveur distant.
• L'heure distante, qui indique pour le fichier situé sur le serveur distant, l'horodatage de la dernière commande
acquérir ou placer sur le serveur distant.
• L'heure locale ordinateur de test, qui indique pour le fichier local, l'horodatage de la dernière commande placer ou
acquérir sur le serveur d'évaluation.
• L'heure de test, qui indique pour le fichier situé sur le serveur d'évaluation, l'horodatage de la dernière commande
acquérir ou placer sur le serveur d'évaluation.
Si le fichier dwsync.xml ne contient pas d'informations pour le fichier, un message s'affiche et indique qu'aucune
information n'est disponible. Si l'heure est définie dans le fichier XML, elle s'affiche au format date/heure
correspondant aux paramètres régionaux (par exemple, 24/6/05 14:43). Si l'heure n'est pas définie dans l'entrée
correspondant au fichier, un tiret (-) est affiché.
Cette fonction agit sur le fichier sélectionné dans l'affichage local des fichiers, si 'site' est transmis, ou sur le fichier
correspondant à l'URL locale, si une URL est transmise.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 224
Site
Arguments
path, 'site'
• path est l'URL pointant vers un fichier local.
• 'site' indique que la fonction utilise le fichier sélectionné dans le panneau Fichiers.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canDisplaySyncInfoForFile() » à la page 493.
site.editColumns()
Description
Cette fonction affiche la boîte de dialogue Définition du site, qui contient la section Colonnes en mode Fichier.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.exportSite()
Disponibilité
Dreamweaver MX, mis à jour dans Dreamweaver CS4.
Description
Exporte un site Dreamweaver dans un fichier XML, qui peut être importé dans une autre instance de Dreamweaver
pour permettre la duplication du site.
Toutes les informations contenues dans la boîte de dialogue Définition du site sont enregistrées dans un fichier XML
qui comprend la liste des dossiers voilés et des informations sur le type de document par défaut. La seule exception est
que l'utilisateur peut omettre le nom et le mot de passe de connexion lorsque l'accès FTP est défini.
Arguments
siteName, {askAboutLoginInfo}, {warnAboutSCS}, {savePath}
• L'argument siteName identifie le site à exporter. Si siteName est une chaîne vide, Dreamweaver exporte le site en
cours.
• L'argument askAboutLoginInfo détermine si une boîte de dialogue demande à l'utilisateur s'il veut enregistrer ses
informations de connexion. Cet argument est facultatif.
• L'argument warnAboutSCS permet de déterminer si l'utilisateur est ou non averti du non-enregistrement des
informations de connexion s'il accède à son site via le contrôle de source. Cet argument est facultatif.
• L'argument savePath est le chemin local à un dossier (par exemple C:\sites\mySites\). Si vous fournissez une
valeur savePath, le fichier .ste est toujours enregistré avec le nom du site. Cet argument est facultatif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 225
Site
Valeurs renvoyées
Valeur booléenne : true si le site nommé existe et si le fichier XML est correctement exporté, et false dans le cas
contraire.
Exemple
L'exemple suivant présente un fichier XML créé par Dreamweaver lors de l'exportation d'un site :
<?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"
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"
localwidth="36" remotewidth="36" />
<column name="Size"
align="right" show="TRUE" share="FALSE" builtin="TRUE"
localwidth="-2" remotewidth="-2" />
<column name="Type"
align="left" show="TRUE" share="FALSE" builtin="TRUE"
localwidth="60" remotewidth="60" />
<column name="Modified"
align="left" show="TRUE" share="FALSE" builtin="TRUE"
localwidth="102" remotewidth="102" />
<column name="Checked Out By"
align="left" show="TRUE" share="FALSE" builtin="TRUE"
localwidth="50" remotewidth="50" />
<column name="Status" note="status"
align="left" show="TRUE" share="FALSE" builtin="FALSE"
RÉFÉRENCE DES API DE DREAMWEAVER CS4 226
Site
localwidth="50" remotewidth="50" />
</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.get()
Disponibilité
Dreamweaver 3.
Description
Obtient les fichiers spécifiés et traite les fichiers dépendants comme suit :
• Si l'utilisateur a activé l'option Invite lors de Acquérir/Extraire dans les préférences, catégorie FTP du site, la boîte
de dialogue Fichiers dépendants s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Oui, les fichiers dépendants sont téléchargés et aucune boîte de dialogue ne s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Non, les fichiers dépendants ne sont pas téléchargés et aucune boîte de dialogue ne s'affiche.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé "site", indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Fichiers, soit l'URL d'un fichier.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canGet() » à la page 494.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 227
Site
site.getAppServerAccessType()
Disponibilité
Dreamweaver MX.
Description
Renvoie la méthode d'accès utilisée pour tous les fichiers sur le serveur d'application du en cours. Le site en cours est
le site associé au document actuellement activé. Si aucun document n'est activé, le site ouvert dans Dreamweaver est
utilisé.
Remarque : ColdFusion Component Explorer utilise cette fonction ; voir « site.getAppServerPathToFiles() » à la page 227
et « site.getLocalPathToFiles() » à la page 230.
Arguments
Aucun.
Valeurs renvoyées
L'une des chaînes suivantes :
•
"none"
•
"local/network"
•
"ftp"
•
"source_control"
site.getAppServerPathToFiles()
Disponibilité
Dreamweaver MX.
Description
Détermine le chemin d'accès aux fichiers distants sur le serveur d'application défini pour le site en cours. Le site en
cours est le site associé au document actuellement activé. Si aucun document n'est activé, le site ouvert dans
Dreamweaver est utilisé.
Remarque : ColdFusion Component Explorer utilise cette fonction ; voir « site.getAppServerAccessType() » à la page 227
et « site.getLocalPathToFiles() » à la page 230.
Arguments
Aucun.
Valeurs renvoyées
Si le type d'accès au serveur d'application est local/network, cette fonction renvoie un chemin ; dans le cas contraire,
cette fonction renvoie une chaîne vide.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 228
Site
site.getAppURLPrefixForSite()
Disponibilité
Dreamweaver MX.
Description
Renvoie la valeur du préfixe de l'URL qui est extraite de l'adresse HTTP définie dans la section Infos locales de la boîte
de dialogue de définition du site. Il s'agit du chemin figurant après http://nom_hôte:numéro_port/.
Arguments
{siteName}
L'argument siteName (facultatif) est le nom du site dont vous souhaitez obtenir le préfixe d'URL. Si vous n'indiquez
pas de site, la fonction obtient le préfixe d'URL du site en cours.
Valeurs renvoyées
Une chaîne contenant le préfixe d'URL du site sélectionné.
Exemple
var sitePrefix = site.getAppURLPrefixForSite();
site.getCheckOutUser()
Disponibilité
Dreamweaver 3.
Description
Obtient les noms d'utilisateur et d'extraction associés au site en cours.
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant un nom d'utilisateur et un nom d'extraction, s'ils sont définis, ou une chaîne vide si les fonctions
d'archivage et d'extraction sont désactivées.
Exemple
Un appel à la fonction site.getCheckOutUser() pourrait renvoyer "denise (deniseLaptop)". Si aucun nom
d'extraction n'est spécifié, seul le nom d'utilisateur est renvoyé ("denise", par exemple).
site.getCheckOutUserForFile()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 229
Site
Description
Obtient le nom d'utilisateur et le nom d'extraction de l'utilisateur qui a extrait le fichier spécifié.
Arguments
fileName
• L'argument fileName correspond au chemin d'accès au fichier interrogé, exprimé sous la forme d'une URL de type
file://.
Valeurs renvoyées
Chaîne contenant le nom d'utilisateur et le nom d'extraction de l'utilisateur qui a extrait le fichier spécifié, ou chaîne
vide si le fichier n'a pas été extrait.
Exemple
Un appel à la fonction site.getCheckOutUserForFile("file://C:/sites/avocado8/index.html") pourrait
renvoyer "denise (deniseLaptop)". Si aucun nom d'extraction n'est spécifié, seul le nom d'utilisateur est renvoyé
("denise", par exemple).
site.getCloakingEnabled()
Disponibilité
Dreamweaver MX.
Description
Détermine si le voilage est activé pour le site en cours.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le voilage est activé pour le site en cours et false dans le cas contraire.
site.getConnectionState()
Disponibilité
Dreamweaver 3.
Description
Obtient l'état de connexion en cours.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si le site distant est connecté.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 230
Site
Activateur
Voir « site.canConnect() » à la page 493.
site.getCurrentSite()
Disponibilité
Dreamweaver 3.
Description
Obtient le site en cours.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient le nom du site en cours.
Exemple
Si plusieurs sites sont définis, un appel à la fonction site.getCurrentSite() renvoie celui qui est actuellement
affiché dans la liste des sites en cours du panneau Fichiers.
site.getFocus()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Détermine quel volet du panneau Fichiers est activé.
Arguments
Aucun.
Valeurs renvoyées
L'une des chaînes suivantes, locales ou distantes.
site.getLocalPathToFiles()
Disponibilité
Dreamweaver MX.
Description
Détermine le chemin d'accès aux fichiers locaux définis pour le site en cours. Le site en cours est le site associé au
document actuellement activé. Si aucun document n'est activé, le site ouvert dans Dreamweaver est utilisé.
Remarque : ColdFusion Component Explorer utilise cette fonction ; voir « site.getAppServerAccessType() » à la page 227
et « site.getAppServerPathToFiles() » à la page 227.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 231
Site
Arguments
Aucun.
Valeurs renvoyées
Chemin d'accès aux fichiers qui résident sur l'ordinateur local pour le site en cours.
site.getLocalRootURL()
Disponibilité
Dreamweaver CS4.
Description
Obtient le dossier racine local du site.
Arguments
siteName
• L'argument siteName est une chaîne qui spécifie le nom du site.
Valeurs renvoyées
Chaîne contenant le dossier racine local du site nommé, exprimé sous la forme d'une URL file://. La chaîne est vide
lorsque le fichier spécifié n'existe pas.
site.getSelection()
Disponibilité
Dreamweaver 3.
Description
Détermine quels sont les fichiers actuellement sélectionnés dans le panneau Fichiers.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes représentant les chemins d'accès aux fichiers et dossiers sélectionnés, exprimé sous la forme d'une
URL de type file://, ou d'un tableau vide si aucun fichier ni dossier n'est sélectionné.
site.getSiteForURL()
Disponibilité
Dreamweaver MX.
Description
Obtient le nom du site, s'il en a un, associé à un fichier donné.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 232
Site
Arguments
fileURL
• L'argument fileURL est l'URL complète (y compris la chaîne "file://") d'un fichier nommé.
Valeurs renvoyées
Chaîne qui contient le nom du site, s'il en a un, dans lequel réside le fichier spécifié. La chaîne est vide lorsque le fichier
spécifié n'existe dans aucun site défini.
site.getSites()
Disponibilité
Dreamweaver 3.
Description
Obtient la liste des sites définis.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes représentant les noms des sites définis, ou tableau vide si aucun site n'est défini.
site.getSiteRootForURL()
Disponibilité
Dreamweaver CS4.
Description
Obtient le dossier racine local du site associé à une URL de fichier spécifique.
Arguments
fileURL
• L'argument fileURL est une chaîne contenant l'URL complète (y compris la chaîne file://) d'un fichier nommé.
Valeurs renvoyées
Chaîne contenant le dossier racine local du site, exprimé sous la forme d'une URL file://, où le fichier spécifié existe.
La chaîne est vide lorsque le fichier spécifié n'existe dans aucun site défini.
Exemple
var dom = dw.getDocumentDOM();
var siteRoot = site.getSiteRootForURL(dom.URL);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 233
Site
site.getSiteURLPrefix()
Disponibilité
Dreamweaver 8.
Description
Obtient le préfixe de l'URL qui est extrait de l'adresse HTTP définie dans la section Infos locales.
Arguments
Aucun.
Valeurs renvoyées
Chaîne contenant le préfixe de l'URL du site.
Exemple
sitePrefix = getSiteURLPrefix();
site.importSite()
Disponibilité
Dreamweaver MX.
Description
Crée un site Dreamweaver à partir d'un fichier XML. Dreamweaver emploie l'attribut localroot de l'élément
<localinfo> pour identifier le dossier racine local du site. Pendant l'importation, si ce dossier n'existe pas sur
l'ordinateur local, Dreamweaver demande un dossier racine local différent. Dreamweaver se comporte de la même
façon lorsqu'il tente de trouver le dossier images par défaut, spécifié par l'attribut imagefolder de l'élément
<localinfo>.
Arguments
pathToSteFile
• L'argument pathToSteFile est une chaîne qui contient l'URL du fichier STE. Dreamweaver utilise ce fichier pour
créer un site. Si pathToSteFile est une chaîne vide, Dreamweaver invite l'utilisateur à choisir un fichier STE à
importer.
Valeurs renvoyées
Valeur booléenne : true si le fichier STE nommé existe et si la création du site réussit et false dans le cas contraire.
site.isCloaked()
Disponibilité
Dreamweaver MX.
Description
Détermine si la sélection en cours dans le panneau Fichiers ou le dossier spécifié est voilé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 234
Site
Arguments
siteOrURL
• L'argument siteOrURL doit contenir l'une des deux valeurs suivantes :
• le mot clé "site", qui indique que la fonction isCloaked() doit tester la sélection dans le panneau Fichiers ;
• l'URL de fichier d'un dossier particulier, qui indique si isCloaked() doit tester le dossier spécifié.
Valeurs renvoyées
Valeur booléenne, true si l'objet indiqué est voilé, false dans le cas contraire.
site.locateInSite()
Disponibilité
Dreamweaver 3.
Description
Recherche le ou les fichiers indiqués dans le volet spécifié du panneau Fichiers et sélectionne les fichiers.
Arguments
localOrRemote, siteOrURL.
• L'argument localOrRemote doit avoir la valeur "local" ou "remote".
• L'argument siteOrURL doit être soit le mot clé "site", indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Fichiers, soit l'URL d'un fichier.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canLocateInSite() » à la page 494.
site.makeEditable()
Disponibilité
Dreamweaver 3.
Description
Désactive le drapeau de lecture seule sur les fichiers sélectionnés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 235
Site
Activateur
Voir « site.canMakeEditable() » à la page 495.
site.makeNewDreamweaverFile()
Disponibilité
Dreamweaver 3.
Description
Crée un nouveau fichier Dreamweaver dans le panneau Fichiers (dans le même dossier que le premier fichier ou
dossier sélectionné).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canMakeNewFileOrFolder() » à la page 495.
site.makeNewFolder()
Disponibilité
Dreamweaver 3.
Description
Crée un nouveau dossier dans le panneau Fichiers (dans le même dossier que le premier fichier ou dossier sélectionné).
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canMakeNewFileOrFolder() » à la page 495.
site.newSite()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Définition du site pour définir un nouveau site.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 236
Site
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.open()
Disponibilité
Dreamweaver 3.
Description
Ouvre les fichiers actuellement sélectionnés dans le panneau Fichiers. Si des dossiers sont sélectionnés, ils sont
développés dans l'affichage Fichiers du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canOpen() » à la page 495.
site.put()
Disponibilité
Dreamweaver 3.
Description
Place les fichiers spécifiés et traite les fichiers dépendants comme suit :
• Si l'utilisateur a activé l'option Invite lors de Placer/Archiver dans les préférences, catégorie FTP du site, la boîte de
dialogue Fichiers dépendants s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Oui, les fichiers dépendants sont téléchargés et aucune boîte de dialogue ne s'affiche.
• Si l'utilisateur a activé l'option Ne plus afficher ce message dans la boîte de dialogue Fichiers dépendants, puis qu'il
a cliqué sur Non, les fichiers dépendants ne sont pas transmis et aucune boîte de dialogue ne s'affiche.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé "site", indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Fichiers, soit l'URL d'un fichier.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 237
Site
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canPut() » à la page 496.
site.recreateCache()
Disponibilité
Dreamweaver 3.
Description
Recrée le cache du site en cours.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canRecreateCache() » à la page 496.
site.refresh()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Actualise la liste des fichiers sur le côté spécifié du panneau Fichiers.
Arguments
whichSide
• L'argument whichSide doit avoir pour valeur local ou remote.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canRefresh() » à la page 497.
site.remoteIsValid()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 238
Site
Description
Détermine si le site distant est valide.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne qui indique si un site distant a été défini et, dans le cas où le type de serveur est Local/Réseau, si le
lecteur est monté.
site.renameSelection()
Disponibilité
Dreamweaver 3.
Description
Transforme le nom du fichier sélectionné en champ de texte et permet à l'utilisateur de renommer le fichier. Si
plusieurs fichiers sont sélectionnés, cette fonction agit sur le dernier.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.runValidation()
Disponibilité
Dreamweaver MX.
Description
Exécute le validateur sur la totalité du site ou uniquement sur les éléments mis en surbrillance.
Arguments
sélection
• L'argument selection est le paramètre qui spécifie que le validateur doit vérifier les éléments mis en surbrillance
uniquement ; dans le cas contraire, le validateur vérifie l'ensemble du site en cours.
Valeurs renvoyées
Aucune.
site.selectAll()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 239
Site
Description
Sélectionne tous les fichiers dans la vue active.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
site.selectNewer()
Disponibilité
Dreamweaver 3.
Description
Sélectionne tous les fichiers les plus récents sur le côté spécifié du panneau Fichiers.
Arguments
whichSide.
• L'argument whichSide doit avoir pour valeur "local" ou "remote".
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canSelectNewer() » à la page 497.
site.serverActivity()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si Dreamweaver est en train d'interagir avec un serveur. Dreamweaver ne peut effectuer
qu'une seule activité de serveur à la fois, cette fonction vous permet donc de déterminer s'il faut désactiver la
fonctionnalité exigeant une interaction du serveur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si Dreamweaver est en train d'interagir avec un serveur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 240
Site
Exemple
L'exemple suivant, extrait du fichier menus.xml, affiche un élément de menu s'il n'y a pas d'activité du serveur (et si un
site est actuellement spécifié dans Dreamweaver) :
<menuitem name="Remove Connection Scripts" enabled="!site.serverActivity() &&
site.getCurrentSite() != ''" command="alert(MMDB.removeConnectionScripts())"
id="SiteOptionsSiteMenu_RemoveConnectionScripts" />
site.setCloakingEnabled()
Disponibilité
Dreamweaver MX.
Description
Détermine s'il est nécessaire d'activer le voilage pour le site en cours.
Arguments
enable
• L'argument enable est une valeur booléenne qui indique s'il est nécessaire d'activer le voilage. Une valeur true
active le voilage pour le site en cours ; une valeur false désactive le voilage pour le site en cours.
Valeurs renvoyées
Aucun.
site.setConnectionState()
Disponibilité
Dreamweaver 3.
Description
Définit l'état de connexion du site en cours.
Arguments
bConnected.
• L'argument bConnected est une valeur booléenne qui indique s'il existe une connexion (true) ou non (false) au
site en cours.
Valeurs renvoyées
Aucune.
site.setCurrentSite()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 241
Site
Description
Ouvre le site spécifié dans le volet local du panneau Fichiers.
Arguments
whichSite
• L'argument whichSite est le nom d'un site défini (tel qu'il apparaît dans la liste des sites en cours, dans le panneau
Fichiers ou dans la boîte de dialogue Définition du site).
Valeurs renvoyées
Aucune.
Exemple
Si trois sites sont définis (avocado8, dreamcentral et testsite, par exemple), un appel à la fonction
site.setCurrentSite("dreamcentral") fait de dreamcentral le site en cours.
site.setFocus()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Active le volet spécifié du panneau Fichiers. Si le volet spécifié n'est pas affiché, la fonction l'affiche et l'active.
Arguments
whichPane, nextTextView
• L'argument whichPane doit correspondre à l'une des chaînes suivantes : local ou remote.
• L'argument nextTextView alterne les modes actifs en mode d'affichage fractionné.
Valeurs renvoyées
Aucune.
site.setSelection()
Disponibilité
Dreamweaver 3.
Description
Sélectionne les fichiers ou les dossiers visibles dans le volet actif du panneau Fichiers.
Arguments
arrayOfURLs
• L'argument arrayOfURLs est un tableau de chaînes correspondant aux chemins d'accès aux fichiers et aux dossiers
du site sélectionné, exprimés sous la forme d'une URL de type file://.
Remarque : Pour les chemins de dossier, ne tapez pas la barre oblique (/) à la fin du chemin.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 242
Site
Valeurs renvoyées
Aucune.
site.siteRelativeToLocalPath()
Disponibilité
Dreamweaver 8.
Description
Convertit une référence d'URI relative de site en un chemin d'accès de fichier local.
Arguments
siteRelativeURI
• L'argument obligatoire siteRelativeURI est une chaîne contenant l'URI relative du site.
Valeurs renvoyées
Chaîne indiquant le chemin d'accès à un fichier local sur votre ordinateur local.
Exemple
L'exemple suivant
var filePath = site.siteRelativeToLocalPath("/myWebApp/myFile.xlml");
renvoie "C:\Inetpub\wwwroot\siteA\myFile.xml", en fonction de vos mappages de site et de l'adresse HTTP spécifiée
dans la section Infos locales de la boîte de dialogue Définition du site.
site.synchronize()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Synchroniser les fichiers.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canSynchronize() » à la page 498.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 243
Site
site.uncloak()
Disponibilité
Dreamweaver MX.
Description
Dévoile la sélection en cours dans le panneau Fichiers ou le dossier spécifié.
Arguments
siteOrURL
• L'argument siteOrURL doit contenir l'une des valeurs suivantes :
• le mot clé "site", qui indique que la fonction unCloak() doit agir sur la sélection dans le panneau Fichiers ;
• l'URL d'un dossier particulier, qui indique que la fonction unCloak() doit agir sur le dossier spécifié et tout son
contenu.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canUncloak() » à la page 498.
site.uncloakAll()
Disponibilité
Dreamweaver MX.
Description
Dévoile tous les dossiers dans le site sélectionné et désactive la case à cocher Voiler les fichiers se terminant avec : dans
les Paramètres de voilage.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canUncloak() » à la page 498.
site.undoCheckOut()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 244
Site
Description
Retire des sites locaux et distants les fichiers verrouillés associés aux fichiers sélectionnés et remplace leur copie locale
par la copie distante.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé "site", indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Fichiers, soit l'URL d'un fichier.
Valeurs renvoyées
Aucune.
Activateur
Voir « site.canUndoCheckOut() » à la page 498.
245
Chapitre 14 : Document
Les fonctions Document de Adobe® Dreamweaver® permettent d'effectuer des opérations dans le document modifié
par l'utilisateur. Les fonctions de document permettent d'effectuer les opérations suivantes :
• Conversion de tableaux en calques
• Exécution d'une commande dans le dossier Configuration/Commands
• Recherche d'une URL de fichier
• Conversion d'une URL relative en URL absolue
• Obtention du nœud sélectionné
• Réalisation d'un codage d'URL sur une chaîne
• Exécution d'un traducteur sur le document
Fonctions relatives aux conversions
Ces fonctions permettent de convertir des tableaux en calques, des calques en tableaux et des feuilles de style en cascade
(CSS) en balises HTML. Chacune de ces fonctions se comporte exactement comme une commande de conversion du
menu Fichier ou Modifier.
dom.convertLayersToTable()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Convertir les calques en tableau.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canConvertLayersToTable() » à la page 465.
dom.convertTablesToLayers()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 246
Document
Description
Ouvre la boîte de dialogue Convertir les tableaux en calques.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canConvertTablesToLayers() » à la page 465.
Fonctions relatives aux commandes
Ces fonctions permettent de tirer parti des fichiers figurant dans le dossier Configuration/Commands. Elles
permettent de gérer le menu Commandes et d'appeler des commandes à partir d'autres types de fichiers d'extension.
dreamweaver.editCommandList()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Modifier la liste de commandes.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.runCommand()
Disponibilité
Dreamweaver 3.
Description
Exécute la commande spécifiée ; cette fonction équivaut à choisir la commande dans un menu. Si une boîte de dialogue
est associée à la commande, elle apparaît et le script de la commande bloque les autres modifications jusqu'à ce que
l'utilisateur ferme la boîte de dialogue. Cette fonction permet d'appeler une commande à partir d'un autre fichier
d'extension.
Remarque : Cette fonction peut être appelée à partir de la fonction objectTag(), d'un script de fichier de commande ou
du fichier d'inspecteur Propriétés.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 247
Document
Arguments
commandFile, {commandArg1}, {commandArg2},...{commandArgN}
• L'argument commandFile est un nom de fichier dans le dossier Configuration/Commands.
• Les autres arguments (commandArg1, commandArg2, etc.) sont facultatifs. Ils sont transmis à la fonction
receiveArguments() dans l'argument commandFile.
Valeurs renvoyées
Aucune.
Exemple
Vous pouvez créer un inspecteur Propriétés personnalisé pour les tableaux. Il permettra à l'utilisateur d'accéder à la
commande Formater le tableau à l'aide d'un bouton de l'inspecteur. Pour ce faire, appelez la fonction suivante à partir
du gestionnaire d'événements onClick de ce bouton :
function callFormatTable(){
dreamweaver.runCommand('Format Table.htm');
}
Fonctions relatives aux manipulations de fichiers
Ces fonctions permettent de créer, d'ouvrir et d'enregistrer des documents (y compris XML et XHTML), de convertir
des documents HTML existants en XHTML et d'exporter des styles CSS vers des fichiers externes. Elles permettent
également de rechercher des fichiers ou des dossiers, de créer des fichiers à partir de modèles, de fermer des documents
et d'obtenir la liste des fichiers récemment ouverts.
dom.cleanupXHTML()
Disponibilité
Dreamweaver MX.
Description
Cette fonction est similaire à la fonction convertToXHTML(), à ceci près que celle-ci nettoie un document XHTML
existant. Cette fonction peut être exécutée sur une sélection à l'intérieur du document. Vous pouvez utiliser la fonction
cleanupXHTML() pour nettoyer la syntaxe dans l'ensemble d'un document XHTML ou dans la sélection en cours à
l'intérieur du document.
Arguments
bWholeDoc
• L'argument bWholeDoc contient une valeur booléenne. Si la valeur est true, la fonction cleanupXHTML() nettoie
l'ensemble du document ; dans le cas contraire, elle nettoie uniquement la sélection.
Valeurs renvoyées
Un tableau de six nombres entiers qui quantifient le nombre d'éléments suivants :
• erreurs XHTML réparées par Dreamweaver
• les éléments map ne disposant pas d'un attribut id et ne pouvant pas être résolus ;
RÉFÉRENCE DES API DE DREAMWEAVER CS4 248
Document
• les éléments script ne disposant pas d'un attribut type et ne pouvant pas être résolus ;
• les éléments style ne disposant pas d'un attribut type et ne pouvant pas être résolus ;
• les éléments img ne disposant pas d'un attribut alt et ne pouvant pas être résolus ;
• les éléments area ne disposant pas d'un attribut alt et ne pouvant pas être résolus.
dom.convertToXHTML()
Disponibilité
Dreamweaver MX.
Description
Analyse le code HTML dans une arborescence DOM, insère les éléments manquants qui sont obligatoires pour
XHTML, nettoie l'arborescence puis écrit celle-ci au format XHTML. Les directives, déclarations, éléments et attributs
manquants que la fonction convertToXHTML() ajoute à l'arborescence DOM si nécessaire, incluent les éléments
suivants :
• Une directive XML
• Une déclaration doctype
• L'attribut xmlns dans l'élément html
• Une section head
• Un élément title
• Une section body
Pendant la conversion, la fonction dom.convertToXHTML() convertit les balises et les attributs HTML purs en
minuscules, écrit des balises et des attributs HTML à l'aide d'une syntaxe XHTML correcte et ajoute des attributs
HTML manquants où cela est possible. Cette fonction traite les balises et les attributs tiers en fonction des paramètres
de la boîte de dialogue Préférences.
Si le document est un modèle, la fonction dom.convertToXHTML() alerte l'utilisateur mais n'effectue pas la
conversion.
Arguments
Aucun.
Valeurs renvoyées
Un tableau de six nombres entiers qui quantifient le nombre d'éléments suivants :
• erreurs XHTML réparées par Dreamweaver
• les éléments map ne disposant pas d'un attribut id et ne pouvant pas être résolus ;
• les éléments script ne disposant pas d'un attribut type et ne pouvant pas être résolus ;
• les éléments style ne disposant pas d'un attribut type et ne pouvant pas être résolus ;
• les éléments img ne disposant pas d'un attribut alt et ne pouvant pas être résolus ;
• les éléments area ne disposant pas d'un attribut alt et ne pouvant pas être résolus.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 249
Document
Exemple
Dans le cadre d'une utilisation normale, une extension appelle d'abord la fonction dreamweaver.openDocument() ou
dreamweaver.getDocumentDOM() pour obtenir une référence au document. L'extension appelle ensuite la fonction
dom.getIsXHTMLDocument() pour déterminer si le document est déjà au format XHTML. Si ce n'est pas le cas, l'extension
appelle la fonction dom.convertToXHTML() pour convertir le document au format XHTML. Ensuite, l'extension appelle
la fonction dreamweaver.saveDocument() pour enregistrer le fichier converti sous un nouveau nom.
dom.getIsXHTMLDocument()
Disponibilité
Dreamweaver MX.
Description
Vérifie un document (en particulier la déclaration <!DOCTYPE>) pour savoir si celui-ci est au format XHTML.
Arguments
Aucun.
Valeurs renvoyées
true si le document est au format XHTML, false dans le cas contraire.
dreamweaver.browseForFileURL()
Disponibilité
Dreamweaver 1, améliorée dans les versions 2, 3 et 4.
Description
Ouvre le type de boîte de dialogue spécifié ayant le libellé spécifié dans la barre de titre.
Arguments
openSelectOrSave, {titleBarLabel}, {bShowPreviewPane}, {bSupressSiteRootWarnings},
{arrayOfExtensions}, {startFolder}, {allowDynamic}, {fileToLocate}
• L'argument openSelectOrSave indique le type de boîte de dialogue : open, select ou save.
• L'argument titleBarLabel, ajouté à Dreamweaver 2, est le libellé qui doit figurer dans la barre de titre de la boîte
de dialogue. Si cet argument n'est pas défini, Dreamweaver utilise par défaut le libellé fourni par le système
d'exploitation.
• L'argument bShowPreviewPane, ajouté à Dreamweaver 2, est une valeur booléenne indiquant si le volet d'aperçu
de l'image doit être affiché dans la boîte de dialogue. Si la valeur de cet argument est true, la boîte de dialogue filtre
les fichiers d'image ; si elle est omise, l'argument prend par défaut la valeur false.
• L'argument bSupressSiteRootWarnings, ajouté à Dreamweaver 3, est une valeur booléenne indiquant s'il faut
supprimer les avertissements signalant que le fichier sélectionné se trouve hors du dossier racine du site. Si cet
argument n'est pas défini, il prend par défaut la valeur false.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 250
Document
• L'argument arrayOfExtensions (ajouté dans Dreamweaver 4) est un tableau de chaînes. Il définit le contenu par
défaut de la liste Types de fichiers qui s'affiche dans le bas de la boîte de dialogue. La syntaxe de cet argument est
menuEntryText|.xxx[;.yyy;.zzz]|CCCC|, où :
•
menuEntryText est le nom du type de fichier.
• Vous pouvez définir les extensions sous la forme .xxx[;.yyy;.zzz] ou CCCC :
•
.xxx spécifie l'extension de nom de fichier pour le type de fichier. .yyy et .zzz permettent de spécifier
plusieurs extensions de nom de fichier.
•
CCCC est la constante de type de fichiers à quatre caractères pour Macintosh.
L'exemple suivant fournit deux filtres dans votre boîte de dialogue de sélection, l'un pour les fichiers MP3 et l'autre
pour tous les fichiers :
dw.browseForFileURL("select", "Please select an mp3",false, true, new Array("mp3 Files
(*.MP3)|*.mp3||","All Files (*.*)|*.*||"));
• L'argument startfolder est une valeur de chaîne qui permet de spécifier l'URL de fichier du dossier dans lequel
la recherche débute. Si cet argument n'est pas spécifié, la recherche débute à partir du dernier répertoire utilisé. Cet
argument est facultatif.
• L'argument allowdynamic est une valeur booléenne qui indique si les URL et les paramètres dynamiques sont
autorisés ou non. Si cet argument a la valeur true, les URL et les paramètres dynamiques sont autorisés. Cet
argument est facultatif.
• L'argument fileToLocate est une valeur de chaîne qui sert à spécifier l'URL du fichier que vous voulez trouver.
Cet argument est facultatif.
Valeurs renvoyées
Une chaîne contenant le nom du fichier, exprimé sous la forme d'une URL de type file://.
dreamweaver.browseForFolderURL()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Choisir un dossier ayant le libellé spécifié dans la barre de titre.
Arguments
{titleBarLabel}, {directoryToStartIn}
• L'argument titleBarLabel est le libellé qui doit s'afficher dans la barre de titre de la boîte de dialogue. S'il n'est pas
spécifié, l'argument titleBarLabel prend par défaut la valeur Choose folder (Choisir un dossier).
• L'argument directoryToStartIn est le chemin indiquant où le dossier doit s'ouvrir, exprimé sous la forme d'une URL
de type file://.
Valeurs renvoyées
Une chaîne contenant le nom du dossier, exprimé sous la forme d'une URL de type file://.
Exemple
Le code suivant renvoie l'URL d'un dossier :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 251
Document
return dreamweaver.browseForFolderURL('Select a Folder', ¬
dreamweaver.getSiteRoot());
dreamweaver.closeDocument()
Disponibilité
Dreamweaver 2.
Description
Ferme le document spécifié.
Arguments
documentObject.
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document (c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM()). Si l'argument documentObject fait
référence au document actif, il se peut que la fenêtre du document ne se ferme pas tant que l'exécution du script qui
appelle cette fonction n'est pas terminée.
Valeurs renvoyées
Aucune.
dreamweaver.createDocument()
Disponibilité
Dreamweaver 2, améliorée dans Dreamweaver 4.
Description
En fonction de l'argument utilisé, cette fonction ouvre un nouveau document soit dans la même fenêtre, soit dans une
nouvelle fenêtre. Le nouveau document devient le document actif.
Remarque : Cette fonction peut être appelée uniquement à partir du fichier menus.xml, d'un fichier de commande ou
depuis le fichier de l'inspecteur Propriétés. Si une action ou un objet tente d'appeler cette fonction, Dreamweaver affiche
un message d'erreur.
Arguments
{bOpenInSameWindow}, {type}
• L'argument bOpenInSameWindow est une valeur booléenne indiquant si le nouveau document doit s'ouvrir dans
la fenêtre en cours. Si l'argument bOpenInSameWindow a pour valeur false, qu'il n'est pas précisé ou que la
fonction est appelée sur Macintosh, le nouveau document s'ouvre dans une nouvelle fenêtre.
• L'argument type indique le type de document à créer, conformément à ce qui a été déclaré dans le fichier
Configuration/DocumentTypes/MMDocumentTypes.xml de Dreamweaver dans l'attribut id de la balise
documenttype. L'argument type peut par exemple avoir la valeur "HTML", "ASP-JS", "ASP-VB",
"ColdFusion", "CFC", "JSP", "ASP.NET_VB", ou toute valeur similaire. Pour obtenir la liste complète des
types disponibles, consultez le fichier MMDocumentTypes.xml. Si vous ne définissez pas l'argument type, il adopte
la valeur "HTML".
RÉFÉRENCE DES API DE DREAMWEAVER CS4 252
Document
Remarque : Vous pouvez étendre le fichier MMDocumentTypes en ajoutant de nouveaux types de documents. Pour plus
d'informations sur l'extension des types de documents, voir Extension de Dreamweaver.
Valeurs renvoyées
Objet document correspondant au nouveau document créé. Il s'agit de la valeur renvoyée par la fonction
dreamweaver.getDocumentDOM().
dreamweaver.createXHTMLDocument()
Disponibilité
Dreamweaver MX.
Description
En fonction de l'argument utilisé, cette fonction ouvre un nouveau document XHTML soit dans la même fenêtre, soit
dans une nouvelle fenêtre. Le nouveau document devient le document actif. Cette fonction est similaire à la fonction
dreamweaver.createDocument().
Lorsque Dreamweaver crée un nouveau document XHTML, il lit un fichier nommé default.xhtml, qui se trouve dans
le dossier Configuration/Templates, et, en utilisant le contenu de ce fichier, il crée un fichier de sortie contenant les
déclarations suivantes :
<?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>
La déclaration DTD par défaut est XHTML 1.0 Transitional et non pas Strict. Si l'utilisateur ajoute un jeu de cadres
au document, Dreamweaver remplace la DTD par XHTML 1.0 Frameset. Content-Type est text/html, et charset
est intentionnellement omis du fichier default.xhtml mais est rempli avant que l'utilisateur visualise le nouveau
document. La directive ?xml n'est pas obligatoire si le document utilise le codage de caractères UTF-8 ou UTF-16 ; si
elle est présente, elle peut être restituée par d'autres navigateurs de version antérieure. Cependant, étant donné que
cette directive doit se trouver dans un document XHTML, Dreamweaver l'utilise par défaut (à la fois pour les
documents nouveaux et convertis). Les utilisateurs peuvent supprimer manuellement la directive. La directive ?xml
inclut l'attribut de codage qui correspond à charset dans l'attribut Content-Type.
Arguments
{bOpenInSameWindow}
• L'argument bOpenInSameWindow est une valeur booléenne indiquant si le nouveau document doit s'ouvrir dans
la fenêtre en cours. Si cet argument a pour valeur false, qu'il n'est pas précisé ou que la fonction est appelée sur
Macintosh, le nouveau document s'ouvre dans une nouvelle fenêtre.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 253
Document
Valeurs renvoyées
L'objet document correspondant au document nouvellement créé (même valeur que celle renvoyée par la fonction
dreamweaver.getDocumentDOM()).
dreamweaver.createXMLDocument()
Disponibilité
Dreamweaver MX.
Description
Crée et ouvre un nouveau fichier XML contenant uniquement la directive XML.
Arguments
Aucun.
Valeurs renvoyées
Le DOM du nouveau fichier XML.
Exemple
L'exemple suivant crée un nouveau document, contenant uniquement la directive XML :
var theDOM = dreamweaver.createXMLDocument("document");
dreamweaver.exportTemplateDataAsXML()
Disponibilité
Dreamweaver MX.
Description
Exporte le document actif dans le fichier indiqué, et ce au format XML. Cette fonction agit sur le document actif, qui
doit être un modèle. Si vous ne spécifiez pas un argument de nom de fichier, Dreamweaver MX ouvre une boîte de
dialogue pour demander la chaîne du fichier d'exportation.
Arguments
{filePath}
• L'argument filePath (facultatif) est une chaîne spécifiant le nom du fichier vers lequel Dreamweaver exporte le
modèle. Exprimez l'argument filePath sous forme d'une URL de type "file:///c|/temp/mydata.txt".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canExportTemplateDataAsXML() » à la page 475.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 254
Document
Exemple
if(dreamweaver.canExportTemplateDataAsXML())
{
dreamweaver.exportTemplateDataAsXML("file:///c|/dw_temps/mytemplate.txt")
}
dreamweaver.getDocumentDOM()
Disponibilité
Dreamweaver 2.
Description
Permet d'accéder à l'arborescence des objets du document spécifié. Une fois celle-ci renvoyée à l'appelant, ce dernier
peut la modifier pour changer le contenu du document.
Arguments
{sourceDoc}
• L'argument sourceDoc doit être "document", "parent", "parent.frames[number]",
"parent.frames['frameName']", ou une URL. L'argument sourceDoc prend par défaut la valeur "document"
si vous ne fournissez pas de valeur. Ces valeurs sont expliquées ci-dessous :
• La valeur document désigne le document actif contenant la sélection en cours.
• La valeur parent désigne le jeu de cadres parent (si le document sélectionné se trouve dans un cadre).
• Les valeurs parent.frames[number] et parent.frames['frameName'] désignent un document figurant
dans un cadre spécifique du jeu de cadres contenant le document actif.
• Si l'argument est une URL relative, celle-ci est relative au fichier de l'extension.
Remarque : Si l'argument a pour valeur "document", l'appelant doit être la fonction applyBehavior(),
deleteBehavior(), objectTag() ou toute fonction d'un fichier de commande ou d'inspecteur Propriétés pouvant
modifier le document.
Valeurs renvoyées
L'objet document JavaScript à la racine de l'arborescence.
Exemples
L'exemple suivant utilise la fonction dreamweaver.getDocumentDOM() pour accéder au document actif :
var theDOM = dreamweaver.getDocumentDOM("document");
Dans l'exemple suivant, le document DOM actif identifie une sélection et la colle à la fin d'un autre document :
var currentDOM = dreamweaver.getDocumentDOM('document');
currentDOM.setSelection(100,200);
currentDOM.clipCopy();
var otherDOM = dreamweaver.openDocument(dreamweaver.¬
getSiteRoot() + "html/foo.htm");
otherDOM.endOfDocument();
otherDOM.clipPaste();
RÉFÉRENCE DES API DE DREAMWEAVER CS4 255
Document
Remarque : L'argument openDocument() est utilisé car les méthodes de l'objet DOM agissent en principe uniquement sur
les documents ouverts. L'exécution d'une fonction sur un document qui n'est pas ouvert entraîne une erreur de
Dreamweaver. Lorsqu'une méthode de l'objet DOM ne peut être appliquée qu'au document actif ou à des documents
fermés, cette caractéristique est indiquée dans sa description.
dreamweaver.getNewDocumentDOM()
Disponibilité
Dreamweaver MX ; argument documentType ajouté dans Dreamweaver 8.
Description
Permet d'accéder à l'arborescence modifiable d'un nouveau document vide. Cette fonction est similaire à la fonction
getDocumentDOM(), à ceci près qu'elle pointe vers un nouveau document plutôt que vers un document existant et
qu'elle n'ouvre pas le document.
Arguments
{documentType}
• L'argument documentType est une chaîne. Sa valeur doit être un type de document spécifié dans le fichier
DocumentTypes.xml.
Valeurs renvoyées
Pointeur vers un nouveau document vide.
Exemple
Le code suivant renvoie le DOM d'un nouveau document vide :
var theDOM = dreamweaver.getNewDocumentDOM();
dreamweaver.getRecentFileList()
Disponibilité
Dreamweaver 3.
Description
Obtient la liste de tous les fichiers récemment ouverts et répertoriés au bas du menu Fichier.
Arguments
Aucun.
Valeurs renvoyées
Un tableau de chaînes représentant les chemins des derniers fichiers ouverts, exprimés sous la forme d'une URL de
type file://. Si aucun fichier n'a été ouvert récemment, la fonction ne renvoie aucune valeur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 256
Document
dreamweaver.importXMLIntoTemplate()
Disponibilité
Dreamweaver 3.
Description
Importe un fichier texte XML dans le modèle de document actif. Cette fonction agit sur le document actif, qui doit être
un modèle. Si vous ne spécifiez pas un argument de nom de fichier, Dreamweaver ouvre une boîte de dialogue pour
demander la chaîne du fichier d'importation.
Arguments
{filePath}
• L'argument filePath (facultatif) est une chaîne spécifiant le nom du fichier vers lequel Dreamweaver importe le
modèle. Exprimez l'argument filePath sous forme d'une URL de type "file:///c|/temp/mydata.txt".
Valeurs renvoyées
Aucune.
dreamweaver.newDocument()
Disponibilité
Dreamweaver MX.
Description
Ouvre un document dans le site en cours et affiche la boîte de dialogue Nouveau document.
Arguments
{bopenWithCurSiteAndShowDialog}
• L'argument bopenWithCurSiteAndShowDialog (facultatif) peut avoir la valeur true ou false. Si vous souhaitez
ouvrir un document dans le site en cours et afficher la boîte de dialogue Nouveau document, spécifiez true ; sinon,
spécifiez false.
Valeurs renvoyées
Aucune.
dreamweaver.newFromTemplate()
Disponibilité
Dreamweaver 3.
Description
Crée un nouveau document à partir du modèle spécifié. Si vous ne spécifiez aucun argument, la boîte de dialogue
Sélectionner le modèle s'affiche.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 257
Document
Arguments
{templateURL}, bMaintain
• L'argument templateURL est le chemin d'un modèle disponible sur le site en cours, exprimé sous la forme d'une
URL de type file://.
• L'argument bMaintain est une valeur booléenne, pouvant être true ou false, indiquant si le lien vers le modèle
d'origine doit être conservé ou pas.
Valeurs renvoyées
Aucune.
dreamweaver.openDocument()
Disponibilité
Dreamweaver 2.
Description
Ouvre un document à modifier dans une nouvelle fenêtre Dreamweaver et en fait le document actif. Pour l'utilisateur,
cela revient à choisir Fichier > Ouvrir et à sélectionner un fichier. Si le fichier spécifié est déjà ouvert, la fenêtre
correspondante s'affiche au premier plan. La fenêtre contenant le fichier spécifié devient la fenêtre active et le fichier
sélectionné devient le document actif. Dans Dreamweaver 2, si la fonction d'archivage/extraction est activée, le fichier
est extrait avant d'être ouvert. Dans Dreamweaver 3 et ses versions ultérieures, vous devez utiliser la fonction
« dreamweaver.openDocumentFromSite() » à la page 257 pour obtenir ce comportement.
Remarque : Cette fonction provoque une erreur si elle est appelée à partir d'un fichier d'objet ou d'action de
comportement.
Arguments
fileName
• L'argument fileName est le nom du fichier à ouvrir, exprimé sous forme d'une URL absolue. S'il s'agit d'une URL
relative, elle est relative au fichier contenant le script ayant appelé cette fonction.
Valeurs renvoyées
L'objet document correspondant au fichier spécifié, soit la même valeur renvoyée par la fonction
dreamweaver.getDocumentDOM().
dreamweaver.openDocumentFromSite()
Disponibilité
Dreamweaver 3.
Description
Ouvre un document à modifier dans une nouvelle fenêtre Dreamweaver et en fait le document actif. Pour l'utilisateur,
cela revient à double-cliquer sur un fichier dans le panneau Site. Si le fichier spécifié est déjà ouvert, la fenêtre
correspondante s'affiche au premier plan. La fenêtre contenant le fichier spécifié devient la fenêtre active et le fichier
sélectionné devient le document actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 258
Document
Remarque : Cette fonction ne peut pas être appelée à partir d'un fichier d'objet ou d'action de comportement sous peine
de générer des erreurs.
Arguments
fileName
• L'argument fileName est le fichier à ouvrir, exprimé sous forme d'une URL absolue. S'il s'agit d'une URL relative,
elle est relative au fichier contenant le script ayant appelé cette fonction.
Valeurs renvoyées
L'objet document correspondant au fichier spécifié, soit la même valeur renvoyée par la fonction
dreamweaver.getDocumentDOM().
dreamweaver.openInFrame()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Ouvrir dans un cadre. Lorsque l'utilisateur sélectionne un document, celui-ci s'ouvre dans
le cadre actif.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canOpenInFrame() » à la page 476.
dreamweaver.releaseDocument()
Disponibilité
Dreamweaver 2.
Description
Libère explicitement de la mémoire un document précédemment référencé.
Les documents référencés par les fonctions dreamweaver.getObjectTags(), dreamweaver.getObjectRefs(),
dreamweaver.getDocumentPath() et dreamweaver.getDocumentDOM() sont automatiquement libérés au terme de
l'exécution du script contenant l'appel. Si le script ouvre un nombre important de documents, vous devez utiliser cette
fonction pour en libérer certains explicitement avant la fin de l'exécution du script, ceci afin d'éviter de saturer la
mémoire.
Remarque : Cette fonction ne s'applique qu'aux documents référencés par une URL, qui ne sont pas ouverts dans un
cadre ou dans une fenêtre de document et qui ne correspondent pas à des fichiers d'extension (les fichiers d'extensions
externes sont chargés en mémoire au démarrage et n'en sont libérés que lorsque vous quittez Dreamweaver).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 259
Document
Arguments
documentObject.
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoyées
Aucune.
dreamweaver.revertDocument()
Disponibilité
Dreamweaver 3.
Description
Rétablit la version précédemment enregistrée du fichier spécifié.
Arguments
documentObject, warn
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
• L'argument warn est une valeur booléenne qui spécifie si l'utilisateur doit être informé que les modifications non
enregistrées seront annulées. En cas d'omission, la valeur par défaut est true.
Valeurs renvoyées
Valeur booléenne : true si Dreamweaver doit avertir l'utilisateur et false dans le cas contraire.
Activateur
Voir « dreamweaver.canRevertDocument() » à la page 478.
dreamweaver.saveAll()
Disponibilité
Dreamweaver 3.
Description
Enregistre tous les documents ouverts et ouvre la boîte de dialogue Enregistrer sous pour tous ceux qui n'ont pas
encore été enregistrés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 260
Document
Activateur
Voir « dreamweaver.canSaveAll() » à la page 478.
dreamweaver.saveDocument()
Disponibilité
Dreamweaver 2.
Description
Enregistre le fichier spécifié sur un ordinateur local.
Remarque : Dans Dreamweaver 2, si le fichier est en lecture seule, Dreamweaver tente de l'extraire. Si le document reste
en lecture seule après cette tentative ou s'il ne peut pas être créé, un message d'erreur s'affiche.
Arguments
documentObject, {fileURL}
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
• L'argument fileURL (facultatif) est une URL représentant un emplacement sur un ordinateur local. S'il s'agit d'une
URL relative, elle est relative au fichier de l'extension. Dans Dreamweaver 2, cet argument est obligatoire. Dans
Dreamweaver 4, si l'argument fileURL est omis et si le fichier a été enregistré précédemment, ce dernier est
enregistré au même endroit ; sinon, la boîte de dialogue Enregistrer sous s'affiche.
Valeurs renvoyées
Valeur booléenne indiquant le succès (true) ou l'échec (false) de l'opération.
Activateur
Voir « dreamweaver.canSaveDocument() » à la page 479.
dreamweaver.saveDocumentAs()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Enregistrer sous.
Arguments
documentObject.
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 261
Document
dreamweaver.saveDocumentAsTemplate()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Enregistrer comme modèle.
Arguments
documentObject, {fileName}
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
• L'argument fileName (facultatif) est le nom du fichier à ouvrir, exprimé sous forme d'une URL absolue.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canSaveDocumentAsTemplate() » à la page 479.
dreamweaver.saveFrameset()
Disponibilité
Dreamweaver 3.
Description
Enregistre le jeu de cadres spécifié ou, si ce dernier n'a pas encore été enregistré, ouvre la boîte de dialogue Enregistrer sous.
Arguments
documentObject.
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canSaveFrameset() » à la page 479.
dreamweaver.saveFramesetAs()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 262
Document
Description
Ouvre la boîte de dialogue Enregistrer sous correspondant au fichier de jeu de cadres comprenant le DOM spécifié.
Arguments
documentObject.
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document, c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canSaveFramesetAs() » à la page 480.
Fonctions relatives à l'ensemble d'un document
Ces fonctions agissent sur l'ensemble d'un document. Elles permettent d'effectuer des vérifications orthographiques,
de vérifier les navigateurs cibles, de définir les propriétés des pages et de déterminer les références d'objet correctes des
éléments du document.
dom.checkSpelling()
Disponibilité
Dreamweaver 3.
Description
Vérifie l'orthographe sur l'ensemble du document (en ouvrant la boîte de dialogue Vérifier l'orthographe, si nécessaire)
et prévient l'utilisateur lorsque la vérification est terminée.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.checkTargetBrowsers()
Disponibilité
Dreamweaver 3.
Description
Vérifie le navigateur cible du document. Pour vérifier le navigateur cible d'un dossier ou d'un groupe de fichiers,
consultez la fonction « site.checkTargetBrowsers() » à la page 221.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 263
Document
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.getParseMode()
Disponibilité
Dreamweaver MX 2004.
Description
Permet d'obtenir le mode d'analyse du document. Ceci permet de contrôler la validation du document et de vérifier
qu'il s'affiche au format HTML dans la fenêtre de document principale.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui spécifie le mode d'analyse actuel : "html", "xml", "css" ou "text".
dom.hideInfoMessagePopup()
Disponibilité
Dreamweaver MX 2004.
Description
Masque le message qui peut s'afficher sous forme d'infobulle dans la fenêtre de document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Voir aussi
« dom.showInfoMessagePopup() » à la page 265.
dom.runValidation()
Disponibilité
Dreamweaver MX, arguments facultatifs ajoutés à Dreamweaver MX 2004.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 264
Document
Description
Exécute le validateur sur un seul document spécifié (similaire à la fonction « site.runValidation() » à la page 238. Le
validateur vérifie que le langage du document est conforme à celui qui a été spécifié dans le doctype du document (par
exemple HTML 4.0 ou HTML 3.2) et à celui qui a été spécifié par le modèle de serveur (par exemple ColdFusion ou
ASP). Si aucun doctype n'a été défini pour le document, le validateur utilise le paramètre de langage spécifié dans la
section Validateur de la boîte de dialogue Préférences.
Arguments
{controlString}, {bOpenResultsWindow}, {bShowInfoMessage}
• L'argument controlString est une chaîne facultative qui possède quatre valeurs possibles : une chaîne vide, "xml",
"auto-explicit" ou "auto-implicit".
• Si la valeur de l'argument est une chaîne vide, le validateur effectue une validation par défaut. Si sa valeur est
"xml", il valide le document en tant que XML.
• Si sa valeur est "auto-explicit" ou "auto-implicit", Dreamweaver effectue une validation automatique
(ou validation en ligne). Plutôt que d'être affichées dans la fenêtre de résultats de la validation (voir
« dom.source.getValidationErrorsForOffset() » à la page 449 and « dom.getAutoValidationCount() » à la
page 442), les erreurs sont soulignées dans le mode Code.
• Si la valeur de l'argument controlString est "auto-explicit", l'utilisateur est invité à enregistrer un document
non enregistré avant la validation.
• Si la valeur de l'argument controlString est "auto-implicit", la validation échoue sans prévenir l'utilisateur
que le document en cours n'a pas été enregistré.
Remarque : La validation automatique (définie par la valeur "auto-explicit" ou "auto-implicit" de l'argument
controlString) n'est disponible que pour la vérification du navigateur cible.
• L'argument bOpenResultsWindow est une valeur booléenne facultative : true ouvre la fenêtre Résultat de la
validation, et false ne l'ouvre pas. La valeur par défaut est true.
• L'argument bShowInfoMessage n'est utilisé que si la valeur de l'argument controlString est "auto-explicit" ou
"auto-implicit". L'argument bShowInfoMessage est une valeur booléenne. true affiche un message
d'information sous l'élément de barre d'outils, DW_ValidatorErrors, indiquant le nombre d'erreurs trouvées.
false n'affiche rien. La valeur par défaut est false.
Valeurs renvoyées
Objet fenêtre des résultats de la validation.
Exemple
Dans l'exemple suivant, une validation régulière est effectuée lorsque l'utilisateur sélectionne Fichier > Vérifier la page
> Valider le marqueur (ou Valider le document actuel dans le panneau Validation) :
dw.getDocumentDOM().runValidation('');
Dans l'exemple suivant, l'utilisateur est invité à enregistrer le document non enregistré, puis une validation
automatique est effectuée. La fenêtre de résultats de la validation ne s'affiche pas et le nombre d'erreurs dans le
document s'affiche sur la barre d'outils du document pour DW_ValidatorErrors :
dw.getDocumentDOM().runValidation('auto-explicit', false, true);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 265
Document
Dans l'exemple suivant, l'utilisateur n'est pas invité à enregistrer le document. Si le document n'a pas été enregistré, la
validation ne peut pas démarrer. Si le document a été enregistré, Dreamweaver effectue une validation automatique.
La fenêtre de résultats de la validation ne s'affiche pas et le nombre d'erreurs dans le document n'apparaît pas sur la
barre d'outils du document :
dw.getDocumentDOM().runValidation('auto-implicit', false);
dom.showInfoMessagePopup()
Disponibilité
Dreamweaver MX 2004.
Description
Affiche un message sous forme d'infobulle dans la fenêtre de document ou sous un élément de barre d'outils.
Arguments
location, message, timeout
• L'argument location est une chaîne spécifiant un élément de barre d'outils, une chaîne vide ou l'un des mots clés
suivants : "top", "topright", "right", "bottomright", "bottom", "bottomleft", "left" ou "topleft".
L'infobulle s'affiche près du bord ou de l'angle spécifié et est centrée. Si la valeur de l'argument est une chaîne vide,
l'infobulle est centrée dans le document. Pour spécifier un élément de barre d'outils, indiquez
"toolbar:toolbarID:itemID". L'ID de barre d'outils et l'ID d'élément de barre d'outils doivent correspondre aux
ID du fichier toolbars.xml.
• L'argument message est une chaîne contenant le message.
• L'argument timeout est un nombre indiquant le temps d'affichage du message en millisecondes. Si sa valeur est 0
(valeur par défaut), le message reste affiché pendant une durée illimitée. Le message disparaît automatiquement
lorsque l'utilisateur clique dessus, passe à un autre document ou lorsque la durée d'affichage spécifiée arrive à
expiration.
Valeurs renvoyées
Aucune.
Exemple
Dans l'exemple ci-dessous, deux messages s'affichent sous forme d'infobulles. La première ligne de code affiche le
message "This message is in the center" au centre du document. Le second appel de la fonction
showInfoMessagePopup() affiche le message "Don't forget the title for the Window" pour la zone de texte
Title (ID : DW_SetTitle) sur la barre d'outils dont l'ID est DW_Toolbar_Main.
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);
Voir aussi
« dom.hideInfoMessagePopup() » à la page 263.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 266
Document
dom.showPagePropertiesDialog()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Propriétés de la page.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.doURLDecoding()
Disponibilité
Dreamweaver MX.
Description
Utilise le mécanisme de décodage d'URL interne de Dreamweaver pour décoder des caractères spéciaux et des
symboles dans les chaînes d'URL. Par exemple, cette fonction interprète %20 comme un caractère d'espacement et le
nom &quot comme des guillemets ".
Arguments
inStr
• L'argument inStr est la chaîne à décoder.
Valeurs renvoyées
Chaîne contenant l'URL décodée.
Exemple
L'exemple suivant appelle la fonction dw.doURLDecoding() afin de décoder les caractères spéciaux indiqués dans son
argument et enregistre la chaîne obtenue dans outStr :
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()
Disponibilité
Dreamweaver 2.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 267
Document
Description
Obtient la référence d'objet Netscape Navigator ou Internet Explorer pour un objet balise spécifique de l'arborescence DOM.
Arguments
NSorIE, tagObject
• L'argument NSorIE doit être "NS
4.0" ou "IE 4.0". Le DOM et les règles relatives aux références imbriquées
diffèrent dans Netscape Navigator 4.0 et Internet Explorer 4.0. Cet argument permet d'indiquer à quel navigateur
doit correspondre la référence renvoyée.
• L'argument tagObject est un objet de balise dans l'arborescence DOM.
Valeurs renvoyées
Chaîne représentant une référence JavaScript valide à l'objet, telle que document.layers['myLayer']. La chaîne est
soumise aux conditions suivantes :
• Dreamweaver renvoie des références Internet Explorer correctes pour les balises suivantes : A, AREA, APPLET,
EMBED, DIV, SPAN, INPUT, SELECT, OPTION, TEXTAREA, OBJECT et IMG.
• Dreamweaver renvoie des références Netscape Navigator correctes pour les balises suivantes : A, AREA, APPLET,
EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT, and IMG, ainsi que pour les balises DIV et SPAN à
positionnement absolu. Pour les balises DIV et SPAN dont le positionnement n'est pas absolu, Dreamweaver renvoie
"cannot reference <tag>".
• Dreamweaver ne renvoie pas de références pour les objets sans nom. Si un objet ne contient pas d'attribut NAME ou
ID, Dreamweaver renvoie "unnamed <tag>". Si le navigateur ne prend pas en charge une référence par nom,
Dreamweaver fait référence à l'objet à l'aide de son index (par exemple document.myform.applets[3]).
• Dreamweaver renvoie les références des objets nommés figurant dans des formulaires ou des calques sans nom (par
exemple document.forms[2].myCheckbox).
dreamweaver.getPreferenceInt()
Disponibilité
Dreamweaver MX.
Description
Vous permet d'extraire une préférence de nombre entier pour une extension donnée.
Arguments
section, key, default_value
• L'argument section est une chaîne qui spécifie la section des préférences contenant l'entrée.
• L'argument key est une chaîne qui spécifie l'entrée de la valeur à extraire.
• L'argument default_value est la valeur par défaut renvoyée par Dreamweaver si l'entrée est introuvable. Il doit s'agir
d'un entier non signé compris entre 0 et 65535 ou d'un entier signé compris entre -32768 et 32767.
Valeurs renvoyées
Valeur entière de l'entrée spécifiée dans la section ou valeur par défaut si la fonction ne trouve pas l'entrée. Renvoie 0
si la valeur de l'entrée spécifiée n'est pas un entier.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 268
Document
Exemple
L'exemple suivant renvoie la valeur du paramètre Distance d'accrochage de la section Mon extension des Préférences.
Si la section Mon extension n'existe pas ou si le paramètre Distance d'accrochage n'est pas défini, la fonction renvoie
la valeur par défaut spécifiée (0).
var snapDist; //default value if entry not found
snapDist = dreamweaver.getPreferenceInt("My Extension", "Snap Distance", 0);
dreamweaver.getPreferenceString()
Disponibilité
Dreamweaver MX.
Remarque : Pour accéder aux préférences des sites, vous devez posséder la version 7.0.1. Vérifiez dw.appVersion pour
connaître la version correcte avant d'accéder aux informations relatives au site.
Description
Permet d'extraire une préférence de chaîne que vous avez stockée pour une extension.
Arguments
section, key, default_value
• L'argument section est une chaîne qui spécifie la section des préférences contenant l'entrée.
• L'argument key est une chaîne qui spécifie la valeur à extraire.
• L'argument default_value est la valeur de chaîne par défaut renvoyée par Dreamweaver si l'entrée est introuvable.
Valeurs renvoyées
Chaîne de la préférence demandée ou valeur par défaut si la chaîne est introuvable.
Exemple
L'exemple suivant renvoie la valeur du paramètre Editeur de texte de la section Mon extension des Préférences. Si la
section Mon extension n'existe pas ou si le paramètre Editeur de texte n'est pas défini, la fonction renvoie la valeur par
défaut spécifiée par la variable txtEditor.
var txtEditor = getExternalTextEditor(); //set default text Editor value
txtEditor = dreamweaver.getPreferenceString("My Extension", "Text Editor", txtEditor);
dreamweaver.setPreferenceInt()
Disponibilité
Dreamweaver MX.
Description
Vous permet de définir une préférence de nombre entier pour une extension donnée. Ce paramètre est enregistré avec
les préférences de Dreamweaver lorsque Dreamweaver n'est pas actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 269
Document
Arguments
section, key, new_value
• L'argument section est une chaîne qui spécifie la catégorie de préférences définissant l'option. Si la catégorie n'existe
pas, Dreamweaver la crée.
• L'argument key est une chaîne qui spécifie l'option de catégorie définie par la fonction. Si l'option n'existe pas,
Dreamweaver la crée.
• L'argument new_value est un entier qui spécifie la valeur de l'option de catégorie.
Valeurs renvoyées
Valeur true en cas de succès et false dans le cas contraire.
Exemple
L'exemple suivant définit l'entrée Distance d'accrochage en fonction de la valeur de la variable snapDist de la catégorie
Mon extension dans les Préférences :
var snapDist = getSnapDistance();
if(snapDist > 0)
{
dreamweaver.setPreferenceInt("My Extension", "Snap Distance", snapDist);
}
dreamweaver.setPreferenceString()
Disponibilité
Dreamweaver MX.
Remarque : Pour accéder aux préférences des sites, vous devez posséder la version 7.0.1. Vérifiez dw.appVersion pour
connaître la version correcte avant d'accéder aux informations relatives au site.
Description
Permet d'écrire une préférence de chaîne pour une extension. Ce paramètre est enregistré avec les préférences de
Dreamweaver lorsque Dreamweaver n'est pas actif.
Arguments
section, key, new_value
• L'argument section est une chaîne qui spécifie la catégorie de Préférences définissant l'option. Si la catégorie n'existe
pas, Dreamweaver la crée.
• L'argument key est une chaîne qui spécifie l'option de catégorie définie par les fonctions. Si l'option de catégorie
n'existe pas, Dreamweaver la crée.
• L'argument new_value est une chaîne qui spécifie la valeur de l'option de catégorie.
Valeurs renvoyées
Valeur true en cas de succès et false dans le cas contraire.
Exemple
var txtEditor = getExternalTextEditor();
dreamweaver.setPreferenceString("My Extension", "Text Editor", txtEditor);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 270
Document
dreamweaver.showTargetBrowsersDialog()
Disponibilité
Dreamweaver MX 2004.
Description
Ouvre la boîte de dialogue Navigateurs cibles. Cette boîte de dialogue permet à l'utilisateur de spécifier les versions des
navigateurs utilisées par la fonction Vérification du navigateur cible pour contrôler les problèmes de compatibilité du
navigateur sur la page actuelle.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Fonctions relatives aux chemins
Ces fonctions permettent d'obtenir et de manipuler les chemins d'accès aux différents fichiers et dossiers enregistrés
sur le disque dur d'un utilisateur. Elles permettent, entre autres, de déterminer le chemin d'accès à la racine du site dans
lequel réside le document actif et de convertir des chemins relatifs en URL absolues.
dreamweaver.absoluteURLToDocRelative()
Disponibilité
Dreamweaver 2.
Description
Lorsqu'elle reçoit une URL absolue et le chemin d'un document, cette fonction convertir l'URL absolue en un chemin
d'accès relatif au document.
Arguments
docPathURL, siteRootURL, absoluteURL
• L'argument docPathURL est le chemin d'accès à un document sur l'ordinateur de l'utilisateur (par exemple, le
document actuel), exprimé sous la forme d'une URL file://.
• L'argument siteRootURL est le chemin d'accès à la racine du site, exprimé sous la forme d'une URL file://.
• L'argument absoluteURL est l'URL file:// à convertir en chemin d'accès relatif au document.
Valeurs renvoyées
Chaîne représentant le chemin d'accès au document à absoluteURL, exprimé de façon relative au document à
docPathURL.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 271
Document
Exemple
Dans l'exemple suivant, si les valeurs de docPathURL et siteRootURL sont respectivement
file://C:/sites/cherrystreet/archives/october.shtml et file://C:/sites/cherrystreet/, la valeur
renvoyée est "../includes/header.html". Cette valeur permet de faire référence à /includes/header.html à
partir de /archives/october.shtml.
var
var
var
var
docPathURL = dw.getDocumentDOM().URL;
siteRootURL = dw.getSiteRoot();
absoluteURL= dw.relativeToAbsoluteURL(docPathURL, siteRootURL, "/includes/header.html");
docRelPath = dw.absoluteURLToDocRelative(docPathURL, siteRootURL, absoluteURL);
dreamweaver.getConfigurationPath()
Disponibilité
Dreamweaver 2.
Description
Obtient le chemin d'accès au dossier Configuration de Dreamweaver, exprimé sous la forme d'une URL de type file://.
Pour savoir comment accède aux dossiers Configuration sur une plate-forme multiutilisateur, voir « Extensions C »
dans l'aide Extension de Dreamweaver.
Arguments
Aucun.
Valeurs renvoyées
Chemin d'accès aux configurations de l'application.
Exemple
La fonction ci-dessous permet de faire référence à d'autres fichiers d'extension stockés dans le sous-dossier
Configuration du dossier de l'application Dreamweaver :
var sortCmd = dreamweaver.getConfigurationPath() + ¬
"/Commands/Sort Table.htm"
var sortDOM = dreamweaver.getDocumentDOM(sortCmd);
dreamweaver.getDocumentPath()
Disponibilité
Dreamweaver 1.2.
Description
Obtient le chemin d'accès du document défini, exprimé sous la forme d'une URL de type file://. Cette fonction revient
à appeler la fonction dreamweaver.getDocumentDOM() et à lire la propriété URL de la valeur renvoyée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 272
Document
Arguments
sourceDoc
• La valeur de l'argument sourceDoc doit être "document", "parent", "parent.frames[number]" ou
"parent.frames['frameName']". "document" désigne le document actif contenant la sélection en cours.
"parent" désigne le jeu de cadres parent (si le document sélectionné se trouve dans un cadre);
"parent.frames[number]" et "parent.frames['frameName']" désignent un document figurant dans un cadre
spécifique du jeu de cadres contenant le document actif.
Valeurs renvoyées
Soit une chaîne contenant l'URL du document défini si le fichier a été enregistré, soit une chaîne vide si le fichier n'a
pas été enregistré.
dreamweaver.getSiteRoot()
Disponibilité
Dreamweaver 1.2.
Description
Obtient le dossier racine local (tel que défini dans la boîte de dialogue Définition du site) du site associé au document
sélectionné, exprimé sous la forme d'une URL de type file://.
Arguments
Aucun.
Valeurs renvoyées
Soit une chaîne contenant l'URL du dossier racine local du site où le fichier a été enregistré, soit une chaîne vide si le
fichier n'est associé à aucun site.
dreamweaver.getTempFolderPath()
Disponibilité
Dreamweaver MX.
Description
Permet d'obtenir le chemin d'accès complet à un dossier temporaire dans lequel vous pouvez enregistrer les fichiers
temporaires ou transitoires. Cette fonction recherche un dossier Temp dans le dossier Configuration de Dreamweaver.
Si le système est multiutilisateur, la recherche se fait dans le dossier Configuration de l'utilisateur. Si aucun dossier
Temp n'a été trouvé, la fonction en crée un. Les fichiers partagés qui ne sont pas transitoires doivent être enregistrés
dans le dossier Configuration/Shared.
Arguments
Aucun.
Valeurs renvoyées
Chemin d'accès au dossier, exprimé sous la forme d'une URL de type file://.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 273
Document
Exemple
La ligne de code ci-dessous renvoie le chemin d'accès complet au fichier spécifié. Contrairement aux autres fonctions
Dreamweaver (telles que dreamweaver.getSiteRoot()), la fonction dw.getTempFolderPath() ne renvoie pas de
barre oblique (/) à la fin du chemin :
var myTempfile = dw.getTempFolderPath() + "/myTempFile.txt";
dreamweaver.relativeToAbsoluteURL()
Disponibilité
Dreamweaver 2.
Description
Si on lui fournit une URL relative et un point de référence donnés (chemin d'accès au document actif ou racine du site),
cette fonction convertit l'URL relative en URL absolue (file://).
Arguments
docPath, siteRoot, relURL
• L'argument docPath correspond au chemin d'accès à un document sur l'ordinateur de l'utilisateur (le document
actif, par exemple), exprimé sous la forme d'une URL de type file://, ou à une chaîne vide si relURL est une URL
relative à la racine.
• L'argument siteRoot est le chemin d'accès à la racine du site, exprimé sous la forme d'une URL de type file://, ou une
chaîne vide si relURL est une URL relative à un document.
• L'argument relURL est l'URL à convertir.
Valeurs renvoyées
URL absolue. La valeur renvoyée est générée conformément aux principes suivants :
• Si relURL est une URL absolue, aucune conversion n'a lieu et la valeur renvoyée est identique à relURL.
• Si relURL est une URL relative à un document, la valeur renvoyée est une combinaison de docPath et relURL.
• Si relURL est une URL relative à la racine, la valeur renvoyée est une combinaison de siteRoot et relURL.
Fonctions relatives à la sélection
Ces fonctions permettent d'obtenir et de définir la sélection dans les documents ouverts. Pour savoir comment obtenir
et définir la sélection dans le panneau Site, voir « Fonctions relatives aux sites » à la page 213.
dom.getSelectedNode()
Disponibilité
Dreamweaver 3.
Description
Obtient le nœud sélectionné. Revient à appeler la fonction dom.getSelection() et à transmettre la valeur renvoyée
à la fonction dom.offsetsToNode().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 274
Document
Arguments
Aucun.
Valeurs renvoyées
Objet balise, texte ou commentaire contenant la série de caractères spécifiée.
dom.getSelection()
Disponibilité
Dreamweaver 3.
Description
Obtient la sélection, exprimée en décalages de caractères, dans le code source du document.
Arguments
{bAllowMultiple}
• L'argument bAllowMultiple (facultatif) est une valeur booléenne qui indique si la fonction doit renvoyer plusieurs
décalages lorsque plusieurs calques, cellules de tableau ou zones réactives de carte graphique sont sélectionnés.
Si cet argument n'est pas défini, il prend par défaut la valeur false.
Valeurs renvoyées
Pour les sélections simples, un tableau contenant deux nombres entiers. Le premier entier correspond au décalage de
caractères à l'ouverture de la sélection. Le second correspond au décalage de caractères à la fermeture de la sélection.
Si les deux valeurs sont identiques, la sélection en cours correspond à un point d'insertion.
Pour les sélections complexes (lorsque la sélection se compose de plusieurs cellules de tableau, calques ou zones
réactives de carte graphique), tableau contenant 2n nombres entiers, où n représente le nombre d'éléments
sélectionnés. Le premier entier de chaque paire correspond au décalage de caractères de l'ouverture de la sélection
(balise d'ouverture TD, DIV, SPAN, LAYER, ILAYER ou MAP comprise) ; le second entier correspond au décalage de
caractères à la fermeture de la sélection (balise de fermeture TD, DIV, SPAN, LAYER, ILAYER ou MAP). Si plusieurs rangées
d'un tableau sont sélectionnées, le décalage de chaque cellule de chaque rangée est renvoyé. La sélection n'inclut jamais
les balises TR.
dom.getSelectorsDefinedInStylesheet()
Disponibilité
Dreamweaver 8.
Description
Obtient un tableau de sélecteurs correspondant au type transmis comme attribut.
Arguments
selector
• L'argument selector est une chaîne dont la valeur est class ou ID. Il spécifie si la fonction renvoie des sélecteurs
de type class ou ID.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 275
Document
Valeurs renvoyées
Tableau de sélecteurs pouvant être de type class ou ID.
Exemple
Le code suivant permet d'obtenir un tableau de sélecteurs de type class :
var dom=dw.getDocumentDOM();
var classSelectors = dom.getSelectorsDefinedInStylesheet('class');
Le code suivant permet d'obtenir un tableau de sélecteurs de type ID :
var dom=dw.getDocumentDOM();
var classSelectors = dom.getSelectorsDefinedInStylesheet('ID');
dom.nodeToOffsets()
Disponibilité
Dreamweaver 3.
Description
Obtient la position d'un nœud donné dans l'arborescence DOM, exprimée en décalages de caractères dans le code
source du document. Fonction valide pour n'importe quel document sur un lecteur local.
Arguments
node
• L'argument node doit être une balise, un commentaire ou un texte correspondant à un nœud de l'arborescence
renvoyée par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoyées
Tableau qui contient deux nombres entiers. Le premier entier correspond au décalage du début de la balise, du texte
ou du commentaire. Le second correspond au décalage de la fin du nœud, par rapport au début du document HTML.
Exemple
L'exemple de code suivant sélectionne le premier objet image du document actif :
var theDOM = dw.getDocumentDOM();
var theImg = theDOM.images[0];
var offsets = theDom.nodeToOffsets(theImg);
theDom.setSelection(offsets[0], offsets[1]);
dom.offsetsToNode()
Disponibilité
Dreamweaver 3.
Description
Obtient l'objet de l'arborescence DOM qui contient la série entière de caractères située entre l'ouverture et la fermeture
définies. Fonction valide pour n'importe quel document sur un lecteur local.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 276
Document
Arguments
offsetBegin, offsetEnd
• L'argument offsetBegin indique le décalage depuis le début du document jusqu'au début d'une série de caractères
correspondant à un objet dans l'arborescence DOM.
• L'argument offsetEnd indique le décalage depuis le début du document jusqu'à la fin d'une série de caractères
correspondant à un objet dans l'arborescence DOM.
Valeurs renvoyées
Objet balise, texte ou commentaire contenant la série de caractères spécifiée.
Exemple
Le code suivant affiche une alerte si la sélection est une image.
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()
Disponibilité
Dreamweaver 3.
Description
Effectue une opération Sélectionner tout.
Remarque : Dans la plupart des cas, cette fonction sélectionne le contenu entier du document actif. Dans certains cas
toutefois (lorsque le point d'insertion se trouve dans un tableau, par exemple), elle ne sélectionne qu'une partie du
document actif. Pour définir le document entier comme sélection, utilisez la fonction dom.setSelection().
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.getSelectedNode()
Disponibilité
Dreamweaver 3.
Description
Définit le nœud sélectionné. Revient à appeler la fonction dom.nodeToOffsets() et à transmettre la valeur renvoyée
à la fonction dom.setSelection().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 277
Document
Arguments
node, {bSelectInside}, {bJumpToNode}
• L'argument node est un nœud de texte, de commentaire ou d'élément du document.
• L'argument bSelectInside (facultatif) est une valeur booléenne qui indique s'il faut sélectionner la propriété
innerHTML du nœud. Cet argument n'est pertinent que si node est un nœud d'élément et qu'il prend par défaut la
valeur false lorsqu'il n'est pas défini.
• L'argument bJumpToNode (facultatif) est une valeur booléenne qui indique s'il faut, le cas échéant, faire défiler la
fenêtre de document pour rendre la sélection visible. S'il n'est pas défini, cet argument prend par défaut la valeur
false.
Valeurs renvoyées
Aucune.
dom.setSelection()
Disponibilité
Dreamweaver 3.
Description
Définit le début et la fin de la sélection dans le document.
Arguments
offsetBegin, offsetEnd
• Ces arguments correspondent respectivement à l'ouverture et à la fermeture de la nouvelle sélection, exprimées en
décalages de caractères dans le code source du document. Si les deux valeurs sont identiques, la nouvelle sélection
correspond à un point d'insertion. Si la nouvelle sélection n'est pas une sélection HTML valide, elle inclut les
caractères de la première sélection HTML valide. Par exemple, si offsetBegin et offsetEnd définissent
SRC="myImage.gif" comme sélection dans IMG SRC="myImage.gif", la sélection est étendue pour inclure
également la balise IMG.
Valeurs renvoyées
Aucune.
dreamweaver.nodeExists()
Disponibilité
Dreamweaver 3.
Description
Détermine si la référence au nœud indiqué est toujours valable. Il arrive souvent, lors de la rédaction d'extensions, que
vous fassiez référence à un nœud, puis que vous effectuiez une opération qui le supprime (comme définir la propriété
innerHTML ou outerHTML de son parent). Cette fonction permet de confirmer que le nœud n'a pas été supprimé avant
de commencer à faire référence à l'une de ses propriétés ou méthodes. Le nœud référencé ne doit pas nécessairement
se trouver dans le document actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 278
Document
Arguments
node
• L'argument node correspond au nœud à vérifier.
Valeurs renvoyées
Valeur booléenne : true si le nœud existe, false dans le cas contraire.
Exemple
L'exemple ci-dessous permet d'obtenir le nœud en cours, de localiser un tableau, puis d'appeler la fonction
dw.nodeExists() afin de vérifier si le nœud original existe encore :
function applyFormatToSelectedTable(){
// get current selection
var selObj = dw.getDocumentDOM().getSelectedNode();
alternateRows(dwscripts.findDOMObject("presetNames").selectedIndex,
findTable());
// restore original selection, if it still exists; if not, just select the
// table.
var selArr;
if (dw.nodeExists(selObj))
selArr = dom.nodeToOffsets(selObj);
else
selArr = dom.nodeToOffsets(findTable());
dom.setSelection(selArr[0],selArr[1]);
}
dreamweaver.selectAll()
Disponibilité
Dreamweaver 3.
Description
Effectue une opération Sélectionner tout dans la fenêtre de document active, dans le panneau Site ou, sur Macintosh,
dans le champ de texte actif d'une boîte de dialogue ou d'un panneau flottant.
Remarque : Si l'opération est effectuée dans le document actif, elle sélectionne dans la plupart des cas le contenu entier
du document. Dans certains cas toutefois (lorsque le point d'insertion se trouve dans un tableau, par exemple), elle ne
sélectionne qu'une partie du document. Pour définir le document entier comme sélection, utilisez la fonction
dom.setSelection().
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 279
Document
Activateur
Voir « dreamweaver.canSelectAll() » à la page 480.
Fonctions de manipulation de chaînes
Ces fonctions vous permettent d'obtenir des informations sur une chaîne et de convertir une chaîne Latin1 en code
national sur la plate-forme de l'utilisateur et vice versa.
dreamweaver.doURLEncoding()
Disponibilité
Dreamweaver 1.
Description
Prend une chaîne et renvoie une chaîne convertie en URL en remplaçant tous les espaces et caractères spéciaux par les
entités spécifiées.
Arguments
stringToConvert
• L'argument stringToConvert est une chaîne qui contient l'URL non codée qui est codée par la fonction.
Valeurs renvoyées
Une chaîne convertie en format d'URL.
Exemple
L'exemple suivant indique la valeur URL pour "My URL-encoded string" :
var URL = dw.doURLEncoding(theURL.value);
returns "My%20URL-encoded%20string"
dreamweaver.getTokens()
Disponibilité
Dreamweaver 1.
Description
Accepte une chaîne et la divise en expressions.
Arguments
searchString, separatorCharacters
• L'argument searchString est la chaîne à diviser en expressions.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 280
Document
• L'argument separatorCharacters est le ou les caractères indiquant la fin d'une expression. Les séparateurs figurant
dans des chaînes entre guillemets sont ignorés. Tous les espaces éventuellement contenus dans
separatorCharacters (les tabulations, par exemple) sont traités comme des séparateurs, comme si vous les aviez
définis explicitement. Deux espaces consécutifs ou plus sont traités comme un seul séparateur.
Valeurs renvoyées
Tableau d'expressions.
Exemple
L'appel de la fonction dw.getTokens() ci-dessous renvoie les expressions indiquées à la suite :
dreamweaver.getTokens('foo("my arg1", 34)', '(),')
•
foo
•
"my arg 1"
•
34
dreamweaver.latin1ToNative()
Disponibilité
Dreamweaver 2.
Description
Convertit une chaîne Latin 1 en code national sur l'ordinateur de l'utilisateur. Cette fonction permet d'afficher
l'interface utilisateur d'un fichier d'extension dans une autre langue.
Remarque : Sous Windows, cette fonction est sans effet, car le code Windows repose sur Latin 1.
Arguments
stringToConvert
• L'argument stringToConvert est la chaîne à convertir de Latin 1 en code national.
Valeurs renvoyées
Chaîne convertie.
dreamweaver.nativeToLatin1()
Disponibilité
Dreamweaver 2.
Description
Convertit une chaîne de code national en code Latin 1.
Remarque : Sous Windows, cette fonction est sans effet, car le code Windows repose sur Latin 1.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 281
Document
Arguments
stringToConvert
• L'argument stringToConvert est la chaîne à convertir du code national en code Latin 1.
Valeurs renvoyées
Chaîne convertie.
dreamweaver.scanSourceString()
Disponibilité
Dreamweaver UltraDev 1.
Description
Analyse une chaîne de code HTML et recherche les balises, les attributs, les directives et le texte. Pour chaque balise,
attribut, directive et texte trouvé, la fonction scanSourceString() lance une fonction de rappel fournie par
l'appelant. Dreamweaver prend en charge les fonctions de rappel suivantes :
•
openTagBegin()
•
openTagEnd()
•
closeTagBegin()
•
closeTagEnd()
•
directive()
•
attribute()
•
text()
Dreamweaver appelle les sept fonctions de rappel dans les cas suivants :
• Dreamweaver appelle openTagBegin() pour chaque balise d'ouverture (par exemple <font>, et non </font>) et
chaque balise vide (par exemple, <img> ou <hr>). La fonction openTagBegin() accepte deux arguments : le nom
de la balise à fermer (par exemple, "font" ou "img") et le décalage du document, qui correspond au nombre
d'octets contenus dans le document avant le début de la balise de fermeture. La fonction renvoie la valeur true si
l'analyse doit continuer et false si elle doit s'arrêter.
• Une fois openTagBegin() exécutée, Dreamweaver appelle attribute() pour chaque attribut HTML. La fonction
attribute() accepte deux arguments: une chaîne contenant le nom de l'attribut (par exemple "color" ou "src")
et une chaîne contenant la valeur de l'attribut (par exemple "#000000" ou "foo.gif"). La fonction attribute()
renvoie une valeur booléenne indiquant si l'analyse doit continuer.
• Une fois que tous les attributs de la balise ont été analysés, Dreamweaver appelle openTagEnd(). La fonction
openTagEnd() accepte un argument : le décalage du document, qui est le nombre d'octets contenus dans le
document avant la fin de la balise d'ouverture. Elle renvoie une valeur booléenne qui indique si l'analyse doit
continuer.
• Dreamweaver appelle closeTagBegin() pour chaque balise de fermeture (par exemple </font>). Cette fonction
accepte deux arguments: le nom de la balise à fermer (par exemple, "font") et le décalage du document, qui
correspond au nombre d'octets contenus dans le document avant le début de la balise de fermeture. La fonction
renvoie une valeur booléenne qui indique si l'analyse doit continuer.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 282
Document
• Une fois closeTagBegin() terminée, Dreamweaver appelle la fonction closeTagEnd(). La fonction
closeTagEnd() accepte un argument : le décalage du document, qui correspond au nombre d'octets contenus dans
le document avant la fin de la balise de fermeture. Elle renvoie une valeur booléenne qui indique si l'analyse doit
continuer.
• Dreamweaver appelle la fonction directive() pour chaque commentaire HTML, script ASP, script JSP ou script
PHP. La fonction directive() accepte deux arguments : une chaîne contenant la directive et le décalage du
document, qui correspond au nombre d'octets contenus dans le document avant la fin de la balise de fermeture. La
fonction renvoie une valeur booléenne qui indique si l'analyse doit continuer.
• Dreamweaver appelle la fonction text() pour chaque portion de texte du document, c'est-à-dire tout ce qui n'est
pas une balise ni une directive. Les portions de texte incluent le texte qui n'est pas visible pour l'utilisateur, par
exemple le texte contenu à l'intérieur d'une balise title ou option. La fonction text() accepte deux arguments:
une chaîne contenant le texte et le décalage du document, qui correspond au nombre d'octets contenus dans le
document avant la fermeture de la balise de fermeture. La fonction text() renvoie une valeur booléenne qui
indique si l'analyse doit continuer.
Arguments
HTMLstr, parserCallbackObj
• L'argument HTMLstr est une chaîne qui contient un code.
• L'argument parserCallbackObj est un objet JavaScript comportant une ou plusieurs des méthodes suivantes :
openTagBegin(), openTagEnd(), closeTagBegin(), closeTagEnd(), directive(), attribute() et text().
Pour de meilleurs résultats, parserCallbackObj doit être une bibliothèque partagée définie à l'aide de l'interface
Extension C. Vous obtiendrez également de meilleures performances si la fonction parserCallbackObj définit
uniquement les fonctions de rappel dont elle a besoin.
Valeurs renvoyées
Valeur booléenne, true si l'opération a réussi et false dans le cas contraire.
Exemple
La séquence d'étapes suivante offre un exemple d'utilisation de la fonction dreamweaver.scanSourceString() :
1 Créez une implémentation pour une ou plusieurs des sept fonctions de rappel.
2 Ecrivez un script qui appelle la fonction dreamweaver.scanSourceString().
3 La fonction dreamweaver.scanSourceString() transmet une chaîne contenant le code HTML et les pointeurs
des fonctions de rappel que vous avez écrits. Par exemple, supposons que la chaîne HTML soit <"font
size=hello/font>".
4 Dreamweaver analyse la chaîne et détermine si elle contient une balise de police. Dreamweaver appelle les fonctions
de rappel dans l'ordre suivant :
• Fonction openTagBegin()
• Fonction attribute() (pour l'attribut de taille)
• Fonction openTagEnd()
• Fonction text() (pour la chaîne "hello")
• Fonctions closeTagBegin() et closeTagEnd()
RÉFÉRENCE DES API DE DREAMWEAVER CS4 283
Document
Fonctions relatives à la traduction
Ces fonctions permettent d'agir directement sur les traducteurs de données ou sur les résultats de la traduction. Elles
permettent d'exécuter ou d'obtenir des informations sur un traducteur, de modifier le contenu d'une région verrouillée
et de stipuler que le code traduit doit être utilisé lors de l'obtention et de la définition de décalages de sélection.
dom.runTranslator()
Disponibilité
Dreamweaver 3.
Description
Cette fonction exécute le traducteur spécifié sur le document. Cette fonction n'est valide que pour le document actif.
Arguments
translatorName
• L'argument translatorName est le nom d'un traducteur tel qu'il apparaît dans les préférences de traduction.
Valeurs renvoyées
Aucune.
dreamweaver.editLockedRegions()
Disponibilité
Dreamweaver 2.
Description
Selon la valeur de l'argument, autorise ou non la modification des régions verrouillées. Par défaut, les régions
verrouillées ne peuvent pas être modifiées. Si vous tentez de modifier une région verrouillée avant de la rendre
modifiable avec cette fonction, Dreamweaver émet un bip et interdit la modification.
Remarque : La modification de régions verrouillées peut avoir des conséquences inattendues sur les éléments de
bibliothèque et les modèles. N'utilisez cette fonction qu'avec les traducteurs de données.
Arguments
bAllowEdits
• L'argument bAllowEdits est une valeur booléenne : true indique que les modifications sont interdites et false le
contraire. Dreamweaver restaure automatiquement l'état par défaut (non modifiable) des régions verrouillées
lorsque l'exécution du script qui appelle la fonction prend fin.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 284
Document
dreamweaver.getTranslatorList()
Disponibilité
Dreamweaver 3.
Description
Cette fonction obtient la liste des traducteurs de données installés.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes, chacune représentant le nom d'un traducteur tel qu'il apparaît dans les préférences de traduction.
dreamweaver.useTranslatedSource()
Disponibilité
Dreamweaver 2.
Description
Cette fonction indique les valeurs renvoyées par dom.nodeToOffsets() et dom.getSelection(). Elles sont utilisées
par dom.offsetsToNode() et dom.setSelection() et doivent être décalées dans le code source converti (code
HTML contenu dans l'arborescence DOM après l'exécution du traducteur) et non dans le code source non converti.
Remarque : Cette fonction ne s'applique qu'aux fichiers de l'inspecteur Propriétés.
Arguments
bUseTranslatedSource
• L'argument bUseTranslatedSource est une valeur booléenne : true si la fonction utilise des décalages dans la source
traduite, et false si elle utilise la source non traduite.
La valeur par défaut de l'argument est false. Lorsque le script appelant la fonction dw.useTranslatedSource()
prend fin, Dreamweaver utilise automatiquement le code source non converti pour les appels suivants de
dw.getSelection(), dw.setSelection(), dw.nodeToOffsets() et dw.offsetsToNode(), sauf si la fonction
dw.useTranslatedSource() est appelée explicitement avec l'argument false avant la fin de l'exécution du
script.
Valeurs renvoyées
Aucune.
Fonctions XSLT
Les fonctions XSLT permettent d'agir sur les fichiers XML. Elles permettent d'obtenir des informations sur les
documents XML, y compris l'arborescence de schémas ou la référence à un document XML, et invitent l'utilisateur à
indiquer le document XML associé au document XSLT actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 285
Document
MMXSLT.getXML()
Disponibilité
Dreamweaver CS3.
Description
Obtient une chaîne de source XML pour un fichier XML.
Arguments
xmlSourceURI
• Chaîne représentant un URI vers un fichier XML. Cet URI peut être absolu (http ou https), relatif au site ou relatif
au document.
Valeurs renvoyées
Une chaîne contenant le contenu du fichier XML.
Exemple
var xmlSource = MMXSLT.getXML(this.fileDataSetURL);
MMXSLT.getXMLSchema()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'arborescence de schémas du fichier XML spécifié.
Arguments
schemaURI, {bRefresh}
• L'argument obligatoire schemaURI est une chaîne correspondant à une référence à un fichier XML local ou distant.
• L'argument facultatif bRefresh est une valeur booléenne : true force l'actualisation du schéma et false renvoie la
copie du schéma à partir du cache de schémas XML. La valeur par défaut est false.
Valeurs renvoyées
Chaîne contenant l'arborescence de schémas XML.
Exemple
L'exemple suivant obtient l'arborescence de schémas à partir du cache de schémas XML pour le fichier menus.xml :
var theSchema = MMXSLT.getXMLSchema("file:///c:/Program Files/Adobe/¬
Adobe Dreamweaver CS4/Configuration/Menus/menus.xml"");
RÉFÉRENCE DES API DE DREAMWEAVER CS4 286
Document
MMXSLT.getXMLSourceURI()
Disponibilité
Dreamweaver 8.
Description
Cette fonction obtient une référence au document source XML associé au document XSLT actif.
Arguments
xsltfileURI, {bUseTempForRemote}
• L'argument xsltfileURI est une chaîne correspondant à l'URI du fichier local qui pointe vers l'emplacement du
fichier XSL.
• L'argument facultatif bUseTempForRemote est une valeur booléenne : true renvoie une référence au fichier XML
temporaire (par exemple file:///C:/Documents and Settings/username/Local Settings/Temporary
Internet Files/Content.IE5/GTSLQ9KZ/rss[1].xml) qui est téléchargé lorsque le fichier XML est distant
(par exemple http://myHost/rssfeed.xml) ; false renvoie une référence absolue.
Valeurs renvoyées
Une chaîne contenant la référence au document source XML associé au document XSLT actif. Si la référence à la
source XML est une référence distante, la fonction renvoie le chemin d'accès à l'emplacement temporaire du fichier
téléchargé.
Exemple
L'exemple suivant obtient la référence au document source XML associé à c:\myxslt\myxsltdocument.xsl :
var theXMLSource = MMXSLT.getXMLSourceURI("file:///c:/myxslt/myxsltdocument.xsl");
MMXSLT.launchXMLSourceDialog()
Disponibilité
Dreamweaver 8.
Description
Cette fonction invite l'utilisateur à indiquer le document source XML associé au document XSLT actif. L'utilisateur
peut choisir une référence soit locale soit distante à un document XML.
Arguments
{xsltfileURI}, {bUseTempForRemote}, {bAddSchemaReference}
• L'argument xsltfileURI est facultatif. Il s'agit d'une chaîne correspondant à l'URI du fichier local qui pointe vers
l'emplacement du fichier XSL. Si cet argument n'est pas défini, il prend comme valeur par défaut le document
actuellement ouvert.
• L'argument facultatif bUseTempForRemote est une valeur booléenne : true renvoie une référence au fichier XML
temporaire (par exemple file:///C:/Documents and Settings/username/Local Settings/Temporary
Internet Files/Content.IE5/GTSLQ9KZ/rss[1].xml) qui est téléchargé lorsque le fichier XML est distant
(par exemple http://myHost/rssfeed.xml) ; false renvoie une référence absolue.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 287
Document
• L'argument bAddSchemaReference est facultatif. Il ajoute une référence dans le document actif qui pointe vers l'URI
de la source XML spécifiée dans la boîte de dialogue de la source XML. Si cet argument n'est pas défini, il prend
comme valeur par défaut le document actuellement ouvert.
Valeurs renvoyées
Une chaîne contenant la référence au document source XML associé au document XSLT actif. Si la référence à la
source XML est une référence distante, la fonction renvoie le chemin d'accès à l'emplacement temporaire du fichier
téléchargé.
Exemple
L'exemple suivant ouvre la boîte de dialogue Document source XML sans indiquer de valeur :
MMXSLT.launchXMLSourceDialog()
288
Chapitre 15 : Contenu de page
Les fonctions relatives au contenu de page d'Adobe® Dreamweaver® permettent d'effectuer des opérations qui affectent
le contenu d'une page Web. Ces opérations sont les suivantes :
• Manipulation d'actifs dans le panneau Actifs
• Ajout de comportements
• Manipulation d'éléments en les coupant et en les collant dans le Presse-papiers
• Application d'un modèle
• Insertion d'un fragment de code
• Création d'ensembles de données XML Spry
• Modification améliorée de Spry et d'autres widgets
• Insertion de widgets
• Création de mises en page qui fonctionnent dans divers navigateurs, grâce aux fonctions de vérification de la
compatibilité avec les navigateurs
Fonctions du panneau Actifs
Ces fonctions, programmées dans l'API comme panneau d'actifs, vous permettent de gérer et d'utiliser les éléments
contenus dans le panneau Actifs (modèles, bibliothèques, images, contenu Adobe Shockwave et Adobe Flash, URL,
couleurs et scripts).
dreamweaver.assetPalette.addToFavoritesFrom Document()
Disponibilité
Dreamweaver 4.
Description
Ajoute l'élément sélectionné dans la fenêtre de document à la liste des favoris. Cette fonction prend uniquement en
charge les images, les fichiers Shockwave, les fichiers Flash, les couleurs de police et les URL.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.addToFavoritesFromSiteAssets()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 289
Contenu de page
Description
Ajoute les éléments sélectionnés dans la liste des sites à la liste des favoris et donne à chaque élément un surnom. Cette
fonction ne supprime pas les éléments de la liste des sites.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.addToFavoritesFromSiteWindow()
Disponibilité
Dreamweaver 4.
Description
Ajoute les éléments sélectionnés dans le panneau Site à la liste des favoris. Cette fonction ne prend en charge que les
images, les films, les scripts, les fichiers Shockwave et les fichiers FLA. Si d'autres dossiers ou fichiers sont sélectionnés,
ils sont ignorés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.copyToSite()
Disponibilité
Dreamweaver 4.
Description
Copie les éléments sélectionnés dans un autre site et les place dans la liste des favoris de celui-ci. Si ces éléments sont
des fichiers (autres que des couleurs ou des URL), le fichier réel est copié dans ce site.
Arguments
targetSite.
• L'argument targetSite est le nom du site cible renvoyé par l'appel site.getSites().
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 290
Contenu de page
dreamweaver.assetPalette.edit()
Disponibilité
Dreamweaver 4.
Description
Modifie les éléments sélectionnés à l'aide de l'éditeur externe principal ou de la commande d'édition personnalisée.
Pour les couleurs, le sélecteur de couleur s'affiche. S'il s'agit d'URL, une boîte de dialogue invite l'utilisateur à entrer
une URL et un surnom. Cette fonction n'est pas disponible pour la liste de couleurs et les URL du site.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.assetPalette.canEdit() » à la page 473.
dreamweaver.assetPalette.getSelectedCategory()
Disponibilité
Dreamweaver 4.
Description
Renvoie la catégorie sélectionnée.
Arguments
Aucun.
Valeurs renvoyées
La catégorie actuellement sélectionnée, qui peut être l'une des suivantes : "templates", "library", "images",
"movies", "shockwave", "flash", "scripts", "colors" ou "urls".
dreamweaver.assetPalette.getSelectedItems()
Disponibilité
Dreamweaver 4.
Description
Renvoie un tableau des éléments sélectionnés dans le panneau Actifs, soit dans la liste des sites, soit dans celle des
favoris.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 291
Contenu de page
Valeurs renvoyées
Tableau de trois chaînes pour chaque élément sélectionné :
• La chaîne name est le nom, le nom de fichier ou le surnom qui s'affiche dans le panneau Actifs.
• La chaîne value est le chemin entier, l'URL complète ou la valeur chromatique, selon l'élément sélectionné.
• La chaîne type, qui peut être "folder" ou l'une des catégories suivantes : "templates",
"library", "images",
"movies", "shockwave", "flash", "scripts", "colors" ou "urls".
Remarque : Si aucun élément n'est sélectionné dans le panneau Actifs, cette fonction renvoie un tableau contenant une
seule chaîne vide.
Exemple
Si « URL » est la catégorie et que le dossier « MyFolderName » et l'URL « MyFavoriteURL » sont sélectionnés dans la
liste des favoris, la fonction renvoie :
items[0]
items[1]
items[2]
items[3]
items[4]
items[5]
=
=
=
=
=
=
"MyFolderName"
"//path/FolderName"
"folder"
"MyFavoriteURL"
"http://www.MyFavoriteURL.com"
"urls"
dreamweaver.assetPalette.getSelectedView()
Disponibilité
Dreamweaver 4.
Description
Indique quelle liste est affichée dans le panneau Actifs.
Arguments
Aucun.
Valeurs renvoyées
Renvoie une chaîne comportant la valeur "site" ou "favorites".
dreamweaver.assetPalette.insertOrApply()
Disponibilité
Dreamweaver 4.
Description
Insère les éléments sélectionnés ou applique l'élément à la sélection en cours. Cette fonction applique des modèles, des
couleurs et des URL à la sélection. Elle insère également des URL et d'autres éléments au niveau du point d'insertion.
Si aucun document n'est ouvert, la fonction n'est pas disponible.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 292
Contenu de page
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.assetPalette.canInsertOrApply() » à la page 474.
dreamweaver.assetPalette.locateInSite()
Disponibilité
Dreamweaver 4.
Description
Sélectionne les fichiers associés aux éléments sélectionnés du côté local du panneau Site. Cette fonction n'est pas
applicable aux couleurs ni aux URL. Elle est disponible dans la liste des sites et la liste des favoris. Si un dossier est
sélectionné dans la liste des favoris, il est ignoré.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.newAsset()
Disponibilité
Dreamweaver 4.
Description
Crée un nouvel élément correspondant à la catégorie en cours dans la liste des favoris. Dans le cas des bibliothèques et
des modèles, l'élément créé est un nouveau fichier de bibliothèque ou de modèle vierge auquel l'utilisateur peut
immédiatement attribuer un nom. Pour les couleurs, le sélecteur de couleur s'affiche. S'il s'agit d'URL, une boîte de
dialogue invite l'utilisateur à entrer une URL et un surnom. Cette fonction n'est pas disponible pour les images, les
fichiers Shockwave, les fichiers Flash ou les scripts.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.newFolder()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 293
Contenu de page
Description
Crée un nouveau dossier ayant un nom par défaut (sans nom) dans la catégorie en cours et place une zone de texte
autour du nom. Cette fonction est uniquement disponible dans la liste des favoris.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.recreateLibraryFrom Document()
Disponibilité
Dreamweaver 4.
Description
Remplace l'ancienne fonction libraryPalette, recreateLibraryFromDocument(). Il remplace un fichier
d'élément de bibliothèque (Library item ou LBI) pour l'instance sélectionnée d'un élément de bibliothèque dans le
document actif. Revient à cliquer sur Créer à nouveau dans l'inspecteur Propriétés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.refreshSiteAssets()
Disponibilité
Dreamweaver 4.
Description
Analyse le site, affiche la liste des sites et y ajoute des données.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.removeFromFavorites()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 294
Contenu de page
Description
Supprime les éléments sélectionnés de la liste des favoris. Cette fonction ne supprime pas les fichiers du disque, sauf
dans le cas d'une bibliothèque ou d'un modèle où l'utilisateur est invité à confirmer l'opération avant que le fichier ne
soit supprimé. Cette fonction est uniquement disponible dans la liste des favoris ou si la catégorie est Library ou
Templates.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.renameNickname()
Disponibilité
Dreamweaver 4.
Description
Affiche une zone de texte autour du nom du dossier ou du surnom du fichier pour pouvoir le modifier. Cette fonction
est uniquement disponible dans la liste des favoris ou pour la catégorie Library ou Template.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.assetPalette.setSelectedCategory()
Disponibilité
Dreamweaver 4.
Description
Affiche une catégorie différente.
Arguments
categoryType.
• L'argument categoryType peut être l'une des catégories suivantes : "templates", "library", "images",
"movies", "shockwave", "flash", "scripts", "colors" ou "urls".
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 295
Contenu de page
dreamweaver.assetPalette.setSelectedView()
Disponibilité
Dreamweaver 4.
Description
Passe de la liste des sites à la liste des favoris et vice versa.
Arguments
viewType.
• L'argument viewType est une chaîne qui peut être "site" ou "favorites".
Valeurs renvoyées
Aucune.
dreamweaver.referencePalette.getFontSize()
Disponibilité
Dreamweaver 4.
Description
Renvoie la taille de police actuelle de la zone d'affichage du panneau Référence.
Arguments
Aucun.
Valeurs renvoyées
Les tailles de police relatives exprimées par les valeurs small, medium ou large.
dreamweaver.referencePalette.setFontSize()
Disponibilité
Dreamweaver 4.
Description
Modifie la taille de police affichée dans le panneau Référence.
Arguments
fontSize.
• L'argument fontSize est l'une des tailles relatives suivantes : small, medium ou large.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 296
Contenu de page
Fonctions relatives aux comportements
Ces fonctions vous permettent d'associer des comportements à un objet ou de les en dissocier, d'identifier les
comportements associés à un objet, d'obtenir des informations sur un objet auquel est associé un comportement, etc.
Les méthodes de l'objet dreamweaver.behaviorInspector contrôlent ou agissent uniquement sur la sélection dans
le panneau Comportements et non sur la sélection dans le document actif.
dom.addBehavior()
Disponibilité
Dreamweaver 3.
Description
Associe un nouveau couple événement/action (comportement) à l'élément sélectionné. Cette fonction n'est valide que
pour le document actif.
Arguments
event, action, {eventBasedIndex}
• L'argument event est le gestionnaire d'événements JavaScript à utiliser pour associer le comportement à l'élément
(par exemple, onClick, onMouseOver ou onLoad).
• L'argument action est l'appel de fonction qui serait renvoyé par applyBehavior() si l'action était ajoutée à l'aide
du panneau Comportements (par exemple, "MM_popupMsg('Hello World')").
• L'argument facultatif eventBasedIndex est la position à laquelle cette action doit être ajoutée. L'argument
eventBasedIndex est un index de référence zéro. Par conséquent, s'il existe déjà deux actions associées à l'événement
en question et que vous spécifiez eventBasedIndex comme étant l'action 1, cette dernière sera insérée et exécutée
entre les deux autres. Si vous ne définissez pas cet argument, l'action est insérée à la suite des actions déjà associées
à l'événement spécifié.
Valeurs renvoyées
Aucune.
dom.getBehavior()
Disponibilité
Dreamweaver 3.
Description
Obtient l'action qui se trouve à la position indiquée dans l'événement spécifié. Cette fonction agit sur la sélection en
cours et n'est valide que pour le document actif.
Arguments
event, {eventBasedIndex}
• L'argument event est le gestionnaire d'événements JavaScript à utiliser pour associer le comportement à l'élément
(par exemple, onClick, onMouseOver ou onLoad).
RÉFÉRENCE DES API DE DREAMWEAVER CS4 297
Contenu de page
• L'argument facultatif eventBasedIndex est la position de l'action à obtenir. Par exemple, si deux actions sont
associées à l'événement spécifié, 0 est la première et 1 la seconde. Si cet argument n'est pas défini, la fonction renvoie
toutes les actions associées à l'événement spécifié.
Valeurs renvoyées
Chaîne représentant l'appel de fonction (par exemple
"MM_swapImage('document.Image1','document.Image1','foo.gif','#933292969950')") ou tableau de
chaînes, si vous n'avez pas défini l'argument eventBasedIndex.
dom.reapplyBehaviors()
Disponibilité
Dreamweaver 3.
Description
Vérifie si les fonctions associées aux appels de comportement sur le nœud spécifié sont présentes dans la section HEAD
du document et, dans le cas contraire, les y insère.
Arguments
elementNode.
• L'argument elementNode est un nœud d'élément du document actif. Si cet argument n'est pas défini, Dreamweaver
recherche les appels de comportement orphelins sur tous les nœuds d'élément du document.
Valeurs renvoyées
Aucune.
dom.removeBehavior()
Disponibilité
Dreamweaver 3.
Description
Supprime l'action qui se trouve à la position indiquée dans l'événement spécifié. Cette fonction agit sur la sélection en
cours et n'est valide que pour le document actif.
Arguments
event, {eventBasedIndex}
• L'argument event est le gestionnaire d'événements JavaScript à utiliser pour associer le comportement à l'élément
(par exemple, onClick, onMouseOver ou onLoad). Si cet argument n'est pas défini, toutes les actions sont
supprimées de l'élément.
• L'argument facultatif eventBasedIndex est la position de l'action à supprimer. Par exemple, si deux actions sont
associées à l'événement spécifié, 0 est la première et 1 la seconde. Si cet argument n'est pas défini, toutes les actions
associées à l'événement sélectionné sont supprimées.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 298
Contenu de page
Valeurs renvoyées
Aucune.
dreamweaver.getBehaviorElement()
Disponibilité
Dreamweaver 2, mise à jour dans CS4.
Description
Obtient l'objet DOM correspondant à la balise à laquelle le comportement est appliqué. Cette fonction ne s'applique
qu'aux fichiers d'action de comportement.
Arguments
Aucun.
Valeurs renvoyées
Un objet DOM ou une valeur null. Cette fonction renvoie la valeur null dans les cas suivants :
• lorsque le script en cours d'exécution n'est pas actif dans le contexte du panneau Comportements ;
• lorsque dreamweaver.popupAction() démarre le script en cours d'exécution ;
• lorsque le panneau Comportements associe un événement à un empaqueteur de lien et que ce dernier n'existe pas ;
• lorsque cette fonction se trouve en dehors d'un fichier d'action.
Exemple
La fonction dreamweaver.getBehaviorElement() peut être utilisée de la même façon que
« dreamweaver.getBehaviorTag() » à la page 299 afin de déterminer si l'action sélectionnée est appropriée pour la
balise HTML sélectionnée. Elle s'en distingue par le fait qu'elle donne accès à plus d'informations au sujet de la balise
et de ses attributs. Si vous écrivez une action qui ne peut être appliquée qu'à un lien hypertexte (A HREF) qui ne prend
pas pour cible un autre cadre ou une autre fenêtre, vous pouvez utiliser la fonction getBehaviorElement(). Vous
pouvez utiliser la fonction getBehaviorElement() au sein de la fonction qui initialise l'interface utilisateur pour la boîte
de dialogue Paramètres. Ce principe est illustré dans l'exemple suivant :
function initializeUI(){
var theTag = dreamweaver.getBehaviorElement();
var CANBEAPPLIED = (theTag.tagName == "A" && ¬
theTag.getAttribute("HREF") != null && ¬
theTag.getAttribute("TARGET") == null);
if (CANBEAPPLIED) {
// display the action user interface
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// link without an explicit target]
}
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 299
Contenu de page
dreamweaver.getBehaviorTag()
Disponibilité
Dreamweaver 1.2.
Description
Obtient la source de la balise à laquelle le comportement est appliqué. Cette fonction ne s'applique qu'aux fichiers
d'action.
Arguments
Aucun.
Valeurs renvoyées
Chaîne représentant la source de la balise. Il s'agit de la chaîne transmise à la fonction canAcceptBehavior() sous forme
d'argument (HTMLelement). Si cette fonction apparaît en dehors d'un fichier d'action, la valeur renvoyée est une chaîne vide.
Exemple
Si vous créez une action qui ne peut être appliquée qu'à un lien hypertexte (A HREF), vous pouvez utiliser la fonction
getBehaviorTag(), comme indiqué dans l'exemple suivant, dans la fonction qui initialise l'interface utilisateur de la
boîte de dialogue Paramètres :
function initializeUI(){
var theTag = dreamweaver.getBehaviorTag().toUpperCase();
var CANBEAPPLIED = (theTag.indexOf('HREF') != -1));
if (CANBEAPPLIED) {
// display the action UI
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// hyperlink
}
}
dreamweaver.popupAction()
Disponibilité
Dreamweaver 2, mise à jour dans CS4.
Description
Lance une boîte de dialogue de paramètres correspondant à l'action de comportement spécifiée. Pour l'utilisateur, cela
revient à sélectionner l'action dans le menu déroulant des actions du panneau Comportements. Cette fonction permet
aux fichiers d'extension autres que des actions d'associer des comportements aux objets dans le document de
l'utilisateur. L'utilisateur ne peut effectuer aucune autre modification tant qu'il n'a pas fermé la boîte de dialogue.
Remarque : Cette fonction peut être appelée au sein de la fonction objectTag() ou dans tout script de fichier de
commande ou dans le fichier de l'inspecteur Propriétés.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 300
Contenu de page
Arguments
actionName, {funcCall}
• L'argument actionName est une chaîne qui contient le nom d'un fichier dans le dossier
Configuration/Behaviors/Actions. Ce fichier contient une action de comportement JavaScript (par exemple, « Swap
Image.htm »).
• L'argument facultatif funcCall est une chaîne contenant un appel de fonction pour l'action définie dans
actionName (par exemple, "MM_SwapImage(...)"). La fonction applyBehavior() du fichier d'action fournit cet
argument, s'il a été spécifié.
Valeurs renvoyées
Appel de fonction de l'action de comportement. Lorsque l'utilisateur clique sur OK dans la boîte de dialogue
Paramètres, le comportement est ajouté au document actuel. Les fonctions appropriées sont ajoutées à la section HEAD
du document. Du code HTML est ajouté à la section BODY et d'autres modifications peuvent être apportées au
document. L'appel de fonction ("MM_SwapImage(...)", par exemple) n'est pas ajouté au document ; il devient la valeur
renvoyée par cette fonction.
dreamweaver.behaviorInspector.getBehaviorAt()
Disponibilité
Dreamweaver 3.
Description
Obtient le couple événement/action (comportement) qui se trouve à la position indiquée dans le panneau
Comportements.
Arguments
positionIndex.
• L'argument positionIndex est la position de l'action dans le panneau Comportements. La première action de la liste
est à la position 0.
Valeurs renvoyées
Tableau constitué de deux éléments :
• un gestionnaire d'événements ;
• un appel de fonction ou une instruction JavaScript.
Exemple
positionIndex étant un index en base zéro, si le panneau Comportements affiche la liste, un appel de la fonction
dreamweaver.behaviorInspector.getBehaviorAt(2) renvoie un tableau contenant deux éléments :
"onMouseOver" et "MM_changeProp('document.moon','document.moon','src','sun.gif','MG')".
dreamweaver.behaviorInspector.getBehaviorCount()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 301
Contenu de page
Description
Compte le nombre d'actions associées à l'élément actuellement sélectionné à l'aide de gestionnaires d'événements.
Arguments
Aucun.
Valeurs renvoyées
Nombre entier qui représente le nombre d'actions attachées à l'élément. Ce nombre est équivalent au nombre d'actions
visibles dans le panneau Comportements et comprend les actions de comportement Dreamweaver et le code JavaScript
personnalisé.
Exemple
Un appel à la fonction dreamweaver.behaviorInspector.getBehaviorCount() pour le lien sélectionné <A
HREF="javascript:setCookie()" onClick="MM_popupMsg('Un cookie a été
défini.');parent.rightframe.location.href='aftercookie.html'>" renvoie la valeur 2.
dreamweaver.behaviorInspector.getSelectedBehavior()
Disponibilité
Dreamweaver 3.
Description
Obtient la position de l'action sélectionnée dans le panneau Comportements.
Arguments
Aucun.
Valeurs renvoyées
Un nombre entier qui représente la position de l'action sélectionnée dans le panneau Comportements ou –1 si aucune
action n'est sélectionnée.
Exemple
Si la première action du panneau Comportements est sélectionnée, un appel de la fonction
dreamweaver.behaviorInspector.getSelectedBehavior() renvoie 0.
dreamweaver.behaviorInspector.moveBehaviorDown()
Disponibilité
Dreamweaver 3.
Description
Déplace une action de comportement vers le bas, à l'intérieur d'une séquence, en modifiant son ordre d'exécution au
sein d'un événement.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 302
Contenu de page
Arguments
positionIndex.
• L'argument positionIndex est la position de l'action dans le panneau Comportements. La première action de la liste
est à la position 0.
Valeurs renvoyées
Aucune.
Exemple
L'appel de la fonction dreamweaver.behaviorInspector.moveBehaviorDown(2) inverse les positions des actions
Précharger les images et Changer la propriété de l'événement onMouseDown. Pour toute autre position, la fonction
dreamweaver.behaviorInspector.moveBehaviorDown() n'a aucun effet, car un seul comportement est associé
aux événements onClick et onFocus et le comportement figurant à la position 3 se trouve déjà à la fin du groupe
onMouseDown.
Voir aussi
« dreamweaver.behaviorInspector.getSelectedBehavior() » à la page 301
RÉFÉRENCE DES API DE DREAMWEAVER CS4 303
Contenu de page
dreamweaver.behaviorInspector.moveBehaviorUp()
Disponibilité
Dreamweaver 3.
Description
Déplace un comportement vers le haut, à l'intérieur d'une séquence, en modifiant son ordre d'exécution au sein d'un
événement.
Arguments
positionIndex.
• L'argument positionIndex est la position de l'action dans le panneau Comportements. La première action de la liste
est à la position 0.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 304
Contenu de page
Exemple
L'appel de la fonction dreamweaver.behaviorInspector.moveBehaviorUp(3) inverse les positions des actions
Précharger les images et Changer la propriété de l'événement onMouseOver. Pour toute autre position, la fonction
dreamweaver.behaviorInspector.moveBehaviorUp() n'a aucun effet, car un seul comportement est associé aux
événements onClick et onFocus et le comportement figurant à la position 2 se trouve déjà au début du groupe
onMouseDown.
Voir aussi
« dreamweaver.behaviorInspector.getSelectedBehavior() » à la page 301
dreamweaver.behaviorInspector.setSelectedBehavior()
Disponibilité
Dreamweaver 3.
Description
Sélectionne l'action qui se trouve à la position indiquée dans le panneau Comportements.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 305
Contenu de page
Arguments
positionIndex.
• L'argument positionIndex est la position de l'action dans le panneau Comportements. La première action de la liste
est à la position 0. Pour désélectionner toutes les actions, spécifiez l'index de position (positionIndex) sur –1.
Spécifier une position à laquelle ne correspond aucune action revient à spécifier –1.
Valeurs renvoyées
Aucune.
Exemple
L'appel de la fonction dreamweaver.behaviorInspector.setSelection(2) sélectionne l'action Changer la
propriété qui est associée à l'événement onMouseDown :
Voir aussi
« dreamweaver.behaviorInspector.getSelectedBehavior() » à la page 301
RÉFÉRENCE DES API DE DREAMWEAVER CS4 306
Contenu de page
Presse-papiers, fonctions
Ces fonctions permettent de copier, de couper et de coller des informations à l'aide du Presse-papiers. Sur un
ordinateur Macintosh, certaines fonctions du Presse-papiers peuvent également être appliquées aux champs de texte
des boîtes de dialogue et des panneaux flottants. Dans ce cas, elles peuvent être implémentées en tant que méthodes de
l'objet dreamweaver ou en tant que méthodes de l'objet DOM. La version dreamweaver de cette fonction agit sur la
sélection dans la fenêtre active : la fenêtre de document actuelle, l'inspecteur de code ou le panneau Site. Sur un
ordinateur Macintosh, la fonction peut également être appliquée au contenu sélectionné d'une zone de texte s'il s'agit
du champ en cours. La version DOM de la fonction agit toujours sur la sélection dans le document spécifié.
dom.clipCopy()
Disponibilité
Dreamweaver 3.
Description
Copie la sélection dans le Presse-papiers avec toutes les balises HTML correspondantes.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.clipCopyText()
Disponibilité
Dreamweaver 3.
Description
Copie le texte sélectionné dans le Presse-papiers sans les balises HTML correspondantes.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canClipCopyText() » à la page 464.
dom.clipCut()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 307
Contenu de page
Description
Coupe la sélection et la place dans le Presse-papiers, avec toutes les balises HTML correspondantes.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.clipPaste()
Disponibilité
Dreamweaver 3.
Description
Colle le contenu du Presse-papiers dans le document actif, au niveau du point d'insertion ou par dessus la sélection en
cours. Si le Presse-papiers contient des balises HTML, celles-ci sont interprétées comme telles.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canClipPaste() » à la page 464.
Exemple
Si le Presse-papiers contient ABC Widgets, un appel à la fonction dw.getDocumentDOM().clipPaste() produira le
résultat suivant :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 308
Contenu de page
dreamweaver.clipCopy()
Disponibilité
Dreamweaver 3.
Description
Copie la sélection à partir de la fenêtre de document, la boîte de dialogue, le panneau Site ou le panneau flottant en
cours dans le Presse-papiers.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canClipCopy() » à la page 474.
dreamweaver.clipCut()
Disponibilité
Dreamweaver 3.
Description
Supprime la sélection dans la fenêtre de document, la boîte de dialogue, le panneau Site ou le panneau flottant actif
pour la placer dans le Presse-papiers.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canClipCut() » à la page 474.
dreamweaver.clipPaste()
Disponibilité
Dreamweaver 3. Ajout de l'argument strPasteOption dans Dreamweaver8.
Description
Colle le contenu du Presse-papiers dans la fenêtre de document, la boîte de dialogue, le panneau flottant ou le panneau
Site actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 309
Contenu de page
Arguments
{strPasteOption}
• L'argument facultatif strPasteOption indique le type de collage à effectuer. Les valeurs sont "text", "structured",
"basicFormat" ou "fullFormat".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canClipPaste() » à la page 475.
Exemple
L'exemple suivant colle le contenu du Presse-papiers sous forme de texte :
dw.clipPaste("text");
dreamweaver.getClipboardText()
Disponibilité
Dreamweaver 3.
Description
Obtient tout le texte mémorisé dans le Presse-papiers.
Arguments
{bAsText}
• La valeur booléenne facultative bAsText spécifie si le contenu du Presse-papiers est extrait sous forme de texte. Si
bAsText a la valeur true, le contenu du Presse-papiers est extrait sous forme de texte. Si bAsText a la valeur false,
le contenu conserve sa mise en forme. Par défaut, cet argument renvoie la valeur false.
Valeurs renvoyées
Chaîne représentant le contenu du Presse-papiers (il peut s'agir de balises HTML) ou, si le Presse-papiers est vide, rien
ne se passe.
Exemple
si dreamweaver.getClipboardText() renvoie "text <b>bold</b> text",
dreamweaver.getClipboardText(true) renvoie "text bold text".
RÉFÉRENCE DES API DE DREAMWEAVER CS4 310
Contenu de page
Fonctions relatives aux éléments de bibliothèque et aux
modèles
Ces fonctions permettent d'effectuer des opérations associées aux éléments de bibliothèque et aux modèles, telles que
la création, la mise à jour et la rupture de liens entre un document et un élément de la bibliothèque ou un modèle. Les
méthodes de l'objet dreamweaver.libraryPalette contrôlent ou agissent sur la sélection dans les éléments de
bibliothèque du panneau Actifs, et non dans le document actif. De même, les méthodes de l'objet
dreamweaver.templatePalette contrôlent ou agissent sur la sélection dans les objets de modèle du panneau Actifs.
dom.applyTemplate()
Disponibilité
Dreamweaver 3.
Description
Applique un modèle au document actif. Si vous ne spécifiez aucun argument, la boîte de dialogue Sélectionner le
modèle s'affiche. Cette fonction n'est valide que pour le document actif.
Arguments
{templateURL}, bMaintainLink
• L'argument templateURL est le chemin d'un modèle disponible sur le site en cours, exprimé sous la forme d'une
URL de type file://.
• L'argument bMaintainLink est une valeur booléenne qui indique si le lien au modèle d'origine doit être conservé
(true) ou non (false).
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canApplyTemplate() » à la page 463.
dom.detachFromLibrary()
Disponibilité
Dreamweaver 3.
Description
Rompt le lien entre l'instance actuellement sélectionnée d'un élément de bibliothèque et le fichier LBI qui lui est associé
en supprimant les balises de verrouillage autour de la sélection. Revient à cliquer sur Détacher de l'original dans
l'inspecteur Propriétés.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 311
Contenu de page
Valeurs renvoyées
Aucune.
dom.detachFromTemplate()
Disponibilité
Dreamweaver 3.
Description
Détache le document actif du modèle qui lui est associé.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.getAttachedTemplate()
Disponibilité
Dreamweaver 3.
Description
Obtient le chemin du modèle associé au document.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient le chemin d'accès du modèle, exprimé sous la forme d'une URL de type file://.
dom.getEditableRegionList()
Disponibilité
Dreamweaver 3.
Description
Obtient la liste des régions modifiables dans le corps du document.
Arguments
Aucun.
Valeurs renvoyées
Tableau de nœuds d'élément.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 312
Contenu de page
Exemple
« dom.getSelectedEditableRegion() » à la page 312.
dom.getIsLibraryDocument()
Disponibilité
Dreamweaver 3.
Description
Détermine si le document est un élément de bibliothèque.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne qui indique si le document est un fichier LBI.
dom.getIsTemplateDocument()
Disponibilité
Dreamweaver 3.
Description
Détermine si le document est un modèle.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne qui indique si le document est un fichier DWT.
dom.getSelectedEditableRegion()
Disponibilité
Dreamweaver 3.
Description
Si la sélection ou le point d'insertion se trouve à l'intérieur d'une région modifiable, cette fonction obtient la position
de cette dernière parmi toutes celles qui existent dans le corps du document.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 313
Contenu de page
Valeurs renvoyées
Un index dans le tableau renvoyé par la fonction dom.getEditbableRegionList(). Pour plus d’informations, voir
« dom.getEditableRegionList() » à la page 311.
Exemple
Le code suivant affiche une boîte de dialogue présentant le contenu de la région modifiable sélectionnée :
var theDOM = dw.getDocumentDOM();
var edRegs = theDOM.getEditableRegionList();
var selReg = theDOM.getSelectedEditableRegion();
alert(edRegs[selReg].innerHTML);
dom.insertLibraryItem()
Disponibilité
Dreamweaver 3.
Description
Insère une instance d'un élément de bibliothèque dans le document.
Arguments
libraryItemURL.
• L'argument libraryItemURL est le chemin d'accès à un fichier LBI, exprimé sous la forme d'une URL de type file://.
Valeurs renvoyées
Aucune.
dom.markSelectionAsEditable()
Disponibilité
Dreamweaver 3.
Description
Affiche la boîte de dialogue Nouvelle région modifiable. Lorsque l'utilisateur clique sur Nouvelle région, Dreamweaver
marque la sélection comme étant modifiable et laisse le texte tel quel.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canMarkSelectionAsEditable() » à la page 469.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 314
Contenu de page
dom.newEditableRegion()
Disponibilité
Dreamweaver 3.
Description
Affiche la boîte de dialogue Nouvelle région modifiable. Lorsque l'utilisateur clique sur Nouvelle région, Dreamweaver
insère le nom de la région dans le document, entre accolades ({ }), à l'emplacement du point d'insertion.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canMakeNewEditableRegion() » à la page 469.
dom.removeEditableRegion()
Disponibilité
Dreamweaver 3.
Description
Supprime une région modifiable du document. Si cette région possède un contenu, celui-ci est conservé ; seuls les
marqueurs de région modifiable sont supprimés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canRemoveEditableRegion() » à la page 470.
dom.updateCurrentPage()
Disponibilité
Dreamweaver 3.
Description
Met à jour les modèles ou les éléments de bibliothèque du document, ou les deux. Cette fonction n'est valide que pour
le document actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 315
Contenu de page
Arguments
{typeOfUpdate}
• L'argument facultatif typeOfUpdate doit être "library", "template" ou "both". S'il n'est pas défini, il prend par
défaut la valeur "both".
Valeurs renvoyées
Aucune.
dreamweaver.updatePages()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Mettre à jour les pages et sélectionne les options spécifiées.
Arguments
{typeOfUpdate}
• L'argument facultatif typeOfUpdate, si vous le spécifiez, doit être "library", "template" ou "both". S'il n'est pas
défini, il prend par défaut la valeur "both".
Valeurs renvoyées
Aucune.
Fonctions du panneau Fragments de code
Avec Dreamweaver, les développeurs Web peuvent modifier et enregistrer des blocs de code réutilisables dans le
panneau Fragments de code, puis les extraire si besoin est.
Le panneau Fragments de code stocke chaque fragment de code dans un fichier CSN enregistré dans le dossier
Configuration\Snippets. Les fragments de code fournis avec Dreamweaver sont stockés dans les dossiers suivants :
• Accessible
• Commentaires
• Content_tables
• Filelist.txt
• Pieds de page
• Form_elements
• En-têtes
• Javascript
• Méta
• Navigation
• Texte
RÉFÉRENCE DES API DE DREAMWEAVER CS4 316
Contenu de page
Les fichiers de fragment de code sont des documents XML. Par conséquent, vous pouvez spécifier le codage dans la
directive XML de la manière suivante :
<?XML version="1.0" encoding="utf-8">
Voici un exemple de fichier de fragment de code :
<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>
Les balises de fragment de code des fichiers CSN ont les attributs suivants :
Attribut
Description
name
Nom du fragment de code
description
Description du fragment de code
preview
Type d'aperçu : code" pour afficher le fragment de code dans la zone d'aperçu
ou "design" pour afficher le fragment de code rendu en code HTML dans la
zone d'aperçu.
type
"wrap" si le fragment de code sert à envelopper la sélection de l'utilisateur,
"block" si le fragment de code doit être inséré avant la sélection.
Vous pouvez faire appel aux méthodes suivantes pour ajouter les fonctions du panneau Fragments de code à vos
extensions.
dreamweaver.snippetPalette.getCurrentSnippetPath()
Disponibilité
Dreamweaver MX 2004.
Description
Renvoie le chemin du fragment actuellement sélectionné dans le panneau Fragments de code.
Arguments
Aucun.
Valeurs renvoyées
Chemin, selon le dossier Snippets, du fragment actuellement sélectionné dans le panneau Fragments de code. Renvoie
une chaîne vide si aucun fragment n'est sélectionné.
dreamweaver.snippetPalette.newFolder()
Disponibilité
Dreamweaver MX.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 317
Contenu de page
Description
Crée un nouveau dossier ayant un nom par défaut (sans titre) et place une zone de texte autour du nom.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.snippetPalette.newSnippet()
Disponibilité
Dreamweaver MX.
Description
Ouvre la boîte de dialogue Ajouter un fragment de code et l'affiche au premier plan.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.snippetPalette.editSnippet()
Disponibilité
Dreamweaver MX.
Description
Ouvre la boîte de dialogue Modifier le fragment de code et l'affiche au premier plan pour que vous puissiez modifier
l'élément sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.snippetpalette.canEditSnippet() » à la page 490.
dreamweaver.snippetPalette.insert()
Disponibilité
Dreamweaver MX.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 318
Contenu de page
Description
Applique le fragment sélectionné dans le panneau Fragment de code à la sélection en cours.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.snippetpalette.canInsert() » à la page 491.
dreamweaver.snippetPalette.insertSnippet()
Disponibilité
Dreamweaver MX.
Description
Insère le fragment sélectionné dans la sélection en cours.
Arguments
path
• Chaîne spécifiant le chemin du fragment par rapport au dossier Snippets.
Valeurs renvoyées
Valeur booléenne.
Activateur
Voir « dreamweaver.snippetpalette.canInsert() » à la page 491.
Exemple
L'appel de la fonction dw.snippetPalette.insertSnippet() insère le fragment de code à l'emplacement spécifié
par l'argument dans le document actif, au point d'insertion :
dw.snippetPalette.insertSnippet('Text\\Different_Link_Color.csn');
dreamweaver.snippetPalette.rename()
Disponibilité
Dreamweaver MX.
Description
Affiche une zone de texte autour du nom du dossier ou du surnom du fichier sélectionné pour permettre de le
modifier.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 319
Contenu de page
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.snippetPalette.remove()
Disponibilité
Dreamweaver MX.
Description
Supprime l'élément ou le dossier sélectionné du panneau Fragment de code et supprime le fichier du disque.
Valeurs renvoyées
Aucune.
Fonctions de modification de widgets Spry
Dreamweaver CS4 fournit des fonctions de modification avancées pour les widgets Spry et autres widgets dynamiques.
element.getTranslatedAttribute()
Disponibilité
Dreamweaver CS3.
Description
Cette fonction est la même que la fonction getAttribute() du W3C, mais agit sur les attributs traduits. La fonction
element.getTranslatedAttribute() extrait une valeur d'attribut en fonction du nom.
Arguments
name
• L'argument name est une chaîne de type DOMString correspondant au nom de l'attribut à extraire.
Valeurs renvoyées
Renvoie le nom de l'attribut sous forme de chaîne DOMString. Si l'attribut n'a pas de valeur spécifiée ni de valeur par
défaut, cette fonction renvoie une chaîne vide.
element.removeTranslatedAttribute()
Disponibilité
Dreamweaver CS3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 320
Contenu de page
Description
Cette fonction est la même que la fonction removeAttribute() du W3C, mais agit sur les attributs traduits. La
fonction element.removeTranslatedAttribute() supprime un attribut en fonction du nom. Si l'attribut possède
une valeur par défaut, l'attribut qui s'affiche contient la valeur par défaut ainsi que l'URI d'espace de nom, le nom local
et le préfixe correspondants, le cas échéant.
Arguments
name
• L'argument name est une chaîne de type DOMString correspondant au nom de l'attribut à supprimer.
Valeurs renvoyées
Aucune.
element.setTranslatedAttribute()
Disponibilité
Dreamweaver CS3.
Description
Cette fonction est la même que la fonction setAttribute() du W3C, mais agit sur les attributs traduits. La fonction
element.setTranslatedAttribute() ajoute un nouvel attribut avec la valeur spécifiée. Si un attribut ayant le nom
spécifié existe déjà dans l'élément, sa valeur est remplacée par celle qui est spécifiée dans l'argument value.
L'argument value est une chaîne simple ; il n'est pas analysé du fait qu'il est en cours de définition. Par conséquent,
toute syntaxe incluse dans la chaîne est traitée en tant que texte simple et doit être ignorée de façon appropriée par
l'implémentation lorsqu'elle sera écrite.
Pour affecter une valeur d'attribut contenant de la syntaxe devant être reconnue en tant que référence d'entité, vous
devez créer un nœud Attr ainsi que des nœuds Text et EntityReference, créer l'arborescence secondaire appropriée
et utiliser setAttributeNode afin de l'affecter en tant que valeur d'un attribut.
Arguments
name, value
• L'argument name est une chaîne de type DOMString correspondant au nom de l'attribut à créer ou à modifier.
• L'argument value est une chaîne de type DOMString correspondant à la valeur à définir pour l'attribut.
Valeurs renvoyées
Aucune.
element.translatedClassName
Disponibilité
Dreamweaver CS3.
Description
Cette fonction est identique à element.ClassName() mais agit sur l'attribut className traduit.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 321
Contenu de page
element.translatedStyle
Disponibilité
Dreamweaver CS3.
Description
Cette fonction est identique à element.style() mais agit sur l'attribut de style traduit.
Exemple
var div1 = dom.getElementById("div1");
div1.translatedStyle.display = "none";
Insertion de fonctions relatives aux widgets Spry
Dreamweaver fournit les fonctions suivantes pour faciliter l'insertion de widgets Spry.
dom.addJavaScript()
Disponibilité
Dreamweaver CS3.
Description
Cette fonction indique à Dreamweaver d'insérer un bloc JavaScript soit dans la section head, soit dans la section body.
Si le point d'insertion est à l'intérieur de la section body, le bloc JavaScript sera inséré juste avant la balise </body>. Si
le document contient déjà un bloc JavaScript à cet endroit, Dreamweaver n'insérera pas de nouvelle balise <script>,
mais ajoutera "code" au contenu du <script>.
Arguments
code, insideHead
• L'argument code est une chaîne contenant le code JavaScript à insérer dans la page.
• L'argument insideHead est une valeur booléenne indiquant si le bloc JavaScript doit être inséré dans la section
head ou dans la section body. La valeur par défaut est true ; elle spécifie l'insertion du code dans la section head. Si
la valeur est false, le code est inséré dans la section body juste avant </body>. Cet argument est facultatif.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 322
Contenu de page
Exemple
function 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;
}
dom.copyAssets()
Disponibilité
Dreamweaver CS3, mise à jour dans CS4.
Description
Un auteur d'extension peut utiliser cette API pour copier des fichiers dépendants externes sur le site de l'utilisateur. Il
peut également ajouter les références requises au fichier dans l'en-tête de la page.
Arguments
assetArray
Tableau d'objets JavaScript. Chaque objet JavaScript possède des champs srcURL, destURL, referenceType,
useDefaultFolder et documentRelative.
• L'argument srcURL est un chemin d'accès à l'actif, exprimé sous la forme d'une URL file://.
• L'argument destURL est un chemin d'accès relatif qui définit la destination de la copie de l'actif. Ce à quoi destURL
est relatif dépend de la valeur de useDefaultFolder. Si useDefaultFolder a la valeur true, le chemin est relatif
au dossier Asset par défaut. Si useDefaultFolder a la valeur false, le chemin est relatif à la racine du site. Si le
site n'est pas défini, le chemin est relatif au document. Reportez-vous à la description de useDefaultFolder.
• L'argument referenceType est nécessaire pour que l'auteur d'extension insère une référence de fichier dans la
section head. Les valeurs autorisées pour referenceType sont les suivantes :
•
link pour insérer une balise LINK pour un fichier CSS externe
•
import pour insérer une balise STYLE avec @import
•
javascript pour insérer une balise SCRIPT avec type=text/javascript
•
vbscript pour insérer une balise SCRIPT avec type=text/vbscript
•
"" pour n'insérer aucune référence dans la section head
• L'argument useDefaultFolder est une valeur booléenne qui indique si le chemin spécifié dans destURL est relatif
au dossier Assets par défaut. Si sa valeur est false, ce qui signifie que cette propriété n'a pas été définie, destURL
est supposé être relatif à la racine du site. Si le site n'est pas défini, destURL est supposé être relatif au document. La
valeur par défaut de cet argument est false.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 323
Contenu de page
• L'argument documentRelative est une valeur booléenne. La valeur par défaut est false. Lorsque ce paramètre a
la valeur false, les actifs sont copiés dans le dossier spécifié dans destURL par rapport à la racine du site, lorsque
le fichier est enregistré dans un site. Si sa valeur est true, les actifs sont copiés dans le chemin spécifié dans destURL
par rapport au document.
Valeurs renvoyées
Tableau de chaînes qui s'expriment sous la forme d'URL file://. Chaque chaîne représente un fichier qui a été inclus
dans la section head du document par l'intermédiaire d'un script ou d'une balise link.
Exemple
function 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;
}
dom.getDefaultAssetFolder()
Disponibilité
Dreamweaver CS3.
Description
Extrait le dossier d'actifs par défaut du document.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient le nom du dossier d'actifs par défaut.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 324
Contenu de page
Exemple
function objectTag()
{
.
.
.
var defaultAssetFolder = dom.getDefaultAssetFolder();
.
.
.
return retVal;
}
Fonctions de vérification de la compatibilité avec les
navigateurs
Les fonctions suivantes facilitent la localisation des combinaisons de code HTML et de feuilles de style CSS qui peuvent
déclencher des bogues de rendu de navigateur (pour plus d'informations, consultez le chapitre « API de vérification
des problèmes de compatibilité entre les navigateurs » du manuel Extension de Dreamweaver), mais elles peuvent
également être utilisées dans d'autres types d'extensions (telles que des commandes).
Remarque : Les valeurs que ces fonctions renvoient représentent les styles en vigueur en mode Création. Lorsque les
fonctions sont utilisées dans des fichiers de problèmes dans le cadre d'une vérification de compatibilité avec les
navigateurs, Dreamweaver filtre automatiquement les styles en fonction de la façon dont les navigateurs cible les
traiteraient (par exemple, les styles définis à l'aide de Star HTML sont pris en compte si le navigateur cible est Internet
Explorer version 6 ou ultérieure), mais ce filtrage n'est pas effectué lorsque vous utilisez les fonctions en dehors du contexte
d'une vérification de compatibilité avec les navigateurs.
elem.getComputedStyleProp()
Disponibilité
Dreamweaver CS3.
Description
Obtient la valeur de la propriété CSS spécifiée qui est utilisée pour restituer l'élément spécifié, que la propriété soit ou
non spécifiée dans la cascade. Les longueurs sont rapportées en pixels (bien que, à la différence des navigateurs,
l'indication "px" ne soit pas fournie avec la valeur).
Arguments
propName, pseudoElt
• L'argument propName est le nom d'une propriété CSS (utiliser une casse mixte au lieu de traits d'union ; par
exemple, "font-size" devient "fontSize").
• L'argument pseudoElt est le pseudo-élément CSS, ou une valeur null s'il n'en existe aucun.
Valeurs renvoyées
Une chaîne contenant la valeur calculée pour la propriété.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 325
Contenu de page
Remarque : Les valeurs numériques sont également renvoyées en tant que chaînes ; pour utiliser ces valeurs dans des
calculs, convertissez-les en nombres à l'aide de parseInt() ou parseFloat().
Exemple
var dom = dw.getDocumentDOM();
var myDiv = dom.getElementsByTagName('myDiv');
var float = myDiv.getComputedStyleProp("float");
if (float == "left")
alert("This div is floated left.");
window.getDeclaredStyle()
Disponibilité
Dreamweaver CS3.
Description
Obtient les styles CSS qui sont déclarés pour l'élément spécifié. Diffère de la fonction getComputedStyle() en ce sens
que les styles qui ne sont pas spécifiquement déclarés sont indéfinis, et qu'elle donne les valeurs de longueur réelles
telles qu'elles sont déclarées dans la feuille de style (par exemple, 20%, .8em) au lieu des valeurs calculées en pixels. Si
bGetInherited a pour valeur false (cas par défaut), la fonction getDeclaredStyle() n'extrait également que les
styles qui s'appliquent directement à l'élément ; elle n'inclut pas les styles hérités d'un parent.
Arguments
elt, pseudoElt, psuedoClassList, bGetInherited
• elt est le nœud du document dont les informations de style sont souhaitées.
• pseudoElt est le pseudo-élément CSS, ou une valeur null s'il n'en existe aucun.
• pseudoClassList est une chaîne facultative composée d'une liste de pseudo-classes séparées par des espaces.
• bGetInherited est une valeur booléenne facultative indiquant s'il faut inclure les styles hérités d'ancêtres (false par
défaut).
Valeurs renvoyées
Un objet en lecture seule contenant des propriétés de style qui sont accessibles à partir de leur nom.
Exemple
var 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+/,""); // remove digits, leaving units
alert(units); // should show %, px, pt, em, etc.
}
else
alert("no margin-left property has been set for myDiv.");
RÉFÉRENCE DES API DE DREAMWEAVER CS4 326
Contenu de page
dom.getMinDisplayWidth()
Disponibilité
Dreamweaver CS3.
Description
Obtient la largeur minimale requise pour qu'un conteneur de niveau bloc puisse afficher l'intégralité de son contenu.
Remarque : La largeur réelle du conteneur peut être plus petite si une valeur inférieure à la valeur que la fonction
dom.minDisplayWidth() renvoie est spécifiée à l'aide de feuilles de style CSS.
Arguments
container
• container est l'élément contenant pour lequel une largeur minimale est requise.
Valeurs renvoyées
Un entier représentant la largeur d'affichage minimale du conteneur spécifié, en pixels, ou -1 n'est pas un conteneur
ou si sa largeur minimale ne peut pas être déterminée.
Exemple
var 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()
Disponibilité
Dreamweaver CS3.
Description
Analyse le document (ou l'élément) à la recherche de descendants ayant 'block' comme valeur d'affichage
intrinsèque ou spécifiée.
Arguments
Aucun
Valeurs renvoyées
Tableau de nœuds d'élément.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 327
Contenu de page
Exemple
[...]
var blocks = DOM.getBlockElements();
var dProps = null, children = null;
for (var i=0; i < blocks.length; i++){
// get the declared styles so we can see whether width
// or height have been specified explicitly
dProps = window.getDeclaredStyle(blocks[i]);
// if the block has children, border-left, and padding-bottom
// but no width or height
if (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();
var hasLayout = false;
// loop through the block-level children to see if
// any have width or height defined. width or height on any
// of the children of the outer block will prevent the bug.
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()
Disponibilité
Dreamweaver CS3.
Description
Analyse le document (ou l'élément) à la recherche de descendants ayant 'inline' comme valeur d'affichage
intrinsèque ou spécifiée.
Arguments
Aucun.
Valeurs renvoyées
Tableau de nœuds d'élément.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 328
Contenu de page
Exemple
[...]
var DOM = dw.getDocumentDOM();
var inEls = DOM.body.getInlineElements();
var next = null, prev = null, parent = null;
var props = null;
// look through all inline elements for replaced elements.
// if no replaced elements are found, don't bother going forward.
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'){
// do something
}
}
[...]
dom.getHeaderElements() elem.getHeaderElements()
Disponibilité
Dreamweaver CS3.
Description
Analyse le document (ou l'élément) à la recherche de balises d'en-tête (H1 à H6).
Arguments
Aucun.
Valeurs renvoyées
Tableau de nœuds d'élément.
Exemple
var DOM = dw.getDocumentDOM();
var headers = DOM.getHeaderElements();
for (var i=0; i < headers.length; i++){
alert(headers[i].tagName);
}
dom.getListElements() elem.getListElements()
Disponibilité
Dreamweaver CS3.
Description
Analyse le document (ou l'élément) à la recherche de listes numérotées, non numérotées et de listes de définitions.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 329
Contenu de page
Arguments
Aucun.
Valeurs renvoyées
Tableau de nœuds d'élément.
Exemple
[...]
var DOM = dw.getDocumentDOM();
// get all the UL, OL, and DL elements in the document.
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"){
// do something
}
}
[...]
elem.isBlockElement()
Disponibilité
Dreamweaver CS3.
Description
Vérifie si l'élément possède la valeur 'block' comme valeur d'affichage intrinsèque ou spécifiée.
Arguments
Aucun.
Valeurs renvoyées
Une valeur booléenne indiquant si l'objet est un élément de niveau bloc.
Exemple
[...]
var
var
var
for
}
}
[...]
DOM = dw.getDocumentDOM();
blocks = DOM.body.getBlockElements();
next = null;
(var i=0; i < blocks.length; i++){
// next is the node right after blocks[i]
next = blocks[i].nextSibling;
// if next isn't null AND next is an element node AND next is a block element,
// we've met the "second of two consecutive block elements" test.
if (next && (next.nodeType == 1) && next.isBlockElement()){
// do something
RÉFÉRENCE DES API DE DREAMWEAVER CS4 330
Contenu de page
elem.isInlineElement()
Disponibilité
Dreamweaver CS3.
Description
Vérifie si l'élément possède la valeur 'inline' comme valeur d'affichage intrinsèque ou spécifiée.
Arguments
Aucun.
Valeurs renvoyées
Une valeur booléenne indiquant si l'objet est un élément en ligne.
Exemple
[...]
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;
// if nextSibling of float is a text node or an inline element
if (next && (next.nodeType == Node.TEXT_NODE ||
(next.nodeType == Node.ELEMENT_NODE && next.isInlineElement()))){
// do something
}
}
[...]
elem.isHeaderElement()
Disponibilité
Dreamweaver CS3.
Description
Vérifie si l'élément est l'une des balises suivantes : h1, h2, h3, h4, h5, h6.
Arguments
Aucun.
Valeurs renvoyées
Une valeur booléenne indiquant si l'objet est un élément d'en-tête.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 331
Contenu de page
Exemple
[...]
var DOM = dw.getDocumentDOM();
var floats = issueUtils.getFloats(DOM.body);
var prev = null;
// first float in the document isn't affected, so start
// at 1.
for (var i=1; i < floats.length; i++){
prev = floats[i].previousSibling;
// if the element before the float is a header
if (prev && prev.isHeaderElement()){
// do something
}
}
[...]
elem.isListElement()
Disponibilité
Dreamweaver CS3.
Description
Vérifie si l'élément est l'une des balises suivantes : ul, ol, dl.
Arguments
Aucun.
Valeurs renvoyées
Une valeur booléenne indiquant si l'objet est un élément de liste.
Exemple
[...]
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()){
// do something
}
}
}
[...]
332
Chapitre 16 : Documents dynamiques
Les fonctions de document dynamique d'Adobe® Dreamweaver® effectuent des opérations liées aux pages de serveur
Web. Ces opérations sont les suivantes :
• Renvoi d'une propriété pour le nœud sélectionné dans le panneau Composants
• Obtention d'une liste de toutes les sources de données dans le document de l'utilisateur
• Affichage de contenu dynamique en mode Création
• Application d'un comportement de serveur à un document
• Obtention des noms de tous les modèles de serveur actuellement définis
Fonctions de composants de serveur
Ces fonctions permettent d'accéder au nœud sélectionné dans la commande d'arborescence Composants de serveur
qui apparaît dans le panneau Composants. Vous pouvez également les utiliser pour actualiser l'affichage de
l'arborescence de composants.
dreamweaver.serverComponents.getSelectedNode()
Disponibilité
Dreamweaver MX.
Description
Renvoie la propriété ComponentRec sélectionnée dans la commande d'arborescence Composants de serveur.
Arguments
Aucun.
Valeurs renvoyées
La propriété ComponentRec.
dreamweaver.serverComponents.refresh()
Disponibilité
Dreamweaver MX.
Description
Actualise l'affichage de l'arborescence de composants.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 333
Documents dynamiques
Valeurs renvoyées
Aucune.
Fonctions relatives aux sources de données
Les fichiers de source de données sont stockés dans le dossier Configuration/DataSources. Chaque modèle de serveur
possède son propre dossier : ASP.Net/C#, ASP.Net/VisualBasic, ASP/JavaScript, ASP/VBScript, ColdFusion, JSP et
PHP/MySQL. Le sous-dossier de chaque modèle contient des fichiers HTML et EDML associés aux sources de
données de ce modèle de serveur.
Pour plus d'informations sur l'utilisation de sources de données dans Dreamweaver, voir Sources de données dans
Extension de Dreamweaver.
dreamweaver.dbi.getDataSources
Disponibilité
Dreamweaver UltraDev 4.
Description
Appelle la fonction findDynamicSources() pour chaque fichier contenu dans le dossier Configuration/DataSources.
Vous pouvez utiliser cette fonction pour générer une liste de toutes les sources de données du document de
l'utilisateur. Cette fonction est répétée sur tous les fichiers du dossier Configuration/DataSources, appelle la fonction
findDynamicSources() dans chaque fichier, concatène tous les tableaux renvoyés et renvoie le tableau de sources de
données concaténé.
Arguments
Aucun.
Valeurs renvoyées
Un tableau contenant une liste concaténée de toutes les sources de données contenues dans le document de
l'utilisateur. Chaque élément du tableau est un objet et chaque objet a les propriétés suivantes :
• La propriété title correspond au libellé qui apparaît à droite de l'icône de chaque nœud parent. La propriété
title est toujours définie.
• La propriété imageFile est le chemin de fichier contenant l'icône (une image GIF) qui représente le nœud parent
dans les boîtes de dialogue Données dynamiques et Texte dynamique ou dans le panneau Liaisons. La propriété
imageFile est toujours définie.
• La propriété allowDelete est facultative. Si cette propriété est définie sur la valeur false, lorsque l'utilisateur
clique sur ce nœud dans le panneau Liaisons, le bouton Moins (-) est désactivé. Si elle est définie sur la valeur true,
le bouton Moins (-) est activé. Si la propriété n'est pas définie, le bouton Moins (-) est activé lorsque l'utilisateur
clique sur l'élément (comme si la propriété était définie sur la valeur true).
• La propriété dataSource est le nom du fichier dans lequel la fonction findDynamicSources() est définie. Par
exemple, la fonction findDynamicSources() dans le fichier Session.htm, situé dans le dossier
Configuration/DataSources/ASP_Js, définit la propriété dataSource sur session.htm. Cette propriété est
toujours définie.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 334
Documents dynamiques
• La propriété name est le nom du comportement de serveur associé à la source de données dataSource, s'il existe.
La propriété name est toujours définie, mais il peut s'agir d'une chaîne vide ("") si aucun comportement de serveur
n'est associé à la source de données (tel qu'une variable de session).
dw.dbi.setExpanded()
Disponibilité
Dreamweaver CS3.
Description
Définit le nœud à développer ou à réduire.
Arguments
data-source-node-name, expanded
• data-source-node-name est une chaîne indiquant le nom de la source de données à développer ou à réduire.
• expanded est une valeur booléenne indiquant si le nœud du jeu de données doit être développé ou réduit.
Valeurs renvoyées
Aucune.
Exemple
dw.dbi.setExpanded(dsName, true);
//expand the data source node
Fonctions de l'Extension Data Manager
Le gestionnaire de données d'extension (Extension Data Manager, EDM) se compose des API de cette section. Vous
pouvez programmer l'accès et la manipulation des données contenues dans les fichiers groupe et participant en
appelant ces fonctions. L'EDM fonctionne de la manière suivante :
• L'EDM exécute toutes les entrées/sorties de fichier EDML pour les fichiers Groupe et Participant.
• En exécutant toutes les demandes de données pour le modèle de serveur en cours, l 'EDM agit comme un filtre de
modèle de serveur.
dreamweaver.getExtDataValue()
Disponibilité
Dreamweaver UltraDev 4.
Description
Cette fonction extrait les valeurs de champ d'un fichier EDML pour les nœuds spécifiés.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 335
Documents dynamiques
Arguments
qualifier(s)
• L'argument qualifier(s) est une liste, de longueur variable (selon le niveau d'information demandé) de qualificateurs
de nœuds séparés par des virgules comprenant le nom du groupe ou du participant, le sous-bloc (le cas échéant) et
le nom du champ.
Valeurs renvoyées
Dreamweaver attend une valeur de champ. Si la valeur n'est pas spécifiée, Dreamweaver utilise la valeur par défaut.
Exemple
L'exemple suivant extrait la valeur de l'attribut d'emplacement pour la balise insertText du participant
recordset_main :
dw.getExtDataValue("recordset_main", "insertText", "location");
dreamweaver.getExtDataArray()
Disponibilité
Dreamweaver UltraDev 4.
Description
Cette fonction extrait un tableau de valeurs d'un fichier EDML pour les nœuds spécifiés.
Arguments
qualifier(s)
• L'argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds séparés par des virgules,
comprenant le nom du groupe ou du participant, le sous-bloc (le cas échéant) et le nom du champ.
Valeurs renvoyées
Dreamweaver attend un tableau de noms de nœuds enfants.
dreamweaver.getExtParticipants()
Disponibilité
Dreamweaver UltraDev 4.
Description
Cette fonction extrait la liste de participants d'un fichier de groupe EDML ou de fichiers participants.
Arguments
value, qualifier(s)
• L'argument value est une valeur de propriété. Il est ignoré s'il n'est pas renseigné. Par exemple,
dreamweaver.getExtParticipants("", "participant");
• L'argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds ayant la propriété requise,
séparés par des virgules.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 336
Documents dynamiques
Valeurs renvoyées
Dreamweaver attend un tableau de noms de participants ayant la propriété requise, si elle est spécifiée, et la propriété
correspondante, si elle est spécifiée.
dreamweaver.getExtGroups()
Disponibilité
Dreamweaver UltraDev 4.
Description
Extrait le nom du groupe, qui est l'équivalent du nom du comportement de serveur, d'un fichier groupe EDML.
Arguments
value, qualifier(s)
• L'argument value est une valeur de propriété. Il est ignoré s'il n'est pas renseigné.
• L'argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds ayant la propriété requise,
séparés par des virgules.
Valeurs renvoyées
Dreamweaver attend un tableau de noms de groupes ayant la propriété requise, si elle est spécifiée, et la propriété
correspondante, si elle est spécifiée.
dreamweaver.refreshExtData()
Disponibilité
Dreamweaver UltraDev 4.
Description
Recharge tous les fichiers de données d'extension.
Vous pouvez créer une commande utile à partir de cette fonction, qui vous permettra de recharger les modifications
apportées aux fichiers EDML de comportement de serveur sans avoir à redémarrer Dreamweaver.
Arguments
Aucun.
Valeurs renvoyées
Dreamweaver attend des données rechargées.
Fonctions Live data
Vous pouvez utiliser les fonctions Live Data suivantes pour reproduire les fonctionnalités de menu :
• La fonction showLiveDataDialog() s'utilise pour l'élément de menu Affichage > Paramètres Live Data.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 337
Documents dynamiques
• La fonction setLiveDataMode() s'utilise pour les éléments de menu Affichage > Live Data et Affichage >
Actualiser les données dynamiques.
• La fonction getLiveDataMode() détermine si le mode Live Data est actif.
Vous pouvez utiliser les autres fonctions Live Data lorsque vous implémentez la fonction
liveDataTranslateMarkup() pour l'API du traducteur.
dreamweaver.getLiveDataInitTags()
Disponibilité
Dreamweaver UltraDev 1.
Description
Renvoie les balises d'initialisation pour le document actif. Les balises d'initialisation sont les balises HTML que
l'utilisateur fournit dans la boîte de dialogue Paramètres Live Data. Cette fonction est généralement appelée à partir de
la fonction liveDataTranslateMarkup() d'un traducteur, de façon à ce que le traducteur puisse transmettre les
balises à la fonction liveDataTranslate().
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient les balises d'initialisation.
dreamweaver.getLiveDataMode()
Disponibilité
Dreamweaver UltraDev 1.
Description
Détermine si la fenêtre Live Data est actuellement visible.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la fenêtre Live Data est visible, false dans le cas contraire.
dreamweaver.getLiveDataParameters ()
Disponibilité
Dreamweaver MX.
Description
Obtient les paramètres d'URL définis comme paramètres Live Data.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 338
Documents dynamiques
Le mode Live Data vous permet d'afficher une page Web au stade de conception (comme si elle avait été traduite par
le serveur d'application et renvoyée). En générant un contenu dynamique affichable en mode Création, vous pouvez
visualiser la mise en forme d'une page avec ses données dynamiques et l'ajuster, le cas échéant.
Avant d'afficher les données dynamiques, vous devez saisir les paramètres Live Data de tout paramètre d'URL auquel
le document fait référence. Cela évite que le serveur Web ne renvoie des erreurs pour des paramètres qui ne sont pas
encore définis au stade de la simulation.
La saisie des paramètres d'URL s'effectue par paire nom/valeur. Ainsi, si les scripts de serveur d'un document font
référence aux variables d'URL ID et Name, vous devez définir ces paramètres d'URL avant d'afficher les données
dynamiques.
Vous pouvez saisir les paramètres Live Data depuis les endroits suivants :
• Depuis la boîte de dialogue Paramètres Live Data, accessible à partir du menu Affichage.
• Dans le champ de texte URL qui apparaît dans la partie supérieure du document lorsque vous cliquez sur le bouton
Affichage des données dynamiques, situé dans la barre d'outils.
Pour les paramètres ID et Name mentionnés ci-dessus, vous pouvez saisir les paires suivantes :
ID
Name
22
Samuel
Dans l'URL, ces paramètres apparaissent alors comme indiqué dans l'exemple ci-dessous :
http://someURL?ID=22&Name=Samuel
Cette fonction vous permet d'obtenir les paramètres Live Data par le biais de JavaScript.
Arguments
Aucun.
Valeurs renvoyées
Tableau qui contient les paramètres d'URL du document actif. Le tableau contient un nombre pair de chaînes de
paramètres. Chaque association de deux éléments représente une paire nom/valeur de paramètre d'URL. L'élément
pair correspond au nom du paramètre et l'élément impair à sa valeur. Dans l'exemple ci-dessus,
getLiveDataParameters() renvoie donc le tableau suivant pour les paramètres ID et Name :
['ID,'22','Name','Samuel'].
Exemple
L'exemple suivant renvoie les paramètres spécifiés comme paramètres Live Data et les conserve dans paramsArray :
var paramsArray = dreamweaver.getLiveDataParameters();
dreamweaver.liveDataTranslate()
Disponibilité
Dreamweaver UltraDev 1.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 339
Documents dynamiques
Description
Envoie un document HTML entier à un serveur d'application, demande au serveur d'exécuter les scripts dans le
document, puis renvoie le document HTML résultant. Cette fonction peut également être appelée à partir de la
fonction liveDataTranslateMarkup() d'un traducteur ; si vous tentez de l'appeler à un autre moment, il en résulte
une erreur. La fonction dreamweaver.liveDataTranslate() effectue les opérations suivantes :
• Elle lit l'image animée (qui s'affiche à côté du bord droit de la fenêtre Live Data).
• Elle analyse les données saisies par l'utilisateur. Si vous cliquez sur l'icône Arrêter, la fonction est immédiatement
terminée.
• Elle accepte un argument contenant une seule chaîne de l'appelant. Cette chaîne représente généralement le code
source entier du document de l'utilisateur. Il s'agit de la même chaîne que celle utilisée dans l'opération suivante.
• Elle enregistre la chaîne HTML du document de l'utilisateur dans un fichier temporaire stocké sur le serveur Live Data.
• Elle envoie une requête HTTP au serveur Live Data, en utilisant les paramètres définis dans la boîte de dialogue
Paramètres Live Data.
• Elle reçoit la réponse HTML du serveur Live Data.
• Elle supprime le fichier temporaire du serveur Live Data.
• Elle arrête la lecture du fichier d'animation.
• Elle renvoie la réponse HTML à l'appelant.
Arguments
string
• Une seule chaîne, représentant généralement le code source entier du document actif de l'utilisateur.
Valeurs renvoyées
Objet httpReply. Cet objet est le même que la valeur renvoyée par la fonction MMHttp.getText(). Si l'utilisateur
clique sur l'icône Arrêter, le code httpReply.statusCode de la valeur de retour est égal à 200 (état OK) et sa valeur
httpReply.data est égale à une chaîne vide. Pour plus d'informations sur l'objet httpReply, voir « L'API HTTP » à
la page 16.
dreamweaver.setLiveDataError()
Disponibilité
Dreamweaver UltraDev 1.
Description
Détermine le message d'erreur qui s'affiche si une erreur se produit lors de l'exécution de la fonction
liveDataTranslateMarkup() dans un traducteur. Si le document transmis par Dreamweaver à
liveDataTranslate() contient des erreurs, le serveur retransmet un message d'erreur au format HTML. Si le
traducteur (code ayant appelé liveDataTranslate()) détermine que le serveur a renvoyé un message d'erreur, il
appelle setLiveDataError() pour afficher le message d'erreur dans Dreamweaver. Ce message s'affiche une fois que
la fonction liveDataTranslateMarkup() a été exécutée ; Dreamweaver affiche la description dans une boîte de
dialogue d'erreur. La fonction setLiveDataError() doit uniquement être appelée à partir de la fonction
liveDataTranslateMarkup().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 340
Documents dynamiques
Arguments
source
• L'argument source est une chaîne qui contient le code source, qui est analysé et affiché dans la boîte de dialogue du
message d'erreur.
Valeurs renvoyées
Aucune.
dreamweaver.getLiveDataMode()
Disponibilité
Dreamweaver UltraDev 1.
Description
Active ou désactive l'affichage de la fenêtre Live Data.
Arguments
bIsVisible
• L'argument bIsVisible est une valeur booléenne qui indique si la fenêtre Live Data doit être visible. Si vous
transmettez la valeur true à cette fonction et que Dreamweaver est défini pour afficher la fenêtre Live Data, l'effet
est le même que si l'utilisateur cliquait sur le bouton Actualiser.
Valeurs renvoyées
Aucune.
dreamweaver.getLiveDataParameters ()
Disponibilité
Dreamweaver MX.
Description
Définit les paramètres d'URL référencés dans le document pour une utilisation en mode Live Data.
Le mode Live Data vous permet d'afficher une page Web au stade de conception (comme si elle avait été traduite par
le serveur d'application et renvoyée). En générant un contenu dynamique affichable en mode Création, vous pouvez
visualiser la mise en forme d'une page avec ses données dynamiques et l'ajuster, le cas échéant.
Avant d'afficher les données dynamiques, vous devez saisir les paramètres Live Data de tout paramètre d'URL auquel
le document fait référence. Cela évite que le serveur Web ne renvoie des erreurs pour des paramètres qui ne sont pas
encore définis au stade de la simulation.
La saisie des paramètres d'URL s'effectue par paire nom/valeur. Ainsi, si les scripts de serveur d'un document font
référence aux variables d'URL ID et Name, vous devez définir ces paramètres d'URL avant d'afficher les données
dynamiques.
Cette fonction vous permet de définir les valeurs Live Data par le biais de JavaScript.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 341
Documents dynamiques
Arguments
liveDataString
• L'argument liveDataString est une chaîne qui contient les paramètres d'URL à définir, au sein de paires nom/valeur.
Valeurs renvoyées
Aucune.
Exemple
dreamweaver.setLiveDataParameters("ID=22&Name=Samuel")
dreamweaver.showLiveDataDialog()
Disponibilité
Dreamweaver UltraDev 1.
Description
Affiche la boîte de dialogue Paramètres Live Data.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Fonctions relatives au mode En direct
Les fonctions du mode En direct s'emploient aux fins suivantes :
• Obtention et définition du mode Création
• Obtention et définition du mode En direct à l'aide du serveur
• Obtention des valeurs par défaut du mode En direct
• Obtention et définition des éléments dépendants du mode En direct
• Consultation des paramètres du mode En direct
dom.getDesignViewMode()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction obtient l'affichage ou le mode du mode Création. Le mode Création peut se trouver en mode d'affichage
Création modifiable classique ou En direct.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 342
Documents dynamiques
Arguments
Aucun.
Valeurs renvoyées
Valeur de chaîne. Renvoie live si le mode Création se trouve en mode En direct. Renvoie editable si le mode
Création se trouve en mode Création modifiable classique.
dom.setDesignViewMode()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction active le mode du mode Création. Par exemple, elle peut activer le mode En direct.
Arguments
mode
• L'argument mode est une chaîne qui peut avoir la valeur live ou editable.
Valeurs renvoyées
Aucun.
dom.getLiveViewUsingServer()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet de savoir si la page actuelle est prévisualisée à l'aide d'un serveur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la page doit être prévisualisée à l'aide d'un serveur, false dans le cas contraire.
dom.setLiveViewUsingServer()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet de spécifier si une page peut être prévisualisée à l'aide d'un serveur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 343
Documents dynamiques
Arguments
bool
• L'argument bool est une valeur booléenne qui indique si une page peut être prévisualisée à l'aide d'un serveur. Si
vous transmettez true à cette fonction, la page peut être prévisualisée à l'aide d'un serveur.
Valeurs renvoyées
Aucun.
dom.getLiveViewDefaultsToUsingServer()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction sert à déterminer si l'action par défaut consiste à prévisualiser à l'aide d'un serveur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne. Si l'action par défaut consiste à prévisualiser une page à l'aide d'un serveur, la valeur booléenne est
true, et false dans le cas contraire.
dom.getLiveViewDependentsUsingServer()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet de déterminer si des fichiers CSS et JavaScript dépendants sont demandés depuis le serveur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne. Si les fichiers CSS et JavaScript dépendants sont demandés depuis le serveur, la valeur booléenne
est true, et false dans le cas contraire.
dom.setLiveViewDependentsUsingServer()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet de spécifier si des fichiers CSS et JavaScript dépendants doivent être demandés depuis le serveur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 344
Documents dynamiques
Arguments
bool
• Valeur booléenne qui indique si les fichiers CSS et JavaScript dépendants sont demandés depuis le serveur. Si vous
envoyez true à cette fonction, les fichiers sont demandés depuis le serveur.
Valeurs renvoyées
Aucun.
dom.showLiveViewParamatersDialog()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet d'afficher la boîte de dialogue des paramètres en direct.
Arguments
Aucun
Valeurs renvoyées
Aucun.
dom.browser.getSelection()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction permet d'obtenir la sélection actuelle depuis le navigateur en mode En direct.
Arguments
Aucun.
Valeurs renvoyées
Renvoie une plage avec deux décalages pour les positions de début et de fin de la sélection dans le code source.
dom.browser.getStatusText()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction sert à obtenir le texte d'état actuel pour le navigateur. Il s'agit généralement d'une chaîne vide ou de la
chaîne « chargement du fichier... ».
RÉFÉRENCE DES API DE DREAMWEAVER CS4 345
Documents dynamiques
Arguments
Aucun.
Valeurs renvoyées
Renvoie le texte qui s'affiche dans la zone d'état du chrome d'un navigateur.
dom.browser.getWindow()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction sert à obtenir l'objet de fenêtre pour le contrôle de navigateur. Vous pouvez accéder au modèle d'objet
de document du navigateur à partir de l'objet de fenêtre.
Arguments
Aucun.
Valeurs renvoyées
Renvoie un objet.
browserEle.loadHTML()
Disponibilité
Dreamweaver CS4.
Description
Cette fonction charge directement une chaîne HTML dans le contrôle de navigateur. Elle peut être utile si vous
disposez de chaînes HTML prêtes à l'emploi. Les chaînes HTML ne doivent pas être associées à un document.
Arguments
Aucun.
Valeurs renvoyées
Aucun.
dom.browser.interactivityPaused
Disponibilité
Dreamweaver CS4.
Description
Cette propriété permet de savoir si l'interactivité est activée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 346
Documents dynamiques
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si l'interactivité est activée et false dans le cas contraire.
dom.browser.javaScriptEnabled
Disponibilité
Dreamweaver CS4.
Description
Cette propriété permet de savoir si JavaScript est activé. Cette propriété fonctionne comme
dom.interactivityPaused(), mais uniquement pour le code JavaScript.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si JavaScript est activé et false dans le cas contraire.
<mm:browsercontrol>
Vous pouvez utiliser cette balise dans les boîtes de dialogue extensibles, afin d'y afficher un navigateur. Cette balise ne
possède aucun attribut spécial. Vous pouvez contrôler la taille de la fenêtre de navigateur à l'aide de styles CSS. L'objet
DOM renvoyé par la balise est du même type que dom.browser, mais il ne s'agit pas de la même instance. La fonction
dom.browser n'est pas utilisable dans les commandes ; vous devez obtenir l'objet de navigateur dans le DOM. Voici
un exemple de cette balise :
<mm:browsercontol id="myBrowser" style="width: 500px; height:300px;" />
Dans l'en-tête du document, vous devez placer un script semblable au suivant :
var browserEle = document.getElementById("myBrowser");
alert(browserEle.getWindow().document.documentElement.outerHTML);
Le contrôle de navigateur diffuse également deux événements spéciaux :
BrowserControlLoad Cet événement est appelé immédiatement après que le navigateur a appelé son événement de
chargement, ce qui vous permet de joindre vos propres éléments au DOM de navigateur chargé.
BrowserControlBeforeNavigation Cet événement est appelé lorsque le navigateur est sur le point d'accéder à une
nouvelle page. Si l'événement est annulé, la demande de navigation l'est également et le contrôle de navigateur reste
sur la page actuelle. Le contexte de l'événement contient également l'URL demandée.
L'exemple suivant illustre le fonctionnement de ces événements :
var browserEle = document.getElementById("myBrowser");
browserEle.addEventListener("BrowserControlBeforeNavigation",
function(e){ if (e.requestedLocation = "foo.com")
e.preventDefault(); //don't allow navigation to this site!}, true);
RÉFÉRENCE DES API DE DREAMWEAVER CS4 347
Documents dynamiques
Fonctions relatives aux comportements de serveur
Ces fonctions vous permettent de manipuler le panneau Comportements de serveur, accessible sous Fenêtre >
Comportements de serveur. Vous pouvez utiliser ces fonctions pour rechercher tous les comportements de serveur sur
une page. Vous pouvez aussi les utiliser pour appliquer un nouveau comportement à un document ou pour modifier
un comportement existant, et ce par le biais d'un programme.
Remarque : Vous pouvez abréger dw.serverBehaviorInspector en dw.sbi.
dreamweaver.getParticipants()
Disponibilité
Dreamweaver UltraDev 4.
Description
La fonction JavaScript dreamweaver.getParticipants() répertorie les participants présents dans le document
utilisateur. Une fois tous les participants du comportement trouvés, Dreamweaver mémorise ces listes de participants.
En général, cette fonction est utilisée avec la fonction findServerBehaviors() (pour plus d'informations, voir
« Comportements de serveur » dans Extension de Dreamweaver) pour repérer les instances d'un comportement dans
le document utilisateur.
Arguments
edmlFilename
• L'argument edmlFilename est le nom du fichier groupe ou participant qui contient les noms des participants à
localiser dans le document utilisateur. Cette chaîne est le nom de fichier, sans l'extension .edml.
Valeurs renvoyées
Cette fonction renvoie un tableau contenant toutes les instances du participant spécifié (ou, dans le cas d'un fichier
groupe, une instance d'un participant dans le groupe) apparaissant dans le document utilisateur. Le tableau contient
des objets JavaScript, avec un élément pour chaque instance de participant trouvée dans le document utilisateur. Le
tableau est trié selon l'ordre dans lequel les participants apparaissent dans le document. Chaque objet JavaScript
possède les propriétés suivantes :
• La propriété participantNode est un pointeur relié au nœud participant dans le document utilisateur.
• La propriété participantName est le nom du fichier EDML du participant (sans l'extension .edml).
• La propriété parameters est un objet JavaScript qui stocke toutes les paires paramètre/valeur.
• La propriété matchRangeMin définit le décalage de caractères à partir du nœud participant du document jusqu'au
début du contenu du participant.
• La propriété matchRangeMax est un nombre entier du participant définissant le décalage depuis le début du nœud
participant jusqu'au dernier caractère du contenu du participant.
dreamweaver.serverBehaviorInspector.getServer Behaviors()
Disponibilité
Dreamweaver UltraDev 1.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 348
Documents dynamiques
Description
Affiche une liste de tous les comportements sur une page. Si Dreamweaver détermine que la liste interne des
comportements de serveur n'est peut-être pas à jour, il appelle la fonction findServerBehaviors() pour chaque
comportement installé. Chaque fonction renvoie un tableau. Dreamweaver fusionne tous les tableaux en un seul
tableau et le trie dans l'ordre où chaque objet selectedNode de comportement apparaît dans le document.
Dreamweaver stocke le tableau fusionné localement. La fonction getServerBehaviors() renvoie un pointeur au
tableau fusionné.
Arguments
Aucun.
Valeurs renvoyées
Tableau d'objets JavaScript. L'appel findServerBehaviors() renvoie les objets dans le tableau. Ils sont triés dans leur
ordre d'apparition dans le panneau Comportements de serveur.
dreamweaver.popupServerBehavior()
Disponibilité
Dreamweaver UltraDev 1.
Description
Applique un nouveau comportement de serveur au document ou modifie un comportement existant. Si l'utilisateur
doit définir les paramètres du comportement, une boîte de dialogue s'affiche.
Arguments
{behaviorName} ou {behaviorObject}
• L'argument facultatif behaviorName est une chaîne qui représente le nom du comportement, la balise de titre d'un
fichier ou un nom de fichier.
• L'argument facultatif behaviorObject est un objet comportement.
Si vous ne définissez pas cet argument, Dreamweaver exécute le comportement de serveur sélectionné. Si
l'argument est le nom d'un comportement de serveur, Dreamweaver ajoute ce comportement à la page. Si
l'argument est l'un des objets du tableau renvoyé par la fonction getServerBehaviors(), une boîte de dialogue
s'affiche pour permettre à l'utilisateur de modifier les paramètres du comportement.
Valeurs renvoyées
Aucune.
Fonctions de modèle de serveur
Dans Dreamweaver, tous les documents ont un type de document associé. Pour les types de documents dynamiques,
Dreamweaver associe également un modèle de serveur (tel que ASP-JS, ColdFusion ou PHP-MySQL).
Les modèles de serveur sont utilisés pour regrouper une fonctionnalité spécifique à une technologie de serveur.
Différents comportements de serveur, sources de données, etc., apparaissent en fonction du modèle de serveur associé
au document.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 349
Documents dynamiques
Utilisez les fonctions de modèle de serveur pour déterminer l'ensemble des modèles de serveur actuellement définis,
le nom, la langue et la version du modèle de serveur en cours, et si le modèle de serveur en cours prend en charge un
ensemble nommé de caractères (tel que UTF-8).
Remarque : Dreamweaver lit toutes les informations contenues dans le fichier HTML du modèle de serveur et stocke ces
informations lors du premier chargement du modèle de serveur. Lorsqu'une extension appelle des fonctions telles que
dom.serverModel.getServerName(), dom.serverModel.getServerLanguage() et
dom.serverModel.getServerVersion(), ces fonctions renvoient les valeurs stockées.
dom.serverModel.getAppURLPrefix()
Disponibilité
Dreamweaver MX.
Description
Renvoie l'URL du dossier racine du site sur le serveur d'évaluation. Cette URL est la même que celle qui a été spécifiée
pour le serveur d'évaluation dans l'onglet Avancé de la boîte de dialogue Définition du site.
Lorsque Dreamweaver communique avec votre serveur d'évaluation, il utilise HTTP (de la même manière qu'un
navigateur). Il utilise alors cette URL pour accéder au dossier racine de votre site.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui maintient l'URL au serveur d'application utilisé pour les données dynamiques et le débogage.
Exemple
Si l'utilisateur crée un site et précise que le serveur d'évaluation est sur l'ordinateur local et que le dossier racine est
intitulé "employeeapp", un appel à la fonction dom.serverModel.getAppURLPrefix() renvoie la chaîne suivante :
http://localhost/employeeapp/
dom.serverModel.getDelimiters()
Disponibilité
Dreamweaver MX.
Description
Permet au code JavaScript d'obtenir le délimiteur de script pour chaque modèle de serveur, afin de pouvoir séparer la
gestion du modèle de serveur et celle du code utilisateur.
Arguments
Aucun.
Valeurs renvoyées
Tableau d'objets dans lequel tous les objets contiennent les trois propriétés suivantes :
• La propriété startPattern est une expression régulière qui correspond au délimiteur d'ouverture de script.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 350
Documents dynamiques
• La propriété endPattern est une expression régulière qui correspond au délimiteur de fermeture de script.
• Le modèle participateInMerge est une valeur booléenne qui indique si le contenu entre les délimiteurs utilisés doit
(true) ou non (false) prendre part à la fusion de blocs.
dom.serverModel.getDisplayName()
Disponibilité
Dreamweaver MX.
Description
Obtient le nom du modèle de serveur qui apparaît dans l'interface utilisateur (UI).
Arguments
Aucun.
Valeurs renvoyées
Chaîne dont la valeur est le nom du modèle de serveur.
dom.serverModel.getFolderName()
Disponibilité
Dreamweaver MX.
Description
Obtient le nom du dossier utilisé pour ce modèle de serveur dans le dossier Configuration (tel que le sous-dossier
ServerModels).
Arguments
Aucun.
Valeurs renvoyées
Chaîne dont la valeur est le nom du dossier.
dom.serverModel.getServerIncludeUrlPatterns()
Disponibilité
Dreamweaver MX.
Description
Renvoie la liste de propriétés, qui vous permet d'accéder aux éléments suivants :
• Modèles URL du traducteur
• Références du fichier
• Type
RÉFÉRENCE DES API DE DREAMWEAVER CS4 351
Documents dynamiques
Arguments
Aucun.
Valeurs renvoyées
Liste d'objets, un pour chaque searchPattern. Chaque objet présente les trois propriétés suivantes :
Propriété
Description
pattern
Expression régulière JavaScript spécifiée dans le champ searchPattern d'un
fichier EDML. Une expression régulière est délimitée par deux barres obliques
(//).
fileRef
L'index de base 1 de la sous-correspondance de l'expression régulière qui
correspond à la référence du fichier inclus.
type
La portion de la valeur paramName qui reste après avoir ôté le suffixe _includeUrl.
Ce type est affecté à l'attribut du type de balise <MM:BeginLock>. Vous en
trouverez un exemple dans le fichier ServerModelSSI.htm, dans le dossier
Configuration/Translators.
Exemple
Le fragment de code suivant d'un fichier participant illustre une balise searchPatterns de traducteur :
<searchPatterns whereToSearch="comment">
<searchPattern paramNames=",ssi_comment_includeUrl">
<![CDATA[/<!--\s*#include\s+(file|virtual)\s*=\s*"([^"]*)"\s*-->/i]]>
</searchPattern>
</searchPatterns>
Le modèle de recherche contient une expression régulière JavaScript qui spécifie deux sous-correspondances (toutes
deux entre parenthèses). La première sous-correspondance est pour la chaîne de texte file ou virtual. La deuxième
sous-correspondance est une référence de fichier.
Pour accéder au modèle URL du traducteur, votre code doit ressembler à l'exemple suivant :
var serverModel = dw.getDocumentDOM().serverModel;
var includeArray = new Array();
includeArray = serverModel.getServerIncludeUrlPatterns();
L'appel à la fonction serverModel.getServerIncludeUrlPatterns() renvoie les trois propriétés suivantes :
Propriété
Valeur renvoyée
pattern
/<!--\s*#include\s+(file|virtual)\s*=\s*"([^"]*)"\s*-->/i
fileRef
2
type
ssi_comment
dom.serverModel.getServerInfo()
Disponibilité
Dreamweaver MX.
Description
Renvoie des informations spécifiques au modèle de serveur en cours. Ces informations figurent dans le fichier de
définition HTML correspondant au modèle de serveur, situé dans le dossier Configuration/ServerModels.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 352
Documents dynamiques
Vous pouvez modifier les informations contenues dans le fichier de définition HTML ou placer des valeurs ou
fonctions de variable supplémentaires dans le fichier. Vous pouvez par exemple modifier les propriétés serverName,
serverLanguage et serverVersion. La fonction dom.serverModel.getServerInfo() renvoie les informations
ajoutées par l'auteur du modèle de serveur au fichier de définition.
Remarque : Les autres valeurs définies dans les fichiers de modèles de serveur par défaut sont réservées à un usage interne.
Les propriétés serverName, serverLanguage et serverVersion sont spécifiques, accessibles directement au moyen
des fonctions correspondantes suivantes :
•
dom.serverModel.getServerName()
•
dom.serverModel.getServerLanguage()
•
dom.serverModel.getServerVersion()
Arguments
Aucun.
Valeurs renvoyées
Objet JavaScript qui contient diverses informations spécifiques au modèle de serveur en cours.
dom.serverModel.getServerName()
Disponibilité
Dreamweaver 1 ; amélioré dans Dreamweaver MX.
Description
Extrait le nom du serveur associé au document et renvoie cette valeur. Le nom de serveur varie selon les technologies
de serveur (comme ASP.NET et JSP) et non selon les langages d'une même technologie de serveur (comme ASP.NET
VB et ASP.NET C#). Parmi les valeurs possibles, on retrouve ASP,ASP.NET, Cold Fusion, JSP et PHP.
Pour extraire le nom de modèle de serveur associé au document, voir « dom.serverModel.getDisplayName() » à la
page 350 ou « dom.serverModel.getFolderName() » à la page 350.
Remarque : Pour Dreamweaver MX ou version ultérieure, la fonction dom.serverModel.getServerName() lit la
propriété serverName de l'objet renvoyé par un appel à la fonction getServerInfo() dans l'API de modèle de serveur
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient le nom du serveur.
dom.serverModel.getServerSupportsCharset()
Disponibilité
Dreamweaver MX.
Description
Détermine si le modèle de serveur associé au document prend en charge le jeu de caractères nommé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 353
Documents dynamiques
Remarque : Dreamweaver vous permet d'appeler cette fonction à partir du calque JavaScript mais aussi lorsque
l'utilisateur modifie l'encodage dans la boîte de dialogue des propriétés. Si le modèle de serveur ne prend pas en charge le
nouvel encodage des caractères, cette fonction renvoie la valeur false et Dreamweaver affiche une boîte de
dialogue d'avertissement demandant à l'utilisateur s'il souhaite faire la conversion. Cela peut
se produire par exemple lorsqu'un utilisateur essaie de convertir un document ColdFusion 4.5 en UTF-8, car ColdFusion
ne prend pas en charge l'encodage UTF-8.
Arguments
metaCharSetString
• L'argument metaCharSetString est une valeur de chaîne qui dénomme un jeu de caractères donné. Cette valeur est
la même que celle de l'attribut "charset=" d'une balise meta associée à un document. Les valeurs prises en charge
pour un modèle de serveur donné sont définies dans le fichier de définition HTML pour le modèle de serveur, situé
dans le dossier Configuration/ServerModels.
Valeurs renvoyées
Valeur booléenne : true si le modèle de serveur prend en charge le jeu de caractères nommé, false dans le cas
contraire.
dom.serverModel.getServerVersion()
Disponibilité
UltraDev 1; amélioré dans Dreamweaver MX.
Description
Détermine le modèle de serveur associé au document et renvoie cette valeur. Chaque modèle de serveur a une fonction
getVersionArray() (dans l'API de modèle de serveur), qui renvoie un tableau de couples nom-version.
Remarque : Pour Dreamweaver, la fonction dom.serverModel.getServerVersion() lit d'abord la propriété
serverVersion de l'objet renvoyé par un appel à la fonction getServerInfo() dans l'API de modèle de serveur. Si cette
propriété n'existe pas, la fonction dom.serverModel.getServerVersion() la lit à partir de la fonction
getVersionArray().
Arguments
name
• L'argument name est une chaîne représentant le nom d'un modèle de serveur.
Valeurs renvoyées
Chaîne qui contient la version du modèle de serveur nommé.
dom.serverModel.testAppServer()
Disponibilité
Dreamweaver MX.
Description
Teste s'il est possible d'établir une connexion au serveur d'application.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 354
Documents dynamiques
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne qui indique si la demande de connexion au serveur d'application a été acceptée.
dreamweaver.getServerModels()
Disponibilité
Dreamweaver MX.
Description
Obtient les noms de tous les modèles de serveur actuellement définis. Les noms sont les mêmes que ceux qui
apparaissent dans la zone de texte Modèle de serveur de la boîte de dialogue Définition du site.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes. Tous les éléments de chaîne contiennent le nom d'un modèle de serveur actuellement défini.
355
Chapitre 17 : Création
Les fonctions de conception d'Adobe® Dreamweaver® permettent d'effectuer des opérations en rapport avec la
personnalisation de l'apparence d'un document. Ces opérations comprennent des fonctions qui vous permettent
d'effectuer les activités suivantes :
• Application d'une feuille de style en cascade (CSC) spécifiée
• Fractionnement vertical ou horizontal d'un cadre sélectionné
• Alignement des zones réactives ou des calques sélectionnés
• Lecture d'un élément de plug-in sélectionné
• Créer une cellule de mise en forme
• Manipulation de lignes ou de colonnes de tableau
Fonctions relatives aux mises en forme CSS
Ces fonctions permettent d'appliquer, de retirer, de créer et de supprimer des styles CSS. Les méthodes de l'objet
dreamweaver.cssRuleTracker contrôlent ou agissent sur l'élément sélectionné dans le panneau de suivi des règles
CSS de l'inspecteur de sélections. Les méthodes de l'objet dreamweaver.cssStylePalette contrôlent ou agissent sur
la sélection dans le panneau Styles CSS, et non dans le document actif.
dom.applyLayout()
Disponibilité
Dreamweaver CS3.
Description
Applique une mise en forme CSS au document. Le corps du document doit être vide, et le document doit être une page
dans laquelle vous pouvez appliquer une mise en forme. C'est-à-dire :
• une page basée sur le code HTML, telle que HTML, XHTML, ColdFusion, PHP, etc. (mais pas CSS, XML,
JavaScript, etc.) ;
• une page qui n'est pas un jeu de cadres ni une instance de modèle (bien qu'un modèle soit approprié).
Arguments
layout-index, CSS, cssFileName, preventOverwrite
• layout-index est un entier d'index de base zéro spécifiant la mise en forme à utiliser. Il s'agit d'un index dans la liste
des mises en forme qui sert à renvoyer les valeurs layoutNames et layoutDescriptions dans les fonctions
correspondantes.
• CSS indique où placer la mise en forme CSS. Les valeurs possibles sont les suivantes :
• "embed" - incorporer le fichier CSS dans la section head du document.
• "link" - établir un lien vers cssFileName.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 356
Création
• "create_and_link" - écrire un fichier CSS dans cssFileName et établir un lien vers lui.
• "import"- importer cssFileName.
• "create_and_import" - écrire un fichier CSS dans cssFileName et importer.
• cssFileName est le nom du fichier CSS vers lequel établir un lien ou à importer et à créer, le cas échéant.
• preventOverwrite est une valeur booléenne où true : lors de la création d'un nouveau fichier CSS, échoue si le
fichier existe déjà ; false : écrase le fichier s'il existe déjà.
Valeurs renvoyées
Valeur booléenne : true si la mise en page a été appliquée, false dans le cas contraire.
Exemple
dw.getLayoutNames();
var theDOM = dw.getDocumentDOM();
alert (theDOM.canApplyLayout());
if (theDOM.canApplyLayout())
theDOM.applyLayout(1, "embed");
else
alert("can't apply layout to this doc");
dom.canApplyLayout()
Disponibilité
Dreamweaver CS3.
Description
Vérifie si une mise en forme CSS peut être appliquée au document. Cette fonction vérifie que le corps du document
est vide, et qu'il s'agit d'une page dans laquelle vous pouvez appliquer une mise en forme. C'est-à-dire :
• une page basée essentiellement sur le code HTML, telle que HTML, XHTML, ColdFusion, PHP, etc. (mais pas CSS,
XML, JavaScript, etc.) ;
• une page qui n'est pas un jeu de cadres ni une instance de modèle (bien qu'un modèle soit approprié). evelyn
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne où true : la mise en page peut être appliquée. false : la mise en forme ne peut pas être appliquée.
dw.getFilesForLayout()
Disponibilité
Dreamweaver CS3.
Description
Obtient les chemins des fichiers de configuration pour la mise en forme spécifiée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 357
Création
Arguments
layoutIndex
• layoutIndex est un entier d'index de base zéro spécifiant la mise en forme. Il s'agit d'un index dans la liste des mises
en forme qui sert à renvoyer les valeurs layoutNames et layoutDescriptions dans les fonctions correspondantes.
Valeurs renvoyées
Un tableau de chaînes contenant les chemins complets des fichiers HTML et des fichiers d'image d'aperçu (pouvant
être null).
dw.getLayoutNames()
Disponibilité
Dreamweaver CS3.
Description
Obtient les noms des mises en forme CSS disponibles.
Arguments
Aucun.
Valeurs renvoyées
Un tableau de chaînes des noms des mises en forme.
dw.getLayoutDescriptions()
Disponibilité
Dreamweaver CS3.
Description
Obtient les descriptions des mises en forme CSS disponibles.
Arguments
Aucun.
Valeurs renvoyées
Un tableau de chaînes des descriptions des mises en forme.
dom.applyCSSStyle()
Disponibilité
Dreamweaver 4.
Description
Applique le style spécifié à l'élément spécifié. Cette fonction n'est valide que pour le document actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 358
Création
Arguments
elementNode, styleName, {classOrID}, {bForceNesting}
• L'argument elementNode désigne un nœud d'élément dans le DOM. Si l'argument elementNode a pour valeur NULL
ou est exprimé sous forme d'une chaîne vide (""), la fonction agit sur la sélection en cours.
• L'argument styleName est le nom d'un style CSS.
• L'argument facultatif classOrID est l'attribut avec lequel le style doit être appliqué ("class" ou "id"). Si l'argument
elementNode a pour valeur NULL ou s'il est exprimé sous forme d'une chaîne vide et qu'aucune balise n'entoure
complètement la sélection, le style est appliqué avec des balises SPAN. Si la sélection est un point d'insertion,
Dreamweaver utilise la méthode heuristique pour déterminer à quelle balise le style doit être appliqué.
• L'argument facultatif bForceNesting est une valeur booléenne qui indique si l'imbrication est autorisée ou non. Si le
drapeau bForceNesting est défini, Dreamweaver insère une nouvelle balise SPAN au lieu de tenter de modifier les
balises existantes dans le document. S'il n'est pas défini, cet argument a la valeur false par défaut.
Valeurs renvoyées
Aucune.
Exemple
Le code suivant applique le style red à la sélection, soit en entourant cette dernière de balises SPAN, soit en appliquant
un attribut CLASS aux balises qui entourent la sélection :
var theDOM = dreamweaver.getDocumentDOM('document');
theDOM.applyCSSStyle('','red');
dom.getElementView()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie le mode Elément pour l'élément sélectionné dans le document. Si l'élément sélectionné est
normal, la fonction getElementView() recherche le premier ancêtre de l'élément sélectionné qui est soit full soit
hidden.
Arguments
Aucun.
Valeurs renvoyées
Une chaîne indiquant l'état de l'élément sélectionné. Ces valeurs sont :
•
"hidden", indique que l'élément possède des propriétés CSS pouvant entraîner un affichage masqué partiel ou total
du contenu en mode Création. Les propriétés CSS prises en charge sont les suivantes :
• overflow : hidden, scroll ou auto
• display : aucune
•
"full", indique que par défaut l'élément est "hidden", mais que la valeur actuelle est "full" comme définie par la
fonction setElementView("full").
•
"normal", indique que l'élément n'a pour valeur ni "hidden" ni "full".
RÉFÉRENCE DES API DE DREAMWEAVER CS4 359
Création
Exemple
L'exemple suivant modifie l'état de l'élément sélectionné en "full" s'il a pour valeur "hidden" :
var currentDOM = dw.getDocumentDOM();
if (currentDOM && getElementView() == "hidden"){
currentDOM.setElementView("full");
}
dom.getShowDivBackgrounds()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'état de l'assistance visuelle Arrière-plans des blocs de mise en forme.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne; true si l'assistance visuelle Arrière-plans des blocs de mise en forme est
activée, false dans le cas contraire.
Exemple
L'exemple suivant vérifie si l'assistance visuelle Arrière-plans des blocs de mise en forme est activée et, si ce n'est pas le
cas, l'active :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowDivBackgrounds() == false){
currentDOM.setShowDivBackgrounds(true);
}
dom.getShowDivBoxModel()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'état de l'assistance visuelle Modèle de boîte des blocs de mise en forme.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne ; true si l'assistance visuelle Modèle de boîte des blocs de mise en forme est activée, false dans le
cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 360
Création
Exemple
L'exemple suivant vérifie si l'assistance visuelle Modèle de boîte des blocs de mise en forme est activée et, si ce n'est pas
le cas, l'active :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowDivBoxModel() == false){
currentDOM.setShowDivBoxModel(true);
}
dom.getShowDivOutlines()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'état de l'assistance visuelle Contours des blocs de mise en forme.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne; true si l'assistance visuelle Contours des blocs de mise en forme est activée,
false dans le cas contraire.
Exemple
L'exemple suivant vérifie si l'assistance visuelle Contours des blocs de mise en forme est activée et, si ce n'est pas le cas,
l'active :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowDivOutlines() == false){
currentDOM.setShowDivOutlines(true);
}
dom.removeCSSStyle()
Disponibilité
Dreamweaver 3.
Description
Supprime l'attribut CLASS ou ID de l'élément spécifié ou supprime les balises SPAN qui entourent complètement
l'élément spécifié. Cette fonction n'est valide que pour le document actif.
Arguments
elementNode, {classOrID}
• L'argument elementNode désigne un nœud d'élément dans le DOM. Si l'argument elementNode est une chaîne vide
(""), la fonction est appliquée à la sélection en cours.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 361
Création
• L'argument facultatif classOrID est l'attribut qui doit être supprimé ("class" ou "id"). Si l'argument classOrID
n'est pas spécifié, il prend par défaut la valeur "class". Si aucun attribut CLASS n'est défini pour l'argument
elementNode, la balise SPAN entourant l'argument elementNode est supprimée.
Valeurs renvoyées
Aucune.
dom.resetAllElementViews()
Disponibilité
Dreamweaver 8.
Description
Cette fonction rétablit le mode Elément original de tous les éléments du document en supprimant tous les styles CSS
générés en interne.
Arguments
{forceRefresh}
• L'argument facultatif forceRefresh est une valeur booléenne qui indique s'il faut actualiser le rendu de la totalité du
document lorsqu'il n'y a pas de style CSS interne à supprimer. La valeur true provoque l'actualisation. La valeur
par défaut est false.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant rétablit le mode Elément de tous les éléments du document sans avoir à actualiser le rendu :
var currentDOM = dw.getDocumentDOM();
currentDOM.resetAllElementViews(false);
dom.setElementView()
Disponibilité
Dreamweaver 8.
Description
Cette fonction définit le mode Elément pour l'élément sélectionné dans le document. Si l'élément sélectionné est
"normal", la fonction setElementView() recherche le premier ancêtre de l'élément sélectionné qui est "full" ou
"hidden".
RÉFÉRENCE DES API DE DREAMWEAVER CS4 362
Création
Arguments
view
• L'argument obligatoire view est une chaîne qui définit l'élément sélectionné comme "full" ou "hidden". Si
l'élément sélectionné est "normal", la fonction setElementView() recherche le premier ancêtre de l'élément
sélectionné, qui correspond soit à "full" soit à "hidden". Pour des informations supplémentaires, consultez la
section « dom.getElementView() » à la page 358. Les valeurs possibles sont les suivantes :
•
"full" : Supprime le style CSS interne qui place l'élément en mode "full" pour permettre à l'élément de
retrouver son état original.
•
"hidden" : Si l'élément sélectionné est en mode "hidden", Dreamweaver génère le style CSS permettant
d'afficher tout le contenu puis l'applique comme une feuille de style interne au moment de la conception.
Valeurs renvoyées
Aucune.
Exemple
Voir « dom.getElementView() » à la page 358.
dom.setShowDivBackgrounds()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle Arrière-plans des blocs de mise en forme.
Arguments
show
• L'argument obligatoire show est une valeur booléenne qui indique s'il faut activer l'assistance visuelle Arrière-plans
des blocs de mise en forme. Définir l'argument show sur true active l'assistance visuelle Arrière-plans des blocs de
mise en forme.
Valeurs renvoyées
Aucune.
Exemple
Voir « dom.getShowDivBackgrounds() » à la page 359.
dom.setShowDivBoxModel()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle Modèle de boîte des blocs de mise en forme.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 363
Création
Arguments
show
• L'argument obligatoire show est une valeur booléenne qui indique s'il faut activer l'assistance visuelle Modèle de
boîte des blocs de mise en forme. Définir l'argument show sur true active l'assistance visuelle Modèle de boîte des
blocs de mise en forme.
Valeurs renvoyées
Aucune.
Exemple
Voir « dom.getShowDivBoxModel() » à la page 359.
dom.setShowDivOutlines()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle Contours des blocs de mise en forme.
Arguments
show
• L'argument obligatoire show est une valeur booléenne qui indique s'il faut activer l'assistance visuelle Contours des
blocs de mise en forme. Définir l'argument show sur true active l'assistance visuelle Contours des blocs de mise en
forme.
Valeurs renvoyées
Aucune.
Exemple
Voir « dom.getShowDivOutlines() » à la page 360.
dreamweaver.cssRuleTracker.editSelectedRule()
Disponibilité
Dreamweaver MX 2004.
Description
Permet à l'utilisateur de modifier la règle sélectionnée dans l'outil de suivi des règles. Cette fonction affiche la règle
sélectionnée dans la grille des propriétés CSS et, si cela s'avère nécessaire, affiche la grille des propriétés ainsi que la
palette qui la contient.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 364
Création
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssRuleTracker.canEditSelectedRule() » à la page 482.
dreamweaver.cssRuleTracker.newRule()
Disponibilité
Dreamweaver MX 2004.
Description
Ouvre la boîte de dialogue Nouveau style CSS pour permettre à l'utilisateur de créer une nouvelle règle.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.cssStylePalette.applySelectedStyle()
Disponibilité
Dreamweaver MX.
Description
Applique le style sélectionné au document actif ou à la feuille de style associée, en fonction de l'élément sélectionné
dans le panneau Styles CSS.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout »; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant »; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canApplySelectedStyle() » à la page 482.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 365
Création
dreamweaver.cssStylePalette.attachStyleSheet()
Disponibilité
Dreamweaver 4.
Description
Affiche une boîte de dialogue qui permet aux utilisateurs d'attacher une feuille de style au document actif ou à l'une
des feuilles de style qui y sont associées en fonction de l'élément sélectionné dans le panneau Styles CSS.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.cssStylePalette.deleteSelectedStyle()
Disponibilité
Dreamweaver 3.
Description
Supprime du document le style actuellement sélectionné dans le panneau Styles CSS.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canDeleteSelectedStyle() » à la page 483.
dreamweaver.cssStylePalette.duplicateSelectedStyle()
Disponibilité
Dreamweaver 3.
Description
Duplique le style actuellement sélectionné dans le panneau Styles CSS et affiche la boîte de dialogue Dupliquer le style
afin de permettre à l'utilisateur d'attribuer un nom ou un sélecteur au nouveau style.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 366
Création
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canDuplicateSelectedStyle() » à la page 483.
dreamweaver.cssStylePalette.editSelectedStyle()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Définition du style correspondant au style sélectionné dans le panneau Styles CSS.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canEditSelectedStyle() » à la page 483.
dreamweaver.cssStylePalette.editSelectedStyleInCodeview()
Disponibilité
Dreamweaver 8.
Description
Cette fonction affiche le mode Code et déplace le curseur de la souris jusqu'au code du style actuellement sélectionné
dans le panneau Styles CSS.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 367
Création
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canEditSelectedStyleInCodeview() » à la page 484.
dreamweaver.cssStylePalette.editStyleSheet()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Modifier feuille de style.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canEditStyleSheet() » à la page 484.
dreamweaver.cssStylePalette.getDisplayStyles()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si les styles CSS sont rendus. La valeur par défaut est true.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les styles CSS sont rendus, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 368
Création
Exemple
var areStylesRendered = dw.cssStylePalette.getDisplayStyles();
dreamweaver.cssStylePalette.getMediaType()
Disponibilité
Dreamweaver MX 2004.
Description
Permet d'obtenir le type de média cible pour le rendu. Le type de média par défaut est "screen".
Arguments
Aucun.
Valeurs renvoyées
Chaîne indiquant le type de média cible.
Exemple
var mediaType = dw.cssStylePalette.getMediaType();
dreamweaver.cssStylePalette.getSelectedStyle()
Disponibilité
Dreamweaver 3 ; fullSelector disponible dans Dreamweaver MX.
Description
Obtient le nom du style actuellement sélectionné dans le panneau Styles CSS.
Arguments
fullSelector.
• L'argument fullSelector est une valeur booléenne qui indique si le sélecteur complet ou la classe uniquement doivent
être renvoyés. Si rien n'est précisé, seul le nom de classe est renvoyé. Par exemple, p.class1 est un sélecteur qui
signifie que le style est appliqué à n'importe quelle balise p de class1, mais il ne s'applique pas, par exemple, à une
balise div de class1. Sans l'argument fullSelector , la fonction
dreamweaver.cssStylePalette.getSelectedStyle() renvoie uniquement le nom de classe, class1, pour le
sélecteur. L'argument fullSelector ordonne à la fonction de renvoyer p.class1 au lieu de class1.
Valeurs renvoyées
Lorsque l'argument fullSelector a la valeur true, la fonction renvoie soit le sélecteur complet, soit une chaîne vide
lorsque le nœud de la feuille de style est sélectionné.
Lorsque l'argument fullSelector a la valeur false ou est ignoré, une chaîne qui représente le nom de classe du style
sélectionné est renvoyée. Si le style sélectionné n'a pas de classe ou si un nœud de feuille de style est sélectionné, une
chaîne vide est renvoyée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 369
Création
Exemple
Si le style red est sélectionné, un appel à la fonction dw.cssStylePalette.getSelectedStyle() renvoie "red".
dreamweaver.cssStylePalette.getStyles()
Disponibilité
Dreamweaver 3.
Description
Renvoie la liste de tous les styles de classe que contient le document actif. Sans arguments, il renvoie simplement les
noms de sélecteurs de classes. Si l'argument bGetIDs est true, il renvoie simplement les noms des sélecteurs d'ID. Dans
les deux cas, si l'argument bGetFullSelector est true, il renvoie le nom de sélecteur complet.
Prenons par exemple un fichier HTML avec le code suivant :
<style>
.test{ background:none };
p.foo{ background:none };
#bar {background:none };
div#hello p.world {background:none};
Les appels dans le tableau suivant renvoient les valeurs dans la colonne Résultat.
Appel de fonction
Résultat
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
Arguments
{bGetIDs}, {bGetFullSelector}
• L'argument bGetIDs est facultatif. Il s'agit d'une valeur booléenne qui, si défini sur true, oblige la fonction à
renvoyer uniquement les noms des sélecteurs d'ID (la partie située après le "#"). La valeur par défaut est false.
• L'argument bGetFullSelector est facultatif. Il s'agit d'une valeur booléenne qui, si défini sur true, renvoie la chaîne
du sélecteur complète, et non uniquement les noms. La valeur par défaut est false.
Valeurs renvoyées
Tableau de chaînes représentant les noms de tous les styles de classe contenus dans le document.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 370
Création
Exemple
Si la configuration du panneau Styles CSS est calquée sur l'exemple suivant, un appel à la fonction
dreamweaver.cssStylePalette.getStyles() renvoie un tableau qui contient ces chaînes : "BreadcrumbEnd",
"change", "doctitle", "heading" et "highlight".
dreamweaver.cssStylePalette.newStyle()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Nouveau style.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.cssStylePalette.renameSelectedStyle()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 371
Création
Description
Modifie le nom de classe utilisé dans la règle sélectionnée dans le panneau Styles CSS ainsi que toutes les instances du
nom de classe figurant dans la règle sélectionnée.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.cssStylePalette.canRenameSelectedStyle() » à la page 485.
dreamweaver.cssStylePalette.setDisplayStyles()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si les styles CSS doivent être rendus et actualise le rendu de tous les documents ouverts.
Arguments
display
• L'argument display est une valeur booléenne : true pour rendre les styles CSS et false dans le cas contraire.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant désactive le rendu des styles CSS :
dw.cssStylePalette.setDisplayStyles(false);
dreamweaver.cssStylePalette.setMediaType()
Disponibilité
Dreamweaver MX 2004.
Description
Permet de définir le type de média cible pour le rendu. Actualise le rendu de tous les documents ouverts.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 372
Création
Arguments
mediaType.
• L'argument mediaType indique le nouveau type de média cible.
Valeurs renvoyées
Aucune.
Exemple
dw.cssStylePalette.setMediaType("print");
dreamweaver.getBlockVisBoxModelColors()
Disponibilité
Dreamweaver 8.
Description
Cette fonction permet d'obtenir les couleurs utilisées pour rendre le modèle de boîte d'un bloc sélectionné lorsque
l'assistance visuelle Modèle de boîte des blocs de mise en forme est activée.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes contenant deux chaînes :
•
marginColor, qui correspond à la valeur hexadécimale de la couleur RVB, sous la forme #RRVVBB.
•
paddingColor, qui correspond à la valeur hexadécimale de la couleur RVB, sous la forme #RRVVBB.
Exemple
L'exemple suivant vérifie la valeur de la couleur des marges et du remplissage ; si aucune n'est blanche, elles sont toutes
deux définies sur blanc :
var boxColors = dreamweaver.getBlockVisBoxModelColors();
if ((boxColors[0] != "#FFFFFF") || (boxColors[1] != "#FFFFFF)){
currentDOM.setBlockVisBoxModelColors("#FFFFFF", "#FFFFFF");
}
dreamweaver.getBlockVisOutlineProperties()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie les propriétés de contour pour l'assistance visuelle de représentation des blocs.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 373
Création
Arguments
forWhat
• L'argument obligatoire forWhat est une chaîne. Les valeurs possibles sont les suivantes : "divs", "selectedDiv"
ou "layers". Si l'argument forWhat a pour valeur "divs", la fonction renvoie les propriétés utilisées pour
l'assistance visuelle qui met en surbrillance tous les blocs de mise en forme. Si l'argument forWhat a pour valeur
"selectedDiv", la fonction renvoie les propriétés utilisées pour l'assistance visuelle qui met en surbrillance les
blocs de mise en forme sélectionnés. La valeur layers définit les calques.
Valeurs renvoyées
Tableau de chaînes contenant trois chaînes :
•
color, qui correspond à la valeur hexadécimale de la couleur RVB, sous la forme #RRVVBB ;
•
width, qui indique la largeur en pixels ;
•
style, dont la valeur est soit "SOLID", "DOTTED", "DASHED" ou "OUTSET".
Exemple
L'exemple suivant renvoie les propriétés de contour de "divs" et définit le style de contour sur "SOLID" :
var outlineStyle = dw.getBlockVisOutlineProperties("divs");
if (outlineStyle[2] != "SOLID"){
dw.setBlockVisOutlineProperties("divs", outlineStyle[0], outlineStyle[1], "SOLID");
}
dreamweaver.getDivBackgroundColors()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie les couleurs utilisées par l'assistance visuelle Arrière-plans des blocs de mise en forme.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes contenant les 16couleurs, chaque couleur étant représentée par la valeur hexadécimale de la
couleur RVB, sous la forme #RRVVBB.
Exemple
L'exemple suivant renvoie les couleurs d'arrière-plans utilisées par l'assistance visuelle Arrière-plans des blocs de mise
en forme :
var backgroundColors = dreamweaver.getDivBackgroundColors();
dreamweaver.setBlockVisOutlineProperties()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 374
Création
Description
Cette fonction définit les propriétés de contour pour l'assistance visuelle de représentation des blocs.
Arguments
forWhat, color, width, {style}
• L'argument obligatoire forWhat est une chaîne indiquant l'utilisation prévue pour la couleur et la largeur spécifiées.
Les valeurs possibles sont les suivantes : "divs", "selectedDiv" ou "layers". Si la valeur est "layers", la
couleur et la largeur spécifiées sont utilisées pour mettre en surbrillance tous les calques lorsque l'assistance visuelle
Contours des blocs de mise en forme est activée. Si la valeur est "divs", les arguments color et width permettent de
mettre en surbrillance tous les divs et autres blocs de mise en forme. Si la valeur est "selectedDiv", les arguments
color et width permettent de mettre en surbrillance tout div ou bloc de mise en forme sélectionné.
• L'argument obligatoire color est une chaîne qui contient la valeur hexadécimale indiquant la couleur RVB sous la
forme #RRVVBB.
• L'argument obligatoire width est un entier qui indique la largeur du contour, en pixels.
• L'argument facultatif style est une chaîne qui indique le style du contour. Les valeurs possibles sont les suivantes :
"SOLID", "DOTTED", "DASHED" et "OUTSET". La valeur "OUTSET" est applicable aux calques uniquement. Cet
argument est ignoré lorsque la valeur de l'argument forWhat est "selectedDiv".
Valeurs renvoyées
Aucune.
Exemple
Voir « dreamweaver.getBlockVisOutlineProperties() » à la page 372.
dreamweaver.setDivBackgroundColors()
Disponibilité
Dreamweaver 8.
Description
Cette fonction définit les couleurs utilisées par l'assistance visuelle Arrière-plans des blocs de mise en forme.
Arguments
couleurs
• L'argument obligatoire colors est un tableau de chaînes contenant toutes les couleurs, représentées par des valeurs
hexadécimales sous la forme #RRVVBB. Ce tableau doit contenir 16 couleurs.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant vérifie qu'il y ait 16 couleurs maximum spécifiées comme couleurs d'arrière-plan div et, le cas
échéant, définit les couleurs utilisées comme couleurs d'arrière-plan en fonction des nuances de gris :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 375
Création
var currentDOM = dw.getDocumentDOM();
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]);
}
Fonctions relatives aux cadres et aux jeux de cadres
Les fonctions relatives aux cadres et aux jeux de cadres remplissent deux rôles : obtention des noms des cadres d'un jeu
de cadres et fractionnement d'un cadre en deux.
dom.getFrameNames()
Disponibilité
Dreamweaver 3.
Description
Renvoie la liste de tous les cadres nommés du jeu de cadres.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes où chaque chaîne correspond au nom d'un cadre dans le jeu de cadres en cours. La fonction ignore
tous les cadres sans nom. Si aucun des cadres du jeu n'est nommé, un tableau vide est renvoyé.
Exemple
Pour un document contenant quatre cadres, dont deux sont nommés, un appel à la fonction dom.getFrameNames()
pourrait renvoyer un tableau contenant les chaînes suivantes :
•
"navframe"
•
"main_content"
dom.isDocumentInFrame()
Disponibilité
Dreamweaver 4.
Description
Indique si le document actif est affiché à l'intérieur d'un jeu de cadres.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 376
Création
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le document se trouve dans un jeu de cadres et false dans le cas contraire.
dom.saveAllFrames()
Disponibilité
Dreamweaver 4.
Description
Si un document est un jeu de cadres ou se trouve à l'intérieur d'un jeu de cadres, cette fonction enregistre tous les cadres
ou les jeux de la fenêtre de document. Si le document spécifié ne se trouve pas dans un jeu de cadres, cette fonction
enregistre le document. Cette fonction ouvre la boîte de dialogue Enregistrer sous pour tous les documents qui n'ont
pas été enregistrés précédemment.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.splitFrame()
Disponibilité
Dreamweaver 3.
Description
Fractionne le cadre sélectionné verticalement ou horizontalement.
Arguments
splitDirection.
• L'argument splitDirection est une chaîne qui doit définir l'une des directions suivantes : "up", "down", "left" ou
"right".
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canSplitFrame() » à la page 472.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 377
Création
Fonctions relatives aux calques et aux cartes d'images
Ces fonctions permettent d'aligner, de redimensionner et de déplacer des calques et des zones réactives de carte
d'images. Il est indiqué, dans la description de chaque fonction, si cette dernière s'applique aux calques ou aux zones
réactives.
dom.align()
Disponibilité
Dreamweaver 3.
Description
Aligne à gauche, à droite, en haut ou en bas les calques ou zones réactives sélectionnés.
Arguments
alignDirection.
• L'argument alignDirection est une chaîne qui représente le bord par rapport auquel aligner les calques ou les zones
réactives, à savoir "left", "right", "top" ou "bottom".
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canAlign() » à la page 463.
dom.arrange()
Disponibilité
Dreamweaver 3.
Description
Déplace les zones réactives sélectionnées dans le sens indiqué.
Arguments
toBackOrFront.
• L'argument toBackOrFront correspond au sens du déplacement des zones réactives, à savoir front ou back.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canArrange() » à la page 464.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 378
Création
dom.makeSizesEqual()
Disponibilité
Dreamweaver 3.
Description
Affecte aux calques ou aux zones réactives sélectionnés la même hauteur ou la même largeur, ou les deux. Le dernier
calque ou la dernière zone réactive sélectionnée sert de guide.
Arguments
bHoriz, bVert.
• L'argument bHoriz est une valeur booléenne qui indique si les calques ou les zones réactives doivent être
redimensionnés horizontalement.
• L'argument bVert est une valeur booléenne qui indique si les calques ou les zones réactives doivent être
redimensionnés verticalement.
Valeurs renvoyées
Aucune.
dom.moveSelectionBy()
Disponibilité
Dreamweaver 3.
Description
Déplace les calques ou les zones réactives sélectionnés horizontalement et verticalement du nombre de pixels spécifiés.
Arguments
x, y
• L'argument x est le nombre de pixels dont la sélection doit être déplacée horizontalement.
• L'argument y est le nombre de pixels dont la sélection doit être déplacée verticalement.
Valeurs renvoyées
Aucune.
dom.resizeSelectionBy()
Disponibilité
Dreamweaver 3.
Description
Redimensionne le calque ou la zone réactive sélectionnée.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 379
Création
Arguments
left, top, bottom, right.
• L'argument left est la nouvelle position de la limite gauche du calque ou de la zone réactive.
• L'argument top est la nouvelle position de la limite supérieure du calque ou de la zone réactive.
• L'argument bottom est la nouvelle position de la limite inférieure du calque ou de la zone réactive.
• L'argument right est la nouvelle position de la limite droite du calque ou de la zone réactive.
Valeurs renvoyées
Aucune.
Exemple
Si le calque sélectionné possède les propriétés Gauche (left), Sommet (top), Largeur (width) et Hauteur (height)
indiquées, un appel à la fonction dw.getDocumentDOM().resizeSelectionBy(10,30,30,10) revient à restaurer
Gauche à 40, Sommet à 20, Largeur à 240 et Hauteur à 240.
dom.setLayerTag()
Disponibilité
Dreamweaver 3.
Description
Spécifie la balise HTML définissant le ou les calques sélectionnés.
Arguments
tagName
• L'argument tagName doit être "layer","ilayer",
"div" ou "span".
Valeurs renvoyées
Aucune.
Fonctions d'environnement de mise en forme
Ces fonctions permettent d'effectuer des opérations associées aux paramètres d'utilisation d'un document. Elles
permettent de modifier la source, la position et l'opacité du tracé de l'image, d'obtenir et de définir l'origine et les unités
de mesure de la règle, d'activer et de désactiver la grille et d'en modifier les paramètres, de démarrer et d'arrêter
l'exécution des plug-ins.
dom.getRulerOrigin()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 380
Création
Description
Renvoie l'origine de la règle.
Arguments
Aucun.
Valeurs renvoyées
Tableau contenant deux nombres entiers. Le premier entier correspond à la coordonnée x de l'origine, le second à la
coordonnée y. Les deux valeurs sont exprimées en pixels.
dom.getRulerUnits()
Disponibilité
Dreamweaver 3.
Description
Renvoie les unités de mesure actuelles de la règle.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient l'une des valeurs suivantes :
•
"in"
•
"cm"
•
"px"
dom.getTracingImageOpacity()
Disponibilité
Dreamweaver 3.
Description
Renvoie le paramètre d'opacité du tracé de l'image dans le document actif.
Arguments
Aucun.
Valeurs renvoyées
Valeur comprise entre 0 et 100, ou rien si l'opacité n'est pas définie.
Activateur
Voir « dom.hasTracingImage() » à la page 473.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 381
Création
dom.loadTracingImage()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Sélectionner source de l'image. Si l'utilisateur sélectionne une image et clique sur OK, la
boîte de dialogue Propriétés de la page s'ouvre et le champ Tracé de l'image contient une valeur.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.playAllPlugins()
Disponibilité
Dreamweaver 3.
Description
Exécute tous les plug-ins dans le document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.playPlugin()
Disponibilité
Dreamweaver 3.
Description
Exécute le plug-in sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canPlayPlugin() » à la page 470.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 382
Création
dom.getRulerOrigin()
Disponibilité
Dreamweaver 3.
Description
Définit l'origine de la règle.
Arguments
xCoordinate, yCoordinate
• L'argument xCoordinate est une valeur, exprimée en pixels, sur l'axe horizontal.
• L'argument yCoordinate est une valeur, exprimée en pixels, sur l'axe vertical.
Valeurs renvoyées
Aucune.
dom.setRulerUnits()
Disponibilité
Dreamweaver 3.
Description
Définit les unités de mesure de la règle.
Arguments
units
• L'argument units doit être "px", "in" ou "cm".
Valeurs renvoyées
Aucune.
dom.setTracingImagePosition()
Disponibilité
Dreamweaver 3.
Description
Déplace le coin supérieur gauche du tracé de l'image vers les coordonnées spécifiées. Si les arguments ne sont pas
définis, la boîte de dialogue Ajuster la position du tracé de l'image s'affiche.
Arguments
x, y
• L'argument x est le nombre de pixels définissant la coordonnée horizontale.
• L'argument y est le nombre de pixels définissant la coordonnée verticale.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 383
Création
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.hasTracingImage() » à la page 473.
dom.setTracingImageOpacity()
Disponibilité
Dreamweaver 3.
Description
Définit le pourcentage d'opacité du tracé de l'image.
Arguments
opacityPercentage.
• L'argument opacityPercentage doit être un nombre entre 0 et 100.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.hasTracingImage() » à la page 473.
Exemple
Le code suivant règle l'opacité du tracé de l'image sur 30% :
dw.getDocumentDOM().setTracingOpacity('30');
dom.snapTracingImageToSelection()
Disponibilité
Dreamweaver 3.
Description
Aligne le coin supérieur gauche du tracé de l'image avec le coin supérieur gauche de la sélection en cours.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.hasTracingImage() » à la page 473.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 384
Création
dom.stopAllPlugins()
Disponibilité
Dreamweaver 3.
Description
Arrête l'exécution de tous les plug-ins en cours dans le document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.stopPlugin()
Disponibilité
Dreamweaver 3.
Description
Arrête le plug-in sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne qui indique si la sélection est exécutée actuellement avec un plug-in.
Activateur
Voir « dom.canStopPlugin() » à la page 472.
dreamweaver.arrangeFloatingPalettes()
Disponibilité
Dreamweaver 3.
Description
Déplace les panneaux flottants visibles vers leur position par défaut.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 385
Création
dreamweaver.showGridSettingsDialog()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Paramètres de la grille.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Fonctions relatives au mode de Mise en forme
Ces fonctions permettent de modifier les éléments de mise en forme d'un document. Elles s'appliquent aux paramètres
de tableau, colonnes et cellules, y compris leur position, propriétés et aspect.
dom.getClickedHeaderColumn()
Disponibilité
Dreamweaver 4.
Description
Si l'utilisateur clique sur un bouton de menu dans l'en-tête d'un tableau du mode de Mise en forme, faisant ainsi
apparaître le menu d'en-tête du tableau, cette fonction renvoie l'index de la colonne sur laquelle l'utilisateur a cliqué.
Le résultat n'est pas défini si le menu d'en-tête du tableau n'est pas visible.
Arguments
Aucun.
Valeurs renvoyées
Nombre entier qui représente l'index de la colonne.
dom.getShowLayoutTableTabs()
Disponibilité
Dreamweaver 4.
Description
Détermine si le document actif affiche les tabulations des tableaux de Mise en forme dans le mode correspondant.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 386
Création
Arguments
Aucun.
Valeurs renvoyées
Renvoie la valeur true si le document actif affiche les tabulations des tableaux de Mise en forme dans le mode
correspondant et false si tel n'est pas le cas.
dom.getShowLayoutView()
Disponibilité
Dreamweaver 4.
Description
Détermine le mode d'affichage du document actif, Mise en forme ou Standard.
Arguments
Aucun.
Valeurs renvoyées
Renvoie la valeur true si le document actif est en mode de Mise en forme et false s'il est en mode Standard.
dom.getShowBlockBackgrounds()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'état de l'assistance visuelle qui active la coloration de l'arrière-plan de tous les blocs ou divs.
Arguments
allblocks
• L'argument obligatoire allblocks est une valeur booléenne. Définir la valeur sur true pour que l'argument ne soit
appliqué qu'aux balises div. Définir la valeur sur false pour que l'argument soit appliqué à tous les éléments de bloc.
Valeurs renvoyées
Valeur booléenne. Si définie sur true, les arrière-plans sont imposés ; si définie sur false, les arrière-plans ne
sont pas imposés.
Exemple
L'exemple suivant vérifie si la coloration d'arrière-plan de tous les blocs est imposée et, si ce n'est pas le cas, active la
coloration d'arrière-plan de tous les blocs ::
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowBlockBackgrounds(false) == false){
currentDOM.setShowBlockBackgrounds(false);
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 387
Création
dom.getShowBlockBorders()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'état de l'assistance visuelle qui dessine les bordures de tous les blocs ou divs.
Arguments
allblocks
• L'argument obligatoire allblocks est une valeur booléenne. Définir la valeur sur true pour obtenir uniquement l'état
des balises div. Définir la valeur sur false pour obtenir l'état de tous les éléments de bloc.
Valeurs renvoyées
Valeur booléenne ; si définie sur true, les bordures sont affichées ; si définie sur false, les bordures ne sont pas
affichées.
Exemple
L'exemple suivant vérifie si l'assistance visuelle des bordures de blocs est activée et, si ce n'est pas le cas, l'active :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowBlockBorders(false) == false){
currentDOM.setShowBlockBorders(true);
}
dom.getShowBlockIDs()
Disponibilité
Dreamweaver 8.
Description
Cette fonction renvoie l'état de l'assistance visuelle qui affiche les informations relatives à la classe et à l'ID de tous les
blocs ou divs.
Arguments
allblocks
• L'argument obligatoire allblocks est une valeur booléenne. Définir la valeur sur true pour afficher uniquement la
classe et l'ID des balises div. Définir la valeur sur false pour afficher la classe et l'ID de tous les éléments de bloc.
Valeurs renvoyées
Valeur booléenne : si définie sur true, les ID sont affichés ; si définie sur false, les ID ne sont pas affichés.
Exemple
L'exemple suivant vérifie si les ID de blocs sont affichés et, si ce n'est pas le cas, les affiche :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 388
Création
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowBlockIDs(false) == false){
currentDOM.setShowBlockIDs(true);
}
dom.getShowBoxModel()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle qui colore le modèle de boîte complet du bloc sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant vérifie si le modèle de boîte complet de la boîte sélectionnée est affiché en couleur et, si ce n'est pas
le cas, le colore :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.getShowBoxModel() == false){
currentDOM.setShowBoxModel(true);
}
dom.setShowBlockBackgrounds()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle qui commande la coloration de l'arrière-plan de tous les blocs
ou divs.
Arguments
allblocks
• L'argument obligatoire allblocks est une valeur booléenne. Définir la valeur sur true pour appliquer la coloration
d'arrière-plan aux balises div uniquement. Définir la valeur sur false pour appliquer la coloration d'arrière-plan à
tous les éléments de bloc.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 389
Création
Exemple
Voir « dom.getShowBlockBackgrounds() » à la page 386.
dom.setShowBlockBorders()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle qui dessine les bordures de tous les blocs ou divs.
Arguments
allblocks
• L'argument obligatoire allblocks est une valeur booléenne. Définir la valeur sur true pour appliquer les bordures
aux balises div uniquement. Définir la valeur sur false pour appliquer les bordures à tous les éléments de bloc.
Valeurs renvoyées
Aucune.
Exemple
Voir « dom.getShowBlockBorders() » à la page 387.
dom.setShowBlockIDs()
Disponibilité
Dreamweaver 8.
Description
Cette fonction active ou désactive l'assistance visuelle qui affiche l'ID et la classe de tous les blocs ou divs.
Arguments
allblocks
• L'argument obligatoire allblocks est une valeur booléenne. Définir la valeur sur true pour afficher la classe et l'ID
des balises div uniquement. Définir la valeur sur false pour afficher la classe et l'ID de tous les éléments de bloc.
Valeurs renvoyées
Aucune.
Exemple
Voir « dom.getShowBlockIDs() » à la page 387.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 390
Création
dom.setShowBoxModel()
Disponibilité
Dreamweaver 8.
Description
Cette fonction définit l'état de l'assistance visuelle qui colore le modèle de boîte complet du bloc sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le modèle de boîte est affiché, false dans le cas contraire.
Exemple
Voir « dom.getShowBoxModel() » à la page 388.
dom.setShowLayoutTableTabs()
Disponibilité
Dreamweaver 4.
Description
Configure le document actif pour qu'il affiche les tabulations des tableaux de Mise en forme chaque fois qu'il est en
mode de Mise en forme. Cette fonction ne place pas le document en mode de Mise en forme.
Arguments
bShow.
• L'argument bShow indique si les tabulations des tableaux de Mise en forme doivent s'afficher lorsque le document
actif est en mode de Mise en forme. Si bShow a la valeur true, Dreamweaver affiche les tabulations ; si bShow a la
valeur false, il ne les affiche pas.
Valeurs renvoyées
Aucune.
dom.getShowLayoutView()
Disponibilité
Dreamweaver 4.
Description
Met le document actif en mode de Mise en forme si bShow a pour valeur true.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 391
Création
Arguments
bShow.
• L'argument bShow est une valeur booléenne qui fait passer le document actif du mode de Mise en forme au mode
Standard, et vice versa. Si la valeur de l'argument bShow est true, le document actif est en mode de Mise en forme ;
si la valeur de bShow est false, il est en mode Standard.
Valeurs renvoyées
Aucune.
Fonctions relatives aux zooms
Fonctions de zoom avant et arrière en mode Création.
dreamweaver.activeViewScale()
Disponibilité
Dreamweaver 8.
Description
La propriété activeViewScale obtient ou définit une virgule flottante modifiable. Lorsque vous obtenez la valeur,
Dreamweaver renvoie l'échelle de la vue active telle qu'elle figure dans la zone de liste modifiable Zoom, divisée par
100. Par exemple, 100% est indiqué par 1,0, 50% par 0,5, et ainsi de suite. Lorsque vous définissez la valeur,
Dreamweaver définit la valeur dans la zone de liste modifiable Zoom. Cette valeur peut être comprise entre 0,06 et 64,
ce qui correspond à 6% et 6400%.
Exemple
L'exemple suivant obtient la valeur de l'échelle du mode actuel. Il effectue aussi un zoom avant, s'il le peut et si l'échelle
est inférieure ou égale à 100% :
if (canZoom() && dreamweaver.activeViewScale <= 1.0) {
zoomIn();
}
L'exemple suivant fixe la valeur de l'échelle du mode actuel à 50% :
dreamweaver.activeViewScale = 0.50;
dreamweaver.fitAll()
Disponibilité
Dreamweaver 8.
Description
Cette fonction effectue un zoom avant ou arrière de manière à ce que la totalité du document s'adapte à la zone
actuellement visible du mode Création.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 392
Création
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canZoom() » à la page 481.
Exemple
if (canZoom()){
fitAll();
}
dreamweaver.fitSelection()
Disponibilité
Dreamweaver 8.
Description
Cette fonction effectue un zoom avant ou arrière de manière à ce que la sélection en cours s'adapte à la zone
actuellement visible du mode Création.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canFitSelection() » à la page 476.
Exemple
if (canFitSeletion()){
fitSelection();
}
dreamweaver.fitWidth()
Disponibilité
Dreamweaver 8.
Description
Cette fonction effectue un zoom avant ou arrière de manière à ce que la largeur totale du document s'adapte à la zone
actuellement visible du mode Création.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 393
Création
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canZoom() » à la page 481.
Exemple
if (canZoom()){
fitWidth();
}
dreamweaver.zoomIn()
Disponibilité
Dreamweaver 8.
Description
Cette fonction effectue un zoom avant sur la fenêtre de mode Création active. Le niveau de zoom correspond à la valeur
prédéfinie dans le menu Zoom. Si aucune valeur n'est prédéfinie, cette fonction est inactive.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canZoom() » à la page 481.
Exemple
if (canZoom()){
zoomIn();
}
dreamweaver.zoomOut()
Disponibilité
Dreamweaver 8.
Description
Cette fonction effectue un zoom arrière sur la fenêtre de mode Création active. Le niveau de zoom correspond à la
valeur prédéfinie dans le menu Zoom. Si aucune valeur n'est prédéfinie, cette fonction est inactive.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 394
Création
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canZoom() » à la page 481.
Exemple
if (canZoom()){
zoomOut();
}
Propriétés et fonctions de repère
Les propriétés et fonctions de repère permettent d'afficher, de manipuler et de supprimer des repères utilisés par les
utilisateurs pour mesurer et mettre en forme des éléments sur leurs pages HTML.
dom.clearGuides()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si tous les repères du document doivent être supprimés.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant supprime tous les repères contenus dans le document si ce dernier en contient au moins un :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.hasGuides() == true) {
currentDOM.clearGuides();
}
dom.createHorizontalGuide()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 395
Création
Description
Cette fonction crée un repère horizontal à l'emplacement spécifié dans le document.
Arguments
location
• L'argument location représente l'emplacement du repère, qui correspond à une chaîne unique contenant à la fois la
valeur et les unités de mesure sans espace entre les deux. Les unités possibles sont "px" pour les pixels et "%" pour
les pourcentages. Par exemple, pour indiquer 10 pixels, location = "10px" ; pour indiquer 50 pour cent,
location = "50%".
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant crée un repère horizontal à l'emplacement spécifié dans le document :
var currentDOM = dw.getDocumentDOM();
currentDOM.createHorizontalGuide("10px");
dom.createVerticalGuide()
Disponibilité
Dreamweaver 8.
Description
Cette fonction crée un repère vertical à l'emplacement spécifié dans le document.
Arguments
location
• L'argument location représente l'emplacement du repère, qui correspond à une chaîne unique contenant à la fois la
valeur et les unités de mesure sans espace entre les deux. Les unités possibles sont "px" pour les pixels et "%" pour
les pourcentages. Par exemple, pour indiquer 10 pixels, location = "10px" ; pour indiquer 50 pour cent,
location = "50%".
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant crée un repère vertical à l'emplacement spécifié dans le document:
var currentDOM = dw.getDocumentDOM();
currentDOM.createVerticalGuide("10px");
dom.deleteHorizontalGuide()
Disponibilité
Dreamweaver 8.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 396
Création
Description
Cette fonction supprime le repère horizontal à l'emplacement spécifié.
Arguments
location
• L'argument location est une chaîne unique représentant l'emplacement à tester dans le document, contenant à la
fois la valeur et les unités de mesure sans espace entre les deux. Les unités possibles sont "px" pour les pixels et "%"
pour les pourcentages. Par exemple, pour indiquer 10 pixels, location = "10px" ; pour indiquer 50 pour cent,
location = "50%".
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant supprime le repère horizontal à l'emplacement spécifié dans le document :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.hasHorizontalGuide("10px") == true) {
currentDOM.deleteHorizonalGuide("10px");
}
dom.deleteVerticalGuide()
Disponibilité
Dreamweaver 8.
Description
Cette fonction supprime le repère vertical à l'emplacement spécifié.
Arguments
location
• L'argument location est une chaîne unique représentant l'emplacement à tester dans le document, contenant à la
fois la valeur et les unités de mesure sans espace entre les deux. Les unités possibles sont "px" pour les pixels et "%"
pour les pourcentages. Par exemple, pour indiquer 10 pixels, location = "10px" ; pour indiquer 50 pour cent,
location = "50%".
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant supprime le repère vertical à l'emplacement spécifié dans le document :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.hasVerticalGuide("10px") == true) {
currentDOM.deleteVerticalGuide("10px");
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 397
Création
dom.guidesColor
Disponibilité
Dreamweaver 8.
Description
Cette propriété de couleur modifiable détermine la couleur des repères contenus dans le document. Vous pouvez
définir et consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant affiche les repères en gris :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.guidesColor != "#444444"){
currentDOM.guidesColor = "#444444";
}
dom.guidesDistanceColor
Disponibilité
Dreamweaver 8.
Description
Cette propriété de couleur modifiable détermine la couleur des commentaires distants des repères contenus dans le
document. Vous pouvez définir et consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant affiche la couleur des commentaires distants des repères en gris :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.guidesDistanceColor != "#CCCCCC"){
currentDOM.guidesDistanceColor = "#CCCCCC";
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 398
Création
dom.guidesLocked
Disponibilité
Dreamweaver 8.
Description
Cette propriété booléenne modifiable détermine si les repères doivent être verrouillés dans le document. Vous pouvez
définir et consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant verrouille les repères s'ils ne le sont pas :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.guidesLocked == false) {
currentDOM.guidesLocked = true;
}
dom.guidesSnapToElements
Disponibilité
Dreamweaver 8.
Description
Cette propriété booléenne modifiable détermine s'il faut aligner les repères sur les éléments dans le document. Vous
pouvez définir et consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant aligne les repères contenus dans le document sur les éléments :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.guidesSnapToElements == false) {
currentDOM.guidesSnapToElements = true;
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 399
Création
dom.guidesVisible
Disponibilité
Dreamweaver 8.
Description
Cette propriété booléenne modifiable détermine si les repères sont visibles dans le document. Vous pouvez définir et
consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant affiche les repères s'ils ne sont pas visibles :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.guidesVisible == false) {
currentDOM.guidesVisible = true;
}
dom.hasGuides()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si le document contient au moins un repère. Vous pouvez définir et consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant supprime tous les repères contenus dans le document si ce dernier en contient au moins un :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.hasGuides() == true) {
currentDOM.clearGuides();
}
RÉFÉRENCE DES API DE DREAMWEAVER CS4 400
Création
dom.hasHorizontalGuide()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si le document contient un repère horizontal à l'emplacement spécifié.
Arguments
location
• L'argument location est une chaîne unique représentant l'emplacement à tester dans le document, contenant à la
fois la valeur et les unités de mesure sans espace entre les deux. Les unités possibles sont "px" pour les pixels et "%"
pour les pourcentages. Par exemple, pour indiquer 10 pixels, location = "10px" ; pour indiquer 50 pour cent,
location = "50%".
Valeurs renvoyées
Valeur booléenne : true s'il y a un repère horizontal à l'emplacement spécifié, false dans le cas contraire.
Exemple
L'exemple suivant supprime tous les repères contenus dans le document si ce dernier contient un repère horizontal à
l'emplacement spécifié :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.hasHorizontalGuide("10px") == true) {
currentDOM.clearGuides();
}
dom.hasVerticalGuide()
Disponibilité
Dreamweaver 8.
Description
Cette fonction détermine si le document contient un repère vertical à l'emplacement spécifié.
Arguments
location
• L'argument location est une chaîne unique représentant l'emplacement à tester dans le document, contenant à la
fois la valeur et les unités de mesure sans espace entre les deux. Les unités possibles sont "px" pour les pixels et "%"
pour les pourcentages. Par exemple, pour indiquer 10 pixels, location = "10px" ; pour indiquer 50 pour cent,
location = "50%".
Valeurs renvoyées
Valeur booléenne : true s'il y a un repère vertical à l'emplacement spécifié, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 401
Création
Exemple
L'exemple suivant supprime tous les repères contenus dans le document si ce dernier contient un repère vertical à
l'emplacement spécifié :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.hasVerticalGuide("10px") == true) {
currentDOM.clearGuides();
}
dom.snapToGuides
Disponibilité
Dreamweaver 8.
Description
Cette propriété booléenne modifiable détermine s'il faut aligner les éléments sur les repères dans le document. Vous
pouvez définir et consulter cette propriété.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant aligne les éléments du document sur les repères :
var currentDOM = dw.getDocumentDOM();
if (currentDOM.snapToGuides == false) {
currentDOM.snapToGuides = true;
}
Fonctions de modification des tableaux
Ces fonctions permettent d'insérer et de supprimer des lignes et des colonnes dans des tableaux, de modifier la largeur
des colonnes et la hauteur des lignes, de convertir en pourcentage des mesures exprimées en pixels (et vice versa) et
d'effectuer d'autres opérations standard de modification des tableaux.
dom.convertWidthsToPercent()
Disponibilité
Dreamweaver 3.
Description
Cette fonction convertit en pourcentage tous les attributs WIDTH exprimés en pixels du tableau en cours.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 402
Création
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.convertWidthsToPixels()
Disponibilité
Dreamweaver 4.
Description
Cette fonction convertit en pourcentage tous les attributs WIDTH exprimés en pixels du tableau en cours.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.decreaseColspan()
Disponibilité
Dreamweaver 3.
Description
Cette fonction diminue l'étendue de colonnes de 1.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canDecreaseColspan() » à la page 466.
dom.decreaseRowspan()
Disponibilité
Dreamweaver 3.
Description
Cette fonction diminue l'étendue de lignes de 1.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 403
Création
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canDecreaseRowspan() » à la page 466.
dom.deleteTableColumn()
Disponibilité
Dreamweaver 3.
Description
Cette fonction supprime du tableau la ou les colonnes sélectionnées.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canDeleteTableColumn() » à la page 466.
dom.deleteTableRow()
Disponibilité
Dreamweaver 3.
Description
Cette fonction supprime du tableau la ou les lignes sélectionnées.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canDeleteTableRow() » à la page 467.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 404
Création
dom.doDeferredTableUpdate()
Disponibilité
Dreamweaver 3.
Description
Si l'option Modification de tableau plus rapide est activée dans la catégorie Général des préférences, cette fonction
oblige la mise en forme du tableau à adopter les modifications apportées récemment, et ce sans déplacer la sélection à
l'extérieur du tableau. Cette fonction n'a aucun effet si l'option Modification de tableau plus rapide n'est pas activée.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.getShowTableWidths()
Disponibilité
Dreamweaver MX 2004, mise à jour dans CS4.
Description
Indique si les largeurs d'un tableau s'affichent en mode Standard ou Tableaux développés. Pour plus d'informations
sur l'affichage des tabulations de tableau en mode de Mise en forme dans Dreamweaver, consultez la section
« dom.getShowLayoutTableTabs() » à la page 385.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si Dreamweaver affiche les largeurs du tableau en mode Standard ou Tableaux développés,
false dans le cas contraire.
dom.getTableExtent()
Disponibilité
Dreamweaver 3.
Description
Cette fonction renvoie le nombre de colonnes et de lignes du tableau sélectionné.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 405
Création
Valeurs renvoyées
Tableau contenant deux nombres entiers. Le premier entier correspond au nombre de colonnes, et le second au
nombre de lignes. Si aucun tableau n'est sélectionné, aucune valeur n'est renvoyée.
dom.increaseColspan()
Disponibilité
Dreamweaver 3.
Description
Cette fonction augmente l'étendue de colonnes de 1.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canIncreaseColspan() » à la page 467.
dom.increaseRowspan()
Disponibilité
Dreamweaver 3.
Description
Cette fonction augmente l'étendue de lignes de 1.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canIncreaseRowspan() » à la page 468.
dom.insertTableColumns()
Disponibilité
Dreamweaver 3.
Description
Cette fonction insère le nombre de colonnes spécifié dans le tableau en cours.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 406
Création
Arguments
numberOfCols, bBeforeSelection
• L'argument numberOfCols est le nombre de colonnes à insérer.
• L'argument bBeforeSelection est une valeur booléenne : true indique que les colonnes doivent être insérées avant
celle qui contient la sélection, et false indique le contraire.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canInsertTableColumns() » à la page 468.
dom.insertTableRows()
Disponibilité
Dreamweaver 3.
Description
Cette fonction insère le nombre de lignes spécifié dans le tableau en cours.
Arguments
numberOfRows, bBeforeSelection
• L'argument numberOfRows est le nombre de lignes à insérer.
• L'argument bBeforeSelection est une valeur booléenne : true indique que les lignes doivent être insérées au-dessus
de celle qui contient la sélection, et false indique le contraire.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canInsertTableRows() » à la page 468.
dom.mergeTableCells()
Disponibilité
Dreamweaver 3.
Description
Cette fonction fusionne les cellules de tableau sélectionnées.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 407
Création
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canMergeTableCells() » à la page 469.
dom.removeAllTableHeights()
Disponibilité
Dreamweaver 3.
Description
Cette fonction supprime tous les attributs HEIGHT du tableau sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.removeAllTableWidths()
Disponibilité
Dreamweaver 3.
Description
Cette fonction supprime tous les attributs WIDTH du tableau sélectionné.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.removeColumnWidth()
Disponibilité
Dreamweaver MX 2004.
Description
Cette fonction supprime tous les attributs WIDTH d'une unique colonne sélectionnée.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 408
Création
Valeurs renvoyées
Aucune.
dom.selectTable()
Disponibilité
Dreamweaver 3.
Description
Sélectionne un tableau entier.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canSelectTable() » à la page 471.
dom.setShowTableWidths()
Disponibilité
Dreamweaver MX 2004, mis à jour dans CS 4.
Description
Permet d'activer ou de désactiver l'affichage des largeurs d'un tableau en mode Standard ou Tableaux développés. Cette
fonction définit la valeur assignée au document en cours et à tous les documents suivants, sauf indication contraire.
Pour plus d'informations sur la définition de l'affichage des tabulations de tableau en mode de Mise en forme dans
Dreamweaver, consultez la section « dom.setShowLayoutTableTabs() » à la page 390.
Arguments
bShow
•
bShow est un argument booléen qui indique si les largeurs de tableau doivent s'afficher lorsque le document en
cours est en mode Standard ou Tableaux développés. Si la valeur de bShow est true, Dreamweaver affiche les
largeurs. Si la valeur de bShow est false, Dreamweaver ne les affiche pas.
Valeurs renvoyées
Aucune.
dom.setTableCellTag()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 409
Création
Description
Cette fonction définit la balise de la cellule sélectionnée.
Arguments
tdOrTh.
• L'argument tdOrTh doit être "td" ou "th".
Valeurs renvoyées
Aucune.
dom.setTableColumns()
Disponibilité
Dreamweaver 3.
Description
Cette fonction définit le nombre de colonnes du tableau sélectionné.
Arguments
numberOfCols.
• L'argument numberOfCols indique le nombre de colonnes à définir dans le tableau.
Valeurs renvoyées
Aucune.
dom.setTableRows()
Disponibilité
Dreamweaver 3.
Description
Cette fonction définit le nombre de lignes du tableau sélectionné.
Arguments
numberOfCols.
• L'argument numberOfRows indique le nombre de lignes à définir dans le tableau sélectionné.
Valeurs renvoyées
Aucune.
dom.showInsertTableRowsOrColumnsDialog()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 410
Création
Description
Cette fonction ouvre la boîte de dialogue Insérer des lignes ou des colonnes.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canInsertTableColumns() » à la page 468 ou « dom.canInsertTableRows() » à la page 468.
dom.splitTableCell()
Disponibilité
Dreamweaver 3.
Description
Cette fonction fractionne la cellule de tableau en cours en un nombre de lignes ou de colonnes donné. Si vous ne
définissez pas l'un des deux arguments, ou les deux, la boîte de dialogue Fractionner la cellule s'affiche.
Arguments
{colsOrRows}, {numberToSplitInto}
• L'argument facultatif colsOrRows doit être "columns" ou "rows".
• L'argument facultatif numberToSplitInto indique en combien de lignes ou de colonnes la cellule doit être
fractionnée.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canSplitTableCell() » à la page 472.
411
Chapitre 18 : Code
Les fonctions de code vous permettent d'effectuer des opérations sur un document affiché en mode Code. Ces
opérations comprennent l'ajout de nouvelles balises de fonction ou de menu à un menu d'indicateurs de code, la
recherche et le remplacement de modèles de chaînes, la suppression de la sélection en cours, l'impression de code
complet ou sélectionné, la modification de balises ou l'application de formatage de syntaxe au code sélectionné.
Fonctions de code
Les indicateurs de code sont des menus contextuels qui s'affichent dans Adobe® Dreamweaver® CS4 lorsque vous tapez
certains caractères en mode Code. Ils vous évitent de saisir tout le texte en proposant une liste de chaînes susceptibles
de compléter la chaîne que vous tapez. Si la chaîne que vous tapez apparaît dans le menu, sélectionnez-la et appuyez
sur Entrée ou Retour pour compléter votre saisie. Si vous tapez <, par exemple, un menu contextuel affiche une liste
des noms de balises. Plutôt que de taper le reste du nom de la balise, vous pouvez la sélectionner dans le menu pour
l'inclure à votre texte.
Vous pouvez ajouter des menus Indicateurs de code dans Dreamweaver en les définissant dans le fichier
CodeHints.xml. Pour plus d'informations sur le fichier CodeHints.xml, voir Extension de Dreamweaver.
Vous pouvez également ajouter de nouveaux menus d'indicateurs de code de façon dynamique via JavaScript après
chargement du contenu du fichier CodeHints.xml par Dreamweaver. Par exemple, le code JavaScript ajoute des
données à la liste des variables de session dans le panneau Liaisons. Vous pouvez utiliser le même code pour ajouter
un menu Indicateurs de code. Ainsi, Dreamweaver affiche un menu de variables de session lorsqu'un utilisateur tape
Session en mode Code.
Le fichier CodeHints.xml et l'API JavaScript contiennent un sous-ensemble utile du moteur Indicateurs de code, mais
certaines fonctionnalités de Dreamweaver ne sont pas accessibles. Par exemple, comme il n'existe pas d'accroche
JavaScript pouvant afficher un sélecteur de couleur, Dreamweaver ne peut pas exprimer le menu Valeurs des attributs
à l'aide de JavaScript. Vous pouvez uniquement afficher un menu d'éléments de texte permettant d'insérer du texte.
La coloration du code vous permet de définir des styles de couleur de code et de modifier des modèles de coloration
de code ou d'en créer de nouveaux. Vous pouvez spécifier ces styles et modèles en modifiant le fichier Colors.xml et
celui de modèle de coloration. Pour plus d'informations sur ces fichiers, voir Extension de Dreamweaver.
L'API JavaScript pour les indicateurs et la coloration de code comprend les fonctions suivantes :
dreamweaver.codeHints.addMenu()
Disponibilité
Dreamweaver MX.
Description
Définit dynamiquement une nouvelle balise menu dans le fichier CodeHints.xml. S'il existe une balise de menu
possédant le même modèle et le même type de document, la fonction ajoute les éléments au menu existant.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 412
Code
Arguments
menuGroupId, pattern, labelArray, {valueArray}, {iconArray}, {doctypes}, {casesensitive}, {object},
{descriptionArray}, {dismissChars}, {allowWhitespacePrefix}, {restriction}, {type}, {bForcedOnly},
{allowMultipleTimes}, {docURI}
• L'argument menuGroupId est l'attribut ID de l'une des balises menugroup.
• L'argument pattern est l'attribut de modèle de la nouvelle balise menu.
• L'argument labelArray est un tableau de chaînes. Chaque chaîne constitue le texte d'un élément de menu dans le
menu contextuel.
• L'argument facultatif valueArray est un tableau de chaînes qui doit avoir la même longueur que l'argument
labelArray. Lorsqu'un utilisateur sélectionne un élément dans le menu contextuel, la chaîne de ce tableau est
insérée dans son document. Si la chaîne à insérer est toujours identique à celle de l'étiquette du menu, la valeur de
cet argument peut être null.
• L'argument facultatif iconArray
peut être une chaîne ou un tableau de chaînes. S'il s'agit d'une chaîne,
elle spécifie l'URL d'un fichier d'image utilisé par Dreamweaver pour tous les éléments du menu. S'il s'agit d'un
tableau de chaînes, il doit être de la même longueur que l'argument labelArray. Chaque chaîne est une URL
(dossier Configuration de Dreamweaver) désignant un fichier d'image que Dreamweaver utilise comme une icône
pour l'élément de menu correspondant. Si cet argument a la valeur null, Dreamweaver affiche le menu sans les
icônes.
• L'argument facultatif doctypes indique que le menu est actif pour certains types de documents uniquement. Vous
pouvez spécifier l'argument doctypes en tant que liste d'ID de types de documents séparés par des virgules. Pour
obtenir une liste des types de documents de Dreamweaver, consultez le fichier
Configuration/Documenttypes/MMDocumentTypes.xml.
• L'argument facultatif casesensitive indique si le modèle fait la distinction entre les majuscules et les minuscules.
Les valeurs possibles de l'argument casesensitive sont les valeurs booléennes true ou false. Par défaut, la
valeur est false si vous omettez cet argument. Si l'argument casesensitive a la valeur true, le menu des
indicateurs de code s'affiche. Ce menu ne s'affiche que si le texte tapé par l'utilisateur correspond au modèle spécifié
par l'attribut de modèle. Dans le cas où l'argument casesensitive aurait la valeur false, le menu s'affiche, même
si le modèle est en minuscules et que le texte est enmajuscules.
• L'argument object spécifie le nom de la chaîne. Cet argument est facultatif. Il s'emploie si l'objet est de type
statique.
• L'argument descriptionArray donne une description détaillée des éléments figurant dans les indicateurs de code.
Cet argument est facultatif.
• L'argument dismissChars spécifie les caractères non standard que l'utilisateur doit taper pour masquer le menu
des indicateurs de code. Cet argument est facultatif.
• L'argument allowWhitespacePrefix est une valeur booléenne qui autorise les blancs avant l'indicateur. Cet
argument est facultatif ; sa valeur par défaut est false.
• L'argument restriction est une chaîne. Cet argument est facultatif et n'est pas spécifié s'il n'impose aucune
contrainte. Sur une page Web contenant des langages côté client et côté serveur, vous pouvez utiliser cet argument
pour limiter l'emploi d'indicateurs de code à l'un des éléments suivants :
• Une section de langage spécifique
• Un bloc de code
• L'argument type sert à définir les types de menus d'interface utilisateur. Cet argument est facultatif ; sa valeur par
défaut est "Enumerated drop down UI". Les autres valeurs possibles sont color, font et url.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 413
Code
• L'argument bForcedOnly est une valeur booléenne. S'il a la valeur true, le menu des indicateurs de code ne
s'affiche qu'en cas d'utilisation du raccourci clavier (CTRL+espace). Cet argument est facultatif ; sa valeur par
défaut est false.
• L'argument allowMultipleTimes est une valeur booléenne. S'il a la valeur true, il autorise le même menu à
s'afficher à plusieurs reprises. Cet argument est facultatif ; sa valeur par défaut est false.
• L'argument docURI permet à l'utilisateur de limiter les indicateurs de code à un document spécifique en fournissant
l'URI (chemin d'accès au fichier natif du SE) de ce document. Cet argument est facultatif et, si l'URI du document
n'est pas spécifié, il n'impose aucune contrainte.
Valeurs renvoyées
Aucune.
Exemple
Si l'utilisateur crée un jeu d'enregistrements appelé "myRs", le code suivant crée un menu pour myRS :
dw.codeHints.addMenu(
"CodeHints_object_methods",
"myRS.",
new Array("firstName", "lastName"),
new Array("firstName", "lastName"),
null,
"ASP_VB, ASP_JS");
//
//
//
//
//
menu is enabled if object methods are enabled
pop up menu if user types "myRS."
items in pop-up menu for myRS
text to actually insert in document
no icons for this menu
// specific to the ASP doc types
dreamweaver.codeHints.addFunction()
Disponibilité
Dreamweaver MX.
Description
Définit dynamiquement une nouvelle balise function. Si une balise function est définie par le même modèle et le
même type de document, cette fonction remplace la balise function existante.
Arguments
menuGroupId, pattern, {doctypes}, {casesensitive}, {object}, {description}, {icon}, source, {docURI},
{bClassPattern}, {bAddToObjectMethodList}, {restriction}
• L'argument menuGroupId est l'attribut de chaîne d'ID de la balise menugroup.
• L'argument pattern est une chaîne qui spécifie l'attribut de modèle de la nouvelle balise function.
• L'argument facultatif doctypes définit que cette fonction est active pour certains types de documents uniquement.
Vous pouvez spécifier l'argument doctypes en tant que liste d'ID de types de documents séparés par des virgules.
Pour obtenir une liste des types de documents de Dreamweaver, consultez le fichier
Configuration/Documenttypes/MMDocumentTypes.xml.
• L'argument facultatif casesensitive indique si le modèle fait la distinction entre les majuscules et les minuscules.
Les valeurs possibles de l'argument casesensitive sont les valeurs booléennes true ou false. Par défaut, la
valeur est false si vous omettez cet argument. Si l'argument casesensitive a la valeur true, le menu des
indicateurs de code s'affiche. Ce menu ne s'affiche que si le texte tapé par l'utilisateur correspond au modèle spécifié
par l'attribut de modèle. Si l'argument casesensitive est false, le menu s'affiche même si le modèle est en
minuscules et le texte en majuscules.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 414
Code
• L'argument object spécifie le nom de la chaîne. Cet argument est facultatif. Il s'emploie si l'objet est de type
statique.
• L'argument description contient une description détaillée de la fonction. Cet argument est facultatif.
• L'argument icon définit le chemin d'accès à une icône personnalisée à utiliser dans le menu déroulant de la
fonction. Cet argument est facultatif.
• L'argument source contient une valeur affichée dans la seconde colonne de l'indicateur de code. La valeur par
défaut de cet argument est empty.
• L'argument docURI permet à l'utilisateur de limiter les indicateurs de code à un document spécifique en fournissant
l'URI (chemin d'accès au fichier natif du SE) de ce document. Cet argument est facultatif et, si l'URI du document
n'est pas spécifié, il n'impose aucune contrainte.
• L'argument bClassPattern est une valeur booléenne. S'il a la valeur true, il spécifie que la fonction appartient à
une instance de « class » et qu'il n'est pas statique. La valeur par défaut est false. Cet argument est facultatif.
• L'argument bAddToObjectMethodList est une valeur booléenne. S'il a la valeur « true », il permet à l'utilisateur
d'ajouter une liste de fonctions statiques. La valeur par défaut est true. Cet argument est facultatif.
• L'argument restriction est une chaîne. Cet argument est facultatif et n'est pas spécifié s'il n'impose aucune
contrainte. Sur une page Web contenant des langages côté client et côté serveur, vous pouvez utiliser cet argument
pour limiter l'emploi d'indicateurs de code à l'un des éléments suivants :
• Une section de langage spécifique
• Un bloc de code
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant de la fonction dw.codeHints.addFunction() ajoute le modèle de nom de fonction
out.newLine() au groupe de menu d'indicateurs de code CodeHints_Object_Methods et l'active uniquement pour
les documents de type JSP :
dw.codeHints.addFunction(
"CodeHints_Object_Methods",
"out.newLine()",
"JSP")
dreamweaver.codeHints.resetMenu()
Disponibilité
Dreamweaver MX.
Description
Réinitialise la balise de menu ou de fonction spécifiée à l'état dans lequel elle se trouvait juste après la lecture du fichier
CodeHints.xml par Dreamweaver. En d'autres termes, l'appel de cette fonction annule l'effet des appels précédents des
fonctions addMenu() et addFunction().
RÉFÉRENCE DES API DE DREAMWEAVER CS4 415
Code
Arguments
menuGroupId, pattern, {doctypes}
• L'argument menuGroupId est l'attribut de chaîne d'ID d'une balise menugroup.
• L'argument pattern est une chaîne qui spécifie l'attribut de modèle de la nouvelle balise menu ou function à
réinitialiser.
• L'argument facultatif doctypes indique que le menu est actif pour certains types de documents uniquement. Vous
pouvez spécifier l'argument doctypes en tant que liste d'ID de types de documents séparés par des virgules. Pour
obtenir une liste des types de documents de Dreamweaver, consultez le fichier
Configuration/Documenttypes/MMDocumentTypes.xml.
Valeurs renvoyées
Aucune.
Exemple
Votre code JavaScript peut créer un menu Indicateurs de code qui contient toutes les variables de session définies par
l'utilisateur. Dès que la liste des variables de session est modifiée, ce code met le menu à jour. Avant de charger la
nouvelle liste de variables de session dans le menu, le code doit supprimer l'ancienne liste. L'appel de cette fonction
supprime les anciennes variables de session.
dreamweaver.codeHints.showCodeHints()
Disponibilité
Dreamweaver MX.
Description
Dreamweaver appelle cette fonction lorsque l'utilisateur ouvre l'élément de menu Edition > Afficher les indicateurs de
code. La fonction ouvre le menu Indicateurs de code à l'emplacement de la sélection en mode Code.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Exemple
L'exemple suivant ouvre le menu d'indicateurs de code au niveau du point d'insertion dans le document en mode Code.
dw.codeHints.showCodeHints()
dreamweaver.reloadCodeColoring()
Description
Recharge les fichiers de coloration de code dans le dossier Configuration/Code Coloring de Dreamweaver.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 416
Code
Valeurs renvoyées
Aucune.
Exemple
dreamweaver.reloadCodeColoring()
Fonctions relatives à la recherche et au remplacement
Comme leur nom l'indique, ces fonctions permettent d'effectuer des recherches et des remplacements. Elles vont de la
simple recherche de l'instance suivante d'une chaîne donnée à des opérations plus complexes de remplacement
automatique.
dreamweaver.findNext()
Disponibilité
Dreamweaver 3 ; modifié dans Dreamweaver MX 2004.
Description
Recherche l'instance suivante de la chaîne de recherche précédemment définie par « dreamweaver.setUpFind() » à la
page 419, par « dreamweaver.setUpComplexFind() » à la page 417 ou par l'utilisateur (à l'aide de la boîte de dialogue
Rechercher), puis la sélectionne dans le document.
Arguments
{bUseLastSetupSearch}
• L'argument facultatif bUseLastSetupSearch est une valeur booléenne. Si bUseLastSetupSearch a la valeur true
(valeur par défaut si aucun argument n'est fourni), la fonction recherche l'occurrence suivante selon les paramètres
définis lors de l'appel précédent à la fonction dreamweaver.setupComplexFind() ou à la fonction
dreamweaver.setupComplexFindReplace(). Si vous définissez bUseLastSetupSearch sur la valeur false, la
fonction ignore la recherche précédente et recherche l'instance suivante du texte sélectionné dans le document.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canFindNext() » à la page 476.
dreamweaver.replace()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 417
Code
Description
Vérifie que la sélection actuelle correspond aux critères de recherche spécifiés par
« dreamweaver.setUpFindReplace() » à la page 419, par « dreamweaver.setUpComplexFindReplace() » à la page 418
ou par l'utilisateur dans la boîte de dialogue Remplacer ; la fonction remplace ensuite la sélection par le texte de
substitution spécifié dans la demande de recherche.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.replaceAll()
Disponibilité
Dreamweaver 3.
Description
Remplace chaque section du document actif correspondant aux critères de recherche précédemment définis par la
fonction « dreamweaver.setUpFindReplace() » à la page 419 ou « dreamweaver.setUpComplexFindReplace() » à la
page 418 ou par l'utilisateur (dans la boîte de dialogue Remplacer) par le contenu de remplacement spécifié.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.setUpComplexFind()
Disponibilité
Dreamweaver 3.
Description
Prépare le terrain pour une recherche avancée de texte ou de balises en chargeant la requête XML spécifiée.
Arguments
xmlQueryString
• L'argument xmlQueryString est une chaîne de code XML commençant par dwquery et se terminant par /dwquery.
Pour obtenir une chaîne formatée correctement, vous pouvez définir la requête à l'aide de la boîte de dialogue
Rechercher, cliquer sur le bouton Enregistrer la requête, ouvrir ce fichier de requête dans un éditeur de texte et
copier tout ce qui est compris entre le début de la balise dwquery et la fin de la balise /dwquery.
Remarque : Dans une requête, certains caractères spéciaux, tels que la barre oblique inverse (\), doivent être ignorés.
Par conséquent, pour utiliser une barre oblique inverse dans une requête, vous devez écrire \\.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 418
Code
Valeurs renvoyées
Aucune.
Exemple
Dans l'exemple ci-après, la première ligne de code définit une recherche de balise et précise que la recherche doit porter
sur le document actif ; la deuxième ligne exécute la recherche.
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()
Disponibilité
Dreamweaver 3.
Description
Prépare le terrain pour une recherche avancée de texte ou de balises en chargeant la requête XML spécifiée.
Arguments
xmlQueryString
• L'argument xmlQueryString est une chaîne du codeXML qui commence par la balise dwquery et se termine par la
balise /dwquery. Pour obtenir une chaîne ayant formatée correctement, vous pouvez définir la requête à l'aide de
la boîte de dialogue Rechercher, cliquer sur le bouton Enregistrer la requête, ouvrir ce fichier de requête dans un
éditeur de texte et copier tout ce qui est compris entre le début de la balise dwquery et la fin de la balise /dwquery.
Remarque : Dans une requête, certains caractères spéciaux, tels que la barre oblique inverse (\), doivent être ignorés.
Par conséquent, pour utiliser une barre oblique inverse dans une requête, vous devez écrire \\.
Valeurs renvoyées
Aucune.
Exemple
Dans l'exemple ci-après, la première ligne de code définit une recherche de balise et précise que la recherche doit porter
sur quatre fichiers ; la deuxième ligne exécute la recherche et le remplacement.
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();
RÉFÉRENCE DES API DE DREAMWEAVER CS4 419
Code
dreamweaver.setUpFind()
Disponibilité
Dreamweaver 3.
Description
Prépare le terrain pour l'exécution d'une recherche de texte ou de code source HTML en définissant les critères de
recherche de l'opération dreamweaver.findNext() qui va suivre.
Arguments
searchObject
L'argument searchObject est un objet pour lequel les propriétés suivantes peuvent être définies :
• La propriété searchString est le texte à rechercher.
• La propriété searchSource est une valeur booléenne indiquant si la recherche doit également porter sur le code
sourceHTML.
• La propriété facultative {matchCase} est une valeur booléenne indiquant si la recherche doit respecter les
majuscules et les minuscules. Si cette propriété n'est pas définie, elle prend par défaut la valeur false.
• La propriété facultative {ignoreWhitespace} est une valeur booléenne indiquant si les différences entre les espaces
blancs doivent être ignorées. La propriétés ignoreWhitespace prend sa valeur par défaut, false, si la valeur de la
propriété useRegularExpressions est true, et true si la valeur de la propriété useRegularExpressions est false.
• La propriété {useRegularExpressions} est une valeur booléenne indiquant que la propriété searchString utilise des
expressions régulières. Si cette propriété n'est pas définie, elle prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
Exemple
L'exemple de code suivant montre comment créer un objet searchObject de trois façons différentes :
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()
Disponibilité
Dreamweaver 3.
Description
Prépare une recherche de texte ou de code source HTML en définissant les critères de recherche et le cadre
d'application de l'opération dreamweaver.replace()dreamweaver.replaceAll() qui va suivre.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 420
Code
Arguments
searchObject
L'argument searchObject est un objet pour lequel les propriétés suivantes peuvent être définies :
• La propriété searchString est le texte à rechercher.
• La propriété replaceString est le texte à substituer au texte recherché.
• La propriété searchSource est une valeur booléenne indiquant si la recherche doit également porter sur le code
sourceHTML.
• La propriété facultative {matchCase} est une valeur booléenne indiquant si la recherche doit respecter les
majuscules et les minuscules. Si cette propriété n'est pas définie, elle prend par défaut la valeur false.
• La propriété facultative {ignoreWhitespace} est une valeur booléenne indiquant si les différences entre les espaces
blancs doivent être ignorées. La propriété ignoreWhitespace prend la valeur false si la propriété
useRegularExpressions a la valeur true et prend la valeur true si l'expression useRegularExpressions a la valeur
false.
• La propriété {useRegularExpressions} est une valeur booléenne indiquant que la propriété searchString utilise des
expressions régulières. Si cette propriété n'est pas définie, elle prend par défaut la valeur false.
Valeurs renvoyées
Aucune.
Exemple
L'exemple de code suivant montre comment créer un objet searchObject de trois façons différentes :
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()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Rechercher.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 421
Code
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canShowFindDialog() » à la page 481.
dreamweaver.showFindReplaceDialog()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Remplacer.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canShowFindDialog() » à la page 481.
Fonctions de modifications générales
Ces fonctions s'utilisent depuis la fenêtre de document. Elles permettent d'insérer du texte, du code HTML et des
objets, d'appliquer, de modifier et de supprimer des marqueurs de police et de caractère, de modifier des balises et des
attributs, etc.
dom.applyCharacterMarkup()
Disponibilité
Dreamweaver 3.
Description
Applique à la sélection le type de marqueur de caractère spécifié. Si la sélection est un point d'insertion, la fonction
applique les marqueurs de caractère spécifiés au texte saisi après le point d'insertion.
Arguments
tagName
• L'argument tagName est le nom de la balise associé au marqueur de caractère. Il doit s'agir d'une des chaînes
suivantes : "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".
RÉFÉRENCE DES API DE DREAMWEAVER CS4 422
Code
Valeurs renvoyées
Aucune.
dom.applyFontMarkup()
Disponibilité
Dreamweaver 3.
Description
Applique à la sélection en cours la balise FONT, ainsi que l'attribut spécifié et sa valeur.
Arguments
attribute, value
• L'argument attribute doit être "face", "size" ou "color".
• L'argument value est la valeur à affecter à l'attribut, comme "Arial, Helvetica, sans-serif", "5" ou "#FF0000".
Valeurs renvoyées
Aucune.
dom.deleteSelection()
Disponibilité
Dreamweaver 3.
Description
Supprime la sélection du document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.editAttribute()
Disponibilité
Dreamweaver 3.
Description
Affiche l'interface permettant de modifier l'attribut de document spécifié. Dans la plupart des cas, il s'agit d'une boîte
de dialogue. Cette fonction n'est valide que pour le document actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 423
Code
Arguments
attribute
• attribute est une chaîne qui spécifie l'attribut de balise à modifier.
Valeurs renvoyées
Aucune.
dom.exitBlock()
Disponibilité
Dreamweaver 3.
Description
Quitte le bloc de paragraphe ou d'en-tête en cours et place le point d'insertion à l'extérieur de tous les éléments de bloc.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.getCharSet()
Disponibilité
Dreamweaver 4.
Description
Renvoie l'attribut charset dans la balise Meta du document.
Arguments
Aucun.
Valeurs renvoyées
L'identité de codage du document. Par exemple, pour un document Latin1, la fonction renvoie iso-8859-1.
dom.getFontMarkup()
Disponibilité
Dreamweaver 3.
Description
Obtient la valeur de l'attribut spécifié de la balise FONT pour la sélection en cours.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 424
Code
Arguments
attribute
• L'argument attribute doit être "face", "size" ou "color".
Valeurs renvoyées
Soit une chaîne contenant la valeur de l'attribut spécifié, soit une chaîne vide si l'attribut n'est pasdéfini.
dom.getLineFromOffset()
Disponibilité
Dreamweaver MX.
Description
Trouve le numéro de ligne d'un décalage de caractère précis dans le texte (le code HTML ou JavaScript) du fichier.
Arguments
offset
• L'argument offset est un nombre entier qui représente l'emplacement du caractère à partir du début du fichier.
Valeurs renvoyées
Nombre entier qui représente le numéro de la ligne dans le document.
dom.getLinkHref()
Disponibilité
Dreamweaver 3.
Description
Obtient le lien qui entoure la sélection en cours. Revient à effectuer une boucle sur les parents et les grands-parents du
nœud en cours jusqu'à ce qu'un lien soit rencontré, puis à appeler la fonction getAttribute('HREF') sur ce lien.
Arguments
Aucun.
Valeurs renvoyées
Chaîne qui contient le nom du fichier lié, exprimé sous la forme d'une URL de type file://.
dom.getLinkTarget()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 425
Code
Description
Obtient la cible du lien qui entoure la sélection en cours. Revient à effectuer une boucle sur les parents et les grandsparents du nœud en cours jusqu'à ce qu'un lien soit rencontré, puis à appeler la fonction getAttribute('TARGET')
sur ce lien.
Arguments
Aucun.
Valeurs renvoyées
Soit une chaîne contenant la valeur de l'attribut TARGET spécifié pour le lien, soit une chaîne vide si aucune cible n'est
définie.
dom.getListTag()
Disponibilité
Dreamweaver 3.
Description
Obtient le style de la liste sélectionnée.
Arguments
Aucun.
Valeurs renvoyées
Soit une chaîne contenant la balise associée à la liste ("ul", "ol" ou "dl"), soit une chaîne vide si aucune balise n'est
associée à la liste. Cette valeur est toujours renvoyée en minuscules.
dom.getTextAlignment()
Disponibilité
Dreamweaver 3.
Description
Obtient l'alignement du bloc contenant la sélection.
Arguments
Aucun.
Valeurs renvoyées
Soit une chaîne contenant la valeur de l'attribut ALIGN de la balise associée au bloc, soit une chaîne vide si l'attribut
ALIGN n'est pas défini. Cette valeur est toujours renvoyée en minuscules.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 426
Code
dom.getTextFormat()
Disponibilité
Dreamweaver 3.
Description
Obtient le format du bloc contenant la sélection.
Arguments
Aucun.
Valeurs renvoyées
Soit une chaîne contenant la balise de bloc associée au texte (comme "p", "h1", "pre", etc.), soit une chaîne vide si
aucune balise de bloc n'est associée à la sélection. Cette valeur est toujours renvoyée en minuscules.
dom.hasCharacterMarkup()
Disponibilité
Dreamweaver 3.
Description
Vérifie si le marqueur de caractère spécifié est déjà associé à la sélection.
Arguments
markupTagName
• L'argument markupTagName est le nom de la balise à vérifier. Il doit s'agir d'une des chaînes suivantes : "b",
"cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".
Valeurs renvoyées
Valeur booléenne qui indique si le marqueur de caractère spécifié est associé à la sélection entière. Cette fonction
renvoie la valeur false si le marqueur spécifié n'est associé qu'à une partie de la sélection.
dom.indent()
Disponibilité
Dreamweaver 3.
Description
Applique un retrait à la sélection à l'aide des balises BLOCKQUOTE. Si la sélection est un élément de liste, cette fonction
lui applique un retrait en convertissant l'élément sélectionné en liste imbriquée. La liste imbriquée est du même type
que la liste externe et contient un seul élément (la sélection d'origine).
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 427
Code
Valeurs renvoyées
Aucune.
dom.insertHTML()
Disponibilité
Dreamweaver 3.
Description
Insère un contenu HTML dans le document, au niveau du point d'insertion en cours.
Arguments
contentToInsert, {bReplaceCurrentSelection}
• L'argument contentToInsert est le contenu à insérer.
• L'argument facultatif bReplaceCurrentSelection est une valeur booléenne qui indique si le contenu spécifié doit
remplacer la sélection en cours. Si la valeur de l'argument bReplaceCurrentSelection est true, le contenu remplace
la sélection actuelle. Si sa valeur est false, le contenu est inséré après la sélection actuelle.
Valeurs renvoyées
Aucune.
Exemple
Le code suivant insère la chaîne HTML <b>130</b> dans le document actuel :
var theDOM = dw.getDocumentDOM();
theDOM.insertHTML('<b>130</b>');
Le résultat s'affiche dans la fenêtre de document.
dom.insertObject()
Disponibilité
Dreamweaver 3.
Description
Insère l'objet spécifié et invite l'utilisateur à définir des paramètres, le cas échéant.
Arguments
objectName
• L'argument objectName est le nom d'un objet dans le dossier Configuration/Objects.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 428
Code
Exemple
Un appel à la fonction dom.insertObject('Button') insère un bouton de formulaire dans le document actif, après
la sélection en cours. Si aucun élément n'est sélectionné, cette fonction insère le bouton au niveau du point d'insertion
en cours.
Remarque : Même si les fichiers d'objets peuvent être conservés dans des dossiers séparés, le nom de chaque fichier doit
impérativement être unique. En effet, si le dossier Forms et le dossier MyObjects contiennent chacun un fichier nommé
Button.htm, par exemple, Dreamweaver n'est pas capable de faire la différence entre les deux.
dom.insertText()
Disponibilité
Dreamweaver 3.
Description
Insère un contenu dans le document, au niveau du point d'insertion en cours.
Arguments
contentToInsert, {bReplaceCurrentSelection}
• L'argument contentToInsert est le contenu à insérer.
• L'argument facultatif bReplaceCurrentSelection est une valeur booléenne qui indique si le contenu spécifié doit
remplacer la sélection en cours. Si la valeur de l'argument bReplaceCurrentSelection est true, le contenu remplace
la sélection actuelle. Si sa valeur est false, le contenu est inséré après la sélection actuelle.
Valeurs renvoyées
Aucune.
Exemple
Le code suivant insères le texte <b>130</b> dans le document actuel :
var theDOM = dreamweaver.getDocumentDOM();
theDOM.insertText('<b>130</b>');
Les résultats s'affichent dans la fenêtre de document.
dom.newBlock()
Disponibilité
Dreamweaver 3.
Description
Crée un bloc doté de la même balise et des mêmes attributs que le bloc contenant la sélection en cours ou, si le pointeur
se trouve à l'extérieur de tous les blocs, crée un paragraphe.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 429
Code
Valeurs renvoyées
Aucune.
Exemple
Si la sélection en cours se trouve à l'intérieur d'un paragraphe centré, un appel à la fonction dom.newBlock() insère
<p align="center"> après le paragraphe en cours.
dom.notifyFlashObjectChanged()
Disponibilité
Dreamweaver 4.
Description
Indique à Dreamweaver que le fichier Flash en cours a été modifié. Dreamweaver met à jour la fenêtre d'aperçu en la
redimensionnant, le cas échéant, et en veillant à conserver le rapport hauteur/largeur d'origine.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.outdent()
Disponibilité
Dreamweaver 3.
Description
Applique un retrait négatif à la sélection.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.removeCharacterMarkup()
Disponibilité
Dreamweaver 3.
Description
Supprime de la sélection le type de marqueur de caractère spécifié.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 430
Code
Arguments
tagName
• L'argument tagName est le nom de la balise associé au marqueur de caractère. Il doit s'agir d'une des chaînes
suivantes : "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".
Valeurs renvoyées
Aucune.
dom.removeFontMarkup()
Disponibilité
Dreamweaver 3.
Description
Supprime d'une balise FONT l'attribut spécifié, ainsi que sa valeur. Si, après suppression de l'attribut, il ne reste que la
balise FONT, la balise FONT est également supprimée.
Arguments
attribute
• L'argument attribute doit être "face", "size" ou "color".
Valeurs renvoyées
Aucune.
dom.resizeSelection()
Disponibilité
Dreamweaver 3.
Description
Redimensionne l'objet sélectionné et lui applique les nouvelles dimensions spécifiées.
Arguments
newWidth, newHeight
• L'argument newWidth spécifie la nouvelle largeur définie pour l'objetsélectionné par la fonction.
• L'argument newHeight spécifie la nouvelle hauteur définie pour l'objetsélectionné par la fonction.
Valeurs renvoyées
Aucune.
dom.setAttributeWithErrorChecking()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 431
Code
Description
Définit l'attribut spécifié sur la valeur indiquée pour la sélection en cours et affiche une invite utilisateursile type de
valeur est incorrect ou si la valeur n'est pas comprise dans la plage spécifiée. Cette fonction n'est valide que pour le
document actif.
Arguments
attribute, value
• L'argument attribute spécifie l'attribut à définir pour la sélection actuelle.
• L'argument value spécifie la valeur à définir pour l'attribut.
Valeurs renvoyées
Aucune.
dom.setLinkHref()
Disponibilité
Dreamweaver 3.
Description
Transforme la sélection en lien hypertexte ou modifie la valeur de l'URL pour la balise HREF qui entoure la sélection
en cours.
Arguments
linkHREF
• L'argument linkHREF est une URL (chemin relatif au document ou à la racine, ou URL absolue) contenant le lien.
Si aucun argument n'est défini, la boîte de dialogue Sélectionner fichier HTMLs'affiche.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canSetLinkHref() » à la page 471.
dom.getLinkTarget()
Disponibilité
Dreamweaver 3.
Description
Définit la cible du lien qui entoure la sélection en cours. Revient à effectuer une boucle sur les parents et les grandsparents du nœud en cours jusqu'à ce qu'un lien soit rencontré, puis à appeler la fonction setAttribute('TARGET')
sur ce lien.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 432
Code
Arguments
{linkTarget}
• L'argument linkTarget est une chaîne qui représente le nom d'un cadre ou d'une fenêtre, ou l'une des cibles réservées
("_self", "_parent", "_top" ou "_blank"). Si aucun argument n'est défini, la boîte de dialogue Définir la cible
s'affiche.
Valeurs renvoyées
Aucune.
dom.setListBoxKind()
Disponibilité
Dreamweaver 3.
Description
Modifie le type du menu SELECT sélectionné.
Arguments
kind
• L'argument kind doit être "menu" ou "list
box".
Valeurs renvoyées
Aucune.
dom.showListPropertiesDialog()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Propriétés de la liste.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dom.canShowListPropertiesDialog() » à la page 471.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 433
Code
dom.setListTag()
Disponibilité
Dreamweaver 3.
Description
Définit le style de la liste sélectionnée.
Arguments
listTag
• L'argument listTag est la balise associée à la liste. Il doit s'agir de "ol", "ul", "dl" ou d'une chaîne vide.
Valeurs renvoyées
Aucune.
dom.setTextAlignment()
Disponibilité
Dreamweaver 3.
Description
Affecte la valeur spécifiée à l'attribut ALIGN du bloc contenant la sélection.
Arguments
alignValue
• L'argument alignValue doit être "left", "center" ou "right".
Valeurs renvoyées
Aucune.
dom.setTextFieldKind()
Disponibilité
Dreamweaver 3.
Description
Définit le format du champ de texte sélectionné.
Arguments
fieldType
• L'argument fieldType doit être "input", "textarea" ou "password".
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 434
Code
dom.setTextFormat()
Disponibilité
Dreamweaver 4.
Description
Définit le format de bloc du texte sélectionné.
Arguments
blockFormat
• L'argument blockFormat est une chaîne qui spécifie l'un des formats suivants : "" (for no format), "p", "h1", "h2",
"h3", "h4", "h5", "h6" ou "pre".
Valeurs renvoyées
Aucune.
dom.showFontColorDialog()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue du sélecteur de couleur.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.deleteSelection()
Disponibilité
Dreamweaver 3.
Description
Supprime la sélection du document actif, du panneau Site ou, sur Macintosh, il supprime la zone de texte active dans
une boîte de dialogue ou un panneau flottant.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 435
Code
Activateur
Voir « dreamweaver.canDeleteSelection() » à la page 475.
dreamweaver.editFontList()
Disponibilité
Dreamweaver 3.
Description
Ouvre la boîte de dialogue Modifier la liste des polices.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.getFontList()
Disponibilité
Dreamweaver 3.
Description
Obtient la liste de tous les groupes de polices apparaissant dans l'inspecteur Propriétés de texte et la boîte de dialogue
Définition du style.
Arguments
Aucun.
Valeurs renvoyées
Tableau de chaînes dont chaque chaîne représente un élément de la liste des polices.
Exemple
Si vous avez effectué une installation par défaut de Dreamweaver, un appel à la fonction
dreamweaver.getFontList() renvoie un tableau contenant les éléments suivants :
•
"Arial, Helvetica, sans-serif"
•
"Times New Roman, Times, serif"
•
"Courier New, Courier, mono"
•
"Georgia, Times New Roman, Times, serif"
•
"Verdana, Arial, Helvetica, sans-serif"
RÉFÉRENCE DES API DE DREAMWEAVER CS4 436
Code
dreamweaver.getFontStyles()
Disponibilité
Dreamweaver 4.
Description
Renvoie les styles pris en charge par la police TrueType spécifiée.
Arguments
fontName
• L'argument fontName est une chaîne contenant le nom de la police.
Valeurs renvoyées
Tableau de trois valeurs booléennes qui indique les styles pris en charge par la police. La première valeur indique si la
police prend en charge le style Gras, la deuxième le style Italique et la troisième les styles Gras et Italique.
dreamweaver.getKeyState()
Disponibilité
Dreamweaver 3.
Description
Détermine si la touche de modification spécifiée est enfoncée.
Arguments
key
• L'argument key doit avoir l'une des valeurs suivantes : "Cmd", "Ctrl", "Alt" ou "Shift". Sous Windows, "Cmd"
et "Ctrl" désignent la touche Contrôle ; sur Macintosh, "Alt" désigne la touche Option.
Valeurs renvoyées
Valeur booléenne qui indique si la touche est enfoncée.
Exemple
Le code suivant vérifie si les touches Maj et Ctrl (Windows) ou Maj et Commande (Macintosh) sont enfoncées avant
d'effectuer une opération.
if (dw.getKeyState("Shift") && dw.getKeyState("Cmd")){
// execute code
}
dreamweaver.getNaturalSize()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 437
Code
Description
Renvoie la largeur et la hauteur d'un objet graphique.
Arguments
url
• L'argument url pointe vers un objet graphique dont les dimensions sont requises. Dreamweaver doit prendre en
charge cet objet (GIF, JPEG, PNG, Flash ou Shockwave). L'URL fournie comme argument de la fonction
getNaturalSize() doit correspondre à une URL absolue pointant vers un fichier local ; il ne peut pas s'agir d'une
URL relative.
Valeurs renvoyées
Tableau contenant deux nombres entiers, le premier définissant la largeur de l'objet et le second sa hauteur.
dreamweaver.getSystemFontList()
Disponibilité
Dreamweaver 4.
Description
Renvoie une liste de polices à utiliser pour le système. Cette fonction peut appeler toutes les polices ou uniquement les
polices TrueType.
Arguments
fontTypes
• L'argument fontTypes est une chaîne qui contient soit all, soit TrueType.
Valeurs renvoyées
Tableau de chaînes qui contient le nom de toutes les polices ; renvoie la valeur null si aucune police n'est trouvée.
Fonction relative à l'impression
Cette fonction permet à l'utilisateur d'imprimer le code depuis le mode Code.
dreamweaver.printCode()
Disponibilité
Dreamweaver MX.
Description
Sous Windows, cette fonction imprime toutes les portions de code ou seulement une sélection de code depuis le mode
Code. Sur Macintosh, elle imprime toutes les portions de code ou seulement une plage de pages de code.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 438
Code
Arguments
showPrintDialog, document
• L'argument showPrintDialog est true ou false. Sous Windows, si cet argument a pour valeur true, la fonction
dreamweaver.PrintCode() affiche la boîte de dialogue d'impression pour demander à l'utilisateur s'il souhaite
imprimer tout le texte ou seulement une sélection de texte. Sur Macintosh, la fonction dreamweaver.PrintCode()
affiche la boîte de dialogue d'impression pour demander à l'utilisateur s'il souhaite imprimer tout le texte ou
seulement une plage de pages.
Si l'argument a pour valeur false, dreamweaver.PrintCode() utilise la sélection précédente de l'utilisateur. La
valeur par défaut est true.
• L'argument document est le DOM du document à imprimer. Pour plus d'informations sur la façon d'obtenir le
DOM d'un document, voir « dreamweaver.getDocumentDOM() » à la page 254.
Valeurs renvoyées
Valeur booléenne, true si l'impression du code est possible, false dans le cas contraire.
Exemple
L'exemple suivant appelle dw.PrintCode() pour lancer la boîte de dialogue d'impression pour le document
utilisateur. Si la fonction renvoie la valeur false, le code affiche un message d'alerte informant l'utilisateur qu'il n'est
pas possible d'exécuter la demande d'impression.
var theDOM = dreamweaver.getDocumentDOM("document");
if(!dreamweaver.PrintCode(true, theDOM))
{
alert("Unable to execute your print request!");
}
Fonctions relatives à Quick Tag Editor
Ces fonctions permettent de se déplacer d'une balise à l'autre à l'intérieur et autour de la sélection en cours. Elles
permettent de supprimer n'importe laquelle de ces balises, d'envelopper la sélection à l'intérieur d'une nouvelle balise
et d'afficher Quick Tag Editor pour permettre à l'utilisateur de modifier certains attributs d'une balise.
dom.selectChild()
Disponibilité
Dreamweaver 3.
Description
Sélectionne un enfant de la sélection en cours. Revient à sélectionner la balise située immédiatement à droite dans le
sélecteur de balises, en bas de la fenêtre de document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 439
Code
dom.selectParent()
Disponibilité
Dreamweaver 3.
Description
Sélectionne le parent de la sélection en cours. Revient à sélectionner la balise située immédiatement à gauche dans le
sélecteur de balises, en bas de la fenêtre de document.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.stripTag()
Disponibilité
Dreamweaver 3.
Description
Supprime les balises qui entourent la sélection actuelle, laissant intact leur contenu. Si la sélection contient plusieurs
balises ou n'en contient aucune, Dreamweaver affiche un message d'erreur.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.wrapTag()
Disponibilité
Dreamweaver 3.
Description
Place la balise spécifiée autour de la sélection en cours. Si la balise n'est pas complète, Dreamweaver affiche un message
d'erreur.
Arguments
startTag, {bAlwaysBalance}, {bMakeLegal}
• L'argument startTag est la source associée à la balise d'ouverture.
• L'argument bAlwaysBalance est une valeur booléenne qui indique si la sélection doit être équilibrée avant d'être
enveloppée. Cet argument est facultatif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 440
Code
• L'argument bMakeLegal est une valeur booléenne qui indique s'il faut vérifier que l'enveloppement produit du code
HTML valide. Cet argument est facultatif.
Valeurs renvoyées
Aucune.
Exemple
Le code suivant place un lien autour de la sélection en cours.
var theDOM = dw.getDocumentDOM();
var theSel = theDOM.getSelectedNode();
if (theSel.nodeType == Node.TEXT_NODE){
theDOM.wrapTag('<a href="foo.html">');
}
dreamweaver.showQuickTagEditor()
Disponibilité
Dreamweaver 3.
Description
Affiche Quick Tag Editor pour la sélection en cours.
Arguments
{nearWhat}, {mode}
• L'argument facultatif nearWhat doit, s'il est spécifié, être "selection" ou "tag
selector". Si cet argument n'est
pas défini, il prend par défaut la valeur "selection".
• L'argument facultatif mode doit, s'il est spécifié, être "default", "wrap", "insert" ou "edit". Si l'argument mode
a pour valeur "default" ou qu'il n'est pas défini, Dreamweaver utilise la méthode heuristique afin de déterminer
le mode à utiliser pour la sélection en cours. Si l'argument nearWhat a pour valeur "tag selector", l'argument mode
est ignoré.
Valeurs renvoyées
Aucune.
Fonctions relatives au mode Code
Ces fonctions incluent les opérations associées à la modification du code source d'un document (et tous les
changements ayant une incidence sur le mode Création). Les fonctions de cette section vous permettent d'ajouter des
commandes de navigation aux modes Code au sein d'une fenêtre de document affichée dans deux volets ou dans la
fenêtre de l'inspecteur de code.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 441
Code
dom.formatRange()
Disponibilité
Dreamweaver MX.
Description
Applique le formatage de syntaxe automatique de Dreamweaver à une plage définie de caractères en mode Code, et ce
conformément aux paramètres de la boîte de dialogue Préférences > Format de code.
Arguments
startOffset, endOffset
• L'argument startOffset est un nombre entier qui représente le début de la plage définie, et ce sous la forme d'un
décalage par rapport au début du document.
• L'argument endOffset est un nombre entier qui représente la fin de la plage définie, et ce sous la forme d'un décalage
par rapport au début du document.
Valeurs renvoyées
Aucune.
dom.formatSelection()
Disponibilité
Dreamweaver MX.
Description
Applique le formatage de syntaxe automatique de Dreamweaver au contenu sélectionné (ce qui revient à utiliser
l'option Commandes > Appliquer le format source à la sélection), conformément aux paramètres de la boîte de
dialogue Préférences > Format de code.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.getShowNoscript()
Disponibilité
Dreamweaver MX.
Description
Obtient l'état actuel de l'option de contenu noscript (depuis l'option de menu Affichage > Contenu Noscript).
Activée par défaut, la balise noscript identifie un script de page pouvant, au choix, être affiché ou non dans le
navigateur.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 442
Code
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le contenu de la balise noscript est actuellement affiché, false dans le cas contraire.
dom.getAutoValidationCount()
Disponibilité
Dreamweaver MX 2004.
Description
Obtient le nombre d'erreurs, d'avertissements et de messages d'information pour la dernière auto-validation (ou
validation en ligne) du document. Actuellement seule une vérification du navigateur cible est effectuée durant l'autovalidation (voir « dom.runValidation() » à la page 263).
Remarque : Cette fonction renvoie uniquement les résultats actuellement affichés dans la fenêtre de résultats du
document. Pour vous assurer que les comptes sont à jour, vous pouvez appeler dom.runValidation() avant
d'appeler cette fonction.
Arguments
Aucun.
Valeurs renvoyées
Objet doté des propriétés suivantes :
• la propriété numError, qui est le nombre d'erreurs ;
• la propriété numWarning, qui est le nombre d'avertissements ;
• la propriété numInfo, qui est le nombre de messages d'information.
Exemple
theDom = dw.getDocumentDOM();
theDom.runValidation();
theDom.getAutoValidationCount();
dom.isDesignViewUpdated()
Disponibilité
Dreamweaver 4.
Description
Détermine si le contenu des modes Création et Texte est synchronisé pour les opérations Dreamweaver qui requièrent
un état de document correct.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 443
Code
Valeurs renvoyées
Valeur booléenne : true si le mode Création (WYSIWIG) est synchronisé avec le texte du mode Texte et false dans
le cas contraire.
dom.isSelectionValid()
Disponibilité
Dreamweaver 4.
Description
Détermine si une sélection est valide, ce qui signifie qu'elle est synchronisée avec le mode Création, ou s'il faut la
déplacer avant qu'une opération n'ait lieu.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection en cours contient un segment de code correct; false si le document n'a pas
encore été synchronisé, étant donné que la sélection n'a pas été mise à jour.
dom.setShowNoscript()
Disponibilité
Dreamweaver MX.
Description
Active ou désactive l'option de contenu noscript (ce qui revient à utiliser l'option Affichage > Contenu Noscript).
Activée par défaut, la balise noscript identifie un script de page pouvant, au choix, être affiché ou non dans le
navigateur.
Arguments
{bShowNoscript}
• L'argument facultatif bShowNoscript est une valeur booléenne qui indique si le contenu de la balise noscript doit
être affiché ; true si le contenu de la balise noscript doit être affiché, false dans le cas contraire.
Valeurs renvoyées
Aucune.
dom.source.arrowDown()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 444
Code
Description
Déplace le point d'insertion vers le bas du document affiché en mode Code, ligne par ligne. Si le contenu est déjà
sélectionné, cette fonction étend la sélection ligne par ligne.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de lignes que le point d'insertion doit sauter. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.arrowLeft()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion vers la gauche de la ligne courante dans le mode Code. Si le contenu est déjà sélectionné,
cette fonction étend la sélection vers la gauche.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de caractères que le point d'insertion doit sauter. Si nTimes n'est pas
défini, il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.arrowRight()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion vers la droite de la ligne courante dans le mode Code. Si le contenu est déjà sélectionné,
cette fonction étend la sélection vers la droite.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 445
Code
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de caractères que le point d'insertion doit sauter. Si nTimes n'est pas
défini, il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné ; dans le cas contraire, il ne l'est pas.
Valeurs renvoyées
Aucune.
dom.source.arrowUp()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion vers le haut du document affiché en mode Code, ligne par ligne. Si le contenu est déjà
sélectionné, cette fonction étend la sélection ligne par ligne.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument nTimes est le nombre de lignes que le point d'insertion doit déplacer. Si nTimes n'est pas défini, il prend
par défaut la valeur1.
• L'argument bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si bShiftIsDown a la
valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.balanceBracesTextView()
Disponibilité
Dreamweaver 4.
Description
Cette fonction est une extension du mode Code qui permet d'équilibrer les parenthèses. vous pouvez appeler
dom.source.balancebracestextview() pour étendre une sélection ou un point d'insertion actuellement mis en
surbrillance. L'extension va de l'ouverture de l'instruction entre parenthèses enveloppante à la fin de cette instruction.
Elle sert à équilibrer les caractères suivants : [], {} et (). Tout nouvel appel étend la sélection à des niveaux
supplémentaires de ponctuation imbriquée.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 446
Code
Valeurs renvoyées
Aucune.
dom.source.doCodeNavItem()
Disponibilité
Dreamweaver 4.
Description
Cette fonction charge la fenêtre Navigation dans le code et la remplit à l'aide de cibles pour la sélection actuelle.
Toutefois, elle n'exécute pas en soi de tâches de navigation ni d'ouverture de fichiers apparentés.
Arguments
Aucun
Valeurs renvoyées
Valeur booléenne : true si la fenêtre Navigation dans le code est ouverte, false s'il est impossible de l'ouvrir parce que
la sélection actuelle ne contient pas de cibles de navigation.
dom.source.endOfDocument()
Disponibilité
Dreamweaver 4.
Description
Place le point d'insertion à la fin du document actif affiché en mode Code. Si le contenu est déjà sélectionné, cette
fonction étend la sélection à la fin du document.
Arguments
bShiftIsDown
• L'argument bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si bShiftIsDown a la
valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.endOfLine()
Disponibilité
Dreamweaver 4.
Description
Place le point d'insertion à la fin de la ligne courante. Si le contenu est déjà sélectionné, cette fonction étend la sélection
jusqu'à la fin de la ligne courante.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 447
Code
Arguments
bShiftIsDown
• L'argument bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si bShiftIsDown a la
valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.endPage()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion à la fin de la page en cours ou à la fin de la page suivante (si le point d'insertion est déjà à
la fin d'une page). Si le contenu est déjà sélectionné, cette fonction étend la sélection page par page.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de pages que le point d'insertion doit sauter. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.getCurrentLines()
Disponibilité
Dreamweaver 4.
Description
Renvoie les numéros de ligne des décalages spécifiés à partir du début du document.
Arguments
Aucun.
Valeurs renvoyées
Numéros de ligne de la sélection en cours.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 448
Code
dom.source.getSelection()
Description
Obtient la sélection du document actif, exprimée en décalages de caractères dans le mode Code du document.
Arguments
Aucun.
Valeurs renvoyées
Paire de nombres entiers représentant les décalages à partir du début du document source. Le premier nombre entier
correspond au début de la sélection et le second à la fin. Si les deux nombres sont égaux, la sélection est un point
d'insertion. Si aucun élément n'est sélectionné dans la source, les deux nombres sont -1.
dom.source.getLineFromOffset()
Disponibilité
Dreamweaver MX.
Description
Place un décalage dans le document source.
Arguments
Aucun.
Valeurs renvoyées
Numéro de la ligne, ou -1 si le décalage est négatif ou se trouve après la fin du fichier.
dom.source.getText()
Disponibilité
Dreamweaver 4.
Description
Renvoie la chaîne de texte de la source comprise entre les décalages définis.
Arguments
startOffset, endOffset
• L'argument startOffset est un nombre entier qui représente le décalage à partir du début dudocument.
• L'argument endOffset est un nombre entier qui représente la fin du document.
Valeurs renvoyées
Chaîne qui représente le texte du code source compris entre les décalages start et end.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 449
Code
dom.source.getValidationErrorsForOffset()
Disponibilité
Dreamweaver MX 2004.
Description
Renvoie la liste des erreurs de validation au point de décalage spécifié ou recherche l'erreur suivante après le décalage.
Si aucune n'est trouvée dans la fonction, la valeur null est renvoyée.
Arguments
offset, {searchDirection}
• L'argument offset est un nombre qui spécifie le décalage dans le code pour lequel la fonction renvoie des erreurs.
• L'argument facultatif searchDirection est une chaîne qui spécifie "empty", "forward" ou "back". Si spécifié, la
fonction recherche vers la fin ou le début du document, en partant du décalage défini, les caractères comportant
des erreurs et les renvoie. Si cela n'est pas spécifié, la fonction vérifie la présence d'erreur au point de décalage défini.
Valeurs renvoyées
Tableau d'objets ou valeur null. Chaque objet du tableau possède les propriétés suivantes :
• L'objet message est une chaîne qui contient le message d'erreur.
• L'objet floaterName est une chaîne qui contient le nom de la fenêtre de résultats. Vous pouvez transmettre cette
valeur aux fonctions showResults() ou setFloaterVisibility().
• L'objet floaterIndex est un index d'éléments dans la liste de résultats de palette.
• L'objet start est l'index d'ouverture du code souligné.
• L'objet end est l'index de fermeture du code souligné.
Remarque : Les index de palette renvoyés ne doivent pas être conservés car ils varient fréquemment, par exemple, lors de
l'ouverture ou de la fermeture de documents.
Exemple
L'exemple suivant appelle getValidationErrorsForOffset() pour vérifier qu'il n'y a pas d'erreur au décalage de la
sélection actuelle. Si la fonction renvoie une erreur, le code appelle la fonction alert() pour afficher le message
d'erreur à l'utilisateur.
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()
Disponibilité
Dreamweaver 4.
Description
Déplace le texte sélectionné en mode Code d'une marque de tabulation vers la droite.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 450
Code
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.source.insert()
Disponibilité
Dreamweaver 4.
Description
Insère la chaîne spécifiée dans le code source au niveau du point de décalage défini à partir du début du fichier source.
Si le décalage n'est pas supérieur ou égal à zéro, l'insertion échoue et la fonction renvoie la valeur false.
Arguments
offset, string
• L'argument offset est le décalage à partir du début du fichier où la chaîne doit êtreinsérée.
• L'argument string est la chaîne à insérer.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
dom.source.nextWord()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion au début du mot suivant (ou des mots suivants, si spécifié) en mode Code. Si le contenu
est déjà sélectionné, cette fonction étend la sélection vers la droite.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de mots que le point d'insertion doit déplacer. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 451
Code
dom.source.outdentTextview()
Disponibilité
Dreamweaver 4.
Description
Déplace le texte sélectionné en mode Code d'une marque de tabulation vers la gauche.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.source.pageDown()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion vers le bas du document affiché en mode Code, page par page. Si le contenu est déjà
sélectionné, cette fonction étend la sélection page par page.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de pages que le point d'insertion doit sauter. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.pageUp()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion vers le haut du document affiché en mode Code, page par page. Si le contenu est déjà
sélectionné, cette fonction étend la sélection page par page.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 452
Code
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de pages que le point d'insertion doit sauter. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.previousWord()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion au début du mot précédent (ou des mots précédents, si spécifié) en mode Code. Si le
contenu est déjà sélectionné, cette fonction étend la sélection vers la gauche.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de mots que le point d'insertion doit déplacer. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.replaceRange()
Disponibilité
Dreamweaver 4.
Description
Remplace la plage de texte source comprise entre startOffset et endOffset par string. Si startOffset est supérieur à
endOffset ou si l'un des décalages n'est pas un nombre entier positif, cette fonction n'a aucun effet et renvoie la valeur
false. Si endOffset est supérieur au nombre de caractères du fichier, cette fonction remplace la plage comprise entre
startOffset et la fin du fichier. Si startOffset et endOffset sont supérieurs au nombre de caractères du fichier, cette
fonction insère le texte à la fin du fichier.
Arguments
startOffset, endOffset, string
• L'argument startOffset est le décalage indiquant le début du bloc à remplacer.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 453
Code
• L'argument endOffset est le décalage indiquant la fin du bloc à remplacer.
• L'argument string est la chaîne à insérer.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
dom.source.scrollEndFile()
Disponibilité
Dreamweaver 4.
Description
Fait défiler le mode Code vers le bas du document sans déplacer le point d'insertion.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.source.scrollLineDown()
Disponibilité
Dreamweaver 4.
Description
Fait défiler le mode Code vers le bas ligne par ligne sans déplacer le point d'insertion.
Arguments
nTimes
• L'argument nTimes est le nombre de lignes à faire défiler. Si nTimes n'est pas défini, il prend par défaut la valeur1.
Valeurs renvoyées
Aucune.
dom.source.scrollLineUp()
Disponibilité
Dreamweaver 4.
Description
Fait défiler le mode Code vers le haut ligne par ligne sans déplacer le point d'insertion.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 454
Code
Arguments
nTimes
• L'argument nTimes est le nombre de lignes à faire défiler. Si nTimes n'est pas défini, il prend par défaut la valeur1.
Valeurs renvoyées
Aucune.
dom.source.scrollPageDown()
Disponibilité
Dreamweaver 4.
Description
Fait défiler le mode Code vers le bas page par page sans déplacer le point d'insertion.
Arguments
nTimes
• L'argument nTimes est le nombre de pages à faire défiler. Si nTimes n'est pas défini, il prend par défaut la valeur1.
Valeurs renvoyées
Aucune.
dom.source.scrollPageUp()
Disponibilité
Dreamweaver 4.
Description
Fait défiler le mode Code vers le haut page par page sans déplacer le point d'insertion.
Arguments
nTimes
• L'argument nTimes est le nombre de pages à faire défiler. Si nTimes n'est pas défini, il prend par défaut la valeur1.
Valeurs renvoyées
Aucune.
dom.source.scrollTopFile()
Disponibilité
Dreamweaver 4.
Description
Fait défiler le mode Code vers le haut du document sans déplacer le point d'insertion.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 455
Code
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.source.selectParentTag()
Disponibilité
Dreamweaver 4.
Description
Cette fonction est une extension du mode Code qui permet d'équilibrer les balises. Vous pouvez appeler
dom.source.selectParentTag() pour étendre la sélection ou le point d'insertion courant de la balise d'ouverture à
la balise de fermeture. Les appels suivants étendent la sélection à des balises supplémentaires jusqu'à ce qu'il n'y ait plus
de balises de fermeture.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dom.source.setCurrentLine()
Disponibilité
Dreamweaver 4.
Description
Place le point d'insertion au début de la ligne indiquée. Si l'argument lineNumber n'est pas un nombre entier positif, la
fonction n'a aucun effet et renvoie la valeur false. Le point d'insertion est placé au début de la dernière ligne si
lineNumber est supérieur au nombre de lignes de la source.
Arguments
lineNumber
• L'argument lineNumber est la ligne au début de laquelle le point d'insertion est placé.
Valeurs renvoyées
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
dom.source.startOfDocument()
Disponibilité
Dreamweaver 4.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 456
Code
Description
Place le point d'insertion au début du document affiché en mode Code. Si le contenu est déjà sélectionné, cette fonction
étend la sélection au début du document.
Arguments
bShiftIsDown
• L'argument bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si bShiftIsDown a la
valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.startOfLine()
Disponibilité
Dreamweaver 4.
Description
Place le point d'insertion au début de la ligne courante. Si le contenu est déjà sélectionné, cette fonction étend la
sélection au début de la ligne courante.
Arguments
bShiftIsDown
• L'argument bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si bShiftIsDown a la
valeur true, le contenu est sélectionné.
Valeurs renvoyées
Aucune.
dom.source.topPage()
Disponibilité
Dreamweaver 4.
Description
Déplace le point d'insertion en haut de la page courante ou de la page précédente (si le point d'insertion est déjà en
haut d'une page). Si le contenu est déjà sélectionné, cette fonction étend la sélection page par page.
Arguments
{nTimes}, {bShiftIsDown}
• L'argument facultatif nTimes est le nombre de pages que le point d'insertion doit sauter. Si nTimes n'est pas défini,
il prend par défaut la valeur1.
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si
bShiftIsDown a la valeur true, le contenu est sélectionné.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 457
Code
Valeurs renvoyées
Aucune.
dom.source.wrapSelection()
Disponibilité
Dreamweaver 4.
Description
Insère le texte de startTag avant la sélection en cours et le texte de endTag après la sélection en cours. La fonction
sélectionne ensuite la plage entière entre les balises insérées, en incluant ces balises. Si la sélection en cours est un point
d'insertion, la fonction place le point d'insertion entre startTag et endTagstartTag et endTag ne doivent pas
nécessairement être des balises; il peut s'agir de tout segment de texte de votre choix.
Arguments
startTag, endTag
• L'argument startTag est le texte à insérer au début de la sélection.
• L'argument endTag est le texte à insérer à la fin de la sélection.
Valeurs renvoyées
Aucune.
dom.synchronizeDocument()
Disponibilité
Dreamweaver 4.
Description
Synchronise les modes Code et Création.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 458
Code
Fonctions de l'éditeur de balises et de la bibliothèque de
balises
Vous pouvez utiliser les éditeurs de balises pour insérer de nouvelles balises, pour modifier des balises existantes ou
pour accéder à des informations de référence sur les balises. Le sélecteur de balises permet aux utilisateurs d'organiser
leurs balises afin qu'ils puissent sélectionner les balises les plus fréquemment utilisées. Les bibliothèques de balises
fournies avec Dreamweaver stockent des informations concernant les balises utilisées dans les langages de balisage
standard et dans les langages de script et de balise fréquemment utilisés. Vous pouvez utiliser les fonctions de l'éditeur
de balises JavaScript, du sélecteur de balises, de la bibliothèque de balises lorsque vous devez utiliser les éditeurs de
balises et bibliothèques de balises dans vos extensions.
dom.getTagSelectorTag()
Disponibilité
Dreamweaver MX.
Description
Cette fonction obtient le nœud DOM de la balise sélectionnée dans la barre du sélecteur de balises se trouvant au bas
de la fenêtre de document.
Arguments
Aucun.
Valeurs renvoyées
Noeud DOM de la balise sélectionnée ; null si aucune balise n'est sélectionnée.
dreamweaver.popupInsertTagDialog()
Disponibilité
Dreamweaver MX.
Description
Cette fonction vérifie les fichiers VTM pour s'assurer qu'un éditeur de balises a été utilisé pour la balise. Si c'est le cas,
l'éditeur de cette balise apparaît et accepte la balise de début. Si ce n'est pas le cas, la balise de début est insérée telle
quelle dans le document de l'utilisateur.
Arguments
start_tag_string
Chaîne de balise de début qui comprend un des types suivants de valeurs initiales :
• une balise, comme <input> ;
• une balise avec des attributs, comme <input
• une directive, comme <%=
%>.
type='text'> ;
RÉFÉRENCE DES API DE DREAMWEAVER CS4 459
Code
Valeurs renvoyées
Valeur booléenne : true si un élément est inséré dans le document et false dans le cas contraire.
dreamweaver.popupEditTagDialog()
Disponibilité
Dreamweaver MX.
Description
Si une balise est sélectionnée, cette fonction ouvre l'éditeur de balises correspondant à cette balise pour vous permettre
de modifier la balise.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
Activateur
Voir « dreamweaver.canPopupEditTagDialog() » à la page 477.
dreamweaver.showTagChooser()
Disponibilité
Dreamweaver MX.
Description
Cette fonction affiche la boîte de dialogue Sélecteur de balises, la fait apparaître au premier plan et la rend active.
Arguments
Aucun.
Valeurs renvoyées
Aucune.
dreamweaver.showTagLibraryEditor()
Disponibilité
Dreamweaver MX.
Description
Cette fonction ouvre l'éditeur de la bibliothèque de balises.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 460
Code
Valeurs renvoyées
Aucun.
dreamweaver.tagLibrary.getTagLibraryDOM()
Disponibilité
Dreamweaver MX.
Description
Associée à l'URL d'un fichier filename.vtm, cette fonction renvoie le DOM de ce fichier afin que son contenu soit
modifié.Cette fonction ne doit être appelée que lorsque l'éditeur de la bibliothèque de balises est actif.
Arguments
fileURL
• L'argument fileURL est l'URL d'un fichier filename.vtm , relatif au dossier Configuration/Tag Libraries, comme le
montre l'exemple suivant : "HTML/img.vtm"
Valeurs renvoyées
Un pointeur DOM désignant un fichier nouveau ou plus ancien du dossier TagLibraries.
dreamweaver.tagLibrary.getSelectedLibrary()
Disponibilité
Dreamweaver MX.
Description
Si un nœud de bibliothèque est sélectionné dans l'éditeur de la bibliothèque de balises, cette fonction obtient le nom
de la bibliothèque.
Arguments
Aucun.
Valeurs renvoyées
Chaîne correspondant au nom de la bibliothèque sélectionnée dans l'éditeur de la bibliothèque de balises ; renvoie une
chaîne vide si aucune bibliothèque n'est sélectionnée.
dreamweaver.tagLibrary.getSelectedTag()
Disponibilité
Dreamweaver MX.
Description
Si un nœud d'attribut est sélectionné, cette fonction obtient le nom de la balise qui contient l'attribut.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 461
Code
Arguments
Aucun.
Valeurs renvoyées
Chaîne correspondant au nom de la balise sélectionnée dans l'éditeur de la bibliothèque de balises ; renvoie une chaîne
vide si aucune balise n'est sélectionnée.
dreamweaver.tagLibrary.importDTDOrSchema()
Disponibilité
Dreamweaver MX.
Description
Cette fonction importe un fichier DTD/Schéma à partir d'un serveur distant dans la bibliothèque de balises.
Arguments
fileURL, Préfixe
• L'argument fileURL est le chemin du fichier DTD ou schéma, au format URL local.
• L'argument Prefix est la chaîne de préfixe qui doit être ajoutée à toutes les balises de cette bibliothèque.
Valeurs renvoyées
Nom de la bibliothèque de balises importées.
dreamweaver.tagLibrary.getImportedTagList()
Disponibilité
Dreamweaver MX.
Description
Cette fonction génère une liste d'objets TagInfo à partir d'une bibliothèque de balises importées.
Arguments
libname
• L'argument libname est le nom de la bibliothèque de balises importées.
Valeurs renvoyées
Tableau d'objets tagInfo.
Un objet taginfo contient des informations concernant une balise de la bibliothèque de balises. Les propriétés
suivantes sont définies dans un objet tagInfo :
• la propriété tagName, qui est une chaîne ;
• la propriété attributes, qui est un tableau de chaînes. Chaque chaîne correspond au nom d'un attribut défini pour
cette balise.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 462
Code
Exemple :
L'exemple suivant indique que l'utilisation de la fonction dw.tagLibrary.getImportedTagList() peut résulter en
un tableau de balises de la bibliothèque libName :
// "fileURL" and "prefix" have been entered by the user.
// tell the Tag Library to Import the DTD/Schema
var libName = dw.tagLibrary.importDTDOrSchema(fileURL, prefix);
// get the array of tags for this library
// this is the TagInfo object
var tagArray = dw.tagLibrary.getImportedTagList(libName);
// now I have an array of tagInfo objects.
// I can get info out of them. This gets info out of the first one.
// note: this assumes there is at least one TagInfo in the array.
var firstTagName = tagArray[0].name;
var firstTagAttributes = tagArray[0].attributes;
// note that firstTagAttributes is an array of attributes.
463
Chapitre 19 : Activateurs
Les fonctions d'activateur de Adobe® Dreamweaver® CS4 déterminent si une autre fonction peut effectuer une
opération donnée dans le contexte actuel. Les circonstances générales dans lesquelles chaque fonction renvoie la valeur
true sont décrites dans la spécification de fonction correspondante. Toutefois, ces descriptions ne prétendent pas être
exhaustives et ne couvrent pas nécessairement tous les cas où la fonction renverrait la valeur false.
Fonctions d'activateur
Les fonctions d'activateur dans l'API JavaScript comprennent les fonctions suivantes.
dom.canAlign()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Aligner à gauche, Aligner à droite, Aligner en haut ou Aligner en bas.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si deux calques ou zones réactives au minimum sont sélectionnés.
dom.canApplyTemplate()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Appliquer à la page. Cette fonction n'est valide que pour le
document actif.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si le document n'est pas un élément de bibliothèque ni un modèle, et si la sélection n'est
pas encadrée de balises NOFRAMES.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 464
Activateurs
dom.canArrange()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Mettre au premier plan ou Mettre en arrière-plan.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si une zone réactive est sélectionnée.
dom.canClipCopyText()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Copier comme texte.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les décalages d'ouverture et de fermeture sont différents ; false dans le cas contraire, pour
indiquer qu'aucune sélection n'a été effectuée.
dom.canClipPaste()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Coller.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le Presse-papiers contient des données pouvant être collées dans Dreamweaver, false dans
le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 465
Activateurs
dom.canClipPasteText()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Coller comme texte.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le Presse-papiers contient des données pouvant être collées sous forme de texte dans
Dreamweaver, false dans le cas contraire.
dom.canConvertLayersToTable()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Convertir les calques en tableau.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le contenu complet de la section BODY du document est compris dans des calques, false
dans le cas contraire.
dom.canConvertTablesToLayers()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Convertir les tableaux en calques.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si tout le contenu de la section BODY du document figure dans des tableaux et si le document
n'est pas basé sur un modèle, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 466
Activateurs
dom.canDecreaseColspan()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Réduire l'étendue de colonnes.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la cellule active possède un attribut COLSPAN et si la valeur de cet attribut est supérieure ou
égale à 2 ; false dans le cas contraire.
dom.canDecreaseRowspan()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Réduire l'étendue de lignes.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la cellule active possède un attribut ROWSPAN et si la valeur de cet attribut est supérieure ou
égale à 2 ; false dans le cas contraire.
dom.canDeleteTableColumn()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Supprimer la colonne.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le point d'insertion se trouve dans une cellule ou si une cellule ou une colonne est
sélectionnée, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 467
Activateurs
dom.canDeleteTableRow()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Supprimer la ligne.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le point d'insertion se trouve dans une cellule ou si une cellule ou une ligne est sélectionnée,
false dans le cas contraire.
site.canEditColumns()
Description
Vérifie si un site existe.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le site existe, false dans le cas contraire.
dom.canEditNoFramesContent()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Modifier le contenu sans cadres.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le document actif est un jeu de cadres ou s'il figure dans un jeu de cadres, false dans le cas
contraire.
dom.canIncreaseColspan()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 468
Activateurs
Description
Détermine si Dreamweaver peut effectuer une opération Augmenter l'étendue de colonnes.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il existe des cellules à droite de la cellule active, false dans le cas contraire.
dom.canIncreaseRowspan()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Augmenter l'étendue de lignes.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il existe des cellules au-dessous de la cellule active, false dans le cas contraire.
dom.canInsertTableColumns()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Insérer une colonne.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection se trouve dans un tableau, false si la sélection constitue un tableau entier ou
si elle ne se trouve pas dans un tableau.
dom.canInsertTableRows()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Insérer une ligne.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 469
Activateurs
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection se trouve dans un tableau, false si la sélection constitue un tableau entier ou
si elle ne se trouve pas dans un tableau.
dom.canMakeNewEditableRegion()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Nouvelle région modifiable.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le document actif est un fichier de modèle (DWT).
dom.canMarkSelectionAsEditable()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Marquer la sélection comme modifiable.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il y a une sélection et si le document actif est un fichier DWT, false dans le cas contraire.
dom.canMergeTableCells()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Fusionner les cellules.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 470
Activateurs
Valeurs renvoyées
Valeur booléenne : true si la sélection est un regroupement adjacent de cellules de tableau, false dans le cas contraire.
dom.canPlayPlugin()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Lire. Cette fonction n'est valide que pour le document actif.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection peut être exécutée avec un plug-in.
dom.canRedo()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Rétablir.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il reste des opérations à rétablir, false dans le cas contraire.
dom.canRemoveEditableRegion()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Rendre la région non modifiable.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le document est un modèle et false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 471
Activateurs
dom.canSelectTable()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Sélectionner le tableau.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection ou le point d'insertion se trouve dans un tableau, false dans le cas contraire.
dom.canSetLinkHref()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut modifier le lien qui entoure la sélection en cours ou en créer un si nécessaire.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection est une image, du texte ou si le point d'insertion se trouve dans un lien, false
dans les autres cas. Une sélection de texte se définit comme une sélection pour laquelle l'inspecteur Propriétés de texte
s'ouvrirait.
dom.canShowListPropertiesDialog()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut afficher la boîte de dialogue Propriétés de la liste.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection est encadrée de balises LI, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 472
Activateurs
dom.canSplitFrame()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Fractionner le cadre [à gauche | à droite | vers le haut | vers le bas].
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection se trouve dans un cadre et false dans le cas contraire.
dom.canSplitTableCell()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Fractionner la cellule.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le point d'insertion se trouve dans une cellule de tableau ou si la sélection est une cellule de
tableau, false dans les autres cas.
dom.canStopPlugin()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Arrêter.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection est exécutée actuellement avec un plug-in, false dans les autres cas.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 473
Activateurs
dom.canUndo()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Annuler.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il reste des opérations à annuler, false dans le cas contraire.
dom.hasTracingImage()
Disponibilité
Dreamweaver 3.
Description
Détermine si le document possède un tracé d'image.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le document comporte un tracé d'image, false dans le cas contraire.
dreamweaver.assetPalette.canEdit()
Disponibilité
Dreamweaver 4.
Description
Active les options de menu du panneau Actifs pour permettre leur modification.
Arguments
Aucun.
Valeurs renvoyées
Renvoie une valeur booléenne : true si l'actif peut être modifié et false dans le cas contraire. Renvoie la valeur false
pour les couleurs et les URL de la liste des sites et false pour une sélection de plusieurs couleurs et URL dans la liste
des favoris.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 474
Activateurs
dreamweaver.assetPalette.canInsertOrApply()
Disponibilité
Dreamweaver 4.
Description
Vérifie si les options sélectionnées peuvent être insérées ou appliquées. Renvoie les valeurs true ou false pour que
l'insertion ou l'application des options de menu puissent être activées ou désactivées.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les éléments sélectionnés peuvent être insérés ou appliqués, false si la page active est un
modèle et que la catégorie en cours est Templates. La fonction renvoie également la valeur false si aucun document
n'est ouvert ou si un élément de bibliothèque est sélectionné dans le document et que la catégorie active est
Bibliothèque.
dreamweaver.canClipCopy()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Copier.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si un contenu sélectionné peut être copié dans le Presse-papiers, false dans le cas contraire.
dreamweaver.canClipCut()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Couper.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si un contenu sélectionné peut être coupé dans le Presse-papiers, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 475
Activateurs
dreamweaver.canClipPaste()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Coller.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le contenu du Presse-papiers, le cas échéant, peut être collé dans le document actif, dans la
fenêtre active du panneau Site ou, sur Macintosh, dans un champ de texte d'un panneau flottant ou d'une boîte de
dialogue ; false dans le cas contraire.
dreamweaver.canDeleteSelection()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut supprimer la sélection en cours. Celle-ci peut se trouver, selon le cas, dans la fenêtre
de document, dans le panneau Site ou, sur Macintosh, dans un champ de texte d'un panneau flottant ou d'une boîte de
dialogue.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si les décalages d'ouverture et de fermeture de la sélection sont différents, ce qui indique
qu'une sélection est effectuée ; false s'ils sont identiques et qu'il n'y a donc qu'un point d'insertion.
dreamweaver.canExportTemplateDataAsXML()
Disponibilité
Dreamweaver MX.
Description
Vérifie si Dreamweaver peut exporter le document actif au format XML.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le document actif peut être exporté et false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 476
Activateurs
Exemple
Dans l'exemple suivant, dw.canExportTemplateDataAsXML() est appelé pour déterminer si Dreamweaver peut
exporter le document actif au format XML. S'il renvoie la valeur true, il appelle dw.ExportTemplateDataAsXML()
pour l'exporter :
if(dreamweaver.canExportTemplateDataAsXML())
{
dreamweaver.exportTemplateDataAsXML("file:///c|/dw_temps/mytemplate.txt")
}
dreamweaver.canFindNext()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Rechercher le suivant.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si un modèle de recherche a été défini, false dans le cas contraire.
dreamweaver.canFitSelection()
Disponibilité
Dreamweaver 8.
Description
Vérifie si un élément est sélectionné dans un mode Création actif, ce qui signifie que fitSelection() peut être
appelée.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si un élément est sélectionné dans un mode Création actif, false dans le cas contraire.
dreamweaver.canOpenInFrame()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Ouvrir dans un cadre.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 477
Activateurs
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection ou le point d'insertion se trouve dans un cadre et false dans le cas contraire.
dreamweaver.canPasteSpecial()
Disponibilité
Dreamweaver 8.
Description
Vérifie si Dreamweaver peut effectuer une opération Collage spécial.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le Presse-papiers contient du texte, du code HTML ou du code HTML pour Dreamweaver
et que le mode Code, Création ou Inspecteur de code est actif ; false dans le cas contraire.
dreamweaver.canPlayRecordedCommand()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Reproduire la commande enregistrée.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il existe un document actif et une commande enregistrée pouvant être exécutée, false dans
le cas contraire.
dreamweaver.canPopupEditTagDialog()
Disponibilité
Dreamweaver MX.
Description
Vérifie si la sélection en cours est une balise et si l'élément de menu Modifier la balise est actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 478
Activateurs
Arguments
Aucun.
Valeurs renvoyées
Nom de la balise sélectionnée ou la valeur null si aucune balise n'est sélectionnée.
dreamweaver.canRedo()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Rétablir dans le contexte en cours.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant s'il existe des opérations pouvant être annulées.
dreamweaver.canRevertDocument()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Rétablir (revenir au dernier état enregistré).
Arguments
documentObject.
• L'argument documentObject correspond à l'objet situé à la racine de l'arborescence DOM d'un document (c'est-àdire la valeur renvoyée par la fonction dreamweaver.getDocumentDOM()).
Valeurs renvoyées
Valeur booléenne indiquant si le document est à l'état non enregistré et s'il en existe une version enregistrée sur un
lecteur local.
dreamweaver.canSaveAll()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Enregistrer tout.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 479
Activateurs
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si deux documents non enregistrés, ou plus, sont ouverts.
dreamweaver.canSaveDocument()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Enregistrer sur le document spécifié.
Arguments
documentObject.
• L'argument documentObject est la racine d'un DOM de document (valeur identique à celle renvoyée par
dreamweaver.getDocumentDOM()).
Valeurs renvoyées
Valeur booléenne indiquant si le document contient des modifications non enregistrées.
dreamweaver.canSaveDocumentAsTemplate()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Enregistrer comme modèle sur le document spécifié.
Arguments
documentObject.
• L'argument documentObject est la racine d'un DOM de document (valeur identique à celle renvoyée par
dreamweaver.getDocumentDOM()).
Valeurs renvoyées
Valeur booléenne indiquant si le document peut être enregistré comme modèle.
dreamweaver.canSaveFrameset()
Disponibilité
Dreamweaver 3.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 480
Activateurs
Description
Vérifie si Dreamweaver peut effectuer une opération Enregistrer le jeu de cadres sur le document spécifié.
Arguments
documentObject.
• L'argument documentObject est la racine d'un DOM de document (valeur identique à celle renvoyée par
dreamweaver.getDocumentDOM()).
Valeurs renvoyées
Valeur booléenne indiquant si le document est un jeu de cadres comportant des modifications non enregistrées.
dreamweaver.canSaveFramesetAs()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Enregistrer le jeu de cadres sous sur le document spécifié.
Arguments
documentObject.
• L'argument documentObject est la racine d'un DOM de document (valeur identique à celle renvoyée par
dreamweaver.getDocumentDOM()).
Valeurs renvoyées
Valeur booléenne qui indique si le document est un jeu de cadres.
dreamweaver.canSelectAll()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Sélectionner tout.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant s'il est possible d'effectuer une opération Sélectionner tout.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 481
Activateurs
dreamweaver.canShowFindDialog()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Rechercher.
Arguments
Aucun.
Valeurs renvoyées
Une valeur booléenne qui est true si une fenêtre de document ou un panneau Site est ouvert. Cette fonction renvoie
la valeur false lorsque la sélection se trouve dans la section HEAD.
dreamweaver.canUndo()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Annuler dans le contexte en cours.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant s'il existe des opérations pouvant être annulées.
dreamweaver.canZoom()
Disponibilité
Dreamweaver 8.
Description
Vérifie si un mode Création est actif, ce qui signifie que les commandes de base de zoom peuvent être appliquées.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true s'il existe un mode Création actif, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 482
Activateurs
dreamweaver.cssRuleTracker.canEditSelectedRule()
Disponibilité
Dreamweaver MX 2004.
Description
Vérifie si l'éditeur de grille de propriété peut s'appliquer à la règle sélectionnée. La grille de propriété pouvant afficher
les règles dans les fichiers verrouillés, la valeur de renvoi true ne garantit pas que les règles peuvent être modifiées.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si l'éditeur de grille de propriété peut s'appliquer à la règle sélectionnée, false dans le cas
contraire.
Exemple
Le code suivant vérifie que la fonction de l'activateur a été définie sur la valeur true avant d'autoriser les modifications
sur la règle sélectionnée :
if(dw.cssRuleTracker.canEditSelectedRule()){
dw.cssRuleTracker.editSelectedRule();
}
dreamweaver.cssStylePalette.canApplySelectedStyle()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le style sélectionné peut être appliqué au document actif.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Valeur booléenne : true si le style sélectionné comporte un sélecteur de classes, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 483
Activateurs
dreamweaver.cssStylePalette.canDeleteSelectedStyle()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le style sélectionné peut être supprimé de la sélection en cours.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Valeur booléenne, true si la sélection peut être supprimée, false dans le cas contraire.
dreamweaver.cssStylePalette.canDuplicateSelectedStyle()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le style sélectionné peut être dupliqué dans le document actif.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Valeur booléenne, true si le style sélectionné peut être dupliqué, false dans le cas contraire.
dreamweaver.cssStylePalette.canEditSelectedStyle()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le style sélectionné peut être modifié dans le document actif.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 484
Activateurs
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Valeur booléenne, true si le style sélectionné est modifiable, false dans le cas contraire.
dreamweaver.cssStylePalette.canEditSelectedStyleInCodeview()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le style sélectionné peut être modifié dans le document actif en mode Code.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Valeur booléenne, true si le style sélectionné est modifiable, false dans le cas contraire.
dreamweaver.cssStylePalette.canEditStyleSheet()
Disponibilité
Dreamweaver MX.
Description
Vérifie si la sélection en cours contient des éléments de feuille de style modifiables.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si la sélection est un nœud de feuille de style ou une définition de style n'est pas masquée et
si elle est distincte de ce document ; false si la sélection est masquée ou si elle se trouve dans ce document.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 485
Activateurs
dreamweaver.cssStylePalette.canRenameSelectedStyle()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le style sélectionné peut être renommé dans le document actif.
Arguments
{pane}
• L'argument facultatif pane est une chaîne spécifiant le volet du panneau Styles CSS auquel cette fonction est
appliquée. Les valeurs possibles sont les suivantes : "stylelist", qui correspond à la liste des styles en mode
« Tout » ; "cascade", qui correspond à la liste des règles applicables concernées en mode « Courant » ; "summary",
qui correspond à la liste des propriétés de la sélection en cours en mode « Courant » et "ruleInspector", qui
correspond à la liste ou grille de propriétés modifiable en mode « Courant ». La valeur par défaut est "stylelist".
Valeurs renvoyées
Valeur booléenne, true si le style sélectionné peut être renommé, false dans le cas contraire.
dreamweaver.isRecording()
Disponibilité
Dreamweaver 3.
Description
Indique si Dreamweaver est en train de mémoriser une commande.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si Dreamweaver est en train d'enregistrer une commande.
dreamweaver.htmlStylePalette.canEditSelection()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut modifier, supprimer ou dupliquer la sélection dans le panneau Styles HTML.
Arguments
Aucun.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 486
Activateurs
Valeurs renvoyées
Valeur booléenne : true si Dreamweaver peut modifier, supprimer ou dupliquer la sélection dans le panneau Styles
HTML ; false si aucun style n'est sélectionné ou si l'un des styles indéterminés est sélectionné.
dreamweaver.resultsPalette.canClear()
Disponibilité
Dreamweaver MX.
Description
Vérifie que vous pouvez effacer le contenu du panneau Résultats actuellement actif.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le contenu peut être effacé, false dans le cas contraire.
dreamweaver.resultsPalette.canCopy()
Disponibilité
Dreamweaver MX.
Description
Vérifie si la fenêtre de résultats peut afficher un message copié dans son contenu.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le contenu peut être affiché, false dans le cas contraire.
dreamweaver.resultsPalette.canCut()
Disponibilité
Dreamweaver MX.
Description
Vérifie si la fenêtre de résultats peut afficher un message coupé dans son contenu.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le contenu peut être affiché, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 487
Activateurs
dreamweaver.resultsPalette.canPaste()
Disponibilité
Dreamweaver MX.
Description
Vérifie si la fenêtre de résultats peut afficher un message collé dans son contenu.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le contenu peut être affiché, false dans le cas contraire.
dreamweaver.resultsPalette.canOpenInBrowser()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le rapport en cours peut être affiché dans un navigateur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le contenu peut être affiché, false dans le cas contraire.
dreamweaver.resultsPalette.canOpenInEditor()
Disponibilité
Dreamweaver MX.
Description
Vérifie si le rapport en cours peut être affiché dans un éditeur.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne, true si le contenu peut être affiché, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 488
Activateurs
dreamweaver.resultsPalette.canSave()
Disponibilité
Dreamweaver MX.
Description
Vérifie si la boîte de dialogue d'enregistrement peut être lancée pour le panneau en cours. Actuellement, les panneaux
Rapports du site, Vérification du navigateur cible, Validation et Vérificateur de lien prennent en charge la boîte de
dialogue d'enregistrement.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true, si la boîte de dialogue d'enregistrement apparaît, false dans le cas contraire.
dreamweaver.resultsPalette.canSelectAll()
Disponibilité
Dreamweaver MX.
Description
Vérifie si un message Sélectionner tout peut être transmis à la fenêtre active.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le message Sélectionner tout peut être transmis, false dans le cas contraire.
dreamweaver.siteSyncDialog.canCompare()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si le menu contextuel Comparer peut être affiché dans la boîte de dialogue Synchroniser le site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le menu contextuel Comparer peut être affiché dans la boîte de dialogue Synchroniser le
site, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 489
Activateurs
dreamweaver.siteSyncDialog.canMarkDelete()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si le menu contextuel Modifier l'action à supprimer peut être affiché dans la boîte de dialogue
Synchroniser le site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le menu contextuel Modifier l'action à supprimer peut être affiché, false dans le cas
contraire.
dreamweaver.siteSyncDialog.canMarkGet()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si le menu contextuel Modifier l'action à obtenir peut être affiché dans la boîte de dialogue
Synchroniser le site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le menu contextuel Modifier l'action à obtenir peut être affiché, false dans le cas contraire.
dreamweaver.siteSyncDialog.canMarkIgnore()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si le menu contextuel Modifier l'action à ignorer peut être affiché dans la boîte de dialogue
Synchroniser le site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le menu contextuel Modifier l'action à ignorer peut être affiché, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 490
Activateurs
dreamweaver.siteSyncDialog.canMarkPut()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si le menu contextuel Modifier l'action à placer peut être affiché dans la boîte de dialogue
Synchroniser le site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le menu contextuel Modifier l'action à placer peut être affiché, false dans le cas contraire.
dreamweaver.siteSyncDialog.canMarkSynced()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si le menu contextuel Modifier l'action à synchroniser peut être affiché dans la boîte de dialogue
Synchroniser le site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le menu contextuel Modifier l'action à synchroniser peut être affiché, false dans le cas
contraire.
dreamweaver.snippetpalette.canEditSnippet()
Disponibilité
Dreamweaver MX.
Description
Vérifie si vous pouvez modifier l'élément sélectionné et renvoie la valeur true ou la valeur false pour vous permettre
d'activer ou de désactiver les éléments de menu destinés à l'édition.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si vous pouvez modifier l'élément sélectionné, false dans le cas contraire.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 491
Activateurs
dreamweaver.snippetpalette.canInsert()
Disponibilité
Dreamweaver MX.
Description
Vérifie si vous pouvez insérer ou appliquer l'élément sélectionné et renvoie la valeur true ou la valeur false pour vous
permettre d'activer ou de désactiver les éléments de menu destinés à l'insertion ou à l'application.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si vous pouvez insérer ou appliquer l'élément sélectionné, false dans le cas contraire.
site.browseDocument()
Disponibilité
Dreamweaver 4.
Description
Ouvre tous les documents sélectionnés dans une fenêtre de navigateur. Cela revient à utiliser la commande Aperçu
dans le navigateur.
Arguments
browserName.
• L'argument browserName est le nom du navigateur tel qu'il est défini dans les préférences d'aperçu dans le
navigateur. Si cet argument n'est pas défini, le navigateur principal de l'utilisateur est utilisé par défaut.
Valeurs renvoyées
Aucune.
site.canCheckIn()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Archiver.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé site, indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Site, soit l'URL d'un fichier.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 492
Activateurs
Valeurs renvoyées
Valeur booléenne : true si les conditions suivantes sont vraies, false dans le cas contraire :
• Un site distant a été défini.
• Dans le cas où une fenêtre de document est active, le fichier a été enregistré sur un site local ou, dans le cas où le
panneau Site est actif, un ou plusieurs fichiers ou dossiers sont sélectionnés.
• La fonction Archiver/Extraire est activée pour le site.
site.canCheckOut()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Extraire sur le ou les fichiers spécifiés.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé site, indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Site, soit l'URL d'un fichier.
Valeurs renvoyées
Valeur booléenne : true si toutes les conditions suivantes sont vraies, false dans le cas contraire :
• Un site distant a été défini.
• Dans le cas où une fenêtre de document est active, le fichier appartient à un site local et il n'est pas déjà extrait ou,
dans le cas où le panneau Site est actif, plusieurs fichiers ou dossiers sont sélectionnés et au moins un des fichiers
sélectionnés n'a pas encore été extrait.
• La fonction Archiver/Extraire est activée pour le site.
site.canCloak()
Disponibilité
Dreamweaver MX.
Description
Détermine si Dreamweaver peut effectuer une opération de voilage.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé site, indiquant que la fonction canCloak() doit agir sur l'élément
sélectionné dans le panneau Site, soit l'URL d'un dossier donné, indiquant que la fonction canCloak() doit agir sur
le dossier spécifié et l'ensemble de son contenu.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 493
Activateurs
Valeurs renvoyées
Valeur booléenne : true si Dreamweaver peut exécuter l'opération de voilage sur le site en cours ou le dossier spécifié,
false dans le cas contraire.
site.canCompareFiles()
Disponibilité
Dreamweaver 8.
Description
Cette fonction vérifie si Dreamweaver peut exécuter la fonction Comparer sur des fichiers sélectionnés.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si deux fichiers (un fichier local et un fichier distant, deux fichiers locaux ou deux fichiers
distants) sont sélectionnés ; false dans le cas contraire.
site.canConnect()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut se connecter au site distant.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le site distant en cours est un site FTP, false dans le cas contraire.
site.canDisplaySyncInfoForFile()
Disponibilité
Dreamweaver CS3.
Description
Détermine si Dreamweaver peut effectuer l'opération displaySyncInfoForFile.
Arguments
path, 'site'
• path est l'URL pointant vers un fichier local.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 494
Activateurs
• 'site' indique que la fonction utilise le fichier sélectionné dans le panneau Site.
Valeurs renvoyées
Renvoie la valeur true si un fichier est sélectionné dans l'affichage local des fichiers (si 'site' en est le paramètre) ou
true si le chemin transmis fait partie d'un site. Renvoie false dans le cas contraire.
site.canGet()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Acquérir.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé site, indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Site, soit l'URL d'un fichier.
Valeurs renvoyées
Si l'argument est site, valeur booléenne indiquant si un ou plusieurs fichiers ou dossiers sont sélectionnés dans le
panneau Site et si un site distant a été défini. Si l'argument est une URL, valeur booléenne indiquant si le document
appartient à un site pour lequel un site distant a été défini.
site.canLocateInSite()
Disponibilité
Dreamweaver 3, mise à jour dans CS4.
Description
Détermine si Dreamweaver peut effectuer une opération Retrouver sur le site local ou Retrouver sur le site distant (en
fonction de l'argument).
Arguments
localOrRemote, siteOrURL
• L'argument localOrRemote doit être local ou remote.
• L'argument siteOrURL doit être le mot clé site. Ce mot clé indique que la fonction doit agir sur l'élément
sélectionné dans le panneau Site ou sur l'URL d'un fichier.
Valeurs renvoyées
L'une des valeurs suivantes :
• Valeur booléenne qui indique si le document appartient à un site. La valeur booléenne est renvoyée si le premier
argument est le mot clé local et le second argument est une URL.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 495
Activateurs
• Valeur booléenne. La valeur booléenne est renvoyée si le premier argument est le mot clé remote et le second
argument est une URL. La valeur booléenne indique :
• si le document appartient à un site pour lequel un site distant a été défini ;
• si le disque dur est monté, si le type de serveur est Local/Réseau.
• Valeur booléenne qui indique si les deux fenêtres contiennent des fichiers du site et si la sélection se trouve dans le
volet en face de l'argument. La valeur booléenne est renvoyée si le second argument est le mot clé site.
site.canMakeEditable()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Désactiver le mode Lecture seule.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si Dreamweaver peut effectuer une opération Désactiver le mode Lecture seule, false si un
ou plusieurs des fichiers sélectionnés sont verrouillés.
site.canMakeNewFileOrFolder()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Nouveau fichier ou Nouveau dossier dans le panneau Site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si des fichiers sont visibles dans le volet sélectionné du panneau Site, false dans le cas
contraire.
site.canOpen()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut ouvrir les fichiers ou les dossiers actuellement sélectionnés dans le panneau Site.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 496
Activateurs
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si des fichiers ou des dossiers sont sélectionnés dans le panneau Site, false dans les autres cas.
site.canPut()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Placer.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé site, indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Site, soit l'URL d'un fichier.
Valeurs renvoyées
L'une des valeurs suivantes :
• si l'argument est le mot clé site, renvoie la valeur true si des fichiers ou des dossiers sont sélectionnés dans le
panneau Site et si un site distant a été défini; renvoie la valeur false dans les autres cas ;
• si l'argument est une URL, renvoie la valeur true si le document appartient à un site pour lequel un site distant a
été défini ; renvoie la valeur false dans le cas contraire.
site.canRecreateCache()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Recréer le cache du site.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si l'option Utiliser le cache pour accélérer les mises à jour des liens est activée pour le site en
cours.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 497
Activateurs
site.canRefresh()
Disponibilité
Dreamweaver 3.
Description
Vérifie si Dreamweaver peut effectuer une opération Actualiser [local | distant].
Arguments
localOrRemote.
• L'argument localOrRemote doit être le mot clé local ou remote.
Valeurs renvoyées
Valeur true si l'argument localOrRemote est le mot clé local ; sinon, une valeur booléenne indiquant si un site distant
a été défini.
site.canSelectAllCheckedOutFiles()
Disponibilité
Dreamweaver 4.
Description
Détermine si la fonction Archiver/Extraire est activée sur le site en cours.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le site autorise l'archivage et l'extraction, false dans le cas contraire.
site.canSelectNewer()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Sélectionner [distants | locaux] plus récents.
Arguments
localOrRemote.
• L'argument localOrRemote doit être le mot clé local ou remote.
Valeurs renvoyées
Valeur booléenne indiquant si le document appartient à un site pour lequel un site distant a été défini.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 498
Activateurs
site.canSynchronize()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Synchroniser.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne indiquant si un site distant a été défini.
site.canUncloak()
Disponibilité
Dreamweaver MX.
Description
Détermine si Dreamweaver peut effectuer une opération de suppression du voile.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot-clé site, indiquant que la fonction canUncloak() doit agir sur
l'élément sélectionné dans le panneau Site, soit l'URL d'un dossier donné, indiquant que la fonction canUncloak()
doit agir sur le dossier spécifié et l'ensemble de son contenu.
Valeurs renvoyées
Valeur booléenne : true si Dreamweaver peut exécuter l'opération de suppression du voile sur le site en cours ou le
dossier spécifié, false dans le cas contraire.
site.canUndoCheckOut()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Annuler extraction.
Arguments
siteOrURL
• L'argument siteOrURL doit être soit le mot clé site, indiquant que la fonction doit agir sur l'élément sélectionné
dans le panneau Site, soit l'URL d'un fichier.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 499
Activateurs
Valeurs renvoyées
Valeur booléenne : true si le fichier spécifié ou l'un des fichiers sélectionnés, au moins, a été extrait.
site.canViewAsRoot()
Disponibilité
Dreamweaver 3.
Description
Détermine si Dreamweaver peut effectuer une opération Afficher comme racine.
Arguments
Aucun.
Valeurs renvoyées
Valeur booléenne : true si le fichier spécifié est un fichier HTML ou Flash, false dans le cas contraire.
500
Index
A
A propos des boîtes de dialogue 122
DWfile.getSize() 12
SCS_ItemExists() 97
DWfile.listFolder() 12
SCS_NewFolder() 96
activateApp() 119
DWfile.read() 13
SCS_Put() 96
activateurs 106
DWfile.remove() 13
SCS_Rename() 97
activeViewScale 391
DWfile.setAttributes() 14
SCS_SetDesignNotes() 105
addBehavior() 296
DWfile.write() 15
SCS_SiteDeleted() 98
addDebugContextData() 159
API d'intégration de commande source
SCS_SiteRenamed() 99
addItem() 153
à propos 91
addJavaScript() 321
SCS_AfterGet() 110
addLinkToExistingFile() 218
SCS_AfterPut() 111
API d'intégration de commande source,
fonctions facultatives 98
addResultItem() 149
SCS_BeforeGet() 109
API d'intégration de Fireworks
administration ODBC 69
SCS_BeforePut() 110
à propos 35
affichage
SCS_canCheckin() 107
bringDWToFront() 35
assistances visuelles 161
SCS_canCheckout() 107
bringFWToFront() 35
codes de touches 146
SCS_canConnect() 106
execJsInFireworks() 36
détermination 185
SCS_canDelete() 109
getJsResponse() 36
sélection 186
SCS_canGet() 106
mayLaunchFireworks() 37
visible 190
SCS_canNewFolder() 108
optimizeInFireworks() 38
SCS_UndoCheckout() 101
validateFireworks() 38
affichage de Dreamweaver au premier
plan 35
SCS_canPut() 107
affichage de Fireworks au premier plan 35
SCS_CanUndoCheckout() 108
à propos 58
affichage des tableaux 79
SCS_Checkin() 100
fonctions d'accès 71
afficher la barre d'outils 172
SCS_Checkout() 101
fonctions de connexion 59
Afficher la boîte de dialogue lors de
l'insertion d'un objet 121
SCS_Connect() 93
MMDB.deleteConnection() 59
SCS_Delete() 96
MMDB.getColdFusionDsnList() 60
SCS_Disconnect() 93
MMDB.getColumnAndTypeList() 71
SCS_Get() 95
MMDB.getColumnList() 72
SCS_GetAgentInfo() 92
MMDB.getColumns() 72
SCS_GetCheckoutName() 100
MMDB.getColumnsOfTable() 73
SCS_GetConnectionInfo() 98
MMDB.getConnection() 60
SCS_GetDesignNotes() 104
MMDB.getConnectionList() 61
SCS_GetErrorMessage() 103
MMDB.getConnectionName() 61
SCS_GetErrorMessageLength() 103
MMDB.getConnectionString() 62
SCS_GetFileCheckoutList() 102
MMDB.getDriverName() 63
SCS_GetFolderList() 95
MMDB.getLocalDsnList() 63
SCS_GetFolderListLength() 94
MMDB.getPassword() 63
SCS_GetMaxNoteLength() 104
MMDB.getPrimaryKeys() 74
SCS_GetNewFeatures() 99
MMDB.getProcedures() 74
SCS_GetNoteCount() 103
MMDB.getRdsPassword() 64
SCS_GetNumCheckedOut() 102
MMDB.getRdsUserName() 64
SCS_GetNumNewFeatures() 99
MMDB.getRemoteDsnList() 64
SCS_GetRootFolder() 94
MMDB.getRuntimeConnectionType() 6
5
alerte audio 120
align() 377
alignement
calques 377
tracé de l'image 383
annulation
état 135
extraction 101
répétition 128
annulation, extraction de fichiers 101
annuler 129, 131, 136
API d'E/S des fichiers
à propos 7
DWfile.copy() 7
DWfile.createFolder() 8
DWfile.exists() 8
DWfile.getAttributes() 9
DWfile.getCreationDate() 10
DWfile.getCreationDateObj() 11
DWfile.getModificationDate() 9
DWfile.getModificationDateObj() 11
SCS_canRename() 109
SCS_GetRootFolderLength() 94
SCS_IsConnected() 93
SCS_IsRemoteNewer() 105
API de base de données
MMDB.getSPColumnList() 76
MMDB.getSPColumnListNamedParams
() 76
RÉFÉRENCE DES API DE DREAMWEAVER CS4 501
Index
MMDB.getSPParameters() 77
API, types
assetPalette.locateInSite() 292
MMDB.getSPParamsAsString() 78
base de données 58
assetPalette.newAsset() 292
MMDB.getTables() 79
assetPalette.newFolder() 292
MMDB.getUserName() 65
boîte de dialogue de connexion à une base
de données 84
MMDB.getViews() 79
Design Notes 23
assetPalette.recreateLibraryFromDocument
() 293
MMDB.hasConnectionWithName() 66
HTTP 16
assetPalette.refreshSiteAssets() 293
MMDB.needToPromptForRdsInfo() 66
intégration de commande source 92
assetPalette.removeFromFavorites() 293
MMDB.needToRefreshColdFusionDsnLi
st() 67
intégration de Fireworks 35
assetPalette.renameNickname() 294
objets Flash 42
assetPalette.setSelectedCategory() 294
MMDB.popupConnection() 67
MMDB.setRdsPassword() 68
APi, types
assetPalette.setSelectedView() 295
MMDB.setRdsUserName() 68
application des styles 357
assetPalette.updateSmartObjectFromOrigin
al() 55
MMDB.showColdFusionAdmin() 68
applications
assistances visuelles 161, 166, 372, 374
MMDB.showConnectionMgrDialog() 69
MMDB.showOdbcDialog() 69
E/S des fichiers 7
ouverture de fichiers 117
sélection 117
Arrière-plans des blocs de mise en
forme 359, 362, 373
Contours des blocs de mise en forme 360,
363
MMDB.showRdsUserDialog() 69
applications externes, fonctions 112
MMDB.showRestrictDialog() 70
applications, fonctions globales 120
MMDB.showResultset() 80
applyCharacterMarkup() 421
MMDB.showSPResultset() 81
applyComment() 207
attachExternalStylesheet() 365
MMDB.showSPResultsetNamedParams(
) 81
applyConnection() 87
attributs
applyCSSStyle() 357
balise de fragment de code 316
MMDB.testConnection() 70
applyFontMarkup() 422
des fichiers, définition 14
applyLayout() 355
obtention 9
API de boîte de dialogue de connexion à une
base de données
à propos 84
applyConnection() 87
fichiers de définition 88
fichiers inclus, générés 87
findConnection() 85
inspectConnection() 86
Modèle de boîte des blocs de mise en
forme 359, 362, 372
applySelectedStyle() 364
applyTemplate() 310
archivage de fichiers 100, 111
B
backspaceKey() 141
arrange() 377
balanceBracesTextView() 445
arrangeFloatingPalettes() 384
balise de fragment de code, attributs 316
arrêt
balise de police 422
contenu des plug-ins 384
balise serverdebuginfo 159
mémorisation 131
balises
API de connectivité à une base de données.
Voir API de boîte de dialogue de
connexion à une base de données
arrowDown() 139, 443
calques 379
API des objets dynamiques 54
arrowLeft() 140, 444
insertion 124
API des objets Flash
arrowRight() 140, 444
police 422
à propos 42
arrowUp() 141, 445
Barre d'outils, afficher 172
SWFFile.createFile() 42
assetPalette.addToFavoritesFromDocumen
t() 288
barre Insertion
SWFFile.getNaturalSize() 43
SWFFile.getObjectType() 44
SWFFile.readFile() 44
API HTTP
assetPalette.addToFavoritesFromSiteAssets
() 288
assetPalette.addToFavoritesFromSiteWind
ow() 289
menus 137
rechargement d'objets 138
barres d'outils, fonctions 179
bascule, fonctions 160
à propos 16
assetPalette.canEdit() 473
MMHttp.clearServerScriptsFolder() 16
assetPalette.canInsertOrApply() 474
API de base de données 58
MMHttp.clearTemp() 17
assetPalette.canUpdateSmartObjectFromOr
iginal() 54
API de boîte de dialogue de connexion 84
MMHttp.getFile() 18
MMHttp.getFileCallback() 19
assetPalette.copyToSite() 289
fichiers de définition de type de
connexion 88
MMHttp.getTextCallback() 20
assetPalette.edit() 290
fonctions d'accès 71
MMHttp.postText() 21
assetPalette.getSelectedCategory() 290
fonctions de connexion 59
MMHttp.postTextCallback() 22
assetPalette.getSelectedItems() 290
modes 79
API SCS. Voir API d'intégration de
commande source
assetPalette.getSelectedView() 291
assetPalette.insertOrApply() 291
bases de données
beep() 120, 123, 213, 214, 242
RÉFÉRENCE DES API DE DREAMWEAVER CS4 502
Index
bibliothèque partagée MMNotes
BridgeTalk
canDecreaseColspan() 466
nom de version 26, 32
bringToFront() 125
canDecreaseRowspan() 466
numéro de version 26, 32
send() 126
canDeleteSelection() 475
suppressStartupScreen() 126
canDeleteTableColumn() 466
bip système 120
blocs
bringAttentionToFloater() 186
canDeleteTableRow() 467
bordures 387, 389
bringDWToFront() 35
canDisplaySyncInfoForFile() 493
ID 387, 389
bringFWToFront() 35
canEditColumns() 467
mise en couleur 386, 388
bringToFront() 125
canEditNoFramesContent() 467
boîte de dialogue Collage spécial 123
browseDocument() 112, 491
canEditSelectedRule() 482
boîte de dialogue Enregistrer comme
commande 135
browseForFileURL() 249
canEditSelection() 485
browseForFolderURL() 250
canEditSnippet() 490
boîtes de dialogue
browseInBridge() 127
canExportTemplateDataAsXML() 475
A propos 122
browser.getSelection() 344
canFindNext() 476
Administration de source de données
ODBC 69
browser.getStatusText() 344
canFitSelection() 476
browser.getWindow() 345
canGet() 494
browserEle.loadHTML() 345
canIncreaseColspan() 467
bruit 120
canIncreaseRowspan() 468
Administration ODBC système 69
Choisir un dossier 250
ColdFusion Administrator 68
Collage spécial 123
Convertir les calques en tableau 245
Convertir les tableaux en calques 246
Définition de la taille 159
Définition du style 366
Données dynamiques 122
Enregistrer comme commande 135
Enregistrer comme modèle 261
Enregistrer sous 259, 260
Gestionnaire de connexions 69
Modifier feuille de style 367
Modifier la liste de commandes 246
Navigateurs cibles 270
Nouveau document 256
Nouveau style 370
Nouveau style CSS 364
Ouvrir dans un cadre 258
Paramètres de la grille 385
Préférences 118, 121, 123
Propriétés de la page 266
Rechercher 420
Remplacer 421
Restreindre 70
Sélecteur de balises 124
Sélectionner source de l'image 381
Sélectionner un éditeur externe 117
Texte dynamique 122
bordures 387
blocs 389
divs 389
canInsert() 491
C
cadres
canInsertTableColumns() 468
canInsertTableRows() 468
fractionnement 376
canLocateInSite() 494
liste 375
canMakeEditable() 495
cadres et jeux de cadres, fonctions 375
canMakeNewEditableRegion() 469
calques 379
canMakeNewFileOrFolder() 495
alignement 377
canMarkDelete() 489
balise HTML 379
canMarkGet() 489
déplacement 378
canMarkIgnore() 489
taille 378
canMarkPut() 490
calques en tableaux, conversion 245
canMarkSelectionAsEditable() 469
calques, fonctions 377
canMarkSynced() 490
canAlign() 463
canMergeTableCells() 469
canApplyLayout() 356
canOpen() 495
canApplyTemplate() 463
canOpenInBrowser() 487
canArrange() 464
canOpenInEditor() 487
canCheckIn() 491
canOpenInFrame() 476
canCheckOut() 492
canPaste() 487
canClear() 486
canPasteSpecial() 477
canClipCopy() 474
canPlayPlugin() 470
canClipCopyText() 464
canPlayRecordedCommand() 477
canClipCut() 474
canPopupEditTagDialog() 477
canClipPaste() 464, 475
canPut() 496
canClipPasteText() 465
canRecreateCache() 496
canCloak() 492
canRedo() 470, 478
canCompare() 488
canRefresh() 497
canCompareFiles() 493
canRemoveEditableRegion() 470
canConnect() 493
canRenameSelectedStyle() 485
canConvertLayersToTable() 465
canRevertDocument() 478
canConvertTablesToLayers() 465
canSave() 488
canCopy() 486
canSaveAll() 478
canCut() 486
canSaveDocument() 479
RÉFÉRENCE DES API DE DREAMWEAVER CS4 503
Index
canSaveDocumentAsTemplate() 479
chemins, fonctions 270
canSaveFrameset() 479
clavier, fonctions 139
coloration
canSaveFramesetAs() 480
clé primaire 74
coloration de la syntaxe 177
canSelectAll() 480, 488
cleanupXHTML() 247
coloration du code 415
canSelectAllCheckedOutFiles() 497
clear() 150
commande source et Dreamweaver
canSelectNewer() 497
clearGuides() 394
canSelectTable() 471
clearServerScriptsFolder() 16
canSetLinkHref() 471
clearSteps() 132
ajout 92
canShowFindDialog() 481
clearTemp() 17
commandes
canShowListPropertiesDialog() 471
clés
code 411, 415
intégration 91
commande source, fonctionnalité système
exécution 246
canSplitFrame() 472
dans les Design Notes 24
canSplitTableCell() 472
dans les fichiers Design Notes 25, 29
commandes mémorisées 130
mémorisées 130
canStopPlugin() 472
liste 30
commentaires, appliquer 207
canSynchronize() 498
obtention de valeurs 30
comparaison, fichiers locaux et distants 105
canUncloak() 498
primaires 74
compare() 215
canUndo() 473, 481
suppression des fichiers Design Notes 27
compareFiles() 214
canUndoCheckOut() 498
clés de Design Note 103
comportements, fonctions 296
canUpdateSmartObjectFromOriginal() 57
clipCopy() 306, 308
conception, fonctions 355
canViewAsRoot() 499
clipCopyText() 306
connection_includefile.edml 88
canZoom() 481
clipCut() 306, 308
carte d'images, fonctions 377
clipPaste() 307, 308
connectivité à une base de données,
présentation 83
cascade() 187
cloak() 221
connectivité, présentation 83
chaînes
closeDocument() 251
connexion à des systèmes de commande
source 93
contenu du fichier 13
CloseNotesFile() 28
écriture dans les fichiers 15
code Code
chaînes d'ID, suppression 137
chaînes de connexion 61, 62
coloration de la syntaxe 165
connexion à la base de données (MMDB),
fonctions 59
connexions 67
code de touche, traduire en caractère 146
définition 87
codeHints.addFunction() 413
détection 85
changeLink() 219
codeHints.addMenu() 411
génération de HTML 87
changeLinkSitewide() 218
codeHints.resetMenu() 414
JDBC 63
changement de nom
codeHints.showCodeHints() 415
obtention de la liste 61, 71
ColdFusion Administrator 68
obtention du nom spécifique 61
test 70
fichiers 97
checkIn() 219
ColdFusion Component Explorer 227, 230
checkLinks() 220
collage 123
checkOut() 220
collapseFullTag() 203
mots de passe 63
checkSpelling() 262
collapseSelectedCodeFragment() 201
suppression 59
checkTargetBrowsers() 221, 262
collapseSelectedCodeFragmentInverse() 20
1, 205
chemin d'accès du dossier
Configuration 271
chemin d'accès du fichier local, conversion
en URI relative du site 213, 214
chemin d'accès du lecteur local
conversion depuis une URL de fichier 27
collpaseSelectedCodeFragment() 204
colonnes 72, 73
acquisition à partir de procédures
stockées 76
dans SQL SELECT 71
systèmes de commande source 93, 98
connexions aux bases de données 67
test de l'existence 66
connexions de bases de données
noms d'utilisateur 65
connexions JDBC 63
connexions nommées 62
procédures 74
jeux de résultats 76
contenu de page web, fonctions 288
largeurs dans la fenêtre de résultats 156
contenu de page, fonctions 288
document 271
noms 74
contenu des plug-ins
dossier Configuration 271
obtention à partir d'instructions 71, 72
dossier temporaire 272
obtention à partir de tables 73
navigateur secondaire 115
types 71
conversion en URL de fichier 24, 29
chemins d'accès
vers une application Flash MX 114
arrêt 384
lecture 381
contenu Flash, taille naturelle 43
conventions typographiques 6
conventions, dans le manuel 6
RÉFÉRENCE DES API DE DREAMWEAVER CS4 504
Index
conversion
chemin d'accès du fichier local en URI
relative du site 213
D
Data Manager 334
rétablissement 259
validation 264
dbi.setExpanded() 334
documents ouverts, liste 188
début de document 145
documents XHTML, nettoyage 247
de pixels en pourcentage 401
déconnexion des systèmes de commande
source 93
documents, fonctions globales 262
de pourcentage en pixels 402
decreaseColspan() 402
URI relative du site en chemin d'accès du
fichier local 214
dom
decreaseRowspan() 402
addBehavior() 296
URL de fichier en chemin d'accès du
lecteur local 27, 32
defineSites() 222
addJavaScript() 321
définition de connexion, fichier 88
align() 377
conversion en XHTML 248
deleteConnection() 59
applyCharacterMarkup() 421
conversions, fonctions 245
deleteHorizontalGuide() 395
applyCSSStyle() 357
convertActiveContent() 138
deleteKey() 141
applyFontMarkup() 422
convertLayersToTable() 245
deleteSelectedStyle() 365
applyLayout() 355
convertNextActiveContent() 139
deleteSelection() 222, 422, 434
applyTemplate() 310
convertTablesToLayers() 245
deleteTableColumn() 403
arrange() 377
convertToXHTML() 248
deleteTableRow() 403
arrowDown() 139
convertWidthsToPercent() 401
deleteVerticalGuide() 396
arrowLeft() 140
convertWidthsToPixels() 402
déplacement
arrowRight() 140
chemin d'accès du lecteur local en URL de
fichier 24, 29
doDeferredTableUpdate() 404
calques 378
arrowUp() 141
étapes de l'historique 132
point d'insertion 139, 140, 141
backspaceKey() 141
fichiers 7
zones réactives 378
browser.getSelection() 344
copie
deployFilesToTestingServerBin() 223
browser.getWindow() 345
Design Notes
browser.interactivityPaused 345
copy() 7
API C 28
browser.javaScriptEnabled 346
copyAssets() 322
longueur 104
canAlign() 463
copySteps() 132
structure des fichiers 23
canApplyLayout() 356
createDocument() 251
systèmes de commande source 104, 105
canApplyTemplate() 463
sélection 306
Copy() 150
createFolder() 8
detachFromLibrary() 310
canArrange() 464
createHorzontalGuide() 394
detachFromTemplate() 311
canClipCopyText() 464
createResultsWindow() 153
diminution
canClipPaste() 464
createVerticalGuide() 395
étendue de colonnes 402
canClipPasteText() 465
createXHTMLDocument() 252
étendue de lignes 402
canConvertLayersToTable() 465
createXMLDocument() 253
displaySyncInfoForFile() 223
canConvertTablesToLayers() 465
création
disposition
canDecreaseColspan() 466
documents 251
dossiers 8, 96
fenêtre de résultats 153
fichiers XML 253
panneaux flottants 384
div
bordures 387
divs
canDecreaseRowspan() 466
canDeleteTableColumn() 466
canDeleteTableRow() 467
canEditNoFramesContent() 467
CSS en balises HTML, conversion 245
bordures 389
canIncreaseColspan() 467
cssRuleTracker.canEditSelectedRule() 482
ID 387, 389
canIncreaseRowspan() 468
cssStyle.canEditSelectedStyle() 483, 484
mise en couleur 386, 388
canInsertTableColumns() 468
cssStylePalette.canApplySelectedStyle() 482
document, fonctions 245
canInsertTableRows() 468
cssStylePalette.canDeleteSelectedStyle() 483
documents
canMakeNewEditableRegion() 469
cssStylePalette.canDuplicateSelectedStyle()
483
création 251, 256
canMarkSelectionAsEditable() 469
début 145
canMergeTableCells() 469
cssStylePalette.canEditStyleSheet() 484
enregistrement 259, 260
canPlayPlugin() 470
cut() 151
fermeture 251
canRedo() 470
ouverture 256, 257
canRemoveEditableRegion() 470
canSelectTable() 471
RÉFÉRENCE DES API DE DREAMWEAVER CS4 505
Index
canSetLinkHref() 471
getBehavior() 296
getShowImageMaps() 163
canShowListPropertiesDialog() 471
getBlockElements() 326
getShowInvalidHTML() 163
canSplitFrame() 472
getCharSet() 423
getShowInvisibleElements() 163
canSplitTableCell() 472
getClickedHeaderColumn() 385
getShowLayerBorders() 164
canStopPlugin() 472
getDefaultAssetFolder() 323
getShowLayoutTableTabs() 385
canUndo() 473
getDesignViewMode() 341
getShowLayoutView() 386
checkSpelling() 262
getEditableRegionList() 311
getShowLineNumbers() 164
checkTargetBrowsers() 262
getEditNoFramesContent() 160
getShowNoscript() 441
cleanupXHTML() 247
getElementView() 358
getShowRulers() 164
clearGuides() 394
getFocus() 185
getShowSyntaxColoring() 165
clipCopy() 306
getFontMarkup() 423
getShowTableBorders() 165
clipCopyText() 306
getFrameNames() 375
getShowTableWidths() 404
clipCut() 306
getHeaderElements() 328
getShowToolbar() 165
clipPaste() 307
getHideAllVisualAids() 161
getShowToolbarIconLabels() 179
collapseSelectedCodeFragment() 201
getInlineElements() 327
getShowTracingImage() 166
collapseSelectedCodeFragmentInverse()
201
getIsLibraryDocument() 312
getShowWordWrap() 166
getIsTemplateDocument() 312
getSnapToGrid() 166
convertActiveContent() 138
getIsXHTMLDocument() 249
getTableExtent() 404
convertLayersToTable() 245
getLineFromOffset() 424
getTagSelectorTag() 458
convertNextActiveContent() 139
getLinkHref() 424
getTextAlignment() 425
convertTablesToLayers() 245
getLinkTarget() 424
getTextFormat() 426
convertToXHTML() 248
getListElements() 328
getToolbarIdArray() 180
convertWidthsToPercent() 401
getListTag() 425
getToolbarItemValue() 180
convertWidthsToPixels() 402
getLiveViewDefaultsToUsingServer() 34
3
getToolbarLabel() 181
getTracingImageOpacity() 380
createVerticalGuide() 395
getLiveViewDependentsUsingServer() 34
3
decreaseColspan() 402
getLiveViewUsingServer() 342
decreaseRowspan() 402
getMinDisplayWidth() 326
deleteHorizontalGuide() 395
getOpenPathName() 206
deleteKey() 141
getParseMode() 263
deleteSelection() 422
getPreventLayerOverlaps() 161
deleteTableColumn() 403
getRulerOrigin() 379
deleteTableRow() 403
getRulerUnits() 380
deleteVerticalGuide() 396
getSelectedEditableRegion() 312
detachFromLibrary() 310
getSelectedNode() 273
detachFromTemplate() 311
getSelection() 274
doDeferredTableUpdate() 404
getSelectorsDefinedInStylesheet() 274
dreamweaver.absoluteURLToDocRelativ
e() 270
getShowAutoIndent() 161
editAttribute() 422
getShowBlockBorders() 387
endOfDocument() 142
getShowBlockIDs() 387
endOfLine() 142
getShowBoxModel() 388
exitBlock() 423
getShowDivBackgrounds() 359
expandAllCodeFragments() 202
getShowDivBoxModel() 359
expandSelectedCodeFragments() 202
getShowDivOutlines() 360
formatRange() 441
getShowFrameBorders() 162
formatSelection() 441
getShowGrid() 162
getAttachedTemplate() 311
getShowHeadView() 162
getAutoValidationCount() 442
getShowHiddenCharacters() 207
copyAssets() 322
createHorizontalGuide() 394
getShowBlockBackgrounds() 386
getToolbarVisibility() 181
getView() 185
getWindowTitle() 186
guidesColor() 397
guidesDistanceColor() 397
guidesLocked 398
guidesSnapToElements 398
guidesVisible 399
hasCharacterMarkup() 426
hasGuides 399
hasHorizontalGuide() 400
hasTracingImage() 473
hasVerticalGuide() 400
hideInfoBar() 196
hideInfoMessagePopup() 263
increaseColspan() 405
increaseRowspan() 405
indent() 426
insertFiles() 119
insertHTML() 427
insertLibraryItem() 313
insertObject() 427
insertTableColumns() 405
insertTableRows() 406
insertText() 428
RÉFÉRENCE DES API DE DREAMWEAVER CS4 506
Index
isDesignViewUpdated() 442
serverModel.getServerName() 352
setSnapToGrid() 173
isDocumentInFrame() 375
setTableCellTag() 408
isRelatedFileViewOpen() 199
serverModel.getServerSupportsCharset()
352
isSelectionValid() 443
serverModel.getServerVersion() 353
setTableRows() 409
loadTracingImage() 381
serverModel.testAppServer() 353
setTextAlignment() 433
makeSizesEqual() 378
setAttributeWithErrorChecking() 430
setTextFieldKind() 433
markSelectionAsEditable() 313
setDesignViewMode() 342
setTextFormat() 434
mergeTableCells() 406
setEditNoFramesContent() 167
setToolbarItemAttribute() 182
moveSelectionBy() 378
setElementView() 361
setToolbarPosition() 183
newBlock() 428
setHideAllVisualAids() 167
setToolbarVisibility() 184
newEditableRegion() 314
setLayerTag() 379
setTracingImageOpacity() 383
nextParagraph() 143
setLinkHref() 431
setTracingImagePosition() 382
nextWord() 143
setLinkTarget() 431
setView() 186
nodeToOffsets() 275
setListBoxKind() 432
showFontColorDialog() 434
notifyFlashObjectChanged() 429
setListTag() 433
showInfoBar() 195
offsetsToNode() 275
setLiveViewDependentsUsingServer() 34
3
showInfoMessagePopup() 265
outdent() 429
pageDown() 143
pageUp() 144
playAllPlugins() 381
playPlugin() 381
previousParagraph() 144
previousWord() 145
reapplyBehaviors() 297
redo() 128
removeAllTableHeights() 407
removeAllTableWidths() 407
removeBehavior() 297
removeCharacterMarkup() 429
removeColumnWidth() 407
removeCSSStyle() 360
removeEditableRegion() 314
removeFontMarkup() 430
resetAllElementViews() 361
resizeSelection() 430
resizeSelectionBy() 378
runTranslator() 283
runValidation() 263
saveAllFrames() 376
selectAll() 276
selectChild() 438
selectParent() 439
selectTable() 408
serverModel.getAppURLPrefix() 349
serverModel.getDelimiters() 349
serverModel.getDisplayName() 350
serverModel.getFolderName() 350
serverModel.getServerIncludeUrlPattern
s() 350
serverModel.getServerInfo() 351
setTableColumns() 409
setLiveViewUsingServer() 342
showInsertTableRowsOrColumnsDialog
() 409
setPreventLayerOverlaps() 167
showListPropertiesDialog() 432
setRulerOrigin() 382
showLiveViewParamatersDialog() 344
setRulerUnits() 382
showPagePropertiesDialog() 266
setSelectedNode() 276
snapToGuides() 401
setSelection() 277
snapTracingImageToSelection() 383
setShowBlockBackgrounds() 388
source.applyComment() 207
setShowBlockBorders() 389
source.arrowDown() 443
setShowBlockIDs() 389
source.arrowLeft() 444
setShowBoxModel() 390
source.arrowRight() 444
setShowDivBackgrounds() 362
source.arrowUp() 445
setShowDivBoxModel() 362
source.balanceBracesTextView() 445
setShowDivOutlines() 363
source.doCodeNavItem() 446
setShowFrameBorders() 168
source.endOfDocument() 446
setShowGrid() 168
source.endOfLine() 446
setShowHeadView() 168
source.endPage() 447
setShowHiddenCharacters() 207
source.getCurrentLines() 447
setShowImageMaps() 169
source.getLineFromOffset() 448
setShowInvalidHTML() 169
source.getSelection() 448
setShowInvisibleElements() 170
source.getText() 448
setShowLayerBorders() 170
setShowLayoutTableTabs() 390
source.getValidationErrorsForOffset() 44
9
setShowLayoutView() 390
source.indentTextView() 449
setShowLineNumbers() 170
source.insert() 450
setShowNoscript() 443
source.nextWord() 450
setShowRulers() 171
source.outdentTextView() 451
setShowSyntaxColoring() 171
source.pageDown() 451
setShowTableBorders() 171
source.pageUp() 451
setShowTableWidths() 408
source.previousWord() 452
setShowToolbar() 172
source.refreshVariableCodeHints() 208
setShowToolbarIconLabels() 182
source.removeComment() 208
setShowTracingImage() 172
source.replaceRange() 452
setShowWordWrap() 172
source.scrollEndFile() 453
RÉFÉRENCE DES API DE DREAMWEAVER CS4 507
Index
source.scrollLineDown() 453
Dreamweaver
canClipCut() 474
source.scrollLineUp() 453
affichage au premier plan 35
canClipPaste() 475
source.scrollPageDown() 454
sortie 121
canDeleteSelection() 475
source.scrollPageUp() 454
dreamweaver
canExportTemplateDataAsXML() 475
source.scrollTopFile() 454
activateApp() 119
canFindNext() 476
source.selectParentTag() 455
activeViewScale 391
canFitSelection() 476
source.setCurrentLine() 455
arrangeFloatingPalettes() 384
canOpenInFrame() 476
source.startOfDocument() 455
assetPalette.addToFavoritesFromDocum
ent() 288
canPasteSpecial() 477
assetPalette.addToFavoritesFromSiteAss
ets() 288
canPopupEditTagDialog() 477
splitFrame() 376
assetPalette.addToFavoritesFromSiteWin
dow() 289
canRevertDocument() 478
splitTableCell() 410
assetPalette.canEdit() 473
canSaveAll() 478
startOfDocument() 145
assetPalette.canInsertOrApply() 474
canSaveDocument() 479
startOfLine() 145
assetPalette.canUpdateSmartObjectFrom
Original() 54
canSaveDocumentAsTemplate() 479
stopAllPlugins() 384
stopPlugin() 384
assetPalette.copyToSite() 289
canSaveFramesetAs() 480
stripTag() 439
assetPalette.edit() 290
canSelectAll() 480
synchronizeDocument() 457
assetPalette.getSelectedCategory() 290
canShowFindDialog() 481
undo() 129
assetPalette.getSelectedItems() 290
canUndo() 481
updateCurrentPage() 314
assetPalette.getSelectedView() 291
wrapTag() 439
source.startOfLine() 456
source.topPage() 456
source.wrapSelection() 457
canPlayRecordedCommand() 477
canRedo() 478
canSaveFrameset() 479
assetPalette.insertOrApply() 291
canUpdateSmartObjectFromOriginal() 5
7
DOM, obtention 254
assetPalette.locateInSite() 292
canZoom() 481
dom.browser.getStatusText() 344
assetPalette.newAsset() 292
cascade() 187
dom.browser.javaScriptEnabled 346
assetPalette.newFolder() 292
clipCopy() 308
dom.collapseFullTag() 200
clipCut() 308
dom.collapseFullTagInverse() 200
assetPalette.recreateLibraryFromDocume
nt() 293
Données dynamiques, boîte de dialogue 122
assetPalette.refreshSiteAssets() 293
closeDocument() 251
Dossier Configuration/Temp 17, 18, 19
assetPalette.removeFromFavorites() 293
codeHints.addFunction() 413
dossier _notes 23
assetPalette.renameNickname() 294
codeHints.addMenu() 411
dossier racine local 272
assetPalette.setSelectedCategory() 294
codeHints.resetMenu() 414
dossiers
assetPalette.setSelectedView() 295
codeHints.showCodeHints() 415
assetPalette.updateSmartObjectFromOri
ginal() 55
compareFiles() 214
beep() 120, 123, 213, 214, 242
createResultsWindow() 153
behaviorInspector.getBehaviorAt() 300
createXHTMLDocument() 252
behaviorInspector.getBehaviorCount() 3
00
createXMLDocument() 253
_mmServerScripts 17
archivage 100
archivage et extraction de systèmes de
commande source 101
configuration 7
Configuration/Temp 17, 18, 19
contenu 12
création 8, 96
obtention des attributs 9
placement 96
suppression 17, 96
système de commande source 94, 95
test de l'existence 97
dossiers transmis, fichiers 95
doURLDecoding() 266
doURLEncoding() 279
behaviorInspector.getSelectedBehavior()
301
behaviorInspector.moveBehaviorDown()
301
clipPaste() 308
createDocument() 251
cssRuleTracker.canEditSelectedRule() 48
2
cssRuleTracker.editSelectedRule() 363
cssRuleTracker.newRule() 364
behaviorInspector.moveBehaviorUp() 30
3
cssStyle.canEditSelectedStyle() 483, 484
behaviorInspector.setSelectedBehavior()
304
cssStylePalette.canApplySelectedStyle() 4
82
bringAttentionToFloater() 186
cssStylePalette.canDeleteSelectedStyle() 4
83
browseDocument() 112
browseForFileURL() 249
browseForFolderURL() 250
canClipCopy() 474
cssStylePalette.applySelectedStyle() 364
cssStylePalette.canDuplicateSelectedStyle
() 483
cssStylePalette.canEditStyleSheet() 484
cssStylePalette.deleteSelectedStyle() 365
RÉFÉRENCE DES API DE DREAMWEAVER CS4 508
Index
cssStylePalette.duplicateSelectedStyle() 3
65
getExternalTextEditor() 114
historyPalette.saveAsCommand() 135
getExtGroups() 336
historyPalette.setSelectedSteps() 136
cssStylePalette.editSelectedStyle() 366
getExtParticipants() 335
historyPalette.setUndoState() 136
cssStylePalette.editSelectedStyleInCodevi
ew() 366
getFlashPath() 114
htmlInspector.collapseFullTag() 203
getFloatersVisible() 188
htmlInspector.collapseSelectedCodeFrag
ment() 204
cssStylePalette.editStyleSheet() 367
cssStylePalette.getDisplayStyles() 367
cssStylePalette.getMediaType() 368
cssStylePalette.getSelectedStyle() 368
cssStylePalette.getStyles() 369
cssStylePalette.newStyle() 370
cssStylePalette.renameSelectedStyle() 370
cssStylePalette.setDisplayStyles() 371
cssStylePalette.setMediaType() 371
dbi.getDataSources() 333
deleteSelection() 434
doURLDecoding() 266
doURLEncoding() 279
editCommandList() 246
editFontList() 435
editLockedRegions() 283
exportTemplateDataAsXML() 253
findNext() 416
fitAll() 391
fitSelection 392
fitWidth() 392
flash.controlExists 53
flash.evalScript() 51
flash.executeScript() 52
flash.newControl() 45
flash.requestStateChange() 47
flash.setMenu() 50
getActiveRelatedFilePath() 197
getActiveWindow() 187
getAppBarColor() 211
getBehaviorElement() 298
getBehaviorTag() 299
getBlockVisBoxModelColors() 372
getBlockVisOutlineProperties() 372
getBrowserList() 113
getClipboardText() 309
getConfigurationPath() 271
getDivBackgroundColors() 373
getDocumentDOM() 254
getDocumentList() 187
getDocumentPath() 271
getElementRef() 266
getExtDataArray() 335
getExtDataValue() 334
getExtensionEditorList() 113
getFloaterVisibility() 188
getFocus() 189
getFontList() 435
getFontStyles() 436
getHideAllFloaters() 173
htmlInspector.collapseSelectedCodeFrag
mentInverse() 205
htmlInspector.expandAllCodeFragments
() 205
getImageHeight() 56
htmlInspector.expandSelectedCodeFrag
ments() 206
getImageWidth() 56
htmlInspector.getShowAutoIndent() 174
getKeyState() 436
htmlInspector.getShowHiddenCharacter
s() 209
getLiveDataInitTags() 337
getLiveDataMode() 337
getLiveDataParameters() 337
getMenuNeedsUpdating() 146
getNaturalSize() 436
htmlInspector.getShowHighlightInvalid
HTML() 174
htmlInspector.getShowLineNumbers() 1
75
getNewDocumentDOM() 255
htmlInspector.getShowSyntaxColoring()
175
getPanelColor() 210
htmlInspector.getShowWordWrap() 175
getParticipants() 347
htmlInspector.setShowAutoIndent() 176
getPreferenceInt() 267
htmlInspector.setShowHiddenCharacters
() 210
getPreferenceString() 268
getPrimaryBrowser() 115
getPrimaryExtensionEditor() 115
getPrimaryView() 190, 198
getRecentFileList() 255
htmlInspector.setShowHighightInvalidH
TML() 176
htmlInspector.setShowLineNumbers() 1
76
getRedoText() 129
htmlInspector.setShowSyntaxColoring()
177
getRelatedFiles() 196
htmlInspector.setShowWordWrap() 177
getSecondaryBrowser() 115
htmlStylePalette.canEditSelection() 485
getServerModels() 354
importXMLIntoTemplate() 256
getShowDialogsOnInsert() 121
isRecording() 485
getShowStatusBar() 174
isReporting() 212
getSiteRoot() 272
latin1ToNative() 280
getSmartObjectOriginalWidth() 56
liveDataTranslate() 338
getSmartObjectState() 55
loadSitesFromPrefs() 215
getSnapDistance() 190
mapKeyCodeToChar() 146
getSplitViewOrientation() 197
minimizeRestoreAll() 191
getSystemFontList() 437
nativeToLatin1() 280
getTempFolderPath() 272
newDocument() 256
getTokens() 279
newFromTemplate() 256
getTranslatorList() 284
nodeExists() 277
getUndoText() 129
notifyMenuUpdated() 147
historyPalette.clearSteps() 132
objectPalette.getMenuDefault() 137
historyPalette.copySteps() 132
objectPalette.setMenuDefault() 137
historyPalette.getSelectedSteps() 133
objet behaviorInspector 296
historyPalette.getStepCount() 133
objet cssStylePalette 355
historyPalette.getStepsAsJavaScript() 134
objet historyPalette 128
historyPalette.getUndoState() 135
objet libraryPalette 310
historyPalette.replaySteps() 135
objet templatePalette 310
RÉFÉRENCE DES API DE DREAMWEAVER CS4 509
Index
openDocument() 257
revertDocument() 259
siteSyncDialog.canMarkGet() 489
openDocumentFromSite() 257
runCommand() 246
siteSyncDialog.canMarkIgnore() 489
openInFrame() 258
saveAll() 259
siteSyncDialog.canMarkPut() 490
openRelatedFile() 197
saveDocument() 260
siteSyncDialog.canMarkSynced() 490
openWithApp() 117
saveDocumentAs() 260
siteSyncDialog.compare() 215
openWithBrowseDialog() 117
saveDocumentAsTemplate() 261
siteSyncDialog.markDelete() 216
openWithExternalTextEditor() 118
saveFrameset() 261
siteSyncDialog.markGet() 216
openWithImageEditor() 118
saveFramesetAs() 261
siteSyncDialog.markIgnore() 217
playRecordedCommand() 130
saveSitesToPrefs() 215
siteSyncDialog.markPut() 217
popupAction() 299
scanSourceString() 281
siteSyncDialog.markSynced() 217
popupEditTagDialog() 459
selectAll() 278
siteSyncDialog.toggleShowAllFiles() 218
popupInsertTagDialog() 458
serverBehaviorInspector.getServerBehavi
ors() 347
snippetpalette.canEditSnippet() 490
serverComponents.getSelectedNode() 33
2
snippetPalette.editSnippet() 317
popupServerBehavior() 348
PrintCode() 437
printDocument() 120
snippetpalette.canInsert() 491
serverComponents.refresh() 332
snippetPalette.getCurrentSnippetPath() 3
16
setActiveWindow() 191
snippetPalette.insert() 317
setBlockVisOutlineProperties() 373
snippetPalette.insertSnippet() 318
setDivBackgroundColors() 374
snippetPalette.newFolder() 316
setFloaterVisibility() 191
snippetPalette.newSnippet() 317
setHideAllFloaters() 177
snippetPalette.remove() 319
setLiveDataError() 339
snippetPalette.rename() 318
setLiveDataMode() 340
startRecording() 131
setLiveDataParameters() 340
stopRecording() 131
setPreferenceInt() 268
setPreferenceString() 269
stylePalette.attachExternalStylesheet() 36
5
setPrimaryView() 193, 199
tagLibrary.getImportedTagList() 461
setShowStatusBar() 178
tagLibrary.getSelectedLibrary() 460
setSnapDistance() 193
tagLibrary.getSelectedTag() 460
setSplitViewOrientation() 198
tagLibrary.getTagLibraryDOM() 460
resultsPalette.canClear() 486
setUpComplexFind() 417
tagLibrary.importDTDOrSchema() 461
resultsPalette.canCopy() 486
setUpComplexFindReplace() 418
tileHorizontally() 194
resultsPalette.canCut() 486
setUpFind() 419
tileVertically() 194
resultsPalette.canOpenInBrowser() 487
setUpFindReplace() 419
toggleFloater() 195
resultsPalette.canOpenInEditor() 487
showAboutBox() 122
undo() 131
resultsPalette.canPaste() 487
showDynamicData() 122
updatePages() 315
resultsPalette.canSave() 488
showFindDialog() 420
updateReference() 195
resultsPalette.canSelectAll() 488
showFindReplaceDialog() 421
updateSmartObjectFromOriginal() 57
resultsPalette.clear() 150
showGridSettingsDialog() 385
useTranslatedSource() 284
resultsPalette.Copy() 150
showLiveDataDialog() 341
validateFlash() 119
resultsPalette.cut() 151
showPreferencesDialog() 123
zoomIn() 393
resultsPalette.debugWindow.addDebugC
ontextData() 159
showProperties() 193
resultsPalette.openInBrowser() 151
showReportsDialog() 212
resultsPalette.openInEditor() 152
showResults() 148
resultsPalette.paste() 151
showTagChooser() 124, 459
dreamweaver.absoluteURLToDocRelative()
270
resultsPalette.save() 152
showTagLibraryEditor() 459
dreamweaver.cssStylePalette
resultsPalette.selectAll() 153
showTargetBrowsersDialog() 270
resultsPalette.siteReports.addResultItem(
) 149
siteSyncDialog.canCompare() 488
quitApplication() 121
redo() 130
referencePalette.getFontSize() 295
referencePalette.setFontSize() 295
refreshExtData() 336
relativeToAbsoluteURL() 273
releaseDocument() 258
reloadCodeColoring() 415
reloadMenus() 147
reloadObjects() 138
reloadToolbars() 184
replace() 416
replaceAll() 417
resolveOriginalAssetFileURLToAbsolute
LocalFilePath() 57
revealDocument() 120
showQuickTagEditor() 440
siteSyncDialog.canMarkDelete() 489
zoomOut() 393
Dreamweaver et commande source
intégration 91
canRenameSelectedStyle() 485
dreamweaver.cssStylePalette.canRenameSel
ectedStyle() 485
dreamweaver.flash.controlEvent() 49
RÉFÉRENCE DES API DE DREAMWEAVER CS4 510
Index
dreamweaver.resultsPalette.bcc 148
getListElements() 328
DSN ODBC 63, 65
isBlockElement() 329
existence, connexions aux bases de
données 66
DSN, ODBC 63, 65
isHeaderElement() 330
exists() 8
duplicateSelectedStyle() 365
isInlineElement() 330
exitBlock() 423
duplication de styles 365
isListElement() 331
expandAllCodeFragments() 202, 205
dw
element
expandSelectedCodeFragments() 202, 206
browseInBridge() 127
getTranslatedAttribute() 319
exportSite() 224
dbi.setExpanded() 334
getTranslatedClassName 320
exportTemplateDataAsXML() 253
getFilesForLayout() 356
removeTranslatedAttribute() 319
Extension Data Manager 334
getLayoutDescriptions() 357
setTranslatedAttribute() 320
extraction de fichiers 101
getLayoutNames() 357
translatedStyle 321
registerIdleHandler() 124
élément sélectionné du document actif 185
revokeIdleHandler() 125
DWfile, DLL 7
éléments de bibliothèque et modèles,
fonctions 310
DWfile.copy() 7
éléments de menu
annulation 101
nombres 102
F
favoris, liste
ajout 288, 289
DWfile.createFolder() 8
Annuler 132
DWfile.exists() 8
Annuler l'extraction 108
DWfile.getAttributes() 9
Archiver 107
DWfile.getCreationDate() 10
Nouveau dossier 108
ajout 153
DWfile.getCreationDateObj() 11
Renommer 109
appel de 156
DWfile.getModificationDate() 9
Rétablir 132
boutons définis 155
DWfile.getModificationDateObj() 11
Supprimer 109
création 153
suppression d'éléments 294
fenêtre de résultats
DWfile.getSize() 12
éléments de plug-in, lecture 381
définition de l'élément sélectionné 157
DWfile.listFolder() 12
endOfDocument() 142, 446
fonctions 148
DWfile.read() 13
endOfLine() 142, 446
largeurs de colonnes 156
DWfile.remove() 13
endPage() 447
récupération d'un tableau d'éléments 154
DWfile.setAttributes() 14
enregistrement
documents 259, 260
récupération de l'index de l'élément
sélectionné 155
étapes de l'historique 135
récupération du nombre d'éléments 155
fichiers Design Notes 24
titre 157
DWfile.write() 15
E
échelle de l'affichage 391
editAttribute() 422
editColumns() 224
editCommandList() 246
éditeur d'image 118
environnement de mise en forme,
fonctions 379
envoi
données 21
texte 22
traitement des fichiers 157, 158
fenêtres
cascade 187
réduction 191
fenêtres de document en cascade 187
envoi HTTP 21, 22
fenêtres, fonctions 185
éditeur de texte, externe 114
équivalent JavaScript, étapes de
l'historique 134
fermeture
éditeurs, listes des 113
étapes
éditeur de texte externe 114, 118
editFontList() 435
editLockedRegions() 283
editSelectedRule() 363
editSelectedStyle() 366
editSnippet() 317
documents 251
fichiers Design Notes 24, 28
dans le panneau Historique 133
feuilles de style 365
enregistrement 135
feuilles de style en cascade en balises HTML,
conversion 245
étapes d'historique
équivalent JavaScript 134
étapes de l'historique
fichier
inclus, généré 87
editStyleSheet() 367
copie 132
effacement du panneau Historique 132
reproduction 135
génération 42
elem
sélection 136
lecture 44
fichier d'objet Flash
getBlockElements() 326
étendue de colonnes, diminution 402
getComputedStyleProp() 324
étendue de lignes, diminution 402
fichier de définition, pour type de
connexion 88
getHeaderElements() 328
execJsInFireworks() 36
fichier EDML, fonctions 334
getInlineElements() 327
fichier menus.xml 147
RÉFÉRENCE DES API DE DREAMWEAVER CS4 511
Index
fichiers
fermeture 28
barre d'outils 179
aide 116
nombre de paires clé/valeur 30
barre d'outils du mode Code 206
annulation de l'extraction 101
obtention de la clé 24
bascule 160
archivage 100, 111
ouverture 27, 33
bibliothèque de balises 458
attributs 14
paires clé/valeur 25
bibliothèque et modèles 310
changement de nom 97
racine du site 26, 31
cadres et jeux de cadres 375
comparaison 214
suppression de clés 27, 33
calques et cartes d'images 377
connection_includefile.edml 88
fichiers distants 105
chemins 270
copie 7
fichiers en lecture seule 14
clavier 139
création (fichiers HTML) 251
fichiers inclus
code 411
création (fichiers non HTML) 15
ASP et JavaScript 88
commandes 246
création (fichiers XHTML) 252
ColdFusion 88
comportements 296
création (fichiers XML) 253
définition du type de connexion 88
comportements de serveur 347
générés 87
composants de serveur 332
dans les dossiers transmis 95
écriture 15
écriture de chaînes 15
fichiers inclus générés
ASP et JavaScript 88
conversion 245
document, globales 262
éditeur principal 115
fichiers masqués 14
éditeur de balises 458
enregistrement 18, 19
fichiers visibles 14
édition générale 421
extraction 101
fichiers XML
environnement de mise en forme 379
extraits 102
création 253
extension data manager 334
fenêtre de résultats 157
fragments de code 316
fenêtre 185
importation 256
fenêtre de résultats 148
fragments de code 316
heure de création 10
FilePathToLocalURL() 29
fractionnement des codes 200
heure de modification 10
findConnection() 85
historique 128
lecture 13
findNext() 416
impression 437
lecture du contenu dans une chaîne 13
Fireworks
insertion d'objets 137
nombre d'extraits 102
affichage au premier plan 35
insertion de widgets Spry 321
obtention des attributs 9
exécution de JavaScript 36
live data 336
obtention du contenu 20
session d'optimisation 37, 38
manipulations de chaînes 279
ouverture dans l'application spécifiée 117
transmission de JavaScript 36
manipulations de fichiers 247
ouverture dans l'éditeur d'image
spécifié 118
version 38
menu 146
fitall() 391
mises en forme CSS 355
placement 96, 111
fitSelection() 392
mode Code 440
récents 255
fitWidth() 392
mode de Mise en forme 385
suppression 13, 17, 96
Flash MX, définition de version 119
modèle de serveur 348
systèmes de commande source 95
Flash, chemin vers 114
modification de widgets Spry 319
taille 12
flash.controlEvent() 49
modification des tableaux 401
test de l'existence 8, 97
flash.controlExists 53
nouveautés dans Dreamweaver CS4 2
traitement 158
flash.evalScript() 51
panneau Actifs 288
fichiers accessibles en écriture 14
flash.executeScript() 52
panneau Fragments de code 315
fichiers apparentés, fonctions 196
flash.newControl() 45
presse-papiers 306
fichiers d'aide, ouverture 116
flash.requestStateChange() 47
Quick Tag Editor 438
fichiers de configuration 7
flash.setMenu() 50
rapports 212
fichiers de configuration userxd5 s 7
fonction d'activateur, présentation 463
recherche/remplacement 416
fichiers de définition de type de connexion
de bases de données 88
fonctionnalités, systèmes de commande
source 99
repère 394
fichiers Design Notes
fonctions
sites 213
sélection 273
clés 25, 29
activateur 463
création de paires clé/valeur 28, 34
source de données 333
application externe 112
enregistrement 24
supprimées dans CS4 4
application, globales 120
traduction 283
RÉFÉRENCE DES API DE DREAMWEAVER CS4 512
Index
transfert du contenu de fichiers 20
fonctions relatives aux applications
getColumnAndTypeList() 71
vérification de la compatibilité avec les
navigateurs 324
communication avec Bridge 125
getColumnList() 72
externes 112
getColumns() 72
XSLT 284
globales 120
getColumnsOfTable() 73
zooms 391
fonctions de code
fonctions relatives aux rapports 212
getComputedStyleProp() 324
fonctions relatives aux zooms 391
getConfigurationPath() 271
indicateurs de code et coloration 411
fonctions supprimées 4
getConnection() 60
mode Code 440
formatRange() 441
getConnectionList() 61
panneau Fragments de code 315
formatSelection() 441
getConnectionName() 61
formulaires, envoi 21, 22
getConnectionState() 229
fractionnement de cadres 376
getConnectionString() 62
FTP, connexion 148
getCreationDate() 10
FWLaunch.bringDWToFront() 35
getCreationDateObj() 11
FWLaunch.bringFWToFront() 35
getCurrentLines() 447
FWLaunch.execJsInFireworks() 36
getCurrentSite() 230
FWLaunch.getJsResponse() 36
getDataSources() 333
FWLaunch.mayLaunchFireworks() 37
getDeclaredStyle() 325
Fonctions de la barre d'information 195
FWLaunch.optimizeInFireworks() 38
getDefaultAssetFolder() 323
fonctions de menu
FWLaunch.validateFireworks() 38
getDelimiters() 349
fonctions de communication avec
Bridge 125
fonctions de comportements
serveur 347
fonctions de document dynamiques 332
fonctions de l'API d'espace de travail
à propos 128
fonctions de l'éditeur de balises et de la
bibliothèque de balises 458
imitation à l'aide de fonctions live
data 336
getDesignViewMode() 341
G
génération de fichiers d'objet Flash 42
getDisplayName() 350
Gestionnaire de connexions 61, 67, 69
getDocumentDOM() 254
get() 226
getDocumentList() 187
fonctions de repère 394
getActiveRelatedFilePath() 197
getDocumentPath() 271
fonctions de sélection
getActiveWindow() 187
getDriverName() 63
dans les documents ouverts 273
getAppBarColor() 211
getDynamicBindings() 58
dans le panneau Site 213
getAppServerAccessType() 227
getEditableRegionList() 311
getAppServerPathToFiles() 227
getEditNoFramesContent() 160
getAppURLPrefix() 349
getElementRef() 266
getAppURLPrefixForSite() 228
getExtDataArray() 335
getAttachedTemplate() 311
getExtDataValue() 334
getAttributes() 9
getExtensionEditorList() 113
getAutoValidationCount() 442
getExternalTextEditor() 114
getBehavior() 296
getExtGroups() 336
getBehaviorAt() 300
getExtParticipants() 335
getBehaviorCount() 300
getFile() 18
getBehaviorElement() 298
getFileCallback() 19
getBehaviorTag() 299
getFilesForLayout() 356
getBlockElements() 326
getFlashPath() 114
getBlockVisBoxModelColors() 372
getFloatersVisible() 188
getBlockVisOutlineProperties() 372
getFloaterVisibility() 188
getBrowserList() 113
getFocus() 185, 189, 230
Fonctions du mode Fractionnement
vertical 197
getCharSet() 423
getFolderName() 350
getCheckOutUser() 228
getFontList() 435
fonctions du panneau Actifs (palette) 288
getCheckOutUserForFile() 228
getFontMarkup() 423
Fonctions du panneau Fragments de
code 315
getClickedHeaderColumn() 385
getFontStyles() 436
getClipboardText() 309
getFrameNames() 375
Fonctions relatives au mode En direct 341
getCloakingEnabled() 229
getHeaderElements() 328
getColdFusionDsnList() 60
getHideAllFloaters() 173
fonctions de menus
optimisation et rechargement de
menus 146
fonctions de vérification de la compatibilité
avec les navigateurs 324
fonctions des Design Notes
MMNotes.close() 24
MMNotes.filePathToLocalURL() 24
MMNotes.get() 24
MMNotes.getKeyCount() 25
MMNotes.getKeys() 25
MMNotes.getSiteRootForFile() 26
MMNotes.getVersionName() 26
MMNotes.getVersionNum() 26
MMNotes.localURLToFilePath() 27
fonctions des menus
menu Commande 246
Fonctions des panneaux et des boîtes de
dialogue de Flash 45
getDivBackgroundColors() 373
RÉFÉRENCE DES API DE DREAMWEAVER CS4 513
Index
getHideAllVisualAids() 161
getPrimaryView() 190, 198
getShowTableBorders() 165
getImageHeight() 56
getProcedures() 74
getShowTableWidths() 404
getImageWidth() 56
getRdsPassword() 64
getShowToolbar() 165
getImportedTagList() 461
getRdsUserName() 64
getShowToolbarIconLabels() 179
getInlineElements() 327
getRecentFileList() 255
getShowToolTips() 178
getIsLibraryDocument() 312
getRedoText() 129
getShowTracingImage() 166
getIsTemplateDocument() 312
getRelatedFiles() 196
getShowWordWrap() 166
getIsXHTMLDocument() 249
getRemoteDsnList() 64
getSiteForURL() 231
getItem() 148, 154
getRulerOrigin() 379
getSiteRoot() 272
getItemCount() 148, 155
getRulerUnits() 380
GetSiteRootForFile() 31
getJsResponse() 36
getRuntimeConnectionType() 65
getSiteRootForURL() 232
getKeyState() 436
getSecondaryBrowser() 115
getSites() 232
getLayoutDescriptions() 357
getSelectedBehavior() 301
getSiteURLPrefix() 233
getLayoutNames() 357
getSelectedEditableRegion() 312
getSize() 12
getLineFromOffset() 424, 448
getSelectedItem() 148
getSmartObjectOriginalWidth() 56
getLinkHref() 424
getSelectedLibrary() 460
getSmartObjectState() 55
getLinkTarget() 424
getSelectedNode() 273, 332
getSnapDistance() 190
getListElements() 328
getSelectedSteps() 133
getSnapToGrid() 166
getListTag() 425
getSelectedStyle() 368
getSPColumnList() 76
getLiveDataInitTags() 337
getSelectedTag() 460
getSPColumnListNamedParams() 76
getLiveDataMode() 337
getSelection() 231, 274, 448
getSplitViewOrientation() 197
getLiveDataParameters () 337
getSelectorDefinedInStylesheet() 274
getSPParameters() 77
getLiveViewDependentsUsingServer() 343
getServerBehaviors() 347
getSPParamsAsString() 78
getLiveViewUsingServer() 342
getServerIncludeUrlPatterns() 350
getStepCount() 133
getLocalDsnList() 63
getServerInfo() 351
getStepsAsJavaScript() 134
getLocalPathToFiles() 230
getServerModels() 354
getStyles() 369
getLocalRootURL() 231
getServerName() 352
getSystemFontList() 437
getMediaType() 368
getServerSupportsCharset() 352
getTableExtent() 404
getMenuDefault() 137
getServerVersion() 353
getTables() 79
getMenuNeedsUpdating() 146
getShowAutoIndent() 161
getTagLibraryDOM() 460
getMinDisplayWidth() 326
getShowBlockBackgrounds() 386
getTagSelectorTag() 458
getModificationDate() 9
getShowBlockBorders() 387
getTempFolderPath() 272
getModificationDateObj() 11
getShowBlockIDs() 387
getText() 448
getNaturalSize() 436
getShowBoxModel() 388
getTextAlignment() 425
getNewDocumentDOM() 255
getShowDialogsOnInsert() 121
getTextCallback() 20
GetNote() 29
getShowFrameBorders() 162
getTextFormat() 426
GetNoteLength() 30
getShowGrid() 162
getTokens() 279
GetNotesKeyCount() 30
getShowHeadView() 162
getToolbarIdArray() 180
GetNotesKeys() 30
getShowHiddenCharacters() 207, 209
getToolbarItemValue() 180
getOpenpathName() 206
getShowImageMaps() 163
getToolbarLabel() 181
getPanelColor() 210
getShowInvalidHTML() 163
getToolbarVisibility() 181
getParseMode() 263
getShowInvisibleElements() 163
getTracingImageOpacity() 380
getParticipants() 347
getShowLayerBorders() 164
getTranslatedAttribute() 319
getPassword() 63
getShowLayoutTableTabs() 385
getTranslatedClassName 320
getPreferenceInt() 267
getShowLayoutView() 386
getTranslatorList() 284
getPreferenceString() 268
getShowLineNumbers() 164
getUndoState() 135
getPreventLayerOverlaps() 161
getShowNoscript() 441
getUndoText() 129
getPrimaryBrowser() 115
getShowRulers() 164
getUserName() 65
getPrimaryExtensionEditor() 115
getShowStatusBar() 174
getValidationErrorsForOffset() 449
getPrimaryKeys() 74
getShowSyntaxColoring() 165
GetVersionName() 32
RÉFÉRENCE DES API DE DREAMWEAVER CS4 514
Index
GetVersionNum() 32
getView() 185
getViews() 79
getWindowTitle() 186
getXML() 285
htmlInspector.getShowHiddenCharacters()
209
htmlInspector.getShowHighlightInvalidHT
ML() 174
htmlInspector.getShowLineNumbers() 175
instructions SQL 80
affichage des résultats 80
obtention de colonnes 71, 72
Intégration de Photoshop 54
interactivityPaused 345
getXMLSchema() 285
htmlInspector.getShowSyntaxColoring() 17
5
getXMLSourceURI() 286
htmlInspector.getShowWordWrap() 175
isCloaked() 233
groupes de fichiers 109, 110
htmlInspector.setShowAutoIndent() 176
isDesignViewUpdated() 442
guides
htmlInspector.setShowHiddenCharacters()
210
isDocumentInFrame() 375
isInlineElement() 330
guidesDistanceColor() 397
htmlInspector.setShowHighlightInvalidHT
ML() 176
guidesLocked 398
htmlInspector.setShowLineNumbers() 176
isRecording() 485
guidesSnapToElements 398
htmlInspector.setShowSyntaxColoring() 17
7
isRelatedFileViewOpen() 199
verrouillage 398
guidesColor() 397
guidesVisible 399
H
hasCharacterMarkup() 426
hasConnectionWithName() 66
hasGuides() 399
hasHorizontalGuide() 400
hasTracingImage() 473
hasVerticalGuide() 400
heure de création
fichier 10
heure de modification
fichier 10
hideInfoBar() 196
hideInfoMessagePopup() 263
historique, fonctions 128
Historique, panneau 132, 133
étapes 133
HTML
balise 379
connexions 87
conversion en XHTML 248
création de nouveaux documents 251
feuilles de style en cascade 245
insertion 427
non valide, affichage 163
HTML non valide 161, 163, 176
htmlInspector.collapseFullTag() 203
htmlInspector.collapseSelectedCodeFragme
nt() 204
htmlInspector.setShowWordWrap() 177
I
identificateur unique 74
importDTDOrSchema() 461
importSite() 233
importXMLIntoTemplate() 256
increaseColspan() 405
increaseRowspan() 405
indent() 426
indentTextView() 449
indicateurs, code 411
informations de connexion, RDS 66, 69
informations relatives aux documents 254
insert() 317, 450
insertFiles() 119
insertHTML() 427
insertion
balises 124
chaîne dans un document 122
insertion d'objets, fonctions 137
insertLibraryItem() 313
insertObject() 427
insertSnippet() 318
insertTableColumns() 405
insertTableRows() 406
insertText() 428
inspectConnection() 86
inspecteur de code
htmlInspector.collapseSelectedCodeFragme
ntInverse() 205
coloration de la syntaxe 175
htmlInspector.expandAllCodeFragments( 2
05
numéros de ligne 175
htmlInspector.expandSelectedCodeFragme
nts() 206
retrait automatique 176
htmlInspector.getShowAutoIndent() 174
HTML non valide 174, 176
renvoi des mots à la ligne 175, 177
isBlockElement() 329
isHeaderElement() 330
isListElement() 331
isReporting() 212
isSelectionValid() 443
itemInfo, structure 95
J
JavaScript
exécution dans Fireworks 36
transmission à Fireworks 36
jeux de cadres 375
enregistrement 376
jeux de résultats 76, 80, 81
L
latin1ToNative() 280
launchXMLSourceDialog() 286
lecture
commandes mémorisées 130
contenu des plug-ins 381
lecture, fichier d'objet Flash 44
ligne, début 146
liste
documents ouverts 188
navigateurs 113
listes
éditeurs 113
fichiers récents 255
listFolder() 12
Live data, fonctions 336, 337
liveDataTranslate() 338
loadSitesFromPrefs() 215
loadTracingImage() 381
LocalURLToFilePath() 32
locateInSite() 234
RÉFÉRENCE DES API DE DREAMWEAVER CS4 515
Index
M
makeEditable() 234
MMDB.getColumnList() 72
MMNotes.remove() 27
MMDB.getColumns() 72
MMNotes.set() 28
makeNewDreamweaverFile() 235
MMDB.getColumnsOfTable() 73
MMXSLT.getXML() 285
makeNewFolder() 235
MMDB.getConnection() 60
MMXSLT.getXMLSchema() 285
makeSizesEqual() 378
MMDB.getConnectionList() 61
MMXSLT.getXMLSourceURI() 286
manipulations de fichiers, fonctions 247
MMDB.getConnectionName() 61
MMXSLT.launchXMLSourceDialog() 286
mapKeyCodeToChar() 146
MMDB.getConnectionString() 62
Mode Code 185, 186
markDelete() 216
MMDB.getDriverName() 63
mode Code
markGet() 216
MMDB.getLocalDsnList() 63
basculement 366
markIgnore() 217
MMDB.getPassword() 63
HTML non valide 161
markPut() 217
MMDB.getPrimaryKeys() 74
mise en retrait automatique 161
markSelectionAsEditable() 313
MMDB.getProcedures() 74
numéros de ligne 164, 170
markSynced() 217
MMDB.getRdsPassword() 64
renvoi des mots à la ligne 166, 173
masquer la barre d'outils 172
MMDB.getRdsUserName() 64
mayLaunchFireworks() 37
MMDB.getRemoteDsnList() 64
mémorisation
MMDB.getRuntimeConnectionType() 65
mode Création
affiché ou masqué 186
visible 185
arrêt 131
MMDB.getSPColumnList() 76
mode de Mise en forme, fonctions 385
étapes 131
MMDB.getSPColumnListNamedParams()
76
mode Mise en forme 386, 390
menu Commande, fonctions 246
menus
MMDB.getSPParameters() 77
modèles de boîte, coloration 388
Acquérir 106
MMDB.getSPParamsAsString() 78
barre Insertion 137
MMDB.getTables() 79
modèles et éléments de bibliothèque,
fonctions 310
Connecter 106
MMDB.getUserName() 65
modes 79
Extraire 107
MMDB.getViews() 79
modification des tableaux, fonctions 401
mise à jour 146, 147
MMDB.hasConnectionWithName() 66
modification du nom
Placer 107
MMDB.needToPromptForRdsInfo() 66
rechargement 147
MMDB.needToRefreshColdFusionDsnList(
) 67
mot précédent 145
MMDB.popupConnection() 67
mots de passe
mergeTableCells() 406
message d'avertissement 120
messages d'erreur 103
longueur 103
systèmes de commande source 103
minimizeRestoreAll() 191
mise à jour
menus 146, 147
paires clé/valeur dans des fichiers Design
Notes 28
mode Standard 386
styles 371
mot suivant 143
MMDB.setRdsPassword() 68
connexion aux bases de données 63
MMDB.setRdsUserName() 68
connexions aux bases de données 63
MMDB.showColdFusionAdmin() 68
RDS 64, 68, 69
MMDB.showConnectionMgrDialog() 69
moveBehaviorDown() 301
MMDB.showOdbcDialog() 69
moveBehaviorUp() 303
MMDB.showRdsUserDialog() 69
moveSelectionBy() 378
MMDB.showRestrictDialog() 70
MMDB.showResultset() 80
MMDB.showSPResultset() 81
N
nativeToLatin1() 280
Arrière-plans des blocs de mise en
forme 373
MMDB.showSPResultsetNamedParams() 8
1
navigateur
blocs 386, 388
MMDB.testConnection() 70
divs 386, 388
MMHttp.clearServerScriptsFolder() 16
modèles de boîtes 372, 388, 390
MMHttp.clearTemp() 17
repères 397
MMHttp.getFile() 18
mise en couleur
mise en retrait 161
MMHttp.getFileCallback() 19
mm
MMHttp.getTextCallback() 20
browsercontrol 346
MMHttp.postText() 21
MMDB.deleteConnection() 59
MMHttp.postTextCallback() 22
MMDB.getColdFusionDsnList() 60
MMNotes, DLL 23
MMDB.getColumnAndTypeList() 71
MMNotes, objet 23
MMNotes.open() 27
ouverture d'URL 112
navigateur par défaut
rapport 151
navigateur principal 115
navigateur secondaire 115
navigateurs
cibles 148
liste 113
principal 115
secondaire 115
vérification de documents 262
RÉFÉRENCE DES API DE DREAMWEAVER CS4 516
Index
needToPromptForRdsInfo() 66
openDocumentFromSite() 257
paste() 151
needToRefreshColdFusionDsnList() 67
openInBrowser() 151
pilotes JDBC 63
nettoyage, documents XHTML 247
openInEditor() 152
pilotes, JDBC 63
newBlock() 428
openInFrame() 258
placement des fichiers 96, 111
newDocument() 256
OpenNotesFile() 33
playAllPlugins() 381
newEditableRegion() 314
OpenNotesFilewithOpenFlags() 33
playPlugin() 381
newFromTemplate() 256
openRelatedFile() 197
playRecordedCommand() 130
newRule() 364
openWithApp() 117
point d'insertion
newSite() 235
openWithBrowseDialog() 117
début de la ligne 146
newSnippet() 317
openWithExternalTextEditor() 118
début du document 145
newStyle() 370
openWithImageEditor() 118
début du paragraphe suivant 143
nextParagraph() 143
optimizeInFireworks() 38
déplacement 139, 140, 141
nextWord() 143, 450
fin de la ligne 142
nodeExists() 277
options, Afficher la boîte de dialogue lors de
l'insertion d'un objet 121
nodeToOffsets() 275
organisation
mot précédent 145
zones réactives 377
fin du document 142
nom de version, bibliothèque partagée
MMNotes 26, 32
orthographe, vérification 262
nombres, de fichiers extraits 102
outdent() 429
noms
outdentTextView() 451
popupAction() 299
ouverture
popupConnection() 67
de colonnes 74
mot suivant 143
paragraphe précédent 144
une page vers le bas 143
extraction 100
documents 256, 257
popupEditTagDialog() 459
système de commande source 92
popupInsertTagDialog() 458
noms d'extraction 100
documents dans un éditeur de texte
externe 118
noms d'utilisateur 65
fichiers d'aide 116
noms d'extraction 100
fichiers Design Notes 27, 33
RDS 64, 68, 69
fichiers, dans l'application spécifiée 117
noms de connexion 61
noms de pilotes 63
noms des dossiers racines 94
fichiers, dans l'éditeur d'image
spécifié 118
popupServerBehavior() 348
postText() 21
postTextCallback() 22
Préférences, boîte de dialogue 123
premier plan
affichage de Dreamweaver 35
affichage de Fireworks 35
P
page d'insertion 144
Presse-papiers, fonctions 306
Page précédente 144
previousParagraph() 144
notifyFlashObjectChanged() 429
Page suivante 143
previousWord() 145, 452
notifyMenuUpdated() 147
pageDown() 143, 451
PrintCode() 437
nouveaux documents 256
pageUp() 144, 451
printDocument() 120
Nouvelles fonctions de Dreamweaver CS4 2
paires clé/valeur
procédures nommées 77
noms des sources de données ColdFusion 60
noms des sources de données dans
ColdFusion 60
procédures stockées 76, 77, 81
numéro de version, bibliothèque partagée
MMNotes 26, 32
création 34
création dans les fichiers Design Notes 28
à propos 71
numéros de ligne 164, 170, 175, 176
dans les fichiers Design Notes 25
affichage des résultats 81
nombre 30
obtention de colonnes 76
O
objets de connexion 60
propriétés 85
Objets dynamiques 54
obtention
DOM actuel 254
objets de connexion nommés 60
PanelWindow, spécifications 46
panneau flottant de résultats 148
obtention de paramètres 78
paramètres 78
panneau flottant, fonctions 185
procédures, connexions nommées 74
panneau Résultats
programme de validation, méthode 148
effacement 150
propriété data des objets httpReply 16
messages 150, 151
propriétés de contour 372, 374
panneau Site, fonctions de sélection 213
put() 236
offsetsToNode() 275
panneaux flottants, disposition 384
opacité, tracé de l'image 380
paragraphe précédent 144
open() 27, 236
paragraphe suivant 143
Q
quitApplication() 121
openDocument() 257
paramètre, de procédures stockées 78
quitter Dreamweaver 121
RÉFÉRENCE DES API DE DREAMWEAVER CS4 517
Index
R
racine du site, fichiers Design Notes 26, 31
rename() 318
resWin.setTitle() 157
renameSelectedStyle() 370
resWin.startProcessing() 158
rapports
renameSelection() 238
resWin.stopProcessing() 158
rendu
rétablissement
dans le panneau Résultats 148
rapports du site 148
RDS
informations de connexion 66, 69
mots de passe 64, 68
noms d'utilisateur 64, 68
styles 367
documents 259
renvoi des mots à la ligne 173, 175, 177
retrait automatique 176
repères
revealDocument() 120
utilisation 394
revertDocument() 259
répéter une étape 128
revokeIdleHandler() 125
read() 13
replace() 416
runCommand() 246
reapplyBehaviors() 297
replaceAll() 417
runTranslator() 283
rechargement 415
replaceRange() 452
runValidation() 238, 263
objets de la barre Insertion 138
replaySteps() 135
recherches 148
reproduction des étapes de l'historique 135
recreateCache() 237
resizeSelection() 430
S
save() 152
redo 130
resizeSelectionBy() 378
saveAll() 259
redo() 128, 130
saveAllFrames() 376
réduction des fenêtres 191
resolveOriginalAssetFileURLToAbsoluteLo
calFilePath() 57
referencePalette.getFontSize() 295
Restreindre, boîte de dialogue 70
saveDocument() 260
referencePalette.setFontSize() 295
Résultats, fenêtre
saveDocumentAs() 260
refresh() 237, 332
ajout d'une entrée de résultats 149
saveAsCommand() 135
saveDocumentAsTemplate() 261
refreshExtData() 336
résultats, groupe de panneaux 148
saveFrameset() 261
refreshVariableCodeHints() 208
resultsPalette.canClear() 486
saveFramesetAs() 261
registerIdleHandler() 124
resultsPalette.canCopy() 486
saveSitesToPrefs() 215
règle
resultsPalette.canCut() 486
scanSourceString() 281
origine 380
resultsPalette.canOpenInBrowser() 487
scrollEndFile() 453
unité 380
resultsPalette.canOpenInEditor() 487
scrollLineDown() 453
relativeToAbsoluteURL() 273
resultsPalette.canPaste() 487
scrollLineUp() 453
releaseDocument() 258
resultsPalette.canSave() 488
scrollPageDown() 454
reloadCodeColoring() 415
resultsPalette.canSelectAll() 488
scrollPageUp() 454
reloadMenus() 147
resultsPalette.clear() 150
scrollTopFile() 454
reloadObjects() 138
resultsPalette.Copy() 150
SCS_AfterPut() 110, 111
reloadToolbars() 184
resultsPalette.cut() 151
SCS_BeforeGet() 109
remoteIsValid() 237
resultsPalette.debugWindow.addDebugCon
textData() 159
SCS_BeforePut() 110
remove()
(dreamweaver.snippetPalette.remove)
319
resultsPalette.openInBrowser() 151
resultsPalette.openInEditor() 152
SCS_canCheckin() 107
SCS_canCheckout() 107
SCS_canConnect() 106
remove() (DWfile.remove) 13
resultsPalette.paste() 151
remove() (MMNotes.remove) 27
resultsPalette.save() 152
removeAllTableHeights() 407
resultsPalette.selectAll() 153
removeAllTableWidths() 407
removeBehavior() 297
resultsPalette.siteReports.addResultItem() 1
49
removeCharacterMarkup() 429
resWin.addItem() 153
SCS_canRename() 109
removeColumnWidth() 407
resWin.addResultItem() 149
SCS_CanUndoCheckout() 108
removeComment() 208
resWin.getItem() 154
SCS_Checkin() 100
removeCSSStyle() 360
resWin.getSelectedItem() 155
SCS_Checkout() 101
removeEditableRegion() 314
resWin.setButtons() 155
SCS_Connect() 93
removeFontMarkup() 430
resWin.setCallbackCommands() 156
SCS_Delete() 96
RemoveNote() 33
resWin.setColumnWidths() 156
SCS_Disconnect() 93
removeTranslatedAttribute() 319
resWin.setFileList() 157
SCS_Get() 95
resWin.setSelectedItem() 157
SCS_GetAgentInfo() 92
SCS_canDelete() 109
SCS_canGet() 106
SCS_canNewFolder() 108
SCS_canPut() 107
RÉFÉRENCE DES API DE DREAMWEAVER CS4 518
Index
SCS_GetCheckoutName() 100
setConnectionState() 240
setShowLayoutTableTabs() 390
SCS_GetConnectionInfo() 98
setCurrentLine() 455
setShowLayoutView() 390
SCS_GetDesignNotes() 104
setCurrentSite() 240
setShowLineNumbers() 170
SCS_GetErrorMessage() 103
setDesignViewMode() 342
setShowNoscript() 443
SCS_GetErrorMessageLength() 103
setDivBackgroundColors() 374
setShowRulers() 171
SCS_GetFileCheckoutList() 102
setEditNoFramesContent() 167
setShowStatusBar() 178
SCS_GetFolderList() 95
setExpanded() 334
setShowSyntaxColoring() 171
SCS_GetFolderListLength() 94
setFileList() 157
setShowTableBorders() 171
SCS_GetMaxNoteLength() 104
setFloaterVisibility() 191
setShowTableWidths() 408
SCS_GetNewFeatures() 99
setFocus() 241
setShowToolbar() 172
SCS_GetNoteCount() 103
setHideAllFloaters() 177
setShowToolbarIconLabels() 182
SCS_GetNumCheckedOut() 102
setHideAllVisualAids() 167
setShowToolTips() 179
SCS_GetNumNewFeatures() 99
setLayerTag() 379
setShowTracingImage() 172
SCS_GetRootFolder() 94
setLinkHref() 431
setShowWordWrap() 172
SCS_GetRootFolderLength() 94
setLinkTarget() 431
setSnapDistance() 193
SCS_IsConnected() 93
setListBoxKind() 432
setSnapToGrid() 173
SCS_IsRemoteNewer() 105
setListTag() 433
setSplitViewOrientation() 198
SCS_ItemExists() 97
setLiveDataError() 339
setTableCellTag() 408
SCS_NewFolder() 96
setLiveDataMode() 340
setTableColumns() 409
SCS_Put() 96
setLiveDataParameters() 340
setTableRows() 409
SCS_Rename() 97
setLiveViewDependentsUsingServer() 343
setTextAlignment() 433
SCS_SetDesignNotes() 105
setLiveViewUsingServer() 342
setTextFieldKind() 433
SCS_SiteDeleted() 98
setMediaType() 371
setTextFormat() 434
SCS_SiteRenamed() 99
setMenuDefault() 137
setTitle() 157
SCS_UndoCheckout() 101
SetNote() 34
setToolbarItemAttribute() 182
SELECT 71, 72
setPreferenceInt() 268
setToolbarPosition() 183
selectAll() 153, 238, 276, 278
setPreferenceString() 269
setToolbarVisibility() 184
selectChild() 438
setPreventLayerOverlaps() 167
setTracingImageOpacity() 383
Sélecteur de balises, boîte de dialogue 124
setPrimaryView() 193, 199
setTracingImagePosition() 382
sélection 185
setRdsPassword() 68
setTranslatedAttribute() 320
setRdsUserName() 68
setUndoState() 136
sélection, étapes de l'historique 136
setRulerOrigin() 382
setUpComplexFind() 417
selectNewer() 239
setRulerUnits() 382
setUpComplexFindReplace() 418
selectParent() 439
setSelectedBehavior() 304
setUpFind() 419
selectParentTag() 455
setSelectedItem() 148
setUpFindReplace() 419
selectTable() 408
setSelectedNode() 276
setView() 186
send() 126
setSelectedSteps() 136
showAboutBox() 122
serveur
suppression 422
setSelection() 241, 277
showColdFusionAdmin() 68
débogage 158
setShowBlockBackgrounds() 388
showConnectionMgrDialog() 69
fonctions de comportements 347
setShowBlockBorders() 389
showDynamicData() 122
fonctions de composants 332
setShowBlockIDs() 389
showFindDialog() 420
session d'optimisation, Fireworks 37, 38
setShowBoxModel() 390
showFindReplaceDialog() 421
set() 28
setShowFrameBorders() 168
showFontColorDialog() 434
setActiveWindow() 191
setShowGrid() 168
showGridSettingsDialog() 385
setAttributes() 14
setShowHeadView() 168
showInfoBar() 195
setAttributeWithErrorChecking() 430
setShowHiddenCharacters() 207, 210
showInfoMessagePopup() 265
setBlockVisOutlineProperties() 373
setShowImageMaps() 169
setCallbackCommands() 156
setShowInvalidHTML() 169
showInsertTableRowsOrColumnsDialog()
409
setCloakingEnabled() 240
setShowInvisibleElements() 170
showListPropertiesDialog() 432
setColumnWidths() 156
setShowLayerBorders() 170
showLiveDataDialog() 341
RÉFÉRENCE DES API DE DREAMWEAVER CS4 519
Index
showLiveViewParamatersDialog() 344
displaySyncInfoForFile() 223
site, informations pour tous les sites 215
showOdbcDialog() 69
editColumns() 224
site.getSiteURLPrefix() 233
showPagePropertiesDialog() 266
enregistrement d'informations pour les
sites 215
sites
showPreferencesDialog() 123
showProperties() 193
showQuickTagEditor() 440
showRdsUserDialog() 69
showReportsDialog() 212
showRestrictDialog() 70
showResults() 148
showResultset() 80
showSPResultset() 81
showSPResultsetNamedParams() 81
showTagChooser() 124, 459
showTagLibraryEditor() 459
showTargetBrowsersDialog() 270
site
addLinkToExistingFile() 218
browseDocument() 491
canCheckIn() 491
canCheckOut() 492
canCloak() 492
canCompareFiles() 493
canConnect() 493
canDisplaySyncInfoForFile() 493
canEditColumns() 467
canGet() 494
canLocateInSite() 494
canMakeEditable() 495
canMakeNewFileOrFolder() 495
canOpen() 495
canPut() 496
canRecreateCache() 496
canRefresh() 497
canSelectAllCheckedOutFiles() 497
canSelectNewer() 497
canSynchronize() 498
canUncloak() 498
canUndoCheckOut() 498
canViewAsRoot() 499
changeLink() 219
changeLinkSitewide() 218
checkIn() 219
checkLinks() 220
checkOut() 220
checkTargetBrowsers() 221
cloak() 221
defineSites() 222
deleteSelection() 222
deployFilesToTestingServerBin() 223
exécution de l'application de comparaison
de fichiers 216
exportSite() 224
get() 226
getAppServerAccessType() 227
getAppServerPathToFiles() 227
getAppURLPrefixForSite() 228
getCheckOutUser() 228
getCheckOutUserForFile() 228
getCloakingEnabled() 229
getConnectionState() 229
getCurrentSite() 230
getFocus() 230
getLocalPathToFiles() 230
getLocalRootURL() 231
getSelection() 231
getShowToolTips() 178
getSiteForURL() 231
getSiteRootForURL() 232
getSites() 232
importSite() 233
isCloaked() 233
locateInSite() 234
makeEditable() 234
makeNewDreamweaverFile() 235
makeNewFolder() 235
newSite() 235
open() 236
put() 236
recreateCache() 237
refresh() 237
remoteIsValid() 237
renameSelection() 238
runValidation() 238
selectAll() 238
selectNewer() 239
setCloakingEnabled() 240
setConnectionState() 240
setCurrentSite() 240
setFocus() 241
setSelection() 241
setShowToolTips() 179
synchronize() 242
uncloak() 243
uncloakAll() 243
undoCheckOut() 243
dossier racine local 272
renommés 99
supprimés 98
sites renommés 99
sites, fonctions 212, 213
siteSyncDialog.canCompare() 488
siteSyncDialog.canMarkDelete() 489
siteSyncDialog.canMarkGet() 489
siteSyncDialog.canMarkIgnore() 489
siteSyncDialog.canMarkPut() 490
siteSyncDialog.canMarkSynced() 490
siteSyncDialog.compare() 215
siteSyncDialog.markDelete() 216
siteSyncDialog.markGet() 216
siteSyncDialog.markIgnore() 217
siteSyncDialog.markPut() 217
siteSyncDialog.markSynced() 217
siteSyncDialog.toggleShowAllFiles() 218
snapToGuides() 401
snapTracingImageToSelection() 383
snippetpalette.canEditSnippet() 490
snippetpalette.canInsert() 491
snippetPalette.getCurrentSnippetPath() 316
snippetPalette.newFolder() 316
source, validation 148
source.applyComment() 207
source.doCodeNavItem() 446
source.refreshVariableCodeHints() 208
source.removeComment() 208
sources de données
ColdFusion 67
ODBC 69
sources de données ColdFusion 67
splitFrame() 376
splitTableCell() 410
Spry
fonctions d'insertion de widgets 321
fonctions de modification de widgets 319
SQL SELECT 71, 72
startOfDocument() 145, 455
startOfLine() 145, 456
startProcessing() 158
startRecording() 131
statusCode, propriété 16
stopAllPlugins() 384
stopPlugin() 384
stopProcessing() 158
RÉFÉRENCE DES API DE DREAMWEAVER CS4 520
Index
stopRecording() 131
sites supprimés 98
stripTag() 439
suppression de fichiers 96
structure InfoPrefs 31
test de l'existence de fichiers 97
styles
test des connexions 93
types de connexion d'exécution 65
versions 92
types, colonnes 71
application 357, 364
types de connexion
création 83
exécution 65
duplication 365
liste 369
modification du nom 371
obtention des noms 368
rendu 367, 371
suppression 360, 365
T
tableaux
conversion en calques 245
tables
U
uncloak() 243
uncloakAll() 243
undo() 129, 131
colonnes 72, 73
undoCheckOut() 243
styles CSS, fonctions 355
obtention de colonnes 73
une page vers le haut 144
suppression
obtention de la liste 79
updateCurrentPage() 314
tables de base de données 79
updatePages() 315
chaînes d'ID 137
connexions aux bases de données 59
taille
updateReference() 195
dossiers 17
calques 378
updateSmartObjectFromOriginal() 57
sélection 422
contenu Flash 43
URL
styles 360, 365
fichiers 12
décodage 266
zones réactives 378
envoi de données 21
suppression de clés des fichiers Design
Notes 33
test, chaînes de connexion 70
obtention de fichiers 18, 19
suppressStartupScreen() 126
testAppServer() 353
obtention du contenu des fichiers 20
SWFFile.createFile() 42
testConnection() 70
ouverture dans un navigateur 112
SWFFile.getNaturalSize() 43
texte
relatives 273
SWFFile.getObjectType() 44
envoi 22
SWFFile.readFile() 44
obtention 129
synchronize() 242
opération de modification 129
synchronizeDocument() 457
Texte dynamique, boîte de dialogue 122
systèmes de commande source 100
tileHorizontally() 194
ajout d'un commentaire 109
tileVertically() 194
changement du nom de fichiers 97
toggleFloater() 195
clés de Design Note 103
toggleShowAllFiles() 218
connexion 93
topPage() 456
connexions 98
Touche Retour arrière, pression 141
création de dossiers 96
touche Suppr 141
déconnexion 93
touches
URL de fichier absolues 273
vers une application Flash MX 114
URL de fichier
conversion en chemin d'accès du fichier
local 24
conversion en chemin d'accès du lecteur
local 27, 32
useTranslatedSource() 284
utilisateurs, extraction de fichiers 102
V
validateFireworks() 38
validateFlash() 119
Design Notes 104, 105
Page précédente 144
dossiers transmis 95
Page suivante 143
éléments des dossiers 94
Retour arrière 141
vérification de documents dans le
navigateur 262
Suppr 141
vérification de liens 148
fichiers 95
fichiers distants 105
tracé de l'image
validation de documents 264
vérification orthographique 262
groupes de fichiers 109, 110, 111
alignement 383
longueur de Design Notes 104
verrouillage, repères 398
opacité 380
versions
longueur du nom du dossier racine 94
traduction, fonctions 283
messages d'erreur 103
Fireworks 38
nom d'extraction 100
traitement des connexions, base de
données 59
Flash MX 119
noms 92
traitement des fichiers 157, 158
noms des dossiers racines 94
translatedStyle 321
nouvelles fonctionnalités 99
transmission de JavaScript à Fireworks 36
placement des fichiers 96
type d'objet Flash 44
sites renommés 99
type d'objet, Flash 44
système de commande source 92
visible 185
RÉFÉRENCE DES API DE DREAMWEAVER CS4 521
Index
W
widgets, Spry
fonctions d'insertion 321
fonctions de modification 319
window.getDeclaredStyle() 325
wrapSelection() 457
wrapTag() 439
write() 15
X
XHTML
conversion 248
création 252
nettoyage 247
test du document 249
Z
zones réactives
déplacement 378
organisation 377
taille 378
zones réactives, fonctions 377
zoom 391
zoomIn() 393
zoomOut() 393
">