Adobe Dreamweaver MX 2004 Manuel utilisateur

ドキュメント
Guide des API de Dreamweaver
Marques commerciales
Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware,
Authorware Star, Backstage, Bright Tiger, Clustercats, Cold Fusion, Contribute, Design in Motion, Director, Dream Templates,
Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, Generator, HomeSite,
JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live
Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Flash, Macromedia M Logo &amp; Design,
Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel, Made with Macromedia, Made with Macromedia Logo
and Design, MAGIC Logo and Design, Mediamaker, Movie Critic, Open Sesame!, Roundtrip HTML, Shockwave, Sitespring,
SoundEdit, Titlemaker, UltraDev, Web Design 101, what the web can be et Xtra sont des marques commerciales ou des marques
d&eacute;pos&eacute;es de Macromedia, Inc. aux Etats-Unis ou dans d’autres juridictions ou pays. Les autres noms de produit, logos, concepts,
titres, mots ou phrases mentionn&eacute;s dans cette publication peuvent &ecirc;tre des marques commerciales, des marques de service ou des
noms commerciaux de Macromedia, Inc. ou d’autres entit&eacute;s et peuvent &ecirc;tre d&eacute;pos&eacute;s dans certaines juridictions ou certains pays.
Informations de tiers
Ce manuel contient des liens vers des sites Web tiers qui ne sont pas contr&ocirc;l&eacute;s par Macromedia et Macromedia ne peut en aucun
cas &ecirc;tre tenu responsable du contenu de ces sites. Si vous acc&eacute;dez &agrave; l’un de ces sites, vous le faites &agrave; vos propres risques.
Macromedia propose ces liens dans un but pratique uniquement et ne peut en aucun cas endosser ou accepter la responsabilit&eacute; du
contenu de ces sites tiers.
Vous trouverez des informations sur les logiciels tiers et/ou d’autres conditions g&eacute;n&eacute;rales &agrave; l’adresse suivante :
www.macromedia.com/go/thirdparty_fr/.
Navigateur Opera &reg; Copyright &copy; 1995-2002 Opera Software ASA et ses fournisseurs. Tous droits r&eacute;serv&eacute;s.
D&eacute;n&eacute;gation de responsabilit&eacute; d’Apple
APPLE COMPUTER, INC. N’ASSUME AUCUNE GARANTIE, IMPLICITE OU EXPLICITE, SUR LE LOGICIEL
INFORMATIQUE CI-INCLUS, SA COMMERCIABILITE OU SON ADEQUATION A UN OBJECTIF PARTICULIER.
L’EXCLUSION DES GARANTIES IMPLICITES N’ETANT PAS AUTORISEE DANS CERTAINS ETATS,
L’EXCLUSION CI-DESSUS PEUT DONC NE PAS S’APPLIQUER A VOTRE CAS. CETTE GARANTIE VOUS OFFRE
DES DROITS JURIDIQUES SPECIFIQUES. VOUS POUVEZ DISPOSER DE CERTAINS AUTRES DROITS, QUI
VARIENT SELON LES ETATS.
Copyright &copy; 1997-2003 Macromedia, Inc. Tous droits r&eacute;serv&eacute;s. Ce manuel ne peut pas &ecirc;tre copi&eacute;, photocopi&eacute;, reproduit,
traduit ou converti sous forme &eacute;lectronique ou informatique, en partie ou en totalit&eacute;, sans l’autorisation &eacute;crite pr&eacute;alable de
Macromedia, Inc. Num&eacute;ro de r&eacute;f&eacute;rence ZDW70M400F
Remerciements
Direction : Sheila McGinn
Gestion de projet : Robert Berry
R&eacute;daction : Robert Berry et David Jacowitz
Direction des &eacute;ditions : Lisa Stanziano
Mise en forme : Mary Kraemer
Gestion de la production : Patrice O’Neill
Conception et production : Adam Barnett, Aaron Begley, Chris Basmajian, John Francis, Jeff Harmon.
Remerciements particuliers &agrave; Jay London, Jeff Schang, Lori Hylan-Cho, Hisami Scott, Sam Mathews, Jake Cockrell, Russ
Helfand, Randy Edmunds, George Comninos, Rosana Francescato, Charles Nadeau, Bonnie Loo, Gwenael Cossoul, Luciano
Arruda, Masayo Noda, Richard Clairicia, Scott Richards, Seungmin Lee, Vincent Truong, Birnou S&eacute;barte et les &eacute;quipes
d’ing&eacute;nierie et de contr&ocirc;le qualit&eacute; de Dreamweaver.
Premi&egrave;re &eacute;dition : Novembre 2003
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103
TABLE DES MATIERES
CHAPITRE 1 : Introduction
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Arri&egrave;re-plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extension de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ressources suppl&eacute;mentaires pour les d&eacute;veloppeurs d’extensions . . . . . . . . . . . . . . .
Nouvelles fonctions de Dreamweaver MX 2004 . . . . . . . . . . . . . . . . . . . . . . . . . .
Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonctions supprim&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contenu de page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Activateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Autre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changements dans la documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Errata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions utilis&eacute;es dans ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
26
26
26
26
27
27
27
27
28
28
28
29
29
29
30
30
PARTIE I : API d’utilitaire
CHAPITRE 2 : API d’E/S des fichiers .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Acc&egrave;s aux fichiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
API d’E/S des fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.copy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.createFolder(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.exists() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.getAttributes() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.getModificationDate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.getCreationDate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.getCreationDateObj() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.getModificationDateObj() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.getSize() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.listFolder() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.read() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DWfile.remove() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
33
34
34
35
35
36
37
37
38
38
38
39
40
3
DWfile.setAttributes() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
DWfile.write() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
CHAPITRE 3 : API HTTP
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Fonctionnement de l’API HTTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
API HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
MMHttp.clearServerScriptsFolder() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
MMHttp.clearTemp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
MMHttp.getFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
MMHttp.getFileCallback(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
MMHttp.getText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
MMHttp.getTextCallback() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
MMHttp.postText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
MMHttp.postTextCallback() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
CHAPITRE 4 : API de Design Notes .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Fonctionnement de Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
API JavaScript de Design Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
MMNotes.close() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
MMNotes.filePathToLocalURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
MMNotes.get() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
MMNotes.getKeyCount() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
MMNotes.getKeys() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
MMNotes.getSiteRootForFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
MMNotes.getVersionName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
MMNotes.getVersionNum(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
MMNotes.localURLToFilePath() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
MMNotes.open() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
MMNotes.remove() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
MMNotes.set(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
API C de Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
void CloseNotesFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
BOOL FilePathToLocalURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
BOOL GetNote(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
int GetNoteLength() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
int GetNotesKeyCount() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
BOOL GetNotesKeys() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
BOOL GetSiteRootForFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
BOOL GetVersionName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
BOOL GetVersionNum(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
BOOL LocalURLToFilePath() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
FileHandle OpenNotesFile(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
FileHandle OpenNotesFilewithOpenFlags() . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
BOOL RemoveNote() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
BOOL SetNote() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
CHAPITRE 5 : Int&eacute;gration de Fireworks
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
L’API FWLaunch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
4
Table des mati&egrave;res
FWLaunch.bringDWToFront() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FWLaunch.bringFWToFront(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FWLaunch.execJsInFireworks() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FWLaunch.getJsResponse() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FWLaunch.mayLaunchFireworks() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FWLaunch.optimizeInFireworks() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FWLaunch.validateFireworks(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CHAPITRE 6 : Int&eacute;gration de Flash .
63
64
64
65
66
66
67
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Fonctionnement des &eacute;l&eacute;ments Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Insertion d’&eacute;l&eacute;ments Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Ajout d’un &eacute;l&eacute;ment Flash &agrave; la barre Ins&eacute;rer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Ajout d’un &eacute;l&eacute;ment Flash &agrave; un menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
API des objets Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
SWFFile.createFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
SWFFile.getNaturalSize() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
SWFFile.getObjectType() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
SWFFile.readFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
CHAPITRE 7 : API de base de donn&eacute;es
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Fonctionnement de l’API de bases de donn&eacute;es. . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Fonctions de connexion &agrave; une base de donn&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
MMDB.deleteConnection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
MMDB.getColdFusionDsnList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
MMDB.getConnection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
MMDB.getConnectionList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
MMDB.getConnectionName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
MMDB.getConnectionString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
MMDB.getDriverName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
MMDB.getDriverUrlTemplateList() (d&eacute;conseill&eacute;e). . . . . . . . . . . . . . . . . . . . . . 82
MMDB.getLocalDsnList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
MMDB.getPassword() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
MMDB.getRDSPassword() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
MMDB.getRDSUserName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
MMDB.getRemoteDsnList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
MMDB.getRuntimeConnectionType() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
MMDB.getUserName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
MMDB.hasConnectionWithName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
MMDB.needToPromptForRdsInfo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
MMDB.needToRefreshColdFusionDsnList() . . . . . . . . . . . . . . . . . . . . . . . . . . 87
MMDB.popupConnection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
MMDB.setRDSPassword(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
MMDB.setRDSUserName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
MMDB.showColdFusionAdmin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
MMDB.showConnectionMgrDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
MMDB.showOdbcDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
MMDB.showRdsUserDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
MMDB.showRestrictDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Table des mati&egrave;res
5
MMDB.testConnection(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
MMDB.getColumnAndTypeList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
MMDB.getColumnList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
MMDB.getColumns() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
MMDB.getColumnsOfTable(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
MMDB.getPrimaryKeys() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
MMDB.getProcedures() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
MMDB.getSPColumnList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
MMDB.getSPColumnListNamedParams(). . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
MMDB.getSPParameters() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
MMDB.getSPParamsAsString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
MMDB.getTables() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
MMDB.getViews(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
MMDB.showResultset(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
MMDB.showSPResultset(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
MMDB.showSPResultsetNamedParams() . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
CHAPITRE 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es
. . . . . . . . . . . . . . . . 103
D&eacute;veloppement d’un nouveau type de connexion . . . . . . . . . . . . . . . . . . . . . . . . 103
API de connexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
findConnection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
applyConnection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Fichier inclus g&eacute;n&eacute;r&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Fichier de d&eacute;finition pour votre type de connexion . . . . . . . . . . . . . . . . . . . . . . . 109
CHAPITRE 9 : API JavaBeans
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
API JavaBeans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
MMJB.getClasses(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
MMJB.getClassesFromPackage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
MMJB.getErrorMessage(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
MMJB.getEvents() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
MMJB.getIndexedProperties() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
MMJB.getMethods() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
MMJB.getProperties() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
MMJB.getReadProperties() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
MMJB.getWriteProperties() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
CHAPITRE 10 : API d’int&eacute;gration de commande source
. . . . . . . . . . . . . . . . . . 119
Fonctionnement de l’int&eacute;gration des commandes source avec Dreamweaver . . . . 119
Ajout d’une fonctionnalit&eacute; de syst&egrave;me de commande source . . . . . . . . . . . . . . . . 120
Fonctions obligatoires de l’API d’int&eacute;gration de commande source . . . . . . . . . . . 120
bool SCS_GetAgentInfo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
bool SCS_Connect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
bool SCS_Disconnect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
bool SCS_IsConnected() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
int SCS_GetRootFolderLength() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
bool SCS_GetRootFolder() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
6
Table des mati&egrave;res
int SCS_GetFolderListLength() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
bool SCS_GetFolderList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
bool SCS_Get() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
bool SCS_Put() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
bool SCS_NewFolder(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
bool SCS_Delete() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
bool SCS_Rename() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
bool SCS_ItemExists() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Fonctions facultatives de l’API d’int&eacute;gration de commande source . . . . . . . . . . . 126
bool SCS_GetConnectionInfo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
bool SCS_SiteDeleted() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
bool SCS_SiteRenamed() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
int SCS_GetNumNewFeatures() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
bool SCS_GetNewFeatures() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
bool SCS_GetCheckoutName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
bool SCS_Checkin(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
bool SCS_Checkout() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
bool SCS_UndoCheckout() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
int SCS_GetNumCheckedOut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
bool SCS_GetFileCheckoutList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
int SCS_GetErrorMessageLength(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
bool SCS_GetErrorMessage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
int SCS_GetNoteCount(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
int SCS_GetMaxNoteLength(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
bool SCS_GetDesignNotes() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
bool SCS_SetDesignNotes() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
bool SCS_IsRemoteNewer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Activateurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
bool SCS_canConnect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
bool SCS_canGet(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
bool SCS_canCheckout() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
bool SCS_canPut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
bool SCS_canCheckin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
bool SCS_CanUndoCheckout() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
bool SCS_canNewFolder() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
bool SCS_canDelete() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
bool SCS_canRename() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
bool SCS_BeforeGet() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
bool SCS_BeforePut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
bool SCS_AfterGet() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
bool SCS_AfterPut(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
PARTIE II : API JavaScript
CHAPITRE 11 : Application
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Fonctions relatives aux applications externes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
dreamweaver.browseDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Table des mati&egrave;res
7
dreamweaver.getBrowserList(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
dreamweaver.getExtensionEditorList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
dreamweaver.getExternalTextEditor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
dreamweaver.getFlashPath() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
dreamweaver.getPrimaryBrowser() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
dreamweaver.getPrimaryExtensionEditor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
dreamweaver.getSecondaryBrowser() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
dreamweaver.openHelpURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
dreamweaver.openWithApp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
dreamweaver.openWithBrowseDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
dreamweaver.openWithExternalTextEditor() . . . . . . . . . . . . . . . . . . . . . . . . . 149
dreamweaver.openWithImageEditor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
dreamweaver.validateFlash() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Fonctions globales relatives aux applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
dreamweaver.beep() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
dreamweaver.getShowDialogsOnInsert() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
dreamweaver.quitApplication() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
dreamweaver.showAboutBox() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
dreamweaver.showDynamicDataDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
dreamweaver.showPreferencesDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
dreamweaver.showTagChooser() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
CHAPITRE 12 : Espace de travail
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Fonctions relatives &agrave; l’historique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
dom.redo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
dom.undo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
dreamweaver.getRedoText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
dreamweaver.getUndoText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
dreamweaver.playRecordedCommand() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
dreamweaver.redo(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
dreamweaver.startRecording(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
dreamweaver.stopRecording() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
dreamweaver.undo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
dreamweaver.historyPalette.clearSteps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
dreamweaver.historyPalette.copySteps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
dreamweaver.historyPalette.getSelectedSteps() . . . . . . . . . . . . . . . . . . . . . . . . 159
dreamweaver.historyPalette.getStepCount() . . . . . . . . . . . . . . . . . . . . . . . . . . 160
dreamweaver.historyPalette.getStepsAsJavaScript() . . . . . . . . . . . . . . . . . . . . . 160
dreamweaver.historyPalette.getUndoState() . . . . . . . . . . . . . . . . . . . . . . . . . . 161
dreamweaver.historyPalette.replaySteps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
dreamweaver.historyPalette.saveAsCommand(). . . . . . . . . . . . . . . . . . . . . . . . 162
dreamweaver.historyPalette.setSelectedSteps(). . . . . . . . . . . . . . . . . . . . . . . . . 162
dreamweaver.historyPalette.getUndoState() . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Fonctions d’insertion d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
dom.insertFlashElement(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
dreamweaver.objectPalette.getMenuDefault() . . . . . . . . . . . . . . . . . . . . . . . . . 164
dreamweaver.objectPalette.setMenuDefault() . . . . . . . . . . . . . . . . . . . . . . . . . 164
dreamweaver.reloadObjects() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Fonctions relatives au clavier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
8
Table des mati&egrave;res
dom.arrowDown() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
dom.arrowLeft() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
dom.arrowRight(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
dom.arrowUp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
dom.backspaceKey(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
dom.deleteKey() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
dom.endOfDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
dom.endOfLine() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
dom.nextParagraph() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
dom.nextWord(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
dom.pageDown() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
dom.pageUp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
dom.previousParagraph() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
dom.previousWord() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
dom.startOfDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
dom.startOfLine() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
dreamweaver.mapKeyCodeToChar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Fonctions relatives aux menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
dreamweaver.getMenuNeedsUpdating() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
dreamweaver.notifyMenuUpdated() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
dreamweaver.reloadMenus() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Fonctions de la fen&ecirc;tre de r&eacute;sultats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Cr&eacute;ation d’une fen&ecirc;tre de r&eacute;sultats ind&eacute;pendante . . . . . . . . . . . . . . . . . . . . . . 173
dreamweaver.createResultsWindow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
dreamweaver.showResults(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
resWin.addItem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
resWin.addResultItem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
resWin.setCallbackCommands() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
resWin.setColumnWidths() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
resWin.setFileList(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
resWin.setTitle(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
resWin.startProcessing() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
resWin.stopProcessing() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Utilisation du groupe de panneaux R&eacute;sultats int&eacute;gr&eacute;. . . . . . . . . . . . . . . . . . . . 178
dreamweaver.resultsPalette.clear() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
dreamweaver.resultsPalette.Copy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
dreamweaver.resultsPalette.cut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
dreamweaver.resultsPalette.Paste(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
dreamweaver.resultsPalette.openInBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
dreamweaver.resultsPalette.openInEditor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
dreamweaver.resultsPalette.save() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
dreamweaver.resultsPalette.selectAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
D&eacute;bogage de serveur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
dreamweaver.resultsPalette.debugWindow.addDebugContextData() . . . . . . . 182
Fonctions de bascule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
dom.getEditNoFramesContent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
dom.getHideAllVisualAids(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
dom.getPreventLayerOverlaps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
dom.getShowAutoIndent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
dom.getShowFrameBorders() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Table des mati&egrave;res
9
dom.getShowGrid() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
dom.getShowHeadView(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
dom.getShowInvalidHTML(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
dom.getShowImageMaps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
dom.getShowInvisibleElements() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
dom.getShowLayerBorders(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
dom.getShowLineNumbers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
dom.getShowRulers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
dom.getShowSyntaxColoring(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
dom.getShowTableBorders(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
dom.getShowToolbar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
dom.getShowTracingImage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
dom.getShowWordWrap() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
dom.getSnapToGrid(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
dom.setEditNoFramesContent(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
dom.setHideAllVisualAids() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
dom.setPreventLayerOverlaps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
dom.setShowFrameBorders() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
dom.setShowGrid() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
dom.setShowHeadView() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
dom.setShowInvalidHTML() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
dom.setShowImageMaps() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
dom.setShowInvisibleElements() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
dom.setShowLayerBorders() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
dom.setShowLineNumbers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
dom.setShowRulers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
dom.setShowSyntaxColoring() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
dom.setShowTableBorders() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
dom.setShowToolbar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
dom.setShowTracingImage(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
dom.setShowWordWrap() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
dom.setSnapToGrid() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
dreamweaver.getHideAllFloaters(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
dreamweaver.getShowStatusBar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
dreamweaver.htmlInspector.getShowAutoIndent() . . . . . . . . . . . . . . . . . . . . . 196
dreamweaver.htmlInspector.getShowInvalidHTML() . . . . . . . . . . . . . . . . . . . 197
dreamweaver.htmlInspector.getShowLineNumbers() . . . . . . . . . . . . . . . . . . . 197
dreamweaver.htmlInspector.getShowSyntaxColoring() . . . . . . . . . . . . . . . . . . 197
dreamweaver.htmlInspector.getShowWordWrap() . . . . . . . . . . . . . . . . . . . . . 198
dreamweaver.htmlInspector.setShowAutoIndent() . . . . . . . . . . . . . . . . . . . . . 198
dreamweaver.htmlInspector.setShowInvalidHTML() . . . . . . . . . . . . . . . . . . . 198
dreamweaver.htmlInspector.setShowLineNumbers(). . . . . . . . . . . . . . . . . . . . 199
dreamweaver.htmlInspector.setShowSyntaxColoring() . . . . . . . . . . . . . . . . . . 199
dreamweaver.htmlInspector.setShowWordWrap() . . . . . . . . . . . . . . . . . . . . . . 199
dreamweaver.setHideAllFloaters() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
dreamweaver.setShowStatusBar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
site.getShowDependents() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
site.getShowHiddenFiles() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
site.getShowPageTitles() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
site.getShowToolTips() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
10
Table des mati&egrave;res
site.setShowDependents(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
site.setShowHiddenFiles(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
site.setShowPageTitles() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
site.setShowToolTips() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonctions relatives aux barres d’outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.forceToolbarUpdate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getShowToolbarIconLabels() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getToolbarIdArray() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getToolbarItemValue() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getToolbarLabel() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getToolbarVisibility() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setToolbarItemAttribute(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setShowToolbarIconLabels() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setToolbarPosition() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setToolbarVisibility() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonctions relatives aux fen&ecirc;tres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getFocus(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getView() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.getWindowTitle(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setView() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.bringAttentionToFloater() . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cascade() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.getActiveWindow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.getDocumentList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.getFloaterVisibility() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.getFocus() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.getPrimaryView() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.getSnapDistance() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.minimizeRestoreAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.setActiveWindow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.setFloaterVisibility() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.setPrimaryView() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.setSnapDistance() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.showProperties() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.tileHorizontally() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.tileVertically() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.toggleFloater() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.updateReference() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CHAPITRE 13 : Site .
202
202
202
203
203
203
203
204
204
205
206
206
207
207
208
209
209
209
210
210
210
211
211
211
212
213
214
214
214
215
215
216
217
217
217
218
218
219
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Fonctions relatives aux rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.isReporting() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.showReportsDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonctions relatives aux sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.loadSitesFromPrefs() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.saveSitesToPrefs(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
site.addLinkToExistingFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
site.addLinkToNewFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
site.canEditColumns() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table des mati&egrave;res
221
221
221
222
222
222
223
223
223
11
site.changeLinkSitewide() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
site.changeLink() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
site.checkIn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
site.checkLinks(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
site.checkOut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
site.checkTargetBrowsers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
site.cloak() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
site.defineSites() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
site.deleteSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
site.deployFilesToTestingServerBin(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
site.editColumns() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
site.exportSite(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
site.findLinkSource() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
site.get() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
site.getAppServerAccessType() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
site.getAppServerPathToFiles() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
site.getAppURLPrefixForSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
site.getCheckOutUser() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
site.getCheckOutUserForFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
site.getCloakingEnabled(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
site.getConnectionState() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
site.getCurrentSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
site.getFocus(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
site.getLinkVisibility() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
site.getLocalPathToFiles() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
site.getSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
site.getSiteForURL(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
site.getSites(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
site.importSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
site.invertSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
site.isCloaked() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
site.locateInSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
site.makeEditable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
site.makeNewDreamweaverFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
site.makeNewFolder(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
site.newHomePage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
site.newSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
site.open(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
site.put(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
site.recreateCache(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
site.refresh() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
site.remoteIsValid(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
site.removeLink() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
site.renameSelection(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
site.runValidation(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
site.saveAsImage(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
site.selectAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
site.selectHomePage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
site.selectNewer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
site.setAsHomePage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
12
Table des mati&egrave;res
site.setCloakingEnabled() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
site.setConnectionState() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
site.setCurrentSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
site.setFocus() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
site.setLayout() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
site.setLinkVisibility(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
site.setSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
site.synchronize() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
site.uncloak() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
site.uncloakAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
site.undoCheckOut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
site.viewAsRoot() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
CHAPITRE 14 : Document
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Fonctions relatives aux conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
dom.convertLayersToTable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
dom.convertTablesToLayers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Fonctions relatives aux commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
dreamweaver.editCommandList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
dreamweaver.popupCommand() (d&eacute;conseill&eacute;e). . . . . . . . . . . . . . . . . . . . . . . . 252
dreamweaver.runCommand() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Fonctions relatives aux manipulations de fichiers. . . . . . . . . . . . . . . . . . . . . . . . . 253
dom.cleanupXHTML() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
dom.convertToXHTML() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
dom.getIsXHTMLDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
dreamweaver.browseForFileURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
dreamweaver.browseForFolderURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
dreamweaver.closeDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
dreamweaver.createDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
dreamweaver.createXHTMLDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
dreamweaver.createXMLDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
dreamweaver.exportCSS(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
dreamweaver.exportEditableRegionsAsXML() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . 260
dreamweaver.exportTemplateDataAsXML() . . . . . . . . . . . . . . . . . . . . . . . . . . 260
dreamweaver.getDocumentDOM() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
dreamweaver.getNewDocumentDOM(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
dreamweaver.getRecentFileList(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
dreamweaver.importXMLIntoTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
dreamweaver.newDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
dreamweaver.newFromTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
dreamweaver.openDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
dreamweaver.openDocumentFromSite(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
dreamweaver.openInFrame(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
dreamweaver.releaseDocument(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
dreamweaver.revertDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
dreamweaver.saveAll(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
dreamweaver.saveDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
dreamweaver.saveDocumentAs(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
dreamweaver.saveDocumentAsTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Table des mati&egrave;res
13
dreamweaver.saveFrameset() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
dreamweaver.saveFramesetAs() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Fonctions globales relatives aux documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
dom.checkSpelling() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
dom.checkTargetBrowsers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
dom.getParseMode(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
dom.hideInfoMessagePopup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
dom.runValidation(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
dom.showInfoMessagePopup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
dom.showPagePropertiesDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
dreamweaver.doURLDecoding(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
dreamweaver.getElementRef(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
dreamweaver.getObjectRefs() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . . . . 274
dreamweaver.getObjectTags() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . . . . 275
dreamweaver.getPreferenceInt() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
dreamweaver.getPreferenceString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
dreamweaver.setPreferenceInt(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
dreamweaver.setPreferenceString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
dreamweaver.showTargetBrowsersDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Fonctions relatives aux chemins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
dreamweaver.getConfigurationPath() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
dreamweaver.getDocumentPath() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
dreamweaver.getSiteRoot() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
dreamweaver.getTempFolderPath() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
dreamweaver.relativeToAbsoluteURL() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Fonctions relatives &agrave; la s&eacute;lection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
dom.getSelectedNode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
dom.getSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
dom.nodeToOffsets() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
dom.offsetsToNode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
dom.selectAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
dom.setSelectedNode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
dom.setSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
dreamweaver.getSelection() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
dreamweaver.nodeExists(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
dreamweaver.nodeToOffsets() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . . . . 286
dreamweaver.offsetsToNode() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . . . . 287
dreamweaver.selectAll(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
dreamweaver.setSelection() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Fonctions de manipulation de cha&icirc;nes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
dreamweaver.doURLEncoding(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
dreamweaver.getTokens() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
dreamweaver.latin1ToNative() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
dreamweaver.nativeToLatin1() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
dreamweaver.scanSourceString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Fonctions relatives &agrave; la traduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
dom.runTranslator() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
dreamweaver.editLockedRegions() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
dreamweaver.getTranslatorList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
dreamweaver.useTranslatedSource() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
14
Table des mati&egrave;res
CHAPITRE 15 : Contenu de page . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Fonctions du panneau Actifs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
dreamweaver.assetPalette.addToFavoritesFromDocument(). . . . . . . . . . . . . . . 295
dreamweaver.assetPalette.addToFavoritesFromSiteAssets() . . . . . . . . . . . . . . . 295
dreamweaver.assetPalette.addToFavoritesFromSiteWindow() . . . . . . . . . . . . . 296
dreamweaver.assetPalette.copyToSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
dreamweaver.assetPalette.edit() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
dreamweaver.assetPalette.getSelectedCategory() . . . . . . . . . . . . . . . . . . . . . . . 297
dreamweaver.assetPalette.getSelectedItems() . . . . . . . . . . . . . . . . . . . . . . . . . . 297
dreamweaver.assetPalette.getSelectedView() . . . . . . . . . . . . . . . . . . . . . . . . . . 298
dreamweaver.assetPalette.insertOrApply(). . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
dreamweaver.assetPalette.locateInSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
dreamweaver.assetPalette.newAsset(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
dreamweaver.assetPalette.newFolder(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
dreamweaver.assetPalette.recreateLibraryFromDocument(). . . . . . . . . . . . . . . 300
dreamweaver.assetPalette.refreshSiteAssets() . . . . . . . . . . . . . . . . . . . . . . . . . . 300
dreamweaver.assetPalette.removeFromFavorites() . . . . . . . . . . . . . . . . . . . . . . 300
dreamweaver.assetPalette.renameNickname() . . . . . . . . . . . . . . . . . . . . . . . . . 301
dreamweaver.assetPalette.setSelectedCategory() . . . . . . . . . . . . . . . . . . . . . . . 301
dreamweaver.assetPalette.setSelectedView(). . . . . . . . . . . . . . . . . . . . . . . . . . . 301
dreamweaver.libraryPalette.deleteSelectedItem() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . 302
dreamweaver.libraryPalette.getSelectedItem() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . 302
dreamweaver.libraryPalette.newFromDocument() (d&eacute;conseill&eacute;e). . . . . . . . . . . 302
dreamweaver.libraryPalette.recreateFromDocument() (d&eacute;conseill&eacute;e) . . . . . . . . 303
dreamweaver.libraryPalette.renameSelectedItem() (d&eacute;conseill&eacute;e) . . . . . . . . . . . 303
dreamweaver.referencePalette.getFontSize() . . . . . . . . . . . . . . . . . . . . . . . . . . 303
dreamweaver.referencePalette.setFontSize() . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
dreamweaver.templatePalette.deleteSelectedTemplate() (d&eacute;conseill&eacute;e) . . . . . . . 304
dreamweaver.templatePalette.getSelectedTemplate() (d&eacute;conseill&eacute;e) . . . . . . . . . 304
dreamweaver.templatePalette.renameSelectedTemplate() (d&eacute;conseill&eacute;e). . . . . . 305
Fonctions relatives aux comportements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
dom.addBehavior(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
dom.getBehavior() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
dom.reapplyBehaviors() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
dom.removeBehavior() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
dreamweaver.getBehaviorElement() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
dreamweaver.getBehaviorEvent() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . . . . . 308
dreamweaver.getBehaviorTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
dreamweaver.popupAction() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
dreamweaver.behaviorInspector.getBehaviorAt() . . . . . . . . . . . . . . . . . . . . . . . 310
dreamweaver.behaviorInspector.getBehaviorCount(). . . . . . . . . . . . . . . . . . . . 310
dreamweaver.behaviorInspector.getSelectedBehavior() . . . . . . . . . . . . . . . . . . 311
dreamweaver.behaviorInspector.moveBehaviorDown() . . . . . . . . . . . . . . . . . . 311
dreamweaver.behaviorInspector.moveBehaviorUp() . . . . . . . . . . . . . . . . . . . . 312
dreamweaver.behaviorInspector.setSelectedBehavior(). . . . . . . . . . . . . . . . . . . 313
Fonctions relatives au Presse-papiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
dom.clipCopy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
dom.clipCopyText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
dom.clipCut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Table des mati&egrave;res
15
dom.clipPaste(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
dom.clipPasteText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
dreamweaver.clipCopy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
dreamweaver.clipCut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
dreamweaver.clipPaste() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
dreamweaver.getClipboardText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Fonctions relatives aux &eacute;l&eacute;ments de biblioth&egrave;que et aux mod&egrave;les . . . . . . . . . . . . . 319
dom.applyTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
dom.detachFromLibrary() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
dom.detachFromTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
dom.getAttachedTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
dom.getEditableRegionList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
dom.getIsLibraryDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
dom.getIsTemplateDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
dom.getSelectedEditableRegion() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
dom.insertLibraryItem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
dom.markSelectionAsEditable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
dom.newEditableRegion() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
dom.removeEditableRegion() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
dom.updateCurrentPage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
dreamweaver.updatePages(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Fonctions du panneau Fragments de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
dreamweaver.snippetPalette.getCurrentSnippetPath() . . . . . . . . . . . . . . . . . . . 325
dreamweaver.snippetPalette.newFolder(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
dreamweaver.snippetPalette.newSnippet(). . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
dreamweaver.snippetPalette.editSnippet() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
dreamweaver.snippetPalette.insert()r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
dreamweaver.snippetPalette.insertSnippet() . . . . . . . . . . . . . . . . . . . . . . . . . . 327
dreamweaver.snippetPalette.rename() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
dreamweaver.snippetPalette.remove() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
CHAPITRE 16 : Documents dynamiques
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Fonctions de composants de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
dreamweaver.serverComponents.getSelectedNode() . . . . . . . . . . . . . . . . . . . . 329
dreamweaver.serverComponents.refresh() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Fonctions relatives aux sources de donn&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
dreamweaver.dbi.getDataSources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Fonctions de l’Extension Data Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
dreamweaver.getExtDataValue() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
dreamweaver.getExtDataArray() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
dreamweaver.getExtParticipants() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
dreamweaver.getExtGroups() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
dreamweaver.refreshExtData() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Fonctions Live data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
dreamweaver.getLiveDataInitTags() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
dreamweaver.getLiveDataMode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
dreamweaver.getLiveDataParameters () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
dreamweaver.liveDataTranslate(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
dreamweaver.setLiveDataError() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
16
Table des mati&egrave;res
dreamweaver.setLiveDataMode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
dreamweaver.setLiveDataParameters() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
dreamweaver.showLiveDataDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Fonctions relatives aux comportements de serveur . . . . . . . . . . . . . . . . . . . . . . . . 338
dreamweaver.getParticipants(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
dreamweaver.serverBehaviorInspector.getServerBehaviors(). . . . . . . . . . . . . . . 339
dreamweaver.popupServerBehavior() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Fonctions de mod&egrave;le de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
dom.serverModel.getAppURLPrefix() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
dom.serverModel.getDelimiters() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
dom.serverModel.getDisplayName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
dom.serverModel.getFolderName() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
dom.serverModel.getServerExtension() (d&eacute;conseill&eacute;e). . . . . . . . . . . . . . . . . . . 342
dom.serverModel.getServerIncludeUrlPatterns(). . . . . . . . . . . . . . . . . . . . . . . 342
dom.serverModel.getServerInfo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
dom.serverModel.getServerLanguage() (d&eacute;conseill&eacute;e) . . . . . . . . . . . . . . . . . . . 344
dom.serverModel.getServerName(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
dom.serverModel.getServerSupportsCharset() . . . . . . . . . . . . . . . . . . . . . . . . 345
dom.serverModel.getServerVersion() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
dom.serverModel.testAppServer(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
dreamweaver.getServerModels() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
CHAPITRE 17 : Conception .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Fonctions CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.applyCSSStyle() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.removeCSSStyle(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssRuleTracker.editSelectedRule() . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssRuleTracker.newRule() . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.applySelectedStyle() . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.attachStyleSheet() . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.deleteSelectedStyle() . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.duplicateSelectedStyle() . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.editSelectedStyle(). . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.editStyleSheet(). . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.getMediaType(). . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.getSelectedStyle() . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.getSelectedTarget() (d&eacute;conseill&eacute;e) . . . . . . . . . . . .
dreamweaver.cssStylePalette.getStyles() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.newStyle(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dreamweaver.cssStylePalette.setMediaType() . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonctions relatives aux cadres et aux jeux de cadres . . . . . . . . . . . . . . . . . . . . . . .
dom.getFrameNames() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.isDocumentInFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.saveAllFrames() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.splitFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonctions relatives aux calques et aux cartes graphiques. . . . . . . . . . . . . . . . . . . .
dom.align(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.arrange(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.makeSizesEqual() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table des mati&egrave;res
347
347
348
348
349
349
350
350
350
351
351
351
352
352
353
353
354
354
354
355
355
355
356
356
356
357
17
dom.moveSelectionBy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
dom.resizeSelectionBy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
dom.setLayerTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Fonctions d’environnement de mise en forme . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
dom.getRulerOrigin(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
dom.getRulerUnits(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
dom.getTracingImageOpacity() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
dom.loadTracingImage(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
dom.playAllPlugins() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
dom.playPlugin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
dom.setRulerOrigin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
dom.setRulerUnits() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
dom.setTracingImagePosition(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
dom.setTracingImageOpacity(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
dom.snapTracingImageToSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
dom.stopAllPlugins() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
dom.stopPlugin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
dreamweaver.arrangeFloatingPalettes() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
dreamweaver.showGridSettingsDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Fonctions relatives au mode de Mise en forme. . . . . . . . . . . . . . . . . . . . . . . . . . . 364
dom.addSpacerToColumn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
dom.createLayoutCell() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
dom.createLayoutTable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
dom.doesColumnHaveSpacer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
dom.doesGroupHaveSpacers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
dom.getClickedHeaderColumn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
dom.getShowLayoutTableTabs(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
dom.getShowLayoutView() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
dom.isColumnAutostretch() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
dom.makeCellWidthsConsistent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
dom.removeAllSpacers() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
dom.removeSpacerFromColumn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
dom.setColumnAutostretch() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
dom.setShowLayoutTableTabs() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
dom.setShowLayoutView(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Fonctions de modification des tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
dom.convertWidthsToPercent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
dom.convertWidthsToPixels() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
dom.decreaseColspan(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
dom.decreaseRowspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
dom.deleteTableColumn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
dom.deleteTableRow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
dom.doDeferredTableUpdate(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
dom.getShowTableWidths() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
dom.getTableExtent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
dom.increaseColspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
dom.increaseRowspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
dom.insertTableColumns(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
dom.insertTableRows(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
dom.mergeTableCells(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
18
Table des mati&egrave;res
dom.removeAllTableHeights() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.removeAllTableWidths(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.removeColumnWidth() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.selectTable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setShowTableWidths() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setTableCellTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setTableColumns() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.setTableRows() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dom.showInsertTableRowsOrColumnsDialog() . . . . . . . . . . . . . . . . . . . . . . .
dom.splitTableCell(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CHAPITRE 18 : Code. .
375
375
375
376
376
376
377
377
377
378
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Fonctions de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
dreamweaver.codeHints.addMenu() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
dreamweaver.codeHints.addFunction(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
dreamweaver.codeHints.resetMenu() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
dreamweaver.codeHints.showCodeHints() . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
dreamweaver.reloadCodeColoring() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Fonctions relatives &agrave; la recherche et au remplacement . . . . . . . . . . . . . . . . . . . . . 383
dreamweaver.findNext() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
dreamweaver.replace(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
dreamweaver.replaceAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
dreamweaver.setUpComplexFind() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
dreamweaver.setUpComplexFindReplace() . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
dreamweaver.setUpFind() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
dreamweaver.setUpFindReplace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
dreamweaver.showFindDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
dreamweaver.showFindReplaceDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Fonctions de modifications g&eacute;n&eacute;rales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
dom.applyCharacterMarkup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
dom.applyFontMarkup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
dom.deleteSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
dom.editAttribute() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
dom.exitBlock() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
dom.getCharSet() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
dom.getFontMarkup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
dom.getLineFromOffset(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
dom.getLinkHref() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
dom.getLinkTarget(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
dom.getListTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
dom.getTextAlignment() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
dom.getTextFormat() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
dom.hasCharacterMarkup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
dom.indent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
dom.insertHTML() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
dom.insertObject() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
dom.insertText(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
dom.newBlock() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
dom.notifyFlashObjectChanged() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
Table des mati&egrave;res
19
dom.outdent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
dom.removeCharacterMarkup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
dom.removeFontMarkup() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
dom.removeLink() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
dom.resizeSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
dom.setAttributeWithErrorChecking(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
dom.setLinkHref() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
dom.setLinkTarget() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
dom.setListBoxKind() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
dom.showListPropertiesDialog(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
dom.setListTag(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
dom.setTextAlignment() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
dom.setTextFieldKind() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
dom.setTextFormat() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
dom.showFontColorDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
dreamweaver.deleteSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
dreamweaver.editFontList(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
dreamweaver.getFontList() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
dreamweaver.getFontStyles(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
dreamweaver.getKeyState() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
dreamweaver.getNaturalSize() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
dreamweaver.getSystemFontList(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Fonction relative &agrave; l’impression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
dreamweaver.PrintCode() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Fonctions relatives &agrave; Quick Tag Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
dom.selectChild() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
dom.selectParent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
dom.stripTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
dom.wrapTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
dreamweaver.showQuickTagEditor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Fonctions du mode code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
dom.formatRange() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
dom.formatSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
dom.getShowNoscript() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
dom.getAutoValidationCount() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
dom.isDesignviewUpdated(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
dom.isSelectionValid() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
dom.setShowNoscript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
dom.source.arrowDown() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
dom.source.arrowLeft() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
dom.source.arrowRight() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
dom.source.arrowUp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
dom.source.balanceBracesTextview() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
dom.source.endOfDocument(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
dom.source.endOfLine() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
dom.source.endPage(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
dom.source.getCurrentLines() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
dom.source.getSelection(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
dom.source.getLineFromOffset() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
dom.source.getText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
20
Table des mati&egrave;res
dom.source.getValidationErrorsForOffset() . . . . . . . . . . . . . . . . . . . . . . . . . . 415
dom.source.indentTextview() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
dom.source.insert(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
dom.source.nextWord() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
dom.source.outdentTextview() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
dom.source.pageDown(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
dom.source.pageUp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
dom.source.previousWord() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
dom.source.replaceRange() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
dom.source.scrollEndFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
dom.source.scrollLineDown(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
dom.source.scrollLineUp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
dom.source.scrollPageDown(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
dom.source.scrollPageUp() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
dom.source.scrollTopFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
dom.source.selectParentTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
dom.source.setCurrentLine() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
dom.source.startOfDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
dom.source.startOfLine() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
dom.source.topPage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
dom.source.wrapSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
dom.synchronizeDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Fonctions de l’&eacute;diteur de balises et de la biblioth&egrave;que de balises. . . . . . . . . . . . . . 423
dom.getTagSelectorTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
dreamweaver.popupInsertTagDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
dreamweaver.popupEditTagDialog(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
dreamweaver.showTagChooser() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
dreamweaver.showTagLibraryEditor(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
dreamweaver.tagLibrary.getTagLibraryDOM() . . . . . . . . . . . . . . . . . . . . . . . . 425
dreamweaver.tagLibrary.getSelectedLibrary() . . . . . . . . . . . . . . . . . . . . . . . . . 425
dreamweaver.tagLibrary.getSelectedTag() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
dreamweaver.tagLibrary.importDTDOrSchema(). . . . . . . . . . . . . . . . . . . . . . 426
dreamweaver.tagLibrary.getImportedTagList() . . . . . . . . . . . . . . . . . . . . . . . . 427
CHAPITRE 19 : Activateurs .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Activateurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
dom.canAlign() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
dom.canApplyTemplate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
dom.canArrange(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
dom.canClipCopyText(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
dom.canClipPaste() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
dom.canClipPasteText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
dom.canConvertLayersToTable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
dom.canConvertTablesToLayers(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
dom.canDecreaseColspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
dom.canDecreaseRowspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
dom.canDeleteTableColumn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
dom.canDeleteTableRow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
dom.canEditNoFramesContent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
Table des mati&egrave;res
21
dom.canIncreaseColspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
dom.canIncreaseRowspan() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
dom.canInsertTableColumns() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
dom.canInsertTableRows() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
dom.canMakeNewEditableRegion() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
dom.canMarkSelectionAsEditable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
dom.canMergeTableCells() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
dom.canPlayPlugin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
dom.canRedo(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
dom.canRemoveEditableRegion(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
dom.canSelectTable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
dom.canSetLinkHref() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
dom.canShowListPropertiesDialog(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
dom.canSplitFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
dom.canSplitTableCell() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
dom.canStopPlugin() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
dom.canUndo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
dom.hasTracingImage() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
dreamweaver.assetPalette.canEdit() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
dreamweaver.assetPalette.canInsertOrApply() . . . . . . . . . . . . . . . . . . . . . . . . . 439
dreamweaver.canClipCopy(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
dreamweaver.canClipCut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
dreamweaver.canClipPaste() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
dreamweaver.canDeleteSelection() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
dreamweaver.canExportCSS(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
dreamweaver.canExportTemplateDataAsXML() . . . . . . . . . . . . . . . . . . . . . . . 441
dreamweaver.canFindNext() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
dreamweaver.canOpenInFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
dreamweaver.canPlayRecordedCommand() . . . . . . . . . . . . . . . . . . . . . . . . . . 442
dreamweaver.canPopupEditTagDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
dreamweaver.canRedo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
dreamweaver.canRevertDocument() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
dreamweaver.canSaveAll(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
dreamweaver.canSaveDocument(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
dreamweaver.canSaveDocumentAsTemplate() . . . . . . . . . . . . . . . . . . . . . . . . 444
dreamweaver.canSaveFrameset() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
dreamweaver.canSaveFramesetAs() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
dreamweaver.canSelectAll(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
dreamweaver.canShowFindDialog() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
dreamweaver.canUndo() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
dreamweaver.cssRuleTracker.canEditSelectedRule() . . . . . . . . . . . . . . . . . . . . 446
dreamweaver.cssStylePalette.canApplySelectedStyle() . . . . . . . . . . . . . . . . . . . 447
dreamweaver.cssStylePalette.canDeleteSelectedStyle() . . . . . . . . . . . . . . . . . . . 447
dreamweaver.cssStylePalette.canDuplicateSelectedStyle() . . . . . . . . . . . . . . . . 447
dreamweaver.cssStyle.canEditSelectedStyle() . . . . . . . . . . . . . . . . . . . . . . . . . . 448
dreamweaver.cssStylePalette.canEditStyleSheet(). . . . . . . . . . . . . . . . . . . . . . . 448
dreamweaver.isRecording() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
dreamweaver.htmlStylePalette.canEditSelection() . . . . . . . . . . . . . . . . . . . . . . 449
dreamweaver.resultsPalette.canClear(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
dreamweaver.resultsPalette.canCopy(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
22
Table des mati&egrave;res
dreamweaver.resultsPalette.canCut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
dreamweaver.resultsPalette.canPaste() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
dreamweaver.resultsPalette.canOpenInBrowser() . . . . . . . . . . . . . . . . . . . . . . 450
dreamweaver.resultsPalette.canOpenInEditor() . . . . . . . . . . . . . . . . . . . . . . . . 450
dreamweaver.resultsPalette.canSave() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
dreamweaver.resultsPalette.canSelectAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
dreamweaver.snippetpalette.canEditSnippet() . . . . . . . . . . . . . . . . . . . . . . . . . 451
dreamweaver.snippetpalette.canInsert(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
site.browseDocument(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
site.canAddLink() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
site.canChangeLink() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
site.canCheckIn() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
site.canCheckOut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
site.canCloak() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
site.canConnect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
site.canFindLinkSource() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
site.canGet() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
site.canLocateInSite() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
site.canMakeEditable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
site.canMakeNewFileOrFolder(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
site.canOpen() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
site.canPut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
site.canRecreateCache() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
site.canRefresh() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
site.canRemoveLink() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
site.canSetLayout() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
site.canSelectAllCheckedOutFiles(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
site.canSelectNewer() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
site.canShowPageTitles(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
site.canSynchronize() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
site.canUncloak() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
site.canUndoCheckOut() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
site.canViewAsRoot() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
INDEX
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Table des mati&egrave;res
23
24
Table des mati&egrave;res
CHAPITRE 1
Introduction
Le Guide des API de Dreamweaver d&eacute;crit deux interfaces de programmation d’applications (API)
qui vous permettent d’effectuer diverses t&acirc;ches de prise en charge lorsque vous d&eacute;veloppez des
extensions Macromedia Dreamweaver MX 2004 et ajoutez des codes de programme &agrave; vos pages
Web Dreamweaver. Ces deux API sont l’API des utilitaires et l’API JavaScript. L’API des utilitaires
contient des sous-ensembles de fonctions li&eacute;es qui permettent d’effectuer des types de t&acirc;ches
sp&eacute;cifiques. Il comprend les sous-ensembles suivants :
• l’API d’E/S des fichiers, qui permet un acc&egrave;s en lecture et en &eacute;criture aux fichiers du syst&egrave;me
•
•
•
•
•
•
•
•
local ;
l’API HTTP, qui permet d’envoyer et de recevoir des informations &agrave; partir d’un serveur Web ;
l’API de Design Notes, qui permet de stocker et d’extraire les notes relatives aux documents ;
l’API d’int&eacute;gration de Fireworks, qui permet de communiquer avec Macromedia Fireworks ;
l’int&eacute;gration Flash, qui contient des informations concernant l’ajout d’&eacute;l&eacute;ments Flash &agrave;
l’interface utilisateur Dreamweaver et sur l’API des objets Flash (qui permet de cr&eacute;er des objets
pour le contenu Macromedia Flash) ;
l’API de base de donn&eacute;es, qui permet d’acc&eacute;der aux informations stock&eacute;es dans les bases de
donn&eacute;es et de g&eacute;rer les connexions &agrave; ces bases de donn&eacute;es ;
l’API de connectivit&eacute; &agrave; une base de donn&eacute;es, qui permet de cr&eacute;er un nouveau type de
connexion et les bo&icirc;tes de dialogue correspondantes pour les mod&egrave;les de serveur nouveaux et
existants ;
l’API JavaBeans, qui extrait les noms de classe, les m&eacute;thodes, les propri&eacute;t&eacute;s et les &eacute;v&egrave;nements
d&eacute;finis pour JavaBeans ;
l’API d’int&eacute;gration de contr&ocirc;le source, qui permet d’&eacute;crire des biblioth&egrave;ques partag&eacute;es, pour
&eacute;tendre la fonction Archiver/Extraire de Dreamweaver.
L’API Javascript permet d’effectuer plusieurs t&acirc;ches mineures g&eacute;n&eacute;ralement effectu&eacute;es par
l’utilisateur lors de la cr&eacute;ation ou de la modification de documents Dreamweaver. Ces fonctions
d’API sont regroup&eacute;es selon les parties de l’interface utilisateur de Dreamweaver auxquelles elles se
rapportent. Ainsi, l’API JavaScript comprend les fonctions relatives &agrave; l’espace de travail, aux
documents, &agrave; la conception, etc. Ces fonctions vous permettent d’effectuer des t&acirc;ches telles que :
ouvrir un nouveau document, obtenir ou d&eacute;finir une taille de police, trouver l’occurrence d’une
cha&icirc;ne de recherche en code HTML, afficher une barre d’outils, etc.
25
Arri&egrave;re-plan
Ce manuel suppose une bonne ma&icirc;trise de Dreamweaver, HTML, XML, de la programmation
JavaScript et, le cas &eacute;ch&eacute;ant, de la programmation C. Si vous r&eacute;digez des extensions pour &eacute;laborer
des applications Web, vous devez &eacute;galement ma&icirc;triser la cr&eacute;ation de scripts c&ocirc;t&eacute; serveur sur au
moins une plate-forme telle que Active Server Pages (ASP), ASP.net, PHP : Hypertext
Preprocessor (PHP), ColdFusion ou Java Server Pages (JSP).
Extension de Dreamweaver
Pour en savoir plus sur la plate-forme Dreamweaver et l’API permettant de d&eacute;velopper des
extensions de Dreamweaver, voir Extension de Dreamweaver. Le manuel Extension de Dreamweaver
d&eacute;crit les fonctions des API que Dreamweaver appelle pour impl&eacute;menter les objets, menus,
panneaux flottants, comportements de serveur, etc., qui forment les diverses fonctionnalit&eacute;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 &eacute;galement comment
personnaliser Dreamweaver en modifiant et en ajoutant des balises &agrave; divers fichiers HTML et
XML, de fa&ccedil;on &agrave; ajouter des types d’&eacute;l&eacute;ments, des &eacute;l&eacute;ments de menus, etc.
Ressources suppl&eacute;mentaires pour les d&eacute;veloppeurs d’extensions
Pour entrer en contact avec d’autres d&eacute;veloppeurs d’extensions, vous pouvez rejoindre le forum de
discussion consacr&eacute; &agrave; l’extensibilit&eacute; de Dreamweaver. Pour ce faire, il vous suffit de vous rendre &agrave;
l’adresse suivante : www.macromedia.com/go/extending_newsgrp.
Nouvelles fonctions de Dreamweaver MX 2004
Les fonctions suivantes ont &eacute;t&eacute; ajout&eacute;es &agrave; l’API JavaScript de Dreamweaver MX 2004. Les en-t&ecirc;tes
d&eacute;signent les chapitres et les sections qui contiennent les nouvelles fonctions :
Espace de travail
Les fonctions barre Ins&eacute;rer, fen&ecirc;tre R&eacute;sultats et barre d’outils ci-dessous ont &eacute;t&eacute; ajout&eacute;es au
chapitre Espace de travail.
Insertion d’objets
• dom.insertFlashElement(), page 163
• dreamweaver.objectPalette.getMenuDefault(),
• dreamweaver.objectPalette.setMenuDefault(),
• dreamweaver.reloadObjects(), page 165
Fen&ecirc;tre R&eacute;sultats
dreamweaver.showResults(), page 173
Barre d’outils
•
•
26
dom.getToolbarItemValue(), page 204
dom.setToolbarItemAttribute(), page 206
Chapitre 1 : Introduction
page 164
page 164
Document
Les nouvelles fonctions suivantes (fonctions globales relatives au document) ont &eacute;t&eacute; ajout&eacute;es au
chapitre Document.
Fonctions globales relatives au document
•
•
•
dom.hideInfoMessagePopup(), page 270
dreamweaver.showTargetBrowsersDialog(), page 279
dom.showInfoMessagePopup(), page 272
Conception
Les nouvelles fonctions suivantes (relatives &agrave; CSS, HTML et &agrave; la modification des tableaux) ont
&eacute;t&eacute; ajout&eacute;es au chapitre Conception.
CSS
•
•
•
•
dreamweaver.cssRuleTracker.newRule(), page 349
dreamweaver.cssRuleTracker.editSelectedRule(), page 348
dreamweaver.cssStylePalette.getMediaType(), page 351
dreamweaver.cssStylePalette.setMediaType(), page 354
Modification des tableaux
•
•
•
dom.getShowTableWidths(), page 372
dom.removeColumnWidth(), page 375
dom.setShowTableWidths(), page 376
Code
Les nouvelles fonctions suivantes (relatives au mode Code) ont &eacute;t&eacute; ajout&eacute;es au chapitre Code.
Mode Code
•
•
dom.getAutoValidationCount(), page 408
dom.source.getValidationErrorsForOffset(), page 415
Fonctions supprim&eacute;es
Les fonctions suivantes ont &eacute;t&eacute; supprim&eacute;es de l’API Dreamweaver MX 2004, car les fonctions
associ&eacute;es ont &eacute;t&eacute; supprim&eacute;es du produit.
Document
Dans le chapitre Document, la fonction de conversion suivante a &eacute;t&eacute; supprim&eacute;e :
Fonction de conversion
dom.convertTo30()
Fonctions supprim&eacute;es
27
Contenu de page
Dans le chapitre Contenu de page, les fonctions suivantes (relatives aux sc&eacute;narios) ont &eacute;t&eacute;
supprim&eacute;es :
Fonctions relatives aux sc&eacute;narios
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
dreamweaver.timelineInspector.addBehavior()
dreamweaver.timelineInspector.addFrame()
dreamweaver.timelineInspector.addKeyframe()
dreamweaver.timelineInspector.addObject()
dreamweaver.timelineInspector.addTimeline()
dreamweaver.timelineInspector.changeObject()
dreamweaver.timelineInspector.getAutoplay()
dreamweaver.timelineInspector.getCurrentFrame()
dreamweaver.timelineInspector.getLoop()
dreamweaver.timelineInspector.recordPathOfLayer()
dreamweaver.timelineInspector.removeBehavior()
dreamweaver.timelineInspector.removeFrame()
dreamweaver.timelineInspector.removeKeyframe()
dreamweaver.timelineInspector.removeObject()
dreamweaver.timelineInspector.removeTimeline()
dreamweaver.timelineInspector.renameTimeline()
dreamweaver.timelineInspector.setAutoplay()
dreamweaver.timelineInspector.setCurrentFrame()
dreamweaver.timelineInspector.setLoop()
Conception
Dans le chapitre Conception, les fonctions suivantes (relatives aux styles HTML) ont &eacute;t&eacute; supprim&eacute;es :
Fonctions relatives aux styles HTML
•
•
•
•
•
•
•
•
dom.applyHTMLStyle()
dreamweaver.htmlStylePalette.deleteSelectedStyle()
dreamweaver.htmlStylePalette.duplicateSelectedStyle()
dreamweaver.htmlStylePalette.editSelectedStyle()
dreamweaver.htmlStylePalette.getSelectedStyle()
dreamweaver.htmlStylePalette.getStyles()
dreamweaver.htmlStylePalette.newStyle()
dreamweaver.htmlStylePalette.setSelectedStyle()
Code
Dans le chapitre Code, les fonctions suivantes (relatives au d&eacute;bogueur JavaScript et &agrave; l’inspecteur
de balises) ont &eacute;t&eacute; supprim&eacute;es :
Fonctions relatives au d&eacute;bogueur JS
•
•
•
•
28
dreamweaver.debugDocument()
dreamweaver.startDebugger()
dreamweaver.getIsAnyBreakpoints()
dreamweaver.removeAllBreakpoints()
Chapitre 1 : Introduction
Fonctions relatives &agrave; l’inspecteur de balises
•
•
•
•
•
•
•
•
•
•
dreamweaver.tagInspector.deleteTags()
dreamweaver.tagInspector.deleteTagsEnabled()
dreamweaver.tagInspector.editTagName()
dreamweaver.tagInspector.editTagNameEnabled()
dreamweaver.tagInspector.tagAfter()
dreamweaver.tagInspector.tagAfterEnabled()
dreamweaver.tagInspector.tagBefore()
dreamweaver.tagInspector.tagBeforeEnabled()
dreamweaver.tagInspector.tagInside()
dreamweaver.tagInspector.tagInsideEnabled()
Activateurs
Dans le chapitre Activateurs, les fonctions suivantes (relatives aux activateurs) ont &eacute;t&eacute; supprim&eacute;es :
•
•
•
•
•
•
•
dreamweaver.timelineInspector.canAddFrame()
dreamweaver.timelineInspector.canAddKeyFrame()
dreamweaver.timelineInspector.canChangeObject()
dreamweaver.timelineInspector.canRemoveBehavior()
dreamweaver.timelineInspector.canRemoveFrame()
dreamweaver.timelineInspector.canRemoveKeyFrame()
dreamweaver.timelineInspector.canRemoveObject()
Autre
Les arguments &quot;answers&quot; et &quot;sitespring&quot; ont &eacute;t&eacute; supprim&eacute;s des
dw.getFloaterVisibility() et dw.setFloaterVisibility().
fonctions
Changements dans la documentation
Extension de Dreamweaver MX a &eacute;t&eacute; divis&eacute; en deux manuels : Extension de Dreamweaver et un
Guide des API de Dreamweaver. Extension de Dreamweaver d&eacute;crit comment d&eacute;velopper diff&eacute;rents
types d’extensions Dreamweaver, en indiquant les fonctions que vous devez &eacute;crire pour cr&eacute;er
chaque type. Il d&eacute;crit &eacute;galement comment personnaliser Dreamweaver en modifiant certains
fichiers HTML et XML configurables. Le Guide des API de Dreamweaver d&eacute;crit les deux API qui
vous permettent d’effectuer diverses t&acirc;ches dans vos extensions de Dreamweaver.
Le manuel Extension de Dreamweaver a &eacute;t&eacute; con&ccedil;u pour aider les utilisateurs &agrave; d&eacute;velopper une
extension Dreamweaver. Le Guide des API de Dreamweaver est con&ccedil;u pour aider le programmeur
qui ma&icirc;trise d&eacute;j&agrave; bien ces notions &agrave; retrouver rapidement la fonction lui permettant d’effectuer
une t&acirc;che pr&eacute;cise. Cette division en deux manuels permet &eacute;galement de clarifier la distinction
entre les fonctions API d’extension que l’auteur de l’extension doit coder et que Dreamweaver
appelle, et les fonctions API JavaScript et d’utilitaires qu’un programmeur peut appeler pour
effectuer diff&eacute;rentes t&acirc;ches dans une extension.
Le Guide des API de Dreamweaver comprend les am&eacute;liorations suivantes, &agrave; l’attention des
d&eacute;veloppeurs d’extensions :
• R&eacute;organisation des fonctions en chapitres.
Les fonctions API JavaScript sont maintenant regroup&eacute;es d’abord par chapitre, selon le
contexte Dreamweaver li&eacute; (Espace de travail, Document, Conception, etc.), puis par sujet
selon la fonction sp&eacute;cifique (fonctions clavier, fonctions de menu, fonctions de fen&ecirc;tre, etc.).
Fonctions supprim&eacute;es
29
• Fonctions d&eacute;conseill&eacute;es d&eacute;sormais indiqu&eacute;es dans le texte.
•
Les fonctions d&eacute;conseill&eacute;es faisaient auparavant l’objet d’une section s&eacute;par&eacute;e. Elles sont
maintenant int&eacute;gr&eacute;es &agrave; leur sujet d’origine, afin de garder le contexte, et sont signal&eacute;es par le
suffixe &laquo; (d&eacute;conseill&eacute;e) &raquo; dans le nom de la fonction.
Chapitre relatif aux fonctions des activateurs.
Les fonctions des activateurs ont &eacute;t&eacute; int&eacute;gr&eacute;es dans un chapitre &agrave; part, avec des r&eacute;f&eacute;rences
crois&eacute;es aux fonctions API concern&eacute;es.
Errata
Vous trouverez une liste des probl&egrave;mes connus dans la section Extensibility (Extension) du centre
de support de Dreamweaver (www.macromedia.com/go/extending_errata).
Conventions utilis&eacute;es dans ce manuel
Ce manuel utilise les conventions typographiques suivantes :
• La police de code indique des fragments de code et des constantes d’API, notamment des
•
•
•
•
noms de classe, des noms de m&eacute;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 &eacute;l&eacute;ments rempla&ccedil;ables dans le code.
Le symbole de continuation (&not;) indique qu’une longue ligne de code a &eacute;t&eacute; fractionn&eacute;e sur deux
lignes ou plus. En raison des limites de marge du format de ce manuel, une ligne de code
continue doit ici &ecirc;tre coup&eacute;e. Lorsque vous copiez les lignes de code, supprimez le symbole de
continuation et entrez-les comme une seule ligne.
Les accolades ({ }) autour d’un argument de fonction indiquent que l’argument est facultatif.
Le nom des fonctions ayant le pr&eacute;fixe dreamweaver.nomfonc peut &ecirc;tre abr&eacute;g&eacute; en dw.nomfonc
lorsque vous &eacute;crivez le code. Ce manuel utilise le pr&eacute;fixe dreamweaver. complet pour d&eacute;finir
la fonction, et &eacute;galement dans l’index. Toutefois, dans de nombreux exemples, le pr&eacute;fixe dw.
est utilis&eacute;.
Conventions de noms utilis&eacute;es dans ce manuel :
• Vous - le d&eacute;veloppeur responsable de la r&eacute;daction des extensions.
• L’utilisateur - la personne utilisant Dreamweaver.
30
Chapitre 1 : Introduction
Etudiez les fonctions utilitaires de Macromedia Dreamweaver MX 2004 qui vous permettent
d’acc&eacute;der aux fichiers locaux ainsi qu’aux fichiers plac&eacute;s sur un site, de travailler avec des objets
Macromedia Fireworks MX 2004 et Macromedia Flash MX 2004, de g&eacute;rer des connexions aux
bases de donn&eacute;es, de cr&eacute;er des types de connexion aux bases de donn&eacute;es, d’acc&eacute;der aux
composants JavaBeans et d’int&eacute;grer Dreamweaver &agrave; divers syst&egrave;mes de commande source.
Chapitre 2 : API d’E/S des fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Chapitre 3 : API HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Chapitre 4 : API de Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Chapitre 5 : Int&eacute;gration de Fireworks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Chapitre 6 : Int&eacute;gration de Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Chapitre 7 : API de base de donn&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapitre 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Chapitre 9 : API JavaBeans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Chapitre 10 : API d’int&eacute;gration de commande source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
PARTIE I
PARTIE I
API d’utilitaire
CHAPITRE 2
API d’E/S des fichiers
Macromedia Dreamweaver MX 2004 inclut une biblioth&egrave;que partag&eacute;e C, appel&eacute;e DWfile, qui
donne aux auteurs d’objets, de commandes, de comportements, de traducteurs de donn&eacute;es, de
panneaux flottants et d’inspecteurs de propri&eacute;t&eacute;s la possibilit&eacute; de lire et d’&eacute;crire des fichiers sur le
syst&egrave;me de fichiers local. Ce chapitre d&eacute;crit l’API d’entr&eacute;e/sortie des fichiers et son utilisation.
Pour obtenir des informations g&eacute;n&eacute;rales sur la fa&ccedil;on dont les biblioth&egrave;ques C interagissent avec
l’interpr&eacute;teur JavaScript dans Dreamweaver, voir Extensibilit&eacute; de niveau C dans le manuel
Extension de Dreamweaver.
Acc&egrave;s aux fichiers de configuration
Sur les plates-formes Microsoft Windows 2000, Windows XP et Mac OS X, les utilisateurs
disposent de leur propre copie des fichiers de configuration. Chaque fois que Dreamweaver &eacute;crit
dans un fichier de configuration, il le fait dans le dossier Configuration de l’utilisateur. De m&ecirc;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&egrave;dent de la m&ecirc;me mani&egrave;re. En d’autres termes, si une extension lit ou &eacute;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.
API d’E/S des fichiers
Toutes les fonctions de l’API d’E/S des fichiers sont des m&eacute;thodes associ&eacute;es &agrave; l’objet DWfile.
33
DWfile.copy()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction copie le fichier sp&eacute;cifi&eacute; vers un nouvel emplacement.
Arguments
originalURL, copyURL
• L’argument originalURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le
fichier que vous souhaitez copier.
• L’argument copyURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente
l’emplacement o&ugrave; vous souhaitez enregistrer le fichier copi&eacute;.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si la copie r&eacute;ussit et false dans le cas contraire.
Exemple
Le code suivant copie un fichier appel&eacute; myconfig.cfg vers myconfig_backup.cfg :
var fileURL = &quot;file:///c|/Config/myconfig.cfg&quot;;
var newURL =&quot;file:///c|/Config/myconfig_backup.cfg&quot;;
DWfile.copy(fileURL, newURL);
DWfile.createFolder()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction cr&eacute;e un dossier &agrave; l’emplacement sp&eacute;cifi&eacute;.
Arguments
folderURL
• L’argument folderURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente
l’emplacement auquel vous souhaitez cr&eacute;er le dossier.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si la cr&eacute;ation du dossier a r&eacute;ussi et false dans le cas contraire.
Exemple
Le code suivant tente de cr&eacute;er un dossier nomm&eacute; tempFolder &agrave; la racine du lecteur C et affiche un
message d’avertissement indiquant si l’op&eacute;ration a r&eacute;ussi.
var folderURL = &quot;file:///c|/tempFolder&quot;;
if (DWfile.createFolder(folderURL)){
alert(&quot;Cr&eacute;ation de &quot; + folderURL);
} else {
34
Chapitre 2 : API d’E/S des fichiers
alert(&quot;Impossible de cr&eacute;er &quot; + folderURL);
}
DWfile.exists()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction v&eacute;rifie l’existence du fichier sp&eacute;cifi&eacute;.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
requis.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le fichier existe et false dans le cas contraire.
Exemple
Le code suivant recherche le fichier mydata.txt et affiche un message d’avertissement indiquant &agrave;
l’utilisateur si le fichier existe :
var fileURL = &quot;file:///c|/temp/mydata.txt&quot;;
if (DWfile.exists(fileURL)){
alert(fileURL + &quot; trouv&eacute;&quot;);
} else {
alert(fileURL + &quot; est introuvable.&quot;);
}
DWfile.getAttributes()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction obtient les attributs du fichier ou dossier sp&eacute;cifi&eacute;.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier ou
dossier dont vous souhaitez obtenir les attributs.
Valeurs renvoy&eacute;es
Cha&icirc;ne repr&eacute;sentant les attributs du fichier ou du dossier sp&eacute;cifi&eacute;. Si le fichier ou le dossier n’existe
pas, cette fonction renvoie la valeur null. Les caract&egrave;res suivants de la cha&icirc;ne repr&eacute;sentent les
attributs :
•
•
signifie lecture seule.
D signifie dossier.
R
API d’E/S des fichiers
35
•
•
signifie masqu&eacute;.
S indique un fichier ou dossier syst&egrave;me.
H
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 = &quot;file:///c|/temp/mydata.txt&quot;;
var str = DWfile.getAttributes(fileURL);
if (str &amp;&amp; (str.indexOf(&quot;R&quot;) != -1)){
alert(fileURL + &quot; est en lecture seule&quot;);
}
DWfile.getModificationDate()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction renvoie l’heure &agrave; laquelle le fichier a &eacute;t&eacute; modifi&eacute; pour la derni&egrave;re fois.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
dont vous v&eacute;rifiez l’heure de la derni&egrave;re modification.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient un nombre hexad&eacute;cimal repr&eacute;sentant le nombre d’unit&eacute;s de temps &eacute;coul&eacute;es
depuis une base de temps donn&eacute;e. La signification exacte des unit&eacute;s de temps et de la base de
temps d&eacute;pend de la plate-forme ; sous Windows, par exemple, une unit&eacute; de temps est &eacute;gale &agrave;
100 ns et la base de temps est le 1er janvier 1600.
Exemple
Comme la valeur renvoy&eacute;e par cette fonction n’est pas une date et une heure identifiables et
qu’elle d&eacute;pend de la plate-forme employ&eacute;e, il est utile d’appeler la fonction deux fois pour
comparer les valeurs renvoy&eacute;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&eacute;cent :
var file1 = &quot;file:///c|/temp/file1.txt&quot;;
var file2 = &quot;file:///c|/temp/file2.txt&quot;;
var time1 = DWfile.getModificationDate(file1);
var time2 = DWfile.getModificationDate(file2);
if (time1 == time2){
alert(&quot;file1 et file2 ont &eacute;t&eacute; enregistr&eacute;s &agrave; la m&ecirc;me heure&quot;);
}else if (time1 &lt; time2){
alert(&quot;file1 est moins r&eacute;cent que file2&quot;);
} else {
alert(&quot;file1 est plus r&eacute;cent que file2&quot;);
}
36
Chapitre 2 : API d’E/S des fichiers
DWfile.getCreationDate()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction renvoie l’heure &agrave; laquelle le fichier a &eacute;t&eacute; cr&eacute;&eacute;.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
dont vous v&eacute;rifiez l’heure de cr&eacute;ation.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient un nombre hexad&eacute;cimal repr&eacute;sentant le nombre d’unit&eacute;s de temps &eacute;coul&eacute;es
depuis une base de temps donn&eacute;e. La signification exacte des unit&eacute;s de temps et de la base de
temps d&eacute;pend de la plate-forme ; sous Windows, par exemple, une unit&eacute; de temps est &eacute;gale &agrave;
100 ns et la base de temps est le 1er janvier 1600.
Exemple
Vous pouvez appeler cette fonction ainsi que la fonction DWfile.getModificationDate() pour
un fichier afin de comparer les dates de modification et de cr&eacute;ation :
var file1 = &quot;file:///c|/temp/file1.txt&quot;;
var time1 = DWfile.getCreationDate(file1);
var time2 = DWfile.getModificationDate(file1);
if (time1 == time2){
alert(&quot;file1 n’a pas &eacute;t&eacute; modifi&eacute; depuis sa cr&eacute;ation&quot;);
}else if (time1 &lt; time2){
alert(&quot;file1 a &eacute;t&eacute; modifi&eacute; pour la derni&egrave;re fois &agrave; &quot; + time2);
}
DWfile.getCreationDateObj()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction obtient l’objet JavaScript repr&eacute;sentant l’heure de cr&eacute;ation du fichier.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
dont vous v&eacute;rifiez l’heure de cr&eacute;ation.
Valeurs renvoy&eacute;es
Obtient un objet de date JavaScript repr&eacute;sentant la date et l’heure de cr&eacute;ation du fichier sp&eacute;cifi&eacute;.
API d’E/S des fichiers
37
DWfile.getModificationDateObj()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction obtient l’objet de date JavaScript repr&eacute;sentant l’heure de la derni&egrave;re modification
du fichier.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
dont vous v&eacute;rifiez l’heure de modification la plus r&eacute;cente.
Valeurs renvoy&eacute;es
Obtient un objet de date JavaScript repr&eacute;sentant la date et l’heure de la derni&egrave;re modification du
fichier sp&eacute;cifi&eacute;.
DWfile.getSize()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction obtient la taille du fichier sp&eacute;cifi&eacute;.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
dont vous v&eacute;rifiez la taille.
Valeurs renvoy&eacute;es
Nombre entier qui repr&eacute;sente la taille r&eacute;elle du fichier sp&eacute;cifi&eacute;, exprim&eacute;e en octets.
DWfile.listFolder()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction obtient une liste du contenu du dossier sp&eacute;cifi&eacute;.
38
Chapitre 2 : API d’E/S des fichiers
Arguments
folderURL, {constraint}
• L’argument folderURL est le dossier dont vous souhaitez obtenir le contenu, exprim&eacute; sous la
•
forme d’une URL de type file:// et d’un masque de fichier facultatif compos&eacute; de caract&egrave;res
g&eacute;n&eacute;riques. Les caract&egrave;res g&eacute;n&eacute;riques valides sont les ast&eacute;risques (*), qui repr&eacute;sentent un ou
plusieurs caract&egrave;res, et les points d’interrogation (?), qui repr&eacute;sentent un seul caract&egrave;re.
L’argument constraint, s’il est fourni, doit &ecirc;tre soit &quot;files&quot; (renvoyer uniquement les
fichiers), soit &quot;directories&quot; (renvoyer uniquement les dossiers). Si cet argument n’est pas
sp&eacute;cifi&eacute;, la fonction renvoie aussi bien des fichiers que des dossiers.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes repr&eacute;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 = &quot;file:///c|/temp&quot;;
var fileMask = &quot;*.txt&quot;;
var list = DWfile.listFolder(folderURL + &quot;/&quot; + fileMask, &quot;fichiers&quot;);
if (list){
alert(folderURL + &quot; contient : &quot; + list.join(&quot;\n&quot;));
}
DWfile.read()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction lit le contenu du fichier sp&eacute;cifi&eacute; dans une cha&icirc;ne.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier que
vous souhaitez lire.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne indiquant le contenu du fichier, soit la valeur null si la lecture &eacute;choue.
Exemple
Le code suivant lit le fichier mydata.txt et, s’il r&eacute;ussit, affiche un message d’avertissement
renfermant le contenu du fichier :
var fileURL = &quot;file:///c|/temp/mydata.txt&quot;;
var str = DWfile.read(fileURL);
if (str){
alert(fileURL + &quot; contient : &quot; + str);
}
API d’E/S des fichiers
39
DWfile.remove()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction d&eacute;place le fichier sp&eacute;cifi&eacute; dans la Corbeille.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier que
vous souhaitez supprimer.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si l’op&eacute;ration r&eacute;ussit et false dans le cas contraire.
Exemple
L’exemple suivant utilise la fonction DWfile.getAttributes() pour d&eacute;terminer si le fichier est
accessible en lecture seule et la fonction confirm() pour afficher &agrave; l’utilisateur une bo&icirc;te de
dialogue de type Oui/Non :
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(’Ce fichier est en lecture seule. Voulez-vous le
supprimer ?’);
if (delAnyway){
DWfile.remove(selFile);
}
}
}
DWfile.setAttributes()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction d&eacute;finit les attributs syst&egrave;me d’un fichier donn&eacute;.
40
Chapitre 2 : API d’E/S des fichiers
Arguments
fileURL, strAttrs
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, identifie le fichier dont
vous d&eacute;finissez les attributs.
• L’argument strAttrs sp&eacute;cifie les attributs syst&egrave;me du fichier identifi&eacute; par l’argument
fileURL.
Le tableau suivant d&eacute;crit les valeurs d’attribut valides et leur signification :
Valeur d’attribut
Description
R
Accessible en lecture seule
W
Accessible en &eacute;criture (annule R)
H
Masqu&eacute;
V
Visible (annule H)
Les valeurs acceptables pour la cha&icirc;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&eacute;fini comme &eacute;tant accessible en &eacute;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&eacute;fini comme &eacute;tant visible (V).
Si vous sp&eacute;cifiez l’attribut H ou V sans indiquer d’attribut de lecture/&eacute;criture R ou W, l’attribut de
lecture/&eacute;criture existant pour le fichier reste inchang&eacute;. De m&ecirc;me, si vous sp&eacute;cifiez l’attribut R
ou W sans sp&eacute;cifier un attribut de visibilit&eacute; H ou V, l’attribut de visibilit&eacute; existant pour le fichier
reste inchang&eacute;.
Valeurs renvoy&eacute;es
Aucune.
DWfile.write()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction r&eacute;dige la cha&icirc;ne sp&eacute;cifi&eacute;e dans le fichier sp&eacute;cifi&eacute;. Si le fichier sp&eacute;cifi&eacute; n’existe pas, il
est cr&eacute;&eacute;.
Arguments
fileURL, text, {mode}
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, repr&eacute;sente le fichier
dans lequel vous &eacute;crivez une cha&icirc;ne.
• L’argument text est la cha&icirc;ne qui doit &ecirc;tre &eacute;crite.
• L’argument mode, s’il est fourni, doit &ecirc;tre &quot;append&quot;. Si cet argument est omis, le contenu du
fichier est &eacute;cras&eacute; par la cha&icirc;ne.
API d’E/S des fichiers
41
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si l’&eacute;criture de la cha&icirc;ne dans le fichier a r&eacute;ussi et false dans le cas
contraire.
Exemple
Le code suivant tente d’&eacute;crire la cha&icirc;ne &quot;xxx&quot; dans le fichier mydata.txt et affiche un message
d’avertissement si l’op&eacute;ration d’&eacute;criture r&eacute;ussit. Il essaie ensuite d’annexer la cha&icirc;ne &quot;aaa&quot; au
fichier et affiche un deuxi&egrave;me message d’avertissement si cette op&eacute;ration r&eacute;ussit. Apr&egrave;s l’ex&eacute;cution
de ce script, le fichier mydata.txt contient uniquement le texte xxxaaa.
var fileURL = &quot;file:///c|/temp/mydata.txt&quot;;
if (DWfile.write(fileURL, &quot;xxx&quot;)){
alert(&quot;xxx &eacute;crit dans &quot; + fileURL);
}
if (DWfile.write(fileURL, &quot;aaa&quot;, &quot;append&quot;)){
alert(&quot;aaa annex&eacute; &agrave; &quot; + fileURL);
}
42
Chapitre 2 : API d’E/S des fichiers
CHAPITRE 3
API HTTP
Les extensions ne fonctionnent pas uniquement dans le syst&egrave;me de fichiers local. Macromedia
Dreamweaver MX 2004 permet d’&eacute;changer des informations avec un serveur Web via le
protocole HTTP (Hypertext Transfer Protocol). Ce chapitre d&eacute;crit l’API HTTP et son
utilisation.
Fonctionnement de l’API HTTP
Toutes les fonctions de l’API HTTP sont des m&eacute;thodes associ&eacute;es &agrave; 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&eacute;faut pour les arguments URL est 80. Pour sp&eacute;cifier un port diff&eacute;rent, ajoutez deux
points (:) et le num&eacute;ro de port &agrave; la suite de l’URL, comme dans l’exemple suivant :
MMHttp.getText(&quot;http://www.myserver.com:8025&quot;);
Pour les fonctions qui renvoient un objet, cet objet poss&egrave;de deux propri&eacute;t&eacute;s : statusCode et
data.
La propri&eacute;t&eacute; statusCode indique l’&eacute;tat de l’op&eacute;ration ; les valeurs possibles sont notamment :
•
•
•
•
•
•
200: Status OK (&eacute;tat OK)
400: Unintelligible request (requ&ecirc;te incompr&eacute;hensible)
404: Requested URL not found (URL demand&eacute;e introuvable)
405: Server does not support requested method (le serveur ne prend pas en charge la m&eacute;thode
demand&eacute;e)
500: Unknown server error (erreur de serveur inconnue)
503: Server capacity reached (capacit&eacute; du serveur atteinte)
Pour obtenir une liste compl&egrave;te des codes d’&eacute;tat pour votre serveur, consultez votre fournisseur
d’acc&egrave;s Internet ou votre administrateur syst&egrave;me.
La valeur de la propri&eacute;t&eacute; data varie selon la fonction ; les valeurs possibles sont sp&eacute;cifi&eacute;es dans les
listes des fonctions individuelles.
Les fonctions qui renvoient un objet ont &eacute;galement une version de rappel (&laquo; callback &raquo;). Les
fonctions de rappel permettent aux autres fonctions de s’ex&eacute;cuter pendant que le serveur Web
traite une requ&ecirc;te HTTP. Ceci est utile si vous effectuez plusieurs requ&ecirc;tes HTTP &agrave; partir de
Dreamweaver. La version de rappel d’une fonction transmet directement son ID et sa valeur de
renvoi &agrave; la fonction sp&eacute;cifi&eacute;e sous forme de premier argument.
43
API HTTP
Cette section pr&eacute;sente en d&eacute;tail les fonctions qui sont des m&eacute;thodes de l’objet MMHttp.
MMHttp.clearServerScriptsFolder()
Disponibilit&eacute;
Dreamweaver MX.
Description
Supprime le dossier _mmServerScripts (et tous ses fichiers) sous le dossier racine du site en cours,
qu’il soit local ou distant. Le dossier _mmServerScripts se trouve dans le dossier Configuration/
Connections/Scripts/server-model/_mmDBScripts.
Arguments
serverScriptsfolder
• L’argument serverScriptsfolder est une cha&icirc;ne qui nomme un dossier donn&eacute;, en liaison
avec le dossier Configuration du serveur d’application, &agrave; partir duquel vous pouvez extraire et
supprimer les scripts de serveur.
Valeurs renvoy&eacute;es
Un objet repr&eacute;sentant la r&eacute;ponse du serveur. La propri&eacute;t&eacute; data de cet objet est une cha&icirc;ne
englobant le contenu des scripts supprim&eacute;s. Si une erreur se produit, Dreamweaver la consigne
dans la propri&eacute;t&eacute; statusCode de l’objet renvoy&eacute;.
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&eacute;e depuis un
menu :
&lt;!-- MENU-LOCATION=NONE --&gt;
&lt;html&gt;
&lt;head&gt;
&lt;TITLE&gt;Clear Server Scripts&lt;/TITLE&gt;
&lt;SCRIPT SRC=&quot;ClearServerScripts.js&quot;&gt;&lt;/SCRIPT&gt;
&lt;SCRIPT LANGUAGE=&quot;javascript&quot;&gt;
&lt;/SCRIPT&gt;
&lt;body onLoad=&quot;MMHttp.clearServerScriptsFolder()&quot;&gt;
&lt;/body&gt;
&lt;/html&gt;
MMHttp.clearTemp()
Description
Cette fonction supprime tous les fichiers du dossier Configuration/Temp situ&eacute; dans le dossier de
l’application Dreamweaver.
Arguments
Aucun.
44
Chapitre 3 : API HTTP
Valeurs renvoy&eacute;es
Aucune.
Exemple
Le code suivant, lorsqu’il est enregistr&eacute; dans un fichier du dossier Configuration/Shutdown,
supprime tous les fichiers du dossier Configuration/Temp lorsque l’utilisateur quitte
Dreamweaver :
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;Clean Up Temp Files on Shutdown&lt;/title&gt;
&lt;/head&gt;
&lt;body onLoad=&quot;MMHttp.clearTemp()&quot;&gt;
&lt;/body&gt;
&lt;/html&gt;
MMHttp.getFile()
Description
Cette fonction obtient le fichier situ&eacute; &agrave; l’URL sp&eacute;cifi&eacute;e et l’enregistre dans le dossier
Configuration/Temp situ&eacute; dans le dossier de l’application Dreamweaver. Dreamweaver cr&eacute;e
automatiquement des sous-dossiers qui reproduisent la structure de dossiers du serveur ; par
exemple, si le fichier sp&eacute;cifi&eacute; 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&eacute; dans
l’URL, Dreamweaver MX consid&egrave;re qu’il s’agit du protocole HTTP.
• L’argument facultatif prompt est une valeur bool&eacute;enne sp&eacute;cifiant s’il faut inviter l’utilisateur &agrave;
enregistrer le fichier. Si saveURL est en dehors du dossier Configuration/Temp, une valeur de
&eacute;gale &agrave; false n’est pas prise en compte pour des raisons de s&eacute;curit&eacute;.
L’argument facultatif saveURL est l’emplacement sur le disque dur de l’utilisateur o&ugrave; le fichier
doit &ecirc;tre enregistr&eacute;, exprim&eacute; 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&icirc;te de dialogue d’enregistrement.
L’argument facultatif titleBarLabel est le libell&eacute; qui doit figurer dans la barre de titre de la
bo&icirc;te de dialogue d’enregistrement.
prompt
•
•
API HTTP
45
Valeurs renvoy&eacute;es
Un objet repr&eacute;sentant la r&eacute;ponse du serveur. La propri&eacute;t&eacute; data de cet objet est une cha&icirc;ne
contenant l’emplacement o&ugrave; le fichier a &eacute;t&eacute; enregistr&eacute;, exprim&eacute; sous la forme d’une URL de type
file://. Normalement, la propri&eacute;t&eacute; statusCode de l’objet contient le code d’&eacute;tat envoy&eacute; par le
serveur. Toutefois, si une erreur de disque se produit lors de l’enregistrement du fichier sur le
lecteur local, la propri&eacute;t&eacute; statusCode contient un entier repr&eacute;sentant l’un des codes d’erreur
suivants en cas d’&eacute;chec de l’op&eacute;ration :
•
•
•
•
•
•
•
•
•
•
•
•
•
•
1: Unspecified error (erreur inconnue)
2: File not found (fichier introuvable)
3: Invalid path (chemin non valide)
4: Number of open files limit reached (la limite du nombre de fichiers ouverts est atteinte)
5: Access denied (acc&egrave;s refus&eacute;)
6: Invalid file handle (identificateur de fichier non valide)
7: Cannot remove current working directory (impossible de supprimer le r&eacute;pertoire de travail
en cours)
8: No more folder entries (plus d’entr&eacute;es de dossier)
9: Error setting file pointer (erreur lors de la d&eacute;finition du pointeur de fichier)
10: Hardware error (erreur mat&eacute;rielle)
11: Sharing violation (violation de partage)
12: Lock violation (violation de verrouillage)
13: Disk full (disque satur&eacute;)
14: End of file reached (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(&quot;http://www.dreamcentral.com/&not;
people/profiles/scott.html&quot;,
false);
if (httpReply.statusCode == 200){
var saveLoc = httpReply.data;
dw.browseDocument(saveLoc);
}
MMHttp.getFileCallback()
Description
Cette fonction obtient le fichier situ&eacute; &agrave; l’URL sp&eacute;cifi&eacute;e, l’enregistre dans le dossier Configuration/
Temp du dossier de l’application Dreamweaver, puis appelle la fonction sp&eacute;cifi&eacute;e avec l’ID et le
r&eacute;sultat de la requ&ecirc;te. Lorsque le fichier est enregistr&eacute; localement, Dreamweaver cr&eacute;e
automatiquement des sous-dossiers qui reproduisent la structure de dossiers du serveur ; par
exemple, si le fichier sp&eacute;cifi&eacute; est dans www.dreamcentral.com/people/index.html, Dreamweaver
enregistre le fichier index.html dans le sous-dossier People du dossier www.dreamcentral.com.
46
Chapitre 3 : API HTTP
Arguments
callbackFunction, URL, {prompt}, {saveURL}, {titleBarLabel}
• L’argument callbackFunction est le nom de la fonction JavaScript &agrave; appeler lorsque la
requ&ecirc;te HTTP est termin&eacute;e.
• L’argument URL est une URL absolue sur un serveur Web ; si http:// n’est pas indiqu&eacute; dans
l’URL, Dreamweaver MX consid&egrave;re qu’il s’agit du protocole HTTP.
• L’argument facultatif prompt est une valeur bool&eacute;enne sp&eacute;cifiant s’il faut inviter l’utilisateur &agrave;
•
•
enregistrer le fichier. Si l’argument saveURL sp&eacute;cifie un emplacement en dehors du dossier
Configuration/Temp, une valeur de prompt &eacute;gale &agrave; false n’est pas prise en compte pour des
raisons de s&eacute;curit&eacute;.
L’argument facultatif saveURL est l’emplacement sur le disque dur de l’utilisateur o&ugrave; le fichier
doit &ecirc;tre enregistr&eacute;, exprim&eacute; 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&icirc;te de dialogue d’enregistrement.
L’argument facultatif titleBarLabel est le libell&eacute; qui doit figurer dans la barre de titre de la
bo&icirc;te de dialogue d’enregistrement.
Valeurs renvoy&eacute;es
Un objet repr&eacute;sentant la r&eacute;ponse du serveur. La propri&eacute;t&eacute; data de cet objet est une cha&icirc;ne
contenant l’emplacement o&ugrave; le fichier a &eacute;t&eacute; enregistr&eacute;, exprim&eacute; sous la forme d’une URL de type
file://. Normalement, la propri&eacute;t&eacute; statusCode de l’objet contient le code d’&eacute;tat envoy&eacute; par le
serveur. Toutefois, si une erreur disque se produit lors de l’enregistrement du fichier sur le lecteur
local, la propri&eacute;t&eacute; statusCode contient un nombre entier repr&eacute;sentant un code d’erreur. Voir
MMHttp.getFile() pour une liste des codes d’erreur possibles.
MMHttp.getText()
Disponibilit&eacute;
Macromedia Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Extrait le contenu du document situ&eacute; &agrave; l’URL sp&eacute;cifi&eacute;e.
Arguments
URL, {serverScriptsFolder}
• L’argument URL est une URL absolue sur un serveur Web. Si http:// n’est pas indiqu&eacute; dans
•
l’URL, Dreamweaver consid&egrave;re qu’il s’agit du protocole HTTP.
L’argument serverScriptsFolder est une cha&icirc;ne facultative qui nomme un dossier
sp&eacute;cifique, li&eacute; au dossier Configuration du serveur d’application, &agrave; partir duquel vous souhaitez
extraire les scripts de serveur. Pour extraire les scripts, Dreamweaver utilise le protocole de
transfert appropri&eacute; (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&eacute;t&eacute; statusCode de l’objet
renvoy&eacute;.
API HTTP
47
MMHttp.getTextCallback()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute; dans Dreamweaver MX.
Description
Extrait le contenu du document situ&eacute; &agrave; l’URL sp&eacute;cifi&eacute;e et le transmet &agrave; la fonction sp&eacute;cifi&eacute;e.
Arguments
callbackFunc, URL, {serverScriptsFolder}
• L’argument callbackFunc est la fonction JavaScript &agrave; appeler lorsque la requ&ecirc;te HTTP est
termin&eacute;e.
• L’argument URL est une URL absolue sur un serveur Web ; si http:// n’est pas indiqu&eacute; dans
l’URL, Dreamweaver MX consid&egrave;re qu’il s’agit du protocole HTTP.
• L’argument serverScriptsFolder est une cha&icirc;ne facultative qui nomme un dossier
sp&eacute;cifique, li&eacute; au dossier Configuration du serveur d’application, &agrave; partir duquel vous souhaitez
extraire les scripts de serveur. Pour extraire les scripts, Dreamweaver utilise le protocole de
transfert appropri&eacute; (par exemple FTP, WebDAV ou Remote File System). Dreamweaver extrait
ces fichiers et les transmet &agrave; la fonction identifi&eacute;e par callbackFunc.
Si une erreur survient, Dreamweaver MX la consigne dans la propri&eacute;t&eacute; statusCode de l’objet
renvoy&eacute;.
MMHttp.postText()
Disponibilit&eacute;
Macromedia Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Ex&eacute;cute un envoi HTTP des donn&eacute;es d&eacute;finies &agrave; l’URL sp&eacute;cifi&eacute;e. En r&egrave;gle g&eacute;n&eacute;rale, les donn&eacute;es
associ&eacute;es &agrave; une op&eacute;ration d’envoi se pr&eacute;sentent sous la forme de texte cod&eacute; en formulaire, mais il
peut s’agir de tout type de donn&eacute;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&eacute; dans
l’URL, Dreamweaver MX consid&egrave;re qu’il s’agit du protocole HTTP.
• L’argument dataToPost repr&eacute;sente les donn&eacute;es &agrave; envoyer. Si le troisi&egrave;me argument est
ou s’il n’est pas sp&eacute;cifi&eacute;, dataToPost doit &ecirc;tre
cod&eacute; en formulaire conform&eacute;ment &agrave; la section 8.2.1 de la sp&eacute;cification RFC 1866 (disponible
&agrave; l’adresse www.faqs.org/rfcs/rfc1866.html).
L’argument facultatif contentType est le type de contenu des donn&eacute;es &agrave; envoyer. S’il n’est pas
sp&eacute;cifi&eacute;, il prend par d&eacute;faut la valeur &quot;application/x-www-form-urlencoded&quot;.
L’argument serverScriptsFolder est une cha&icirc;ne facultative qui nomme un dossier
sp&eacute;cifique, li&eacute; au dossier Configuration du serveur d’application, vers lequel vous souhaitez
envoyer les donn&eacute;es. Pour envoyer les donn&eacute;es, Dreamweaver utilise le protocole de transfert
appropri&eacute; (par exemple FTP, WebDAV ou Remote File System).
&quot;application/x-www-form-urlencoded&quot;
•
•
48
Chapitre 3 : API HTTP
Si une erreur se produit, Dreamweaver la consigne dans la propri&eacute;t&eacute; statusCode de l’objet
renvoy&eacute;.
Exemple
Dans l’exemple suivant d’appel de la fonction MMHttp.postText(), supposons qu’un
d&eacute;veloppeur a plac&eacute; le fichier myScripts.cfm dans un dossier nomm&eacute; DeployScripts, qui se trouve
dans le dossier Configuration sur l’ordinateur local :
MMHttp.postText(
&quot;http://ultraqa8/DeployScripts/myScripts.cfm&quot;,
&quot;arg1=Foo&quot;,
&quot;application/x-www-form-urlencoded&quot;,
&quot;Configuration/DeployScripts/&quot;
)
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&eacute;
dans un autre dossier nomm&eacute; DeployScripts, qui constitue un sous-dossier du dossier racine du
site Web ultraqa8. Pour d&eacute;ployer les fichiers, Dreamweaver utilise le protocole sp&eacute;cifi&eacute; dans les
propri&eacute;t&eacute;s de configuration du site.
2 Dreamweaver utilise le protocole HTTP pour envoyer les donn&eacute;es arg1=Foo vers le
serveur Web.
3 En r&eacute;ponse &agrave; la requ&ecirc;te d’envoi, le serveur Web sur ultraqa8 ex&eacute;cute le script myScripts.cfm &agrave;
l’aide des donn&eacute;es arg1.
MMHttp.postTextCallback()
Disponibilit&eacute;
Macromedia Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Ex&eacute;cute un envoi HTTP du texte &agrave; l’URL sp&eacute;cifi&eacute;e et transmet la r&eacute;ponse du serveur &agrave; la fonction
sp&eacute;cifi&eacute;e. En r&egrave;gle g&eacute;n&eacute;rale, les donn&eacute;es associ&eacute;es &agrave; une op&eacute;ration d’envoi se pr&eacute;sentent sous la
forme de texte cod&eacute; en formulaire, mais il peut s’agir de tout type de donn&eacute;es que le serveur peut
accepter.
Arguments
callbackFunc, URL, dataToPost, {contentType}, {serverScriptsFolder}
• L’argument callbackFunc est le nom de la fonction JavaScript &agrave; appeler lorsque la requ&ecirc;te
•
•
•
HTTP est termin&eacute;e.
L’argument URL est une URL absolue sur un serveur Web ; si http:// n’est pas indiqu&eacute; dans
l’URL, Dreamweaver MX consid&egrave;re qu’il s’agit du protocole HTTP.
L’argument dataToPost repr&eacute;sente les donn&eacute;es &agrave; envoyer. Si le troisi&egrave;me argument est
&quot;application/x-www-form-urlencoded&quot; ou s’il n’est pas sp&eacute;cifi&eacute;, dataToPost doit &ecirc;tre
cod&eacute; en formulaire conform&eacute;ment &agrave; la section 8.2.1 de la sp&eacute;cification RFC 1866 (disponible
&agrave; l’adresse www.faqs.org/rfcs/rfc1866.html).
L’argument facultatif contentType correspond au type de contenu des donn&eacute;es &agrave; envoyer. S’il
n’est pas sp&eacute;cifi&eacute;, il prend par d&eacute;faut la valeur &quot;application/x-www-form-urlencoded&quot;.
API HTTP
49
• L’argument serverScriptsFolder est une cha&icirc;ne facultative. Il nomme un dossier donn&eacute;, en
liaison avec le dossier Configuration du serveur d’application sur lequel vous voulez envoyer les
donn&eacute;es. Pour envoyer les donn&eacute;es, Dreamweaver utilise le protocole de transfert appropri&eacute;
(par exemple FTP, WebDAV ou Remote File System). Dreamweaver extrait ces donn&eacute;es et les
transmet &agrave; la fonction identifi&eacute;e par callbackFunc.
Si une erreur se produit, Dreamweaver la consigne dans la propri&eacute;t&eacute; statusCode de l’objet
renvoy&eacute;.
50
Chapitre 3 : API HTTP
CHAPITRE 4
API de Design Notes
Macromedia Dreamweaver, Macromedia Fireworks et Macromedia Flash MX 2004 permettent
aux concepteurs et d&eacute;veloppeurs de sites Web de stocker et de r&eacute;cup&eacute;rer des informations
compl&eacute;mentaires sur les documents (telles que des commentaires de r&eacute;vision, des notes de
modification ou le fichier source d’un document GIF ou JPEG) dans des fichiers appel&eacute;s Design
Notes.
MMNotes est une biblioth&egrave;que C partag&eacute;e qui permet aux auteurs d’extensions de lire et d’&eacute;crire
dans les fichiers Design Notes. A l’instar de la biblioth&egrave;que partag&eacute;e DWfile, MMNotes poss&egrave;de
une API JavaScript qui permet d’appeler les fonctions contenues dans la biblioth&egrave;que &agrave; partir
d’objets, de commandes, de comportements, de panneaux flottants, d’inspecteurs de propri&eacute;t&eacute;s et
de traducteurs de donn&eacute;es.
MMNotes poss&egrave;de &eacute;galement une API C qui donne &agrave; d’autres applications la possibilit&eacute; de lire et
d’&eacute;crire dans les fichiers Design Notes. La biblioth&egrave;que partag&eacute;e MMNotes peut &ecirc;tre utilis&eacute;e
ind&eacute;pendamment de Dreamweaver, que celui-ci soit install&eacute; ou non.
Pour plus d’informations sur l’utilisation de la fonctionnalit&eacute; Design Notes dans Dreamweaver,
voir le manuel Utilisation de Dreamweaver.
Fonctionnement de Design Notes
Chaque fichier Design Notes stocke des informations relatives &agrave; un seul document. Si un fichier
Design Notes est associ&eacute; &agrave; un ou plusieurs documents dans un dossier, Dreamweaver cr&eacute;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&ecirc;tre Site, mais ils s’affichent dans le
Finder Macintosh ou dans l’Explorateur Windows. Un nom de fichier Design Notes est compos&eacute;
du nom du fichier principal suivi de l’extension .mno. Par exemple, le fichier Design Notes
associ&eacute; &agrave; avocado8.gif est avocado8.gif.mno.
Les fichiers Design Notes sont des fichiers XML stockant des informations sous la forme d’une
s&eacute;rie de paires cl&eacute;/valeur. La cl&eacute; d&eacute;crit le type des informations stock&eacute;es et la valeur repr&eacute;sente les
informations. Les cl&eacute;s sont limit&eacute;es &agrave; 64 caract&egrave;res.
51
L’exemple suivant illustre le fichier Design Notes associ&eacute; au fichier foghorn.gif.mno :
&lt;?xml version=&quot;1.0&quot; encoding=&quot;iso-8859-1&quot; ?&gt;
&lt;info&gt;
&lt;infoitem key=&quot;FW_source&quot; value=&quot;file:///C|sites/&not;
dreamcentral/images/sourceFiles/foghorn.png&quot; /&gt;
&lt;infoitem key=&quot;Author&quot; value=&quot;Heidi B.&quot; /&gt;
&lt;infoitem key=&quot;Status&quot; value=&quot;Final draft, approved &not;
by Jay L.&quot; /&gt;
&lt;/info&gt;
API JavaScript de Design Notes
Toutes les fonctions de l’API JavaScript de Design Notes sont des m&eacute;thodes associ&eacute;es &agrave; l’objet
MMNotes.
MMNotes.close()
Description
Cette fonction ferme le fichier Design Notes sp&eacute;cifi&eacute; et enregistre les modifications &eacute;ventuelles. Si
toutes les paires cl&eacute;/valeur ont &eacute;t&eacute; supprim&eacute;es, Dreamweaver supprime le fichier Design Notes.
S’il s’agit du dernier fichier Design Notes dans le dossier _notes, Dreamweaver supprime
&eacute;galement le dossier.
Remarque : Appelez toujours la fonction MMNotes.close() une fois le travail sur les Design Notes
termin&eacute;, afin que Dreamweaver &eacute;crive sur le fichier.
Arguments
fileHandle
• L’argument fileHandle est l’identificateur de fichier renvoy&eacute; par la fonction
MMNotes.open().
Valeurs renvoy&eacute;es
Aucune.
Exemple
Voir MMNotes.set(), page 56.
MMNotes.filePathToLocalURL()
Description
Cette fonction convertit le chemin d’acc&egrave;s du lecteur local sp&eacute;cifi&eacute; en une URL de type file://.
Arguments
drivePath
• L’argument drivePath est une cha&icirc;ne contenant le chemin d’acc&egrave;s complet du lecteur.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant l’URL de type file:// du fichier sp&eacute;cifi&eacute;.
52
Chapitre 4 : API de Design Notes
Exemple
Un appel &agrave; la fonction MMNotes.filePathToLocalURL('C:/sites/webdev/index.htm')
renvoie &quot;file:///c|sites/webdev/index.htm&quot;.
MMNotes.get()
Description
Cette fonction obtient la valeur de la cl&eacute; sp&eacute;cifi&eacute;e dans le fichier Design Notes indiqu&eacute;.
Arguments
fileHandle, keyName
• L’argument fileHandle est l’identificateur de fichier renvoy&eacute; par MMNotes.open().
• L’argument keyName est une cha&icirc;ne contenant le nom de la cl&eacute;.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant la valeur de la cl&eacute;.
Exemple
Voir MMNotes.getKeys(), page 53.
MMNotes.getKeyCount()
Description
Cette fonction obtient le nombre de paires cl&eacute;/valeur du fichier Design Notes sp&eacute;cifi&eacute;.
Arguments
fileHandle
• L’argument fileHandle est l’identificateur de fichier renvoy&eacute; par la fonction
MMNotes.open().
Valeurs renvoy&eacute;es
Un nombre entier repr&eacute;sentant le nombre de paires cl&eacute;/valeur du fichier Design Notes sp&eacute;cifi&eacute;.
MMNotes.getKeys()
Description
Cette fonction obtient une liste de toutes les cl&eacute;s d’un fichier Design Notes.
Arguments
fileHandle
• L’argument fileHandle est l’identificateur de fichier renvoy&eacute; par la fonction
MMNotes.open().
Valeurs renvoy&eacute;es
Un tableau de cha&icirc;nes, chacune d’elles contenant le nom d’une cl&eacute;.
API JavaScript de Design Notes
53
Exemple
Le code suivant peut &ecirc;tre utilis&eacute; dans un panneau flottant personnalis&eacute; afin d’afficher les
informations Design Notes relatives au document actif :
var noteHandle = MMNotes.open(dw.getDocumentDOM().URL);
var theKeys = MMNotes.getKeys(noteHandle);
var noteString = &quot;&quot;;
var theValue = &quot;&quot;;
for (var i=0; i &lt; theKeys.length; i++){
theValue = MMNotes.get(noteHandle,theKeys[i]);
noteString += theKeys[i] + &quot; = &quot; theValue + &quot;\n&quot;;
}
document.theForm.bigTextField.value = noteString;
// always close noteHandle
MMNotes.close(noteHandle);
MMNotes.getSiteRootForFile()
Description
Cette fonction d&eacute;termine la racine du site pour le fichier Design Notes sp&eacute;cifi&eacute;.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, est le chemin d’un
fichier local.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le chemin du dossier racine local pour le site, exprim&eacute; sous la forme d’une
URL de type file://, ou une cha&icirc;ne vide si Dreamweaver n’est pas install&eacute; ou si le fichier Design
Notes se trouve en dehors de tout site d&eacute;fini par Dreamweaver. Cette fonction recherche tous les
sites d&eacute;finis dans Dreamweaver.
MMNotes.getVersionName()
Description
Cette fonction obtient le nom de version de la biblioth&egrave;que partag&eacute;e MMNotes indiquant
l’application qui l’a impl&eacute;ment&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le nom de l’application qui a impl&eacute;ment&eacute; la biblioth&egrave;que partag&eacute;e
MMNotes.
54
Chapitre 4 : API de Design Notes
Exemple
L’appel de la fonction MMNotes.getVersionName() &agrave; partir d’une commande, d’un objet, d’un
comportement, d’un inspecteur de propri&eacute;t&eacute;s, d’un panneau flottant ou d’un traducteur de
donn&eacute;es Dreamweaver renvoie &quot;Dreamweaver&quot;. L’appel de la fonction
MMNotes.getVersionName() &agrave; partir de Fireworks renvoie &eacute;galement la valeur &quot;Dreamweaver&quot;
&eacute;tant donn&eacute; que Fireworks utilise la m&ecirc;me version de la biblioth&egrave;que (celle qui a &eacute;t&eacute; cr&eacute;&eacute;e par
l’&eacute;quipe technique de Dreamweaver).
MMNotes.getVersionNum()
Description
Cette fonction obtient le num&eacute;ro de version de la biblioth&egrave;que partag&eacute;e MMNotes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le num&eacute;ro de version.
MMNotes.localURLToFilePath()
Description
Cette fonction convertit l’URL de type file:// sp&eacute;cifi&eacute;e en un chemin d’acc&egrave;s du lecteur local.
Arguments
fileURL
• L’argument fileURL, exprim&eacute; sous la forme d’une URL de type file://, est le chemin d’un
fichier local.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le chemin d’acc&egrave;s du lecteur local pour le fichier sp&eacute;cifi&eacute;.
Exemple
Un appel &agrave; la fonction MMNotes.localURLToFilePath('file:///MacintoshHD/images/
moon.gif') renvoie &quot;MacintoshHD:images:moon.gif&quot;.
MMNotes.open()
Description
Cette fonction ouvre le fichier Design Notes associ&eacute; au fichier sp&eacute;cifi&eacute; ou cr&eacute;e un fichier Design
Notes s’il n’en existe pas.
Arguments
filePath, {bForceCreate}
• L’argument filePath, exprim&eacute; sous la forme d’une URL de type file://, est le chemin du
fichier principal auquel le fichier Design Notes est associ&eacute;.
API JavaScript de Design Notes
55
• L’argument bForceCreate est une valeur bool&eacute;enne indiquant si la note doit &ecirc;tre cr&eacute;&eacute;e m&ecirc;me
si la fonctionnalit&eacute; Design Notes est d&eacute;sactiv&eacute;e pour le site ou si l’argument filePath n’est
associ&eacute; &agrave; aucun site.
Valeurs renvoy&eacute;es
L’identificateur du fichier Design Notes ou z&eacute;ro (0) si le fichier n’a pas &eacute;t&eacute; ouvert ni cr&eacute;&eacute;.
Exemple
Voir MMNotes.set(), page 56.
MMNotes.remove()
Description
Cette fonction supprime la cl&eacute; sp&eacute;cifi&eacute;e (et sa valeur) du fichier Design Notes indiqu&eacute;.
Arguments
fileHandle, keyName
• L’argument fileHandle est l’identificateur de fichier renvoy&eacute; par la fonction
MMNotes.open().
• L’argument keyName est une cha&icirc;ne contenant le nom de la cl&eacute; &agrave; supprimer.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec.
MMNotes.set()
Description
Cette fonction cr&eacute;e ou met &agrave; jour une paire cl&eacute;/valeur dans un fichier Design Notes.
Arguments
fileHandle, keyName, valueString
• L’argument fileHandle est l’identificateur de fichier renvoy&eacute; par la fonction
MMNotes.open().
• L’argument keyName est une cha&icirc;ne contenant le nom de la cl&eacute;.
• L’argument valueString est une cha&icirc;ne contenant la valeur.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec.
Exemple
L’exemple suivant ouvre le fichier Design Notes associ&eacute; &agrave; un fichier situ&eacute; sur le site dreamcentral
appel&eacute; peakhike99/index.html, ajoute une nouvelle paire cl&eacute;/valeur, modifie la valeur d’une cl&eacute;
existante, puis ferme le fichier de Design Notes :
var noteHandle = MMNotes.open('file:///c|/sites/dreamcentral/
peakhike99/index.html',true);
if(noteHandle &gt; 0){
MMNotes.set(noteHandle,&quot;Author&quot;,&quot;M. G. Miller&quot;);
56
Chapitre 4 : API de Design Notes
MMNotes.set(noteHandle,&quot;Last Changed&quot;,&quot;28 ao&ucirc;t 1999&quot;);
MMNotes.close(noteHandle);
}
API C de Design Notes
Outre l’API JavaScript, la biblioth&egrave;que partag&eacute;e MMNotes affiche une API C permettant aux
autres applications de cr&eacute;er des fichiers Design Notes. Il n’est pas n&eacute;cessaire d’appeler les fonctions
C directement si vous utilisez la biblioth&egrave;que partag&eacute;e MMNotes dans Dreamweaver ; les versions
JavaScript de ces fonctions les appellent pour vous.
Cette section d&eacute;crit ces fonctions, leurs arguments et les valeurs qu’elles renvoient. Les d&eacute;finitions
de toutes les fonctions et de tous les types de donn&eacute;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&eacute;cifi&eacute; et enregistre les modifications &eacute;ventuelles. Si
toutes les paires cl&eacute;/valeur ont &eacute;t&eacute; supprim&eacute;es du fichier Design Notes, Dreamweaver supprime ce
dernier. Dreamweaver supprime le dossier _notes lorsque le dernier fichier Design Notes est
supprim&eacute;.
Arguments
FileHandle noteHandle
• L’argument noteHandle est l’identificateur de fichier renvoy&eacute; par la fonction
OpenNotesFile().
Valeurs renvoy&eacute;es
Aucune.
BOOL FilePathToLocalURL()
Description
Cette fonction convertit le chemin d’acc&egrave;s du lecteur local sp&eacute;cifi&eacute; en une URL de type file://.
Arguments
const char* drivePath, char* localURLBuf, int localURLMaxLen
• L’argument drivePath est une cha&icirc;ne contenant le chemin d’acc&egrave;s complet du lecteur.
• L’argument localURLBuf est la zone de m&eacute;moire tampon o&ugrave; l’URL de type file:// est stock&eacute;e.
• L’argument localURLMaxLen est la taille maximale de localURLBuf.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. L’argument
localURLBuf re&ccedil;oit la valeur de l’URL de type file://.
API C de Design Notes
57
BOOL GetNote()
Description
Cette fonction obtient la valeur de la cl&eacute; sp&eacute;cifi&eacute;e dans le fichier Design Notes indiqu&eacute;.
Arguments
FileHandle noteHandle, const char keyName[64], char* valueBuf, int valueBufLength
• L’argument noteHandle est l’identificateur de fichier renvoy&eacute; par la fonction
OpenNotesFile().
• L’argument keyName[64] est une cha&icirc;ne contenant le nom de la cl&eacute;.
• L’argument valueBuf est la zone de m&eacute;moire tampon o&ugrave; la valeur est stock&eacute;e.
• L’argument valueBufLength est le nombre entier renvoy&eacute; par GetNoteLength(noteHandle,
keyName),
indiquant la longueur maximale de la m&eacute;moire tampon des valeurs.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. L’argument
valueBuf re&ccedil;oit la valeur de la cl&eacute;.
Exemple
Le code suivant obtient la valeur de la cl&eacute; comments dans le fichier Design Notes associ&eacute; au fichier
welcome.html :
FileHandle noteHandle = OpenNotesFile(&quot;file:///c|/sites/avocado8/&not;
iwjs/welcome.html&quot;);
if(noteHandle &gt; 0){
int valueLength = GetNoteLength( noteHandle, &quot;comments&quot;);
char* valueBuffer = new char[valueLength + 1];
GetNote(noteHandle, &quot;comments&quot;, valueBuffer, valueLength + 1);
printf(&quot;Comments: %s&quot;,valueBuffer);
CloseNotesFile(noteHandle);
}
int GetNoteLength()
Description
Cette fonction obtient la longueur de la valeur associ&eacute;e &agrave; la cl&eacute; sp&eacute;cifi&eacute;e.
Arguments
FileHandle noteHandle, const char keyName[64]
• L’argument noteHandle est l’identificateur de fichier renvoy&eacute; par la fonction
OpenNotesFile().
• L’argument keyName[64] est une cha&icirc;ne contenant le nom de la cl&eacute;.
Valeurs renvoy&eacute;es
Un nombre entier repr&eacute;sentant la longueur de la valeur.
Exemple
Voir BOOL GetNote(), page 58.
58
Chapitre 4 : API de Design Notes
int GetNotesKeyCount()
Description
Cette fonction obtient le nombre de paires cl&eacute;/valeur du fichier Design Notes sp&eacute;cifi&eacute;.
Arguments
FileHandle noteHandle
• L’argument noteHandle est l’identificateur de fichier renvoy&eacute; par la fonction
OpenNotesFile().
Valeurs renvoy&eacute;es
Un nombre entier repr&eacute;sentant le nombre de paires cl&eacute;/valeur du fichier Design Notes sp&eacute;cifi&eacute;.
BOOL GetNotesKeys()
Description
Cette fonction obtient une liste de toutes les cl&eacute;s d’un fichier Design Notes.
Arguments
FileHandle noteHandle, char* keyBufArray[64], int keyArrayMaxLen
• L’argument noteHandle est l’identificateur de fichier renvoy&eacute; par OpenNotesFile().
• L’argument keyBufArray[64] est le tableau en m&eacute;moire tampon o&ugrave; les cl&eacute;s sont stock&eacute;es.
• L’argument keyArrayMaxLen est le nombre entier renvoy&eacute; par
GetNotesKeyCount(noteHandle), indiquant le nombre maximum d’&eacute;l&eacute;ments contenus dans
le tableau en m&eacute;moire tampon des cl&eacute;s.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. L’argument
keyBufArray re&ccedil;oit les noms de cl&eacute;.
Exemple
Le code suivant imprime les noms de cl&eacute; et les valeurs de toutes les cl&eacute;s du fichier Design Notes
associ&eacute; au fichier welcome.html :
typedef char[64] InfoKey;
FileHandle noteHandle = OpenNotesFile(&quot;file:///c|/sites/avocado8/&not;
iwjs/welcome.html&quot;);
if (noteHandle &gt; 0){
int keyCount = GetNotesKeyCount(noteHandle);
if (keyCount &lt;= 0)
return;
InfoKey* keys = new InfoKey[keyCount];
BOOL succeeded = GetNotesKeys(noteHandle, keys, keyCount);
if (succeeded){
for (int i=0; i &lt; keyCount; i++){
printf(&quot;Key is: %s\n&quot;, keys[i]);
printf(&quot;Value is: %s\n\n&quot;, GetNote(noteHandle, keys[i]);
}
}
delete []keys;
API C de Design Notes
59
}
CloseNotesFile(noteHandle);
BOOL GetSiteRootForFile()
Description
Cette fonction d&eacute;termine la racine du site pour le fichier Design Notes sp&eacute;cifi&eacute;.
Arguments
const char* filePath, char* siteRootBuf, int siteRootBufMaxLen, {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&eacute;moire tampon o&ugrave; la racine du site est stock&eacute;e.
L’argument siteRootBufMaxLen est la taille maximale de la m&eacute;moire tampon r&eacute;f&eacute;renc&eacute;e par
siteRootBuf.
L’argument facultatif infoPrefs est une r&eacute;f&eacute;rence &agrave; un struct dans lequel les pr&eacute;f&eacute;rences du
site sont stock&eacute;es.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. L’argument
siteRootBuf re&ccedil;oit l’adresse de la m&eacute;moire tampon qui stocke la racine du site. Si vous sp&eacute;cifiez
l’argument infoPrefs, la fonction renvoie &eacute;galement les pr&eacute;f&eacute;rences de Design Notes pour le site.
Le struct InfoPrefs poss&egrave;de deux variables : bUseDesignNotes et bUploadDesignNotes, toutes
deux de type BOOL.
BOOL GetVersionName()
Description
Cette fonction obtient le nom de version de la biblioth&egrave;que partag&eacute;e MMNotes indiquant
l’application qui l’a impl&eacute;ment&eacute;e.
Arguments
char* versionNameBuf, int versionNameBufMaxLen
• L’argument versionNameBuf est la zone de m&eacute;moire tampon o&ugrave; le nom de version est stock&eacute;.
• L’argument versionNameBufMaxLen est la taille maximale de la m&eacute;moire tampon r&eacute;f&eacute;renc&eacute;e
par versionNameBuf.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. Dreamweaver
stocke Dreamweaver dans l’argument versionNameBuf.
BOOL GetVersionNum()
Description
Cette fonction obtient le num&eacute;ro de version de la biblioth&egrave;que partag&eacute;e MMNotes, ce qui vous
permet de savoir si certaines fonctions sont disponibles.
60
Chapitre 4 : API de Design Notes
Arguments
char* versionNumBuf, int versionNumBufMaxLen
• L’argument versionNumBuf est la zone de m&eacute;moire tampon o&ugrave; le num&eacute;ro de version est
stock&eacute;.
• L’argument versionNumBufMaxLen est la taille maximale de la m&eacute;moire tampon r&eacute;f&eacute;renc&eacute;e
par versionNumBuf.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. L’argument
versionNumBuf stocke le num&eacute;ro de version.
BOOL LocalURLToFilePath()
Description
Cette fonction convertit l’URL de type file:// sp&eacute;cifi&eacute;e en un chemin d’acc&egrave;s du lecteur local.
Arguments
const char* localURL, char* drivePathBuf, int drivePathMaxLen
• L’argument localURL, exprim&eacute; sous la forme d’une URL de type file://, est le chemin d’un
fichier local.
• L’argument drivePathBuf est la zone de m&eacute;moire tampon o&ugrave; le chemin d’acc&egrave;s du lecteur
•
local est stock&eacute;.
L’argument drivePathMaxLen est la taille maximale de la m&eacute;moire tampon r&eacute;f&eacute;renc&eacute;e par
drivePathBuf.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec. L’argument
drivePathBuf re&ccedil;oit le chemin de fichier local.
FileHandle OpenNotesFile()
Description
Cette fonction ouvre le fichier Design Notes associ&eacute; au fichier sp&eacute;cifi&eacute; ou cr&eacute;e un fichier Design
Notes s’il n’en existe pas.
Arguments
const char* localFileURL, {BOOL bForceCreate}
• L’argument localFileURL, exprim&eacute; sous la forme d’une URL de type file://, est une cha&icirc;ne
contenant le chemin du fichier principal auquel le fichier Design Notes est associ&eacute;.
• L’argument bForceCreate est une valeur bool&eacute;enne indiquant si le fichier Design Notes doit
&ecirc;tre cr&eacute;&eacute; m&ecirc;me si la fonctionnalit&eacute; Design Notes est d&eacute;sactiv&eacute;e pour le site ou si le chemin
sp&eacute;cifi&eacute; par l’argument localFileURL n’est associ&eacute; &agrave; aucun site.
API C de Design Notes
61
FileHandle OpenNotesFilewithOpenFlags()
Description
Cette fonction ouvre le fichier Design Notes associ&eacute; au fichier sp&eacute;cifi&eacute; ou cr&eacute;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&eacute; sous la forme d’une URL de type file://, est une cha&icirc;ne
contenant le chemin du fichier principal auquel le fichier Design Notes est associ&eacute;.
• L’argument bForceCreate est une valeur bool&eacute;enne indiquant si le fichier Design Notes doit
•
&ecirc;tre cr&eacute;&eacute; m&ecirc;me si la fonctionnalit&eacute; Design Notes est d&eacute;sactiv&eacute;e pour le site ou si le chemin n’est
associ&eacute; &agrave; aucun site. La valeur par d&eacute;faut est false. Cet argument est facultatif, mais vous
devez le d&eacute;finir si vous sp&eacute;cifiez le troisi&egrave;me argument.
L’argument facultatif bReadOnly est une valeur bool&eacute;enne indiquant si le fichier doit &ecirc;tre
ouvert en mode lecture seule. La valeur par d&eacute;faut est false. Vous pouvez sp&eacute;cifier l’argument
bReadOnly disponible &agrave; partir de la version 2 du fichier MMNotes.dll.
BOOL RemoveNote()
Description
Cette fonction supprime la cl&eacute; sp&eacute;cifi&eacute;e (et sa valeur) du fichier Design Notes indiqu&eacute;.
Arguments
FileHandle noteHandle, const char keyName[64]
• L’argument noteHandle est l’identificateur de fichier renvoy&eacute; par la fonction
OpenNotesFile().
• L’argument keyName[64] est une cha&icirc;ne contenant le nom de la cl&eacute; &agrave; supprimer.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec.
BOOL SetNote()
Description
Cette fonction cr&eacute;e ou met &agrave; jour une paire cl&eacute;/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&eacute; par la fonction
OpenNotesFile().
• L’argument keyName[64] est une cha&icirc;ne contenant le nom de la cl&eacute;.
• L’argument value est une cha&icirc;ne contenant la valeur.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’op&eacute;ration a r&eacute;ussi ; false indique un &eacute;chec.
62
Chapitre 4 : API de Design Notes
CHAPITRE 5
Int&eacute;gration de Fireworks
FWLaunch est une biblioth&egrave;que C partag&eacute;e qui donne aux auteurs d’objets, de commandes, de
comportements et d’inspecteurs de propri&eacute;t&eacute;s la possibilit&eacute; de communiquer avec Macromedia
Fireworks MX 2004. A l’aide de FWLaunch, vous r&eacute;digez du code JavaScript pour ouvrir
l’interface utilisateur (IU) de Fireworks et fournissez des commandes &agrave; Fireworks via son propre
API JavaScript, au sujet duquel vous trouverez plus d’informations dans le manuel Extension de
Fireworks. Pour des informations g&eacute;n&eacute;rales sur l’interaction des biblioth&egrave;ques C avec l’interpr&eacute;teur
JavaScript dans Macromedia Dreamweaver MX 2004, voir Extension de Dreamweaver pour plus
de d&eacute;tails sur les extensions C.
L’API FWLaunch
L’objet FWLaunch permet aux extensions d’ouvrir Fireworks, d’ex&eacute;cuter des op&eacute;rations Fireworks
&agrave; l’aide de l’API JavaScript de Fireworks et de renvoyer les valeurs &agrave; Dreamweaver. Ce chapitre
d&eacute;crit l’API de communication FWLaunch et son utilisation.
FWLaunch.bringDWToFront()
Disponibilit&eacute;
Dreamweaver 3, Fireworks 3.
Description
Cette fonction fait passer Dreamweaver au premier plan.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
63
FWLaunch.bringFWToFront()
Disponibilit&eacute;
Dreamweaver 3, Fireworks 3.
Description
Cette fonction fait passer Fireworks au premier plan s’il est en cours d’ex&eacute;cution.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
FWLaunch.execJsInFireworks()
Disponibilit&eacute;
Dreamweaver 3, Fireworks 3.
Description
Cette fonction transmet l’&eacute;l&eacute;ment JavaScript sp&eacute;cifi&eacute; (ou une r&eacute;f&eacute;rence &agrave; un fichier JavaScript) &agrave;
Fireworks en vue de son ex&eacute;cution.
Arguments
javascriptOrFileURL
• L’argument javascriptOrFileURL, exprim&eacute; sous la forme d’une URL de type file://, est soit
une cha&icirc;ne de JavaScript litt&eacute;ral, soit le chemin d’acc&egrave;s d’un fichier JavaScript.
Valeurs renvoy&eacute;es
Un objet cookie si le code JavaScript a &eacute;t&eacute; transmis avec succ&egrave;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
•
•
•
•
64
l’argument javascriptOrFileURL est sp&eacute;cifi&eacute; comme ayant la valeur null ou comme une
cha&icirc;ne vide.
Erreur d’E/S de fichier, ce qui indique que Fireworks ne peut pas cr&eacute;er de fichier r&eacute;ponse car le
disque est satur&eacute;.
Erreur de notification de Dreamweaver ; l’utilisateur n’ex&eacute;cute pas une version valide de
Dreamweaver (version 3 ou ult&eacute;rieure).
Erreur de lancement de Fireworks, ce qui indique que la fonction n’ouvre pas une version
valide de Fireworks (version 3 ou ult&eacute;rieure).
L’utilisateur a annul&eacute; l’op&eacute;ration.
Chapitre 5 : Int&eacute;gration de Fireworks
FWLaunch.getJsResponse()
Disponibilit&eacute;
Dreamweaver 3, Fireworks 3.
Description
Cette fonction d&eacute;termine si Fireworks est toujours en train d’ex&eacute;cuter le code JavaScript qui lui a
&eacute;t&eacute; transmis par la fonction FWLaunch.execJsInFireworks(), que l’ex&eacute;cution du script se soit
termin&eacute;e avec succ&egrave;s ou qu’une erreur se soit produite.
Arguments
progressTrackerCookie
• L’argument progressTrackerCookie est l’objet cookie renvoy&eacute; par la fonction
FWLaunch.execJsInFireworks().
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le r&eacute;sultat du script transmis &agrave; FWLaunch.execJsInFireworks() si
l’op&eacute;ration se termine avec succ&egrave;s, la valeur null si Fireworks est toujours en train d’ex&eacute;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&eacute;cutait le script.
Erreur d’E/S de fichier, ce qui indique que Fireworks ne peut pas cr&eacute;er de fichier r&eacute;ponse car le
disque est satur&eacute;.
Erreur de notification de Dreamweaver ; l’utilisateur n’ex&eacute;cute pas une version valide de
Dreamweaver (version 3 ou ult&eacute;rieure).
Erreur de lancement de Fireworks, ce qui indique que la fonction n’ouvre pas une version
valide de Fireworks (version 3 ou ult&eacute;rieure).
L’utilisateur a annul&eacute; l’op&eacute;ration.
Valeurs renvoy&eacute;es
Le code suivant transmet la cha&icirc;ne &quot;prompt('Please enter your name:')&quot; &agrave; la fonction
FWLaunch.execJsInFireworks(), puis il v&eacute;rifie le r&eacute;sultat :
var progressCookie = FWLaunch.execJsInFireworks(&quot;prompt('Please enter your
name:')&quot;);
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) == &quot;number&quot;) {
// error or user-cancel, time to close the window
// and let the user know we got an error
window.close();
alert(&quot;An error occurred.&quot;);
L’API FWLaunch
65
} else {
// got a valid response!
alert(&quot;Nice to meet you, &quot; + response);
window.close();
}
doneFlag = true;
}
}
}
FWLaunch.mayLaunchFireworks()
Disponibilit&eacute;
Dreamweaver 2, Fireworks 2.
Description
Cette fonction d&eacute;termine s’il est possible d’ouvrir une session d’optimisation de Fireworks.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;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&eacute;j&agrave; en cours d’ex&eacute;cution.
FWLaunch.optimizeInFireworks()
Disponibilit&eacute;
Dreamweaver 2, Fireworks 2.
Description
Cette fonction ouvre une session d’optimisation de Fireworks pour l’image sp&eacute;cifi&eacute;e.
Arguments
docURL, imageURL, {targetWidth}, {targetHeight}
• L’argument docURL est le chemin d’acc&egrave;s du document actif, exprim&eacute; sous la forme d’une URL
•
•
•
de type file://.
L’argument imageURL est le chemin de l’image s&eacute;lectionn&eacute;e. Si le chemin est relatif, sa
r&eacute;f&eacute;rence sera le chemin sp&eacute;cifi&eacute; dans l’argument docURL.
L’argument targetWidth (facultatif ) d&eacute;finit la largeur par rapport &agrave; laquelle l’image doit &ecirc;tre
redimensionn&eacute;e.
L’argument targetHeight (facultatif ) d&eacute;finit la hauteur par rapport &agrave; laquelle l’image doit
&ecirc;tre redimensionn&eacute;e.
Valeurs renvoy&eacute;es
Z&eacute;ro (0) si une session d’optimisation de Fireworks a &eacute;t&eacute; lanc&eacute;e avec succ&egrave;s pour l’image
sp&eacute;cifi&eacute;e ; sinon, un code d’erreur non nul indiquant que l’une des erreurs suivantes s’est
produite :
66
Chapitre 5 : Int&eacute;gration de Fireworks
• Utilisation non valide, ce qui indique que l’argument docURL, l’argument imageURL, ou les
deux, ont &eacute;t&eacute; sp&eacute;cifi&eacute;s comme &eacute;tant null ou sous forme d’une cha&icirc;ne vide.
• Erreur d’E/S de fichier ; Fireworks ne peut pas cr&eacute;er de fichier r&eacute;ponse car le disque est satur&eacute;.
• Erreur de notification de Dreamweaver ; l’utilisateur n’ex&eacute;cute pas une version valide de
Dreamweaver (version 2 ou ult&eacute;rieure).
• Erreur lors du d&eacute;marrage de Fireworks, ce qui indique que la fonction n’ouvre pas une version
valide de Fireworks (version 2 ou ult&eacute;rieure).
• L’utilisateur a annul&eacute; l’op&eacute;ration.
FWLaunch.validateFireworks()
Disponibilit&eacute;
Dreamweaver 2, Fireworks 2.
Description
Cette fonction recherche la version sp&eacute;cifi&eacute;e de Fireworks sur le disque dur de l’utilisateur.
Arguments
{versionNumber}
• L’argument versionNumber est un nombre &agrave; virgule flottante sup&eacute;rieur ou &eacute;gal &agrave; 2 ; il est
facultatif et repr&eacute;sente la version requise de Fireworks. Si cet argument n’est pas d&eacute;fini, il prend
par d&eacute;faut la valeur 2.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne indiquant si la version sp&eacute;cifi&eacute;e de Fireworks a &eacute;t&eacute; trouv&eacute;e.
Exemple
Le code suivant v&eacute;rifie si Fireworks est install&eacute; :
if (FWLaunch.validateFireworks(6.0)){
alert(&quot;Fireworks 6.0 or later is installed.&quot;);
}else{
alert(&quot;Fireworks 6.0 is not installed.&quot;);
}
Un exemple simple de communication FWLaunch
La commande suivante demande &agrave; Fireworks d’inviter l’utilisateur &agrave; entrer son nom, puis renvoie
le nom &agrave; Dreamweaver.
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;Prompt in Fireworks&lt;/title&gt;
&lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html; &not;
charset=iso-8859-1&quot;&gt;
&lt;script&gt;
function commandButtons(){
return new Array(&quot;Prompt&quot;, &quot;promptInFireworks()&quot;, &quot;Cancel&quot;, &not;
&quot;readyToCancel()&quot;, &quot;Close&quot;,&quot;window.close()&quot;);
}
var gCancelClicked = false;
L’API FWLaunch
67
var gProgressTrackerCookie = null;
function readyToCancel() {
gCancelClicked = true;
}
function promptInFireworks() {
var isFireworks3 = FWLaunch.validateFireworks(3.0);
if (!isFireworks3) {
alert(&quot;You must have Fireworks 3.0 or later to use this &not;
command&quot;);
return;
}
// Tell Fireworks to execute the prompt() method.
gProgressTrackerCookie = FWLaunch.execJsInFireworks&not;
(&quot;prompt('Please enter your name:')&quot;);
// null means it wasn’t launched, a number means an error code
if (gProgressTrackerCookie == null || &not;
typeof(gProgressTrackerCookie) == &quot;number&quot;) {
window.close();
alert(&quot;an error occurred&quot;);
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(&quot;checkJsResponse();&quot;, 500);
}
function checkJsResponse() {
var response = null;
// The user clicked the cancel button, close the window
if (gCancelClicked) {
window.close();
alert(&quot;cancel clicked&quot;);
} else {
// We’re still going, ask Fireworks how it’s doing
if (gProgressTrackerCookie != null)
response = &not;
FWLaunch.getJsResponse(gProgressTrackerCookie);
if (response == null) {
// still waiting for a response, call us again in 1/2 a
// second
checkOneMoreTime();
} else if (typeof(response) == &quot;number&quot;) {
// if the response was a number, it means an error
// occurred
// the user cancelled in Fireworks
window.close();
alert(&quot;an error occurred.&quot;);
68
Chapitre 5 : Int&eacute;gration de Fireworks
} 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 &not;
front
alert(&quot;Nice to meet you, &quot; + response + &quot;!&quot;);
}
}
}
&lt;/script&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;form&gt;
&lt;table width=&quot;313&quot; nowrap&gt;
&lt;tr&gt;
&lt;td&gt;This command asks Fireworks to execute the prompt() &not;
function. When you click Prompt, Fireworks comes forward and &not;
asks you to enter a value into a dialog box. That value is then &not;
returned to Dreamweaver and displayed in an alert.&lt;/td&gt;
&lt;/tr&gt;
&lt;/table&gt;
&lt;/form&gt;
&lt;/body&gt;
&lt;/html&gt;
L’API FWLaunch
69
70
Chapitre 5 : Int&eacute;gration de Fireworks
CHAPITRE 6
Int&eacute;gration de Flash
Macromedia Dreamweaver MX 2004 prend maintenant en charge les &eacute;l&eacute;ments Flash XM 2004,
en plus de l’API d’objet Flash, qui s’appuie sur le mod&egrave;le Flash Generator pour cr&eacute;er de nouveaux
objets Flash. Ce chapitre d&eacute;crit comment utiliser les &eacute;l&eacute;ments Flash (fichiers SWC), et explique en
d&eacute;tail comment cr&eacute;er des objets Flash (fichiers SWF) &agrave; partir des mod&egrave;les Flash Generator
(fichiers SWT).
Pour plus d’informations sur l’ajout de contenu Flash &agrave; des objets ou des commandes
Dreamweaver, voir Extension de Dreamweaver.
Fonctionnement des &eacute;l&eacute;ments Flash
Les &eacute;l&eacute;ments Flash se pr&eacute;sentent sous forme de fichiers SWC. Un fichier SWC est un clip vid&eacute;o
compil&eacute; g&eacute;n&eacute;r&eacute; par Flash pour &ecirc;tre utilis&eacute; par Macromedia et des produits tiers. Dreamweaver
peut rendre ces composants accessibles aux utilisateurs via la barre Ins&eacute;rer, le menu Ins&eacute;rer ou une
barre d’outils. Vous cr&eacute;ez des &eacute;l&eacute;ments Flash &agrave; l’aide de l’outil de cr&eacute;ation Web Flash, mais
Dreamweaver peut analyser les propri&eacute;t&eacute;s d’un &eacute;l&eacute;ment Flash et les exprimer via la balise param
(enfant de la balise object). Les utilisateurs peuvent ensuite modifier les attributs de la balise
param, de fa&ccedil;on &agrave; changer les propri&eacute;t&eacute;s de l’&eacute;l&eacute;ment au moment de l’&eacute;dition (pour plus
d’informations sur l’utilisation des propri&eacute;t&eacute;s des composants dans Dreamweaver, voir Utilisation
de Dreamweaver).
71
Insertion d’&eacute;l&eacute;ments Flash
Les &eacute;l&eacute;ments Flash sont install&eacute;s via Extension Manager. Dreamweaver ajoute des &eacute;l&eacute;ments Flash
aux documents de la m&ecirc;me fa&ccedil;on que les objets de la barre Ins&eacute;rer ou du menu Ins&eacute;rer (pour plus
d’informations sur l’utilisation d’objets Dreamweaver, voir Objets de la barre Ins&eacute;rer dans
Extension de Dreamweaver). Les utilisateurs peuvent ajouter des cha&icirc;nes de code aux documents en
cliquant sur les objets de la barre Ins&eacute;rer ou en s&eacute;lectionnant les options dans le menu Ins&eacute;rer. Les
utilisateurs peuvent acc&eacute;der aux &eacute;l&eacute;ments Flash via la barre Ins&eacute;rer ou le menu Ins&eacute;rer (ce qui
signifie que vous pouvez ajouter &agrave; la barre Ins&eacute;rer ou au menu Ins&eacute;rer un fichier d’&eacute;l&eacute;ment Flash
valide d&eacute;j&agrave; install&eacute; dans le dossier Configuration/Objects/FlashElements ou l’un de ses sousdossiers). Les d&eacute;veloppeurs d’extensions peuvent utiliser la fonction JavaScript
dom.insertFlashElement() du fichier de d&eacute;finition de l’objet pour ajouter des &eacute;l&eacute;ments Flash
disponibles &agrave; un document. Lorsque l’utilisateur s&eacute;lectionne l’objet de l’&eacute;l&eacute;ment Flash,
Dreamweaver ouvre le fichier SWC, qui contient le contenu Flash (fichier SWF) et un fichier
d&eacute;taillant les param&egrave;tres que l’utilisateur peut modifier. Dreamweaver ins&egrave;re ensuite le fichier
SWF dans le document de l’utilisateur.
Ajout d’un &eacute;l&eacute;ment Flash &agrave; la barre Ins&eacute;rer
De m&ecirc;me que pour tout autre objet, l’ajout d’un &eacute;l&eacute;ment Flash &agrave; la barre Ins&eacute;rer se fait via la
balise button. Toutefois, une balise button pour un &eacute;l&eacute;ment Flash doit avoir des attributs file et
command pour &ecirc;tre correctement ajout&eacute;e au document (pour plus d’informations sur la balise
button, voir Objets de la barre Ins&eacute;rer dans Extension de Dreamweaver). Les attributs file
permettent d’indiquer &agrave; Dreamweaver o&ugrave; se trouve le fichier source de l’&eacute;l&eacute;ment par rapport au
dossier Objects. Utilisez ensuite l’attribut command pour indiquer &agrave; Dreamweaver d’utiliser la
fonction dom.insertFlashElement() lorsque l’utilisateur clique sur le bouton de la barre
Ins&eacute;rer.
L’exemple suivant repr&eacute;sente le code qui doit &ecirc;tre &eacute;crit dans le fichier inserbar.xml (en tant
qu’enfant de la balise category ou menubutton appropri&eacute;e, selon l’endroit o&ugrave; vous souhaitez voir
appara&icirc;tre le bouton de l’&eacute;l&eacute;ment Flash) :
&lt;button id=&quot;FlashElement_Nav&quot;
name=&quot;Navigation&quot;
file=&quot;FlashElements\nav.swc&quot;
command=&quot;dw.getDocumentDOM().insertFlashElement('nav.swc')&quot; /&gt;
Remarque : L’image sur la barre Ins&eacute;rer pour l’&eacute;l&eacute;ment Flash est d&eacute;termin&eacute;e au sein du fichier SWC.
En outre, la balise button pour un &eacute;l&eacute;ment Flash doit avoir un attribut de fichier d&eacute;fini.
Ajout d’un &eacute;l&eacute;ment Flash &agrave; un menu
Un &eacute;l&eacute;ment Flash peut &eacute;galement &ecirc;tre situ&eacute; dans le menu Ins&eacute;rer ou dans d’autres menus de
Dreamweaver. Utilisez la fonction JavaScript dom.insertFlashElement() avec le format de fichier
menus.xml (voir Menus et commandes de menus dans Extension de Dreamweaver) pour indiquer
l’emplacement de l’&eacute;l&eacute;ment de menu Flash. L’exemple suivant est un code qui permet, au sein du
fichier menus.xml, d’int&eacute;grer l’&eacute;l&eacute;ment Navigation Flash dans le menu Insertion &gt; El&eacute;ment
Flash :
&lt;menuitem name=&quot;Navigation&quot;
key=&quot;&quot;command=&quot;dw.getDocumentDOM().insertFlashElement('nav.swc')&quot;
enabled=&quot;(dw.getFocus() != 'browser') &amp;&amp; (dw.getDocumentDOM() != null &amp;&amp; &not;
dw.getDocumentDOM().getParseMode() == 'html')&quot;
id=&quot;DWMenu_Insert_FlashElement_Nav&quot; /&gt;
72
Chapitre 6 : Int&eacute;gration de Flash
API des objets Flash
L’API des objets Flash permet aux d&eacute;veloppeurs d’extensions de construire des objets pour cr&eacute;er
un contenu Macromedia Flash simple via Flash Generator. Cette API fournit un moyen de d&eacute;finir
des param&egrave;tres dans un mod&egrave;le Flash Generator pour r&eacute;aliser un fichier SWF ou d’image. Elle
permet de cr&eacute;er de nouveaux objets Flash mais aussi de lire et de manipuler des objets Flash
existants. Les fonctionnalit&eacute;s bouton Flash et texte Flash sont construites &agrave; l’aide de cette API.
Le fichier de mod&egrave;le Flash Generator SWT contient toutes les informations indispensables &agrave; la
construction d’un fichier d’objet Flash. Ces fonctions d’API vous permettent de cr&eacute;er un nouveau
fichier SWF (ou fichier d’image) &agrave; partir d’un fichier SWT en rempla&ccedil;ant les param&egrave;tres du
fichier SWT par des valeurs r&eacute;elles. Pour plus d’informations sur Flash, voir le manuel
correspondant. Les fonctions suivantes sont des m&eacute;thodes de l’objet SWFFile.
SWFFile.createFile()
Description
Cette fonction g&eacute;n&egrave;re un nouveau fichier Objet Flash &agrave; partir du mod&egrave;le et du tableau des
param&egrave;tres sp&eacute;cifi&eacute;s. Elle cr&eacute;e &eacute;galement une version GIF, PNG, JPEG et MOV du titre si les
noms de fichier sous ces formats sont pr&eacute;cis&eacute;s.
Pour pouvoir sp&eacute;cifier un param&egrave;tre facultatif plac&eacute; apr&egrave;s des param&egrave;tres facultatifs que vous ne
voulez pas sp&eacute;cifier, vous devez ins&eacute;rer des cha&icirc;nes vides dans ces param&egrave;tres. Par exemple, si vous
souhaitez sp&eacute;cifier un fichier PNG, mais pas de fichier GIF, vous devez ins&eacute;rer une cha&icirc;ne vide
avant de sp&eacute;cifier le nom du fichier PNG.
Arguments
templateFile, templateParams, swfFileName, {gifFileName}, {pngFileName},
{jpgFileName}, {movFileName}, {generatorParams}
• L’argument templateFile est le chemin d’acc&egrave;s du fichier mod&egrave;le, exprim&eacute; 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&egrave;tres du fichier SWT et les valeurs correspondent &agrave; la d&eacute;finition que vous
voulez leur attribuer. Pour que Dreamweaver puisse reconna&icirc;tre un fichier SWF comme objet
Flash, le premier param&egrave;tre doit &ecirc;tre &quot;dwType&quot;. Sa valeur doit &ecirc;tre une cha&icirc;ne repr&eacute;sentant le
nom du type d’objet, telle que &quot;Flash Text&quot;.
L’argument swfFileName, exprim&eacute; sous forme d’une URL de type file://, correspond au nom
de fichier de sortie d’un fichier SWF ou d’une cha&icirc;ne vide &agrave; ignorer.
L’argument gifFileName, exprim&eacute; sous forme d’une URL de type file://, correspond au nom
de fichier de sortie d’un fichier GIF. Cet argument est facultatif.
L’argument pngFileName, exprim&eacute; 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&eacute; 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&eacute; sous forme d’une URL de type file://, correspond au nom
de fichier de sortie d’un fichier QuickTime. Cet argument est facultatif.
API des objets Flash
73
• L’argument generatorParams est un tableau de cha&icirc;nes repr&eacute;sentant les indicateurs facultatifs
de la ligne de commande de Generator. Cet argument est facultatif. Les &eacute;l&eacute;ments de donn&eacute;es
de toutes les balises doivent suivre dans le tableau. Les indicateurs couramment utilis&eacute;s sont
r&eacute;pertori&eacute;s dans le tableau suivant :
Indicateur
d’option
Donn&eacute;es
Description
Exemple
-defaultsize
Largeur,
hauteur
D&eacute;finit la taille de l’image de sortie en &quot;-defaultsize&quot;,
&quot;640&quot;, &quot;480&quot;
fonction des largeur et hauteur
indiqu&eacute;es.
-exactFit
Aucune
Etend le contenu de l’image de sortie &quot;-exactFit&quot;
pour qu’il s’adapte exactement &agrave; la
taille de sortie indiqu&eacute;e.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient l’une des valeurs suivantes :
•
•
•
•
•
•
•
signifie que l’appel s’est d&eacute;roul&eacute; sans anomalie.
signifie que le fichier de mod&egrave;le choisi &eacute;tait incorrect ou
introuvable.
&quot;invalidOutputFile&quot; signifie qu’au moins un des noms de fichier de sortie sp&eacute;cifi&eacute;s &eacute;tait
incorrect.
&quot;invalidData&quot; signifie qu’une ou plusieurs des paires nom/valeur templateParams &eacute;taient
incorrectes.
&quot;initGeneratorFailed&quot; signifie que Generator n’a pas pu &ecirc;tre initialis&eacute;.
&quot;outOfMemory&quot; signifie que l’op&eacute;ration n’a pas pu se terminer correctement faute de m&eacute;moire.
&quot;unknownError&quot; signifie qu’une erreur inconnue s’est produite.
&quot;noError&quot;
&quot;invalidTemplateFile&quot;
Exemple
Le code JavaScript suivant cr&eacute;e un fichier objet Flash de type &quot;monType&quot;, qui remplace toutes les
occurrences de la cha&icirc;ne &quot;text&quot; &agrave; l’int&eacute;rieur du fichier de mod&egrave;le par la cha&icirc;ne &quot;Hello World&quot;.
Il cr&eacute;e un fichier GIF et un fichier SWF.
var params = new Array;
params[0] = &quot;dwType&quot;;
params[1] = &quot;monType&quot;;
params[2] = &quot;text&quot;;
params[3] = &quot;Hello World&quot;;
errorString = SWFFile.createFile( &quot;file:///MyMac/test.swt&quot;, &not;
params, &quot;file:///MyMac/test.swf&quot;, &quot;file:///MyMac/test.gif&quot;);
SWFFile.getNaturalSize()
Description
Cette fonction renvoie la taille naturelle de tout contenu Flash.
74
Chapitre 6 : Int&eacute;gration de Flash
Arguments
fileName
• L’argument fileName, exprim&eacute; sous la forme d’une URL de type file://, correspond au chemin
d’acc&egrave;s au contenu Flash.
Valeurs renvoy&eacute;es
Un tableau contenant deux &eacute;l&eacute;ments qui repr&eacute;sentent la largeur et la hauteur du contenu Flash ou
une valeur null si le fichier n’est pas un fichier Flash.
SWFFile.getObjectType()
Description
Cette fonction renvoie le type d’objet Flash, c’est-&agrave;-dire la valeur transmise dans le param&egrave;tre
dwType lorsque le fichier a &eacute;t&eacute; cr&eacute;&eacute; par la fonction SWFFile.createFile().
Arguments
fileName
• L’argument fileName, exprim&eacute; sous la forme d’une URL de type file://, correspond au chemin
d’acc&egrave;s &agrave; un fichier Objet Flash. Il s’agit g&eacute;n&eacute;ralement d’un fichier SWF.
Valeurs renvoy&eacute;es
Une cha&icirc;ne repr&eacute;sentant le type d’objet ou contenant la valeur null si le fichier n’est pas un
fichier Objet Flash ou s’il est introuvable.
Exemple
Le code suivant v&eacute;rifie si le fichier test.swf est un objet Flash de type monType :
if ( SWFFile.getObjectType(&quot;file:///MyMac/test.swf&quot;) == &not;
&quot;monType&quot; ){
alert (&quot;Ceci est un objet monType.&quot;);
}else{
alert (&quot;Ceci n’est pas un objet monType.&quot;);
}
SWFFile.readFile()
Description
Cette fonction lit un fichier Objet Flash.
Arguments
fileName
• L’argument fileName, exprim&eacute; sous la forme d’une URL de type file://, correspond au chemin
d’acc&egrave;s &agrave; un fichier Objet Flash.
API des objets Flash
75
Valeurs renvoy&eacute;es
Un tableau de cha&icirc;nes dans lequel le premier &eacute;l&eacute;ment est le chemin d’acc&egrave;s complet du fichier
mod&egrave;le SWT. Les cha&icirc;nes suivantes repr&eacute;sentent les param&egrave;tres (paires nom/valeur) de l’objet.
Dans le tableau, chaque nom est suivi de sa valeur. La premi&egrave;re paire nom/valeur est &quot;dwType&quot;,
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 Objet Flash.
Exemple
L’appel du code var params = SWFFile.readFile(&quot;file:///MyMac/test.swf&quot;) renvoie les
valeurs suivantes dans le tableau des param&egrave;tres :
&quot;file:///MyMac/test.swt&quot;
&quot;dwType&quot;
&quot;monType&quot;
&quot;text&quot;
&quot;Hello World&quot;
76
Chapitre 6 : Int&eacute;gration de Flash
// fichier mod&egrave;le utilis&eacute; pour cr&eacute;er ce fichier .swf
// premier param&egrave;tre
// premi&egrave;re valeur de param&egrave;tre
// second param&egrave;tre
// seconde valeur de param&egrave;tre
CHAPITRE 7
API de base de donn&eacute;es
Les fonctions de l’API de base de donn&eacute;es permettent de g&eacute;rer les connexions aux bases de
donn&eacute;es et d’acc&eacute;der aux informations stock&eacute;es dans ces derni&egrave;res. L’API de base de donn&eacute;es est
divis&eacute; en deux fonctions distinctes : la gestion des connexions et l’acc&egrave;s aux bases de donn&eacute;es.
La gestion des connexions aux bases de donn&eacute;es permet, par exemple, d’obtenir le nom
d’utilisateur et le mot de passe n&eacute;cessaires pour &eacute;tablir une connexion &agrave; une base de donn&eacute;es ou
d’ouvrir une bo&icirc;te de dialogue de connexion &agrave; une base de donn&eacute;es.
L’acc&egrave;s aux informations de base de donn&eacute;es permet par exemple d’extraire les m&eacute;tadonn&eacute;es qui
d&eacute;crivent le sch&eacute;ma ou la structure d’une base de donn&eacute;es. Ces m&eacute;tadonn&eacute;es incluent des
informations telles que les noms des tables, des colonnes, des proc&eacute;dures stock&eacute;es et des
affichages. Vous pouvez &eacute;galement afficher les r&eacute;sultats de l’ex&eacute;cution d’une requ&ecirc;te de base de
donn&eacute;es ou d’une proc&eacute;dure stock&eacute;e. Lorsque vous acc&eacute;dez &agrave; une base de donn&eacute;es par le biais de
cette API, vous utilisez des instructions SQL (Structured Query Language).
Les fonctions de l’API de base de donn&eacute;es sont utilis&eacute;es au moment de la conception, lorsque les
utilisateurs d&eacute;veloppent leurs applications Web, et non au moment de l’ex&eacute;cution, c’est-&agrave;-dire
lorsque l’application Web est d&eacute;ploy&eacute;e.
Il est possible d’utiliser ces fonctions dans n’importe quelle extension. En fait, les fonctions des
API de comportement de serveur, de format des donn&eacute;es et de source de donn&eacute;es de Macromedia
Dreamweaver MX 2004 utilisent toutes des fonctions de base de donn&eacute;es.
Fonctionnement de l’API de bases de donn&eacute;es
L’exemple suivant illustre la fa&ccedil;on dont la fonction de comportement de serveur,
getDynamicBindings(), est d&eacute;finie pour Recordset.js. Cet exemple utilise la fonction
MMDB.getColumnAndTypeList() :
fonction 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, &quot; &quot;);
var bIsSimple = ParseSimpleSQL(statement);
statement = stripCFIFSimple(statement);
77
if (bIsSimple) {
statement = RemoveWhereClause(statement,false);
} else {
var pa = new Array();
if (ss.ParamArray != null) {
for (var i = 0; i &lt; 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;
}
Fonctions de connexion &agrave; une base de donn&eacute;es
Les fonctions de connexion &agrave; une base de donn&eacute;es vous permettent d’&eacute;tablir et de g&eacute;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&egrave;dent pas aux
bases de donn&eacute;es. Pour les fonctions qui acc&egrave;dent aux bases de donn&eacute;es, voir Fonctions d’acc&egrave;s &agrave; la
base de donn&eacute;es, page 91.
MMDB.deleteConnection()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction permet de supprimer la connexion &agrave; la base de donn&eacute;es nomm&eacute;e.
Arguments
connName
• L’argument connName est le nom de la connexion &agrave; la base de donn&eacute;es tel qu’il est sp&eacute;cifi&eacute; dans
le Gestionnaire de connexions. Cet argument identifie la connexion &agrave; la base de donn&eacute;es &agrave;
supprimer en fonction de son nom.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant supprime une connexion &agrave; une base de donn&eacute;es :
function clickedDelete()
{
var selectedObj = dw.serverComponents.getSelectedNode();
if (selectedObj &amp;&amp; selectedObj.objectType==&quot;Connection&quot;)
{
var connRec = MMDB.getConnection(selectedObj.name);
78
Chapitre 7 : API de base de donn&eacute;es
if (connRec)
{
MMDB.deleteConnection(selectedObj.name);
dw.serverComponents.refresh();
}
}
}
MMDB.getColdFusionDsnList()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait les noms des sources de donn&eacute;es (DSN) ColdFusion du serveur du site, en utilisant les
fonctions getRDSUserName() et getRDSPassword().
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau contenant les DSN ColdFusion d&eacute;finis sur le serveur pour le site en cours.
MMDB.getConnection()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Extrait un objet de connexion nomm&eacute;.
Arguments
name
• L’argument name est une variable de cha&icirc;ne qui sp&eacute;cifie le nom de la connexion &agrave; laquelle vous
souhaitez faire r&eacute;f&eacute;rence.
Valeurs renvoy&eacute;es
R&eacute;f&eacute;rence &agrave; un objet de connexion nomm&eacute;. Les objets de connexion ont les propri&eacute;t&eacute;s suivantes :
Propri&eacute;t&eacute;
Description
name
Nom de connexion
type
Indique, en cas de useHTTP false, quel fichier DLL utiliser pour se connecter &agrave; une
base de donn&eacute;es en ex&eacute;cution
string
Cha&icirc;ne de connexion ADO d’ex&eacute;cution ou URL JDBC
dsn
DSN ColdFusion
driver
Pilote JDBC d’ex&eacute;cution
Fonctions de connexion &agrave; une base de donn&eacute;es
79
Propri&eacute;t&eacute;
Description
username
Nom d’utilisateur d’ex&eacute;cution
password
Mot de passe d’ex&eacute;cution
useHTTP
Cha&icirc;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)
includePattern
Expression r&eacute;guli&egrave;re utilis&eacute;e pour trouver l’instruction d’inclusion de fichier sur la
page pendant Live Data et Aper&ccedil;u dans le navigateur
variables
Tableau de noms de variables de pages et leurs valeurs correspondantes, utilis&eacute;
pendant Live Data et Aper&ccedil;u dans le navigateur
catalog
Utilis&eacute; pour restreindre les m&eacute;tadonn&eacute;es qui apparaissent (pour plus
d’informations, voir MMDB.getProcedures(), page 94)
schema
Utilis&eacute; pour restreindre les m&eacute;tadonn&eacute;es qui apparaissent (pour plus
d’informations, voir MMDB.getProcedures(), page 94)
filename
Nom de fichier de bo&icirc;te de dialogue qui &eacute;tait utilis&eacute; pour cr&eacute;er la connexion
Remarque : Il s’agit des propri&eacute;t&eacute;s standard impl&eacute;ment&eacute;es par Dreamweaver. Les d&eacute;veloppeurs
peuvent d&eacute;finir leurs propres types de connexion et ajouter de nouvelles propri&eacute;t&eacute;s &agrave; cet ensemble
standard, ou bien fournir un ensemble diff&eacute;rent de propri&eacute;t&eacute;s.
MMDB.getConnectionList()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait une liste de toutes les cha&icirc;nes de connexion d&eacute;finies dans le Gestionnaire de connexions.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes, chaque cha&icirc;ne correspondant au nom d’une connexion tel qu’il appara&icirc;t dans
le Gestionnaire de connexions.
Exemple
La fonction MMDB.getConnectionList() peut renvoyer les cha&icirc;nes [&quot;EmpDB&quot;, &quot;Test&quot;,
&quot;TestEmp&quot;].
MMDB.getConnectionName()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
80
Chapitre 7 : API de base de donn&eacute;es
Description
Extrait un nom de connexion correspondant &agrave; la cha&icirc;ne de connexion sp&eacute;cifi&eacute;e. Cette fonction est
utile lorsque vous devez res&eacute;lectionner un nom de connexion dans l’interface utilisateur (IU) &agrave;
partir des donn&eacute;es de la page.
Si vous avez une cha&icirc;ne de connexion faisant r&eacute;f&eacute;rence &agrave; deux pilotes diff&eacute;rents, vous pouvez
sp&eacute;cifier &agrave; la fois la cha&icirc;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&egrave;de les propri&eacute;t&eacute;s suivantes :
ConnectionString=&quot;jdbc:inetdae:velcro-qa-5:1433?database=pubs&quot;
DriverName=&quot;com.inet.tds.TdsDriver&quot;
• Connexion 2 poss&egrave;de les propri&eacute;t&eacute;s suivantes :
ConnectionString=&quot;jdbc:inetdae:velcro-qa-5:1433?database=pubs&quot;
DriverName=&quot;com.inet.tds.TdsDriver2&quot;
Les cha&icirc;nes de connexion de Connexion 1 et Connexion 2 sont identiques. Connexion 2 &eacute;tablit
une connexion avec une version plus r&eacute;cente de TdsDriver. Vous devez transmettre le nom du
pilote &agrave; cette fonction pour d&eacute;finir compl&egrave;tement le nom de connexion que vous souhaitez
obtenir.
Arguments
connString, {driverName}
• connString est la cha&icirc;ne de connexion qui extrait le nom de la connexion.
• L’argument facultatif driverName d&eacute;finit l’argument connString de mani&egrave;re plus pr&eacute;cise.
Valeurs renvoy&eacute;es
Cha&icirc;ne de nom de connexion correspondant &agrave; la cha&icirc;ne de connexion.
Exemple
Le code suivant renvoie la cha&icirc;ne &quot;EmpDB&quot; :
var connectionName = MMDB.getConnectionName &not;
(&quot;dsn=EmpDB;uid=;pwd=&quot;);
MMDB.getConnectionString()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait la cha&icirc;ne de connexion associ&eacute;e &agrave; la connexion nomm&eacute;e.
Arguments
connName
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Fonctions de connexion &agrave; une base de donn&eacute;es
81
Valeurs renvoy&eacute;es
Cha&icirc;ne de connexion qui correspond &agrave; la connexion nomm&eacute;e.
Exemple
Le code var connectionString = MMDB.getConnectionString (&quot;EmpDB&quot;) renvoie
diff&eacute;rentes cha&icirc;nes pour une connexion ADO ou JDBC.
• Pour une connexion ADO, la cha&icirc;ne suivante peut renvoyer :
&quot;dsn=EmpDB;uid=;pwd=&quot;;
• Pour une connexion JDBC, la cha&icirc;ne suivante peut renvoyer :
&quot;jdbc:inetdae:192.168.64.49:1433?database=pubs&amp;user=JoeUser&amp;&not;
password=joesSecret&quot;
MMDB.getDriverName()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait le nom du pilote associ&eacute; &agrave; la connexion sp&eacute;cifi&eacute;e. Seules les connexions JDBC ont des
noms de pilote.
Arguments
connName
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant le nom du pilote.
Exemple
L’instruction MMDB.getDriverName (&quot;EmpDB&quot;); peut renvoyer la cha&icirc;ne suivante :
&quot;jdbc/oracle/driver/JdbcOracle&quot;
MMDB.getDriverUrlTemplateList() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver UltraDev 4, d&eacute;conseill&eacute;e dans Dreamweaver MX.
Remarque : Pour Dreamweaver UltraDev 4, la liste des pilotes JDBC est stock&eacute;e dans le fichier
connections.xml r&eacute;sidant dans le dossier Configuration/Connections. Tous les pilotes ont un mod&egrave;le
d’URL associ&eacute;. Cette fonction renvoie la liste des pilotes JDBC.
82
Chapitre 7 : API de base de donn&eacute;es
Pour Dreamweaver MX (ou version ult&eacute;rieure), ces pilotes et les mod&egrave;les d’URL sont cod&eacute;s dans
les bo&icirc;tes de dialogue JDBC. En outre, cette fonction est une d&eacute;finition de fonction vide utilis&eacute;e
pour &eacute;liminer les erreurs de fonctions non d&eacute;finies. L’exemple suivant indique la mani&egrave;re dont un
lecteur JDBC et un mod&egrave;le d’URL sont cod&eacute;s :
var DEFAULT_DRIVER = &quot;COM.ibm.db2.jdbc.app.DB2Driver&quot;;
var DEFAULT_TEMPLATE = &quot;jdbc:db2:[database]&quot;;
Dreamweaver dispose d’une bo&icirc;te de dialogue pour chaque paire pilote/mod&egrave;le d’URL.
En r&eacute;sum&eacute;, les d&eacute;veloppeurs qui utilisent Dreamweaver UltraDev 4 doivent ajouter une nouvelle
entr&eacute;e &agrave; XML et ceux qui utilisent Dreamweaver MX (ou version sup&eacute;rieure) doivent mettre en
œuvre une nouvelle bo&icirc;te de dialogue.
Description
Extrait les pilotes JDBC et les mod&egrave;les d’URL respectifs.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau contenant les pilotes JDBC d&eacute;tect&eacute;s sur le syst&egrave;me de l’utilisateur et leurs mod&egrave;les d’URL
respectifs, s’ils sont sp&eacute;cifi&eacute;s. Le tableau dispose d’un nombre pair d’&eacute;l&eacute;ments contenant :
Driver1, UrlTemplate1, Driver2, UrlTemplate2, etc.
MMDB.getLocalDsnList()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait les DSN ODBC d&eacute;finis dans le syst&egrave;me de l’utilisateur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau contenant les DSN ODBC d&eacute;finis sur le syst&egrave;me de l’utilisateur.
MMDB.getPassword()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait le mot de passe utilis&eacute; pour la connexion sp&eacute;cifi&eacute;e.
Arguments
connName
Fonctions de connexion &agrave; une base de donn&eacute;es
83
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Valeurs renvoy&eacute;es
Une cha&icirc;ne de mot de passe associ&eacute;e au nom de connexion.
Exemple
L’instruction MMDB.getPassword (&quot;EmpDB&quot;); peut renvoyer &quot;joessecret&quot;.
MMDB.getRDSPassword()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait le mot de passe Remote Development Services (RDS) (&agrave; utiliser avec les connexions
ColdFusion).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant le mot de passe RDS.
MMDB.getRDSUserName()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait le nom d’utilisateur RDS (&agrave; utiliser avec les connexions ColdFusion).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le nom d’utilisateur RDS.
MMDB.getRemoteDsnList()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
84
Chapitre 7 : API de base de donn&eacute;es
Description
Extrait les DSN ODBC du serveur de site. Les fonctions getRDSUserName() et
getRDSPassword() sont utilis&eacute;es lorsque le mod&egrave;le de serveur du site en cours est ColdFusion.
Cette fonction offre aux d&eacute;veloppeurs la possibilit&eacute; de sp&eacute;cifier une cha&icirc;ne de param&egrave;tre URL &agrave;
annexer &agrave; l’URL Remote Connectivity g&eacute;n&eacute;r&eacute;e par MMDB.getRemoteDsnList(). Si le
d&eacute;veloppeur fournit une cha&icirc;ne de param&egrave;tre, cette fonction la transmet aux scripts de
connectivit&eacute; HTTP.
Arguments
{urlParams}
• L’argument facultatif urlParams est une cha&icirc;ne contenant une liste des expressions
name=value, s&eacute;par&eacute;es par des esperluettes (&amp;). Les valeurs ne doivent pas &ecirc;tre entour&eacute;es de
guillemets. Certains caract&egrave;res, tels que l’espace dans la valeur &laquo; Hello World &raquo;, doivent &ecirc;tre
cod&eacute;s. Voici un exemple d’argument valide que vous pouvez transmettre dans
MMDB.getRemoteDsnList() :
a=1&amp;b=Hello%20World
Valeurs renvoy&eacute;es
Renvoie un tableau contenant les DSN ODBC d&eacute;finis sur le serveur pour le site en cours.
MMDB.getRuntimeConnectionType()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Renvoie le type de connexion d’ex&eacute;cution du nom de connexion sp&eacute;cifi&eacute;.
Arguments
connName
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Valeurs renvoy&eacute;es
Cha&icirc;ne correspondant au type de connexion. Cette fonction peut renvoyer une des valeurs
suivantes : &quot;ADO&quot;, &quot;ADODSN&quot;, &quot;JDBC&quot; ou&quot;CFDSN&quot;.
Exemple
Le code suivant renvoie la cha&icirc;ne &quot;ADO&quot; pour une connexion ADO :
var connectionType = MMDB.getRuntimeConnectionType (&quot;EmpDB&quot;)
MMDB.getUserName()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Fonctions de connexion &agrave; une base de donn&eacute;es
85
Description
Renvoie un nom d’utilisateur pour la connexion sp&eacute;cifi&eacute;e.
Arguments
connName
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Valeurs renvoy&eacute;es
Cha&icirc;ne de nom d’utilisateur associ&eacute;e au nom de connexion.
Exemple
L’instruction MMDB.getUserName (&quot;EmpDB&quot;); peut renvoyer &quot;amit&quot;.
MMDB.hasConnectionWithName()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
D&eacute;termine l’existence de la connexion d’un nom donn&eacute;.
Arguments
name
•
name
est le nom de la connexion.
Valeurs renvoy&eacute;es
Renvoie une valeur bool&eacute;enne : true indique l’existence d’une connexion ayant le nom sp&eacute;cifi&eacute; ;
false indique le contraire.
MMDB.needToPromptForRdsInfo()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si Dreamweaver doit ouvrir la bo&icirc;te de dialogue des informations de connexion RDS.
Arguments
bForce
•
bForce est une valeur bool&eacute;enne ; true indique que l’utilisateur ayant pr&eacute;c&eacute;demment annul&eacute;
la bo&icirc;te de dialogue RDS doit toujours &ecirc;tre invit&eacute; &agrave; saisir les informations de connexion RDS.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true indique que l’utilisateur doit &ecirc;tre invit&eacute; &agrave; saisir les informations de
connexion RDS ; false indique le contraire.
86
Chapitre 7 : API de base de donn&eacute;es
MMDB.needToRefreshColdFusionDsnList()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ordonne au Gestionnaire de connexions de vider la m&eacute;moire cache et d’extraire la liste des
sources des donn&eacute;es ColdFusion du serveur d’application la prochaine fois qu’un utilisateur
demande la liste.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
MMDB.popupConnection()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction appelle une bo&icirc;te de dialogue de connexion. Cette fonction a les trois signatures
suivantes :
• Si la liste d’arguments ne comporte que dialogFileName (une cha&icirc;ne), popupConnection()
•
•
provoque le lancement de la bo&icirc;te de dialogue de connexion dans Dreamweaver, pour que vous
puissiez y d&eacute;finir une nouvelle connexion.
Si la liste d’arguments ne comporte que connRec (une r&eacute;f&eacute;rence de connexion),
popupConnection() provoque le lancement de la bo&icirc;te de dialogue de connexion en mode
d’&eacute;dition dans Dreamweaver, pour que vous puissiez y modifier la connexion nomm&eacute;e. Dans
ce mode, la zone de texte du nom s’affiche en gris&eacute;.
Si la liste d’arguments ne comporte que connRec et la valeur bool&eacute;enne bDuplicate,
popupConnection() provoque le lancement de la bo&icirc;te de dialogue en mode dupliqu&eacute; dans
Dreamweaver. Dans ce mode, la zone de texte du nom s’affiche en gris&eacute; et les propri&eacute;t&eacute;s
restantes sont copi&eacute;es pour d&eacute;finir une connexion dupliqu&eacute;e.
Arguments
dialogFileName
ou
connRec
ou
connrec, bDuplicate
Fonctions de connexion &agrave; une base de donn&eacute;es
87
•
•
•
dialogFileName est une cha&icirc;ne qui contient le nom d’un fichier HTML r&eacute;sidant dans le
dossier Configuration/Connections/server-model. Ce fichier HTML d&eacute;finit la bo&icirc;te de dialogue
qui cr&eacute;e une connexion. Il doit impl&eacute;menter trois fonctions API JavaScript :
findConnection(), inspectConnection() et applyConnection(). En g&eacute;n&eacute;ral, vous cr&eacute;ez
un fichier JavaScript qui impl&eacute;mente ces fonctions, puis vous int&eacute;grez ce fichier au fichier
HTML. Pour plus d’informations sur la cr&eacute;ation d’une connexion, voir API de connectivit&eacute; &agrave;
une base de donn&eacute;es, page 103.
connRec est une r&eacute;f&eacute;rence &agrave; un objet de connexion existant.
bDuplicate est une valeur bool&eacute;enne.
Valeurs renvoy&eacute;es
Aucune. La bo&icirc;te de dialogue de connexion d&eacute;finie s’ouvre.
MMDB.setRDSPassword()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
D&eacute;finit le mot de passe RDS.
Arguments
password
•
password
est une cha&icirc;ne contenant le mot de passe RDS.
Valeurs renvoy&eacute;es
Aucune.
MMDB.setRDSUserName()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
D&eacute;finit le nom d’utilisateur RDS.
Arguments
username
• L’argument username est le nom d’un utilisateur RDS valide.
Valeurs renvoy&eacute;es
Aucune.
MMDB.showColdFusionAdmin()
Disponibilit&eacute;
Dreamweaver MX.
88
Chapitre 7 : API de base de donn&eacute;es
Description
Affiche la bo&icirc;te de dialogue ColdFusion Administrator.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune. La bo&icirc;te de dialogue ColdFusion Administrator appara&icirc;t.
MMDB.showConnectionMgrDialog()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche la bo&icirc;te de dialogue Gestionnaire de connexions.
Arguments
Aucune.
Valeurs renvoy&eacute;es
Aucune. La bo&icirc;te de dialogue Gestionnaire de connexions s’affiche.
MMDB.showOdbcDialog()
Disponibilit&eacute;
Dreamweaver UltraDev 4 (Windows uniquement).
Description
Affiche la bo&icirc;te de dialogue d’administration ODBC syst&egrave;me ou Administrateur de source de
donn&eacute;es ODBC.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune. La bo&icirc;te de dialogue d’administration ODBC syst&egrave;me ou Administrateur de source de
donn&eacute;es ODBC appara&icirc;t.
MMDB.showRdsUserDialog()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Affiche la bo&icirc;te de dialogue demandant le nom d’utilisateur et du mot de passe RDS.
Fonctions de connexion &agrave; une base de donn&eacute;es
89
Arguments
username, password
• L’argument username est le nom d’utilisateur initial.
• password est le mot de passe initial.
Valeurs renvoy&eacute;es
Objet contenant les nouvelles valeurs dans les propri&eacute;t&eacute;s username et password. Si l’une des
propri&eacute;t&eacute;s n’est pas d&eacute;finie, ceci indique que l’utilisateur a annul&eacute; la bo&icirc;te de dialogue.
MMDB.showRestrictDialog()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Affiche la bo&icirc;te de dialogue Restreindre.
Arguments
catalog, schema
• catalog est la valeur de catalogue initiale.
• L’argument schema est la valeur de sch&eacute;ma initiale.
Valeurs renvoy&eacute;es
Objet contenant les nouvelles valeurs dans les propri&eacute;t&eacute;s catalog et schema. Si l’une des
propri&eacute;t&eacute;s n’est pas d&eacute;finie, ceci indique que l’utilisateur a annul&eacute; la bo&icirc;te de dialogue.
MMDB.testConnection()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Teste les param&egrave;tres de connexion. Affiche une bo&icirc;te de dialogue modale qui d&eacute;crit les r&eacute;sultats.
Arguments
serverPropertiesArray
Cette fonction attend un seul argument, un objet de tableau contenant les valeurs de la liste
suivante adapt&eacute;es au mod&egrave;le de serveur en cours. Pour les propri&eacute;t&eacute;s qui ne s’appliquent pas &agrave; la
connexion test&eacute;e, laissez-les vides (&quot;&quot;).
•
•
•
•
•
•
90
type indique, lorsque useHTTP est une valeur false, quelle DLL utiliser pour se connecter &agrave;
une base de donn&eacute;es au moment de la conception, pour tester les param&egrave;tres de connexion.
string est la cha&icirc;ne de connexion ADO ou l’URL JDBC.
dsn est le nom de la source de donn&eacute;es.
driver est le pilote JDBC.
username est le nom d’utilisateur.
L’argument password est le mot de passe.
Chapitre 7 : API de base de donn&eacute;es
• L’argument useHTTP est une valeur bool&eacute;enne. Une valeur true sp&eacute;cifie que Dreamweaver doit
utiliser une connexion HTTP au moment de la conception ; dans le cas contraire,
Dreamweaver utilise une DLL.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le test de connexion r&eacute;ussit ; false dans le cas contraire.
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
Les fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es vous permettent de faire une recherche dans la base de
donn&eacute;es. Pour l’ensemble des fonctions qui g&egrave;rent une connexion &agrave; une base de donn&eacute;es, voir
Fonctions de connexion &agrave; une base de donn&eacute;es, page 78.
La liste suivante d&eacute;crit certains des arguments communs &agrave; toutes les fonctions disponibles :
• La plupart des fonctions d’acc&egrave;s &agrave; une base de donn&eacute;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&egrave;re vous permet d’obtenir
par programmation une liste de tous les noms de connexion.
Les proc&eacute;dures stock&eacute;es exigent souvent des param&egrave;tres. Il existe deux fa&ccedil;ons de sp&eacute;cifier des
valeurs de param&egrave;tre pour les fonctions d’acc&egrave;s aux bases de donn&eacute;es. En premier lieu, vous
pouvez fournir un tableau de valeurs de param&egrave;tre (paramValuesArray). Si vous ne sp&eacute;cifiez
que des valeurs de param&egrave;tre, celles-ci doivent &ecirc;tre dans l’ordre dans lequel la proc&eacute;dure stock&eacute;e
les demande. Sp&eacute;cifiez ensuite les valeurs de param&egrave;tre pour fournir un tableau des noms de
param&egrave;tre (paramNameArray). Vous pouvez utiliser la fonction MMDB.getSPParamsAsString()
pour obtenir les param&egrave;tres de la proc&eacute;dure stock&eacute;e. Si vous fournissez des noms de param&egrave;tres,
les valeurs sp&eacute;cifi&eacute;es dans paramValuesArray doivent &ecirc;tre dans l’ordre dans lequel les noms ont
&eacute;t&eacute; sp&eacute;cifi&eacute;s dans paramNameArray.
MMDB.getColumnAndTypeList()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait une liste de colonnes et leurs types respectifs d’une d&eacute;claration SQL SELECT.
Arguments
connName, d&eacute;claration
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour effectuer une connexion de base de
donn&eacute;es &agrave; une source de donn&eacute;es active.
statement est la d&eacute;claration SQL SELECT &agrave; ex&eacute;cuter.
connName
Renvoie
Un tableau de cha&icirc;nes qui repr&eacute;sente une liste de colonnes (et leur type) qui correspondent &agrave; la
d&eacute;claration SELECT, ou bien une erreur si la d&eacute;claration SQL n’est pas valide ou si la connexion n’a
pas pu s’&eacute;tablir.
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
91
Exemple
Le code var columnArray = MMDB.getColumnAndTypeList(&quot;EmpDB&quot;,&quot;Select * from
Employees&quot;) renvoie le tableau de cha&icirc;nes suivant :
columnArray[0]
columnArray[1]
columnArray[2]
columnArray[3]
columnArray[4]
columnArray[5]
=
=
=
=
=
=
&quot;EmpName&quot;
&quot;varchar&quot;
&quot;EmpFirstName&quot;
&quot;varchar&quot;
&quot;Age&quot;
&quot;integer&quot;
MMDB.getColumnList()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait la liste de colonnes d’une d&eacute;claration SQL SELECT ex&eacute;cut&eacute;e.
Arguments
connName, d&eacute;claration
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
statement est la d&eacute;claration SQL SELECT &agrave; ex&eacute;cuter.
connName
Renvoie
Un tableau de cha&icirc;nes qui repr&eacute;sente une liste de colonnes correspondant &agrave; la d&eacute;claration SELECT,
ou une erreur si la d&eacute;claration SQL n’est pas valide ou si la connexion n’a pas pu s’&eacute;tablir.
Exemple
Le code var columnArray = MMDB.getColumnList(&quot;EmpDB&quot;,&quot;Select * from Employees&quot;)
renvoie le tableau de cha&icirc;nes suivant :
columnArray[0] = &quot;EmpName&quot;
columnArray[1] = &quot;EmpFirstName&quot;
columnArray[2] = &quot;Age&quot;
MMDB.getColumns()
Disponibilit&eacute;
Dreamweaver MX, arguments mis &agrave; jour dans MX 2004.
Description
Renvoie un tableau d’objets qui d&eacute;crivent les colonnes du tableau sp&eacute;cifi&eacute;.
Arguments
connName, tableName
• L’argument connName est le nom de la connexion. Cette valeur identifie la connexion qui
contient la cha&icirc;ne que Dreamweaver doit utiliser pour &eacute;tablir une connexion de base de
donn&eacute;es &agrave; une source de donn&eacute;es active.
92
Chapitre 7 : API de base de donn&eacute;es
•
tableName
est le tableau &agrave; interroger.
Renvoie
Un tableau d ’objets, &agrave; raison d’un objet par colonne. Chaque objet d&eacute;finit les trois propri&eacute;t&eacute;s
suivantes pour la colonne &agrave; laquelle il est associ&eacute;.
Property Name
Description
name
Nom de la colonne (par exemple, price)
datatype
Type de donn&eacute;es de la colonne (par exemple, small money)
definedsize
Taille d&eacute;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&eacute;finir la valeur du texte de l’info bulle :
var columnNameObjs = MMDB.getColumns(connName,tableName);
var databaseType
= MMDB.getDatabaseType(connName);
for (i = 0; i &lt; 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&eacute;
Dreamweaver UltraDev 1.
Description
Extrait une liste de toutes les colonnes du tableau sp&eacute;cifi&eacute;.
Arguments
connName, tableName
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument tableName est le nom d’une table de la base de donn&eacute;es d&eacute;sign&eacute;e par l’argument
connName.
connName
Renvoie
Un tableau de cha&icirc;nes dont chaque cha&icirc;ne est le nom d’une colonne du tableau.
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
93
Exemple
L’instruction MMDB.getColumnsOfTable (&quot;EmpDB&quot;,&quot;Employees&quot;); renvoie les cha&icirc;nes
suivantes :
[&quot;EmpID&quot;, &quot;FirstName&quot;, &quot;LastName&quot;]
MMDB.getPrimaryKeys()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie les noms de colonne qui s’associent pour former la cl&eacute; primaire de la table nomm&eacute;e. Une
cl&eacute; primaire sert d’identificateur unique pour une ligne de base de donn&eacute;es et se compose d’une
colonne minimum.
Arguments
connName, tableName
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument tableName est le nom de la table pour laquelle vous souhaitez restituer l’ensemble
des colonnes comprenant la cl&eacute; primaire de cette table.
connName
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes. Le tableau contient une cha&icirc;ne pour chaque colonne comprenant la cl&eacute;
primaire.
Exemple
L’exemple suivant renvoie la cl&eacute; primaire de la table.
var connName
= componentRec.parent.parent.parent.name;
var tableName
= componentRec.name;
var primaryKeys = MMDB.getPrimaryKeys(connName,tableName);
MMDB.getProcedures()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie un tableau d’objets de proc&eacute;dure associ&eacute;s &agrave; une connexion nomm&eacute;e.
Arguments
connName
•
94
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Chapitre 7 : API de base de donn&eacute;es
Valeurs renvoy&eacute;es
Un tableau d’objets de proc&eacute;dure dans lequel chaque objet de proc&eacute;dure a les trois propri&eacute;t&eacute;s
suivantes :
Nom de propri&eacute;t&eacute;
Description
sch&eacute;ma*
Nom du sch&eacute;ma associ&eacute; &agrave; l’objet.
Cette propri&eacute;t&eacute; identifie l’utilisateur associ&eacute; &agrave; la proc&eacute;dure
stock&eacute;e dans la base de donn&eacute;es SQL et &agrave; laquelle acc&egrave;de
getProcedures(). La base de donn&eacute;es &agrave; laquelle acc&egrave;de cette
fonction d&eacute;pend du type de connexion.
• Pour les connexions ODBC, la source de donn&eacute;es ODBC
d&eacute;finit la base de donn&eacute;es. Le DSN est sp&eacute;cifi&eacute; par la propri&eacute;t&eacute;
dsn dans l’objet de connexion (connName) que vous transmettez
&agrave; getProcedures().
• Pour les connexion &agrave; la BD OLE, la cha&icirc;ne de connexion donne
un nom &agrave; la base de donn&eacute;es.
catalogue
Nom du catalogue associ&eacute; &agrave; l’objet (qualificatif de propri&eacute;taire).
La valeur de la propri&eacute;t&eacute; catalog est d&eacute;finie par un attribut du
pilote de la BD OLE. Cet attribut du pilote d&eacute;finit une
user.database par d&eacute;faut &agrave; utiliser lorsque la cha&icirc;ne de
connexion &agrave; la BD OLE n’indique pas de base de donn&eacute;es.
procedure
Nom de la proc&eacute;dure.
*
Dreamweaver &eacute;tablit &eacute;galement une connexion et regroupe toutes les tables dans la base de donn&eacute;es chaque
fois que vous modifiez un jeu d’enregistrements. Si la base de donn&eacute;es comporte un nombre important de
tables, Dreamweaver peut prendre du temps pour les r&eacute;cup&eacute;rer sur certains syst&egrave;mes. Si votre base de
donn&eacute;es contient un sch&eacute;ma ou un catalogue, vous pouvez les utiliser pour restreindre le nombre d’&eacute;l&eacute;ments de
la base de donn&eacute;es extraits par Dreamweaver au moment de la conception. Pour commencer, cr&eacute;ez un sch&eacute;ma
ou un catalogue dans votre application de base de donn&eacute;es pour pouvoir ensuite l’appliquer dans
Dreamweaver. Reportez-vous &agrave; la documentation sur votre base de donn&eacute;es ou consultez votre administrateur
syst&egrave;me.
Exemple
Le code suivant extrait une liste de proc&eacute;dures :
var procObjects
= MMDB.getProcedures(connectionName);
for (i = 0; i &lt; procObjects.length; i++)
{
var thisProcedure = procObjects[i]
thisSchema = Trim(thisProcedure.schema)
if (thisSchema.length == 0)
{
thisSchema = Trim(thisProcedure.catalog)
}
if (thisSchema.length &gt; 0)
{
thisSchema += &quot;.&quot;
}
var procName = String(thisSchema + thisProcedure.procedure);
}
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
95
MMDB.getSPColumnList()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de colonnes de jeu de r&eacute;sultats g&eacute;n&eacute;r&eacute;e par un appel &agrave; la proc&eacute;dure
stock&eacute;e sp&eacute;cifi&eacute;e.
Arguments
connName, statement, paramValuesArray
•
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument statement est le nom de la proc&eacute;dure stock&eacute;e qui renvoie le jeu de r&eacute;sultats
lorsqu’elle est ex&eacute;cut&eacute;e.
L’argument paramValuesArray est un tableau contenant une liste de valeurs tests de param&egrave;tre
au moment de la conception. Sp&eacute;cifiez les valeurs de param&egrave;tre dans l’ordre attendu par la
proc&eacute;dure stock&eacute;e. Vous pouvez utiliser la fonction MMDB.getSPParamsAsString() pour
obtenir les param&egrave;tres de la proc&eacute;dure stock&eacute;e.
connName
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes repr&eacute;sentant la liste des colonnes. Cette fonction renvoie une erreur lorsque
l’instruction SQL ou la cha&icirc;ne de connexion est incorrecte.
Exemple
Le code suivant peut renvoyer une liste de colonnes de jeux de r&eacute;sultats g&eacute;n&eacute;r&eacute;es &agrave; partir de la
proc&eacute;dure stock&eacute;e ex&eacute;cut&eacute;e, getNewEmployeesMakingAtLeast :
var paramValueArray = new Array(&quot;2/1/2000&quot;, &quot;50000&quot;)
var columnArray = MMDB.getSPColumnList(&quot;EmpDB&quot;, &not;
&quot;getNewEmployeesMakingAtLeast&quot;, paramValueArray)
Les valeurs suivantes renvoient :
columnArray[0] = &quot;EmpID&quot;, columnArray[1] = &quot;LastName&quot;, &not;
columnArray[2] =&quot;startDate&quot;, columnArray[3] = &quot;salary&quot;
MMDB.getSPColumnListNamedParams()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Cette fonction extrait une liste de colonnes de jeu de r&eacute;sultats g&eacute;n&eacute;r&eacute;e par un appel &agrave; la proc&eacute;dure
stock&eacute;e sp&eacute;cifi&eacute;e.
96
Chapitre 7 : API de base de donn&eacute;es
Arguments
connName, statement, paramNameArray, paramValuesArray
•
•
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument statement est le nom de la proc&eacute;dure stock&eacute;e qui renvoie le jeu de r&eacute;sultats
lorsqu’elle est ex&eacute;cut&eacute;e.
L’argument paramNameArray est un tableau contenant une liste de noms de param&egrave;tres. Vous
pouvez utiliser la fonction MMDB.getSPParamsAsString() pour obtenir les param&egrave;tres de la
proc&eacute;dure stock&eacute;e.
L’argument paramValuesArray est un tableau contenant une liste de valeurs tests de param&egrave;tre
au moment de la conception. Vous pouvez sp&eacute;cifier si oui ou non la proc&eacute;dure requiert des
param&egrave;tres pendant l’ex&eacute;cution. Si vous avez fourni des noms de param&egrave;tre dans
paramNameArray, sp&eacute;cifiez les valeurs de param&egrave;tre dans l’ordre dans lequel leurs noms
apparaissent dans paramNameArray. Si vous n’avez pas indiqu&eacute; paramNameArray, sp&eacute;cifiez les
valeurs dans l’ordre attendu par la proc&eacute;dure stock&eacute;e.
connName
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes repr&eacute;sentant la liste des colonnes. Cette fonction renvoie une erreur lorsque
l’instruction SQL ou la cha&icirc;ne de connexion est incorrecte.
Exemple
Le code suivant peut renvoyer une liste de colonnes de jeux de r&eacute;sultats g&eacute;n&eacute;r&eacute;es &agrave; partir de la
proc&eacute;dure stock&eacute;e ex&eacute;cut&eacute;e, getNewEmployeesMakingAtLeast :
var paramNameArray = new Array(&quot;startDate&quot;, &quot;salary&quot;)
var paramValueArray = new Array(&quot;2/1/2000&quot;, &quot;50000&quot;)
var columnArray = MMDB.getSPColumnListNamedParams(&quot;EmpDB&quot;, &not;
&quot;getNewEmployeesMakingAtLeast&quot;, paramNameArray, paramValueArray)
Les valeurs suivantes renvoient :
columnArray[0] = &quot;EmpID&quot;, columnArray[1] = &quot;LastName&quot;,&not;
columnArray[2] =&quot;startDate&quot;, columnArray[3] = &quot;salary&quot;
MMDB.getSPParameters()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie un tableau d’objets de param&egrave;tre pour une proc&eacute;dure nomm&eacute;e.
Arguments
connName, procName
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument procName est le nom de la proc&eacute;dure.
connName
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
97
Valeurs renvoy&eacute;es
Tableau d’objets de param&egrave;tre, chacun d’entre eux sp&eacute;cifiant l’ensemble de propri&eacute;t&eacute;s suivant :
Nom de la propri&eacute;t&eacute;
Description
name
Nom du param&egrave;tre (par exemple, @@lolimit)
datatype
Type de donn&eacute;es du param&egrave;tre (par exemple, smallmoney)
direction
Direction du param&egrave;tre :
1– Le param&egrave;tre est utilis&eacute; uniquement pour l’entr&eacute;e.
2– Le param&egrave;tre est utilis&eacute; uniquement pour la sortie. Dans ce
cas, vous transmettez le param&egrave;tre par r&eacute;f&eacute;rence et la m&eacute;thode
place une valeur dedans. Vous pouvez utiliser la valeur une fois la
m&eacute;thode renvoy&eacute;e.
3– Le param&egrave;tre est utilis&eacute; pour l’entr&eacute;e et la sortie.
4– Le param&egrave;tre contient une valeur de retour.
Exemple
L’exemple suivant extrait les objets de param&egrave;tre pour la proc&eacute;dure sp&eacute;cifi&eacute;e et cr&eacute;e une info bulle
pour chaque objet qui utilise ses propri&eacute;t&eacute;s.
var paramNameObjs = MMDB.getSPParameters(connName,procName);
for (i = 0; i &lt; paramNameObjs.length; i++)
{
var paramObj = paramNameObjs[i];
var tooltiptext = paramObj.datatype;
tooltiptext+=&quot; &quot;;
tooltiptext+=GetDirString(paramObj.directiontype);
}
MMDB.getSPParamsAsString()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait une cha&icirc;ne d&eacute;limit&eacute;e par virgules contenant la liste des param&egrave;tres pris par la proc&eacute;dure
stock&eacute;e.
Arguments
connName, procName
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument procName est le nom de la proc&eacute;dure stock&eacute;e.
connName
Valeurs renvoy&eacute;es
Cha&icirc;ne d&eacute;limit&eacute;e par virgules contenant la liste des param&egrave;tres requis par la proc&eacute;dure stock&eacute;e.
Les noms, la direction et le type de donn&eacute;es des param&egrave;tres sont inclus, s&eacute;par&eacute;s par des pointsvirgules (;).
98
Chapitre 7 : API de base de donn&eacute;es
Exemple
Le code MMDB.getSPParamsAsString (&quot;EmpDB&quot;,&quot;getNewEmployeesMakingAtLeast&quot;) peut
renvoyer une cha&icirc;ne de nom de formulaire startDate;direction:in;datatype:date,
salary;direction:in;datatype:integer
Dans cet exemple, la proc&eacute;dure stock&eacute;e getNewEmployeesMakingAtLeast a deux param&egrave;tres :
startDate et Salary. Pour startDate, la direction est in et le type de donn&eacute;es est date. Pour
salary, la direction est in et le type de donn&eacute;es est date.
MMDB.getTables()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Extrait une liste de toutes les tables d&eacute;finies pour la base de donn&eacute;es sp&eacute;cifi&eacute;e. Chaque objet a trois
propri&eacute;t&eacute;s : table, schema et catalog.
Arguments
connName
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Valeurs renvoy&eacute;es
Un tableau d’objets dans lequel chaque objet a trois propri&eacute;t&eacute;s : table, schema et catalog.
Table est le nom de la table. Schema est le nom du sch&eacute;ma qui contient la table. Catalog est le
catalogue qui contient la table.
Exemple
L’instruction MMDB.getTables (&quot;EmpDB&quot;); pourrait produire un tableau de deux objets. Les
propri&eacute;t&eacute;s du premier objet peuvent ressembler &agrave; l’exemple suivant :
object1[table:&quot;Employees&quot;, schema:&quot;personnel&quot;, catalog:&quot;syscat&quot;]
Les propri&eacute;t&eacute;s du deuxi&egrave;me objet peuvent ressembler &agrave; l’exemple suivant :
object2[table:&quot;Departments&quot;, schema:&quot;demo&quot;, catalog:&quot;syscat2&quot;]
MMDB.getViews()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait une liste de tous les modes d’affichage d&eacute;finis pour la base de donn&eacute;es sp&eacute;cifi&eacute;e. Chaque
objet mode d’affichage a les propri&eacute;t&eacute;s catalog, schema et view.
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
99
Arguments
connName
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
connName
Valeurs renvoy&eacute;es
Un table d’objets d’affichage dans lequel chaque objet a trois propri&eacute;t&eacute;s : catalog, schema et
view. Catalog ou schema permet de restreindre/filtrer le nombre de modes d’affichage rattach&eacute;s &agrave;
un nom de sch&eacute;ma individuel ou &agrave; un nom de catalogue d&eacute;fini comme faisant partie des
informations de connexion.
Exemple
L’exemple suivant renvoie les modes pour une valeur de connexion donn&eacute;e,
CONN_LIST.getValue() :
var viewObjects = MMDB.getViews(CONN_LIST.getValue())
for (i = 0; i &lt; viewObjects.length; i++)
{
thisView = viewObjects[i]
thisSchema = Trim(thisView.schema)
if (thisSchema.length == 0)
{
thisSchema = Trim(thisView.catalog)
}
if (thisSchema.length &gt; 0)
{
thisSchema += &quot;.&quot;
}
views.push(String(thisSchema + thisView.view))
}
MMDB.showResultset()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche une bo&icirc;te de dialogue contenant les r&eacute;sultats de l’ex&eacute;cution de la d&eacute;claration SQL
sp&eacute;cifi&eacute;e. La bo&icirc;te de dialogue contient une grille dont l’en-t&ecirc;te refl&egrave;te les informations de
colonnes qui d&eacute;crivent le jeu de r&eacute;sultats. Si la cha&icirc;ne de connexion ou l’instruction SQL n’est pas
valide, une erreur appara&icirc;t. Cette fonction valide l’instruction SQL.
Arguments
connName, SQLstatement
•
•
100
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument SQLstatement d&eacute;signe l’instruction SQL SELECT.
connName
Chapitre 7 : API de base de donn&eacute;es
Valeurs renvoy&eacute;es
Aucune. Cette fonction renvoie une erreur lorsque l’instruction SQL ou la cha&icirc;ne de connexion
est incorrecte.
Exemple
Le code suivant affiche le r&eacute;sultat de l’instruction SQL ex&eacute;cut&eacute;e :
MMDB.showResultset(&quot;EmpDB&quot;,&quot;Select EmpName,EmpFirstName,Age &not;
from Employees&quot;)
MMDB.showSPResultset()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche une bo&icirc;te de dialogue contenant les r&eacute;sultats de l’ex&eacute;cution de la proc&eacute;dure stock&eacute;e
sp&eacute;cifi&eacute;e. La bo&icirc;te de dialogue contient une grille dont l’en-t&ecirc;te refl&egrave;te les informations de
colonne qui d&eacute;crivent le jeu de r&eacute;sultats. Si la cha&icirc;ne de connexion ou la proc&eacute;dure stock&eacute;e n’est
pas valide, une erreur appara&icirc;t. Cette fonction valide la proc&eacute;dure stock&eacute;e.
Arguments
connName, procName, paramValuesArray
•
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument procName est le nom de la proc&eacute;dure stock&eacute;e &agrave; ex&eacute;cuter.
paramValuesArrayargument est un tableau contenant une liste de valeurs tests de param&egrave;tre
au moment de la conception. Sp&eacute;cifiez les valeurs de param&egrave;tre dans l’ordre attendu par la
proc&eacute;dure stock&eacute;e. Vous pouvez utiliser la fonction MMDB.getSPParamsAsString() pour
obtenir les param&egrave;tres de la proc&eacute;dure stock&eacute;e.
connName
Valeurs renvoy&eacute;es
Cette fonction renvoie une erreur lorsque l’instruction SQL ou la cha&icirc;ne de connexion est
incorrecte, sinon, elle ne renvoie rien.
Exemple
Le code suivant affiche le r&eacute;sultat de la proc&eacute;dure stock&eacute;e ex&eacute;cut&eacute;e :
var paramValueArray = new Array(&quot;2/1/2000&quot;, &quot;50000&quot;)
MMDB.showSPResultset(&quot;EmpDB&quot;, &quot;getNewEmployeesMakingAtLeast&quot;, &not;
paramValueArray)
Fonctions d’acc&egrave;s &agrave; la base de donn&eacute;es
101
MMDB.showSPResultsetNamedParams()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche une bo&icirc;te de dialogue contenant le jeu de r&eacute;sultats de la proc&eacute;dure stock&eacute;e sp&eacute;cifi&eacute;e. La
bo&icirc;te de dialogue contient une grille dont l’en-t&ecirc;te refl&egrave;te les informations de colonne qui
d&eacute;crivent le jeu de r&eacute;sultats. Si la cha&icirc;ne de connexion ou la proc&eacute;dure stock&eacute;e n’est pas valide, une
erreur appara&icirc;t. Cette fonction valide la proc&eacute;dure stock&eacute;e. Cette fonction diff&egrave;re de
MMDB.showSPResultset(), car vous pouvez sp&eacute;cifier les valeurs de param&egrave;tre par leur nom, au
lieu de l’ordre attendu par la proc&eacute;dure stock&eacute;e.
Arguments
connName, procName, paramNameArray, paramValuesArray
•
•
•
•
est un nom de connexion sp&eacute;cifi&eacute; dans le Gestionnaire de connexions. Il identifie la
cha&icirc;ne de connexion que Dreamweaver doit utiliser pour connecter la base de donn&eacute;es &agrave; une
source de donn&eacute;es active.
L’argument procName est le nom de la proc&eacute;dure stock&eacute;e qui renvoie le jeu de r&eacute;sultats
lorsqu’elle est ex&eacute;cut&eacute;e.
L’argument paramNameArray est un tableau contenant une liste de noms de param&egrave;tres. Vous
pouvez utiliser la fonction MMDB.getSPParamsAsString() pour obtenir les param&egrave;tres de la
proc&eacute;dure stock&eacute;e.
L’argument paramValuesArray est un tableau contenant une liste de valeurs tests de param&egrave;tre
au moment de la conception.
connName
Valeurs renvoy&eacute;es
Cette fonction renvoie une erreur lorsque l’instruction SQL ou la cha&icirc;ne de connexion est
incorrecte, sinon, elle ne renvoie rien.
Exemple
Le code suivant affiche le r&eacute;sultat de la proc&eacute;dure stock&eacute;e ex&eacute;cut&eacute;e :
var paramNameArray = new Array(&quot;startDate&quot;, &quot;salary&quot;)
var paramValueArray = new Array(&quot;2/1/2000&quot;, &quot;50000&quot;)
MMDB.showSPResultsetNamedParams(&quot;EmpDB&quot;,&quot;getNewEmployees&not;
MakingAtLeast&quot;, paramNameArray, paramValueArray)
102
Chapitre 7 : API de base de donn&eacute;es
CHAPITRE 8
API de connectivit&eacute; &agrave; une base de donn&eacute;es
En tant que d&eacute;veloppeur, vous pouvez cr&eacute;er de nouveaux types de connexions et leurs bo&icirc;tes de
dialogue correspondantes pour les mod&egrave;les de serveur nouveaux et existants de Macromedia
Dreamweaver MX 2004. Lorsqu’un utilisateur cr&eacute;e ensuite un site pour &eacute;laborer des pages, il ou
elle cr&eacute;e un nouvel objet de connexion apr&egrave;s avoir s&eacute;lectionn&eacute; le type particulier de connexion que
vous avez cr&eacute;&eacute;.
L’utilisateur peut s&eacute;lectionner votre nouveau type de connexion de plusieurs mani&egrave;res :
• Il peut cliquer sur le bouton plus (+) et s&eacute;lectionner Jeu d’enregistrements dans le panneau
•
Application. Il peut ensuite agrandir la fen&ecirc;tre de la liste Connexion dans la bo&icirc;te de dialogue
Jeu d’enregistrements.
Il peut cliquer sur le bouton plus (+) et s&eacute;lectionner Nom de la source de donn&eacute;es dans l’onglet
Base de donn&eacute;es du panneau Bases de donn&eacute;es.
D&eacute;veloppement d’un nouveau type de connexion
Les &eacute;tapes suivantes expliquent le processus de cr&eacute;ation d’un nouveau type de connexion :
1 D&eacute;finissez la mise en forme de la bo&icirc;te de dialogue de connexion.
Cr&eacute;ez un fichier HTML mettant en forme l’interface utilisateur de votre bo&icirc;te de dialogue de
connexion. Donnez un nom &agrave; ce fichier en utilisant le nom de la connexion (par exemple
myConnection.htm). Pour plus d’informations sur la cr&eacute;ation d’une bo&icirc;te de dialogue, voir
Bien d&eacute;marrer avec Dreamweaver.
V&eacute;rifiez que ce fichier HTML inclut une r&eacute;f&eacute;rence au fichier de mise en œuvre de JavaScript
d&eacute;fini &agrave; l’&eacute;tape 2, Cr&eacute;ez un fichier JavaScript qui impl&eacute;mente au moins les &eacute;l&eacute;ments suivants :,
page 104, comme le montre l’exemple suivant :
&lt;head&gt;
&lt;script SRC=&quot;../myConnectionImpl.js&quot;&gt;&lt;/script&gt;
&lt;/head&gt;
Stockez ce fichier HTML, qui d&eacute;finit votre bo&icirc;te de dialogue de connexion, dans le dossier
Configuration/Connections/server-model/platform (o&ugrave; la plate-forme est Windows ou
Macintosh).
Par exemple, la bo&icirc;te de dialogue de connexion ADO par d&eacute;faut pour un document ASP
JavaScript sur une plate-forme Windows est stock&eacute;e dans le dossier ASP_Js/Win et est intitul&eacute;e
Connection_ado_conn_string.htm.
103
Remarque : Pendant l’ex&eacute;cution, Macromedia Dreamweaver &eacute;tablit de mani&egrave;re dynamique la liste
des types de connexion disponibles dans l’ensemble des bo&icirc;tes de dialogue pr&eacute;sentes dans le
dossier ASP_Js/Win.
Le dossier Configuration/ServerModels contient des fichiers HTML qui d&eacute;finissent chaque
mod&egrave;le de serveur. A l’int&eacute;rieur de chaque fichier HTML se trouve la fonction
getServerModelFolderName(), qui renvoie le nom du dossier associ&eacute; au mod&egrave;le de serveur.
L’exemple suivant indique la fonction pour le type de document ASP JavaScript :
fonction getServerModelFolderName()
{
renvoie &quot;ASP_JS&quot; ;
}
Vous pouvez &eacute;galement consulter le fichier MMDocumentTypes.xml, situ&eacute; dans le dossier
Configuration/DocumentTypes, pour d&eacute;terminer la correspondance entre les mod&egrave;les de
serveur et les types de documents.
2 Cr&eacute;ez un fichier JavaScript qui impl&eacute;mente au moins les &eacute;l&eacute;ments suivants :
El&eacute;ment
Description
Un ensemble de variables
Chacune d’entre elles d&eacute;finit une
Type de connexion, nom de
propri&eacute;t&eacute; de connexion sp&eacute;cifique la source de donn&eacute;es, etc.
Un ensemble de boutons
Tous les boutons apparaissent
dans la bo&icirc;te de dialogue de
connexion
Fonctions de connectivit&eacute; Ensemble, ces fonctions
d&eacute;finissent l’API de connectivit&eacute;
Exemples
Tester, Aide, etc. (OK et
Annuler sont
automatiquement inclus)
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
&eacute;galement le stocker dans le sous-dossier appropri&eacute; du dossier Configuration/Connections.
Remarque : Le fichier HTML d&eacute;fini &agrave; l’&eacute;tape 1 D&eacute;finissez la mise en forme de la bo&icirc;te de dialogue de
connexion., page 103, doit inclure ce fichier de mise en œuvre du type de connexion.
Ces deux &eacute;tapes constituent les conditions minimales pour cr&eacute;er une nouvelle bo&icirc;te de dialogue
de connexion, sauf si vous avez besoin de d&eacute;finir des param&egrave;tres de connexion autres que ceux
fournis dans le fichier standard connection_includefile.edml.
Remarque : Le titre de la bo&icirc;te de dialogue que voit l’utilisateur se trouve dans la balise title,
sp&eacute;cifi&eacute;e dans le document HTML.
Les fonctions r&eacute;pertori&eacute;es dans la section suivante permettent de cr&eacute;er une bo&icirc;te de dialogue de
connexion. En plus d’impl&eacute;menter les appels pour la g&eacute;n&eacute;ration des fichiers inclus r&eacute;serv&eacute;s &agrave;
l’utilisateur, vous pouvez enregistrer votre type de connectivit&eacute; dans la section du mod&egrave;le de
serveur du fichier XML de connexion.
Pour plus d’informations sur l’API de connectivit&eacute; &agrave; une base de donn&eacute;es, associ&eacute;e &agrave; la cr&eacute;ation
d’une nouvelle connexion, voir Fonctions de connexion &agrave; une base de donn&eacute;es, page 78.
104
Chapitre 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es
API de connexion
Pour cr&eacute;er un nouveau type de connexion, y compris la bo&icirc;te de dialogue avec laquelle les
utilisateurs interagissent, vous devez impl&eacute;menter les trois fonctions suivantes :
findConnection(), inspectConnection() et applyConnection(). Ecrivez ces trois fonctions
et incluez-les dans le fichier de mise en œuvre JavaScript associ&eacute; &agrave; votre nouveau type de
connexion (voir l’&eacute;tape 2 Cr&eacute;ez un fichier JavaScript qui impl&eacute;mente au moins les &eacute;l&eacute;ments suivants :,
page 104).
La fonction applyConnection() renvoie une source HTML dans un fichier inclus. Consultez les
exemples de source HTML dans le Fichier inclus g&eacute;n&eacute;r&eacute;, page 108. La fonction
findConnection() prend la source HTML et en extrait les propri&eacute;t&eacute;s. Vous pouvez mettre en
œuvre findConnection() pour utiliser les mod&egrave;les de recherche dans les fichiers XML afin
d’extraire les informations renvoy&eacute;es &agrave; partir de applyConnection(). Si vous souhaitez voir un
exemple de ce type de mise en œuvre, &eacute;tudiez les deux fichiers JavaScript suivants :
•
connection_ado_conn_string.js
se trouve dans le dossier Configuration/Connections/
ASP_Js.
•
connection_common.js
se trouve dans le dossierConfiguration/Connections/Shared.
Lorsque l’utilisateur ouvre un site, Dreamweaver parcourt tous les fichiers dans le dossier
Connections, les ouvre et transmet leur contenu &agrave; la fonction findConnection(). Si le contenu
d’un fichier correspond aux crit&egrave;res d’une connexion valide, findConnection() renvoie un objet
de connexion. Dreamweaver r&eacute;pertorie ensuite tous les objets de connexion dans le panneau
Explorateur de base de donn&eacute;es.
Lorsque l’utilisateur ouvre une bo&icirc;te de dialogue de connexion et choisit de cr&eacute;er une nouvelle
connexion ou de dupliquer ou encore de modifier une connexion existante, Dreamweaver
d&eacute;clenche la fonction inspectConnection() et retransmet le m&ecirc;me objet de connexion cr&eacute;&eacute; par
findConnection(). Ce processus permet &agrave; Dreamweaver de renseigner la bo&icirc;te de dialogue en
utilisant les informations de connexion.
Lorsque l’utilisateur clique sur dans une bo&icirc;te de dialogue de connexion, Dreamweaver d&eacute;clenche
la fonction applyConnection() pour construire la page HTML, plac&eacute;e dans le fichier inclus de
connexion r&eacute;sidant dans le dossier Configuration/Connections. La fonction applyConnection()
renvoie une cha&icirc;ne vide qui indique une erreur dans l’un des champs. La bo&icirc;te de dialogue ne doit
pas &ecirc;tre ferm&eacute;e. Le fichier inclus a un type d’extension de fichier par d&eacute;faut pour le mod&egrave;le de
serveur en cours.
Lorsque l’utilisateur ajoute &agrave; une page un comportement de serveur qui utilise la connexion, tel
qu’un jeu d’enregistrements ou une proc&eacute;dure stock&eacute;e, Dreamweaver ajoute une instruction &agrave; la
page qui comprend le fichier inclus de connexion.
findConnection()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
API de connexion
105
Description
Dreamweaver appelle cette fonction pour d&eacute;tecter une connexion dans la source HTML sp&eacute;cifi&eacute;e
et analyser les param&egrave;tres de la connexion. Si le contenu de ce fichier source respecte les crit&egrave;res
permettant une connexion valide, findConnection() renvoie un objet de connexion ; dans le cas
contraire, cette fonction renvoie une valeur null.
Argument
htmlSource
htmlSource
est la source HTML d’une connexion.
Valeurs renvoy&eacute;es
Objet de connexion qui fournit les valeurs d’une combinaison particuli&egrave;re de propri&eacute;t&eacute;s
r&eacute;pertori&eacute;es dans le tableau suivant. Les propri&eacute;t&eacute;s pour lesquelles cette fonction renvoie une
valeur d&eacute;pendent du type de document.
106
Propri&eacute;t&eacute;
Description
name
Nom de la connexion
type
Si useHTTP est false, indique quelle DLL doit &ecirc;tre utilis&eacute;e pour la
connexion &agrave; des bases de donn&eacute;es au moment de l’ex&eacute;cution
string
Cha&icirc;ne de connexion d’ex&eacute;cution. Pour ADO, il s’agit d’une cha&icirc;ne de
param&egrave;tres de connexion ; pour JDBC, il s’agit d’une URL de
connexion
dsn
Nom de la source de donn&eacute;es utilis&eacute; pour les connexions de
d’ex&eacute;cution ODBC ou Cold Fusion
driver
Nom d’un pilote JDBC utilis&eacute; pendant l’ex&eacute;cution
username
Nom d’utilisateur employ&eacute; pour la connexion d’ex&eacute;cution
password
Mot de passe utilis&eacute; pour la connexion d’ex&eacute;cution
designtimeString
Cha&icirc;ne de connexion au moment de la conception (voir string)
designtimeDsn
Nom de la source de donn&eacute;es au moment de la conception (voir dsn)
designtimeDriver
Nom d’un pilote JDBC utilis&eacute; au moment de la conception
designtimeUsername
Nom de l’utilisateur employ&eacute; pour la connexion au moment de la
conception
designtimePassword
Mot de passe utilis&eacute; pour la connexion au moment de la conception
designtimeType
Type de connexion utilis&eacute;e au moment de la conception
usesDesigntimeInfo
En cas de valeur false, Dreamweaver utilise les propri&eacute;t&eacute;s d’ex&eacute;cution
au moment de la conception ; dans le cas contraire, Dreamweaver
utilise les propri&eacute;t&eacute;s au moment de la conception
useHTTP
Cha&icirc;ne contenant true ou false : true indique d’utiliser la connexion
HTTP au moment de la conception ; false indique d’utiliser DLL
includePattern
Expression r&eacute;guli&egrave;re utilis&eacute;e pour trouver l’instruction d’inclusion de
fichier sur la page pendant Live Data et Aper&ccedil;u dans le navigateur
Chapitre 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es
Propri&eacute;t&eacute;
Description
variables
Objet ayant une propri&eacute;t&eacute; pour chaque variable de page d&eacute;finie sur sa
valeur correspondante. Cet objet est utilis&eacute; pendant Live Data et
Aper&ccedil;u dans le navigateur
catalog
Cha&icirc;ne contenant un identificateur de base de donn&eacute;es qui restreint la
quantit&eacute; de m&eacute;tadonn&eacute;es qui apparaissent
schema
Cha&icirc;ne contenant un identificateur de base de donn&eacute;es qui restreint la
quantit&eacute; de m&eacute;tadonn&eacute;es qui apparaissent
filename
Nom de la bo&icirc;te de dialogue utilis&eacute;e pour cr&eacute;er la connexion
Si une connexion n’est pas trouv&eacute;e dans htmlSource, une valeur null est renvoy&eacute;e.
Remarque : Les d&eacute;veloppeurs peuvent ajouter des propri&eacute;t&eacute;s personnalis&eacute;es (par exemple,
m&eacute;tadonn&eacute;es) &agrave; la source HTML, qui renvoie applyConnection() avec les propri&eacute;t&eacute;s standard.
inspectConnection()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Dreamweaver appelle cette fonction pour initialiser les donn&eacute;es de la bo&icirc;te de dialogue pour
d&eacute;finir une connexion lorsque l’utilisateur modifie une connexion existante. Ce processus permet
&agrave; Dreamweaver de renseigner la bo&icirc;te de dialogue en utilisant les informations de connexion
appropri&eacute;es.
Argument
parameters
L’argument parameters correspond &agrave; l’objet renvoy&eacute; par la fonction findConnection().
Valeurs renvoy&eacute;es
Aucune.
applyConnection()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Dreamweaver d&eacute;clenche cette fonction lorsque l’utilisateur clique sur dans la bo&icirc;te de dialogue de
connexion. La fonction applyConnection() g&eacute;n&egrave;re la source HTML pour une connexion.
Dreamweaver &eacute;crit le HTML dans le fichier inclus Configuration/Connections/connectionname.ext, o&ugrave; connection-name est le nom de votre connexion (voir D&eacute;finissez la mise en forme de la
bo&icirc;te de dialogue de connexion., page 103) et .ext est l’extension par d&eacute;faut associ&eacute;e au mod&egrave;le de
serveur.
Arguments
Aucun.
API de connexion
107
Valeurs renvoy&eacute;es
Source HTML pour une connexion. Dreamweaver ferme &eacute;galement la bo&icirc;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&icirc;ne vide pour indiquer que la bo&icirc;te de dialogue doit rester
ouverte.
Fichier inclus g&eacute;n&eacute;r&eacute;
Le fichier inclus g&eacute;n&eacute;r&eacute; par applyConnection() d&eacute;clare toutes les propri&eacute;t&eacute;s d’une connexion. Le
nom du fichier inclus correspond au nom de connexion avec l’extension de fichier d&eacute;finie pour le
mod&egrave;le de serveur associ&eacute; au site en cours.
Remarque : Les connexions &eacute;tant partag&eacute;es, d&eacute;finissez la valeur allowMultiple sur false. Le fichier
de connexion est ainsi inclus dans le document une fois seulement et le script de serveur reste dans la
page si un autre comportement de serveur l’utilise.
Les sections suivantes illustrent certains exemples de fichiers inclus g&eacute;n&eacute;r&eacute;s par
applyConnection() pour divers mod&egrave;les de serveur par d&eacute;faut.
Remarque : Pour cr&eacute;er un nouveau format de fichier inclus de connexion, vous devez d&eacute;finir un
nouveau fichier de correspondance EDML, qui doit ressembler &agrave; connection_includefile.edml,
comme dans Fichier de d&eacute;finition pour votre type de connexion, page 109.
ASP JavaScript
Le fichier inclus ASP et JavaScript doit &ecirc;tre nomm&eacute; MyConnection1.asp, o&ugrave; MyConnection1 est
le nom de la connexion. L’exemple suivant est un fichier inclus pour une cha&icirc;ne de connexion
ADO :
&lt;%
// Filename=&quot;Connection_ado_conn_string.htm&quot;
// Type=&quot;ADO&quot;
// HTTP=&quot;true&quot;
// Catalog=&quot;&quot;
// Schema=&quot;&quot;
var MM_MyConnection1_STRING = &quot;dsn=pubs&quot;;
%&gt;
Le fichier du comportement de serveur inclut cette connexion en utilisant l’instruction
d’inclusion de fichier relative, comme le montre l’illustration suivante :
&lt;!--#include file=&quot;../Connections/MyConnection1.asp&quot;--&gt;
ColdFusion
Lorsque vous utilisez UltraDev 4 ColdFusion, Dreamweaver s’appuie sur un fichier inclus
ColdFusion pour extraire une liste des sources de donn&eacute;es.
Remarque : Avec Dreamweaver ColdFusion standard, Dreamweaver ignore tous les fichiers inclus
et utilise les RDS pour r&eacute;cup&eacute;rer la liste des sources de donn&eacute;es &agrave; partir de ColdFusion.
Le fichier inclus UltraDev 4 ColdFusion doit &ecirc;tre nomm&eacute; MyConnection1.cfm, o&ugrave;
MyConnection1 est le nom de votre connexion. L’exemple suivant illustre le fichier inclus pour
une connexion ColdFusion &agrave; un tableau de produits :
&lt;!-- FileName=&quot;Connection_cf_dsn.htm&quot; &quot;dsn=products&quot; --&gt;
&lt;!-- Type=&quot;ADO&quot; --&gt;
&lt;!-- Catalog=&quot;&quot; --&gt;
108
Chapitre 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es
&lt;!-- Schema=&quot;&quot; --&gt;
&lt;!-- HTTP=&quot;false&quot; --&gt;
&lt;CFSET MM_MyConnection1_DSN
&lt;CFSET MM_MyConnection1_USERNAME
&lt;CFSET MM_Product_USERNAME
&lt;CFSET MM_MyConnection1_PASSWORD
=
=
=
=
&quot;products&quot;&gt;
&quot;&quot;&gt;
&quot;&quot;&gt;
&quot;&quot;&gt;
Le fichier du comportement de serveur inclut cette connexion en utilisant l’instruction
cfinclude, comme le montre l’illustration suivante :
&lt;cfinclude template=&quot;Connections/MyConnection1.cfm&quot;&gt;
JSP
Le fichier inclus JSP doit &ecirc;tre nomm&eacute; MyConnection1.jsp, o&ugrave; MyConnection1 est le nom de
votre connexion. L’exemple suivant est le fichier inclus pour une connexion JDBC &agrave; une base de
donn&eacute;es :
&lt;%
// Filename=&quot;Connection_jdbc_conn1.htm&quot;
// Type=&quot;JDBC&quot;
// HTTP=&quot;false&quot;
// Catalog=&quot;&quot;
// Schema=&quot;&quot;
String MM_MyConnection1_DRIVER
= &quot;com.inet.tds.TdsDriver&quot;;
String MM_MyConnection1_USERNAME = &quot;testadmin&quot;;
String MM_MyConnection1_PASSWORD = &quot;velcro&quot;;
String MM_MyConnection1_URL
= &quot;jdbc:server:test-3:1433?database=pubs&quot;;
%&gt;
Le fichier du comportement de serveur inclut cette connexion en utilisant l’instruction
d’inclusion de fichier relative, comme le montre l’illustration suivante :
&lt;%@ include file=&quot;Connections/MyConnection1.jsp&quot; %&gt;
Fichier de d&eacute;finition pour votre type de connexion
Pour tous les mod&egrave;les de serveur, il existe un fichier connection_includefile.edml qui d&eacute;finit le
type de connexion et associe les propri&eacute;t&eacute;s d&eacute;finies dans le fichier inclus aux &eacute;l&eacute;ments de
l’interface Dreamweaver.
Par d&eacute;faut, Dreamweaver fournit sept fichiers de d&eacute;finition, un pour chacun des mod&egrave;les de
serveur pr&eacute;d&eacute;finis, comme l’illustre le tableau suivant.
mod&egrave;le de serveur
Sous-dossier du dossier Configuration/Connections
ASP JavaScript
ASP_Js
ASP.NET CSharp
ASP.NET_Csharp
ASP.NET VBScript
ASP.NET_VB
ASP VBScript
ASP_Vbs
ColdFusion
ColdFusion
Page JavaServer
JSP
PHP MySql
PHP_MySql
Fichier de d&eacute;finition pour votre type de connexion
109
Dreamweaver utilise les param&egrave;tres quickSearch et searchPattern pour reconna&icirc;tre les blocs de
connexion et le param&egrave;tre insertText afin de cr&eacute;er des blocs de connexion. Pour plus
d’informations sur les balises et les attributs EDML et sur les mod&egrave;les de recherche d’expression
r&eacute;guli&egrave;re, voir Comportements de serveur dans Extension de Dreamweaver.
Remarque : Si vous changez le format de votre fichier inclus ou si vous d&eacute;finissez un fichier inclus
pour un nouveau mod&egrave;le de serveur, vous devez associer les param&egrave;tres de connexion avec
l’interface utilisateur de Dreamweaver, Live Data et Aper&ccedil;u dans le navigateur. L’exemple suivant de
fichier EDML, associ&eacute; au mod&egrave;le de serveur ASP JS par d&eacute;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&egrave;les de recherche d’expression r&eacute;guli&egrave;re,
voir Comportements de serveur dans Extension de Dreamweaver.
&lt;participant name=&quot;connection_includefile&quot; version=&quot;5.0&quot;&gt;
&lt;quickSearch&gt;
&lt;![CDATA[// HTTP=]]&gt;&lt;/quickSearch&gt;
&lt;insertText location=&quot;&quot;&gt;
&lt;![CDATA[&lt;%
// FileName=&quot;@@filename@@&quot;
// Type=&quot;@@type@@&quot; @@designtimeString@@
// DesigntimeType=&quot;@@designtimeType@@&quot;
// HTTP=&quot;@@http@@&quot;
// Catalog=&quot;@@catalog@@&quot;
// Schema=&quot;@@schema@@&quot;
var MM_@@cname@@_STRING = @@string@@
%&gt;
]]&gt;
&lt;/insertText&gt;
&lt;searchPatterns whereToSearch=&quot;directive&quot;&gt;
&lt;searchPattern paramNames=&quot;filename&quot;&gt;
&lt;![CDATA[/\/\/\s*FileName=&quot;([^&quot;]*)&quot;/]]&gt;&lt;/searchPattern&gt;
&lt;searchPattern paramNames=&quot;type,designtimeString&quot;&gt;
&lt;![CDATA[/\/\/\s+Type=&quot;(\w*)&quot;([^\r\n]*)/]]&gt;&lt;/searchPattern&gt;
&lt;searchPattern paramNames=&quot;designtimeType&quot; isOptional=&quot;true&quot;&gt;
&lt;![CDATA[/\/\/\s*DesigntimeType=&quot;(\w*)&quot;/]]&gt;&lt;/searchPattern&gt;
&lt;searchPattern paramNames=&quot;http&quot;&gt;
&lt;![CDATA[/\/\/\s*HTTP=&quot;(\w+)&quot;/]]&gt;&lt;/searchPattern&gt;
&lt;searchPattern paramNames=&quot;catalog&quot;&gt;
&lt;![CDATA[/\/\/\s*Catalog=&quot;(\w*)&quot;/]]&gt;&lt;/searchPattern&gt;
&lt;searchPattern paramNames=&quot;schema&quot;&gt;
&lt;![CDATA[/\/\/\s*Schema=&quot;(\w*)&quot;/]]&gt;&lt;/searchPattern&gt;
&lt;searchPattern paramNames=&quot;cname,string&quot;&gt;
&lt;![CDATA[/var\s+MM_(\w*)_STRING\s*=\s*([^\r\n]+)/]]&gt;&lt;/searchPattern&gt;
&lt;/searchPatterns&gt;
&lt;/participant&gt;
Les expressions d’un fichier EDML, telles que @@filename@@ dans cet exemple, associent les
valeurs du fichier inclus avec les propri&eacute;t&eacute;s d’un objet de connexion. Les propri&eacute;t&eacute;s des objets de
connexion sont d&eacute;finies dans le fichier de mise en œuvre JavaScript.
Toutes les bo&icirc;tes de dialogue de connexion par d&eacute;faut de Dreamweaver utilisent le fichier de
correspondance connection_includefile.edml. Pour permettre &agrave; Dreamweaver de trouver ce
fichier, son nom est d&eacute;fini dans le fichier de mise en œuvre JavaScript, comme le montre
l’illustration suivante :
var PARTICIPANT_FILE = &quot;connection_includefile&quot;;
110
Chapitre 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es
Lors de la cr&eacute;ation d’un type de connexion personnalis&eacute;e, vous pouvez utiliser n’importe quel
fichier de correspondance dans vos bo&icirc;tes de dialogue personnalis&eacute;es. Si vous cr&eacute;ez un fichier de
correspondance, vous pouvez utiliser un nom diff&eacute;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&eacute;e &agrave; la variable PARTICIPANT_FILE,
comme le montre l’illustration suivante :
var PARTICIPANT_FILE = &quot;myConnection_mappingfile&quot;;
Fichier de d&eacute;finition pour votre type de connexion
111
112
Chapitre 8 : API de connectivit&eacute; &agrave; une base de donn&eacute;es
CHAPITRE 9
API JavaBeans
Ce chapitre pr&eacute;sente les API des composants JavaBeans. Les fonctions MMJB*() sont des accroches
JavaScript qui appellent des introspections Java pour la prise en charge des JavaBeans. Ces
fonctions extraient des noms de classe, des m&eacute;thodes, des propri&eacute;t&eacute;s et des &eacute;v&eacute;nements &agrave; partir des
JavaBeans, qui peuvent &ecirc;tre affich&eacute;s dans l’interface utilisateur Dreamweaver. Pour utiliser ces
fonctions JavaScript et permettre &agrave; Dreamweaver MX 2004 d’acc&eacute;der &agrave; des JavaBeans, ces
derniers doivent se trouver dans le dossier Configuration/Classes.
Remarque : Les arguments de fonction d&eacute;crits dans ce chapitre contiennent parfois un argument
appel&eacute; packageName.className, qui repr&eacute;sente une valeur unique.
API JavaBeans
Les fonctions suivantes sont des m&eacute;thodes de l’objet MMJB.
MMJB.getClasses()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Lit tous les noms de classe des JavaBeans dans le dossier Configuration/Classes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes des noms de classe r&eacute;sidant dans le dossier Configuration/Classes ; une erreur
renvoie un tableau vide.
MMJB.getClassesFromPackage()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Lit toutes les classes JavaBeans du paquet.
113
Arguments
packageName.pathName
•
correspond au chemin du paquet. Il doit s’agir d’une archive Java
JAR ou ZIP (par exemple, C:/jdbcdrivers/Una2000_Enterprise.zip).
packageName.pathName
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes des noms de classe &agrave; l’int&eacute;rieur du fichier JARou ZIP ; une erreur renvoie un
tableau vide.
MMJB.getErrorMessage()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait le dernier message d’erreur de Dreamweaver envoy&eacute; pendant l’utilisation de l’interface
MMJB.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne du message Dreamweaver de la derni&egrave;re erreur.
MMJB.getEvents()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Introspecte la classe des JavaBeans et en renvoie les &eacute;v&eacute;nements.
Arguments
packageName.className, {packagePath}
•
•
packageName.className est le nom de la classe. La classe doit &ecirc;tre situ&eacute;e dans une archive
Jave JAR ou ZIP. Si packagePath est omis, l’archive doit &ecirc;tre situ&eacute;e dans le classpath de
votre syst&egrave;me, ou doit &ecirc;tre un fichier de classe install&eacute; dans le dossier Configuration/Classes.
PackagePath est une cha&icirc;ne facultative qui pointe vers l’emplacement de l’archive Java JAR ou
ZIP qui contient className.
Valeurs renvoy&eacute;es
Un tableau de cha&icirc;nes des &eacute;v&egrave;nements associ&eacute;s &agrave; className ; une erreur renvoie un tableau vide.
114
Chapitre 9 : API JavaBeans
MMJB.getIndexedProperties()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Introspecte la classe des JavaBeans et en renvoie les propri&eacute;t&eacute;s index&eacute;es, qui correspondent &agrave; des
mod&egrave;les de conception dont le comportement est identique &agrave; celui des ensembles.
Arguments
packageName.className,
•
•
{packagePath}
packageName.className est le nom de la classe. La classe doit &ecirc;tre situ&eacute;e dans une archive
Jave JAR ou ZIP. Si packagePath est omis, l’archive doit &ecirc;tre situ&eacute; dans le classpath de votre
syst&egrave;me, ou doit &ecirc;tre un fichier de classe install&eacute; dans le dossier Configuration/Classes.
packagePath, argument facultatif, est une cha&icirc;ne qui pointe vers l’archive Java JAR ou ZIP
contenant className.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes relatives aux propri&eacute;t&eacute;s index&eacute;es de className ; une erreur renvoie un tableau
vide.
MMJB.getMethods()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
Description
Introspecte la classe des JavaBeans et en renvoie les m&eacute;thodes.
Arguments
packageName.className, {packagePath}
•
•
packageName.className est le nom de la classe. La classe doit &ecirc;tre situ&eacute;e dans une archive
Java JAR ou ZIP. Si packagePath est omis, l’archive doit &ecirc;tre situ&eacute;e dans le classpath de
votre syst&egrave;me, ou doit &ecirc;tre un fichier de classe install&eacute; dans le dossier Configuration/Classes.
PackagePath est une cha&icirc;ne facultative qui pointe vers l’emplacement de l’archive Java JAR ou
ZIP qui contient className.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes relatives aux m&eacute;thodes associ&eacute;es &agrave; className ; une erreur renvoie un tableau
vide.
MMJB.getProperties()
Disponibilit&eacute;
Dreamweaver UltraDev 4, am&eacute;lior&eacute;e dans la version Dreamweaver MX.
API JavaBeans
115
Description
Introspecte la classe des JavaBeans et en renvoie les propri&eacute;t&eacute;s.
Arguments
packageName.className, {packagePath}
•
•
packageName.className est le nom de la classe. La classe doit &ecirc;tre situ&eacute;e dans une archive
Java JAR ou ZIP. Si packagePath est omis, l’archive doit &ecirc;tre situ&eacute;e dans le classpath de
votre syst&egrave;me, ou doit &ecirc;tre un fichier de classe install&eacute; dans le dossier Configuration/Classes.
PackagePath est une cha&icirc;ne facultative qui pointe vers l’emplacement de l’archive Java JAR ou
ZIP qui contient className.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes relatives aux propri&eacute;t&eacute;s associ&eacute;es &agrave; className ; une erreur renvoie un tableau
vide.
MMJB.getReadProperties()
Disponibilit&eacute;
Dreamweaver MX.
Description
Extrait les propri&eacute;t&eacute;s en lecture seule des JavaBeans prenant en charge les appels d’acc&egrave;s d&eacute;finis.
Arguments
packageName.className, {packagePath}
•
•
packageName.className est le nom de la classe. La classe doit &ecirc;tre situ&eacute;e dans une archive
Java JAR ou ZIP. Si packagePath est omis, l’archive doit &ecirc;tre situ&eacute;e dans le classpath de
votre syst&egrave;me, ou doit &ecirc;tre un fichier de classe install&eacute; dans le dossier Configuration/Classes.
packagePath, argument facultatif, est une cha&icirc;ne qui pointe vers l’archive Java JAR ou ZIP
contenant className.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes de propri&eacute;t&eacute;s en lecture seule associ&eacute;es &agrave; className ; une erreur renvoie un
tableau vide.
MMJB.getWriteProperties()
Disponibilit&eacute;
Dreamweaver MX.
Description
Propri&eacute;t&eacute;s en lecture seule pour les JavaBeans prenant en charge les appels de m&eacute;thodes d&eacute;finies.
Arguments
packageName.className, {packagePath}
116
Chapitre 9 : API JavaBeans
•
•
packageName.className est le nom de la classe. La classe doit &ecirc;tre situ&eacute;e dans une archive
Java JAR ou ZIP. Si packagePath est omis, l’archive doit &ecirc;tre situ&eacute;e dans le classpath de
votre syst&egrave;me, ou doit &ecirc;tre un fichier de classe install&eacute; dans le dossier Configuration/Classes.
packagePath, argument facultatif, est une cha&icirc;ne qui pointe vers l’archive Java JAR ou ZIP
contenant className.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes relatives aux propri&eacute;t&eacute;s en lecture seule associ&eacute;es &agrave; className ; une erreur
renvoie un tableau vide.
API JavaBeans
117
118
Chapitre 9 : API JavaBeans
CHAPITRE 10
API d’int&eacute;gration de commande source
L’API d’int&eacute;gration de commande source vous permet de r&eacute;diger des biblioth&egrave;ques partag&eacute;es afin
d’accro&icirc;tre les fonctionnalit&eacute;s d’archivage et d’extraction de Macromedia Dreamweaver MX 2004
&agrave; l’aide de syst&egrave;mes de commande source (tels que Sourcesafe ou CVS).
Vos biblioth&egrave;ques doivent prendre en charge un minimum de fonctions API pour que
Dreamweaver puisse &ecirc;tre int&eacute;gr&eacute; au syst&egrave;me de commande source. En outre, vos biblioth&egrave;ques
doivent se trouver dans le dossier Files/Common Files/Macromedia/2004/Source Control.
Lorsque vous d&eacute;marrez Dreamweaver, celui-ci charge toutes les biblioth&egrave;ques. Il d&eacute;termine les
fonctionnalit&eacute;s prises en charge par chaque biblioth&egrave;que en appelant la fonction
GetProcAddress() pour chaque API. Si une adresse n’existe pas, Dreamweaver suppose que la
biblioth&egrave;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&egrave;que pour prendre en charge la fonctionnalit&eacute;. Lorsqu’un
utilisateur Dreamweaver d&eacute;finit ou modifie un site, puis choisit l’onglet SCS du serveur Web, les
choix correspondant aux DLL charg&eacute;es depuis le dossier Program Files/Common Files/
Macromedia/2004/Source Control s’affichent (en plus des &eacute;l&eacute;ments standard) dans l’onglet.
Pour cr&eacute;er un menu Site &gt; Commande source auquel vous pouvez ajouter des &eacute;l&eacute;ments
personnalis&eacute;s, ajoutez le code suivant au fichier :
&lt;menu name=&quot;Source Control&quot; id=&quot;DWMenu_MainSite_Site_Source&not;
Control&quot;&gt;&lt;menuitem dynamic name=&quot;None&quot;file=&quot;Menus/MM/&not;
File_SCSItems.htm&quot; id=&quot;DWMenu_MainSite_Site_NewFeatures_&not;
Default&quot; /&gt;
&lt;/menu&gt;
Fonctionnement de l’int&eacute;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&ecirc;te,
notamment de l’affichage des bo&icirc;tes de dialogue qui rassemblent les informations ou qui
permettent &agrave; l’utilisateur d’interagir avec la DLL. La DLL affiche &eacute;galement des informations ou
des messages d’erreur.
119
Le syst&egrave;me de commande source peut &eacute;ventuellement prendre en charge les Design Notes et
l’archivage et l’extraction. Pour activer les Design Notes dans les syst&egrave;mes de commande source,
l’utilisateur Dreamweaver doit choisir l’onglet Design Notes dans la bo&icirc;te de dialogue Modifier les
sites et cocher la case qui permet d’activer cette fonctionnalit&eacute; (cette proc&eacute;dure s’applique
&eacute;galement aux syst&egrave;mes FTP et de r&eacute;seau local). Si le syst&egrave;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&eacute;rer les Design Notes (de la m&ecirc;me fa&ccedil;on qu’avec les syst&egrave;mes
FTP et de r&eacute;seau local).
Les fonctions d’archivage et d’extraction sont trait&eacute;es diff&eacute;remment ; si le syst&egrave;me de commande
source les prend en charge, l’utilisateur ne peut pas &eacute;viter leur utilisation dans la bo&icirc;te de dialogue
Design Notes. Si l’utilisateur essaie de court-circuiter le syst&egrave;me de commande source, un message
d’erreur s’affiche.
Ajout d’une fonctionnalit&eacute; de syst&egrave;me de commande source
Pour ajouter une fonctionnalit&eacute; de syst&egrave;me de commande source &agrave; Dreamweaver, r&eacute;digez un
gestionnaire GetNewFeatures qui renvoie un jeu d’&eacute;l&eacute;ments de menu et les fonctions C
correspondantes. Si, par exemple, vous r&eacute;digez une biblioth&egrave;que Sourcesafe et que vous souhaitez
permettre aux utilisateurs de Dreamweaver de consulter l’historique d’un fichier, vous pouvez
r&eacute;diger un gestionnaire GetNewFeatures qui renvoie l’&eacute;l&eacute;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’&eacute;l&eacute;ment Historique s’affiche dans le menu. Si l’utilisateur choisit alors
l’&eacute;l&eacute;ment de menu Historique, Dreamweaver appelle la fonction correspondante, qui se charge de
transmettre les fichiers s&eacute;lectionn&eacute;s &agrave; la DLL. La DLL affiche ensuite la bo&icirc;te de dialogue
Historique, ce qui permet &agrave; l’utilisateur d’interagir avec elle de la m&ecirc;me fa&ccedil;on que Sourcesafe.
Fonctions obligatoires de l’API d’int&eacute;gration de commande
source
L’API d’int&eacute;gration de commande source comporte des fonctions obligatoires et facultatives. Les
fonctions r&eacute;pertori&eacute;es dans cette section sont obligatoires.
bool SCS_GetAgentInfo()
Description
Demande &agrave; la DLL de renvoyer son nom et sa description, qui sont affich&eacute;s dans la bo&icirc;te de
dialogue Modifier les sites. Le nom appara&icirc;t dans le menu d&eacute;roulant Acc&egrave;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
•
•
120
est le nom du syst&egrave;me de commande source. Ce nom s’affiche dans la zone de liste
modifiable permettant de s&eacute;lectionner un syst&egrave;me de commande source, dans l’onglet
Commande source de la bo&icirc;te de dialogue Modifier les sites. Le nom ne doit pas compter plus
de 32 caract&egrave;res.
version est une cha&icirc;ne qui indique la version de la DLL. La version appara&icirc;t dans l’onglet
Commande source de la bo&icirc;te de dialogue Modifier les sites. La version ne doit pas compter
plus de 32 caract&egrave;res.
name
Chapitre 10 : API d’int&eacute;gration de commande source
•
•
description est une cha&icirc;ne qui d&eacute;crit le syst&egrave;me de commande source. La description
appara&icirc;t dans l’onglet Commande source de la bo&icirc;te de dialogue Modifier les sites. La
description ne doit pas compter plus de 256 caract&egrave;res.
dwAppVersion est une cha&icirc;ne qui d&eacute;crit la version de Dreamweaver appelant la DLL. La DLL
peut utiliser cette cha&icirc;ne pour d&eacute;terminer la version et la langue de Dreamweaver.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_Connect()
Description
Connecte l’utilisateur &agrave; son syst&egrave;me de commande source. Si la DLL ne dispose pas d’information
de connexion, elle doit afficher une bo&icirc;te de dialogue invitant l’utilisateur &agrave; entrer des
informations, et elle doit stocker les donn&eacute;es pour une utilisation ult&eacute;rieure.
Arguments
void **connectionData, const char siteName[64]
•
•
connectionData est un descripteur des donn&eacute;es que l’agent souhaite recevoir de Dreamweaver
lorsqu’il appelle d’autres fonctions API.
siteName est une cha&icirc;ne qui pointe vers le nom du site. Le nom du site ne doit pas compter
plus de 64 caract&egrave;res.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_Disconnect()
Description
D&eacute;connecte l’utilisateur du syst&egrave;me de commande source.
Arguments
void *connectionData
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_IsConnected()
Description
D&eacute;termine l’&eacute;tat de la connexion.
Fonctions obligatoires de l’API d’int&eacute;gration de commande source
121
Arguments
void *connectionData
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
int SCS_GetRootFolderLength()
Description
Renvoie la longueur du nom du dossier racine.
Arguments
void *connectionData
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
Valeurs renvoy&eacute;es
Nombre entier qui indique la longueur du nom du dossier racine. Si la fonction renvoie &lt; 0,
Dreamweaver consid&egrave;re cette r&eacute;ponse comme une erreur et tente de r&eacute;cup&eacute;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
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est une m&eacute;moire tampon dans laquelle est enregistr&eacute; 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&eacute;e par la fonction GetRootFolderLength.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
int SCS_GetFolderListLength()
Description
Renvoie le nombre d’&eacute;l&eacute;ments dans le dossier transmis.
122
Chapitre 10 : API d’int&eacute;gration de commande source
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le chemin d’acc&egrave;s et le nom complets du dossier distant dont la DLL v&eacute;rifie le
nombre d’&eacute;l&eacute;ments.
Valeurs renvoy&eacute;es
Nombre entier qui indique le nombre d’&eacute;l&eacute;ments dans le dossier en cours. Si la fonction renvoie &lt; 0,
Dreamweaver consid&egrave;re cette r&eacute;ponse comme une erreur et tente de r&eacute;cup&eacute;rer le message d’erreur de
la DLL si elle est prise en charge.
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’&eacute;l&eacute;ment est un dossier ou un fichier.
Arguments
void *connectionData, const char *remotePath, itemInfo itemList[
numItems
•
•
•
•
], const int
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le nom du chemin d’acc&egrave;s au dossier distant dont la DLL v&eacute;rifie le nombre
d’&eacute;l&eacute;ments.
itemList est une liste pr&eacute;-allou&eacute;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 &agrave; 12
day
int
Composant jour de la date de modification, de 1 &agrave; 31
year
int
Composant ann&eacute;e de la date de modification, 1900+
hour
int
Composant heure de la date de modification, de 0 &agrave; 23
minutes
int
Composant minute de la date de modification, de 0 &agrave; 59
seconds
int
Composant seconde de la date de modification, de 0 &agrave; 59
type
char[256]
type de fichier (s’il n’est pas d&eacute;fini par la DLL, DW utilise
l’extension de fichier pour d&eacute;terminer le type, comme il le
fait &agrave; pr&eacute;sent)
size
int
En octets
numItems est le nombre d’&eacute;l&eacute;ments
GetFolderListLength).
allou&eacute;s &agrave; l’argument itemList (renvoy&eacute; par la fonction
Fonctions obligatoires de l’API d’int&eacute;gration de commande source
123
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et 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
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste des fichiers ou dossiers distants &agrave; extraire, exprim&eacute;e sous la forme
de noms et de chemins d’acc&egrave;s complets.
localPathList est une liste miroir des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
locaux.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_Put()
Description
Place une liste de fichiers ou de dossiers locaux dans le syst&egrave;me de commande source.
Arguments
void *connectionData, const char
const int numItems
•
•
•
•
*localPathList[], const char *remotePathList[],
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
L’argument localPathList est la liste des noms de fichiers locaux ou des chemins de fichiers
&agrave; placer dans le syst&egrave;me de commande source.
remotePathList est une liste miroir de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
distants.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
124
Chapitre 10 : API d’int&eacute;gration de commande source
bool SCS_NewFolder()
Description
Cr&eacute;e un nouveau dossier.
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le chemin d’acc&egrave;s complet du dossier distant que la DLL cr&eacute;e.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_Delete()
Description
Supprime une liste de fichiers ou de dossiers du syst&egrave;me de commande source.
Arguments
void *connectionData, const char *remotePathList[], const int numItems
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers distants
&agrave; supprimer.
numItems est le nombre d’&eacute;l&eacute;ments dans remotePathList.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_Rename()
Description
Renomme ou d&eacute;place un fichier ou un dossier selon les valeurs sp&eacute;cifi&eacute;es dans les arguments
oldRemotePath et newRemotePath. Ainsi, si les valeurs de oldRemotePath et newRemotePath
sont respectivement &quot;$/folder1/file1&quot; et &quot;$/folder1/renamefile1&quot;, 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 &quot;$/folder1/file1&quot;
et &quot;$/folder1/subfolder1/file1&quot;, le fichier file1 est alors d&eacute;plac&eacute; dans le sous-dossier
subfolder1.
Pour savoir si l’invocation de cette fonction constitue un d&eacute;placement ou l’attribution d’un
nouveau nom, v&eacute;rifiez les chemins parents des deux valeurs d’entr&eacute;e ; s’ils sont identiques, il s’agit
de l’op&eacute;ration &laquo; renommer &raquo;.
Fonctions obligatoires de l’API d’int&eacute;gration de commande source
125
Arguments
void *connectionData, const char *oldRemotePath, const char *newRemotePath
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
oldRemotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant &agrave; renommer ou &agrave;
d&eacute;placer.
newRemotePath est le nom du chemin d’acc&egrave;s au nouveau fichier ou dossier distant.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_ItemExists()
Description
D&eacute;termine si un fichier ou un dossier existe sur le serveur.
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le chemin d’acc&egrave;s d’un fichier ou d’un dossier distant.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
Fonctions facultatives de l’API d’int&eacute;gration de commande
source
L’API d’int&eacute;gration de commande source comporte des fonctions obligatoires et facultatives. Les
fonctions r&eacute;pertori&eacute;es dans cette section sont facultatives.
bool SCS_GetConnectionInfo()
Description
Affiche une bo&icirc;te de dialogue qui permet &agrave; l’utilisateur de modifier ou de d&eacute;finir les informations
de connexion du site. N’&eacute;tablit pas la connexion. Cette fonction est appel&eacute;e lorsque l’utilisateur
clique sur le bouton Param&egrave;tres dans la section Infos distantes de la bo&icirc;te de dialogue Modifier les
sites.
Arguments
void **connectionData, const char siteName[64]
•
•
126
connectionData est un descripteur des donn&eacute;es que l’agent veut recevoir de Dreamweaver
lorsqu’il appelle d’autres fonctions API.
siteName est une cha&icirc;ne qui pointe vers le nom du site. Ce nom ne peut pas comporter plus de
64 caract&egrave;res.
Chapitre 10 : API d’int&eacute;gration de commande source
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_SiteDeleted()
Description
Informe la DLL que le site a &eacute;t&eacute; supprim&eacute; ou qu’il n’est plus li&eacute; &agrave; ce syst&egrave;me de commande source.
Cette fonction indique au syst&egrave;me de commande source qu’il peut supprimer les informations
persistantes du site.
Arguments
const char siteName[64]
•
siteName est une cha&icirc;ne qui pointe vers le nom du site. Ce nom ne peut pas comporter plus de
64 caract&egrave;res.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_SiteRenamed()
Description
Notifie &agrave; la DLL que l’utilisateur a renomm&eacute; le site, pour qu’il puisse mettre &agrave; jour les
informations persistantes relatives &agrave; ce site.
Arguments
const char oldSiteName[64], const char newSiteName[64]
•
•
oldSiteName est une cha&icirc;ne qui pointe vers le nom initial du site, avant qu’il ne soit renomm&eacute;.
Ce nom ne peut pas comporter plus de 64 caract&egrave;res.
newSiteName est une cha&icirc;ne qui pointe vers le nouveau nom du site, apr&egrave;s qu’il a &eacute;t&eacute;
renomm&eacute;. Ce nom ne peut pas comporter plus de 64 caract&egrave;res.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
int SCS_GetNumNewFeatures()
Description
Renvoie le nombre de nouvelles fonctions &agrave; ajouter &agrave; Dreamweaver (comme Historique de fichier,
Diff&eacute;rences, etc.).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Nombre entier qui indique le nombre de nouvelles fonctionnalit&eacute;s &agrave; ajouter &agrave; Dreamweaver. Si la
fonction renvoie &lt; 0, Dreamweaver consid&egrave;re cette r&eacute;ponse comme une erreur et tente de
r&eacute;cup&eacute;rer le message d’erreur de la DLL si elle est prise en charge.
Fonctions facultatives de l’API d’int&eacute;gration de commande source
127
bool SCS_GetNewFeatures()
Description
Renvoie une liste d’&eacute;l&eacute;ments &agrave; ajouter aux menus principaux et contextuels de Dreamweaver. Par
exemple, la DLL Sourcesafe peut ajouter Historique et Diff&eacute;rences de fichiers au menu principal.
Arguments
char menuItemList[][32], scFunction functionList[], scFunction enablerList[],
const int numNewFeatures
•
•
•
•
est une liste de cha&icirc;nes compl&eacute;t&eacute;e par la DLL et indiquant les &eacute;l&eacute;ments &agrave;
ajouter aux menus principaux et contextuels. Chaque cha&icirc;ne peut contenir 32 caract&egrave;res
maximum.
functionList est renseign&eacute; par la DLL ; il indique les routines de la DLL &agrave; appeler lorsque
l’utilisateur choisit l’&eacute;l&eacute;ment de menu correspondant.
enablerList est renseign&eacute; par la DLL ; il indique les routines de la DLL &agrave; appeler lorsque
Dreamweaver a besoin de d&eacute;terminer si l’&eacute;l&eacute;ment de menu correspondant est activ&eacute;.
numNewFeatures est le nombre d’&eacute;l&eacute;ments ajout&eacute;s par la DLL ; cette valeur est r&eacute;cup&eacute;r&eacute;e en
appelant la fonction GetNumNewFeatures().
menuItemList
La signature de fonction suivante d&eacute;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&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_GetCheckoutName()
Description
Renvoie le nom d’extraction de l’utilisateur en cours. Si le syst&egrave;me de commande source ne prend
pas en charge cette fonction et que l’utilisateur a activ&eacute; l’extraction, la fonction utilise la
fonctionnalit&eacute; interne d’archivage et d’extraction de Dreamweaver qui transporte les fichiers LCK
depuis et vers le syst&egrave;me de commande source.
Arguments
void *connectionData, char checkOutName[64], char emailAddress[64]
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
checkOutName est le nom de l’utilisateur en cours.
emailAddress est l’adresse &eacute;lectronique de l’utilisateur en cours.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
128
Chapitre 10 : API d’int&eacute;gration de commande source
bool SCS_Checkin()
Description
Archive une liste de fichiers ou de dossiers locaux dans le syst&egrave;me de commande source. La DLL
doit configurer le fichier en lecture seule. Si le syst&egrave;me de commande source ne prend pas en
charge cette fonction et que l’utilisateur a activ&eacute; l’extraction, la fonction utilise la fonctionnalit&eacute;
interne d’archivage et d’extraction de Dreamweaver qui transporte les fichiers LCK depuis et vers
le syst&egrave;me de commande source.
Arguments
void *connectionData, const char *localPathList[], const char *remotePathList[],
bool successList[], const int numItems
•
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
localPathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers locaux &agrave;
archiver.
remotePathList est une liste miroir de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
distants.
successList est une liste de valeurs bool&eacute;ennes compl&eacute;t&eacute;e par la DLL pour permettre &agrave;
Dreamweaver de conna&icirc;tre les fichiers dont l’archivage a r&eacute;ussi.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_Checkout()
Description
Extrait une liste de fichiers ou de dossiers locaux du syst&egrave;me de commande source. La DLL se
charge d’accorder les droits d’acc&egrave;s en &eacute;criture au fichier. Si le syst&egrave;me de commande source ne
prend pas en charge cette fonction et que l’utilisateur a activ&eacute; l’extraction, la fonction utilise la
fonctionnalit&eacute; interne d’archivage et d’extraction de Dreamweaver qui transporte les fichiers LCK
depuis et vers le syst&egrave;me de commande source.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[],
bool successList[], const int numItems
•
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de noms de chemin d’acc&egrave;s aux fichiers et aux dossiers distant &agrave;
extraire.
localPathList est une liste miroir des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
locaux.
successList est une liste de valeurs bool&eacute;ennes compl&eacute;t&eacute;e par la DLL pour permettre &agrave;
Dreamweaver de conna&icirc;tre les fichiers dont l’extraction a r&eacute;ussi.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Fonctions facultatives de l’API d’int&eacute;gration de commande source
129
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_UndoCheckout()
Description
Annule l’&eacute;tat d’extraction d’une liste de fichiers ou de dossiers. La DLL doit configurer le fichier
en lecture seule. Si le syst&egrave;me de commande source ne prend pas en charge cette fonction et que
l’utilisateur a activ&eacute; l’extraction, la fonction utilise la fonctionnalit&eacute; interne d’archivage et
d’extraction de Dreamweaver qui transporte les fichiers LCK depuis et vers le syst&egrave;me de
commande source.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[],
bool successList[], const int numItems
•
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de chemins aux fichiers ou dossiers distants dont l’extraction
doit &ecirc;tre annul&eacute;e.
localPathList est une liste miroir des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
locaux.
successList est une liste de valeurs bool&eacute;ennes compl&eacute;t&eacute;e par la DLL pour permettre &agrave;
Dreamweaver de conna&icirc;tre les fichiers dont l’extraction a &eacute;t&eacute; annul&eacute;e avec succ&egrave;s.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
int SCS_GetNumCheckedOut()
Description
Renvoie le nombre d’utilisateurs dont un fichier &agrave; &eacute;t&eacute; extrait.
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant &agrave; v&eacute;rifier pour conna&icirc;tre
le nombre d’utilisateurs ayant proc&eacute;d&eacute; &agrave; son extraction.
Valeurs renvoy&eacute;es
Nombre entier qui repr&eacute;sente le nombre de personnes disposant du fichier extrait. Si la fonction
renvoie &lt; 0, Dreamweaver consid&egrave;re cette r&eacute;ponse comme une erreur et tente de r&eacute;cup&eacute;rer le
message d’erreur de la DLL si elle est prise en charge.
130
Chapitre 10 : API d’int&eacute;gration de commande source
bool SCS_GetFileCheckoutList()
Description
Renvoie une liste d’utilisateurs dont un fichier a &eacute;t&eacute; 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
•
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant &agrave; v&eacute;rifier pour conna&icirc;tre
le nombre d’utilisateurs ayant proc&eacute;d&eacute; &agrave; son extraction.
checkOutList est une liste de cha&icirc;nes qui correspond aux utilisateurs disposant du fichier
extrait. Chaque cha&icirc;ne ne doit pas avoir plus de 64 caract&egrave;res.
emailAddressList est une liste de cha&icirc;nes correspondant aux adresses &eacute;lectroniques des
utilisateurs. Chaque adresse ne doit pas d&eacute;passer 64 caract&egrave;res.
numCheckedOut est le nombre de personnes qui ont le fichier extrait. Il est renvoy&eacute; par
GetNumCheckedOut().
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
int SCS_GetErrorMessageLength()
Description
Renvoie la longueur du message d’erreur interne en cours de la DLL. Permet d’allouer la m&eacute;moire
tampon transmise dans la fonction GetErrorMessage(). Cette fonction doit &ecirc;tre appel&eacute;e
uniquement si une fonction d’API renvoie la valeur false ou &lt;0, ce qui indique un &eacute;chec.
Arguments
void *connectionData
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
Valeurs renvoy&eacute;es
Nombre entier repr&eacute;sentant la longueur du message d’erreur.
bool SCS_GetErrorMessage()
Description
Renvoie le dernier message d’erreur. Si vous impl&eacute;mentez getErrorMessage(), Dreamweaver
l’appelle &agrave; 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 &ecirc;tre disponible.
Fonctions facultatives de l’API d’int&eacute;gration de commande source
131
Arguments
void *connectionData, char errorMsg[], const int *msgLength
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
errorMsg est une cha&icirc;ne pr&eacute;-allou&eacute;e de la DLL dans laquelle vient se placer le message
d’erreur.
msgLength est la longueur de la m&eacute;moire tampon repr&eacute;sent&eacute;e par l’argument errorMsg[].
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
int SCS_GetNoteCount()
Description
Renvoie le nombre de cl&eacute;s Design Note pour le chemin de dossier ou de fichier distant sp&eacute;cifi&eacute;. Si
cela n’est pas pris en charge par le syst&egrave;me de commande source, Dreamweaver obtient ces
informations du fichier compagnon MNO.
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant dont la DLL v&eacute;rifie le
nombre de Design Notes jointes.
Valeurs renvoy&eacute;es
Nombre entier qui indique le nombre de Design Notes associ&eacute;es au fichier. Si la fonction renvoie
&lt; 0, Dreamweaver consid&egrave;re cette r&eacute;ponse comme une erreur et tente de r&eacute;cup&eacute;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&eacute;cifi&eacute;. Si cette
fonction n’est pas prise en charge par le syst&egrave;me de commande source, Dreamweaver obtient ces
informations du fichier MNO.
Arguments
void *connectionData, const char *remotePath
•
•
132
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant dont la DLL v&eacute;rifie la
Design Note la plus longue.
Chapitre 10 : API d’int&eacute;gration de commande source
Valeurs renvoy&eacute;es
Nombre entier qui indique la taille de la Design Note la plus longue associ&eacute;e au fichier. Si la
fonction renvoie &lt; 0, Dreamweaver consid&egrave;re cette r&eacute;ponse comme une erreur et tente de
r&eacute;cup&eacute;rer le message d’erreur de la DLL si elle est prise en charge.
bool SCS_GetDesignNotes()
Description
R&eacute;cup&egrave;re des paires cl&eacute;-valeur des m&eacute;ta-informations pour le fichier ou le dossier sp&eacute;cifi&eacute;. Si cette
fonction n’est pas prise en charge par le syst&egrave;me de commande source, Dreamweaver r&eacute;cup&egrave;re ces
informations dans le fichier MNO correspondant.
Arguments
void *connectionData, const char *remotePath, char keyList[][64],
char *valueList[], bool showColumnList[], const int noteCount,
const int noteLength
•
•
•
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant dont la DLL v&eacute;rifie le
nombre d’&eacute;l&eacute;ments.
keyList est une liste de cl&eacute;s de Design Note, comme &quot;Status&quot;.
valueList est une liste de valeurs de Design Note correspondant aux cl&eacute;s de Design Note,
comme &quot;Awaiting Signoff&quot;.
showColumnList est une liste de valeurs bool&eacute;ennes correspondant aux cl&eacute;s de Design Note,
qui indiquent si Dreamweaver peut afficher une cl&eacute; sous forme de colonne dans le panneau
Site.
noteCount correspond au nombre de Design Notes jointes &agrave; un fichier ou dossier ; cette valeur
est renvoy&eacute;e par la fonction GetNoteCount().
noteLength est la longueur maximale d’une Design Note ; cette valeur est renvoy&eacute;e par la
fonction GetMaxNoteLength().
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_SetDesignNotes()
Description
Enregistre les paires cl&eacute;-valeur dans les m&eacute;ta-informations du fichier ou du dossier sp&eacute;cifi&eacute;. Cela
remplace le jeu de m&eacute;ta-informations du fichier. Si cette fonction n’est pas prise en charge par le
syst&egrave;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
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
Fonctions facultatives de l’API d’int&eacute;gration de commande source
133
•
•
•
•
•
•
remotePath est le nom du chemin d’acc&egrave;s au fichier ou dossier distant dont la DLL v&eacute;rifie le
nombre d’&eacute;l&eacute;ments.
keyList est une liste de cl&eacute;s de Design Note, comme &quot;Status&quot;.
valueList est une liste de valeurs de Design Note correspondant aux cl&eacute;s de Design Note,
comme &quot;Awaiting Signoff&quot;.
showColumnList est une liste de valeurs bool&eacute;ennes correspondant aux cl&eacute;s de Design Note,
qui indiquent si Dreamweaver peut afficher une cl&eacute; sous forme de colonne dans le panneau
Site.
noteCount correspond au nombre de Design Notes jointes &agrave; un fichier ou dossier ; ce nombre
permet &agrave; la DLL de conna&icirc;tre la taille des listes sp&eacute;cifi&eacute;es. Si noteCount a pour valeur 0, toutes
les Design Notes sont supprim&eacute;es du fichier.
noteLength est la longueur de la Design Note la plus longue pour le fichier ou le dossier
sp&eacute;cifi&eacute;.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_IsRemoteNewer()
Description
V&eacute;rifie chaque chemin distant sp&eacute;cifi&eacute; pour voir si la copie distante est plus r&eacute;cente. Si cette
fonction n’est pas prise en charge par le syst&egrave;me de commande source, Dreamweaver utilise son
algorithme interne isRemoteNewer.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[],
int remoteIsNewerList[], const int numItems
•
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers &agrave;
comparer pour conna&icirc;tre ceux dot&eacute;s des &eacute;tats les plus r&eacute;cents.
localPathList est une liste miroir des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
locaux.
remoteIsNewerList est une liste de nombres entiers compl&eacute;t&eacute;e par la DLL pour permettre &agrave;
Dreamweaver d’identifier le fichier le plus r&eacute;cent du c&ocirc;t&eacute; distant. Les valeurs suivantes sont
renvoy&eacute;es : 1 indique la version distante est la plus r&eacute;cente ; -1 indique que la version locale est
la plus r&eacute;cente ; 0 indique que les deux versions sont identiques.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
134
Chapitre 10 : API d’int&eacute;gration de commande source
Activateurs
Si les activateurs facultatifs ne sont pas pris en charge par le syst&egrave;me de commande source ou que
l’application n’est pas connect&eacute;e au serveur, Dreamweaver d&eacute;termine le moment o&ugrave; les &eacute;l&eacute;ments
de menu sont activ&eacute;s, en fonction des informations dont il dispose concernant les fichiers distants.
bool SCS_canConnect()
Description
Indique si l’&eacute;l&eacute;ment de menu Connecter doit &ecirc;tre activ&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canGet()
Description
Indique si l’&eacute;l&eacute;ment de menu Acqu&eacute;rir doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *remotePathList[], const char
*localPathList[], const int numItems
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de noms de chemin d’acc&egrave;s aux fichiers et aux dossier distant &agrave;
obtenir.
localPathList est une liste miroir des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
locaux.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canCheckout()
Description
Indique si l’&eacute;l&eacute;ment de menu Extraire doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[],
const int numItems
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
Activateurs
135
•
remotePathList
est une liste de noms de chemin d’acc&egrave;s aux fichiers et aux dossiers distant &agrave;
extraire.
•
localPathList
est une liste miroir des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
locaux.
•
numItems
est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canPut()
Description
Indique si l’&eacute;l&eacute;ment de menu Placer doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char
const int numItems
•
•
•
•
*localPathList[], const char *remotePathList[],
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
localPathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers &agrave; placer
dans le syst&egrave;me de commande source.
remotePathList est une liste miroir de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers &agrave;
placer dans le syst&egrave;me de commande source.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canCheckin()
Description
Indique si l’&eacute;l&eacute;ment de menu Archiver doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *localPathList[], const char *remotePathList[],
const int numItems
•
•
•
•
136
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
localPathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers locaux &agrave;
archiver.
remotePathList est une liste miroir de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers
distants.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Chapitre 10 : API d’int&eacute;gration de commande source
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_CanUndoCheckout()
Description
Indique si l’&eacute;l&eacute;ment de menu Annuler l’extraction doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[],
const int numItems
•
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de noms de chemin d’acc&egrave;s aux fichiers et aux dossiers distant &agrave;
extraire.
localPathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers locaux &agrave;
placer dans le syst&egrave;me de commande source.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canNewFolder()
Description
Indique si l’&eacute;l&eacute;ment de menu Nouveau dossier doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePath est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers distants que
l’utilisateur a s&eacute;lectionn&eacute; pour indiquer l’emplacement de cr&eacute;ation du nouveau dossier.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canDelete()
Description
Indique si l’&eacute;l&eacute;ment de menu Supprimer doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *remotePathList[], const int numItems
Activateurs
137
•
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste de noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers distants
&agrave; supprimer.
numItems est le nombre d’&eacute;l&eacute;ments dans chaque liste.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_canRename()
Description
Indique si l’&eacute;l&eacute;ment de menu Renommer doit &ecirc;tre activ&eacute;.
Arguments
void *connectionData, const char *remotePath
•
•
connectionData est un pointeur vers les donn&eacute;es de l’agent transf&eacute;r&eacute;es &agrave; Dreamweaver
pendant l’appel de la fonction Connect().
remotePathList est une liste des noms de chemin d’acc&egrave;s aux fichiers ou aux dossiers distants
qui peuvent &ecirc;tre renomm&eacute;s.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
bool SCS_BeforeGet()
Description
Dreamweaver appelle cette fonction avant d’acqu&eacute;rir ou d’extraire un ou plusieurs fichiers. Cette
fonction permet &agrave; la DLL d’effectuer une op&eacute;ration sur un groupe de fichiers, telle que l’ajout
d’un commentaire d’extraction.
Arguments
*connectionData
•
est un argument qui pointe vers les donn&eacute;es de l’agent transmises &agrave;
Dreamweaver pendant l’appel Connect().
*connectionData
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
Exemple
Pour acqu&eacute;rir un groupe de fichiers, Dreamweaver effectue des appels vers la DLL dans l’ordre
suivant :
SCS_BeforeGet(connectionData);
SCS_Get(connectionData,remotePathList1,localPathList1,&not;
successList1);
SCS_Get(connectionData,remotePathList2,localPathList2,&not;
successList2);
SCS_Get(connectionData,remotePathList3,localPathList3,&not;
successList3);
SCS_AfterGet(connectionData);
138
Chapitre 10 : API d’int&eacute;gration de commande source
bool SCS_BeforePut()
Description
Dreamweaver appelle cette fonction avant de placer ou d’archiver un ou plusieurs fichiers. Cette
fonction permet &agrave; la DLL d’effectuer une op&eacute;ration sur un groupe de fichiers, telle que l’ajout
d’un commentaire d’archivage.
Arguments
*connectionData
•
est un argument qui pointe vers les donn&eacute;es de l’agent transmises &agrave;
Dreamweaver pendant l’appel Connect().
*connectionData
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
Exemple
Pour acqu&eacute;rir un groupe de fichiers, Dreamweaver effectue des appels vers la DLL dans l’ordre
suivant :
SCS_BeforePut(connectionData);
SCS_Put(connectionData,localPathList1,remotePathList1,&not;
successList1);
SCS_Put(connectionData,localPathList2,remotePathList2,&not;
successList2);
SCS_Put(connectionData,localPathList3,remotePathList3,&not;
successList3);
SCS_AfterPut(connectionData);
bool SCS_AfterGet()
Description
Dreamweaver appelle cette fonction apr&egrave;s avoir acquis ou extrait un ou plusieurs fichiers. Cette
fonction permet &agrave; la DLL d’effectuer n’importe quelle op&eacute;ration apr&egrave;s l’acquisition ou l’extraction
d’un lot, telle que la cr&eacute;ation d’une bo&icirc;te de dialogue de r&eacute;sum&eacute;.
Arguments
*connectionData
• *connectionData est un argument qui pointe vers les donn&eacute;es de l’agent transmises &agrave;
Dreamweaver pendant l’appel Connect().
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
Exemple
Voir bool SCS_BeforeGet(), page 138.
Activateurs
139
bool SCS_AfterPut()
Description
Dreamweaver appelle cette fonction apr&egrave;s avoir plac&eacute; ou archiv&eacute; un ou plusieurs fichiers. Cette
fonction permet &agrave; la DLL d’effectuer n’importe quelle op&eacute;ration apr&egrave;s le placement ou l’archivage
d’un lot, telle que la cr&eacute;ation d’une bo&icirc;te de dialogue de r&eacute;sum&eacute;.
Arguments
*connectionData
•
est un argument qui pointe vers les donn&eacute;es de l’agent transmises &agrave;
Dreamweaver pendant l’appel Connect().
*connectionData
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
Exemple
Voir bool SCS_BeforePut(), page 139.
140
Chapitre 10 : API d’int&eacute;gration de commande source
Utilisez l’une des principales fonctions Javascript disponibles (Macromedia
Dreamweaver MX 2004 en propose plus de 600), qui encapsulent les t&acirc;ches ex&eacute;cut&eacute;es par les
utilisateurs lors de la cr&eacute;ation ou de la modification d’un document dans Dreamweaver. Vous
pouvez utiliser ces fonctions pour r&eacute;aliser presque toutes les op&eacute;rations que l’utilisateur peut
effectuer &agrave; l’aide des menus, des panneaux flottants, des inspecteurs de propri&eacute;t&eacute;s, du panneau
Site ou de la fen&ecirc;tre de document.
Chapitre 11 : Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Chapitre 12 : Espace de travail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Chapitre 13 : Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Chapitre 14 : Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Chapitre 15 : Contenu de page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Chapitre 16 : Documents dynamiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Chapitre 17 : Conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Chapitre 18 : Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Chapitre 19 : Activateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
PARTIE II
PARTIE II
API JavaScript
CHAPITRE 11
Application
Les fonctions relatives aux applications effectuent des op&eacute;rations ayant trait &agrave; la fa&ccedil;on dont
Macromedia Dreamweaver MX 2004 interagit avec d’autres applications ou des t&acirc;ches
Dreamweaver ind&eacute;pendantes des documents (d&eacute;finition des pr&eacute;f&eacute;rences ou fermeture de
Dreamweaver, par exemple).
Fonctions relatives aux applications externes
Ces fonctions permettent d’effectuer des op&eacute;rations relatives &agrave; l’application
Macromedia Flash MX 2004, aux navigateurs et aux &eacute;diteurs externes, d&eacute;finis respectivement
dans les cat&eacute;gories Aper&ccedil;u dans le navigateur et Editeurs externes des Pr&eacute;f&eacute;rences. Elles permettent
d’obtenir des informations sur les applications externes et d’ouvrir des fichiers dans ces
applications.
dreamweaver.browseDocument()
Disponibilit&eacute;
Dreamweaver 2, am&eacute;lior&eacute;e dans les versions 3 et 4.
Description
Ouvre l’URL sp&eacute;cifi&eacute;e dans le navigateur sp&eacute;cifi&eacute;.
Arguments
fileName, {browser}
• L’argument fileName correspond au nom du fichier &agrave; ouvrir, exprim&eacute; sous la forme d’une
URL absolue.
Remarque : Certains navigateurs ne sont pas en mesure de trouver un fichier dont l’URL contient
une ancre (&laquo; Configuration/ExtensionHelp/browseHelp.htm#helpyou &raquo;, par exemple).
• L’argument browser, ajout&eacute; &agrave; Dreamweaver 3, d&eacute;finit un navigateur. Cet argument peut &ecirc;tre le
nom d’un navigateur tel qu’il est d&eacute;fini dans la cat&eacute;gorie Aper&ccedil;u dans le navigateur des
Pr&eacute;f&eacute;rences ou &ecirc;tre 'primary' ou 'secondary'. Si l’argument n’est pas d&eacute;fini, l’URL s’ouvre
dans le navigateur principal de l’utilisateur.
Valeurs renvoy&eacute;es
Aucune.
143
Exemple
La fonction suivante utilise la fonction dreamweaver.browseDocument() pour ouvrir la page
d’accueil Hotwired dans un navigateur :
function goToHotwired(){
dreamweaver.browseDocument('http://www.hotwired.com/');
}
Dans Dreamweaver 4, vous pouvez faire en sorte que cette op&eacute;ration ouvre le document dans
Microsoft Internet Explorer &agrave; l’aide du code suivant :
function goToHotwired(){
var prevBrowsers = dw.getBrowserList();
var theBrowser = &quot;&quot;;
for (var i=1; i &lt; prevBrowsers.length; i+2){
if (prevBrowsers[i].indexOf('Iexplore.exe') != -1){
theBrowser = prevBrowsers[i];
break;
}
}
dw.browseDocument('http://www.hotwired.com/',theBrowser);
}
Pour plus d’informations sur la fonction dreamweaver.getBrowserList(), voir
dreamweaver.getBrowserList(), page 144.
dreamweaver.getBrowserList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste des navigateurs d&eacute;finis dans le sous-menu Fichier &gt; Aper&ccedil;u dans le navigateur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau contenant autant de paires de cha&icirc;nes que de navigateurs d&eacute;finis. La premi&egrave;re cha&icirc;ne de la
paire repr&eacute;sente le nom du navigateur, et la seconde son emplacement sur l’ordinateur de
l’utilisateur, exprim&eacute; sous la forme d’une URL de type file://. Si aucun navigateur n’est d&eacute;fini, la
fonction ne renvoie rien.
dreamweaver.getExtensionEditorList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste des &eacute;diteurs d&eacute;finis dans la cat&eacute;gorie Editeurs externes des pr&eacute;f&eacute;rences pour le
fichier sp&eacute;cifi&eacute;.
144
Chapitre 11 : Application
Arguments
fileURL
• L’argument fileURL peut &ecirc;tre une URL compl&egrave;te de type file://, un nom de fichier ou une
extension de fichier (point compris).
Valeurs renvoy&eacute;es
Tableau contenant autant de paires de cha&icirc;nes que d’&eacute;diteurs d&eacute;finis. La premi&egrave;re cha&icirc;ne de la
paire repr&eacute;sente le nom de l’&eacute;diteur, et la seconde son emplacement sur l’ordinateur de
l’utilisateur, exprim&eacute; sous la forme d’une URL de type file://. Si aucun &eacute;diteur n’est d&eacute;fini dans les
pr&eacute;f&eacute;rences, la fonction renvoie un tableau contenant une cha&icirc;ne vide.
Exemple
Un appel &agrave; la fonction dreamweaver.getExtensionEditorList(&quot;.gif&quot;) pourrait renvoyer un
tableau contenant les cha&icirc;nes suivantes :
•
•
&quot;Fireworks 3&quot;
&quot;file:///C|/Program Files/Macromedia/Fireworks 3/Fireworks 3.exe&quot;
dreamweaver.getExternalTextEditor()
Disponibilit&eacute;
Dreamweaver 4.
Description
Affiche le nom de l’&eacute;diteur de texte externe actuellement configur&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le nom de l’&eacute;diteur de texte appropri&eacute; pour l’interface utilisateur et non le
chemin entier.
dreamweaver.getFlashPath()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient le chemin d’acc&egrave;s complet de l’application Flash MX sous la forme d’une URL de fichier.
Arguments
Aucun.
Fonctions relatives aux applications externes
145
Valeurs renvoy&eacute;es
Tableau contenant deux &eacute;l&eacute;ments. El&eacute;ment [0] est une cha&icirc;ne contenant le nom de l’&eacute;diteur
Flash MX. El&eacute;ment [1] est une cha&icirc;ne contenant le chemin de l’application Flash sur l’ordinateur
local, exprim&eacute; sous la forme d’une URL de type file://. Si Flash n’est pas install&eacute;, la fonction ne
renvoie rien.
Exemple
L’exemple suivant appelle la fonction dw.getFlashPath() pour obtenir le chemin d’acc&egrave;s &agrave;
l’application Flash et transmettre ce dernier sous la forme d’une URL de type file:// &agrave; 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]);
}
dreamweaver.getPrimaryBrowser()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le chemin du navigateur principal.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le chemin d’acc&egrave;s au navigateur principal sur l’ordinateur de l’utilisateur,
exprim&eacute; sous la forme d’une URL de type file://, ou rien, si aucun navigateur principal n’est
d&eacute;fini.
dreamweaver.getPrimaryExtensionEditor()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’&eacute;diteur principal associ&eacute; au fichier sp&eacute;cifi&eacute;.
Arguments
fileURL
• L’argument fileURL correspond au chemin d’acc&egrave;s au fichier &agrave; ouvrir, exprim&eacute; sous la forme
d’une URL de type file://.
146
Chapitre 11 : Application
Valeurs renvoy&eacute;es
Tableau contenant une paire de cha&icirc;nes. La premi&egrave;re cha&icirc;ne de la paire repr&eacute;sente le nom de
l’&eacute;diteur, et la seconde son emplacement sur l’ordinateur de l’utilisateur, exprim&eacute; sous la forme
d’une URL de type file://. Si aucun &eacute;diteur principal n’est d&eacute;fini, la fonction renvoie un tableau
contenant une cha&icirc;ne vide.
dreamweaver.getSecondaryBrowser()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le chemin du navigateur secondaire.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le chemin d’acc&egrave;s au navigateur secondaire sur l’ordinateur de l’utilisateur,
exprim&eacute; sous la forme d’une URL de type file://, ou rien, si aucun navigateur secondaire n’est
d&eacute;fini.
dreamweaver.openHelpURL()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ouvre le fichier d’aide sp&eacute;cifi&eacute; dans le visualisateur d’aide du syst&egrave;me d’exploitation.
Dreamweaver affiche le contenu de l’aide dans le visualisateur d’aide standard du syst&egrave;me
d’exploitation plut&ocirc;t que dans un navigateur. L’aide est au format HTML, mais elle peut &ecirc;tre lue
par HTML Help sous Windows ou Help Viewer sur Macintosh OS X.
L’aide compl&egrave;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&egrave;me d’exploitation.
• Manuel d’aide
Un 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 un
dossier.
Les fichiers du manuel d’aide se trouvent dans le dossier d’aide de Dreamweaver.
Fonctions relatives aux applications externes
147
• Fichier help.xml
Le fichier help.xml &eacute;tablit des correspondances entre les ID et le nom des manuels d’aide. Par
exemple, le code XML ci-dessous &eacute;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 :
&lt;?xml version = &quot;1.0&quot; ?&gt;
&lt;help-books&gt;
&lt;book-id id=&quot;DW_Using&quot; win-mapping=&quot;UsingDreamweaver.chm&quot; macmapping=&quot;Dreamweaver Help&quot;/&gt;
&lt;/help-books&gt;
•
•
Chaque entr&eacute;e book-id comporte les attributs suivants :
■ L’attribut id correspond &agrave; l’ID de manuel utilis&eacute; dans les fichiers help.map et HelpDoc.js.
■ L’attribut win-mapping correspond au nom du manuel Windows, soit
&quot;UsingDreamweaver.chm&quot; dans cet exemple.
■ L’attribut mac-mapping correspond au nom du manuel Macintosh, soit &quot;Dreamweaver
Help&quot; dans cet exemple.
Fichier help.map
Le fichier help.map &eacute;tablit une correspondance entre une ID de contenu de l’aide et un manuel
d’aide sp&eacute;cifique. Dreamweaver utilise le fichier help.map pour rechercher un contenu d’aide
sp&eacute;cifique lorsqu’il appelle l’aide directement.
Fichier helpDoc.js
Le fichier helpDoc.js vous permet d’&eacute;tablir une correspondance entre des noms de variables
que vous pouvez utiliser &agrave; la place de l’ID du manuel et du num&eacute;ro de page. Le fichier
helpDoc.js &eacute;tablit une correspondance entre une ID de contenu et une page HTML dans un
manuel d’aide sp&eacute;cifique. Dreamweaver utilise le fichier helpDoc.js lorsqu’il appelle l’aide &agrave;
partir de JavaScript.
Arguments
bookID
• L’argument obligatoire bookID se pr&eacute;sente au format suivant :
ID:page
L’attribut ID correspond &agrave; l’ID de manuel bookID de l’entr&eacute;e figurant dans le fichier help.xml
qui indique le fichier renfermant l’aide &agrave; afficher. L’attribut page de l’entr&eacute;e identifie la page &agrave;
afficher. Les pages sont r&eacute;f&eacute;renc&eacute;es dans le fichier help.map.
Valeurs renvoy&eacute;es
en cas de r&eacute;ussite et false si Dreamweaver ne peut pas ouvrir le fichier sp&eacute;cifi&eacute; dans le
visualisateur d’aide.
true
Exemple
openHelpURL(&quot;DW_Using:index.htm&quot;);
148
Chapitre 11 : Application
dreamweaver.openWithApp()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre le fichier sp&eacute;cifi&eacute; dans l’application sp&eacute;cifi&eacute;e.
Arguments
fileURL, appURL
• L’argument fileURL correspond au chemin d’acc&egrave;s au fichier &agrave; ouvrir, exprim&eacute; sous la forme
d’une URL de type file://.
• L’argument appURL correspond au chemin d’acc&egrave;s &agrave; l’application dans laquelle ouvrir le fichier,
exprim&eacute; sous forme d’une URL de type file://.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.openWithBrowseDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue S&eacute;lectionner un &eacute;diteur externe pour permettre &agrave; l’utilisateur de
s&eacute;lectionner l’application dans laquelle ouvrir le fichier sp&eacute;cifi&eacute;.
Arguments
fileURL
• L’argument fileURL correspond au chemin d’acc&egrave;s au fichier &agrave; ouvrir, exprim&eacute; sous la forme
d’une URL de type file://.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.openWithExternalTextEditor()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre le document actif dans l’&eacute;diteur de texte externe d&eacute;fini dans la section Editeurs externes de
la bo&icirc;te de dialogue Pr&eacute;f&eacute;rences.
Arguments
Aucun.
Fonctions relatives aux applications externes
149
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.openWithImageEditor()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre le fichier nomm&eacute; dans l’&eacute;diteur d’image sp&eacute;cifi&eacute;.
Remarque : Cette fonction fait appel &agrave; un m&eacute;canisme sp&eacute;cial d’int&eacute;gration Macromedia
Fireworks MX 2004 qui renvoie les informations au document actif lorsque Fireworks est sp&eacute;cifi&eacute;
comme &eacute;diteur d’image. Pour &eacute;viter les erreurs lorsque aucun document n’est actif, n’appelez jamais
cette fonction &agrave; partir du panneau Site.
Arguments
fileURL, appURL
• L’argument fileURL correspond au chemin d’acc&egrave;s au fichier &agrave; ouvrir, exprim&eacute; sous la forme
d’une URL de type file://.
• L’argument appURL correspond au chemin d’acc&egrave;s &agrave; l’application dans laquelle ouvrir le fichier,
exprim&eacute; sous forme d’une URL de type file://.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.validateFlash()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si Flash MX (ou une version ult&eacute;rieure) est install&eacute; sur l’ordinateur local.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si Flash MX (ou une version ult&eacute;rieure) est install&eacute; sur l’ordinateur
local ; false dans le cas contraire.
150
Chapitre 11 : Application
Fonctions globales relatives aux applications
Ces fonctions agissent sur l’ensemble d’une application. Elles permettent d’effectuer des t&acirc;ches
comme quitter une application ou acc&eacute;der aux pr&eacute;f&eacute;rences.
dreamweaver.beep()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cr&eacute;e un bip syst&egrave;me.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant appelle la fonction dw.beep() pour attirer l’attention de l’utilisateur sur un
message affich&eacute; par la fonction alert() :
beep(){
if(confirm(“Is your order complete?”)
{
dreamweaver.beep();
alert(“Click OK to submit your order”);
}
}
dreamweaver.getShowDialogsOnInsert()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si l’option Afficher la bo&icirc;te de dialogue lors de l’insertion d’objets est activ&eacute;e dans la
cat&eacute;gorie G&eacute;n&eacute;ral des pr&eacute;f&eacute;rences.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si cette option est activ&eacute;e.
Fonctions globales relatives aux applications
151
dreamweaver.quitApplication()
Disponibilit&eacute;
Dreamweaver 3.
Description
Quitte Dreamweaver lorsque l’ex&eacute;cution du script appelant cette fonction prend fin.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.showAboutBox()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue A propos de.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.showDynamicDataDialog()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche la bo&icirc;te de dialogue Donn&eacute;es dynamiques ou Texte dynamique, puis attend que
l’utilisateur ferme la bo&icirc;te de dialogue. Si l’utilisateur clique sur OK, la fonction
showDynamicDataDialog() renvoie une cha&icirc;ne &agrave; ins&eacute;rer dans le document de l’utilisateur. Cette
cha&icirc;ne est renvoy&eacute;e par la fonction API de la source des donn&eacute;es, c’est-&agrave;-dire
generateDynamicDataRef(), et transmise &agrave; la fonction API du format de donn&eacute;es,
formatDynamicDataRef() ; la valeur renvoy&eacute;e par formatDynamicDataRef() est la m&ecirc;me que
celle renvoy&eacute;e par la fonction showDynamicDataDialog().
Arguments
source, {title}
152
Chapitre 11 : Application
• L’argument source est une cha&icirc;ne contenant le code source qui repr&eacute;sente l’objet de donn&eacute;es
•
dynamique. Il s’agit de la m&ecirc;me cha&icirc;ne que celle renvoy&eacute;e apr&egrave;s un appel pr&eacute;c&eacute;dent de la m&ecirc;me
fonction. Cette fonction utilise le contenu de l’argument source pour initialiser toutes les
commandes de la bo&icirc;te de dialogue afin qu’elles apparaissent exactement telles qu’elles &eacute;taient
au moment o&ugrave; l’utilisateur a cliqu&eacute; sur OK pour cr&eacute;er cette cha&icirc;ne.
Dreamweaver transmet cette cha&icirc;ne &agrave; la fonction inspectDynamicDataRef() pour
d&eacute;terminer si la cha&icirc;ne correspond &agrave; l’un des nœuds de l’arborescence. Si la cha&icirc;ne correspond
&agrave; un nœud, celui-ci est s&eacute;lectionn&eacute; lorsque la bo&icirc;te de dialogue r&eacute;appara&icirc;t. Vous pouvez
&eacute;galement transmettre une cha&icirc;ne vide qui n’initialise pas la bo&icirc;te de dialogue. Par exemple,
aucune bo&icirc;te de dialogue n’est initialis&eacute;e lorsqu’elle est utilis&eacute;e pour cr&eacute;er un nouvel &eacute;l&eacute;ment.
L’argument title, qui est facultatif, est une cha&icirc;ne qui contient le texte &agrave; afficher dans la barre
de titre de la bo&icirc;te de dialogue. S’il n’est pas d&eacute;fini, Dreamweaver affiche Donn&eacute;es dynamiques
dans la barre de titre.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui repr&eacute;sente l’objet de donn&eacute;es dynamique, si l’utilisateur clique sur OK.
dreamweaver.showPreferencesDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Pr&eacute;f&eacute;rences.
Arguments
{strCategory}
• L’argument facultatif strCategory doit correspondre &agrave; l’une des cha&icirc;nes suivantes pour ouvrir
la cat&eacute;gorie correspondante dans la bo&icirc;te de dialogue Pr&eacute;f&eacute;rences : &quot;general&quot;,
&quot;accessibility&quot;, &quot;html colors&quot; (pour la cat&eacute;gorie Coloration du code), &quot;html format&quot;
(pour la cat&eacute;gorie Format du code), &quot;code hints&quot;, &quot;html rewriting&quot; (pour la cat&eacute;gorie
Correction du code), &quot;css styles&quot;, &quot;external editors&quot; (pour la cat&eacute;gorie Types de
fichiers/Editeurs), &quot;fonts&quot;, &quot;highlighting&quot;, &quot;invisible elements&quot;, &quot;layers&quot;,
&quot;layout mode&quot;, &quot;new document&quot;, &quot;office&quot;, &quot;floaters&quot; (pour la cat&eacute;gorie Panneaux),
&quot;browsers&quot; (pour la cat&eacute;gorie Aper&ccedil;u dans le navigateur), &quot;site ftp&quot;, &quot;status bar&quot; et
&quot;validator&quot;. Si Dreamweaver ne reconna&icirc;t pas dans l’argument un nom de volet valide ou
qu’aucun argument n’est d&eacute;fini, la bo&icirc;te de dialogue ouvre le dernier volet actif.
Valeurs renvoy&eacute;es
Aucune.
Fonctions globales relatives aux applications
153
dreamweaver.showTagChooser()
Disponibilit&eacute;
Dreamweaver MX.
Description
Active ou d&eacute;sactive l’affichage de la bo&icirc;te de dialogue S&eacute;lecteur de balise afin que les utilisateurs
ins&egrave;rent des balises en mode Code. La fonction affiche la bo&icirc;te de dialogue S&eacute;lecteur de balise audessus de toutes les autres fen&ecirc;tres Dreamweaver. Si la bo&icirc;te de dialogue n’est pas visible, la
fonction l’ouvre, l’affiche au premier plan et en fait l’&eacute;l&eacute;ment actif. Si le s&eacute;lecteur de balise est
visible, la fonction masque la bo&icirc;te de dialogue.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
154
Chapitre 11 : Application
CHAPITRE 12
Espace de travail
Les fonctions API de l’espace de travail cr&eacute;ent des &eacute;l&eacute;ments dans l’espace de travail Macromedia
Dreamweaver MX 2004 ou effectuent des actions dessus. Elles permettent d’effectuer diverses
t&acirc;ches dont voici un aper&ccedil;u : refaire les &eacute;tapes qui s’affichent dans le panneau Historique, placer
un objet dans la barre Ins&eacute;rer, se d&eacute;placer &agrave; l’aide des fonctions relatives au clavier, recharger des
menus, manipuler des fen&ecirc;tres de r&eacute;sultats ind&eacute;pendantes ou int&eacute;gr&eacute;es, d&eacute;finir des options,
positionner une barre d’outils et obtenir la s&eacute;lection ou d&eacute;finir l’&eacute;l&eacute;ment actif.
Fonctions relatives &agrave; l’historique
Ces fonctions permettent d’annuler, de refaire, d’enregistrer et de lire toutes les &eacute;tapes qui
s’affichent dans le panneau Historique. Par &eacute;tape, on entend une modification apport&eacute;e &agrave; un
document (ou &agrave; une s&eacute;lection dans le document) pouvant &ecirc;tre reproduite. Les m&eacute;thodes de l’objet
dreamweaver.historyPalette permettent de contr&ocirc;ler ou d’agir sur la s&eacute;lection dans le
panneau Historique et non dans le document actif.
dom.redo()
Disponibilit&eacute;
Dreamweaver 3.
Description
R&eacute;p&egrave;te l’&eacute;tape qui vient juste d’&ecirc;tre annul&eacute;e dans le document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canRedo(), page 436.
155
dom.undo()
Disponibilit&eacute;
Dreamweaver 3.
Description
Annule l’&eacute;tape qui vient d’&ecirc;tre ex&eacute;cut&eacute;e dans le document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canUndo(), page 438.
dreamweaver.getRedoText()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le texte associ&eacute; &agrave; l’op&eacute;ration de modification &agrave; r&eacute;p&eacute;ter si l’utilisateur choisit Edition &gt;
R&eacute;p&eacute;ter ou s’il appuie sur Ctrl+Y (Windows) ou sur Commande+Y (Macintosh).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant le texte associ&eacute; &agrave; l’op&eacute;ration de modification &agrave; r&eacute;p&eacute;ter.
Exemple
Si la derni&egrave;re action de l’utilisateur a consist&eacute; &agrave; mettre le texte s&eacute;lectionn&eacute; en gras, un appel &agrave; la
fonction dreamweaver.getRedoText() renvoie &quot;Repeat Apply Bold&quot;.
dreamweaver.getUndoText()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le texte associ&eacute; &agrave; l’op&eacute;ration de modification &agrave; annuler si l’utilisateur choisit Edition &gt;
Annuler ou s’il appuie sur Ctrl+Z (Windows) ou sur Commande+Z (Macintosh).
Arguments
Aucun.
156
Chapitre 12 : Espace de travail
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant le texte associ&eacute; &agrave; l’op&eacute;ration de modification &agrave; annuler.
Exemple
Si la derni&egrave;re action de l’utilisateur a consist&eacute; &agrave; appliquer un style CSS (cascading style sheet) &agrave; un
texte s&eacute;lectionn&eacute;, un appel &agrave; la fonction dreamweaver.getUndoText() renvoie &quot;Undo Apply
&lt;span&gt;&quot;.
dreamweaver.playRecordedCommand()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ex&eacute;cute la commande m&eacute;moris&eacute;e dans le document actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canPlayRecordedCommand(), page 442.
dreamweaver.redo()
Disponibilit&eacute;
Dreamweaver 3.
Description
R&eacute;p&egrave;te l’&eacute;tape qui vient juste d’&ecirc;tre annul&eacute;e dans la fen&ecirc;tre de document, la bo&icirc;te de dialogue, le
panneau flottant ou le panneau Site en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canRedo(), page 443.
dreamweaver.startRecording()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions relatives &agrave; l’historique
157
Description
D&eacute;marre la m&eacute;morisation des &eacute;tapes dans le document actif ; la commande pr&eacute;c&eacute;demment
m&eacute;moris&eacute;e est imm&eacute;diatement &eacute;limin&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.isRecording(), page 448 (doit renvoyer la valeur false).
dreamweaver.stopRecording()
Disponibilit&eacute;
Dreamweaver 3.
Description
Arr&ecirc;te la m&eacute;morisation sans intervention de l’utilisateur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.isRecording(), page 448 (doit renvoyer la valeur true).
dreamweaver.undo()
Disponibilit&eacute;
Dreamweaver 3.
Description
Annule l’&eacute;tape pr&eacute;c&eacute;dente dans la fen&ecirc;tre de document, la bo&icirc;te de dialogue, le panneau flottant
ou le panneau Site actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canUndo(), page 438.
158
Chapitre 12 : Espace de travail
dreamweaver.historyPalette.clearSteps()
Disponibilit&eacute;
Dreamweaver 3.
Description
Efface toutes les &eacute;tapes du panneau Historique et d&eacute;sactive les &eacute;l&eacute;ments de menu Annuler et
R&eacute;p&eacute;ter.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.historyPalette.copySteps()
Disponibilit&eacute;
Dreamweaver 3.
Description
Copie les &eacute;tapes sp&eacute;cifi&eacute;es de l’historique dans le Presse-papiers. Dreamweaver pr&eacute;vient
l’utilisateur de la possibilit&eacute; de cons&eacute;quences inattendues au cas o&ugrave; les &eacute;tapes sp&eacute;cifi&eacute;es
contiendraient une action impossible &agrave; reproduire.
Arguments
arrayOfIndices
• L’argument arrayOfIndices est un tableau d’index de position dans le panneau Historique.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le code JavaScript correspondant aux &eacute;tapes sp&eacute;cifi&eacute;es de l’historique.
Exemple
Le code suivant copie les quatre premi&egrave;res &eacute;tapes dans le panneau Historique :
dreamweaver.historyPalette.copySteps([0,1,2,3]);
dreamweaver.historyPalette.getSelectedSteps()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine quelle section du panneau Historique est s&eacute;lectionn&eacute;e.
Arguments
Aucun.
Fonctions relatives &agrave; l’historique
159
Valeurs renvoy&eacute;es
Tableau qui contient les index de position de toutes les &eacute;tapes s&eacute;lectionn&eacute;es. La premi&egrave;re position
est la position 0 (z&eacute;ro).
Exemple
Si la deuxi&egrave;me, la troisi&egrave;me et la quatri&egrave;me &eacute;tapes sont s&eacute;lectionn&eacute;es dans le panneau Historique,
comme le montre la figure ci-apr&egrave;s, un appel &agrave; la fonction
dreamweaver.historyPalette.getSelectedSteps() renvoie [1,2,3] :
dreamweaver.historyPalette.getStepCount()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le nombre d’&eacute;tapes figurant dans le panneau Historique.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Nombre entier qui repr&eacute;sente le nombre d’&eacute;tapes r&eacute;pertori&eacute;es actuellement dans le panneau
Historique.
dreamweaver.historyPalette.getStepsAsJavaScript()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’&eacute;quivalent JavaScript des &eacute;tapes s&eacute;lectionn&eacute;es.
Arguments
arrayOfIndices
• L’argument arrayOfIndices est un tableau d’index de position dans le panneau Historique.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le code JavaScript correspondant aux &eacute;tapes sp&eacute;cifi&eacute;es de l’historique.
160
Chapitre 12 : Espace de travail
Exemple
Si les trois &eacute;tapes indiqu&eacute;es dans l’illustration ci-apr&egrave;s sont s&eacute;lectionn&eacute;es dans le panneau
Historique, un appel &agrave; la fonction
dreamweaver.historyPalette.getStepsAsJavaScript(dw.historyPalette.getSelectedS
teps()) renvoie &quot;dw.getDocumentDOM().insertText(’Hey diddle diddle, a cat and a
fiddle, the cow jumped over the moon.’);\ndw.getDocumentDOM().newBlock();\n
dw.getDocumentDOM().insertHTML(’&lt;img src=\ &quot;../wdw99/50browsers/images/
sun.gif\&quot;&gt;’, true);\n&quot; :
dreamweaver.historyPalette.getUndoState()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’&eacute;tat d’annulation en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
La position du marqueur d’annulation dans le panneau Historique.
dreamweaver.historyPalette.replaySteps()
Disponibilit&eacute;
Dreamweaver 3.
Description
R&eacute;ex&eacute;cute les &eacute;tapes sp&eacute;cifi&eacute;es de l’historique dans le document actif. Dreamweaver pr&eacute;vient
l’utilisateur de la possibilit&eacute; de cons&eacute;quences inattendues dans le cas o&ugrave; les &eacute;tapes sp&eacute;cifi&eacute;es
contiendraient une action qui ne peut pas &ecirc;tre reproduite.
Arguments
arrayOfIndices
• L’argument arrayOfIndices est un tableau d’index de position dans le panneau Historique.
Fonctions relatives &agrave; l’historique
161
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le code JavaScript correspondant aux &eacute;tapes sp&eacute;cifi&eacute;es de l’historique.
Exemple
Un appel &agrave; la fonction dreamweaver.historyPalette.replaySteps([0,2,3]) r&eacute;ex&eacute;cute la
premi&egrave;re, la troisi&egrave;me et la quatri&egrave;me &eacute;tapes dans le panneau Historique.
dreamweaver.historyPalette.saveAsCommand()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Enregistrer comme commande et permet &agrave; l’utilisateur d’enregistrer les
&eacute;tapes sp&eacute;cifi&eacute;es sous forme de commande. Dreamweaver pr&eacute;vient l’utilisateur de la possibilit&eacute; de
cons&eacute;quences inattendues dans le cas o&ugrave; les &eacute;tapes sp&eacute;cifi&eacute;es contiendraient une action qui ne
peut pas &ecirc;tre reproduite.
Arguments
arrayOfIndices
• L’argument arrayOfIndices est un tableau d’index de position dans le panneau Historique.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le code JavaScript correspondant aux &eacute;tapes sp&eacute;cifi&eacute;es de l’historique.
Exemple
Le code suivant enregistre la quatri&egrave;me, la sixi&egrave;me et la huiti&egrave;me commandes du panneau
Historique comme une commande :
dreamweaver.historyPalette.saveAsCommand([3,5,7]);
dreamweaver.historyPalette.setSelectedSteps()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne les &eacute;tapes sp&eacute;cifi&eacute;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&eacute;fini, aucune &eacute;tape n’est s&eacute;lectionn&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
162
Chapitre 12 : Espace de travail
Exemple
L’exemple de code suivant s&eacute;lectionne la premi&egrave;re, la deuxi&egrave;me et la troisi&egrave;me &eacute;tapes dans le
panneau Historique :
dreamweaver.historyPalette.setSelectedSteps([0,1,2]);
dreamweaver.historyPalette.getUndoState()
Disponibilit&eacute;
Dreamweaver 3.
Description
Effectue le nombre d’annulations et de r&eacute;p&eacute;titions n&eacute;cessaires pour arriver &agrave; l’&eacute;tat d’annulation
sp&eacute;cifi&eacute;.
Arguments
undoState
• L’argument undoState correspond &agrave; l’objet renvoy&eacute; par la fonction
dreamweaver.historyPalette.getUndoState().
Valeurs renvoy&eacute;es
Aucune.
Fonctions d’insertion d’objets
Les fonctions d’insertion d’objets permettent d’effectuer des t&acirc;ches ayant trait aux objets de la
barre Ins&eacute;rer ou du menu Insertion.
dom.insertFlashElement()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Ins&egrave;re l’&eacute;l&eacute;ment Flash (fichier SWC) sp&eacute;cifi&eacute; dans le document actif. Cette fonction suppose que
l’&eacute;l&eacute;ment Flash a &eacute;t&eacute; ajout&eacute; &agrave; la barre Ins&eacute;rer et que le fichier du composant se trouve dans le
dossier ou le sous-dossier Configuration/Objects/FlashElements.
Arguments
swcFilename
• La cha&icirc;ne swcFilename indique le chemin d’acc&egrave;s et le nom du composant Flash par rapport
au dossier Configuration/Objects/FlashElements.
Valeurs renvoy&eacute;es
Aucune.
Fonctions d’insertion d’objets
163
Exemple
L’exemple suivant ins&egrave;re le composant Flash de la barre de navigation figurant dans le dossier
Components/Objects/FlashElements/Navigation dans le document actif :
dom.insertFlashElement(&quot;\Navigation\navBar.swc&quot;);
dreamweaver.objectPalette.getMenuDefault()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Extrait la cha&icirc;ne d’ID de l’&eacute;l&eacute;ment par d&eacute;faut pour le menu associ&eacute;.
Arguments
menuId
• L’argument menuId correspond &agrave; la cha&icirc;ne d&eacute;finissant le menu dans le fichier insertbar.xml.
Valeurs renvoy&eacute;es
Valeur de la cha&icirc;ne d&eacute;finissant l’ID de l’&eacute;l&eacute;ment par d&eacute;faut.
Exemple
L’exemple suivant attribue l’objet par d&eacute;faut actif du menu Support &agrave; la variable defID :
var defId = dw.objectPalette.getMenuDefault(&quot;DW_Media&quot;);
dreamweaver.objectPalette.setMenuDefault()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
D&eacute;finit l’objet par d&eacute;faut d’un menu d&eacute;roulant. L’ic&ocirc;ne de l’objet par d&eacute;faut repr&eacute;sente le menu
d&eacute;roulant sp&eacute;cifi&eacute; dans la barre Ins&eacute;rer. L’utilisateur peut cliquer sur l’objet par d&eacute;faut pour
l’ins&eacute;rer ou cliquer sur la fl&egrave;che figurant en regard pour ouvrir le menu d&eacute;roulant correspondant
afin d’afficher les autres objets de ce menu. Dreamweaver prendra en compte la nouvelle valeur
par d&eacute;faut la prochaine fois que l’utilisateur ouvrira Dreamweaver ou utilisera la commande
Recharger extensions.
Arguments
menuId, defaultId
• L’argument menuId correspond &agrave; la cha&icirc;ne d&eacute;finissant le menu dans le fichier insertbar.xml.
• L’argument defaultId correspond &agrave; la cha&icirc;ne d&eacute;finissant le nouvel objet par d&eacute;faut dans le
champ insertbar.xml.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la configuration de la nouvelle valeur par d&eacute;faut r&eacute;ussit et false
dans le cas contraire.
164
Chapitre 12 : Espace de travail
Exemple
L’exemple suivant d&eacute;finit l’objet Flash en qualit&eacute; d’objet par d&eacute;faut pour le menu Support :
dw.objectPalette.setMenuDefault(&quot;DW_Media&quot;, &quot;DW_Flash&quot;);
dreamweaver.reloadObjects()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Recharge tous les objets de la barre Ins&eacute;rer. Cette fonction revient &agrave; maintenir la touche Ctrl
enfonc&eacute;e tout en cliquant dans le menu des cat&eacute;gories de la barre Ins&eacute;rer et &agrave; s&eacute;lectionner l’option
de menu Recharger extensions.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le chargement des objets a r&eacute;ussi et false dans le cas contraire.
Fonctions relatives au clavier
Les fonctions relatives au clavier &eacute;mulent les op&eacute;rations de d&eacute;placement au sein d’un document
effectu&eacute;es &agrave; l’aide des touches de direction RET. ARR, SUPPR., PG. PREC et PG. SUIV.
Parall&egrave;lement aux fonctions g&eacute;n&eacute;rales, telles que arrowLeft() (&eacute;quivalent &agrave; la touche de direction
GAUCHE) et backspaceKey() (&eacute;quivalent &agrave; la touche RET. ARR), Dreamweaver propose
&eacute;galement des m&eacute;thodes permettant d’acc&eacute;der soit au mot ou paragraphe suivant ou pr&eacute;c&eacute;dent,
soit au d&eacute;but ou &agrave; la fin d’une ligne ou d’un document.
dom.arrowDown()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion vers le bas du nombre de lignes sp&eacute;cifi&eacute;.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument nTimes correspond au nombre de fois o&ugrave; le point d’insertion doit se d&eacute;placer vers
•
le bas. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la s&eacute;lection. Si
cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives au clavier
165
dom.arrowLeft()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion vers la gauche du nombre de colonnes sp&eacute;cifi&eacute;.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de fois o&ugrave; le point d’insertion doit se
d&eacute;placer vers la gauche. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.arrowRight()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion vers la droite du nombre de colonnes sp&eacute;cifi&eacute;.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de fois o&ugrave; le point d’insertion doit se
d&eacute;placer vers la droite. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.arrowUp()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion vers le haut du nombre de lignes sp&eacute;cifi&eacute;.
Arguments
{nTimes}, {bShiftIsDown}
166
Chapitre 12 : Espace de travail
• Facultatif, l’argument nTimes correspond au nombre de fois o&ugrave; le point d’insertion doit se
d&eacute;placer vers le haut. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.backspaceKey()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction revient &agrave; appuyer sur la touche RET. ARR un nombre de fois donn&eacute;. Le r&eacute;sultat
obtenu diff&egrave;re selon qu’il y a une s&eacute;lection en cours ou simplement un point d’insertion.
Arguments
{nTimes}
• Facultatif, l’argument nTimes correspond au nombre de fois o&ugrave; une op&eacute;ration de retour arri&egrave;re
doit avoir lieu. Si l’argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
Valeurs renvoy&eacute;es
Aucune.
dom.deleteKey()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction revient &agrave; appuyer sur la touche SUPPR. un nombre de fois donn&eacute;. Le r&eacute;sultat
obtenu diff&egrave;re selon qu’il y a une s&eacute;lection en cours ou simplement un point d’insertion.
Arguments
{nTimes}
• Facultatif, l’argument nTimes correspond au nombre de fois o&ugrave; une op&eacute;ration de suppression
doit avoir lieu. Si l’argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
Valeurs renvoy&eacute;es
Aucune.
dom.endOfDocument()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions relatives au clavier
167
Description
D&eacute;place le point d’insertion &agrave; la fin du document, dans la fen&ecirc;tre active (c’est-&agrave;-dire apr&egrave;s le
dernier contenu visible dans la fen&ecirc;tre de document ou apr&egrave;s la balise HTML de fermeture dans
l’inspecteur de code, selon le cas).
Arguments
{bShiftIsDown}
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si l’argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.endOfLine()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion &agrave; la fin de la ligne.
Arguments
{bShiftIsDown}
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si l’argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.nextParagraph()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion au d&eacute;but du paragraphe suivant ou saute plusieurs paragraphes si
l’argument nTimes est sup&eacute;rieur &agrave; 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de paragraphes post&eacute;rieurs que le point
•
d’insertion doit sauter. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la s&eacute;lection. Si
cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
168
Chapitre 12 : Espace de travail
dom.nextWord()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion au d&eacute;but du mot suivant ou saute plusieurs mots si l’argument
nTimes est sup&eacute;rieur &agrave; 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de mots post&eacute;rieurs que le point
•
d’insertion doit sauter. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.pageDown()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion d’une page vers le bas (&eacute;quivalent &agrave; la touche PG. SUIV).
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de pages post&eacute;rieures que le point
•
d’insertion doit sauter. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.pageUp()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion d’une page vers le haut (&eacute;quivalent &agrave; la touche PG. PREC).
Arguments
{nTimes}, {bShiftIsDown}
Fonctions relatives au clavier
169
• Facultatif, l’argument nTimes correspond au nombre de pages ant&eacute;rieures que le point
d’insertion doit sauter. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.previousParagraph()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion au d&eacute;but du paragraphe suivant ou saute plusieurs paragraphes si
l’argument nTimes est sup&eacute;rieur &agrave; 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de paragraphes ant&eacute;rieurs que le point
d’insertion doit sauter. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.previousWord()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion au d&eacute;but du mot pr&eacute;c&eacute;dent ou saute plusieurs mots si l’argument
nTimes est sup&eacute;rieur &agrave; 1.
Arguments
{nTimes}, {bShiftIsDown}
• Facultatif, l’argument nTimes correspond au nombre de mots ant&eacute;rieurs que le point
•
d’insertion doit sauter. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
170
Chapitre 12 : Espace de travail
dom.startOfDocument()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion au d&eacute;but du document, dans la fen&ecirc;tre active (c’est-&agrave;-dire avant le
premier contenu visible dans la fen&ecirc;tre de document ou avant la balise HTML d’ouverture dans
l’inspecteur de code, selon le cas).
Arguments
{bShiftIsDown}
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si l’argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.startOfLine()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le point d’insertion au d&eacute;but de la ligne.
Arguments
{bShiftIsDown}
• Facultatif, l’argument bShiftIsDown est une valeur bool&eacute;enne qui indique s’il faut &eacute;tendre la
s&eacute;lection. Si l’argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.mapKeyCodeToChar()
Disponibilit&eacute;
Dreamweaver 4.
Description
Convertit un code de touche tel qu’il est indiqu&eacute; dans le champ keyCode de l’objet &eacute;v&eacute;nement en
caract&egrave;re. Vous devez v&eacute;rifier si le code de touche est une touche sp&eacute;ciale, telle que les touches
ORIG, PG. SUIV, etc. S’il ne s’agit pas d’une touche sp&eacute;ciale, cette m&eacute;thode peut &ecirc;tre utilis&eacute;e
pour traduire le code en code de caract&egrave;re affichable &agrave; l’utilisateur.
Arguments
keyCode
• L’argument keyCode est le code de touche &agrave; traduire en caract&egrave;re.
Fonctions relatives au clavier
171
Valeurs renvoy&eacute;es
Aucune.
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&eacute;cialement con&ccedil;ues pour emp&ecirc;cher l’ex&eacute;cution de routines de mise &agrave; jour superflues sur les
menus dynamiques int&eacute;gr&eacute;s &agrave; Dreamweaver. Pour plus d’informations, voir
dreamweaver.getMenuNeedsUpdating() et dreamweaver.notifyMenuUpdated().
dreamweaver.getMenuNeedsUpdating()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si le menu sp&eacute;cifi&eacute; doit &ecirc;tre mis &agrave; jour.
Arguments
menuId
• L’argument menuId est une cha&icirc;ne contenant la valeur de l’attribut id de l’&eacute;l&eacute;ment de menu,
tel qu’il est d&eacute;fini dans le fichier menus.xml.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si le menu doit &ecirc;tre mis &agrave; jour. Cette fonction renvoie la valeur
false uniquement si la fonction dreamweaver.notifyMenuUpdated() a &eacute;t&eacute; appel&eacute;e avec cet
argument menuId et si la valeur renvoy&eacute;e par menuListFunction n’a pas chang&eacute;. Pour plus
d’informations, voir dreamweaver.notifyMenuUpdated(), page 172.
dreamweaver.notifyMenuUpdated()
Disponibilit&eacute;
Dreamweaver 3.
Description
Pr&eacute;vient Dreamweaver lorsque le menu sp&eacute;cifi&eacute; doit &ecirc;tre mis &agrave; jour.
Arguments
menuId, menuListFunction
• L’argument menuId est une cha&icirc;ne contenant la valeur de l’attribut id de l’&eacute;l&eacute;ment de menu,
•
172
tel qu’il est d&eacute;fini dans le fichier menus.xml.
L’argument menuListFunction doit correspondre &agrave; l’une des cha&icirc;nes suivantes :
&quot;dw.cssStylePalette.getStyles()&quot;, &quot;dw.getDocumentDOM().getFrameNames()&quot;,
&quot;dw.getDocumentDOM().getEditableRegionList&quot;, &quot;dw.getBrowserList()&quot;,
&quot;dw.getRecentFileList()&quot;, &quot;dw.getTranslatorList()&quot;, &quot;dw.getFontList()&quot;,
&quot;dw.getDocumentList()&quot;, &quot;dw.htmlStylePalette.getStyles()&quot; ou
&quot;site.getSites()&quot;.
Chapitre 12 : Espace de travail
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.reloadMenus()
Disponibilit&eacute;
Dreamweaver 3.
Description
Recharge la structure de menus &agrave; partir du fichier menus.xml du dossier Configuration.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de la fen&ecirc;tre de r&eacute;sultats
Les fonctions de la fen&ecirc;tre de r&eacute;sultats vous permettent de cr&eacute;er une fen&ecirc;tre ind&eacute;pendante
contenant des colonnes de donn&eacute;es format&eacute;es ou de dialoguer avec les fen&ecirc;tres int&eacute;gr&eacute;es du
groupe de panneaux R&eacute;sultats.
Cr&eacute;ation d’une fen&ecirc;tre de r&eacute;sultats ind&eacute;pendante
Ces fonctions cr&eacute;ent des fen&ecirc;tres personnalis&eacute;es qui ressemblent au r&eacute;sultat de la fen&ecirc;tre
D&eacute;bogueur JavaScript.
dreamweaver.createResultsWindow()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cr&eacute;e une nouvelle fen&ecirc;tre de r&eacute;sultats et renvoie une r&eacute;f&eacute;rence d’objet JavaScript &agrave; la fen&ecirc;tre.
Arguments
strName, arrColumns
• L’argument strName est la cha&icirc;ne &agrave; utiliser pour le titre de la fen&ecirc;tre.
• L’argument arrColumns est un tableau de noms de colonnes &agrave; utiliser dans le contr&ocirc;le de liste.
Valeurs renvoy&eacute;es
R&eacute;f&eacute;rence d’objet &agrave; la fen&ecirc;tre cr&eacute;&eacute;e.
dreamweaver.showResults()
Disponibilit&eacute;
Dreamweaver MX 2004.
Fonctions de la fen&ecirc;tre de r&eacute;sultats
173
Description
Ouvre le panneau flottant de r&eacute;sultats sp&eacute;cifi&eacute; et s&eacute;lectionne l’&eacute;l&eacute;ment.
Remarque : Cette fonction est uniquement prise en charge dans les fen&ecirc;tres Validation, V&eacute;rification
du navigateur cible et Rapports du site du panneau flottant de r&eacute;sultats.
Arguments
floaterName, floaterIndex
• L’argument floaterName est une cha&icirc;ne indiquant le panneau flottant de r&eacute;sultats &agrave; ouvrir. Les
valeurs autoris&eacute;es sont 'validation', 'btc' ou 'reports'.
• L’argument floaterIndex est un nombre ou une cha&icirc;ne. Utilisez un nombre pour sp&eacute;cifier
l’index d’un &eacute;l&eacute;ment &agrave; s&eacute;lectionner dans le panneau de r&eacute;sultats. Utilisez une cha&icirc;ne pour
sp&eacute;cifier l’URL d’un document. Dans le cas d’une URL, la fonction s&eacute;lectionne le premier
&eacute;l&eacute;ment visible de ce document.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant v&eacute;rifie la pr&eacute;sence d’erreurs au d&eacute;but de la s&eacute;lection en cours dans le document.
Si des erreurs sont d&eacute;tect&eacute;es, elles sont affich&eacute;es dans la fen&ecirc;tre sp&eacute;cifi&eacute;e (floaterName) du
panneau de r&eacute;sultats. Dans le cas contraire, il ouvre la fen&ecirc;tre V&eacute;rification du navigateur cible du
panneau de r&eacute;sultats et affiche le premier &eacute;l&eacute;ment visible du document.
var offset = dw.getDocumentDOM().source.getSelection()[0];
var errors = dw.getDocumentDOM().source.getValidationErrorsForOffset(offset);
if ( errors &amp;&amp; errors.length &gt; 0 )
dw.showResults( errors[0].floaterName, errors[0].floaterIndex );
else
dw.showResults(’btc’, dw.getDocumentDOM().URL);
resWin.addItem()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ajoute un nouvel &eacute;l&eacute;ment &agrave; la fen&ecirc;tre de r&eacute;sultats.
Remarque : N’utilisez cette fonction que sur des fen&ecirc;tres de r&eacute;sultats ind&eacute;pendantes cr&eacute;&eacute;es &agrave; l’aide
de dreamweaver.createResultsWindow(). Il est impossible d’utiliser resWin.addItem() avec des
fen&ecirc;tres de r&eacute;sultats int&eacute;gr&eacute;es, notamment les fen&ecirc;tres Validation, V&eacute;rifier le navigateur cible ou
Rapports du site.
Arguments
resultWindowObj, strIcon, strDesc, itemData, iStartSel, iEndSel, colNdata
• L’argument resultWindowObj correspond &agrave; l’objet renvoy&eacute; par la fonction
createResultsWindow().
174
Chapitre 12 : Espace de travail
• L’argument strIcon est une cha&icirc;ne indiquant le chemin d’acc&egrave;s &agrave; l’ic&ocirc;ne &agrave; utiliser. Pour
afficher une ic&ocirc;ne int&eacute;gr&eacute;e, utilisez une valeur comprise entre 1 et 10 plut&ocirc;t que le chemin
d’acc&egrave;s complet &agrave; l’ic&ocirc;ne. Utilisez la valeur 0 pour n’afficher aucune ic&ocirc;ne. L’illustration cidessous indique les ic&ocirc;nes correspondant aux chiffres allant de 1 &agrave; 10 :
• L’argument strDesc correspond &agrave; la description d&eacute;taill&eacute;e de l’&eacute;l&eacute;ment. Indiquez &quot;0&quot; s’il n’y a
pas de description.
• L’argument itemData est une cha&icirc;ne qui peut vous servir &agrave; stocker des donn&eacute;es particuli&egrave;res
relatives &agrave; l’&eacute;l&eacute;ment &agrave; ajouter (num&eacute;ro de ligne du document, par exemple).
• L’argument iStartSel indique le d&eacute;but du d&eacute;calage de la s&eacute;lection dans le fichier. Entrez la
•
•
valeur null s’il n’y a pas de d&eacute;calage.
L’argument iEndSel indique la fin du d&eacute;calage de la s&eacute;lection dans le fichier. Entrez la valeur
null s’il n’y a pas de d&eacute;calage.
L’argument colNdata est un tableau de cha&icirc;nes qui contient les donn&eacute;es de chaque colonne
(par exemple, tableau de 3 cha&icirc;nes s’il existe 3 colonnes).
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’ajout de l’&eacute;l&eacute;ment a r&eacute;ussi et false dans le cas contraire.
Exemple
L’exemple suivant cr&eacute;e une fen&ecirc;tre de r&eacute;sultats du nom de resWin dont les colonnes s’intitulent
Frodo, Sam et Gollum. L’appel de la fonction resWin.addItem() ajoute une ic&ocirc;ne de dossier
ainsi que les trois cha&icirc;nes (msg1, msg2 et msg3) dans les trois colonnes d&eacute;finies pour la fen&ecirc;tre.
var resWin = dw.createResultsWindow(&quot;Test Window&quot;, [&quot;Frodo&quot;, &quot;Sam&quot;,
&quot;Gollum&quot;]);
resWin.addItem(resWin, &quot;3&quot;, &quot;Description&quot;, null, null, null, [&quot;msg1&quot;, &quot;msg2&quot;,
&quot;msg3&quot;]);
resWin.addResultItem()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ajoute une nouvelle entr&eacute;e dans la fen&ecirc;tre de r&eacute;sultats en cours, en fonction des informations
figurant dans le fichier trait&eacute; par la fonction processfile().
Remarque : N’utilisez cette fonction que sur la fen&ecirc;tre de r&eacute;sultats int&eacute;gr&eacute;e des rapports de site
(dreamweaver.resultsPalette.siteReports). Il est impossible d’utiliser resWin.addResultItem() avec
les autres fen&ecirc;tres de r&eacute;sultats int&eacute;gr&eacute;es ou les fen&ecirc;tres de r&eacute;sultats ind&eacute;pendantes cr&eacute;&eacute;es avec
dreamweaver.createResultsWindow().
Cette fonction est uniquement disponible dans le rappel processFile() d’un rapport de site.
Pour plus d’informations sur les rapports de site, voir la rubrique &laquo; Rapports &raquo; dans l’aide
Extension de Dreamweaver.
Fonctions de la fen&ecirc;tre de r&eacute;sultats
175
Arguments
strFilePath, strIcon, strDisplay, strDesc, {iLineNo}, {iStartSel}, {iEndSel}
• L’argument strFilePath est le chemin d’acc&egrave;s complet &agrave; l’URL du fichier &agrave; traiter.
• L’argument strIcon est le chemin d’acc&egrave;s &agrave; l’ic&ocirc;ne &agrave; utiliser. Pour afficher une ic&ocirc;ne int&eacute;gr&eacute;e,
utilisez une valeur comprise entre 1 et 10 plut&ocirc;t que le chemin d’acc&egrave;s complet &agrave; l’ic&ocirc;ne
(utilisez la valeur 0 pour n’afficher aucune ic&ocirc;ne). L’illustration ci-dessous indique les ic&ocirc;nes
correspondant aux chiffres allant de 1 &agrave; 10 :
• L’argument strDisplay est la cha&icirc;ne &agrave; afficher &agrave; l’utilisateur dans la premi&egrave;re colonne de la
fen&ecirc;tre de r&eacute;sultats (g&eacute;n&eacute;ralement le nom de fichier).
• L’argument strDesc est la description qui accompagne l’entr&eacute;e.
• L’argument iLineNo est le nombre de lignes figurant dans le fichier (facultatif ).
• L’argument iStartSel indique le d&eacute;but du d&eacute;calage dans le fichier (facultatif, mais s’il est
•
pr&eacute;sent, il faut &eacute;galement utiliser l’argument iEndSel).
L’argument iEndSel indique la fin du d&eacute;calage dans le fichier (obligatoire si l’argument
iStartSel est utilis&eacute;).
Valeurs renvoy&eacute;es
Aucune.
resWin.setCallbackCommands()
Disponibilit&eacute;
Dreamweaver 4.
Description
Indique &agrave; la fen&ecirc;tre de r&eacute;sultats sur quelles commandes la m&eacute;thode processFile() doit &ecirc;tre
appel&eacute;e. Si cette fonction n’est pas appel&eacute;e, la commande qui a cr&eacute;&eacute; la fen&ecirc;tre de r&eacute;sultats est
appel&eacute;e.
Arguments
arrCmdNames
• L’argument arrCmdNames est un tableau de noms de commandes sur lesquelles appeler la
fonction processFile().
Valeurs renvoy&eacute;es
Aucune.
resWin.setColumnWidths()
Disponibilit&eacute;
Dreamweaver 4.
176
Chapitre 12 : Espace de travail
Description
D&eacute;finit la largeur de chaque colonne.
Arguments
arrWidth
• L’argument arrWidth est un tableau de nombres entiers repr&eacute;sentant les largeurs &agrave; utiliser pour
chaque colonne de la commande.
Valeurs renvoy&eacute;es
Aucune.
resWin.setFileList()
Disponibilit&eacute;
Dreamweaver 4.
Description
Indique &agrave; la fen&ecirc;tre de r&eacute;sultats une liste de fichiers, de dossiers ou des deux sur lesquels appeler
un ensemble de commandes.
Arguments
arrFilePaths, bRecursive
• L’argument arrFilePaths est un tableau de chemins de fichier ou de dossier &agrave; r&eacute;p&eacute;ter.
• L’argument bRecursive est une valeur bool&eacute;enne indiquant si la r&eacute;p&eacute;tition doit &ecirc;tre r&eacute;currente
(true) ou non (false).
Valeurs renvoy&eacute;es
Aucune.
resWin.setTitle()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;finit le titre de la fen&ecirc;tre.
Arguments
strTitle
• L’argument strTitle est le nouveau titre du panneau flottant.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de la fen&ecirc;tre de r&eacute;sultats
177
resWin.startProcessing()
Disponibilit&eacute;
Dreamweaver 4.
Description
Lance le traitement du fichier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
resWin.stopProcessing()
Disponibilit&eacute;
Dreamweaver 4.
Description
Arr&ecirc;te le traitement du fichier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Utilisation du groupe de panneaux R&eacute;sultats int&eacute;gr&eacute;
Ces fonctions produisent la sortie dans le groupe de panneaux R&eacute;sultats. Le groupe de panneaux
R&eacute;sultats affiche des rapports &agrave; onglets sur les recherches, la validation de la source, les rapports au
niveau du site, les cibles de navigateur, les rapports de console, les connexions FTP et les
v&eacute;rifications de liens.
Utilisation de panneaux enfants sp&eacute;cifiques
Les panneaux enfants suivants sont des fen&ecirc;tres de r&eacute;sultats int&eacute;gr&eacute;es qui existent toujours dans
l’interface Dreamweaver et auxquelles il est possible d’acc&eacute;der directement. Ces panneaux &eacute;tant
des fen&ecirc;tres de r&eacute;sultats, vous pouvez utiliser les m&eacute;thodes suivantes, d&eacute;finies pour les fen&ecirc;tres de
r&eacute;sultats ind&eacute;pendantes :
•
•
•
dreamweaver.resultsPalette.siteReports
dreamweaver.resultsPalette.validator
dreamweaver.resultsPalette.btc
(panneau V&eacute;rification du navigateur cible)
Pour plus d’informations sur l’utilisation des m&eacute;thodes resWin, voir Cr&eacute;ation d’une fen&ecirc;tre de
r&eacute;sultats ind&eacute;pendante, page 173.
178
Chapitre 12 : Espace de travail
Utilisation du panneau enfant actif
Les fonctions API g&eacute;n&eacute;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.resultsPalette.clear()
Disponibilit&eacute;
Dreamweaver MX.
Description
Efface le contenu du panneau actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canClear(), page 449.
dreamweaver.resultsPalette.Copy()
Disponibilit&eacute;
Dreamweaver MX.
Description
Envoie un message copi&eacute; &agrave; la fen&ecirc;tre active (souvent utilis&eacute; pour la fen&ecirc;tre de connexion FTP).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canCopy(), page 449.
dreamweaver.resultsPalette.cut()
Disponibilit&eacute;
Dreamweaver MX.
Description
Envoie un message coup&eacute; &agrave; la fen&ecirc;tre active (souvent utilis&eacute; pour la fen&ecirc;tre de connexion FTP).
Fonctions de la fen&ecirc;tre de r&eacute;sultats
179
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canCut(), page 450.
dreamweaver.resultsPalette.Paste()
Disponibilit&eacute;
Dreamweaver MX.
Description
Envoie un message coll&eacute; &agrave; la fen&ecirc;tre active (souvent utilis&eacute; pour la fen&ecirc;tre de connexion FTP).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canPaste(), page 450.
dreamweaver.resultsPalette.openInBrowser
Disponibilit&eacute;
Dreamweaver MX.
Description
Envoie un rapport (Rapports de site, V&eacute;rification du navigateur cible, Validation et V&eacute;rificateur de
lien) vers le navigateur par d&eacute;faut.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canOpenInBrowser(), page 450.
180
Chapitre 12 : Espace de travail
dreamweaver.resultsPalette.openInEditor()
Disponibilit&eacute;
Dreamweaver MX.
Description
Saute &agrave; la ligne s&eacute;lectionn&eacute;e pour les rapports sp&eacute;cifiques (Rapports du site, V&eacute;rification du
navigateur cible, Validation et V&eacute;rificateur de lien) et ouvre le document dans l’&eacute;diteur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canOpenInEditor(), page 450.
dreamweaver.resultsPalette.save()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ouvre la bo&icirc;te de dialogue Enregistrer pour une fen&ecirc;tre qui prend en charge la fonction
Enregistrer (Rapports du site, V&eacute;rification du navigateur cible, Validation et V&eacute;rificateur de lien).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canSave(), page 451.
dreamweaver.resultsPalette.selectAll()
Disponibilit&eacute;
Dreamweaver MX.
Description
Envoie une commande S&eacute;lectionner tout vers la fen&ecirc;tre active.
Arguments
Aucun.
Fonctions de la fen&ecirc;tre de r&eacute;sultats
181
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.resultsPalette.canSelectAll(), page 451.
D&eacute;bogage de serveur
Dreamweaver peut solliciter des fichiers &agrave; partir de ColdFusion et afficher la r&eacute;ponse dans son
navigateur incorpor&eacute;. Lorsque le serveur renvoie la r&eacute;ponse, Dreamweaver recherche un paquet de
XML ayant une signature connue, dans la r&eacute;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 &eacute;l&eacute;ments suivants :
• l’ensemble des mod&egrave;les, balises personnalis&eacute;es et fichiers inclus utilis&eacute;s pour cr&eacute;er la page CFM
•
•
•
•
•
rendue ;
les exceptions ;
les requ&ecirc;tes SQL ;
les requ&ecirc;tes d’objets ;
les variables ;
la plage de trac&eacute;.
En outre, le panneau D&eacute;bogage du serveur peut afficher des donn&eacute;es de d&eacute;bogage provenant
d’autres mod&egrave;les de serveur. Pour configurer Dreamweaver afin que le programme d&eacute;bogue les
autres mod&egrave;les de serveur, utilisez la fonction
dreamweaver.resultsPalette.debugWindow.addDebugContextData().
dreamweaver.resultsPalette.debugWindow.addDebugContextData()
Disponibilit&eacute;
Dreamweaver MX.
Description
Interpr&egrave;te un fichier XML personnalis&eacute; renvoy&eacute; du serveur sp&eacute;cifi&eacute; dans la bo&icirc;te de dialogue
D&eacute;finition du site. Le contenu du fichier XML affiche les donn&eacute;es de l’arborescence dans le
panneau D&eacute;bogage du serveur, pour que vous puissiez utiliser le panneau D&eacute;bogage du serveur en
vue d’&eacute;valuer le contenu g&eacute;n&eacute;r&eacute; par le serveur &agrave; partir des diff&eacute;rents mod&egrave;les de serveur.
Arguments
treedata
• L’argument treedata est la cha&icirc;ne XML renvoy&eacute;e par le serveur. La cha&icirc;ne XML doit utiliser
la mise en forme suivante :
182
server debug node
Nœud racine pour les donn&eacute;es XML de
d&eacute;bogage
debugnode
Correspond &agrave; tous les nœuds
context
Nom de l’&eacute;l&eacute;ment qui appara&icirc;t dans la liste de
contexte
Chapitre 12 : Espace de travail
icon
Ic&ocirc;ne &agrave; utiliser pour le nœud d’arborescence
name
Nom &agrave; afficher
value
Valeur &agrave; afficher
timestamp
Uniquement applicable au nœud de contexte
Les cha&icirc;nes suivantes sont facultatives :
jumptoline
Etablit un lien vers un num&eacute;ro de ligne
sp&eacute;cifique
template
Nom de la partie du fichier de mod&egrave;le de l’URL
path
Chemin du fichier &agrave; partir du serveur
line number
Num&eacute;ro de ligne dans le fichier
start position
D&eacute;but du d&eacute;calage de caract&egrave;res dans la ligne
end position
Fin du d&eacute;calage de caract&egrave;res dans la ligne
Exemple :
&lt;serverdebuginfo&gt;
&lt;context&gt;
&lt;template&gt;&lt;![CDATA[/ooo/master.cfm]]&gt;&lt;/template&gt;
&lt;path&gt;&lt;![CDATA[C:\server\wwwroot\ooo\master.cfm]]&gt;&lt;/path&gt;
&lt;timestamp&gt;&lt;![CDATA[0:0:0.0]]&gt;&lt;/timestamp&gt;
&lt;/context&gt;
&lt;debugnode&gt;
&lt;name&gt;&lt;![CDATA[CGI]]&gt;&lt;/name&gt;
&lt;icon&gt;&lt;![CDATA[ServerDebugOutput/ColdFusion/CGIVariables.gif]]&gt;&lt;/icon&gt;
&lt;debugnode&gt;
&lt;name&gt;&lt;![CDATA[Pubs.name.sourceURL]]&gt;&lt;/name&gt;
&lt;icon&gt;&lt;![CDATA[ServerDebugOutput/ColdFusion/Variable.gif]]&gt;&lt;/icon&gt;
&lt;value&gt;&lt;![CDATA[jdbc:macromedia:sqlserver://
name.macromedia.com:1111;databaseName=Pubs]]&gt;&lt;/value&gt;
&lt;/debugnode&gt;
&lt;/debugnode&gt;
&lt;debugnode&gt;
&lt;name&gt;&lt;![CDATA[Element Snippet is undefined in class
coldfusion.compiler.TagInfoNotFoundException]]&gt;&lt;/name&gt;
&lt;icon&gt;&lt;![CDATA[ServerDebugOutput/ColdFusion/Exception.gif]]&gt;&lt;/icon&gt;
&lt;jumptoline linenumber=&quot;3&quot; startposition=&quot;2&quot; endposition=&quot;20&quot;&gt;
&lt;template&gt;&lt;![CDATA[/ooo/master.cfm]]&gt;&lt;/template&gt;
&lt;path&gt;&lt;![CDATA[C:\Neo\wwwroot\ooo\master.cfm]]&gt;&lt;/path&gt;
&lt;/jumptoline&gt;
&lt;/debugnode&gt;
&lt;/serverdebuginfo&gt;
Valeurs renvoy&eacute;es
Aucune.
Fonctions de bascule
Ces fonctions permettent d’obtenir et de d&eacute;finir un certain nombre d’options qui peuvent &ecirc;tre
activ&eacute;es ou d&eacute;sactiv&eacute;es.
Fonctions de bascule
183
dom.getEditNoFramesContent()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Modifier &gt; Jeu de cadres &gt; Modifier le contenu
sans cadres.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu de NOFRAMES est l’affichage actif et false dans le cas
contraire.
dom.getHideAllVisualAids()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si les assistances visuelles sont d&eacute;finies comme &eacute;tant masqu&eacute;es.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true pour d&eacute;finir les assistances visuelles comme &eacute;tant masqu&eacute;es et false
dans le cas contraire.
dom.getPreventLayerOverlaps()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Emp&ecirc;cher le chevauchement des calques.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true pour activer l’option Emp&ecirc;cher le chevauchement des calques et
false dans le cas contraire.
184
Chapitre 12 : Espace de travail
dom.getShowAutoIndent()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si l’option de retrait automatique est activ&eacute;e dans la fen&ecirc;tre de
document en mode Code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le retrait automatique est activ&eacute; et false dans le cas contraire.
dom.getShowFrameBorders()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Bordures de cadre.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les bordures de cadre sont visibles et false dans le cas contraire.
dom.getShowGrid()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Grille &gt; Afficher.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la grille est visible et false dans le cas contraire.
dom.getShowHeadView()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions de bascule
185
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Contenu de l’en-t&ecirc;te.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu de l’en-t&ecirc;te est visible et false dans le cas contraire.
dom.getShowInvalidHTML()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si le code HTML incorrect est actuellement en surbrillance dans la
fen&ecirc;tre de document en mode Code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le code HTML incorrect est en surbrillance et false dans le cas
contraire.
dom.getShowImageMaps()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Cartes graphiques.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les cartes graphiques sont visibles et false dans le cas contraire.
dom.getShowInvisibleElements()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; El&eacute;ments invisibles.
186
Chapitre 12 : Espace de travail
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les marqueurs d’&eacute;l&eacute;ments invisibles sont visibles et false dans le
cas contraire.
dom.getShowLayerBorders()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Bordures de calque.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les bordures de calque sont visibles et false dans le cas contraire.
dom.getShowLineNumbers()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si les num&eacute;ros de ligne sont affich&eacute;s en mode Code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les num&eacute;ros de ligne sont affich&eacute;s et false dans le cas contraire.
dom.getShowRulers()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; R&egrave;gles &gt; Afficher.
Arguments
Aucun.
Fonctions de bascule
187
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les r&egrave;gles sont visibles et false dans le cas contraire.
dom.getShowSyntaxColoring()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si l’option de coloration de la syntaxe est activ&eacute;e dans la fen&ecirc;tre de
document en mode Code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la coloration de la syntaxe est activ&eacute;e et false dans le cas
contraire.
dom.getShowTableBorders()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Bordures de tableau.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les bordures de tableau sont visibles et false dans le cas contraire.
dom.getShowToolbar()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si la barre d’outils est visible.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la barre d’outils est affich&eacute;e et false dans le cas contraire.
188
Chapitre 12 : Espace de travail
dom.getShowTracingImage()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Trac&eacute; de l’image &gt; Afficher.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’option est activ&eacute;e et false dans le cas contraire.
dom.getShowWordWrap()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si l’option de retour automatique &agrave; la ligne est activ&eacute;e dans la fen&ecirc;tre de
document en mode Code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le retour automatique &agrave; la ligne est activ&eacute; et false dans le cas
contraire.
dom.getSnapToGrid()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Grille &gt; Aligner sur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’option Aligner sur la grille est activ&eacute;e et false dans le cas
contraire.
Fonctions de bascule
189
dom.setEditNoFramesContent()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Modifier &gt; Jeu de cadres &gt; Modifier le contenu sans
cadres.
Arguments
bEditNoFrames
• L’argument bEditNoFrames est une valeur bool&eacute;enne : true active l’option Modifier le
contenu sans cadres, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canEditNoFramesContent(), page 433.
dom.setHideAllVisualAids()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;sactive l’affichage de l’ensemble des bordures, cartes graphiques et &eacute;l&eacute;ments
invisibles, quel que soit leur param&egrave;tre individuel dans le menu Affichage.
Arguments
bSet
• L’argument bSet est une valeur bool&eacute;enne : true masque les assistances visuelles tandis que
false
les affiche.
Valeurs renvoy&eacute;es
Aucune.
dom.setPreventLayerOverlaps()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Emp&ecirc;cher le chevauchement des calques.
Arguments
bPreventLayerOverlaps
190
Chapitre 12 : Espace de travail
• L’argument bPreventLayerOverlaps est une valeur bool&eacute;enne : true active l’option
Emp&ecirc;cher le chevauchement des calques, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowFrameBorders()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Bordures de cadre.
Arguments
bShowFrameBorders
• L’argument bShowFrameBorders est une valeur bool&eacute;enne : true active l’option Bordures de
cadre, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowGrid()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Grille &gt; Afficher.
Arguments
bShowGrid
• L’argument bShowGrid est une valeur bool&eacute;enne : true active l’option Affichage &gt; Grille &gt;
Afficher, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowHeadView()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Contenu de l’en-t&ecirc;te.
Arguments
bShowHead
Fonctions de bascule
191
• L’argument bShowHead est une valeur bool&eacute;enne : true active l’option Contenu de l’en-t&ecirc;te,
tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowInvalidHTML()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive la mise en surbrillance du code HTML incorrect dans la fen&ecirc;tre
de document en mode Code.
Cette fonction d&eacute;termine si le code HTML incorrect est actuellement en surbrillance.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true si la mise en surbrillance du code HTML
incorrect est activ&eacute;e et false dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowImageMaps()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Cartes graphiques.
Arguments
bShowImageMaps
• L’argument bShowImageMaps est une valeur bool&eacute;enne : true active l’option Cartes
graphiques, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowInvisibleElements()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; El&eacute;ments invisibles.
192
Chapitre 12 : Espace de travail
Arguments
bViewInvisibleElements
• L’argument bViewInvisibleElements est une valeur bool&eacute;enne : true active l’option
El&eacute;ments invisibles, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowLayerBorders()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Bordures de calque.
Arguments
bShowLayerBorders
• L’argument bShowLayerBorders est une valeur bool&eacute;enne : true active l’option Bordures de
calque, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowLineNumbers()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction affiche ou masque les num&eacute;ros de ligne dans la fen&ecirc;tre de document en mode
Code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour afficher les num&eacute;ros de ligne et false
dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowRulers()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt;R&egrave;gles &gt; Afficher.
Fonctions de bascule
193
Arguments
bShowRulers
• L’argument bShowRulers est une valeur bool&eacute;enne : true active l’option Afficher, tandis que
false
la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowSyntaxColoring()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive la coloration de la syntaxe dans la fen&ecirc;tre de document en
mode Code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour afficher la coloration de la syntaxe et
false
dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowTableBorders()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Bordures de tableau.
Arguments
bShowTableBorders
• L’argument bShowTableBorders est une valeur bool&eacute;enne : true active l’option Bordures de
tableau, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowToolbar()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction affiche ou masque la barre d’outils.
194
Chapitre 12 : Espace de travail
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour afficher la barre d’outils et false dans
le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowTracingImage()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Trac&eacute; de l’image &gt; Afficher.
Arguments
bShowTracingImage
• L’argument bShowTracingImage est une valeur bool&eacute;enne : true active l’option Afficher,
tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowWordWrap()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive l’option Retour &agrave; la ligne dans la fen&ecirc;tre de document en mode
Code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour effectuer un retour &agrave; la ligne et false
dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dom.setSnapToGrid()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Grille &gt; Aligner sur.
Fonctions de bascule
195
Arguments
bSnapToGrid
• L’argument bSnapToGrid est une valeur bool&eacute;enne : true active l’option Aligner sur, tandis
que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.getHideAllFloaters()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Masquer les panneaux.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’option Masquer les panneaux est activ&eacute;e et false si l’option
Afficher les panneaux est activ&eacute;e.
dreamweaver.getShowStatusBar()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Affichage &gt; Barre d’&eacute;tat.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la barre d’&eacute;tat est visible et false dans le cas contraire.
dreamweaver.htmlInspector.getShowAutoIndent()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si l’option de retrait automatique est activ&eacute;e dans l’inspecteur de code.
Arguments
Aucun.
196
Chapitre 12 : Espace de travail
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le retrait automatique est activ&eacute; et false dans le cas contraire.
dreamweaver.htmlInspector.getShowInvalidHTML()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si le code HTML incorrect est actuellement en surbrillance dans
l’inspecteur de code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le code HTML incorrect est en surbrillance et false dans le cas
contraire.
dreamweaver.htmlInspector.getShowLineNumbers()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si les num&eacute;ros de ligne sont affich&eacute;s dans l’inspecteur de code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les num&eacute;ros de ligne sont affich&eacute;s et false dans le cas contraire.
dreamweaver.htmlInspector.getShowSyntaxColoring()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si l’option de coloration de la syntaxe est activ&eacute;e dans l’inspecteur de
code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la coloration de la syntaxe est activ&eacute;e et false dans le cas
contraire.
Fonctions de bascule
197
dreamweaver.htmlInspector.getShowWordWrap()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine si l’option de retour &agrave; la ligne est activ&eacute;e dans l’inspecteur de code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le retour automatique &agrave; la ligne est activ&eacute; et false dans le cas
contraire.
dreamweaver.htmlInspector.setShowAutoIndent()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive l’option de retrait automatique dans l’inspecteur de code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true active l’option de retrait automatique,
tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.htmlInspector.setShowInvalidHTML()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive la mise en surbrillance du code HTML incorrect dans
l’inspecteur de code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour rendre la mise en surbrillance du code
HTML incorrect visible et false dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
198
Chapitre 12 : Espace de travail
dreamweaver.htmlInspector.setShowLineNumbers()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction affiche ou masque les num&eacute;ros de ligne dans l’inspecteur de code en mode Code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour afficher les num&eacute;ros de ligne et false
pour les masquer.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.htmlInspector.setShowSyntaxColoring()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive la coloration de la syntaxe dans l’inspecteur de code en mode
Code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour rendre la coloration de la syntaxe
visible et false dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.htmlInspector.setShowWordWrap()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction active ou d&eacute;sactive l’option Retour &agrave; la ligne dans l’inspecteur de code.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true active l’option Retour &agrave; la ligne, tandis que
false
la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de bascule
199
dreamweaver.setHideAllFloaters()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active l’option Masquer les panneaux ou Afficher les panneaux.
Arguments
bShowFloatingPalettes
• L’argument bShowFloatingPalettes est une valeur bool&eacute;enne : true active l’option Masquer
les panneaux, tandis que false active l’option Afficher les panneaux.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.setShowStatusBar()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Affichage &gt; Barre d’&eacute;tat.
Arguments
bShowStatusBar
• L’argument bShowStatusBar est une valeur bool&eacute;enne : true active l’option Barre d’&eacute;tat,
tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
site.getShowDependents()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Afficher les fichiers d&eacute;pendants.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les fichiers d&eacute;pendants sont visibles dans la carte du site et false
dans le cas contraire.
200
Chapitre 12 : Espace de travail
site.getShowHiddenFiles()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Afficher les fichiers identifi&eacute;s comme masqu&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les fichiers masqu&eacute;s sont visibles dans la carte du site et false
dans le cas contraire.
site.getShowPageTitles()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Afficher les titres des pages.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les titres de page sont visibles dans la carte du site et false dans le
cas contraire.
site.getShowToolTips()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient l’&eacute;tat en cours de l’option Info-bulles.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true lorsque les info-bulles sont visibles dans le panneau Site et false
dans le cas contraire.
Fonctions de bascule
201
site.setShowDependents()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Afficher les fichiers d&eacute;pendants dans la carte du site.
Arguments
bShowDependentFiles
• L’argument bShowDependentFiles est une valeur bool&eacute;enne : true active l’option Afficher les
fichiers d&eacute;pendants, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
site.setShowHiddenFiles()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Afficher les fichiers identifi&eacute;s comme masqu&eacute;s dans la
carte du site.
Arguments
bShowHiddenFiles
• L’argument bShowHiddenFiles est une valeur bool&eacute;enne : true active l’option Afficher les
fichiers identifi&eacute;s comme masqu&eacute;s, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
site.setShowPageTitles()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Afficher les titres des pages dans la carte du site.
Arguments
bShowPageTitles
• L’argument bShowPageTitles est une valeur bool&eacute;enne : true active l’option Afficher les
titres des pages, tandis que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
202
Chapitre 12 : Espace de travail
Activateur
site.canShowPageTitles(), page 460.
site.setShowToolTips()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active ou d&eacute;sactive l’option Info-bulles.
Arguments
bShowToolTips
• L’argument bShowToolTips est une valeur bool&eacute;enne : true active l’option Info-bulles, tandis
que false la d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux barres d’outils
Les fonctions JavaScript suivantes vous permettent d’obtenir et de d&eacute;finir l’affichage des barres
d’outils et de leurs &eacute;tiquettes, de vous procurer les &eacute;tiquettes des &eacute;l&eacute;ments de barre d’outils dans la
fen&ecirc;tre en cours, de positionner les barres d’outils et d’obtenir leur ID. Pour plus d’informations
sur la cr&eacute;ation ou la modification des barres d’outils, voir la rubrique &laquo; Barres d’outils &raquo; dans l’aide
Extension de Dreamweaver.
dom.forceToolbarUpdate()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Oblige les gestionnaires de mise &agrave; jour &agrave; s’ex&eacute;cuter sur tous les &eacute;l&eacute;ments de la barre d’outils
sp&eacute;cifi&eacute;e.
Arguments
toolbarID
• L’argument toolbarID correspond &agrave; l’ID de la barre d’outils dont Dreamweaver doit mettre &agrave;
jour les &eacute;l&eacute;ments.
Valeurs renvoy&eacute;es
Aucune.
dom.getShowToolbarIconLabels()
Disponibilit&eacute;
Dreamweaver MX.
Fonctions relatives aux barres d’outils
203
Description
Cette fonction d&eacute;termine si les &eacute;tiquettes des boutons sont visibles dans la fen&ecirc;tre de document
active. Dreamweaver affiche toujours les &eacute;tiquettes des commandes autres que les boutons si ces
&eacute;tiquettes sont d&eacute;finies.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les &eacute;tiquettes des boutons sont visibles dans la fen&ecirc;tre de
document active et false dans le cas contraire.
Exemple
L’exemple suivant permet d’afficher les &eacute;tiquettes des boutons :
var dom = dw.getDocumentDom();
if (dom.getShowToolbarIconLabels() == false)
{
dom.setShowToolbarIconLabels(true);
}
dom.getToolbarIdArray()
Disponibilit&eacute;
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&eacute;sactiver toutes les barres d’outils et
pouvoir ainsi les repositionner en ne rendant visibles que certaines d’entre elles.
Arguments
Aucun.
Valeurs renvoy&eacute;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&eacute;
Dreamweaver MX 2004.
Description
Obtient la valeur de l’&eacute;l&eacute;ment de barre d’outils sp&eacute;cifi&eacute;.
204
Chapitre 12 : Espace de travail
Arguments
toolbarID, itemID
• L’argument toolbarID est une cha&icirc;ne indiquant l’ID de la barre d’outils contenant l’&eacute;l&eacute;ment
•
pour lequel vous souhaitez obtenir une valeur.
L’argument itemID est une cha&icirc;ne qui indique l’ID de l’&eacute;l&eacute;ment pour lequel vous souhaitez
obtenir une valeur.
Valeurs renvoy&eacute;es
Une cha&icirc;ne repr&eacute;sentant la valeur de l’&eacute;l&eacute;ment de barre d’outils.
Exemple
L’exemple de fonction receiveArguments() suivant figure dans une commande de barre d’outils
qui r&eacute;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&eacute;n&eacute;rer une valeur valide pour la
fonction de propri&eacute;t&eacute; CSS font-size :
receiveArguments(newSize){
var dom = dw.getDocumentDOM();
if (newSize != &quot;&quot;){
dom.applyFontMarkupAsStyle(’font-size’, newSize +
dom.getToolbarItemValue(&quot;DW_Toolbar_Text&quot;,&quot;DW_Text_Units&quot;));
}
else{
dom.removeFontMarkupAsStyle(’font-size’);
}
}
dom.getToolbarLabel()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction obtient l’&eacute;tiquette de la barre d’outils sp&eacute;cifi&eacute;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 &agrave; la valeur de l’attribut ID
de la balise toolbar d&eacute;finie dans le fichier toolbars.xml.
Valeurs renvoy&eacute;es
La cha&icirc;ne de nom label qui est affect&eacute;e &agrave; la balise toolbar comme attribut.
Exemple
L’exemple suivant stocke l’&eacute;tiquette de myEditbar dans la variable label :
var label = dom.getToolbarLabel(&quot;myEditbar&quot;);
Fonctions relatives aux barres d’outils
205
dom.getToolbarVisibility()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction renvoie une valeur bool&eacute;enne qui indique si la barre d’outils sp&eacute;cifi&eacute;e dans
l’argument toolbar_id est visible.
Arguments
toolbar_id
• L’argument toolbar_id est la cha&icirc;ne d’ID affect&eacute;e &agrave; la barre d’outils.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;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&eacute;rifie si la barre d’outils myEditbar est visible dans la fen&ecirc;tre de document,
puis stocke cette valeur dans la variable retval :
var retval = dom.getToolbarVisibility(&quot;myEditbar&quot;);
return retval;
dom.setToolbarItemAttribute()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Modifie une valeur parmi les trois attributs image ou l’attribut tooltip d’un &eacute;l&eacute;ment de la barre
d’outils.
Arguments
toolbarID, toolbarItemId, attrName, attrValue
• L’argument toolbarID est une cha&icirc;ne qui indique l’ID de la barre d’outils.
• L’argument toolbarItemId est une cha&icirc;ne qui indique l’ID de l’&eacute;l&eacute;ment de la barre d’outils.
• L’argument attrName est une cha&icirc;ne qui indique le nom de l’attribut &agrave; d&eacute;finir. Les valeurs
•
autoris&eacute;es sont 'image', 'overImage', 'disabledImage' et 'tooltip'.
L’argument attrValue est une cha&icirc;ne qui indique la valeur &agrave; d&eacute;finir.
Valeurs renvoy&eacute;es
Aucune.
206
Chapitre 12 : Espace de travail
Exemple
L’exemple suivant appelle dom.setToolbarItemAttribute() trois fois pour d&eacute;finir les attributs
image, imageOver et tooltip de l’&eacute;l&eacute;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&eacute;
Dreamweaver MX.
Description
Cette fonction indique &agrave; Dreamweaver d’afficher les &eacute;tiquettes des boutons comportant des
&eacute;tiquettes. Dreamweaver affiche toujours les &eacute;tiquettes des commandes autres que les boutons, si
ces &eacute;tiquettes sont d&eacute;finies.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne : true pour afficher les &eacute;tiquettes des boutons et
false
dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant indique &agrave; Dreamweaver d’afficher les &eacute;tiquettes des boutons sur les barres
d’outils :
dom.setShowToolbarIconLabels(true);
dom.setToolbarPosition()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction d&eacute;place la barre d’outils sp&eacute;cifi&eacute;e &agrave; la position indiqu&eacute;e.
Remarque : Il est impossible de d&eacute;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 &agrave; la valeur de l’attribut ID
de la balise toolbar d&eacute;finie dans le fichier toolbars.xml.
Fonctions relatives aux barres d’outils
207
• L’argument position indique l’endroit o&ugrave; Dreamweaver place la barre d’outils par rapport aux
•
autres barres d’outils. Les valeurs possibles de l’argument position sont d&eacute;crites dans la liste
suivante :
■ top correspond &agrave; la position par d&eacute;faut. La barre d’outils appara&icirc;t en haut de la fen&ecirc;tre de
document.
■ below affiche la barre d’outils au d&eacute;but de la ligne qui se trouve juste en dessous de la barre
d’outils sp&eacute;cifi&eacute;e dans l’argument relative_to. Dreamweaver indique une erreur si la barre
d’outils ne trouve pas la barre d’outils sp&eacute;cifi&eacute;e dans l’argument 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&eacute;cal&eacute;e par rapport aux autres
barres d’outils flottantes. Sur Macintosh, floating est trait&eacute; de la m&ecirc;me fa&ccedil;on que top.
relative_to=&quot;toolbar_id&quot; est obligatoire lorsque l’argument position est d&eacute;fini sur la
valeur below. Dans les autres cas, cet argument est ignor&eacute;. Indique l’ID de la barre d’outils en
dessous de laquelle cette barre d’outils doit &ecirc;tre plac&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant place myEditbar en dessous de la barre d’outils myPicturebar :
dom.setToolbarPosition(&quot;myEditbar&quot;, &quot;below&quot;, &quot;myPicturebar&quot;);
dom.setToolbarVisibility()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction affiche ou masque la barre d’outils sp&eacute;cifi&eacute;e.
Arguments
toolbar_id, bShow
• L’argument toolbar_id est l’ID de la barre d’outils, qui correspond &agrave; la valeur de l’attribut ID
•
de la balise toolbar d&eacute;finie dans le fichier toolbars.xml.
L’argument bShow est une valeur bool&eacute;enne qui indique si la barre d’outils doit &ecirc;tre affich&eacute;e ou
masqu&eacute;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&eacute;es
Aucune.
208
Chapitre 12 : Espace de travail
Exemple
L’exemple suivant v&eacute;rifie si la barre d’outils myEditbar est visible dans la fen&ecirc;tre de document. Si
ce n’est pas le cas, il l’affiche :
var dom = dw.getDocumentDOM();
if(dom != null &amp;&amp; dom.getToolbarVisibility(&quot;myEditbar&quot;) == false)
{
dom.setToolbarVisibility(&quot;myEditbar&quot;, true);
{
Fonctions relatives aux fen&ecirc;tres
Ces fonctions permettent d’agir sur la fen&ecirc;tre de document et sur les panneaux flottants. Elles
permettent d’afficher et de masquer les panneaux flottants, de d&eacute;terminer la partie active de la
fen&ecirc;tre de document et de d&eacute;finir le document actif. Pour les op&eacute;rations relatives au panneau Site,
voir Fonctions relatives aux sites, page 222.
Remarque : Certaines fonctions de cette section fonctionnent uniquement sous Windows. Leur
description indique si tel est le cas.
dom.getFocus()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction d&eacute;termine quelle partie du document est actuellement active.
Arguments
Aucun.
Valeurs renvoy&eacute;es
L’une des cha&icirc;nes suivantes :
•
•
•
•
la cha&icirc;ne &quot;head&quot; si la zone HEAD est active ;
la cha&icirc;ne &quot;body&quot; si la zone BODY ou NOFRAMES est active ;
la cha&icirc;ne &quot;frameset&quot; si un jeu de cadres ou l’un des cadres qui le composent est s&eacute;lectionn&eacute; ;
la cha&icirc;ne &quot;none&quot; si la zone active ne figure pas dans le document (si elle se trouve dans
l’inspecteur de propri&eacute;t&eacute;s ou dans un autre panneau flottant, par exemple).
dom.getView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine quel mode est visible.
Arguments
Aucun.
Fonctions relatives aux fen&ecirc;tres
209
Valeurs renvoy&eacute;es
&quot;design&quot;, &quot;code&quot;
ou &quot;split&quot;, selon le mode d’affichage visible.
dom.getWindowTitle()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient le titre de la fen&ecirc;tre contenant le document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant le texte qui appara&icirc;t entre les balises TITLE du document, ou rien si le
document ne figure pas dans une fen&ecirc;tre ouverte.
dom.setView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction affiche ou masque le mode Cr&eacute;ation ou Code pour produire un affichage
contenant uniquement le mode Cr&eacute;ation ou Code ou les deux.
Arguments
viewString
• L’argument viewString correspond au mode &agrave; afficher ; il doit avoir l’une des valeurs
suivantes : &quot;design&quot;, &quot;code&quot; ou &quot;split&quot;.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.bringAttentionToFloater()
Disponibilit&eacute;
Dreamweaver MX.
Description
Place au premier plan le panneau ou l’inspecteur sp&eacute;cifi&eacute; et attire l’attention sur cet &eacute;l&eacute;ment en le
faisant clignoter (fonctionnalit&eacute; l&eacute;g&egrave;rement diff&eacute;rente de dw.toggleFloater()).
Arguments
floaterName
• L’argument floaterName correspond au nom de la fen&ecirc;tre, du panneau ou de l’inspecteur.
210
Chapitre 12 : Espace de travail
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant ouvre le panneau Actifs et le fait clignoter :
dw.bringAttentionToFloater(&quot;library&quot;);
dreamweaver.cascade()
Disponibilit&eacute;
Dreamweaver MX (sous Windows uniquement).
Description
Affiche en cascade les fen&ecirc;tres de document en commen&ccedil;ant dans l’angle sup&eacute;rieur gauche et en
d&eacute;calant l&eacute;g&egrave;rement chaque fen&ecirc;tre par rapport &agrave; la pr&eacute;c&eacute;dente.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant affiche les documents ouverts en cascade :
dw.cascade()
dreamweaver.getActiveWindow()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient le document figurant dans la fen&ecirc;tre active.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Objet document correspondant au document qui figure dans la fen&ecirc;tre active ou, si le document
figure dans un cadre, objet document correspondant au jeu de cadres.
dreamweaver.getDocumentList()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions relatives aux fen&ecirc;tres
211
Description
Cette fonction obtient la liste de tous les documents ouverts.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau d’objets document, chacun correspondant &agrave; une fen&ecirc;tre de document ouverte. Si une
fen&ecirc;tre de document contient un jeu de cadres, l’objet document d&eacute;signe le jeu de cadres et non le
contenu des cadres.
dreamweaver.getFloaterVisibility()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction v&eacute;rifie si le panneau ou l’inspecteur sp&eacute;cifi&eacute; est visible.
Arguments
floaterName
• L’argument floaterName est le nom du panneau flottant. Si floaterName ne correspond &agrave;
aucun nom de panneau int&eacute;gr&eacute;, Dreamweaver recherche dans le dossier Configuration/Floaters
un fichier appel&eacute; floaterName.htm dans lequel floaterName correspond au nom d’un
panneau flottant.
Les valeurs de floaterName pour les panneaux Dreamweaver int&eacute;gr&eacute;s sont les cha&icirc;nes se
trouvant &agrave; droite des noms de panneaux dans la liste suivante :
Actifs = &quot;assets&quot;
Comportements = &quot;behaviors&quot;
Inspecteur de code = &quot;html&quot;
Composants = &quot;server components&quot;
Styles CSS = &quot;css styles&quot;
Liaisons = &quot;data sources&quot;
Cadres = &quot;frames&quot;
Historique = &quot;history&quot;
Styles HTML = &quot;html styles&quot;
Barre Ins&eacute;rer = &quot;objects&quot;
Calques = &quot;layers&quot;
Biblioth&egrave;que = &quot;library&quot;
V&eacute;rificateur de lien (R&eacute;sultats) = &quot;linkchecker&quot;
Propri&eacute;t&eacute;s = &quot;properties&quot;
212
Chapitre 12 : Espace de travail
R&eacute;f&eacute;rence = &quot;reference&quot;
Rapports (R&eacute;sultats) = &quot;reports&quot;
Recherche (R&eacute;sultats) = &quot;search&quot;
Comportements de serveur = &quot;server behaviors&quot;
Site = &quot;site&quot;
Fichiers du site = &quot;site files&quot;
Carte du site = &quot;site map&quot;
Fragments de code = &quot;snippets&quot;
Inspecteur de balises = &quot;tag inspector&quot;
V&eacute;rification du navigateur cible (R&eacute;sultats) = &quot;btc&quot;
Mod&egrave;les = &quot;templates&quot;
Validation (R&eacute;sultats) = &quot;validation&quot;
Valeurs renvoy&eacute;es
Une valeur bool&eacute;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&eacute;
floaterName.
dreamweaver.getFocus()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine la partie de l’application actuellement active.
Arguments
bAllowFloaters
• L’argument bAllowFloaters est une valeur bool&eacute;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&eacute;es
L’une des cha&icirc;nes suivantes :
•
•
•
•
•
La cha&icirc;ne &quot;document&quot; si la fen&ecirc;tre de document est active ;
La cha&icirc;ne &quot;site&quot; si le panneau Site est actif ;
La cha&icirc;ne &quot;textView&quot; si le mode Texte est actif ;
La cha&icirc;ne &quot;html&quot; si l’inspecteur de code est actif ;
La cha&icirc;ne floaterName si bAllowFloaters a pour valeur true et si un panneau flottant est
actif, floaterName correspondant &agrave; &quot;objects&quot;, &quot;properties&quot;, &quot;launcher&quot;, &quot;library&quot;, &quot;css
styles&quot;, &quot;html styles&quot;, &quot;behaviors&quot;, &quot;timelines&quot;, &quot;layers&quot;, &quot;frames&quot;, &quot;templates&quot; ou
&quot;history&quot; ;
Fonctions relatives aux fen&ecirc;tres
213
• La cha&icirc;ne &quot;none&quot; (Macintosh) si aucune fen&ecirc;tre de document ni le panneau Site ne sont
ouverts.
dreamweaver.getPrimaryView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;termine le mode d’affichage d&eacute;fini comme mode principal (au premier plan).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Les cha&icirc;nes &quot;design&quot; ou &quot;code&quot;, selon le mode visible ou le volet situ&eacute; au premier plan dans un
affichage &agrave; deux volets.
dreamweaver.getSnapDistance()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction renvoie la distance d’alignement en pixels.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Nombre entier repr&eacute;sentant la distance d’alignement en pixels. La distance par d&eacute;faut est
10 pixels ; 0 indique que la fonction d’alignement est d&eacute;sactiv&eacute;e.
dreamweaver.minimizeRestoreAll()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction r&eacute;duit en ic&ocirc;ne ou restaure toutes les fen&ecirc;tres dans Dreamweaver.
Arguments
bMinimize
• L’argument bMinimize est une valeur bool&eacute;enne : true pour r&eacute;duire les fen&ecirc;tres en ic&ocirc;nes et
false
pour les restaurer.
Valeurs renvoy&eacute;es
Aucune.
214
Chapitre 12 : Espace de travail
dreamweaver.setActiveWindow()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction active la fen&ecirc;tre contenant le document sp&eacute;cifi&eacute;.
Arguments
documentObject, {bActivateFrame}
• L’argument documentObject correspond &agrave; l’objet situ&eacute; &agrave; la racine de l’arborescence DOM
•
d’un document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction
dreamweaver.getDocumentDOM()).
Facultatif, l’argument bActivateFrame n’est applicable que lorsque documentObject se
trouve &agrave; l’int&eacute;rieur d’un jeu de cadres. L’argument bActivateFrame est une valeur bool&eacute;enne :
true active le cadre contenant le document ainsi que la fen&ecirc;tre contenant le jeu de cadres et
false les d&eacute;sactive.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.setFloaterVisibility()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction indique s’il faut rendre visible un panneau flottant ou un inspecteur sp&eacute;cifique.
Arguments
floaterName, bIsVisible
• L’argument floaterName est le nom du panneau flottant. Si floaterName ne correspond &agrave;
aucun nom de panneau int&eacute;gr&eacute;, Dreamweaver recherche dans le dossier Configuration/Floaters
un fichier appel&eacute; floaterName.htm dans lequel floaterName correspond au nom d’un
panneau flottant. Si Dreamweaver ne trouve aucun panneau flottant portant le nom
floaterName, cette fonction n’a aucun effet.
Les valeurs de floaterName pour les panneaux Dreamweaver int&eacute;gr&eacute;s sont les cha&icirc;nes se
trouvant &agrave; droite des noms de panneaux dans la liste suivante :
Actifs = &quot;assets&quot;
Comportements = &quot;behaviors&quot;
Inspecteur de code = &quot;html&quot;
Composants = &quot;server components&quot;
Styles CSS = &quot;css styles&quot;
Liaisons = &quot;data sources&quot;
Fonctions relatives aux fen&ecirc;tres
215
Cadres = &quot;frames&quot;
Historique = &quot;history&quot;
Styles HTML = &quot;html styles&quot;
Barre Ins&eacute;rer = &quot;objects&quot;
Calques = &quot;layers&quot;
Biblioth&egrave;que = &quot;library&quot;
V&eacute;rificateur de lien (R&eacute;sultats) = &quot;linkchecker&quot;
Propri&eacute;t&eacute;s = &quot;properties&quot;
R&eacute;f&eacute;rence = &quot;reference&quot;
Rapports (R&eacute;sultats) = &quot;reports&quot;
Recherche (R&eacute;sultats) = &quot;search&quot;
Comportements de serveur = &quot;server behaviors&quot;
Site = &quot;site&quot;
Fichiers du site = &quot;site files&quot;
Carte du site = &quot;site map&quot;
Fragments de code = &quot;snippets&quot;
Inspecteur de balises = &quot;tag inspector&quot;
V&eacute;rification du navigateur cible (R&eacute;sultats) = &quot;btc&quot;
Mod&egrave;les = &quot;templates&quot;
Validation (R&eacute;sultats) = &quot;validation&quot;
L’argument bIsVisible est une valeur bool&eacute;enne indiquant si le panneau flottant doit &ecirc;tre
visible.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.setPrimaryView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction affiche le mode sp&eacute;cifi&eacute; en haut de la fen&ecirc;tre de document.
Arguments
viewString
• L’argument viewString correspond au mode &agrave; afficher en haut de la fen&ecirc;tre de document ; il
peut avoir l’une des valeurs suivantes : &quot;design&quot; ou &quot;code&quot;.
216
Chapitre 12 : Espace de travail
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.setSnapDistance()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction d&eacute;finit la distance d’alignement en pixels.
Arguments
snapDistance
• L’argument snapDistance est un nombre entier repr&eacute;sentant la distance d’alignement en
pixels. La valeur par d&eacute;faut est 10 pixels. Saisissez 0 pour d&eacute;sactiver la fonction d’alignement.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.showProperties()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction rend l’inspecteur de propri&eacute;t&eacute;s visible et l’active.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.tileHorizontally()
Disponibilit&eacute;
Dreamweaver MX (sous Windows uniquement).
Description
Organise les fen&ecirc;tres de document en mosa&iuml;que horizontale en les pla&ccedil;ant les unes &agrave; c&ocirc;t&eacute; des
autres sans qu’elles ne se chevauchent. Ce processus revient au partage vertical de l’espace de
travail.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux fen&ecirc;tres
217
Exemple
L’exemple suivant affiche les documents ouverts en mosa&iuml;que horizontale :
dw.tileHorizontally()
dreamweaver.tileVertically()
Disponibilit&eacute;
Dreamweaver MX (sous Windows uniquement).
Description
Organise les fen&ecirc;tres de documents en mosa&iuml;que verticale en les pla&ccedil;ant les unes derri&egrave;re les autres
sans qu’elles ne se chevauchent. Ce processus revient au partage horizontal de l’espace de travail.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant affiche les documents ouverts en mosa&iuml;que verticale :
dw.tileVertically()
dreamweaver.toggleFloater()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction affiche, masque ou place au premier plan le panneau ou l’inspecteur sp&eacute;cifi&eacute;.
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&ecirc;tre. Si le nom de la fen&ecirc;tre flottante est
reference,
l’&eacute;tat de visibilit&eacute; du panneau R&eacute;f&eacute;rence peut &ecirc;tre mis &agrave; jour par l’utilisateur dans
le mode Code. Tous les autres panneaux effectuent un suivi continu de la s&eacute;lection, mais le
panneau R&eacute;f&eacute;rence n’analyse la s&eacute;lection dans le mode Code que lorsque l’utilisateur appelle un
suivi.
Valeurs renvoy&eacute;es
Aucune.
218
Chapitre 12 : Espace de travail
dreamweaver.updateReference()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction met &agrave; jour le panneau flottant R&eacute;f&eacute;rence. Si le panneau flottant R&eacute;f&eacute;rence n’est pas
visible, dw.updateReference() l’affiche et le met &agrave; jour.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux fen&ecirc;tres
219
220
Chapitre 12 : Espace de travail
CHAPITRE 13
Site
Les fonctions relatives aux sites effectuent des t&acirc;ches ayant trait &agrave; la gestion d’un site Web. Il peut
s’agir de personnaliser un rapport, de d&eacute;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&eacute;der aux fonctionnalit&eacute;s de cr&eacute;ation de rapports de Macromedia
Dreamweaver MX 2004, c’est-&agrave;-dire de lancer, de contr&ocirc;ler et de personnaliser le processus de
cr&eacute;ation de rapports. Pour plus d’informations, voir la rubrique &laquo; Rapports &raquo; dans l’aide Extension
de Dreamweaver.
dreamweaver.isReporting()
Disponibilit&eacute;
Dreamweaver 4.
Description
V&eacute;rifie si un processus de cr&eacute;ation de rapport est en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si un processus est en cours et false dans le cas contraire.
dreamweaver.showReportsDialog()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ouvre la bo&icirc;te de dialogue Rapports.
Arguments
Aucun.
221
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux sites
Ces fonctions permettent d’effectuer des op&eacute;rations sur les fichiers de site ou sur la carte du site.
Elles permettent d’effectuer les t&acirc;ches suivantes :
•
•
•
•
•
•
cr&eacute;er des liens entre fichiers ;
obtenir, placer, archiver et extraire des fichiers ;
s&eacute;lectionner et d&eacute;s&eacute;lectionner des fichiers ;
cr&eacute;er et supprimer des fichiers ;
obtenir des informations sur les sites d&eacute;finis par l’utilisateur ;
importer et exporter les informations du site.
dreamweaver.loadSitesFromPrefs()
Disponibilit&eacute;
Dreamweaver 4.
Description
Charge les informations du site pour tous les sites de la base de registres du syst&egrave;me (Windows) ou
du fichier de pr&eacute;f&eacute;rences Dreamweaver (Macintosh) dans Dreamweaver. Si un site est connect&eacute; &agrave;
un serveur distant lorsque cette fonction est appel&eacute;e, il est automatiquement d&eacute;connect&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.saveSitesToPrefs()
Disponibilit&eacute;
Dreamweaver 4.
Description
Enregistre toutes les informations pour chaque site que l’utilisateur a d&eacute;fini dans la base de
registres du syst&egrave;me (Windows) ou le fichier de pr&eacute;f&eacute;rences Dreamweaver (Macintosh).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
222
Chapitre 13 : Site
site.addLinkToExistingFile()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue S&eacute;lectionner fichier HTML pour permettre &agrave; l’utilisateur de
s&eacute;lectionner un fichier, puis cr&eacute;e un lien entre ce dernier et le document s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canAddLink(), page 453.
site.addLinkToNewFile()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Lier au nouveau fichier pour permettre &agrave; l’utilisateur d’indiquer les
d&eacute;tails du nouveau fichier, puis cr&eacute;e un lien entre ce dernier et le document s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canAddLink(), page 453.
site.canEditColumns()
Description
D&eacute;termine si un site existe.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il existe un site et false dans le cas contraire.
Fonctions relatives aux sites
223
site.changeLinkSitewide()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Modifier le lien au niveau du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.changeLink()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue S&eacute;lectionner fichier HTML pour permettre &agrave; l’utilisateur de
s&eacute;lectionner le nouveau fichier &agrave; associer au lien.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canChangeLink(), page 453.
site.checkIn()
Disponibilit&eacute;
Dreamweaver 3.
Description
Archive les fichiers s&eacute;lectionn&eacute;s et traite les fichiers d&eacute;pendants de l’une des fa&ccedil;ons suivantes :
• Si l’utilisateur a activ&eacute; l’option Invite lors de Placer/Archiver dans les pr&eacute;f&eacute;rences, cat&eacute;gorie
•
•
224
FTP du site, la bo&icirc;te de dialogue Fichiers d&eacute;pendants s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Oui, les fichiers d&eacute;pendants sont t&eacute;l&eacute;charg&eacute;s et aucune bo&icirc;te
de dialogue ne s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Non, les fichiers d&eacute;pendants ne sont pas t&eacute;l&eacute;charg&eacute;s et
aucune bo&icirc;te de dialogue ne s’affiche.
Chapitre 13 : Site
Arguments
siteOrURL.
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; &quot;site&quot;, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canCheckIn(), page 453.
site.checkLinks()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue V&eacute;rificateur de lien et v&eacute;rifie les liens dans les fichiers sp&eacute;cifi&eacute;s.
Arguments
scopeOfCheck.
• L’argument scopeOfCheck d&eacute;finit l’&eacute;tendue de la v&eacute;rification des liens. Il doit avoir pour
valeur &quot;document&quot;, &quot;selection&quot; ou &quot;site&quot;.
Valeurs renvoy&eacute;es
Aucune.
site.checkOut()
Disponibilit&eacute;
Dreamweaver 3.
Description
Extrait les fichiers s&eacute;lectionn&eacute;s et traite les fichiers d&eacute;pendants de l’une des fa&ccedil;ons suivantes :
• Si l’utilisateur a activ&eacute; l’option Invite lors de Acqu&eacute;rir/Extraire dans les pr&eacute;f&eacute;rences, cat&eacute;gorie
FTP du site, la bo&icirc;te de dialogue Fichiers d&eacute;pendants s’affiche.
• Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
•
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Oui, les fichiers d&eacute;pendants sont t&eacute;l&eacute;charg&eacute;s et aucune bo&icirc;te
de dialogue ne s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Non, les fichiers d&eacute;pendants ne sont pas t&eacute;l&eacute;charg&eacute;s et
aucune bo&icirc;te de dialogue ne s’affiche.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; &quot;site&quot;, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Fonctions relatives aux sites
225
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canCheckOut(), page 454.
site.checkTargetBrowsers()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie le navigateur cible des documents s&eacute;lectionn&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.cloak()
Disponibilit&eacute;
Dreamweaver MX.
Description
Voile la s&eacute;lection en cours dans le panneau Site ou le dossier sp&eacute;cifi&eacute;.
Arguments
siteOrURL
L’argument siteOrURL doit contenir l’une des deux valeurs suivantes :
• le mot-cl&eacute; &quot;site&quot;, qui indique si cloak() doit envelopper la s&eacute;lection dans le panneau Site ;
• l’URL d’un dossier particulier, qui indique si cloak() doit envelopper le dossier sp&eacute;cifi&eacute; et
tout son contenu.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canCloak(), page 454.
site.defineSites()
Disponibilit&eacute;
Dreamweaver 3.
226
Chapitre 13 : Site
Description
La fonction ouvre la bo&icirc;te de dialogue Modifier les sites.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.deleteSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime les fichiers s&eacute;lectionn&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.deployFilesToTestingServerBin()
Disponibilit&eacute;
Dreamweaver MX.
Description
Place le ou les fichiers sp&eacute;cifi&eacute;s dans le dossier bin du serveur d’&eacute;valuation. Si aucun param&egrave;tre
relatif au d&eacute;ploiement des fichiers de prise en charge n’est d&eacute;fini pour le site en cours, cette
fonction appelle la bo&icirc;te de dialogue D&eacute;ployer les fichiers de prise en charge sur le serveur
d’&eacute;valuation.
Arguments
filesToDeploy
• L’argument filesToDeploy correspond &agrave; un tableau de noms de fichiers que Dreamweaver
d&eacute;ploiera.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le d&eacute;ploiement des fichiers r&eacute;ussit et false dans le cas contraire.
Exemple
Cet exemple d&eacute;ploie les fichiers image1.jpg et script1.js dans le dossier bin du serveur
d’&eacute;valuation :
site.deployFilesToTestingServerBin(&quot;image1.jpg&quot;, &quot;script1.js&quot;);
Fonctions relatives aux sites
227
site.editColumns()
Description
Cette fonction affiche la bo&icirc;te de dialogue Modifier les sites, qui contient la section Colonnes en
mode Fichier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.exportSite()
Disponibilit&eacute;
Dreamweaver MX.
Description
Exporte un site Dreamweaver dans un fichier XML, qui peut &ecirc;tre import&eacute; dans une autre instance
de Dreamweaver pour permettre la duplication du site.
Toutes les informations contenues dans la bo&icirc;te de dialogue D&eacute;finition du site sont enregistr&eacute;es
dans un fichier XML qui comprend la liste des dossiers voil&eacute;s et des informations sur le type de
document par d&eacute;faut. La seule exception est que l’utilisateur peut omettre le nom et le mot de
passe de connexion lorsque l’acc&egrave;s FTP est d&eacute;fini. L’exemple suivant pr&eacute;sente un fichier XML cr&eacute;&eacute;
par Dreamweaver lors de l’exportation d’un site :
&lt;?xml version=&quot;1.0&quot; ?&gt;
&lt;site&gt;
&lt;localinfo
sitename=&quot;DW00&quot;
localroot=&quot;C:\Documents and Settings\jlondon\Desktop\DWServer\&quot;
imagefolder=&quot;C:\Documents and Settings\jlondon\Desktop\DWServer\Images\&quot;
spacerfilepath=&quot;&quot;
refreshlocal=&quot;TRUE&quot;
cache=&quot;FALSE&quot;
httpaddress=&quot;http://&quot; curserver=&quot;webserver&quot; /&gt;
&lt;remoteinfo
accesstype=&quot;ftp&quot;
host=&quot;dreamweaver&quot;
remoteroot=&quot;kojak/&quot;
user=&quot;dream&quot;
checkoutname=&quot;Jay&quot;
emailaddress=&quot;[email protected]&quot;
usefirewall=&quot;FALSE&quot;
usepasv=&quot;TRUE&quot;
enablecheckin=&quot;TRUE&quot;
checkoutwhenopen=&quot;TRUE&quot; /&gt;
&lt;designnotes
usedesignnotes=&quot;TRUE&quot;
sharedesignnotes=&quot;TRUE&quot; /&gt;
&lt;sitemap
homepage=&quot;C:\Documents and Settings\jlondon\Desktop\DWServer\Untitled-2.htm&quot;
pagesperrow=&quot;200&quot; columnwidth=&quot;125&quot; showdependentfiles=&quot;TRUE&quot;
showpagetitles=&quot;FALSE&quot; showhiddenfiles=&quot;TRUE&quot; /&gt;
228
Chapitre 13 : Site
&lt;fileviewcolumns sharecolumns=&quot;TRUE&quot;&gt;
&lt;column name=&quot;Local Folder&quot;
align=&quot;left&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;TRUE&quot;
localwidth=&quot;180&quot; remotewidth=&quot;180&quot; /&gt;
&lt;column name=&quot;Notes&quot;
align=&quot;center&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;TRUE&quot;
localwidth=&quot;36&quot; remotewidth=&quot;36&quot; /&gt;
&lt;column name=&quot;Size&quot;
align=&quot;right&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;TRUE&quot;
localwidth=&quot;-2&quot; remotewidth=&quot;-2&quot; /&gt;
&lt;column name=&quot;Type&quot;
align=&quot;left&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;TRUE&quot;
localwidth=&quot;60&quot; remotewidth=&quot;60&quot; /&gt;
&lt;column name=&quot;Modified&quot;
align=&quot;left&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;TRUE&quot;
localwidth=&quot;102&quot; remotewidth=&quot;102&quot; /&gt;
&lt;column name=&quot;Checked Out By&quot;
align=&quot;left&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;TRUE&quot;
localwidth=&quot;50&quot; remotewidth=&quot;50&quot; /&gt;
&lt;column name=&quot;Status&quot; note=&quot;status&quot;
align=&quot;left&quot; show=&quot;TRUE&quot; share=&quot;FALSE&quot; builtin=&quot;FALSE&quot;
localwidth=&quot;50&quot; remotewidth=&quot;50&quot; /&gt;
&lt;/fileviewcolumns&gt;
&lt;appserverinfo
servermodel=&quot;ColdFusion&quot;
urlprefix=&quot;http://dreamweaver/kojak/&quot;
serverscripting=&quot;CFML&quot;
serverpageext=&quot;&quot;
connectionsmigrated=&quot;TRUE&quot;
useUD4andUD5pages=&quot;TRUE&quot;
defaultdoctype=&quot;&quot;
accesstype=&quot;ftp&quot;
host=&quot;dreamweaver&quot;
remoteroot=&quot;kojak/&quot;
user=&quot;dream&quot;
usefirewall=&quot;FALSE&quot;
usepasv=&quot;TRUE&quot; /&gt;
&lt;cloaking enabled=&quot;TRUE&quot; patterns=&quot;TRUE&quot;&gt;
&lt;cloakedfolder folder=&quot;databases/&quot; /&gt;
&lt;cloakedpattern pattern=&quot;.png&quot; /&gt;
&lt;cloakedpattern pattern=&quot;.jpg&quot; /&gt;
&lt;cloakedpattern pattern=&quot;.jpeg&quot; /&gt;
&lt;/cloaking&gt;
&lt;/site&gt;
Arguments
siteName
• L’argument siteName identifie le site &agrave; exporter. Si siteName est une cha&icirc;ne vide,
Dreamweaver exporte le site en cours.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le site nomm&eacute; existe et si le fichier XML est correctement export&eacute;,
et false dans le cas contraire.
Fonctions relatives aux sites
229
site.findLinkSource()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre le fichier contenant le lien ou le fichier d&eacute;pendant s&eacute;lectionn&eacute; et met en surbrillance le
texte du lien ou la r&eacute;f&eacute;rence au fichier d&eacute;pendant. Cette fonction agit seulement sur les fichiers de
l’affichage Carte du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canFindLinkSource(), page 455.
site.get()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient les fichiers sp&eacute;cifi&eacute;s et traite les fichiers d&eacute;pendants comme suit :
• Si l’utilisateur a activ&eacute; l’option Invite lors de Acqu&eacute;rir/Extraire dans les pr&eacute;f&eacute;rences, cat&eacute;gorie
•
•
FTP du site, la bo&icirc;te de dialogue Fichiers d&eacute;pendants s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Oui, les fichiers d&eacute;pendants sont t&eacute;l&eacute;charg&eacute;s et aucune bo&icirc;te
de dialogue ne s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Non, les fichiers d&eacute;pendants ne sont pas t&eacute;l&eacute;charg&eacute;s et
aucune bo&icirc;te de dialogue ne s’affiche.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; &quot;site&quot;, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canGet(), page 455.
230
Chapitre 13 : Site
site.getAppServerAccessType()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie la m&eacute;thode d’acc&egrave;s utilis&eacute;e pour tous les fichiers sur le serveur d’application du site en
cours. Le site en cours est le site associ&eacute; au document actuellement activ&eacute;. Si aucun document
n’est activ&eacute;, le site ouvert dans Dreamweaver est utilis&eacute;.
Remarque : ColdFusion Component Explorer utilise cette fonction ; voir
site.getAppServerPathToFiles() et site.getLocalPathToFiles().
Arguments
Aucun.
Valeurs renvoy&eacute;es
L’une des cha&icirc;nes suivantes :
•
•
•
•
&quot;none&quot;
&quot;local/network&quot;
&quot;ftp&quot;
&quot;source_control&quot;
site.getAppServerPathToFiles()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine le chemin d’acc&egrave;s aux fichiers distants sur le serveur d’application d&eacute;fini pour le site en
cours. Le site en cours est le site associ&eacute; au document actuellement activ&eacute;. Si aucun document
n’est activ&eacute;, le site ouvert dans Dreamweaver est utilis&eacute;.
Remarque : ColdFusion Component Explorer utilise cette fonction ; voir
site.getAppServerAccessType() et site.getLocalPathToFiles().
Arguments
Aucun.
Valeurs renvoy&eacute;es
Si le type d’acc&egrave;s au serveur d’application est local/network, cette fonction renvoie un chemin ;
dans le cas contraire, cette fonction renvoie une cha&icirc;ne vide.
site.getAppURLPrefixForSite()
Disponibilit&eacute;
Dreamweaver MX.
Fonctions relatives aux sites
231
Description
Obtient la valeur du pr&eacute;fixe d’URL du site s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le pr&eacute;fixe d’URL du site s&eacute;lectionn&eacute;.
Exemple
sitePrefix = getAppURLPrefixForSite();
site.getCheckOutUser()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient les noms d’utilisateur et d’extraction associ&eacute;s au site en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant un nom d’utilisateur et un nom d’extraction, s’ils sont d&eacute;finis, ou une cha&icirc;ne
vide si les fonctions d’archivage et d’extraction sont d&eacute;sactiv&eacute;es.
Exemple
Un appel &agrave; la fonction site.getCheckOutUser() pourrait renvoyer ceci : &quot;denise
(deniseLaptop)&quot;. Si aucun nom d’extraction n’est sp&eacute;cifi&eacute;, seul le nom d’utilisateur
(&quot;denise&quot;, par exemple).
est renvoy&eacute;
site.getCheckOutUserForFile()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le nom d’utilisateur et le nom d’extraction de l’utilisateur qui a extrait le fichier sp&eacute;cifi&eacute;.
Arguments
fileName.
• L’argument fileName correspond au chemin d’acc&egrave;s au fichier interrog&eacute;, exprim&eacute; sous la
forme d’une URL de type file://.
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant le nom d’utilisateur et le nom d’extraction de l’utilisateur qui a extrait le fichier
sp&eacute;cifi&eacute;, ou cha&icirc;ne vide si le fichier n’a pas &eacute;t&eacute; extrait.
232
Chapitre 13 : Site
Exemple
Un appel &agrave; la fonction site.getCheckOutUserForFile(&quot;file://C:/sites/avocado8/
index.html&quot;) pourrait renvoyer ceci : &quot;denise (deniseLaptop)&quot;. Si aucun nom d’extraction
n’est sp&eacute;cifi&eacute;, seul le nom d’utilisateur est renvoy&eacute; (&quot;denise&quot;, par exemple).
site.getCloakingEnabled()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si le voilage est activ&eacute; pour le site en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le voilage est activ&eacute; pour le site en cours et false dans le cas
contraire.
site.getConnectionState()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’&eacute;tat de connexion en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le site distant est connect&eacute;.
Activateur
site.canConnect(), page 455.
site.getCurrentSite()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le site en cours.
Arguments
Aucun.
Fonctions relatives aux sites
233
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le nom du site en cours.
Exemple
Si plusieurs sites sont d&eacute;finis, un appel &agrave; la fonction site.getCurrentSite() renvoie celui qui
est actuellement affich&eacute; dans la liste des sites en cours du panneau Site.
site.getFocus()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine quel volet du panneau Site est activ&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
L’une des cha&icirc;nes suivantes :
•
•
•
&quot;local&quot;
&quot;remote&quot;
&quot;site map&quot;
site.getLinkVisibility()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si tous les liens s&eacute;lectionn&eacute;s dans la carte du site sont visibles (c’est-&agrave;-dire s’ils ne sont pas
identifi&eacute;s comme masqu&eacute;s).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si tous les liens s&eacute;lectionn&eacute;s sont visibles et false dans le cas
contraire.
site.getLocalPathToFiles()
Disponibilit&eacute;
Dreamweaver MX.
234
Chapitre 13 : Site
Description
D&eacute;termine le chemin d’acc&egrave;s aux fichiers locaux d&eacute;finis pour le site en cours. Le site en cours est le
site associ&eacute; au document actuellement activ&eacute;. Si aucun document n’est activ&eacute;, le site ouvert dans
Dreamweaver est utilis&eacute;.
Remarque : ColdFusion Component Explorer utilise cette fonction ; voir
site.getAppServerAccessType() et site.getAppServerPathToFiles().
Arguments
Aucun.
Valeurs renvoy&eacute;es
Chemin d’acc&egrave;s aux fichiers qui r&eacute;sident sur l’ordinateur local pour le site en cours.
site.getSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine quels sont les fichiers actuellement s&eacute;lectionn&eacute;s dans le panneau Site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes repr&eacute;sentant les chemins aux fichiers et dossiers s&eacute;lectionn&eacute;s, exprim&eacute; sous la
forme d’une URL de type file://, ou d’un tableau vide si aucun fichier ni dossier n’est s&eacute;lectionn&eacute;.
site.getSiteForURL()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient le nom du site, s’il en a un, associ&eacute; &agrave; un fichier donn&eacute;.
Arguments
fileURL
• L’argument fileURL est l’URL compl&egrave;te (y compris la cha&icirc;ne &laquo;
file:// &raquo;)
d’un fichier
nomm&eacute;.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le nom du site, s’il en a un, dans lequel r&eacute;side le fichier sp&eacute;cifi&eacute;. La cha&icirc;ne est
vide lorsque le fichier sp&eacute;cifi&eacute; n’existe dans aucun site d&eacute;fini.
Fonctions relatives aux sites
235
site.getSites()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste des sites d&eacute;finis.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes repr&eacute;sentant les noms des sites d&eacute;finis, ou tableau vide si aucun site n’est
d&eacute;fini.
site.importSite()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cr&eacute;e un site Dreamweaver &agrave; partir d’un fichier XML. Au cours de l’importation, si le dossier
sp&eacute;cifi&eacute; par l’attribut localroot de l’&eacute;l&eacute;ment &lt;localinfo&gt; n’existe pas sur l’ordinateur local,
Dreamweaver invite l’utilisateur &agrave; choisir un dossier racine local diff&eacute;rent. Dreamweaver se
comporte de la m&ecirc;me mani&egrave;re lorsqu’il tente de localiser le dossier d’image par d&eacute;faut sp&eacute;cifi&eacute; par
l’attribut imagefolder de l’&eacute;l&eacute;ment &lt;localinfo&gt;.
Arguments
fileURL
• L’argument fileURL est une cha&icirc;ne qui contient l’URL du fichier XML. Dreamweaver utilise
ce fichier XML pour cr&eacute;er un nouveau site. Si fileURL est une cha&icirc;ne vide, Dreamweaver
invite l’utilisateur &agrave; choisir un fichier XML &agrave; importer.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le fichier XML nomm&eacute; existe et si la cr&eacute;ation du site r&eacute;ussit et
false dans le cas contraire.
site.invertSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Inverse la s&eacute;lection dans la carte du site.
Arguments
Aucun.
236
Chapitre 13 : Site
Valeurs renvoy&eacute;es
Aucune.
site.isCloaked()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si la s&eacute;lection en cours dans le panneau Site ou le dossier sp&eacute;cifi&eacute; est voil&eacute;.
Arguments
siteOrURL
• L’argument siteOrURL doit contenir l’une des deux valeurs suivantes :
■
■
le mot-cl&eacute; &quot;site&quot;, qui indique que la fonction isCloaked() doit tester la s&eacute;lection dans le
panneau Site ;
l’URL de fichier d’un dossier particulier, qui indique si isCloaked() doit tester le dossier
sp&eacute;cifi&eacute;.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’objet sp&eacute;cifi&eacute; est voil&eacute; et false dans le cas contraire.
site.locateInSite()
Disponibilit&eacute;
Dreamweaver 3.
Description
Recherche le ou les fichiers indiqu&eacute;s dans le volet sp&eacute;cifi&eacute; du panneau Site et s&eacute;lectionne les
fichiers.
Arguments
localOrRemote, siteOrURL
• L’argument localOrRemote doit avoir la valeur &quot;local&quot; ou &quot;remote&quot;.
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; &quot;site&quot;, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canLocateInSite(), page 456.
Fonctions relatives aux sites
237
site.makeEditable()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;sactive le drapeau de lecture seule sur les fichiers s&eacute;lectionn&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canMakeEditable(), page 456.
site.makeNewDreamweaverFile()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cr&eacute;e un nouveau fichier Dreamweaver dans le panneau Site (dans le m&ecirc;me dossier que le premier
fichier ou dossier s&eacute;lectionn&eacute;).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canMakeNewFileOrFolder(), page 456.
site.makeNewFolder()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cr&eacute;e un nouveau dossier dans le panneau Site (dans le m&ecirc;me dossier que le premier fichier ou
dossier s&eacute;lectionn&eacute;).
Arguments
Aucun.
238
Chapitre 13 : Site
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canMakeNewFileOrFolder(), page 456.
site.newHomePage()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Nouvelle page d’accueil pour permettre &agrave; l’utilisateur de cr&eacute;er une
nouvelle page d’accueil.
Remarque : Cette fonction agit seulement sur les fichiers de l’affichage Carte du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.newSite()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue D&eacute;finition du site pour d&eacute;finir un nouveau site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.open()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre les fichiers actuellement s&eacute;lectionn&eacute;s dans le panneau Site. Si des dossiers sont s&eacute;lectionn&eacute;s,
ils sont d&eacute;velopp&eacute;s dans l’affichage Fichiers du site.
Arguments
Aucun.
Fonctions relatives aux sites
239
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canOpen(), page 457.
site.put()
Disponibilit&eacute;
Dreamweaver 3.
Description
Place les fichiers sp&eacute;cifi&eacute;s et traite les fichiers d&eacute;pendants comme suit :
• Si l’utilisateur a activ&eacute; l’option Invite lors de Placer/Archiver dans les pr&eacute;f&eacute;rences, cat&eacute;gorie
•
•
FTP du site, la bo&icirc;te de dialogue Fichiers d&eacute;pendants s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Oui, les fichiers d&eacute;pendants sont t&eacute;l&eacute;charg&eacute;s et aucune bo&icirc;te
de dialogue ne s’affiche.
Si l’utilisateur a activ&eacute; l’option Ne plus afficher ce message dans la bo&icirc;te de dialogue Fichiers
d&eacute;pendants, puis qu’il a cliqu&eacute; sur Non, les fichiers d&eacute;pendants ne sont pas t&eacute;l&eacute;charg&eacute;s et
aucune bo&icirc;te de dialogue ne s’affiche.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; &quot;site&quot;, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canPut(), page 457.
site.recreateCache()
Disponibilit&eacute;
Dreamweaver 3.
Description
Recr&eacute;e le cache du site en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
240
Chapitre 13 : Site
Activateur
site.canRecreateCache(), page 458.
site.refresh()
Disponibilit&eacute;
Dreamweaver 3.
Description
Actualise la liste des fichiers sur le c&ocirc;t&eacute; sp&eacute;cifi&eacute; du panneau Site.
Arguments
whichSide
• L’argument whichSide doit avoir pour valeur &quot;local&quot; ou &quot;remote&quot;. Si la carte du site est
active et que whichSide a pour valeur &quot;local&quot;, la carte du site est actualis&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canRefresh(), page 458.
site.remoteIsValid()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si le site distant est valide.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si un site distant a &eacute;t&eacute; d&eacute;fini et, dans le cas o&ugrave; le type de serveur est
Local/R&eacute;seau, si le lecteur est mont&eacute;.
site.removeLink()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime le lien s&eacute;lectionn&eacute; du document situ&eacute; au-dessus de lui dans la carte du site.
Arguments
Aucun.
Fonctions relatives aux sites
241
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canRemoveLink(), page 458.
site.renameSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Transforme le nom du fichier s&eacute;lectionn&eacute; en champ de texte et permet &agrave; l’utilisateur de renommer
le fichier. Si plusieurs fichiers sont s&eacute;lectionn&eacute;s, cette fonction agit sur le dernier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.runValidation()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ex&eacute;cute le validateur sur la totalit&eacute; du site ou uniquement sur les &eacute;l&eacute;ments mis en surbrillance.
Arguments
selection
• L’argument selection est le param&egrave;tre qui sp&eacute;cifie que le validateur doit v&eacute;rifier les &eacute;l&eacute;ments
mis en surbrillance uniquement ; dans le cas contraire, le validateur v&eacute;rifie l’ensemble du site
en cours.
Valeurs renvoy&eacute;es
Aucune.
site.saveAsImage()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Enregistrer sous pour permettre &agrave; l’utilisateur d’enregistrer la carte du
site sous forme d’image.
242
Chapitre 13 : Site
Arguments
fileType
• L’argument fileType correspond au type d’image &agrave; enregistrer. Pour Windows, les valeurs
autoris&eacute;es sont &quot;bmp&quot; et &quot;png&quot;, et pour Macintosh &quot;pict&quot; et &quot;jpeg&quot;. Si cet argument n’est pas
d&eacute;fini ou que sa valeur n’est pas valide sur la plate-forme en cours, il prend par d&eacute;faut la valeur
&quot;bmp&quot; pour Windows et &quot;pict&quot; pour Macintosh.
Valeurs renvoy&eacute;es
Aucune.
site.selectAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne tous les fichiers de l’affichage actif (&agrave; savoir soit la carte du site, soit les fichiers de site).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.selectHomePage()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue d’ouverture de fichier pour permettre &agrave; l’utilisateur de s&eacute;lectionner une
nouvelle page d’accueil.
Remarque : Cette fonction agit seulement sur les fichiers de l’affichage Carte du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.selectNewer()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne tous les fichiers les plus r&eacute;cents sur le c&ocirc;t&eacute; sp&eacute;cifi&eacute; du panneau Site.
Fonctions relatives aux sites
243
Arguments
whichSide
• L’argument whichSide doit avoir pour valeur &quot;local&quot; ou &quot;remote&quot;.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canSelectNewer(), page 459.
site.setAsHomePage()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;signe le fichier s&eacute;lectionn&eacute; dans l’affichage Fichiers du site comme &eacute;tant la page d’accueil du
site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
site.setCloakingEnabled()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine s’il est n&eacute;cessaire d’activer le voilage pour le site en cours.
Arguments
enable
• L’argument enable est une valeur bool&eacute;enne qui indique s’il est n&eacute;cessaire d’activer le voilage.
Une valeur true active le voilage pour le site en cours ; une valeur false d&eacute;sactive le voilage
pour le site en cours.
Valeurs renvoy&eacute;es
Aucun.
site.setConnectionState()
Disponibilit&eacute;
Dreamweaver 3.
244
Chapitre 13 : Site
Description
D&eacute;finit l’&eacute;tat de connexion du site en cours.
Arguments
bConnected
• L’argument bConnected est une valeur bool&eacute;enne qui indique s’il existe une connexion (true)
ou non (false) au site en cours.
Valeurs renvoy&eacute;es
Aucune.
site.setCurrentSite()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre le site sp&eacute;cifi&eacute; dans le volet local du panneau Site.
Arguments
whichSite
• L’argument whichSite est le nom d’un site d&eacute;fini (tel qu’il appara&icirc;t dans la liste des sites en
cours, dans le panneau Site ou dans la bo&icirc;te de dialogue Modifier les sites).
Valeurs renvoy&eacute;es
Aucune.
Exemple
Si trois sites sont d&eacute;finis (avocado8, dreamcentral et testsite, par exemple), un appel &agrave; la fonction
site.setCurrentSite(&quot;dreamcentral&quot;) fait de dreamcentral le site en cours.
site.setFocus()
Disponibilit&eacute;
Dreamweaver 3.
Description
Active le volet sp&eacute;cifi&eacute; du panneau Site. Si le volet sp&eacute;cifi&eacute; n’est pas affich&eacute;, la fonction l’affiche et
l’active.
Arguments
whichPane
• L’argument whichPane doit correspondre &agrave; l’une des cha&icirc;nes suivantes : &quot;local&quot;, &quot;remote&quot;
ou &quot;site map&quot;.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux sites
245
site.setLayout()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre le volet Mise en forme de la carte du site dans la bo&icirc;te de dialogue D&eacute;finition du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canSetLayout(), page 459.
site.setLinkVisibility()
Disponibilit&eacute;
Dreamweaver 3.
Description
Affiche ou masque le lien en cours.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;enne qui indique si le lien en cours ne doit plus &ecirc;tre
identifi&eacute; comme masqu&eacute;.
Valeurs renvoy&eacute;es
Aucune.
site.setSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne les fichiers ou les dossiers visibles dans le volet actif du panneau Site.
Arguments
arrayOfURLs
• L’argument arrayOfURLs est un tableau de cha&icirc;nes correspondant aux chemins d’acc&egrave;s aux
fichiers et aux dossiers du site s&eacute;lectionn&eacute;, exprim&eacute;s sous la forme d’une URL de type file://.
Remarque : Pour les chemins de dossier, ne tapez pas la barre oblique (/) &agrave; la fin du chemin.
246
Chapitre 13 : Site
Valeurs renvoy&eacute;es
Aucune.
site.synchronize()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Synchroniser les fichiers.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canSynchronize(), page 460.
site.uncloak()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;voile la s&eacute;lection dans le panneau Site ou le dossier sp&eacute;cifi&eacute;.
Arguments
siteOrURL
• L’argument siteOrURL doit contenir l’une des valeurs suivantes :
■
■
le mot-cl&eacute; &quot;site&quot;, qui indique que la fonction unCloak() doit agir sur la s&eacute;lection dans le
panneau Site ;
l’URL d’un dossier particulier, qui indique que la fonction unCloak() doit agir sur le
dossier sp&eacute;cifi&eacute; et tout son contenu.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canUncloak(), page 460.
Fonctions relatives aux sites
247
site.uncloakAll()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;voile tous les dossiers dans le site s&eacute;lectionn&eacute; et d&eacute;sactive la case &agrave; cocher Voiler les fichiers se
terminant avec : dans les Param&egrave;tres de voilage.
Arguments
Aucune.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canUncloak(), page 460.
site.undoCheckOut()
Disponibilit&eacute;
Dreamweaver 3.
Description
Retire des sites locaux et distants les fichiers verrouill&eacute;s associ&eacute;s aux fichiers s&eacute;lectionn&eacute;s et
remplace leur copie locale par la copie distante.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; &quot;site&quot;, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canUndoCheckOut(), page 461.
site.viewAsRoot()
Disponibilit&eacute;
Dreamweaver 3.
Description
Place provisoirement le fichier s&eacute;lectionn&eacute; en premi&egrave;re position sur la carte du site.
Arguments
Aucun.
248
Chapitre 13 : Site
Valeurs renvoy&eacute;es
Aucune.
Activateur
site.canViewAsRoot(), page 461.
Fonctions relatives aux sites
249
250
Chapitre 13 : Site
CHAPITRE 14
Document
Les fonctions Document de Macromedia Dreamweaver MX 2004 permettent d’effectuer des
op&eacute;rations dans le document modifi&eacute; par l’utilisateur. Ces fonctions permettent notamment de
convertir les tableaux en calques, d’ex&eacute;cuter une commande du dossier Configuration/
Commands, de rechercher l’URL d’un fichier, de v&eacute;rifier l’orthographe ou de d&eacute;finir les
propri&eacute;t&eacute;s d’une page, de convertir une URL relative en URL absolue, d’obtenir le nœud parent
s&eacute;lectionn&eacute;, d’effectuer l’encodage URL d’une cha&icirc;ne ou d’ex&eacute;cuter 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&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Convertir les calques en tableau.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canConvertLayersToTable(), page 431.
dom.convertTablesToLayers()
Disponibilit&eacute;
Dreamweaver 3.
251
Description
Ouvre la bo&icirc;te de dialogue Convertir les tableaux en calques.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canConvertTablesToLayers(), page 431.
Fonctions relatives aux commandes
Ces fonctions permettent d’exploiter au mieux les fichiers figurant dans le dossier Configuration/
Commands. Elles permettent de g&eacute;rer le menu Commandes et d’appeler des commandes &agrave; partir
d’autres types de fichiers d’extension.
dreamweaver.editCommandList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Modifier la liste de commandes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.popupCommand() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 2, d&eacute;conseill&eacute;e depuis la version 3 : utiliser &agrave; la place dreamweaver.runCommand().
Description
Cette fonction ex&eacute;cute la commande sp&eacute;cifi&eacute;e. Pour l’utilisateur, cela revient &agrave; choisir la
commande dans un menu ; si une bo&icirc;te de dialogue est associ&eacute;e &agrave; la commande, elle s’affiche.
Cette fonction permet d’appeler une commande &agrave; partir d’un autre fichier d’extension.
L’utilisateur ne peut effectuer aucune autre modification tant qu’il n’a pas ferm&eacute; la bo&icirc;te de
dialogue.
Remarque : Cette fonction peut &ecirc;tre appel&eacute;e &agrave; partir de la fonction objectTag(), d’un script de fichier
de commande ou du fichier d’inspecteur de propri&eacute;t&eacute;s.
Arguments
commandFile
252
Chapitre 14 : Document
• L’argument commandFile correspond au nom d’un fichier de commandes du dossier
Configuration/Commands (&quot;Format Table.htm&quot;, par exemple).
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.runCommand()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ex&eacute;cute la commande sp&eacute;cifi&eacute;e ; cette fonction &eacute;quivaut &agrave; choisir la commande dans un menu. Si
une bo&icirc;te de dialogue est associ&eacute;e &agrave; la commande, elle appara&icirc;t et le script de la commande bloque
les autres modifications jusqu’&agrave; ce que l’utilisateur ferme la bo&icirc;te de dialogue. Cette fonction
permet d’appeler une commande &agrave; partir d’un autre fichier d’extension.
Remarque : Cette fonction peut &ecirc;tre appel&eacute;e &agrave; partir de la fonction objectTag(), d’un script de fichier
de commande ou du fichier d’inspecteur de propri&eacute;t&eacute;s.
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 &agrave; la
fonction receiveArguments() dans l’argument commandFile.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Vous pouvez cr&eacute;er un inspecteur de propri&eacute;t&eacute;s personnalis&eacute; pour les tableaux. Il permettra &agrave;
l’utilisateur d’acc&eacute;der &agrave; la commande Formater le tableau &agrave; l’aide d’un bouton de l’inspecteur.
Pour ce faire, appelez la fonction suivante &agrave; partir du gestionnaire d’&eacute;v&eacute;nements onClick de ce
bouton :
function callFormatTable(){
dreamweaver.runCommand(’Format Table.htm’);
}
Fonctions relatives aux manipulations de fichiers
Ces fonctions permettent de cr&eacute;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 &eacute;galement de rechercher des fichiers ou des
dossiers, de cr&eacute;er des fichiers &agrave; partir de mod&egrave;les, de fermer des documents et d’obtenir la liste des
fichiers r&eacute;cemment ouverts.
Fonctions relatives aux manipulations de fichiers
253
dom.cleanupXHTML()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction est similaire &agrave; la fonction convertToXHTML(), &agrave; ceci pr&egrave;s que celle-ci nettoie un
document XHTML existant. Cette fonction peut &ecirc;tre ex&eacute;cut&eacute;e sur une s&eacute;lection &agrave; l’int&eacute;rieur du
document. Vous pouvez utiliser la fonction cleanupXHTML() pour nettoyer la syntaxe dans
l’ensemble d’un document XHTML ou dans la s&eacute;lection en cours &agrave; l’int&eacute;rieur du document.
Arguments
bWholeDoc
• L’argument bWholeDoc contient une valeur bool&eacute;enne. Si la valeur est true, la fonction
cleanupXHTML() nettoie l’ensemble du document ; dans le cas contraire, elle nettoie
uniquement la s&eacute;lection.
Valeurs renvoy&eacute;es
Un tableau de six nombres entiers qui quantifient le nombre d’&eacute;l&eacute;ments suivants :
•
•
•
•
•
•
Erreurs XHTML r&eacute;par&eacute;es par Dreamweaver
&Eacute;l&eacute;ments map ne disposant pas d’un attribut id et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments script ne disposant pas d’un attribut type et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments style ne disposant pas d’un attribut type et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments img ne disposant pas d’un attribut alt et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments area ne disposant pas d’un attribut alt et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
dom.convertToXHTML()
Disponibilit&eacute;
Dreamweaver MX.
Description
Analyse le code HTML dans une arborescence DOM, ins&egrave;re les &eacute;l&eacute;ments manquants qui sont
obligatoires pour XHTML, nettoie l’arborescence puis &eacute;crit celle-ci au format XHTML. Les
directives, d&eacute;clarations, &eacute;l&eacute;ments et attributs manquants que la fonction convertToXHTML()
ajoute &agrave; l’arborescence DOM si n&eacute;cessaire, incluent les &eacute;l&eacute;ments suivants :
•
•
•
•
•
•
254
Une directive XML
Une d&eacute;claration doctype
L’attribut xmlns dans l’&eacute;l&eacute;ment html
Une section head
Un &eacute;l&eacute;ment title
Une section body
Chapitre 14 : Document
Pendant la conversion, la fonction dom.convertToXHTML() convertit les balises et les
attributs HTML purs en minuscules, &eacute;crit des balises et des attributs HTML &agrave; l’aide d’une
syntaxe XHTML correcte et ajoute des attributs HTML manquants o&ugrave; elle le peut. Cette
fonction traite les balises et les attributs tiers en fonction des param&egrave;tres de la bo&icirc;te de dialogue
Param&egrave;tres.
Si le document est un mod&egrave;le, la fonction dom.convertToXHTML() alerte l’utilisateur mais
n’effectue pas la conversion.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un tableau de six nombres entiers qui quantifient les &eacute;l&eacute;ments suivants :
•
•
•
•
•
•
Erreurs XHTML r&eacute;par&eacute;es par Dreamweaver
&Eacute;l&eacute;ments map ne disposant pas d’un attribut id et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments script ne disposant pas d’un attribut type et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments style ne disposant pas d’un attribut type et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments img ne disposant pas d’un attribut alt et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
&Eacute;l&eacute;ments area ne disposant pas d’un attribut alt et ne pouvant pas &ecirc;tre r&eacute;par&eacute;s
Exemple
Dans le cadre d’une utilisation normale, une extension appelle d’abord la fonction
dreamweaver.openDocument() ou dreamweaver.getDocumentDOM() pour obtenir une
r&eacute;f&eacute;rence au document. L’extension appelle ensuite la fonction dom.getIsXHTMLDocument()
pour d&eacute;terminer si le document est d&eacute;j&agrave; 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&eacute;
Dreamweaver MX.
Description
V&eacute;rifie un document (en particulier la d&eacute;claration &lt;!DOCTYPE&gt;) pour savoir si celui-ci est au
format XHTML.
Arguments
Aucun.
Valeurs renvoy&eacute;es
true
si le document est au format XHTML ; false dans le cas contraire.
Fonctions relatives aux manipulations de fichiers
255
dreamweaver.browseForFileURL()
Disponibilit&eacute;
Dreamweaver 1, am&eacute;lior&eacute;e dans les versions 2, 3 et 4.
Description
Ouvre le type de bo&icirc;te de dialogue sp&eacute;cifi&eacute; ayant le libell&eacute; sp&eacute;cifi&eacute; dans la barre de titre.
Arguments
openSelectOrSave, {titleBarLabel}, {bShowPreviewPane},
{bSupressSiteRootWarnings}, {arrayOfExtensions}
&not;
• L’argument openSelectOrSave indique le type de bo&icirc;te de dialogue : &quot;open&quot;, &quot;select&quot; ou
•
•
•
•
&quot;save&quot;.
L’argument titleBarLabel, ajout&eacute; &agrave; Dreamweaver 2, est le libell&eacute; qui doit figurer dans la
barre de titre de la bo&icirc;te de dialogue. Si cet argument n’est pas d&eacute;fini, Dreamweaver utilise par
d&eacute;faut le libell&eacute; fourni par le syst&egrave;me d’exploitation.
L’argument bShowPreviewPane, ajout&eacute; &agrave; Dreamweaver 2, est une valeur bool&eacute;enne indiquant
si le volet d’aper&ccedil;u de l’image doit &ecirc;tre affich&eacute; dans la bo&icirc;te de dialogue. Si l’argument a pour
valeur true, la bo&icirc;te de dialogue filtre les fichiers d’image ; s’il n’est pas d&eacute;fini, il prend par
d&eacute;faut la valeur false.
L’argument bSupressSiteRootWarnings, ajout&eacute; &agrave; Dreamweaver 3, est une valeur bool&eacute;enne
indiquant s’il faut supprimer les avertissements signalant que le fichier s&eacute;lectionn&eacute; se trouve
hors du dossier racine du site. Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur
false.
L’argument arrayOfExtensions, ajout&eacute; &agrave; Dreamweaver 4, est un tableau de cha&icirc;nes qui
sp&eacute;cifie le contenu par d&eacute;faut du menu d&eacute;roulant Type au bas de la bo&icirc;te de dialogue. La
syntaxe correcte est menuEntryText|.xxx[;.yyy;.zzz]|CCCC| o&ugrave; menuEntryText est le
nom du type de fichier qui s’affiche. Les extensions peuvent &ecirc;tre sp&eacute;cifi&eacute;es sous la forme
.xxx[;.yyy;.zzz] ou CCCC o&ugrave; .xxx d&eacute;finit l’extension du type de fichier (.yyy et .zzz
peuvent &eacute;galement sp&eacute;cifier des extensions de fichier multiples) et CCCC est la constante du type
de fichier &agrave; quatre caract&egrave;res utilis&eacute;e sur Macintosh.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le nom du fichier, exprim&eacute; sous la forme d’une URL de type file://.
dreamweaver.browseForFolderURL()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Choisir un dossier ayant le libell&eacute; sp&eacute;cifi&eacute; dans la barre de titre.
Arguments
{titleBarLabel}, {directoryToStartIn}
256
Chapitre 14 : Document
• L’argument titleBarLabel est le libell&eacute; qui doit s’afficher dans la barre de titre de la bo&icirc;te de
•
dialogue. S’il n’est pas sp&eacute;cifi&eacute;, l’argument titleBarLabel prend par d&eacute;faut la valeur &laquo; Choose
Folder &raquo;.
L’argument directoryToStartIn est le chemin indiquant o&ugrave; le dossier doit s’ouvrir, exprim&eacute;
sous la forme d’une URL de type file://.
Valeurs renvoy&eacute;es
Une cha&icirc;ne contenant le nom du dossier, exprim&eacute; sous la forme d’une URL de type file://.
Exemple
Le code suivant renvoie l’URL d’un dossier :
return dreamweaver.browseForFolderURL(’Select a Folder’, &not;
dreamweaver.getSiteRoot());
dreamweaver.closeDocument()
Disponibilit&eacute;
Dreamweaver 2.
Description
Ferme le document sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
Si l’argument documentObject fait r&eacute;f&eacute;rence au document actif, il se peut que la fen&ecirc;tre du
document ne se ferme pas tant que l’ex&eacute;cution du script qui appelle cette fonction n’est pas
termin&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.createDocument()
Disponibilit&eacute;
Dreamweaver 2, am&eacute;lior&eacute;e dans la version 4.
Description
En fonction de l’argument utilis&eacute;, cette fonction ouvre un nouveau document soit dans la m&ecirc;me
fen&ecirc;tre, soit dans une nouvelle fen&ecirc;tre. Le nouveau document devient le document actif.
Remarque : Cette fonction peut &ecirc;tre appel&eacute;e uniquement &agrave; partir du fichier menus.xml ou d’un fichier
de commande ou d’inspecteur de propri&eacute;t&eacute;s. Si une action ou un objet tente d’appeler cette fonction,
Dreamweaver affiche un message d’erreur.
Arguments
{bOpenInSameWindow}, {type}
Fonctions relatives aux manipulations de fichiers
257
• L’argument bOpenInSameWindow est une valeur bool&eacute;enne indiquant si le nouveau document
•
doit s’ouvrir dans la fen&ecirc;tre en cours. Si l’argument bOpenInSameWindow a pour valeur false,
qu’il n’est pas pr&eacute;cis&eacute; ou que la fonction est appel&eacute;e sur Macintosh, le nouveau document
s’ouvre dans une nouvelle fen&ecirc;tre.
L’argument type indique le type de document &agrave; cr&eacute;er, conform&eacute;ment &agrave; ce qui a &eacute;t&eacute; d&eacute;clar&eacute;
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
&quot;HTML&quot;, &quot;ASP-JS&quot;, &quot;ASP-VB&quot;, &quot;ColdFusion&quot;, &quot;CFC&quot;, &quot;JSP&quot;, &quot;ASP.NET_VB&quot;, ou toute
valeur similaire. Pour obtenir la liste compl&egrave;te des types disponibles, voir le fichier
MMDocumentTypes.xml. Si vous ne d&eacute;finissez pas l’argument type, il adopte la valeur
&quot;HTML&quot;.
Remarque : Vous pouvez &eacute;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&eacute;es
Objet document correspondant au nouveau document cr&eacute;&eacute;. Il s’agit de la valeur renvoy&eacute;e par la
fonction dreamweaver.getDocumentDOM().
dreamweaver.createXHTMLDocument()
Disponibilit&eacute;
Dreamweaver MX.
Description
En fonction de l’argument utilis&eacute;, cette fonction ouvre un nouveau document XHTML soit dans
la m&ecirc;me fen&ecirc;tre, soit dans une nouvelle fen&ecirc;tre. Le nouveau document devient le document actif.
Cette fonction est similaire &agrave; la fonction dreamweaver.createDocument().
Lorsque Dreamweaver cr&eacute;e un nouveau document XHTML, il lit un fichier nomm&eacute;
default.xhtml, qui se trouve dans le dossier Configuration/Templates, et, en utilisant le contenu
de ce fichier, il cr&eacute;e un fichier de sortie contenant les d&eacute;clarations suivantes :
&lt;?xml version=&quot;1.0&quot;&gt;
&lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD XHTML 1.0 Transitional//EN&quot;
&quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&quot;&gt;
&lt;html xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt;
&lt;head&gt;
&lt;title&gt;Untitled Document&lt;/title&gt;
&lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html; charset=&quot; /&gt;
&lt;/head&gt;
&lt;body bgcolor=&quot;#FFFFFF&quot; text=&quot;#000000&quot;&gt;
&lt;/body&gt;
&lt;/html&gt;
258
Chapitre 14 : Document
La d&eacute;claration DTD par d&eacute;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&egrave;res UTF-8 ou UTF-16 ; si elle est pr&eacute;sente,
elle peut &ecirc;tre restitu&eacute;e par d’autres navigateurs de version ant&eacute;rieure. Cependant, &eacute;tant donn&eacute; que
cette directive doit se trouver dans un document XHTML, Dreamweaver l’utilise par d&eacute;faut (&agrave; 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 &agrave; charset dans l’attribut
Content-Type.
Arguments
{bOpenInSameWindow}
• L’argument bOpenInSameWindow est une valeur bool&eacute;enne indiquant si le nouveau document
doit s’ouvrir dans la fen&ecirc;tre en cours. Si cet argument a pour valeur false, qu’il n’est pas
pr&eacute;cis&eacute; ou que la fonction est appel&eacute;e sur Macintosh, le nouveau document s’ouvre dans une
nouvelle fen&ecirc;tre.
Valeurs renvoy&eacute;es
L’objet document correspondant au document nouvellement cr&eacute;&eacute; (m&ecirc;me valeur que celle
renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
dreamweaver.createXMLDocument()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cr&eacute;e et ouvre un nouveau fichier XML contenant uniquement la directive XML.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Le DOM du nouveau fichier XML.
Exemple
L’exemple suivant cr&eacute;e un nouveau document, contenant uniquement la directive XML :
var theDOM = dreamweaver.createXMLDocument(&quot;document&quot;);
dreamweaver.exportCSS()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Exporter les styles dans un fichier CSS.
Fonctions relatives aux manipulations de fichiers
259
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canExportCSS(), page 441.
dreamweaver.exportEditableRegionsAsXML() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3, d&eacute;conseill&eacute;e depuis MX.
Description
Cette fonction ouvre la bo&icirc;te de dialogue Exporter les r&eacute;gions modifiables sous XML.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.exportTemplateDataAsXML()
Disponibilit&eacute;
Dreamweaver MX.
Description
Exporte le document actif dans le fichier indiqu&eacute;, et ce au format XML. Cette fonction agit sur le
document actif, qui doit &ecirc;tre un mod&egrave;le. Si vous ne sp&eacute;cifiez pas un argument de nom de fichier,
DreamweaverMX ouvre une bo&icirc;te de dialogue pour demander la cha&icirc;ne du fichier d’exportation.
Arguments
{filePath}
• L’argument filePath (facultatif ) est une cha&icirc;ne sp&eacute;cifiant le nom du fichier vers lequel
Dreamweaver exporte le mod&egrave;le. Exprimez l’argument filePath sous forme d’une URL de
type &quot;file:///c|/temp/mydata.txt&quot;.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canExportTemplateDataAsXML(), page 441.
260
Chapitre 14 : Document
Exemple
if(dreamweaver.canExportTemplateDataAsXML())
{
dreamweaver.exportTemplateDataAsXML(&quot;file:///c|/dw_temps/mytemplate.txt&quot;)
}
dreamweaver.getDocumentDOM()
Disponibilit&eacute;
Dreamweaver 2.
Description
Permet d’acc&eacute;der &agrave; l’arborescence des objets du document sp&eacute;cifi&eacute;. Une fois celle-ci renvoy&eacute;e &agrave;
l’appelant, ce dernier peut la modifier pour changer le contenu du document.
Arguments
{sourceDoc}
• L’argument sourceDoc doit &ecirc;tre &quot;document&quot;, &quot;parent&quot;, &quot;parent.frames[number]&quot;,
&quot;parent.frames[’frameName’]&quot; ou une URL. L’argument sourceDoc prend par d&eacute;faut la
valeur &quot;document&quot; si vous ne fournissez pas de valeur. Ces valeurs sont expliqu&eacute;es ci-dessous
■
■
■
■
:
La valeur document d&eacute;signe le document actif contenant la s&eacute;lection en cours.
La valeur parent d&eacute;signe le jeu de cadres parent (si le document s&eacute;lectionn&eacute; se trouve dans
un cadre).
Les valeurs parent.frames[number] et parent.frames[’frameName’] d&eacute;signent un
document figurant dans un cadre sp&eacute;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 &quot;document&quot;, l’appelant doit &ecirc;tre la fonction
applyBehavior(), deleteBehavior(), objectTag() ou toute fonction d’un fichier de commande
ou d’inspecteur de propri&eacute;t&eacute;s pouvant modifier le document.
Valeurs renvoy&eacute;es
Objet document JavaScript &agrave; la racine de l’arborescence.
Exemples
L’exemple suivant utilise la fonction dreamweaver.getDocumentDOM() pour acc&eacute;der au
document actif :
var theDOM = dreamweaver.getDocumentDOM(&quot;document&quot;);
Dans l’exemple suivant, le document DOM actif identifie une s&eacute;lection et la colle &agrave; la fin d’un
autre document :
var currentDOM = dreamweaver.getDocumentDOM(’document’);
currentDOM.setSelection(100,200);
currentDOM.clipCopy();
var otherDOM = dreamweaver.openDocument(dreamweaver.&not;
getSiteRoot() + &quot;html/foo.htm&quot;);
otherDOM.endOfDocument();
otherDOM.clipPaste();
Fonctions relatives aux manipulations de fichiers
261
Remarque : L’argument openDocument() est utilis&eacute; car les m&eacute;thodes de l’objet DOM agissent en
principe uniquement sur les documents ouverts. L’ex&eacute;cution d’une fonction sur un document qui
n’est pas ouvert entra&icirc;ne une erreur de Dreamweaver. Lorsqu’une m&eacute;thode de l’objet DOM ne peut
&ecirc;tre appliqu&eacute;e qu’au document actif ou &agrave; des documents ferm&eacute;s, cette caract&eacute;ristique est indiqu&eacute;e
dans sa description.
dreamweaver.getNewDocumentDOM()
Disponibilit&eacute;
Dreamweaver MX.
Description
Permet d’acc&eacute;der &agrave; l’arborescence modifiable d’un nouveau document vide. Cette fonction est
similaire &agrave; la fonction getDocumentDOM(), &agrave; ceci pr&egrave;s qu’elle pointe vers un nouveau document
plut&ocirc;t que vers un document existant et qu’elle n’ouvre pas le document.
Arguments
Aucun.
Valeurs renvoy&eacute;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&eacute;
Dreamweaver 3.
Description
Obtient la liste de tous les fichiers r&eacute;cemment ouverts et r&eacute;pertori&eacute;s au bas du menu Fichier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un tableau de cha&icirc;nes repr&eacute;sentant les chemins des derniers fichiers ouverts, exprim&eacute;s sous la
forme d’une URL de type file://. Si aucun fichier n’a &eacute;t&eacute; ouvert r&eacute;cemment, la fonction ne renvoie
aucune valeur.
262
Chapitre 14 : Document
dreamweaver.importXMLIntoTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
Importe un fichier de texte XML dans le mod&egrave;le de document actif. Cette fonction agit sur le
document actif, qui doit &ecirc;tre un mod&egrave;le. Si vous ne sp&eacute;cifiez pas un argument de nom de fichier,
Dreamweaver ouvre une bo&icirc;te de dialogue pour demander la cha&icirc;ne du fichier d’importation.
Arguments
{filePath}
• L’argument filePath (facultatif ) est une cha&icirc;ne sp&eacute;cifiant le nom du fichier vers lequel
Dreamweaver exporte le mod&egrave;le. Exprimez l’argument filePath sous forme d’une URL de
type &quot;file:///c|/temp/mydata.txt&quot;.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.newDocument()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ouvre un document dans le site en cours et affiche la bo&icirc;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&icirc;te de
dialogue Nouveau document, sp&eacute;cifiez true ; sinon, sp&eacute;cifiez false.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.newFromTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cr&eacute;e un nouveau document &agrave; partir du mod&egrave;le sp&eacute;cifi&eacute;. Si vous ne sp&eacute;cifiez aucun argument, la
bo&icirc;te de dialogue S&eacute;lectionner le mod&egrave;le s’affiche.
Fonctions relatives aux manipulations de fichiers
263
Arguments
{templateURL}, bMaintain
• L’argument templateURL est le chemin d’un mod&egrave;le disponible sur le site en cours, exprim&eacute;
sous la forme d’une URL de type file://.
• L’argument bMaintain est une valeur bool&eacute;enne, pouvant &ecirc;tre true ou false, indiquant si le
lien vers le mod&egrave;le d’origine doit &ecirc;tre conserv&eacute; ou pas.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.openDocument()
Disponibilit&eacute;
Dreamweaver 2.
Description
Ouvre un document &agrave; modifier dans une nouvelle fen&ecirc;tre Dreamweaver et en fait le document
actif. Pour l’utilisateur, cela revient &agrave; choisir Fichier &gt; Ouvrir et &agrave; s&eacute;lectionner un fichier. Si le
fichier sp&eacute;cifi&eacute; est d&eacute;j&agrave; ouvert, la fen&ecirc;tre correspondante s’affiche au premier plan. La fen&ecirc;tre
contenant le fichier sp&eacute;cifi&eacute; devient la fen&ecirc;tre active et le fichier s&eacute;lectionn&eacute; devient le document
actif. Dans Dreamweaver 2, si la fonction d’archivage/extraction est activ&eacute;e, le fichier est extrait
avant d’&ecirc;tre ouvert. Dans Dreamweaver 3 et ses versions ult&eacute;rieures, vous devez utiliser la fonction
dreamweaver.openDocumentFromSite() pour obtenir ce comportement.
Remarque : Cette fonction provoque une erreur si elle est appel&eacute;e &agrave; partir d’un fichier d’objet ou
d’action de comportement.
Arguments
fileName
• L’argument fileName est le nom du fichier &agrave; ouvrir, exprim&eacute; sous forme d’une URL absolue.
S’il s’agit d’une URL relative, elle est relative au fichier contenant le script ayant appel&eacute; cette
fonction.
Valeurs renvoy&eacute;es
L’objet document correspondant au fichier sp&eacute;cifi&eacute;, soit la m&ecirc;me valeur renvoy&eacute;e par la fonction
dreamweaver.getDocumentDOM().
dreamweaver.openDocumentFromSite()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre un document &agrave; modifier dans une nouvelle fen&ecirc;tre Dreamweaver et en fait le document
actif. Pour l’utilisateur, cela revient &agrave; double-cliquer sur un fichier dans le panneau Site. Si le
fichier sp&eacute;cifi&eacute; est d&eacute;j&agrave; ouvert, la fen&ecirc;tre correspondante s’affiche au premier plan. La fen&ecirc;tre
contenant le fichier sp&eacute;cifi&eacute; devient la fen&ecirc;tre active et le fichier s&eacute;lectionn&eacute; devient le document
actif.
264
Chapitre 14 : Document
Remarque : Cette fonction ne peut pas &ecirc;tre appel&eacute;e &agrave; partir d’un fichier d’objet ou d’action de
comportement sous peine de g&eacute;n&eacute;rer des erreurs.
Arguments
fileName
• L’argument fileName est le fichier &agrave; ouvrir, exprim&eacute; sous forme d’une URL absolue. S’il s’agit
d’une URL relative, elle est relative au fichier contenant le script ayant appel&eacute; cette fonction.
Valeurs renvoy&eacute;es
L’objet document correspondant au fichier sp&eacute;cifi&eacute;, soit la m&ecirc;me valeur renvoy&eacute;e par la fonction
dreamweaver.getDocumentDOM().
dreamweaver.openInFrame()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Ouvrir dans un cadre. Lorsque l’utilisateur s&eacute;lectionne un document,
celui-ci s’ouvre dans le cadre actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canOpenInFrame(), page 442.
dreamweaver.releaseDocument()
Disponibilit&eacute;
Dreamweaver 2.
Description
Lib&egrave;re explicitement de la m&eacute;moire un document pr&eacute;c&eacute;demment r&eacute;f&eacute;renc&eacute;.
Les documents r&eacute;f&eacute;renc&eacute;s par les fonctions dreamweaver.getObjectTags(),
dreamweaver.getObjectRefs(), dreamweaver.getDocumentPath() et
dreamweaver.getDocumentDOM() sont automatiquement lib&eacute;r&eacute;s au terme de l’ex&eacute;cution du
script contenant l’appel. Si le script ouvre un nombre important de documents, vous devez utiliser
cette fonction pour en lib&eacute;rer certains explicitement avant la fin de l’ex&eacute;cution du script, ceci afin
d’&eacute;viter de saturer la m&eacute;moire.
Remarque : Cette fonction ne s’applique qu’aux documents r&eacute;f&eacute;renc&eacute;s par une URL, qui ne sont pas
ouverts dans un cadre ou dans une fen&ecirc;tre de document et qui ne correspondent pas &agrave; des fichiers
d’extension (les fichiers d’extensions externes sont charg&eacute;s en m&eacute;moire au d&eacute;marrage et n’en sont
lib&eacute;r&eacute;s que lorsque vous quittez Dreamweaver).
Fonctions relatives aux manipulations de fichiers
265
Arguments
documentObject.
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.revertDocument()
Disponibilit&eacute;
Dreamweaver 3.
Description
R&eacute;tablit la version pr&eacute;c&eacute;demment enregistr&eacute;e du fichier sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canRevertDocument(), page 443.
dreamweaver.saveAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
Enregistre tous les documents ouverts et ouvre la bo&icirc;te de dialogue Enregistrer sous pour tous
ceux qui n’ont pas encore &eacute;t&eacute; enregistr&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canSaveAll(), page 444.
266
Chapitre 14 : Document
dreamweaver.saveDocument()
Disponibilit&eacute;
Dreamweaver 2.
Description
Enregistre le fichier sp&eacute;cifi&eacute; sur un ordinateur local.
Remarque : Dans Dreamweaver 2, si le fichier est accessible en lecture seule, Dreamweaver tente
de l’extraire. Si le document reste en lecture seule apr&egrave;s cette tentative ou qu’il ne peut pas &ecirc;tre cr&eacute;&eacute;,
un message d’erreur s’affiche.
Arguments
documentObject, {fileURL}
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
• L’argument fileURL (facultatif ) est une URL repr&eacute;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
n’est pas d&eacute;fini et que le fichier a &eacute;t&eacute; enregistr&eacute; pr&eacute;c&eacute;demment, ce dernier est enregistr&eacute; au
m&ecirc;me endroit ; sinon, une bo&icirc;te de dialogue d’enregistrement s’affiche.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant le succ&egrave;s (true) ou l’&eacute;chec (false) de l’op&eacute;ration.
Activateur
dreamweaver.canSaveDocument(), page 444.
dreamweaver.saveDocumentAs()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Enregistrer sous.
Arguments
documentObject
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux manipulations de fichiers
267
dreamweaver.saveDocumentAsTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Enregistrer comme mod&egrave;le.
Arguments
documentObject, {fileName}
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
•
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
L’argument fileName (facultatif ) est le nom du fichier &agrave; ouvrir, exprim&eacute; sous forme d’une
URL absolue.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canSaveDocumentAsTemplate(), page 444.
dreamweaver.saveFrameset()
Disponibilit&eacute;
Dreamweaver 3.
Description
Enregistre le jeu de cadres sp&eacute;cifi&eacute; ou, si ce dernier n’a pas encore &eacute;t&eacute; enregistr&eacute;, ouvre la bo&icirc;te de
dialogue Enregistrer sous.
Arguments
documentObject
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canSaveFramesetAs(), page 445.
268
Chapitre 14 : Document
dreamweaver.saveFramesetAs()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Enregistrer sous correspondant au fichier de jeu de cadres comprenant
le DOM sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canSaveFramesetAs(), page 445.
Fonctions globales relatives aux documents
Ces fonctions agissent sur l’ensemble d’un document. Elles permettent d’effectuer des
v&eacute;rifications orthographiques, de v&eacute;rifier les navigateurs cibles, de d&eacute;finir les propri&eacute;t&eacute;s des pages
et de d&eacute;terminer les r&eacute;f&eacute;rences d’objet correctes des &eacute;l&eacute;ments du document.
dom.checkSpelling()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie l’orthographe sur l’ensemble du document (en ouvrant la bo&icirc;te de dialogue V&eacute;rifier
l’orthographe, si n&eacute;cessaire) et pr&eacute;vient l’utilisateur lorsque la v&eacute;rification est termin&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions globales relatives aux documents
269
dom.checkTargetBrowsers()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie le navigateur cible du document. Pour v&eacute;rifier le navigateur cible d’un dossier ou d’un
groupe de fichiers, voir site.checkTargetBrowsers(), page 226.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.getParseMode()
Disponibilit&eacute;
Dreamweaver MX 2004
Description
Permet d’obtenir le mode d’analyse du document. Ceci permet de contr&ocirc;ler la validation du
document et de v&eacute;rifier qu’il s’affiche au format HTML dans la fen&ecirc;tre de document principale.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une cha&icirc;ne indiquant le mode d’analyse : &quot;html&quot;, &quot;xml&quot;, &quot;css&quot; ou &quot;text&quot;.
dom.hideInfoMessagePopup()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Masque le message qui peut s’afficher sous forme d’info-bulle dans la fen&ecirc;tre de document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Voir aussi
dom.showInfoMessagePopup(), page 272.
270
Chapitre 14 : Document
dom.runValidation()
Disponibilit&eacute;
Dreamweaver MX, arguments facultatifs ajout&eacute;s &agrave; Dreamweaver MX 2004.
Description
Ex&eacute;cute le validateur sur un seul document sp&eacute;cifi&eacute; (similaire &agrave; la fonction site.runValidation()).
Le validateur v&eacute;rifie que le langage du document est conforme &agrave; celui qui a &eacute;t&eacute; sp&eacute;cifi&eacute; dans le
doctype du document (comme, par exemple, HTML 4.0 ou HTML 3.2) et &agrave; celui qui a &eacute;t&eacute;
sp&eacute;cifi&eacute; par le mod&egrave;le de serveur (comme, par exemple, ColdFusion ou ASP). Si aucun doctype
n’a &eacute;t&eacute; d&eacute;fini pour le document, le validateur utilise le param&egrave;tre de langage sp&eacute;cifi&eacute; dans la
section Validateur de la bo&icirc;te de dialogue Pr&eacute;f&eacute;rences.
Arguments
{controlString}, {bOpenResultsWindow}, {bShowInfoMessage}
• L’argument controlString (facultatif ) peut avoir l’une des quatre valeurs suivantes : Cha&icirc;ne
vide, &quot;xml&quot;, &quot;auto-explicit&quot; ou &quot;auto-implicit&quot;.
■ Si la valeur de l’argument est une cha&icirc;ne vide, le validateur effectue une validation par
d&eacute;faut. Si sa valeur est &quot;xml&quot;, il valide le document en tant que XML.
■ Si sa valeur est &quot;auto-explicit&quot; ou &quot;auto-implicit&quot;, Dreamweaver effectue une
validation automatique (ou validation en ligne). Plut&ocirc;t que d’&ecirc;tre affich&eacute;es dans la fen&ecirc;tre de
r&eacute;sultats de la validation (voir dom.source.getValidationErrorsForOffset(), page 415 et
dom.getAutoValidationCount(), page 408), les erreurs sont soulign&eacute;es dans le mode Code.
■ Si la valeur de l’argument controlString est &quot;auto-explicit&quot;, l’utilisateur est invit&eacute; &agrave;
enregistrer un document non enregistr&eacute; avant la validation.
■ Si la valeur de l’argument controlString est &quot;auto-implicit&quot; et que la validation
&eacute;choue, l’utilisateur n’est pas pr&eacute;venu que le document en cours n’a pas &eacute;t&eacute; enregistr&eacute;.
Remarque : La validation automatique (d&eacute;finie par la valeur &quot;auto-explicit&quot; ou &quot;auto-implicit&quot; de
l’argument controlString) n’est disponible que pour la v&eacute;rification du navigateur cible.
• L’argument bOpenResultsWindow (facultatif ) doit avoir une valeur bool&eacute;enne : pour ouvrir la
•
fen&ecirc;tre de r&eacute;sultats de la validation, sa valeur doit &ecirc;tre true ; sinon, sa valeur est false. La valeur
par d&eacute;faut est true.
L’argument bShowInfoMessage n’est utilis&eacute; que si la valeur de l’argument controlString est
&quot;auto-explicit&quot; ou &quot;auto-implicit&quot;. L’argument bShowInfoMessage doit avoir une
valeur bool&eacute;enne : si sa valeur est true, un message d’informations s’affiche sous l’&eacute;l&eacute;ment de
barre d’outils DW_ValidatorErrors, indiquant le nombre d’erreurs d&eacute;tect&eacute;es ; si sa valeur est
false, rien ne s’affiche. La valeur par d&eacute;faut est false.
Valeurs renvoy&eacute;es
Objet fen&ecirc;tre des r&eacute;sultats de la validation.
Exemple
Dans l’exemple suivant, une validation r&eacute;guli&egrave;re est effectu&eacute;e lorsque l’utilisateur s&eacute;lectionne
Fichier &gt; V&eacute;rifier la page &gt; Valider le marqueur (ou Valider le document actuel dans le panneau
Validation) :
dw.getDocumentDOM().runValidation(’’);
Fonctions globales relatives aux documents
271
Dans l’exemple suivant, l’utilisateur est invit&eacute; &agrave; enregistrer le document non enregistr&eacute;, puis une
validation automatique est effectu&eacute;e. La fen&ecirc;tre de r&eacute;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);
Dans l’exemple suivant, l’utilisateur n’est pas invit&eacute; &agrave; enregistrer le document. Si le document n’a
pas &eacute;t&eacute; enregistr&eacute;, la validation ne peut pas d&eacute;marrer. Si le document a &eacute;t&eacute; enregistr&eacute;,
Dreamweaver effectue une validation automatique. La fen&ecirc;tre de r&eacute;sultats de la validation ne
s’affiche pas et le nombre d’erreurs dans le document n’appara&icirc;t pas sur la barre d’outils du
document :
dw.getDocumentDOM().runValidation(’auto-implicit’, false);
dom.showInfoMessagePopup()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Affiche un message sous forme d’info-bulle dans la fen&ecirc;tre de document ou sous un &eacute;l&eacute;ment de
barre d’outils.
Arguments
location, message, timeout
• L’argument
•
•
location peut &ecirc;tre une cha&icirc;ne indiquant un &eacute;l&eacute;ment de barre d’outils, une cha&icirc;ne
vide ou l’un des mots-cl&eacute;s suivants : &quot;top&quot;, &quot;topright&quot;, &quot;right&quot;, &quot;bottomright&quot;, &quot;bottom&quot;,
&quot;bottomleft&quot;, &quot;left&quot; ou &quot;topleft&quot;. L’info-bulle s’affiche pr&egrave;s du bord ou de l’angle sp&eacute;cifi&eacute;
et est centr&eacute;e. Si la valeur de l’argument est une cha&icirc;ne vide, l’info-bulle est centr&eacute;e dans le
document. Pour sp&eacute;cifier une barre d’outils, indiquez &quot;toolbar:toolbarID:itemID&quot;. L’ID
de barre d’outils et l’ID d’&eacute;l&eacute;ment de barre d’outils doivent correspondre aux ID du fichier
toolbars.xml.
L’argument message est une cha&icirc;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&eacute;faut), le message reste affich&eacute; pendant une dur&eacute;e
illimit&eacute;e. Le message dispara&icirc;t automatiquement lorsque l’utilisateur clique dessus, passe &agrave; un
autre document ou lorsque la dur&eacute;e d’affichage sp&eacute;cifi&eacute;e arrive &agrave; expiration.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Dans l’exemple ci-dessous, deux messages s’affichent sous forme d’info-bulles. La premi&egrave;re ligne
de code affiche le message &quot;Ce message est au centre&quot; au centre du document. Le second
appel de la fonction showInfoMessagePopup() affiche le message &quot;N’oubliez pas le titre
de la fen&ecirc;tre&quot; pour la zone de texte Titre (ID : DW_SetTitle) sur la barre d’outils dont l’ID
est DW_Toolbar_Main.
272
Chapitre 14 : Document
dw.getDocumentDOM.showInfoMessagePopup(’’, ’Ce message est au centre’, 5000);
dw.getDocumentDOM.showInfoMessagePopup(’toolbar:DW_Toolbar_Main:DW_SetTitle’,
’N’oubliez pas le titre de la fen&ecirc;tre’, 5000);
Voir aussi
dom.hideInfoMessagePopup(), page 270.
dom.showPagePropertiesDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la page.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.doURLDecoding()
Disponibilit&eacute;
Dreamweaver MX.
Description
Utilise le m&eacute;canisme de d&eacute;codage d’URL interne de Dreamweaver pour d&eacute;coder des caract&egrave;res
sp&eacute;ciaux et des symboles dans les cha&icirc;nes d’URL. Par exemple, cette fonction interpr&egrave;te %20
comme un caract&egrave;re d’espacement et le nom &amp;quot comme des guillemets &quot;.
Arguments
inStr
• L’argument inStr est la cha&icirc;ne &agrave; d&eacute;coder.
Valeurs renvoy&eacute;es
Cha&icirc;ne contenant l’URL d&eacute;cod&eacute;e.
Exemple
L’exemple suivant appelle la fonction dw.doURLDecoding() afin de d&eacute;coder les caract&egrave;res
sp&eacute;ciaux indiqu&eacute;s dans son argument et enregistre la cha&icirc;ne obtenue dans outStr :
outStr = dreamweaver.doURLDecoding(“http://maps.yahoo.com/py/
ddResults.py?Pyt=Tmap&amp;tarname=&amp;tardesc=&amp;newname=&amp;newdesc=&amp;newHash=&amp;newTHash
=&amp;newSts=&amp;newTSts=&amp;tlt=&amp;tln=&amp;slt=&amp;sln=&amp;newFL=Use+Address+Below&amp;newaddr=2000
+Shamrock+Rd&amp;newcsz=Metroo+Park%2C+CA&amp;newcountry=us&amp;newTFL=Use+Address+Belo
w&amp;newtaddr=500+El+Camino&amp;newtcsz=Santa+Clara%2C+CA&amp;newtcountry=us&amp;Submit=Ge
t+Directions”)
Fonctions globales relatives aux documents
273
dreamweaver.getElementRef()
Disponibilit&eacute;
Dreamweaver 2.
Description
Obtient la r&eacute;f&eacute;rence d’objet Netscape Navigator ou Internet Explorer pour un objet balise
sp&eacute;cifique de l’arborescence DOM.
Arguments
NSorIE, tagObject
• L’argument NSorIE doit &ecirc;tre &quot;NS
•
4.0&quot; ou &quot;IE 4.0&quot;. En effet, le DOM et les r&egrave;gles relatives
aux r&eacute;f&eacute;rences imbriqu&eacute;es diff&egrave;rent dans Netscape Navigator 4.0 et Internet Explorer 4.0. Cet
argument permet d’indiquer &agrave; quel navigateur doit correspondre la r&eacute;f&eacute;rence renvoy&eacute;e.
L’argument tagObject est un objet de balise dans l’arborescence DOM.
Valeurs renvoy&eacute;es
Cha&icirc;ne repr&eacute;sentant une r&eacute;f&eacute;rence JavaScript valide &agrave; l’objet, telle que
document.layers[’myLayer’]. La cha&icirc;ne est soumise aux conditions suivantes :
• Dreamweaver renvoie des r&eacute;f&eacute;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&eacute;f&eacute;rences Netscape Navigator correctes pour les balises suivantes : A,
•
•
AREA, APPLET, EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT et IMG et pour les
balises DIV et SPAN &agrave; positionnement absolu. Pour les balises DIV et SPAN dont le
positionnement n’est pas absolu, Dreamweaver renvoie &quot;cannot reference &lt;tag&gt;&quot;.
Dreamweaver ne renvoie pas de r&eacute;f&eacute;rences pour les objets sans nom. Si un objet ne contient pas
d’attribut NAME ou ID, Dreamweaver renvoie &quot;unnamed &lt;tag&gt;&quot;. Si le navigateur ne prend pas
en charge une r&eacute;f&eacute;rence par nom, Dreamweaver fait r&eacute;f&eacute;rence &agrave; l’objet &agrave; l’aide de son index (par
exemple document.myform.applets[3]).
Dreamweaver renvoie les r&eacute;f&eacute;rences des objets nomm&eacute;s figurant dans des formulaires ou des
calques sans nom (par exemple document.forms[2].myCheckbox).
dreamweaver.getObjectRefs() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 1, d&eacute;conseill&eacute;e depuis Dreamweaver 3.
Description
Cette fonction recherche, dans les documents indiqu&eacute;s, les instances des balises sp&eacute;cifi&eacute;es ou, si
aucune balise n’est sp&eacute;cifi&eacute;e, recherche toutes les balises du document et fournit des r&eacute;f&eacute;rences aux
balises en fonction du navigateur. Cette fonction revient &agrave; appeler la fonction
getElementsByTagName(), puis la fonction dreamweaver.getElementRef() pour chaque
balise de la nodelist.
Arguments
NSorIE, sourceDoc, {tag1}, {tag2},...{tagN}
274
Chapitre 14 : Document
• L’argument NSorIE doit &ecirc;tre &quot;NS
•
•
4.0&quot; ou &quot;IE 4.0&quot;. En effet, le DOM et les r&egrave;gles relatives
aux r&eacute;f&eacute;rences imbriqu&eacute;es diff&egrave;rent dans Netscape Navigator 4.0 et Internet Explorer 4.0. Cet
argument permet d’indiquer &agrave; quel navigateur doit correspondre la r&eacute;f&eacute;rence renvoy&eacute;e.
L’argument sourceDoc doit &ecirc;tre &quot;document&quot;, &quot;parent&quot;, &quot;parent.frames[number]&quot;,
&quot;parent.frames[’frameName’]&quot; ou une URL. document d&eacute;signe le document actif
contenant la s&eacute;lection en cours. parent d&eacute;signe le jeu de cadres parent (si le document
s&eacute;lectionn&eacute; se trouve dans un cadre) ; parent.frames[number] et
parent.frames[’frameName’] d&eacute;signent un document figurant dans un cadre sp&eacute;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.
Le troisi&egrave;me argument et les arguments suivants, s’ils sont d&eacute;finis, correspondent aux noms de
balises (par exemple &quot;IMG&quot;, &quot;FORM&quot; ou &quot;HR&quot;).
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes, chacun d’entre eux repr&eacute;sentant une r&eacute;f&eacute;rence JavaScript valide &agrave; une instance
nomm&eacute;e du type de balise demand&eacute; dans le document sp&eacute;cifi&eacute; (par exemple
&quot;document.monCalque.document.monImage&quot;) pour le navigateur sp&eacute;cifi&eacute;.
• Dreamweaver renvoie des r&eacute;f&eacute;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&eacute;f&eacute;rences Netscape Navigator correctes pour les balises suivantes : A,
•
•
AREA, APPLET, EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT et IMG et pour les
balises DIV et SPAN &agrave; positionnement absolu. Pour les balises DIV et SPAN dont le
positionnement n’est pas absolu, Dreamweaver renvoie &quot;cannot reference &lt;tag&gt;&quot;.
Dreamweaver ne renvoie pas de r&eacute;f&eacute;rences pour les objets sans nom. Si un objet ne contient pas
d’attribut NAME ou ID, Dreamweaver renvoie &quot;unnamed &lt;tag&gt;&quot;. Si le navigateur ne prend pas
en charge une r&eacute;f&eacute;rence par nom, Dreamweaver fait r&eacute;f&eacute;rence &agrave; l’objet &agrave; l’aide de son index (par
exemple document.myform.applets[3]).
Dreamweaver ne renvoie pas de r&eacute;f&eacute;rences pour les objets nomm&eacute;s figurant dans des
formulaires ou des calques sans nom (par exemple document.forms[2].myCheckbox).
Lorsque la m&ecirc;me liste d’arguments est transmise &agrave; la fonction getObjectTags(), les deux
fonctions renvoient des tableaux de m&ecirc;me longueur et de contenus identiques.
dreamweaver.getObjectTags() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 1, d&eacute;conseill&eacute;e depuis Dreamweaver 3.
Description
Cette fonction recherche, dans le document indiqu&eacute;, les instances des balises sp&eacute;cifi&eacute;es ou, si
aucune balise n’est sp&eacute;cifi&eacute;e, toutes les balises du document. Cette fonction revient &agrave; appeler la
fonction getElementsByTagName(), puis la fonction outerHTML() pour chaque balise de la
nodelist.
Arguments
sourceDoc, {tag1}, {tag2},...{tagN}
Fonctions globales relatives aux documents
275
• L’argument sourceDoc doit &ecirc;tre &quot;document&quot;, &quot;parent&quot;, &quot;parent.frames[number]&quot;,
•
&quot;parent.frames[’frameName’]&quot; ou une URL. document d&eacute;signe le document actif
contenant la s&eacute;lection en cours. parent d&eacute;signe le jeu de cadres parent (si le document
s&eacute;lectionn&eacute; se trouve dans un cadre) ; parent.frames[number] et
parent.frames[’frameName’] d&eacute;signent un document figurant dans un cadre sp&eacute;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.
Le second argument et les arguments suivants, s’il en existe, correspondent aux noms de balises
(par exemple &quot;IMG&quot;, &quot;FORM&quot;, &quot;HR&quot;).
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes, chacun d’entre eux correspondant au code source d’une instance du type de
balise demand&eacute; dans le document sp&eacute;cifi&eacute;.
• Si l’un des arguments de tag est LAYER, la fonction renvoie toutes les balises LAYER et ILAYER
et toutes les balises DIV et SPAN &agrave; positionnement absolu.
• Si l’un des arguments de tag est INPUT, la fonction renvoie tous les &eacute;l&eacute;ments du formulaire.
Pour obtenir un type d’&eacute;l&eacute;ment particulier du formulaire, d&eacute;finissez INPUT/TYPE, TYPE
correspondant &agrave; button, text, radio, checkbox, password, textarea, select, hidden,
reset ou submit.
Lorsque la m&ecirc;me liste d’arguments est transmise &agrave; la fonction getObjectRefs(), les deux
fonctions renvoient des tableaux de m&ecirc;me longueur.
Exemple
Selon le contenu du document actif, dreamweaver.getObjectTags(&quot;document&quot;, &quot;IMG&quot;)
pourrait renvoyer un tableau contenant les &eacute;l&eacute;ments suivants :
•
•
•
&quot;&lt;IMG SRC=&quot;/images/dot.gif&quot; WIDTH=&quot;10&quot; HEIGHT=&quot;10&quot; NAME=&quot;bullet&quot;&gt;&quot;
&quot;&lt;IMG SRC=&quot;header.gif&quot; WIDTH=&quot;400&quot; HEIGHT=&quot;32&quot; NAME=&quot;header&quot;&gt;&quot;
&quot;&lt;IMG SRC=&quot;971208_nj.jpg&quot; WIDTH=&quot;119&quot; HEIGHT=&quot;119&quot; NAME=&quot;headshot&quot;&gt;&quot;
dreamweaver.getPreferenceInt()
Disponibilit&eacute;
Dreamweaver MX.
Description
Vous permet d’extraire une pr&eacute;f&eacute;rence de nombre entier pour une extension donn&eacute;e.
Arguments
section, key, default_value
• L’argument section est une cha&icirc;ne qui sp&eacute;cifie la section des pr&eacute;f&eacute;rences contenant l’entr&eacute;e.
• L’argument key est une cha&icirc;ne qui sp&eacute;cifie l’entr&eacute;e de la valeur &agrave; extraire.
• L’argument default_value est la valeur par d&eacute;faut renvoy&eacute;e par Dreamweaver si l’entr&eacute;e est
introuvable. Il doit s’agir d’un entier non sign&eacute; compris entre 0 et 65 535 ou d’un entier sign&eacute;
compris entre -32 768 et 32 767.
276
Chapitre 14 : Document
Valeurs renvoy&eacute;es
Valeur enti&egrave;re de l’entr&eacute;e sp&eacute;cifi&eacute;e dans la section ou valeur par d&eacute;faut si la fonction ne trouve pas
l’entr&eacute;e. Envoie 0 si la valeur de l’entr&eacute;e sp&eacute;cifi&eacute;e n’est pas un entier.
Exemple
L’exemple suivant renvoie la valeur du param&egrave;tre Distance d’accrochage de la section Mon
extension des Pr&eacute;f&eacute;rences. Si la section Mon extension n’existe pas ou si le param&egrave;tre Distance
d’accrochage n’est pas d&eacute;fini, la fonction renvoie la valeur par d&eacute;faut sp&eacute;cifi&eacute;e (0).
var snapDist; //valeur par d&eacute;faut si l’entr&eacute;e est introuvable
snapDist = dreamweaver.getPreferenceInt(&quot;Mon extension&quot;, &quot;Distance
d’accrochage&quot;, 0);
dreamweaver.getPreferenceString()
Disponibilit&eacute;
Dreamweaver MX.
Description
Permet d’extraire une pr&eacute;f&eacute;rence de cha&icirc;ne que vous avez stock&eacute;e pour une extension.
Arguments
section, key, default_value
• L’argument section est une cha&icirc;ne qui sp&eacute;cifie la section des pr&eacute;f&eacute;rences contenant l’entr&eacute;e.
• L’argument key est une cha&icirc;ne qui sp&eacute;cifie la valeur &agrave; extraire.
• L’argument default_value est la cha&icirc;ne par d&eacute;faut renvoy&eacute;e par Dreamweaver si l’entr&eacute;e est
introuvable.
Valeurs renvoy&eacute;es
Cha&icirc;ne de la pr&eacute;f&eacute;rence demand&eacute;e ou valeur par d&eacute;faut si la cha&icirc;ne est introuvable.
Exemple
L’exemple suivant renvoie la valeur du param&egrave;tre Editeur de texte de la section Mon extension des
Pr&eacute;f&eacute;rences. Si la section Mon extension n’existe pas ou si le param&egrave;tre Editeur de texte n’est pas
d&eacute;fini, la fonction renvoie la valeur par d&eacute;faut sp&eacute;cifi&eacute;e par la variable txtEditor.
var txtEditor = getExternalTextEditor(); //pour d&eacute;finir la valeur de l’&eacute;diteur
de texte par d&eacute;faut
txtEditor = dreamweaver.getPreferenceString(&quot;Mon extension&quot;, &quot;Editeur de
texte&quot;, txtEditor);
dreamweaver.setPreferenceInt()
Disponibilit&eacute;
Dreamweaver MX.
Description
Vous permet de d&eacute;finir une pr&eacute;f&eacute;rence de nombre entier pour une extension donn&eacute;e. Ce
param&egrave;tre est enregistr&eacute; avec les pr&eacute;f&eacute;rences de Dreamweaver lorsque Dreamweaver n’est pas actif.
Fonctions globales relatives aux documents
277
Arguments
section, key, new_value
• L’argument section est une cha&icirc;ne qui sp&eacute;cifie la cat&eacute;gorie de pr&eacute;f&eacute;rences d&eacute;finissant l’option.
Si la cat&eacute;gorie n’existe pas, Dreamweaver la cr&eacute;e.
• L’argument key est une cha&icirc;ne qui sp&eacute;cifie l’option de cat&eacute;gorie d&eacute;finie par la fonction. Si
l’option n’existe pas, Dreamweaver la cr&eacute;e.
• L’argument new_value est un entier qui sp&eacute;cifie la valeur de l’option de cat&eacute;gorie.
Valeurs renvoy&eacute;es
Valeur true en cas de succ&egrave;s et false dans le cas contraire.
Exemple
L’exemple suivant d&eacute;finit l’entr&eacute;e Distance d’accrochage en fonction de la valeur de la variable
snapDist de la cat&eacute;gorie Mon extension dans les Pr&eacute;f&eacute;rences :
var snapDist = getSnapDistance();
if(snapDist &gt; 0)
{
dreamweaver.setPreferenceInt(&quot;Mon extension&quot;, &quot;Distance d’accrochage&quot;,
snapDist);
}
dreamweaver.setPreferenceString()
Disponibilit&eacute;
Dreamweaver MX.
Description
Permet d’&eacute;crire une pr&eacute;f&eacute;rence de cha&icirc;ne pour une extension. Ce param&egrave;tre est enregistr&eacute; avec les
pr&eacute;f&eacute;rences de Dreamweaver lorsque Dreamweaver n’est pas actif.
Arguments
section, key, new_value
• L’argument section est une cha&icirc;ne qui sp&eacute;cifie la cat&eacute;gorie de Pr&eacute;f&eacute;rences d&eacute;finissant l’option.
Si la cat&eacute;gorie n’existe pas, Dreamweaver la cr&eacute;e.
• L’argument key est une cha&icirc;ne qui sp&eacute;cifie l’option de cat&eacute;gorie d&eacute;finie par les fonctions. Si
•
l’option de cat&eacute;gorie n’existe pas, Dreamweaver la cr&eacute;e.
L’argument new_value est une cha&icirc;ne qui sp&eacute;cifie la valeur de l’option de cat&eacute;gorie.
Valeurs renvoy&eacute;es
Valeur true en cas de succ&egrave;s et false dans le cas contraire.
Exemple
var txtEditor = getExternalTextEditor();
dreamweaver.setPreferenceString(&quot;Mon extension&quot;, &quot;Editeur de texte&quot;,
txtEditor);
278
Chapitre 14 : Document
dreamweaver.showTargetBrowsersDialog()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Ouvre la bo&icirc;te de dialogue Navigateurs cibles. Cette bo&icirc;te de dialogue permet &agrave; l’utilisateur de
sp&eacute;cifier les versions des navigateurs utilis&eacute;es par la fonction V&eacute;rification du navigateur cible pour
contr&ocirc;ler les probl&egrave;mes de compatibilit&eacute; du navigateur sur la page actuelle.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux chemins
Ces fonctions permettent d’obtenir et de manipuler les chemins d’acc&egrave;s aux diff&eacute;rents fichiers et
dossiers enregistr&eacute;s sur le disque dur d’un utilisateur. Elles permettent, entre autres, de d&eacute;terminer
le chemin d’acc&egrave;s &agrave; la racine du site dans lequel r&eacute;side le document actif et de convertir des
chemins relatifs en URL absolues.
dreamweaver.getConfigurationPath()
Disponibilit&eacute;
Dreamweaver 2.
Description
Obtient le chemin d’acc&egrave;s au dossier Configuration de Dreamweaver, exprim&eacute; sous la forme
d’une URL de type file://.
Pour savoir comment Dreamweaver acc&egrave;de aux dossiers Configuration sur une plate-forme
multiutilisateur, voir Extensions C dans l’aide Extension de Dreamweaver.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Chemin d’acc&egrave;s aux configurations de l’application.
Exemple
La fonction ci-dessous est utile pour faire r&eacute;f&eacute;rence &agrave; d’autres fichiers d’extension stock&eacute;s dans le
sous-dossier Configuration du dossier de l’application Dreamweaver :
var sortCmd = dreamweaver.getConfigurationPath() + &not;
&quot;/Commands/Sort Table.htm&quot;
var sortDOM = dreamweaver.getDocumentDOM(sortCmd);
Fonctions relatives aux chemins
279
dreamweaver.getDocumentPath()
Disponibilit&eacute;
Dreamweaver 1.2.
Description
Obtient le chemin d’acc&egrave;s du document d&eacute;fini, exprim&eacute; sous la forme d’une URL de type file://.
Cette fonction revient &agrave; appeler la fonction dreamweaver.getDocumentDOM() et &agrave; lire la
propri&eacute;t&eacute; URL de la valeur renvoy&eacute;e.
Arguments
sourceDoc
• La valeur de l’argument sourceDoc doit &ecirc;tre &quot;document&quot;, &quot;parent&quot;,
&quot;parent.frames[number]&quot; ou &quot;parent.frames[’frameName’]&quot;. document d&eacute;signe le
document actif contenant la s&eacute;lection en cours. parent d&eacute;signe le jeu de cadres parent (si le
document s&eacute;lectionn&eacute; se trouve dans un cadre) ; &quot;parent.frames[number]&quot; et
&quot;parent.frames[’frameName’]&quot; d&eacute;signent un document figurant dans un cadre sp&eacute;cifique
du jeu de cadres contenant le document actif.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant l’URL du document d&eacute;fini si le fichier a &eacute;t&eacute; enregistr&eacute;, soit une cha&icirc;ne
vide si le fichier n’a pas &eacute;t&eacute; enregistr&eacute;.
dreamweaver.getSiteRoot()
Disponibilit&eacute;
Dreamweaver 1.2.
Description
Obtient le dossier racine local (tel que d&eacute;fini dans la bo&icirc;te de dialogue D&eacute;finition du site) du site
associ&eacute; au document s&eacute;lectionn&eacute;, exprim&eacute; sous la forme d’une URL de type file://.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant l’URL du dossier racine local du site o&ugrave; le fichier a &eacute;t&eacute; enregistr&eacute;, soit
une cha&icirc;ne vide si le fichier n’est associ&eacute; &agrave; aucun site.
dreamweaver.getTempFolderPath()
Disponibilit&eacute;
Dreamweaver MX.
280
Chapitre 14 : Document
Description
Permet d’obtenir le chemin d’acc&egrave;s complet &agrave; 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&egrave;me est multiutilisateur, la recherche se fait
dans le dossier Configuration de l’utilisateur. Si aucun dossier Temp n’a &eacute;t&eacute; trouv&eacute;, la fonction en
cr&eacute;e un. Les fichiers partag&eacute;s qui ne sont pas transitoires doivent &ecirc;tre enregistr&eacute;s dans le dossier
Configuration/Shared.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Chemin d’acc&egrave;s au dossier, exprim&eacute; sous la forme d’une URL de type file://.
Exemple
La ligne de code ci-dessous renvoie le chemin d’acc&egrave;s complet au fichier sp&eacute;cifi&eacute;. Contrairement
aux autres fonctions Dreamweaver (telles que dreamweaver.getSiteRoot()), la fonction
dw.getTempFolderPath() ne renvoie pas de barre oblique (/) &agrave; la fin du chemin :
var myTempfile = dw.getTempFolderPath() + &quot;/myTempFile.txt&quot;;
dreamweaver.relativeToAbsoluteURL()
Disponibilit&eacute;
Dreamweaver 2.
Description
Si on lui fournit une URL relative et un point de r&eacute;f&eacute;rence donn&eacute;s (chemin d’acc&egrave;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&egrave;s &agrave; un document sur l’ordinateur de
•
•
l’utilisateur (le document actif, par exemple), exprim&eacute; sous la forme d’une URL de type file://,
ou &agrave; une cha&icirc;ne vide si relURL est une URL relative &agrave; la racine.
L’argument siteRoot est le chemin d’acc&egrave;s &agrave; la racine du site, exprim&eacute; sous la forme d’une
URL de type file://, ou une cha&icirc;ne vide si relURL est une URL relative &agrave; un document.
L’argument relURL est l’URL &agrave; convertir.
Valeurs renvoy&eacute;es
URL absolue. La valeur renvoy&eacute;e est g&eacute;n&eacute;r&eacute;e conform&eacute;ment aux principes suivants :
• Si relURL est une URL absolue, aucune conversion n’a lieu et la valeur renvoy&eacute;e est identique &agrave;
relURL.
• Si relURL est une URL relative &agrave; un document, la valeur renvoy&eacute;e est une combinaison de
docPath+relURL.
• Si relURL est une URL relative &agrave; la racine, la valeur renvoy&eacute;e est une combinaison de
siteRoot+relURL.
Fonctions relatives aux chemins
281
Fonctions relatives &agrave; la s&eacute;lection
Ces fonctions permettent d’obtenir et de d&eacute;finir la s&eacute;lection dans les documents ouverts. Pour
savoir comment obtenir et d&eacute;finir la s&eacute;lection dans le panneau Site, voir Fonctions relatives aux
sites, page 222.
dom.getSelectedNode()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le nœud s&eacute;lectionn&eacute;. Revient &agrave; appeler la fonction dom.getSelection() et &agrave; transmettre
la valeur renvoy&eacute;e &agrave; la fonction dom.offsetsToNode().
Arguments
Aucun.
Valeurs renvoy&eacute;es
Objet balise, texte ou commentaire contenant la s&eacute;rie de caract&egrave;res sp&eacute;cifi&eacute;e.
dom.getSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la s&eacute;lection, exprim&eacute;e en d&eacute;calages de caract&egrave;res, dans le code source du document.
Arguments
{bAllowMultiple}
• L’argument bAllowMultiple (facultatif ) est une valeur bool&eacute;enne qui indique si la fonction
doit renvoyer plusieurs d&eacute;calages lorsque plusieurs calques, cellules de tableau ou zones
r&eacute;actives de carte graphique sont s&eacute;lectionn&eacute;s.
Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Pour les s&eacute;lections simples, un tableau contenant deux nombres entiers. Le premier entier
correspond au d&eacute;calage de caract&egrave;res &agrave; l’ouverture de la s&eacute;lection. Le second correspond au
d&eacute;calage de caract&egrave;res &agrave; la fermeture de la s&eacute;lection. Si les deux valeurs sont identiques, la s&eacute;lection
en cours correspond &agrave; un point d’insertion.
282
Chapitre 14 : Document
Pour les s&eacute;lections complexes (lorsque la s&eacute;lection se compose de plusieurs cellules de tableau,
calques ou zones r&eacute;actives de carte graphique), tableau contenant 2n nombres entiers, o&ugrave; n
repr&eacute;sente le nombre d’&eacute;l&eacute;ments s&eacute;lectionn&eacute;s. Le premier entier de chaque paire correspond au
d&eacute;calage de caract&egrave;res de l’ouverture de la s&eacute;lection (balise d’ouverture TD, DIV, SPAN, LAYER,
ILAYER ou MAP comprise) ; le second entier correspond au d&eacute;calage de caract&egrave;res &agrave; la fermeture de
la s&eacute;lection (balise de fermeture TD, DIV, SPAN, LAYER, ILAYER ou MAP comprise). Si plusieurs
rang&eacute;es d’un tableau sont s&eacute;lectionn&eacute;es, le d&eacute;calage de chaque cellule de chaque rang&eacute;e est
renvoy&eacute;. La s&eacute;lection n’inclut jamais les balises TR.
dom.nodeToOffsets()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la position d’un nœud donn&eacute; dans l’arborescence DOM, exprim&eacute;e en d&eacute;calages de
caract&egrave;res dans le code source du document. Fonction valide pour n’importe quel document sur
un lecteur local.
Arguments
node
• L’argument node doit &ecirc;tre une balise, un commentaire ou un texte correspondant &agrave; un nœud
de l’arborescence renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoy&eacute;es
Tableau qui contient deux nombres entiers. Le premier entier correspond au d&eacute;calage du d&eacute;but de
la balise, du texte ou du commentaire. Le second correspond au d&eacute;calage de la fin du nœud, par
rapport au d&eacute;but du document HTML.
Exemple
L’exemple de code suivant s&eacute;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&eacute;
Dreamweaver 3.
Description
Obtient l’objet de l’arborescence DOM qui contient la s&eacute;rie enti&egrave;re de caract&egrave;res situ&eacute;e entre
l’ouverture et la fermeture d&eacute;finies. Fonction valide pour n’importe quel document sur un lecteur
local.
Arguments
offsetBegin, offsetEnd
Fonctions relatives &agrave; la s&eacute;lection
283
• L’argument offsetBegin indique le d&eacute;calage depuis le d&eacute;but du document jusqu’au d&eacute;but
d’une s&eacute;rie de caract&egrave;res correspondant &agrave; un objet dans l’arborescence DOM.
• L’argument offsetEnd indique le d&eacute;calage depuis le d&eacute;but du document jusqu’&agrave; la fin d’une
s&eacute;rie de caract&egrave;res correspondant &agrave; un objet dans l’arborescence DOM.
Valeurs renvoy&eacute;es
Objet balise, texte ou commentaire contenant la s&eacute;rie de caract&egrave;res sp&eacute;cifi&eacute;e.
Exemple
Le code suivant affiche une alerte si la s&eacute;lection est une image.
var offsets = dom.getSelection();
var theSelection = dreamweaver.offsetsToNode(offsets[0], &not;
offsets[1]);
if (theSelection.nodeType == Node.ELEMENT_NODE &amp;&amp; &not;
theSelection.tagName == ’IMG’){
alert(’La s&eacute;lection en cours est une image.’);
}
dom.selectAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
Effectue une op&eacute;ration S&eacute;lectionner tout.
Remarque : Dans la plupart des cas, cette fonction s&eacute;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&eacute;lectionne qu’une partie du document actif. Pour d&eacute;finir le document entier comme s&eacute;lection,
utilisez la fonction dom.setSelection().
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.setSelectedNode()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit le nœud s&eacute;lectionn&eacute;. Revient &agrave; appeler la fonction dom.nodeToOffsets() et &agrave;
transmettre la valeur renvoy&eacute;e &agrave; la fonction dom.setSelection().
Arguments
node, {bSelectInside}, {bJumpToNode}
• L’argument node est un nœud de texte, de commentaire ou d’&eacute;l&eacute;ment du document.
284
Chapitre 14 : Document
• L’argument bSelectInside (facultatif ) est une valeur bool&eacute;enne qui indique s’il faut
•
s&eacute;lectionner la propri&eacute;t&eacute; innerHTML du nœud. Cet argument n’est pertinent que si node est un
nœud d’&eacute;l&eacute;ment et qu’il prend par d&eacute;faut la valeur false lorsqu’il n’est pas d&eacute;fini.
L’argument bJumpToNode (facultatif ) est une valeur bool&eacute;enne qui indique s’il faut, le cas
&eacute;ch&eacute;ant, faire d&eacute;filer la fen&ecirc;tre de document pour rendre la s&eacute;lection visible. S’il n’est pas
d&eacute;fini, cet argument prend par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
dom.setSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit le d&eacute;but et la fin de la s&eacute;lection dans le document.
Arguments
offsetBegin, offsetEnd
• Ces arguments correspondent respectivement &agrave; l’ouverture et &agrave; la fermeture de la nouvelle
s&eacute;lection, exprim&eacute;es en d&eacute;calages de caract&egrave;res dans le code source du document. Si les deux
valeurs sont identiques, la nouvelle s&eacute;lection correspond &agrave; un point d’insertion. Si la nouvelle
s&eacute;lection n’est pas une s&eacute;lection HTML valide, elle inclut les caract&egrave;res de la premi&egrave;re s&eacute;lection
HTML valide. Par exemple, si offsetBegin et offsetEnd d&eacute;finissent SRC=&quot;myImage.gif&quot;
comme s&eacute;lection dans &lt;IMG SRC=&quot;myImage.gif&quot;&gt;, la s&eacute;lection est &eacute;tendue pour inclure
&eacute;galement la balise IMG.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.getSelection() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 2 ; d&eacute;conseill&eacute;e depuis la version 3. Voir dom.getSelection(), page 282.
Description
Obtient la s&eacute;lection en cours, exprim&eacute;e en d&eacute;calages d’octets dans le code source du document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau qui contient deux nombres entiers. Le premier entier repr&eacute;sente le d&eacute;calage d’octets du
d&eacute;but de la s&eacute;lection et le second correspond au d&eacute;calage d’octets de la fin de la s&eacute;lection. Si les
deux valeurs sont identiques, la s&eacute;lection en cours correspond &agrave; un point d’insertion.
Fonctions relatives &agrave; la s&eacute;lection
285
dreamweaver.nodeExists()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si la r&eacute;f&eacute;rence au nœud indiqu&eacute; est toujours valable. Il arrive souvent, lors de la
r&eacute;daction d’extensions, que vous fassiez r&eacute;f&eacute;rence &agrave; un nœud, puis que vous effectuiez une
op&eacute;ration qui le supprime (comme d&eacute;finir la propri&eacute;t&eacute; innerHTML ou outerHTML de son parent).
Cette fonction vous permet de confirmer que le nœud n’a pas &eacute;t&eacute; supprim&eacute; avant de commencer
&agrave; faire r&eacute;f&eacute;rence &agrave; l’une de ses propri&eacute;t&eacute;s ou m&eacute;thodes. Le nœud r&eacute;f&eacute;renc&eacute; ne doit pas
n&eacute;cessairement se trouver dans le document actif.
Arguments
node
• L’argument node correspond au nœud &agrave; v&eacute;rifier.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le nœud existe et 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&eacute;rifier si le nœud original existe encore :
function applyFormatToSelectedTable(){
// pour obtenir la s&eacute;lection en cours
var selObj = dw.getDocumentDOM().getSelectedNode();
alternateRows(dwscripts.findDOMObject(&quot;presetNames&quot;).selectedIndex,
findTable());
// pour restaurer la s&eacute;lection d’origine, si elle existe encore ; dans le cas
contraire, s&eacute;lectionne simplement
// le tableau.
var selArr;
if (dw.nodeExists(selObj))
selArr = dom.nodeToOffsets(selObj);
else
selArr = dom.nodeToOffsets(findTable());
dom.setSelection(selArr[0],selArr[1]);
}
dreamweaver.nodeToOffsets() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 2, d&eacute;conseill&eacute;e depuis la version 3 : utiliser &agrave; la place dom.nodeToOffsets(),
page 283.
286
Chapitre 14 : Document
Description
Obtient la position d’un nœud dans l’arborescence DOM, exprim&eacute;e en d&eacute;calages d’octets dans le
code source du document.
Arguments
node
• L’argument node doit &ecirc;tre une balise, un commentaire ou un texte correspondant &agrave; un nœud
de l’arborescence renvoy&eacute;e par la fonction dreamweaver.getDocumentDOM().
Valeurs renvoy&eacute;es
Tableau qui contient deux nombres entiers. Le premier entier repr&eacute;sente le d&eacute;calage d’octets de
l’ouverture de la balise, du texte ou du commentaire et le second correspond au d&eacute;calage d’octets
de la fermeture du nœud.
dreamweaver.offsetsToNode() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 2, d&eacute;conseill&eacute;e depuis la version 3 : utiliser &agrave; la place dom.offsetsToNode(),
page 283.
Description
Obtient l’objet de l’arborescence DOM qui contient la s&eacute;rie enti&egrave;re de caract&egrave;res situ&eacute;e entre
l’ouverture et la fermeture d&eacute;finies.
Arguments
offsetBegin, offsetEnd
• Ces arguments correspondent respectivement &agrave; l’ouverture et &agrave; la fermeture d’une s&eacute;rie de
caract&egrave;res, exprim&eacute;es en d&eacute;calages d’octets dans le code source du document.
Valeurs renvoy&eacute;es
Objet balise, texte ou commentaire contenant la s&eacute;rie de caract&egrave;res sp&eacute;cifi&eacute;e.
dreamweaver.selectAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
Effectue une op&eacute;ration S&eacute;lectionner tout dans la fen&ecirc;tre de document active, dans le panneau Site
ou, sur Macintosh, dans le champ de texte actif d’une bo&icirc;te de dialogue ou d’un panneau flottant.
Remarque : Si l’op&eacute;ration est effectu&eacute;e dans le document actif, elle s&eacute;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&eacute;lectionne qu’une partie du document. Pour d&eacute;finir le
document entier comme s&eacute;lection, utilisez la fonction dom.setSelection().
Arguments
Aucun.
Fonctions relatives &agrave; la s&eacute;lection
287
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canSelectAll(), page 445.
dreamweaver.setSelection() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 2, d&eacute;conseill&eacute;e depuis la version 3 : utiliser &agrave; la place dom.setSelection(),
page 285.
Description
D&eacute;finit la s&eacute;lection dans le document actif. Cette fonction ne peut d&eacute;placer la s&eacute;lection qu’&agrave;
l’int&eacute;rieur du document actif. Elle ne peut pas rendre un autre document actif.
Arguments
offsetBegin, offsetEnd
• Ces arguments correspondent respectivement &agrave; l’ouverture et &agrave; la fermeture de la nouvelle
s&eacute;lection, exprim&eacute;es en d&eacute;calages d’octets dans le code source du document. Si les deux valeurs
sont identiques, la nouvelle s&eacute;lection correspond &agrave; un point d’insertion. Si la nouvelle s&eacute;lection
n’est pas une s&eacute;lection HTML valide, elle inclut les caract&egrave;res de la premi&egrave;re s&eacute;lection HTML
valide. Par exemple, si offsetBegin et offsetEnd d&eacute;finissent SRC=&quot;myImage.gif&quot; comme
s&eacute;lection dans &lt;IMG SRC=&quot;myImage.gif&quot;&gt;, la s&eacute;lection est &eacute;tendue pour inclure &eacute;galement la
balise IMG.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de manipulation de cha&icirc;nes
Ces fonctions vous permettent d’obtenir des informations sur une cha&icirc;ne et de convertir une
cha&icirc;ne Latin1 en code national sur la plate-forme de l’utilisateur et vice-versa.
dreamweaver.doURLEncoding()
Disponibilit&eacute;
Dreamweaver 1.
Description
Prend une cha&icirc;ne et renvoie une cha&icirc;ne convertie en URL en rempla&ccedil;ant tous les espaces et
caract&egrave;res sp&eacute;ciaux par les entit&eacute;s sp&eacute;cifi&eacute;es.
Arguments
stringToConvert
• L’argument stringToConvert est une cha&icirc;ne qui contient l’URL non cod&eacute;e qui est cod&eacute;e par
la fonction.
288
Chapitre 14 : Document
Valeurs renvoy&eacute;es
Une cha&icirc;ne convertie en format d’URL.
Exemple
L’exemple suivant indique la valeur URL pour &quot;My URL-encoded string&quot; :
var URL = dw.doURLEncoding(theURL.value);
renvoie &quot;My%20URL-encoded%20string&quot;
dreamweaver.getTokens()
Disponibilit&eacute;
Dreamweaver 1.
Description
Accepte une cha&icirc;ne et la divise en expressions.
Arguments
searchString, separatorCharacters
• L’argument searchString est la cha&icirc;ne &agrave; diviser en expressions.
• L’argument separatorCharacters est le ou les caract&egrave;res indiquant la fin d’une expression.
Les s&eacute;parateurs figurant dans des cha&icirc;nes entre guillemets sont ignor&eacute;s. Tous les espaces
&eacute;ventuellement contenus dans separatorCharacters (les tabulations, par exemple) sont
trait&eacute;s comme des s&eacute;parateurs, comme si vous les aviez d&eacute;finis explicitement. Deux espaces
cons&eacute;cutifs ou plus sont trait&eacute;s comme un seul s&eacute;parateur.
Valeurs renvoy&eacute;es
Tableau d’expressions.
Exemple
L’appel de la fonction dw.getTokens() ci-dessous renvoie les expressions indiqu&eacute;es &agrave; la suite :
dreamweaver.getTokens(’foo(&quot;my arg1&quot;, 34)’, ’(),’)
•
•
•
foo
&quot;my arg 1&quot;
34
dreamweaver.latin1ToNative()
Disponibilit&eacute;
Dreamweaver 2.
Description
Convertit une cha&icirc;ne Latin 1 en code national sur la machine 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 n’a aucun effet car le code Windows repose sur Latin 1.
Arguments
stringToConvert
Fonctions de manipulation de cha&icirc;nes
289
• L’argument stringToConvert est la cha&icirc;ne &agrave; convertir de Latin 1 en code national sur la
machine de l’utilisateur.
Valeurs renvoy&eacute;es
Cha&icirc;ne convertie.
dreamweaver.nativeToLatin1()
Disponibilit&eacute;
Dreamweaver 2.
Description
Convertit une cha&icirc;ne de code national en code Latin 1.
Remarque : Sous Windows, cette fonction n’a aucun effet car le code Windows repose sur Latin 1.
Arguments
stringToConvert
• L’argument stringToConvert est la cha&icirc;ne &agrave; convertir du code national en code Latin 1.
Valeurs renvoy&eacute;es
Cha&icirc;ne convertie.
dreamweaver.scanSourceString()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Analyse une cha&icirc;ne de code HTML et recherche les balises, les attributs, les directives et le texte.
Pour chaque balise, attribut, directive et texte trouv&eacute;, la fonction scanSourceString() appelle
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 :
1 Dreamweaver appelle openTagBegin() pour chaque balise d’ouverture (par exemple &lt;font&gt;,
et non &lt;/font&gt;) et chaque balise vide (par exemple, &lt;img&gt; ou &lt;hr&gt;). La fonction
openTagBegin() accepte deux arguments : le nom de la balise (par exemple, font ou img) et le
d&eacute;calage du document, qui est le nombre d’octets contenus dans le document avant le d&eacute;but de
la balise. La fonction renvoie la valeur true si l’analyse doit continuer et false si elle doit
s’arr&ecirc;ter.
290
Chapitre 14 : Document
2 Une fois openTagBegin() ex&eacute;cut&eacute;e, Dreamweaver appelle attribute() pour chaque attribut
3
4
5
6
7
HTML. La fonction attribute() accepte deux arguments : une cha&icirc;ne contenant le nom de
l’attribut (par exemple, &quot;color&quot; ou &quot;src&quot;) et une cha&icirc;ne contenant la valeur de l’attribut (par
exemple &quot;#000000&quot; ou &quot;foo.gif&quot;). La fonction attribute() renvoie une valeur bool&eacute;enne
indiquant si l’analyse doit continuer.
Une fois que tous les attributs de la balise ont &eacute;t&eacute; analys&eacute;s, Dreamweaver appelle openTagEnd().
La fonction openTagEnd() accepte un argument : le d&eacute;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&eacute;enne qui indique si l’analyse doit continuer.
Dreamweaver appelle closeTagBegin() pour chaque balise de fermeture (par exemple, &lt;/
font&gt;). Cette fonction accepte deux arguments : le nom de la balise &agrave; fermer (par exemple,
&quot;font&quot;) et le d&eacute;calage du document, qui correspond au nombre d’octets contenus dans le
document avant le d&eacute;but de la balise de fermeture. La fonction renvoie une valeur bool&eacute;enne
qui indique si l’analyse doit continuer.
Une fois closeTagBegin() termin&eacute;e, Dreamweaver appelle la fonction closeTagEnd(). La
fonction closeTagEnd() accepte un argument : le d&eacute;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&eacute;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&icirc;ne
contenant la directive et le d&eacute;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&eacute;enne qui indique si l’analyse doit continuer.
Dreamweaver appelle la fonction text() pour chaque portion de texte du document, c’est-&agrave;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 &agrave; l’int&eacute;rieur d’une balise
&lt;title&gt; ou &lt;option&gt;. La fonction text() accepte deux arguments : une cha&icirc;ne contenant le
texte et le d&eacute;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&eacute;enne qui indique si l’analyse doit continuer.
Arguments
HTMLstr, parserCallbackObj
• L’argument HTMLstr est une cha&icirc;ne qui contient un code.
• L’argument parserCallbackObj est un objet JavaScript qui a une ou plusieurs des m&eacute;thodes
suivantes : openTagBegin(), openTagEnd(), closeTagBegin(), closeTagEnd(),
directive(), attribute() et text(). Pour de meilleurs r&eacute;sultats, parserCallbackObj doit
&ecirc;tre une biblioth&egrave;que partag&eacute;e d&eacute;finie &agrave; l’aide de l’interface Extension C. Vous obtiendrez
&eacute;galement de meilleures performances si la fonction parserCallbackObj d&eacute;finit uniquement
les fonctions de rappel dont elle a besoin.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si l’op&eacute;ration r&eacute;ussit et false dans le cas contraire.
Exemple
La s&eacute;quence d’&eacute;tapes suivante offre un exemple d’utilisation de la fonction
dreamweaver.scanSourceString() :
1 Cr&eacute;ez une impl&eacute;mentation pour une ou plusieurs des sept fonctions de rappel.
2 Ecrivez un script qui appelle la fonction dreamweaver.scanSourceString().
Fonctions de manipulation de cha&icirc;nes
291
3 La fonction dreamweaver.scanSourceString() transmet une cha&icirc;ne contenant le code
HTML et les pointeurs des fonctions de rappel que vous avez &eacute;crits. Par exemple, supposons
que la cha&icirc;ne HTML soit &quot;&lt;font size=2&gt;bonjour&lt;/font&gt;&quot;.
4 Dreamweaver analyse la cha&icirc;ne et d&eacute;termine si elle contient une balise de police. Dreamweaver
appelle ensuite les fonctions de rappel dans l’ordre suivant :
■ Fonction openTagBegin()
■ Fonction attribute() (pour l’attribut de taille)
■ Fonction openTagEnd()
■ Fonction text() (pour la cha&icirc;ne &laquo; bonjour &raquo;)
■ Fonctions closeTagBegin() et closeTagEnd()
Fonctions relatives &agrave; la traduction
Ces fonctions permettent d’agir directement sur les traducteurs de donn&eacute;es ou sur les r&eacute;sultats de
la traduction. Elles permettent d’ex&eacute;cuter ou d’obtenir des informations sur un traducteur, de
modifier le contenu d’une r&eacute;gion verrouill&eacute;e et de stipuler que le code traduit doit &ecirc;tre utilis&eacute; lors
de l’obtention et de la d&eacute;finition de d&eacute;calages de s&eacute;lection.
dom.runTranslator()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction ex&eacute;cute le traducteur sp&eacute;cifi&eacute; 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&icirc;t dans les pr&eacute;f&eacute;rences
de traduction.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.editLockedRegions()
Disponibilit&eacute;
Dreamweaver 2.
Description
Selon la valeur de l’argument, autorise ou non la modification des r&eacute;gions verrouill&eacute;es. Par d&eacute;faut,
les r&eacute;gions verrouill&eacute;es ne peuvent pas &ecirc;tre modifi&eacute;es. Si vous tentez de modifier une r&eacute;gion
verrouill&eacute;e avant de la rendre modifiable avec cette fonction, Dreamweaver &eacute;met un bip et interdit
la modification.
292
Chapitre 14 : Document
Remarque : La modification de r&eacute;gions verrouill&eacute;es peut avoir des cons&eacute;quences inattendues sur les
&eacute;l&eacute;ments de biblioth&egrave;que et les mod&egrave;les. N’utilisez cette fonction qu’avec les traducteurs de
donn&eacute;es.
Arguments
bAllowEdits
• L’argument bAllowEdits doit avoir une valeur bool&eacute;enne : true indique que les modifications
sont autoris&eacute;es ; false indique le contraire. Dreamweaver restaure automatiquement l’&eacute;tat par
d&eacute;faut (non modifiable) des r&eacute;gions verrouill&eacute;es lorsque l’ex&eacute;cution du script qui appelle la
fonction prend fin.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.getTranslatorList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient la liste des traducteurs de donn&eacute;es install&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes, chacune repr&eacute;sentant le nom d’un traducteur tel qu’il appara&icirc;t dans les
pr&eacute;f&eacute;rences de traduction.
dreamweaver.useTranslatedSource()
Disponibilit&eacute;
Dreamweaver 2.
Description
Cette fonction indique les valeurs renvoy&eacute;es par dom.nodeToOffsets() et
dom.getSelection(). Elles sont utilis&eacute;es par dom.offsetsToNode() et dom.setSelection()
et doivent &ecirc;tre d&eacute;cal&eacute;es dans le code source converti (code HTML contenu dans l’arborescence
DOM apr&egrave;s l’ex&eacute;cution du traducteur) et non dans le code source non converti.
Remarque : Cette fonction ne s’applique qu’aux fichiers de l’inspecteur de propri&eacute;t&eacute;s.
Arguments
bUseTranslatedSource
• L’argument bUseTranslatedSource doit avoir une valeur bool&eacute;enne : true si la fonction
utilise des d&eacute;calages dans le code source traduit ; false si la fonction utilise le code source non
traduit.
Fonctions relatives &agrave; la traduction
293
La valeur par d&eacute;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&eacute;e explicitement avec l’argument false avant la fin de
l’ex&eacute;cution du script.
Valeurs renvoy&eacute;es
Aucune.
294
Chapitre 14 : Document
CHAPITRE 15
Contenu de page
Les fonctions relatives au contenu de page permettent d’effectuer des op&eacute;rations qui affectent le
contenu d’une page Web. Ces op&eacute;rations comprennent la manipulation d’actifs dans le panneau
Actifs, l’ajout de comportements, le coupage et le collage d’&eacute;l&eacute;ments provenant du Presse-papiers,
l’application d’un mod&egrave;le ou l’insertion d’un fragment de code.
Fonctions du panneau Actifs
Ces fonctions, programm&eacute;es dans l’API comme panneau d’actifs, vous permettent de g&eacute;rer et
d’utiliser les &eacute;l&eacute;ments contenus dans le panneau Actifs (mod&egrave;les, biblioth&egrave;ques, images, contenu
Shockwave et Flash de Macromedia, URL, couleurs et scripts).
dreamweaver.assetPalette.addToFavoritesFromDocument()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ajoute l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la fen&ecirc;tre de document &agrave; 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&eacute;es
Aucune.
dreamweaver.assetPalette.addToFavoritesFromSiteAssets()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ajoute les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s dans la liste des sites &agrave; la liste des favoris et donne &agrave; chaque
&eacute;l&eacute;ment un surnom. Cette fonction ne supprime pas les &eacute;l&eacute;ments de la liste des sites.
295
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.addToFavoritesFromSiteWindow()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ajoute les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s dans le panneau Site ou dans la carte du site &agrave; la liste des favoris.
Cette fonction prend uniquement en charge les images, les animations, les scripts, les fichiers
Shockwave, les fichiers Flash et les URL (dans le cas de la carte du site). Si d’autres dossiers ou
fichiers sont s&eacute;lectionn&eacute;s, ils sont ignor&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.copyToSite()
Disponibilit&eacute;
Dreamweaver 4.
Description
Copie les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s dans un autre site et les place dans la liste des favoris de ce site. Si
ces &eacute;l&eacute;ments sont des fichiers (autres que des couleurs ou des URL), le fichier r&eacute;el est copi&eacute; dans ce
site.
Arguments
targetSite
• L’argument targetSite est le nom du site cible renvoy&eacute; par l’appel site.getSites().
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.edit()
Disponibilit&eacute;
Dreamweaver 4.
296
Chapitre 15 : Contenu de page
Description
Modifie les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s &agrave; l’aide de l’&eacute;diteur externe principal ou de la commande
d’&eacute;dition personnalis&eacute;e. Pour les couleurs, le s&eacute;lecteur de couleur s’affiche. S’il s’agit d’URL, une
bo&icirc;te de dialogue invite l’utilisateur &agrave; 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&eacute;es
Aucune.
Activateur
dreamweaver.assetPalette.canEdit(), page 439.
dreamweaver.assetPalette.getSelectedCategory()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie la cat&eacute;gorie s&eacute;lectionn&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
La cat&eacute;gorie s&eacute;lectionn&eacute;e, qui peut &ecirc;tre l’une des cat&eacute;gories suivantes : &quot;templates&quot;, &quot;library&quot;,
&quot;images&quot;, &quot;movies&quot;, &quot;shockwave&quot;, &quot;flash&quot;, &quot;scripts&quot;, &quot;colors&quot; ou &quot;urls&quot;.
dreamweaver.assetPalette.getSelectedItems()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie un tableau des &eacute;l&eacute;ments s&eacute;lectionn&eacute;s dans le panneau Actifs, soit dans la liste des sites,
soit dans celle des favoris.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de trois cha&icirc;nes pour chaque &eacute;l&eacute;ment s&eacute;lectionn&eacute; :
• La cha&icirc;ne name est le nom, le nom de fichier ou le surnom qui s’affiche dans le panneau Actifs.
• La cha&icirc;ne value est le chemin entier, l’URL compl&egrave;te ou la valeur chromatique, selon
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
Fonctions du panneau Actifs
297
• La cha&icirc;ne type est soit &quot;folder&quot;, soit l’une des cat&eacute;gories suivantes : &quot;templates&quot;,
&quot;library&quot;, &quot;images&quot;, &quot;movies&quot;, &quot;shockwave&quot;, &quot;flash&quot;, &quot;scripts&quot;, &quot;colors&quot;
ou &quot;urls&quot;.
Remarque : Si aucun &eacute;l&eacute;ment n’est s&eacute;lectionn&eacute; dans le panneau Actifs, cette fonction renvoie un
tableau contenant une seule cha&icirc;ne vide.
Exemple
Si &laquo; URL &raquo; est la cat&eacute;gorie et que le dossier &laquo; MyFolderName &raquo; et l’URL &laquo; MyFavoriteURL &raquo; sont
s&eacute;lectionn&eacute;s dans la liste des favoris, la fonction renvoie :
items[0]
items[1]
items[2]
items[3]
items[4]
items[5]
=
=
=
=
=
=
&quot;MyFolderName&quot;
&quot;//path/FolderName&quot;
&quot;folder&quot;
&quot;MyFavoriteURL&quot;
&quot;http://www.MyFavoriteURL.com&quot;
&quot;urls&quot;
dreamweaver.assetPalette.getSelectedView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Indique quelle liste est affich&eacute;e dans le panneau Actifs.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Renvoie une cha&icirc;ne comportant la valeur &quot;site&quot; ou &quot;favorites&quot;.
dreamweaver.assetPalette.insertOrApply()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ins&egrave;re les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s ou applique l’&eacute;l&eacute;ment &agrave; la s&eacute;lection en cours. Il applique des
mod&egrave;les, des couleurs et des URL &agrave; la s&eacute;lection ; il ins&egrave;re &eacute;galement des URL et d’autres &eacute;l&eacute;ments
au niveau du point d’insertion. Si aucun document n’est ouvert, cette fonction n’est pas
disponible.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.assetPalette.canInsertOrApply(), page 439.
298
Chapitre 15 : Contenu de page
dreamweaver.assetPalette.locateInSite()
Disponibilit&eacute;
Dreamweaver 4.
Description
S&eacute;lectionne les fichiers associ&eacute;s aux &eacute;l&eacute;ments s&eacute;lectionn&eacute;s du c&ocirc;t&eacute; 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&eacute;lectionn&eacute; dans la liste des favoris, il est ignor&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.newAsset()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cr&eacute;e un nouvel &eacute;l&eacute;ment correspondant &agrave; la cat&eacute;gorie en cours dans la liste des favoris. Dans le cas
des biblioth&egrave;ques et des mod&egrave;les, l’&eacute;l&eacute;ment cr&eacute;&eacute; est un nouveau fichier de biblioth&egrave;que ou de
mod&egrave;le vierge auquel l’utilisateur peut imm&eacute;diatement attribuer un nom. Pour les couleurs, le
s&eacute;lecteur de couleur s’affiche. S’il s’agit d’URL, une bo&icirc;te de dialogue invite l’utilisateur &agrave; 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&eacute;es
Aucune.
dreamweaver.assetPalette.newFolder()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cr&eacute;e un nouveau dossier ayant un nom par d&eacute;faut (sans nom) dans la cat&eacute;gorie en cours et place
une zone de texte autour du nom. Cette fonction est uniquement disponible dans la liste des
favoris.
Arguments
Aucun.
Fonctions du panneau Actifs
299
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.recreateLibraryFromDocument()
Disponibilit&eacute;
Dreamweaver 4.
Description
Remplace l’ancienne fonction libraryPalette, recreateLibraryFromDocument(). Il
remplace un fichier d’&eacute;l&eacute;ment de biblioth&egrave;que (Library item ou LBI) pour l’instance s&eacute;lectionn&eacute;e
d’un &eacute;l&eacute;ment de biblioth&egrave;que dans le document actif. Revient &agrave; cliquer sur Cr&eacute;er &agrave; nouveau dans
l’inspecteur de propri&eacute;t&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.refreshSiteAssets()
Disponibilit&eacute;
Dreamweaver 4.
Description
Analyse le site, affiche la liste des sites et y ajoute des donn&eacute;es.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.removeFromFavorites()
Disponibilit&eacute;
Dreamweaver 4.
Description
Supprime les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s de la liste des favoris. Cette fonction ne supprime pas les
fichiers du disque, sauf dans le cas d’une biblioth&egrave;que ou d’un mod&egrave;le o&ugrave; l’utilisateur est invit&eacute; &agrave;
confirmer l’op&eacute;ration avant que le fichier ne soit supprim&eacute;. Cette fonction est uniquement
disponible dans la liste des favoris ou si la cat&eacute;gorie est Library ou Templates.
Arguments
Aucun.
300
Chapitre 15 : Contenu de page
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.renameNickname()
Disponibilit&eacute;
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&eacute;gorie
Library ou Template.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.setSelectedCategory()
Disponibilit&eacute;
Dreamweaver 4.
Description
Affiche une cat&eacute;gorie diff&eacute;rente.
Arguments
categoryType
• L’argument categoryType peut &ecirc;tre l’une des cat&eacute;gories suivantes : &quot;templates&quot;,
&quot;library&quot;, &quot;images&quot;, &quot;movies&quot;, &quot;shockwave&quot;, &quot;flash&quot;, &quot;scripts&quot;, &quot;colors&quot;
ou &quot;urls&quot;.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.assetPalette.setSelectedView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Passe de la liste des sites &agrave; la liste des favoris et vice versa.
Arguments
viewType
• L’argument viewType est une cha&icirc;ne qui peut &ecirc;tre &quot;site&quot; ou &quot;favorites&quot;.
Fonctions du panneau Actifs
301
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.libraryPalette.deleteSelectedItem() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3 ; d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.setSelectedCategory() et appeler
dreamweaver.assetPalette.removeFromFavorites().
Description
Cette fonction supprime l’&eacute;l&eacute;ment de biblioth&egrave;que s&eacute;lectionn&eacute; du panneau Biblioth&egrave;que et
supprime le fichier d’&eacute;l&eacute;ment de la biblioth&egrave;que Dreamweaver (LBI) qui lui est associ&eacute; du dossier
Library &agrave; la racine du site actuel. Il peut rester des instances de l’&eacute;l&eacute;ment supprim&eacute; sur certaines
pages du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.libraryPalette.getSelectedItem() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3 ; version d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.getSelectedItems().
Description
Cette fonction obtient le chemin de l’&eacute;l&eacute;ment de biblioth&egrave;que s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le chemin d’acc&egrave;s &agrave; l’&eacute;l&eacute;ment de biblioth&egrave;que, exprim&eacute; sous la forme d’une
URL de type file://.
dreamweaver.libraryPalette.newFromDocument() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3 ; d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.setSelectedCategory() et appeler dreamweaver.assetPalette.newAsset().
Description
Cette fonction cr&eacute;e un nouvel &eacute;l&eacute;ment de biblioth&egrave;que bas&eacute; sur l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le
document actif.
302
Chapitre 15 : Contenu de page
Arguments
bReplaceCurrent
• L’argument bReplaceCurrent est une valeur bool&eacute;enne indiquant si la s&eacute;lection doit &ecirc;tre
remplac&eacute;e par une instance du nouvel &eacute;l&eacute;ment de biblioth&egrave;que cr&eacute;&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.libraryPalette.recreateFromDocument() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3 ; version d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.recreateLibraryFromDocument().
Description
Cette fonction cr&eacute;e dans le document actif un fichier LBI correspondant &agrave; l’instance s&eacute;lectionn&eacute;e
d’un &eacute;l&eacute;ment de biblioth&egrave;que. Revient &agrave; cliquer sur Cr&eacute;er &agrave; nouveau dans l’inspecteur de
propri&eacute;t&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.libraryPalette.renameSelectedItem() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3 ; d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.setSelectedCategory() avec l’argument &quot;library&quot; et appeler
dreamweaver.assetPalette.renameNickname().
Description
Cette fonction transforme le nom de l’&eacute;l&eacute;ment de biblioth&egrave;que s&eacute;lectionn&eacute; en champ de texte et
permet &agrave; l’utilisateur de renommer la s&eacute;lection.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.referencePalette.getFontSize()
Disponibilit&eacute;
Dreamweaver 4.
Fonctions du panneau Actifs
303
Description
Renvoie la taille de police actuelle de la zone d’affichage du panneau R&eacute;f&eacute;rence.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Les tailles de police relatives exprim&eacute;es par les valeurs small, medium ou large.
dreamweaver.referencePalette.setFontSize()
Disponibilit&eacute;
Dreamweaver 4.
Description
Modifie la taille de police affich&eacute;e dans le panneau R&eacute;f&eacute;rence.
Arguments
fontSize
• L’argument fontSize correspond &agrave; l’une des tailles relatives suivantes : small, medium ou
large.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.templatePalette.deleteSelectedTemplate() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3, d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.setSelectedCategory() avec &quot;templates&quot; comme valeur d’argument et
appeler dreamweaver.assetPalette.removeFromFavorites().
Description
Cette fonction supprime le mod&egrave;le s&eacute;lectionn&eacute; du dossier des mod&egrave;les.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.templatePalette.getSelectedTemplate() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3 ; d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.getSelectedItems().
304
Chapitre 15 : Contenu de page
Description
Cette fonction obtient le chemin du mod&egrave;le s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le chemin d’acc&egrave;s du mod&egrave;le, exprim&eacute; sous la forme d’une URL de type file://.
dreamweaver.templatePalette.renameSelectedTemplate() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3, d&eacute;conseill&eacute;e dans Dreamweaver 4 ; utiliser &agrave; la place
dreamweaver.assetPalette.setSelectedCategory() avec &quot;templates&quot; comme valeur d’argument et
appeler dreamweaver.assetPalette.renameNickname().
Description
Cette fonction transforme le nom du mod&egrave;le s&eacute;lectionn&eacute; en champ de texte et permet &agrave;
l’utilisateur de renommer la s&eacute;lection.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux comportements
Ces fonctions vous permettent d’associer des comportements &agrave; un objet ou de les en dissocier,
d’identifier les comportements associ&eacute;s &agrave; un objet, d’obtenir des informations sur un objet auquel
est associ&eacute; un comportement, etc. Les m&eacute;thodes de l’objet dreamweaver.behaviorInspector
contr&ocirc;lent ou agissent uniquement sur la s&eacute;lection dans le panneau Comportements et non sur la
s&eacute;lection dans le document actif.
dom.addBehavior()
Disponibilit&eacute;
Dreamweaver 3.
Description
Associe un nouveau couple &eacute;v&eacute;nement/action (comportement) &agrave; l’&eacute;l&eacute;ment s&eacute;lectionn&eacute;. Cette
fonction n’est valide que pour le document actif.
Arguments
event, action, {eventBasedIndex}
• L’argument event est le gestionnaire d’&eacute;v&eacute;nements JavaScript &agrave; utiliser pour associer le
comportement &agrave; l’&eacute;l&eacute;ment (par exemple, onClick, onMouseOver ou onLoad).
Fonctions relatives aux comportements
305
• L’argument action est l’appel de fonction qui serait renvoy&eacute; par applyBehavior() si l’action
•
&eacute;tait ajout&eacute;e &agrave; l’aide du panneau Comportements (par exemple, &quot;MM_popupMsg(’Hello
World’)&quot;).
L’argument facultatif eventBasedIndex est la position &agrave; laquelle cette action doit &ecirc;tre ajout&eacute;e.
L’argument eventBasedIndex est un index de r&eacute;f&eacute;rence z&eacute;ro ; par cons&eacute;quent, s’il existe d&eacute;j&agrave;
deux actions associ&eacute;es &agrave; l’&eacute;v&eacute;nement en question et que vous sp&eacute;cifiez eventBasedIndex
comme &eacute;tant l’action 1, cette derni&egrave;re sera ins&eacute;r&eacute;e et ex&eacute;cut&eacute;e entre les deux autres. Si vous ne
d&eacute;finissez pas cet argument, l’action est ins&eacute;r&eacute;e &agrave; la suite des actions d&eacute;j&agrave; associ&eacute;es &agrave;
l’&eacute;v&eacute;nement sp&eacute;cifi&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.getBehavior()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’action qui se trouve &agrave; la position indiqu&eacute;e dans l’&eacute;v&eacute;nement sp&eacute;cifi&eacute;. Cette fonction agit
sur la s&eacute;lection en cours et n’est valide que pour le document actif.
Arguments
event, {eventBasedIndex}
• L’argument event est le gestionnaire d’&eacute;v&eacute;nements JavaScript &agrave; utiliser pour associer le
•
comportement &agrave; l’&eacute;l&eacute;ment (par exemple, onClick, onMouseOver ou onLoad).
L’argument facultatif eventBasedIndex est la position de l’action &agrave; obtenir. Par exemple, si
deux actions sont associ&eacute;es &agrave; l’&eacute;v&eacute;nement sp&eacute;cifi&eacute;, 0 est la premi&egrave;re et 1 la seconde. Si cet
argument n’est pas d&eacute;fini, la fonction renvoie toutes les actions associ&eacute;es &agrave; l’&eacute;v&eacute;nement sp&eacute;cifi&eacute;.
Valeurs renvoy&eacute;es
Cha&icirc;ne repr&eacute;sentant l’appel de fonction (par exemple
&quot;MM_swapImage(’document.Image1’,’document.Image1’,’foo.gif’,’#933292969950’)&quot;)
ou tableau de cha&icirc;nes, si vous n’avez pas d&eacute;fini l’argument eventBasedIndex.
dom.reapplyBehaviors()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si les fonctions associ&eacute;es aux appels de comportement sur le nœud sp&eacute;cifi&eacute; sont pr&eacute;sentes
dans la section HEAD du document et, dans le cas contraire, les y ins&egrave;re.
Arguments
elementNode
306
Chapitre 15 : Contenu de page
• L’argument elementNode est un nœud d’&eacute;l&eacute;ment du document actif. Si cet argument n’est pas
d&eacute;fini, Dreamweaver recherche les appels de comportement orphelins sur tous les nœuds
d’&eacute;l&eacute;ment du document.
Valeurs renvoy&eacute;es
Aucune.
dom.removeBehavior()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime l’action qui se trouve &agrave; la position indiqu&eacute;e dans l’&eacute;v&eacute;nement sp&eacute;cifi&eacute;. Cette fonction
agit sur la s&eacute;lection en cours et n’est valide que pour le document actif.
Arguments
event, {eventBasedIndex}
• L’argument event est le gestionnaire d’&eacute;v&eacute;nements &agrave; utiliser pour associer le comportement &agrave;
•
l’&eacute;l&eacute;ment (par exemple, onClick, onMouseOver ou onLoad). Si cet argument n’est pas d&eacute;fini,
toutes les actions sont supprim&eacute;es de l’&eacute;l&eacute;ment.
L’argument facultatif eventBasedIndex est la position de l’action &agrave; supprimer. Par exemple, si
deux actions sont associ&eacute;es &agrave; l’&eacute;v&eacute;nement sp&eacute;cifi&eacute;, 0 est la premi&egrave;re et 1 la seconde. Si cet
argument n’est pas d&eacute;fini, toutes les actions associ&eacute;es &agrave; l’&eacute;v&eacute;nement s&eacute;lectionn&eacute; sont
supprim&eacute;es.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.getBehaviorElement()
Disponibilit&eacute;
Dreamweaver 2.
Description
Obtient l’objet DOM correspondant &agrave; la balise &agrave; laquelle le comportement est appliqu&eacute;. Cette
fonction ne s’applique qu’aux fichiers d’action de comportement.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un objet DOM ou une valeur null. La fonction renvoie la valeur null dans les cas suivants :
• Lorsque le script en cours d’ex&eacute;cution n’est pas actif dans le contexte du panneau
Comportements ;
• Lorsque le panneau Comportements est utilis&eacute; pour modifier un comportement dans un
sc&eacute;nario ;
Fonctions relatives aux comportements
307
• Lorsque le script en cours d’ex&eacute;cution est appel&eacute; par la fonction
dreamweaver.popupAction()
;
• Lorsque le panneau Comportements associe un &eacute;v&eacute;nement &agrave; 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 &ecirc;tre utilis&eacute;e de la m&ecirc;me mani&egrave;re que la
fonction dreamweaver.getBehaviorTag() pour d&eacute;terminer si l’action s&eacute;lectionn&eacute;e est adapt&eacute;e &agrave; la
balise HTML s&eacute;lectionn&eacute;e. Elle vous permet en outre d’acc&eacute;der &agrave; des informations
compl&eacute;mentaires sur la balise et ses attributs. Comme indiqu&eacute; dans l’exemple suivant, si vous
cr&eacute;ez une action qui ne peut &ecirc;tre appliqu&eacute;e qu’&agrave; un lien hypertexte (A HREF) ne renvoyant pas &agrave;
un autre cadre ou une autre fen&ecirc;tre, utilisez la fonction getBehaviorElement() dans la fonction
qui initialise l’interface utilisateur de la bo&icirc;te de dialogue des param&egrave;tres.
function initializeUI(){
var theTag = dreamweaver.getBehaviorElement();
var CANBEAPPLIED = (theTag.tagName == &quot;A&quot; &amp;&amp; &not;
theTag.getAttribute(&quot;HREF&quot;) != null &amp;&amp; &not;
theTag.getAttribute(&quot;TARGET&quot;) == null);
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 without an explicit target]
}
}
dreamweaver.getBehaviorEvent() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 1.2, d&eacute;conseill&eacute;e dans Dreamweaver 2, car les actions sont d&eacute;sormais choisies avant
les &eacute;v&eacute;nements.
Description
Dans un fichier d’action de comportement, cette fonction obtient l’&eacute;v&eacute;nement qui d&eacute;clenche
l’action.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne repr&eacute;sentant l’&eacute;v&eacute;nement. Il s’agit de la cha&icirc;ne transmise &agrave; la fonction
canAcceptBehavior() sous la forme d’un argument (event).
dreamweaver.getBehaviorTag()
Disponibilit&eacute;
Dreamweaver 1.2.
308
Chapitre 15 : Contenu de page
Description
Obtient la source de la balise &agrave; laquelle le comportement est appliqu&eacute;. Cette fonction ne
s’applique qu’aux fichiers d’action.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne repr&eacute;sentant la source de la balise. Il s’agit de la cha&icirc;ne transmise &agrave; la fonction
canAcceptBehavior() sous forme d’argument (HTMLelement). Si cette fonction appara&icirc;t en
dehors d’un fichier d’action, la valeur renvoy&eacute;e est une cha&icirc;ne vide.
Exemple
Si vous cr&eacute;ez une action qui ne peut &ecirc;tre appliqu&eacute;e qu’&agrave; un lien hypertexte (A HREF), vous pouvez
utiliser la fonction getBehaviorTag(), comme indiqu&eacute; dans l’exemple suivant, dans la fonction
qui initialise l’interface utilisateur de la bo&icirc;te de dialogue des param&egrave;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&eacute;
Dreamweaver 2.
Description
Invoque une bo&icirc;te de dialogue de param&egrave;tres correspondant &agrave; l’action de comportement sp&eacute;cifi&eacute;e.
Pour l’utilisateur, cela revient &agrave; s&eacute;lectionner l’action dans le menu d&eacute;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&eacute; la bo&icirc;te de dialogue.
Remarque : Cette fonction peut &ecirc;tre appel&eacute;e au sein de la fonction objectTag() ou dans tout script
de fichier de commande ou dans le fichier de l’inspecteur de propri&eacute;t&eacute;s.
Arguments
actionName, {funcCall}
• L’argument actionName est une cha&icirc;ne contenant le nom d’un fichier dans le dossier
Configuration/Behaviors/Actions qui contient une action de comportement JavaScript (par
exemple, &quot;Timeline/Play Timeline.htm&quot;).
Fonctions relatives aux comportements
309
• L’argument facultatif funcCall est une cha&icirc;ne contenant un appel de fonction pour l’action
d&eacute;finie dans actionName (par exemple, &quot;MM_playTimeline(...)&quot;). Cet argument, s’il est
d&eacute;fini, est fourni par la fonction applyBehavior() du fichier d’action.
Valeurs renvoy&eacute;es
Appel de fonction de l’action de comportement. Lorsque l’utilisateur clique sur OK dans la bo&icirc;te
de dialogue des param&egrave;tres, le comportement est ajout&eacute; au document actif (les fonctions
appropri&eacute;es sont ajout&eacute;es dans la section HEAD du document, le code HTML peut &ecirc;tre ajout&eacute; au
d&eacute;but de la section BODY et d’autres modifications peuvent &ecirc;tre effectu&eacute;es dans le document).
L’appel de fonction (&quot;MM_playTimeline(...)&quot;, par exemple) n’est pas ajout&eacute; au document ; il
devient la valeur renvoy&eacute;e par cette fonction.
dreamweaver.behaviorInspector.getBehaviorAt()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le couple &eacute;v&eacute;nement/action (comportement) qui se trouve &agrave; la position indiqu&eacute;e dans le
panneau Comportements.
Arguments
positionIndex
• L’argument positionIndex est la position de l’action dans le panneau Comportements. La
premi&egrave;re action de la liste est &agrave; la position 0.
Valeurs renvoy&eacute;es
Tableau constitu&eacute; de deux &eacute;l&eacute;ments :
• Un gestionnaire d’&eacute;v&eacute;nements.
• Un appel de fonction ou une instruction JavaScript.
Exemple
&eacute;tant un index de base z&eacute;ro, si le panneau Comportements affiche la liste, un
appel &agrave; la fonction dreamweaver.behaviorInspector.getBehaviorAt(2) renvoie un tableau
constitu&eacute; de deux cha&icirc;nes : &quot;onMouseOver&quot; et
&quot;MM_changeProp(’document.moon’,’document.moon’,’src’,’sun.gif’,’MG’)&quot;.
positionIndex
dreamweaver.behaviorInspector.getBehaviorCount()
Disponibilit&eacute;
Dreamweaver 3.
Description
Compte le nombre d’actions associ&eacute;es &agrave; l’&eacute;l&eacute;ment actuellement s&eacute;lectionn&eacute; &agrave; l’aide de
gestionnaires d’&eacute;v&eacute;nements.
Arguments
Aucun.
310
Chapitre 15 : Contenu de page
Valeurs renvoy&eacute;es
Nombre entier qui repr&eacute;sente le nombre d’actions attach&eacute;es &agrave; l’&eacute;l&eacute;ment. Ce nombre est &eacute;quivalent
au nombre d’actions visibles dans le panneau Comportements et comprend les actions de
comportement Dreamweaver et le code JavaScript personnalis&eacute;.
Exemple
Un appel &agrave; la fonction dreamweaver.behaviorInspector.getBehaviorCount() pour le lien
s&eacute;lectionn&eacute; &lt;A HREF=&quot;javascript:setCookie()&quot; onClick=&quot;MM_popupMsg(’A cookie has
been set.’);parent.rightframe.location.href=’aftercookie.html’&quot;&gt; renvoie la
valeur 2.
dreamweaver.behaviorInspector.getSelectedBehavior()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la position de l’action s&eacute;lectionn&eacute;e dans le panneau Comportements.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un nombre entier qui repr&eacute;sente la position de l’action s&eacute;lectionn&eacute;e dans le panneau
Comportements ou –1 si aucune action n’est s&eacute;lectionn&eacute;e.
Exemple
Si la premi&egrave;re action du panneau Comportements est s&eacute;lectionn&eacute;e, comme le montre la figure ciapr&egrave;s, un appel &agrave; la fonction dreamweaver.behaviorInspector.getSelectedBehavior()
renvoie le nombre 0 :
dreamweaver.behaviorInspector.moveBehaviorDown()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions relatives aux comportements
311
Description
D&eacute;place une action de comportement vers le bas, &agrave; l’int&eacute;rieur d’une s&eacute;quence, en modifiant son
ordre d’ex&eacute;cution au sein d’un &eacute;v&eacute;nement.
Arguments
positionIndex
• L’argument positionIndex est la position de l’action dans le panneau Comportements. La
premi&egrave;re action de la liste est &agrave; la position 0.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Si le panneau Comportements est configur&eacute; comme dans l’illustration ci-apr&egrave;s, l’appel de la
fonction dreamweaver.behaviorInspector.moveBehaviorDown(2) aura pour effet
d’intervertir les positions des actions Pr&eacute;charger les images et Changer la propri&eacute;t&eacute; dans
l’&eacute;v&eacute;nement onMouseDown. Pour toute autre position, la fonction
dreamweaver.behaviorInspector.moveBehaviorDown() n’a aucun effet, car un seul
comportement est associ&eacute; aux &eacute;v&eacute;nements onClick et onFocus et le comportement figurant &agrave; la
position 3 se trouve d&eacute;j&agrave; &agrave; la fin du groupe onMouseDown.
dreamweaver.behaviorInspector.moveBehaviorUp()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place un comportement vers le haut, &agrave; l’int&eacute;rieur d’une s&eacute;quence, en modifiant son ordre
d’ex&eacute;cution au sein d’un &eacute;v&eacute;nement.
Arguments
positionIndex
• L’argument positionIndex est la position de l’action dans le panneau Comportements. La
premi&egrave;re action de la liste est &agrave; la position 0.
312
Chapitre 15 : Contenu de page
Valeurs renvoy&eacute;es
Aucune.
Exemple
Si le panneau Comportements est configur&eacute; comme dans l’illustration ci-apr&egrave;s, l’appel de la
fonction dreamweaver.behaviorInspector.moveBehaviorUp(3) aura pour effet d’intervertir
les positions des actions Pr&eacute;charger les images et Changer la propri&eacute;t&eacute; dans l’&eacute;v&eacute;nement
onMouseOver. Pour toute autre position, la fonction
dreamweaver.behaviorInspector.moveBehaviorUp() n’a aucun effet, car un seul
comportement est associ&eacute; aux &eacute;v&eacute;nements onClick et onFocus et le comportement figurant &agrave; la
position 2 se trouve d&eacute;j&agrave; au d&eacute;but du groupe onMouseDown.
dreamweaver.behaviorInspector.setSelectedBehavior()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne l’action qui se trouve &agrave; la position indiqu&eacute;e dans le panneau Comportements.
Arguments
positionIndex
• L’argument positionIndex est la position de l’action dans le panneau Comportements. La
premi&egrave;re action de la liste est &agrave; la position 0. Pour d&eacute;s&eacute;lectionner toutes les actions, sp&eacute;cifiez
l’index de position (positionIndex) sur –1. Sp&eacute;cifier une position &agrave; laquelle ne correspond
aucune action revient &agrave; sp&eacute;cifier –1.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux comportements
313
Exemple
Si le panneau Comportements est d&eacute;fini comme dans la figure suivante, l’appel de la fonction
dreamweaver.behaviorInspector.setSelection(2) s&eacute;lectionne l’action Changer la propri&eacute;t&eacute;
associ&eacute;e &agrave; l’&eacute;v&eacute;nement onMouseDown :
Fonctions relatives au Presse-papiers
Ces fonctions permettent de copier, de couper et de coller des informations &agrave; l’aide du Pressepapiers. Sur un ordinateur Macintosh, certaines fonctions du Presse-papiers peuvent &eacute;galement
&ecirc;tre appliqu&eacute;es aux champs de texte des bo&icirc;tes de dialogue et des panneaux flottants. Dans ce cas,
elles peuvent &ecirc;tre impl&eacute;ment&eacute;es en tant que m&eacute;thodes de l’objet dreamweaver ou en tant que
m&eacute;thodes de l’objet DOM. La version dreamweaver de la fonction agit sur la s&eacute;lection dans la
fen&ecirc;tre active, qu’il s’agisse d’une fen&ecirc;tre de document, de l’inspecteur de code ou du panneau
Site. Sur un ordinateur Macintosh, la fonction peut &eacute;galement &ecirc;tre appliqu&eacute;e au contenu
s&eacute;lectionn&eacute; d’une zone de texte s’il s’agit du champ en cours. La version DOM de la fonction agit
toujours sur la s&eacute;lection dans le document sp&eacute;cifi&eacute;.
dom.clipCopy()
Disponibilit&eacute;
Dreamweaver 3.
Description
Copie la s&eacute;lection dans le Presse-papiers avec toutes les balises HTML correspondantes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.clipCopyText()
Disponibilit&eacute;
Dreamweaver 3.
314
Chapitre 15 : Contenu de page
Description
Copie le texte s&eacute;lectionn&eacute; dans le Presse-papiers sans les balises HTML correspondantes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canClipCopyText(), page 430.
dom.clipCut()
Disponibilit&eacute;
Dreamweaver 3.
Description
Coupe la s&eacute;lection et la place dans le Presse-papiers, avec toutes les balises HTML
correspondantes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.clipPaste()
Disponibilit&eacute;
Dreamweaver 3.
Description
Colle le contenu du Presse-papiers dans le document actif, au niveau du point d’insertion ou par
dessus la s&eacute;lection en cours. Si le Presse-papiers contient des balises HTML, celles-ci sont
interpr&eacute;t&eacute;es comme telles.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canClipPaste(), page 430.
Fonctions relatives au Presse-papiers
315
Exemple
Si le Presse-papiers contient ABC Widgets, un appel &agrave; la fonction
dw.getDocumentDOM().clipPaste() produira le r&eacute;sultat suivant :
dom.clipPasteText()
Disponibilit&eacute;
Dreamweaver 3.
Description
Colle le contenu du Presse-papiers dans le document actif, au niveau du point d’insertion en
cours ou par dessus la s&eacute;lection en cours. Cette fonction remplace les sauts de ligne &eacute;ventuels par
des balises BR. Si le Presse-papiers contient des balises HTML, celles-ci ne sont pas interpr&eacute;t&eacute;es et
les s&eacute;parateurs de balises (&lt; &gt;) sont remplac&eacute;s par &amp;lt; et &amp;gt; respectivement.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canClipPasteText(), page 431.
316
Chapitre 15 : Contenu de page
Exemple
Si le Presse-papiers contient ce qui suit : &lt;code&gt;return true;&lt;/code&gt;, un appel &agrave; la fonction
dw.getDocumentDOM().clipPasteText() produira le r&eacute;sultat suivant :
dreamweaver.clipCopy()
Disponibilit&eacute;
Dreamweaver 3.
Description
Copie la s&eacute;lection &agrave; partir de la fen&ecirc;tre de document, la bo&icirc;te de dialogue, le panneau Site ou le
panneau flottant en cours dans le Presse-papiers.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canClipCopy(), page 440.
dreamweaver.clipCut()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime la s&eacute;lection dans la fen&ecirc;tre de document, la bo&icirc;te de dialogue, le panneau Site ou le
panneau flottant actif pour la placer dans le Presse-papiers.
Fonctions relatives au Presse-papiers
317
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canClipCut(), page 440.
dreamweaver.clipPaste()
Disponibilit&eacute;
Dreamweaver 3.
Description
Colle le contenu du Presse-papiers dans la fen&ecirc;tre de document, la bo&icirc;te de dialogue, le panneau
flottant ou le panneau Site actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canClipPaste(), page 440.
dreamweaver.getClipboardText()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient tout le texte m&eacute;moris&eacute; dans le Presse-papiers.
Arguments
{bAsText}
• La valeur bool&eacute;enne facultative bAsText sp&eacute;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&eacute;faut, cet
argument renvoie la valeur false.
Valeurs renvoy&eacute;es
Cha&icirc;ne repr&eacute;sentant le contenu du Presse-papiers (il peut s’agir de balises HTML) ou, si le Pressepapiers est vide, rien ne se passe.
318
Chapitre 15 : Contenu de page
Exemple
Si la fonction dreamweaver.getClipboardText() renvoie &quot;text &lt;b&gt;bold&lt;/b&gt; text&quot;, alors
dreamweaver.getClipboardText(true) renvoie &quot;text bold text&quot;.
Fonctions relatives aux &eacute;l&eacute;ments de biblioth&egrave;que et aux mod&egrave;les
Ces fonctions permettent d’effectuer des op&eacute;rations associ&eacute;es aux &eacute;l&eacute;ments de biblioth&egrave;que et aux
mod&egrave;les, telles que la cr&eacute;ation, la mise &agrave; jour et la rupture de liens entre un document et un
&eacute;l&eacute;ment de la biblioth&egrave;que ou un mod&egrave;le. Les m&eacute;thodes de l’objet
dreamweaver.libraryPalette contr&ocirc;lent ou agissent sur la s&eacute;lection dans les &eacute;l&eacute;ments de
biblioth&egrave;que du panneau Actifs, et non dans le document actif. De m&ecirc;me, les m&eacute;thodes de l’objet
dreamweaver.templatePalette contr&ocirc;lent ou agissent sur la s&eacute;lection dans les objets de mod&egrave;le
du panneau Actifs.
dom.applyTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
Applique un mod&egrave;le au document actif. Si vous ne sp&eacute;cifiez aucun argument, la bo&icirc;te de dialogue
S&eacute;lectionner le mod&egrave;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&egrave;le disponible sur le site en cours, exprim&eacute;
sous la forme d’une URL de type file://.
• L’argument bMaintainLink est une valeur bool&eacute;enne qui indique si le lien au mod&egrave;le d’origine
doit &ecirc;tre conserv&eacute; (true) ou non (false).
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canApplyTemplate(), page 429.
dom.detachFromLibrary()
Disponibilit&eacute;
Dreamweaver 3.
Description
Rompt le lien entre l’instance actuellement s&eacute;lectionn&eacute;e d’un &eacute;l&eacute;ment de biblioth&egrave;que et le fichier
LBI qui lui est associ&eacute; en supprimant les balises de verrouillage autour de la s&eacute;lection. Revient &agrave;
cliquer sur D&eacute;tacher de l’original dans l’inspecteur de propri&eacute;t&eacute;s.
Arguments
Aucun.
Fonctions relatives aux &eacute;l&eacute;ments de biblioth&egrave;que et aux mod&egrave;les
319
Valeurs renvoy&eacute;es
Aucune.
dom.detachFromTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;tache le document actif du mod&egrave;le qui lui est associ&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.getAttachedTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le chemin du mod&egrave;le associ&eacute; au document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le chemin d’acc&egrave;s du mod&egrave;le, exprim&eacute; sous la forme d’une URL de type file://.
dom.getEditableRegionList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste des r&eacute;gions modifiables dans le corps du document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de nœuds d’&eacute;l&eacute;ment.
Exemple
dom.getSelectedEditableRegion(), page 321.
320
Chapitre 15 : Contenu de page
dom.getIsLibraryDocument()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si le document est un &eacute;l&eacute;ment de biblioth&egrave;que.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si le document est un fichier LBI.
dom.getIsTemplateDocument()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si le document est un mod&egrave;le.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si le document est un fichier DWT.
dom.getSelectedEditableRegion()
Disponibilit&eacute;
Dreamweaver 3.
Description
Si la s&eacute;lection ou le point d’insertion se trouve &agrave; l’int&eacute;rieur d’une r&eacute;gion modifiable, cette fonction
obtient la position de cette derni&egrave;re parmi toutes celles qui existent dans le corps du document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un index dans le tableau renvoy&eacute; par la fonction dom.getEditbableRegionList(). Pour plus
d’informations, voir dom.getEditableRegionList(), page 320.
Fonctions relatives aux &eacute;l&eacute;ments de biblioth&egrave;que et aux mod&egrave;les
321
Exemple
Le code suivant affiche une bo&icirc;te de dialogue pr&eacute;sentant le contenu de la r&eacute;gion modifiable
s&eacute;lectionn&eacute;e :
var theDOM = dw.getDocumentDOM();
var edRegs = theDOM.getEditableRegionList();
var selReg = theDOM.getSelectedEditableRegion();
alert(edRegs[selReg].innerHTML);
dom.insertLibraryItem()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ins&egrave;re une instance d’un &eacute;l&eacute;ment de biblioth&egrave;que dans le document.
Arguments
libraryItemURL
• L’argument libraryItemURL est le chemin d’acc&egrave;s &agrave; un fichier LBI, exprim&eacute; sous la forme
d’une URL de type file://.
Valeurs renvoy&eacute;es
Aucune.
dom.markSelectionAsEditable()
Disponibilit&eacute;
Dreamweaver 3.
Description
Affiche la bo&icirc;te de dialogue Nouvelle r&eacute;gion modifiable. Lorsque l’utilisateur clique sur Nouvelle
r&eacute;gion, Dreamweaver marque la s&eacute;lection comme &eacute;tant modifiable et laisse le texte tel quel.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canMarkSelectionAsEditable(), page 435.
dom.newEditableRegion()
Disponibilit&eacute;
Dreamweaver 3.
322
Chapitre 15 : Contenu de page
Description
Affiche la bo&icirc;te de dialogue Nouvelle r&eacute;gion modifiable. Lorsque l’utilisateur clique sur Nouvelle
r&eacute;gion, Dreamweaver ins&egrave;re le nom de la r&eacute;gion dans le document, entre accolades ({ }), &agrave;
l’emplacement du point d’insertion.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canMakeNewEditableRegion(), page 435.
dom.removeEditableRegion()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime une r&eacute;gion modifiable du document. Si cette r&eacute;gion poss&egrave;de un contenu, celui-ci est
conserv&eacute; ; seuls les marqueurs de r&eacute;gion modifiable sont supprim&eacute;s.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canRemoveEditableRegion(), page 436.
dom.updateCurrentPage()
Disponibilit&eacute;
Dreamweaver 3.
Description
Met &agrave; jour les mod&egrave;les ou les &eacute;l&eacute;ments de biblioth&egrave;que du document, ou les deux. Cette fonction
n’est valide que pour le document actif.
Arguments
{typeOfUpdate}
• L’argument facultatif typeOfUpdate doit &ecirc;tre &quot;library&quot;, &quot;template&quot; ou &quot;both&quot;. S’il n’est
pas d&eacute;fini, il prend par d&eacute;faut la valeur &quot;both&quot;.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux &eacute;l&eacute;ments de biblioth&egrave;que et aux mod&egrave;les
323
dreamweaver.updatePages()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Mettre &agrave; jour les pages et s&eacute;lectionne les options sp&eacute;cifi&eacute;es.
Arguments
{typeOfUpdate}
• L’argument facultatif typeOfUpdate, si vous le sp&eacute;cifiez, doit &ecirc;tre &quot;library&quot;, &quot;template&quot; ou
&quot;both&quot;.
S’il n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur &quot;both&quot;.
Valeurs renvoy&eacute;es
Aucune.
Fonctions du panneau Fragments de code
Avec Dreamweaver, les d&eacute;veloppeurs Web peuvent modifier et enregistrer des blocs de code
r&eacute;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&eacute;
dans le dossier Configuration\Snippets. Les fragments de code fournis avec Dreamweaver sont
stock&eacute;s dans les dossiers suivants :
•
•
•
•
•
•
•
•
•
•
•
Accessible
Comments
Content_tables
Filelist.txt
Footers
Form_elements
Headers
Javascript
Meta
Navigation
Text
Les fichiers de fragment de code sont des documents XML. Par cons&eacute;quent, vous pouvez sp&eacute;cifier
le codage dans la directive XML de la mani&egrave;re suivante :
&lt;?XML version=&quot;1.0&quot; encoding=&quot;utf-8&quot;&gt;
Voici un exemple de fichier de fragment de code :
&lt;snippet name=&quot;Detect Flash&quot; description=&quot;VBscript to check for Flash ActiveX
control&quot; preview=&quot;code&quot; factory=&quot;true&quot; type=&quot;wrap&quot; &gt;
&lt;insertText location=&quot;beforeSelection&quot;&gt;
&lt;![CDATA[ ------- code --------- ]]&gt;
&lt;/insertText&gt;
&lt;insertText location=&quot;afterSelection&quot;&gt;
&lt;![CDATA[ ------- code --------- ]]&gt;
324
Chapitre 15 : Contenu de page
&lt;/insertText&gt;
&lt;/snippet&gt;
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&ccedil;u : &quot;code&quot; pour afficher le fragment de code dans la zone d’aper&ccedil;u ou
&quot;design&quot; pour afficher le fragment de code rendu en code HTML dans la zone
d’aper&ccedil;u.
type
&quot;wrap&quot; si le fragment de code sert &agrave; envelopper la s&eacute;lection de l’utilisateur, &quot;block&quot;
si le fragment de code doit &ecirc;tre ins&eacute;r&eacute; avant la s&eacute;lection.
Vous pouvez faire appel aux m&eacute;thodes suivantes pour ajouter les fonctions du panneau Fragments
de code &agrave; vos extensions.
dreamweaver.snippetPalette.getCurrentSnippetPath()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Renvoie le chemin du fragment actuellement s&eacute;lectionn&eacute; dans le panneau Fragments de code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Chemin, selon le dossier Snippets, du fragment actuellement s&eacute;lectionn&eacute; dans le panneau
Fragments de code. Renvoie une cha&icirc;ne vide si aucun fragment n’est s&eacute;lectionn&eacute;.
dreamweaver.snippetPalette.newFolder()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cr&eacute;e un nouveau dossier ayant un nom par d&eacute;faut (sans titre) et place une zone de texte autour
du nom.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions du panneau Fragments de code
325
dreamweaver.snippetPalette.newSnippet()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ouvre la bo&icirc;te de dialogue Ajouter un fragment de code et l’affiche au premier plan.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.snippetPalette.editSnippet()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ouvre la bo&icirc;te de dialogue Modifier le fragment de code et l’affiche au premier plan pour que
vous puissiez modifier l’&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.snippetpalette.canEditSnippet(), page 451.
dreamweaver.snippetPalette.insert()r
Disponibilit&eacute;
Dreamweaver MX.
Description
Applique le fragment s&eacute;lectionn&eacute; dans le panneau Fragment de code &agrave; la s&eacute;lection en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.snippetpalette.canInsert(), page 452.
326
Chapitre 15 : Contenu de page
dreamweaver.snippetPalette.insertSnippet()
Disponibilit&eacute;
Dreamweaver MX.
Description
Ins&egrave;re le fragment s&eacute;lectionn&eacute; dans la s&eacute;lection en cours.
Arguments
• Cha&icirc;ne sp&eacute;cifiant le chemin du fragment par rapport au dossier Snippets.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne.
Activateur
dreamweaver.snippetpalette.canInsert(), page 452.
Exemple
L’appel de la fonction dw.snippetPalette.insertSnippet() ins&egrave;re le fragment de code &agrave;
l’emplacement sp&eacute;cifi&eacute; par l’argument dans le document actif, au point d’insertion :
dw.snippetPalette.insertSnippet(’Text\\Different_Link_Color.csn’);
dreamweaver.snippetPalette.rename()
Disponibilit&eacute;
Dreamweaver MX.
Description
Affiche une zone de texte autour du nom du dossier ou du surnom du fichier s&eacute;lectionn&eacute; pour
permettre de le modifier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.snippetPalette.remove()
Disponibilit&eacute;
Dreamweaver MX.
Description
Supprime l’&eacute;l&eacute;ment ou le dossier s&eacute;lectionn&eacute; du panneau Fragment de code et supprime le fichier
du disque.
Valeurs renvoy&eacute;es
Aucune.
Fonctions du panneau Fragments de code
327
328
Chapitre 15 : Contenu de page
CHAPITRE 16
Documents dynamiques
Les fonctions de document dynamique de Macromedia Dreamweaver MX 2004 effectuent des
op&eacute;rations li&eacute;es aux pages de serveur Web. Ces op&eacute;rations peuvent, par exemple, &ecirc;tre le renvoi
d’une propri&eacute;t&eacute; pour le nœud s&eacute;lectionn&eacute; dans le panneau Composants, l’obtention d’une liste
des sources de donn&eacute;es dans le document utilisateur, l’affichage de contenu dynamique en mode
Cr&eacute;ation, l’application d’un comportement de serveur &agrave; un document ou encore l’obtention des
noms de tous les mod&egrave;les de serveur actuellement d&eacute;finis.
Fonctions de composants de serveur
Ces fonctions permettent d’acc&eacute;der au nœud s&eacute;lectionn&eacute; dans la commande d’arborescence
Composants de serveur qui appara&icirc;t dans le panneau Composants. Vous pouvez &eacute;galement les
utiliser pour actualiser l’affichage de l’arborescence de composants.
dreamweaver.serverComponents.getSelectedNode()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie la propri&eacute;t&eacute; ComponentRec s&eacute;lectionn&eacute;e dans la commande d’arborescence Composants
de serveur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
La propri&eacute;t&eacute; ComponentRec.
dreamweaver.serverComponents.refresh()
Disponibilit&eacute;
Dreamweaver MX.
Description
Actualise l’affichage de l’arborescence de composants.
329
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux sources de donn&eacute;es
Les fichiers de source de donn&eacute;es sont stock&eacute;s dans le dossier Configuration/DataSources. Tous
les mod&egrave;les de serveur ont leur propre dossier : ASP.Net/C#, ASP.Net/VisualBasic, ASP/
JavaScript, ASP/VBScript, ColdFusion, JSP et PHP/MySQL. Le sous-dossier de chaque mod&egrave;le
contient des fichiers HTML et EDML associ&eacute;s aux sources de donn&eacute;es de ce mod&egrave;le de serveur.
Pour plus d’informations sur l’utilisation de sources de donn&eacute;es dans Dreamweaver, voir Sources
de donn&eacute;es dans Extension de Dreamweaver.
dreamweaver.dbi.getDataSources
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Appelle la fonction findDynamicSources() pour chaque fichier contenu dans le dossier
Configuration/DataSources. Vous pouvez utiliser cette fonction pour g&eacute;n&eacute;rer une liste de toutes
les sources de donn&eacute;es du document de l’utilisateur. Cette fonction est r&eacute;p&eacute;t&eacute;e sur tous les fichiers
du dossier Configuration/DataSources, appelle la fonction findDynamicSources() dans chaque
fichier, concat&egrave;ne tous les tableaux renvoy&eacute;s et renvoie le tableau de sources de donn&eacute;es
concat&eacute;n&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un tableau contenant une liste concat&eacute;n&eacute;e de toutes les sources de donn&eacute;es contenues dans le
document de l’utilisateur. Chaque &eacute;l&eacute;ment du tableau est un objet et chaque objet a les propri&eacute;t&eacute;s
suivantes :
• La propri&eacute;t&eacute; title correspond au libell&eacute; qui appara&icirc;t &agrave; droite de l’ic&ocirc;ne de chaque nœud
parent. La propri&eacute;t&eacute; title est toujours d&eacute;finie.
• La propri&eacute;t&eacute; imageFile est le chemin de fichier contenant l’ic&ocirc;ne (une image GIF) qui
•
330
repr&eacute;sente le nœud parent dans les bo&icirc;tes de dialogue Donn&eacute;es dynamiques et Texte
dynamique ou dans le panneau Liaisons. La propri&eacute;t&eacute; imageFile est toujours d&eacute;finie.
La propri&eacute;t&eacute; allowDelete est facultative. Si cette propri&eacute;t&eacute; est d&eacute;finie sur la valeur false,
lorsque l’utilisateur clique sur ce nœud dans le panneau Liaisons, le bouton moins (-) appara&icirc;t
d&eacute;sactiv&eacute;. Si elle est d&eacute;finie sur la valeur true, le bouton moins () est activ&eacute;. Si la propri&eacute;t&eacute; n’est
pas d&eacute;finie, le bouton moins () est activ&eacute; lorsque l’utilisateur clique sur l’&eacute;l&eacute;ment (comme si la
propri&eacute;t&eacute; &eacute;tait d&eacute;finie sur la valeur true).
Chapitre 16 : Documents dynamiques
• La propri&eacute;t&eacute; dataSource est le nom du fichier dans lequel la fonction
findDynamicSources() est d&eacute;finie. Par exemple, la fonction findDynamicSources() dans le
•
fichier Session.htm, situ&eacute; dans le dossier Configuration/DataSources/ASP_Js, d&eacute;finit la
propri&eacute;t&eacute; dataSource sur session.htm. Cette propri&eacute;t&eacute; est toujours d&eacute;finie.
La propri&eacute;t&eacute; name est le nom du comportement de serveur associ&eacute; &agrave; la source de donn&eacute;es
dataSource, s’il existe. La propri&eacute;t&eacute; name est toujours d&eacute;finie, mais il peut s’agir d’une cha&icirc;ne
vide (&quot;&quot;) si aucun comportement de serveur n’est associ&eacute; &agrave; la source de donn&eacute;es (tel qu’une
variable de session).
Fonctions de l’Extension Data Manager
Le gestionnaire de donn&eacute;es d’extension (EDM) se compose des API de cette section. Vous pouvez
programmer l’acc&egrave;s et la manipulation des donn&eacute;es contenues dans les fichiers groupe et
participant en appelant ces fonctions. L’EDM fonctionne de la mani&egrave;re suivante :
• L’EDM ex&eacute;cute toutes les entr&eacute;es/sorties de fichier EDML pour les fichiers Groupe et
Participant.
• En ex&eacute;cutant toutes les demandes de donn&eacute;es pour le mod&egrave;le de serveur en cours, l ’EDM agit
comme un filtre de mod&egrave;le de serveur.
dreamweaver.getExtDataValue()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Cette fonction extrait les valeurs de champ d’un fichier EDML pour les nœuds sp&eacute;cifi&eacute;s.
Arguments
qualifier(s)
• L’argument qualifier(s) est une liste, de longueur variable (selon le niveau d’information
demand&eacute;) de qualificateurs de nœuds s&eacute;par&eacute;s par des virgules comprenant le nom du groupe
ou du participant, le sous-bloc (le cas &eacute;ch&eacute;ant) et le nom du champ.
Valeurs renvoy&eacute;es
Dreamweaver attend une valeur de champ. Si la valeur n’est pas sp&eacute;cifi&eacute;e, Dreamweaver utilise la
valeur par d&eacute;faut.
Exemple
L’exemple suivant extrait la valeur de l’attribut d’emplacement pour la balise insertText du
participant recordset_main participant :
dw.getExtDataValue(&quot;recordset_main&quot;, &quot;insertText&quot;, &quot;location&quot;);
dreamweaver.getExtDataArray()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Fonctions de l’Extension Data Manager
331
Description
Cette fonction extrait un tableau de valeurs d’un fichier EDML pour les nœuds sp&eacute;cifi&eacute;s.
Arguments
qualifier(s)
• L’argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds
s&eacute;par&eacute;s par des virgules, comprenant le nom du groupe ou du participant, le sous-bloc (le cas
&eacute;ch&eacute;ant) et le nom du champ.
Valeurs renvoy&eacute;es
Dreamweaver attend un tableau de noms de nœuds enfants.
dreamweaver.getExtParticipants()
Disponibilit&eacute;
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&eacute;t&eacute;. Il est ignor&eacute; s’il n’est pas renseign&eacute;. Par exemple,
dreamweaver.getExtParticipants(&quot;&quot;, &quot;participant&quot;);
• L’argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds ayant
la propri&eacute;t&eacute; requise, s&eacute;par&eacute;s par des virgules.
Valeurs renvoy&eacute;es
Dreamweaver attend un tableau de noms de participants ayant la propri&eacute;t&eacute; requise, si elle est
sp&eacute;cifi&eacute;e, et la propri&eacute;t&eacute; correspondant &agrave; la valeur requise, si elle est sp&eacute;cifi&eacute;e.
dreamweaver.getExtGroups()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Extrait le nom du groupe, qui est l’&eacute;quivalent du nom du comportement de serveur, d’un fichier
groupe EDML.
Arguments
value, qualifier(s)
• L’argument value est une valeur de propri&eacute;t&eacute;. Il est ignor&eacute; s’il n’est pas renseign&eacute;.
• L’argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds ayant
la propri&eacute;t&eacute; requise, s&eacute;par&eacute;s par des virgules.
332
Chapitre 16 : Documents dynamiques
Valeurs renvoy&eacute;es
Dreamweaver attend un tableau de noms de groupes ayant la propri&eacute;t&eacute; requise, si elle est sp&eacute;cifi&eacute;e,
et la propri&eacute;t&eacute; correspondant &agrave; la valeur requise, si elle est sp&eacute;cifi&eacute;e.
dreamweaver.refreshExtData()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
Recharge tous les fichiers de donn&eacute;es d’extension.
Conseil : Vous pouvez cr&eacute;er une commande utile &agrave; partir de cette fonction, qui vous permettra de
recharger les modifications apport&eacute;es aux fichiers EDML de comportement de serveur sans avoir &agrave;
red&eacute;marrer Dreamweaver.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Dreamweaver attend des donn&eacute;es recharg&eacute;es.
Fonctions Live data
Vous pouvez utiliser les fonctions Live Data suivantes pour reproduire les fonctionnalit&eacute;s de
menu :
• La fonction showLiveDataDialog() s’utilise pour l’&eacute;l&eacute;ment de menu Affichage &gt; Param&egrave;tres
Live Data.
• La fonction setLiveDataMode() s’utilise pour les &eacute;l&eacute;ments de menu Affichage &gt; Live Data et
•
Affichage &gt; Actualiser les donn&eacute;es dynamiques.
La fonction getLiveDataMode() d&eacute;termine si le mode Live Data est actif.
Vous pouvez utiliser les autres fonctions Live Data lorsque vous impl&eacute;mentez la fonction
liveDataTranslateMarkup() pour l’API du traducteur.
dreamweaver.getLiveDataInitTags()
Disponibilit&eacute;
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&icirc;te de dialogue Param&egrave;tres Live Data. Cette
fonction est g&eacute;n&eacute;ralement appel&eacute;e &agrave; partir de la fonction liveDataTranslateMarkup() d’un
traducteur, de fa&ccedil;on &agrave; ce que le traducteur puisse transmettre les balises &agrave; la fonction
liveDataTranslate().
Arguments
Aucun.
Fonctions Live data
333
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient les balises d’initialisation.
dreamweaver.getLiveDataMode()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
D&eacute;termine si la fen&ecirc;tre Live Data est actuellement visible.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si la fen&ecirc;tre Live Data est visible ; false dans le cas contraire.
dreamweaver.getLiveDataParameters ()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient les param&egrave;tres d’URL d&eacute;finis comme param&egrave;tres Live Data.
Le mode Live Data vous permet d’afficher une page Web au stade de conception (comme si elle
avait &eacute;t&eacute; traduite par le serveur d’application et renvoy&eacute;e). En g&eacute;n&eacute;rant un contenu dynamique
affichable en mode Cr&eacute;ation, vous pouvez visualiser la mise en forme d’une page avec ses donn&eacute;es
dynamiques et l’ajuster, le cas &eacute;ch&eacute;ant.
Avant d’afficher les donn&eacute;es dynamiques, vous devez saisir les param&egrave;tres Live Data de tout
param&egrave;tre d’URL auquel le document fait r&eacute;f&eacute;rence. Cela &eacute;vite que le serveur Web ne renvoie des
erreurs pour des param&egrave;tres qui ne sont pas encore d&eacute;finis au stade de la simulation.
La saisie des param&egrave;tres d’URL s’effectue par paire nom/valeur. Ainsi, si les scripts de serveur d’un
document font r&eacute;f&eacute;rence aux variables d’URL ID et Name, vous devez d&eacute;finir ces param&egrave;tres
d’URL avant d’afficher les donn&eacute;es dynamiques.
Vous pouvez saisir les param&egrave;tres Live Data depuis les endroits suivants dans Dreamweaver :
• Depuis la bo&icirc;te de dialogue Param&egrave;tres Live Data, accessible &agrave; partir du menu Affichage.
• Dans le champ de texte URL qui appara&icirc;t dans la partie sup&eacute;rieure du document lorsque vous
cliquez sur le bouton Affichage des donn&eacute;es dynamiques, situ&eacute; dans la barre d’outils.
Pour les param&egrave;tres ID et Name mentionn&eacute;s ci-dessus, vous pouvez saisir les paires suivantes :
ID
Name
22
Samuel
Dans l’URL, ces param&egrave;tres apparaissent alors comme indiqu&eacute; dans l’exemple ci-dessous :
http://someURL?ID=22&amp;Name=Samuel
Cette fonction vous permet d’obtenir les param&egrave;tres Live Data par le biais de JavaScript.
334
Chapitre 16 : Documents dynamiques
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau qui contient les param&egrave;tres d’URL du document actif. Le tableau contient un nombre
pair de cha&icirc;nes de param&egrave;tres. Chaque association de deux &eacute;l&eacute;ments repr&eacute;sente une paire nom/
valeur de param&egrave;tre d’URL. L’&eacute;l&eacute;ment pair correspond au nom du param&egrave;tre et l’&eacute;l&eacute;ment impair &agrave;
sa valeur. Dans l’exemple ci-dessus, getLiveDataParameters() renvoie donc le tableau suivant
pour les param&egrave;tres ID et Name : [’ID,’22’,’Name’,’Samuel’].
Exemple
L’exemple suivant renvoie les param&egrave;tres sp&eacute;cifi&eacute;s comme param&egrave;tres Live Data et les conserve
dans paramsArray :
var paramsArray = dreamweaver.getLiveDataParameters();
dreamweaver.liveDataTranslate()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Envoie un document HTML entier &agrave; un serveur d’application, demande au serveur d’ex&eacute;cuter les
scripts dans le document, puis renvoie le document HTML r&eacute;sultant. Cette fonction peut
&eacute;galement &ecirc;tre appel&eacute;e &agrave; partir de la fonction liveDataTranslateMarkup() d’un traducteur ; si
vous tentez de l’appeler &agrave; un autre moment, cela produit une erreur. La fonction
dreamweaver.liveDataTranslate() effectue les op&eacute;rations suivantes :
• Elle lit l’image anim&eacute;e (qui s’affiche &agrave; c&ocirc;t&eacute; du bord droit de la fen&ecirc;tre Live Data).
• Elle analyse les donn&eacute;es saisies par l’utilisateur. Si vous cliquez sur l’ic&ocirc;ne Arr&ecirc;ter, la fonction
•
•
•
•
•
•
•
est imm&eacute;diatement termin&eacute;e.
Elle accepte un argument contenant une seule cha&icirc;ne de l’appelant (cette cha&icirc;ne repr&eacute;sente
g&eacute;n&eacute;ralement le code source entier du document de l’utilisateur. Il s’agit de la m&ecirc;me cha&icirc;ne que
celle utilis&eacute;e dans l’op&eacute;ration suivante).
Elle enregistre la cha&icirc;ne HTML du document de l’utilisateur dans un fichier temporaire stock&eacute;
sur le serveur Live Data.
Elle envoie une requ&ecirc;te HTTP au serveur Live Data, en utilisant les param&egrave;tres d&eacute;finis dans la
bo&icirc;te de dialogue Param&egrave;tres Live Data.
Elle re&ccedil;oit la r&eacute;ponse HTML du serveur Live Data.
Elle supprime le fichier temporaire du serveur Live Data.
Elle arr&ecirc;te la lecture du fichier d’animation.
Elle renvoie la r&eacute;ponse HTML &agrave; l’appelant.
Arguments
• Une seule cha&icirc;ne, repr&eacute;sentant g&eacute;n&eacute;ralement le code source entier du document actif de
l’utilisateur.
Fonctions Live data
335
Valeurs renvoy&eacute;es
Objet httpReply. Cet objet est le m&ecirc;me que la valeur renvoy&eacute;e par la fonction
MMHttp.getText(). Si l’utilisateur clique sur l’ic&ocirc;ne Arr&ecirc;ter, le code httpReply.statusCode de
la valeur de retour est &eacute;gal &agrave; 200 (&eacute;tat OK) et son httpReply.data est &eacute;gal &agrave; une cha&icirc;ne vide.
Pour plus d’informations sur l’objet httpReply, voir Chapitre 3, API HTTP, page 43.
dreamweaver.setLiveDataError()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
D&eacute;termine le message d’erreur qui s’affiche si une erreur se produit lors de l’ex&eacute;cution de la
fonction liveDataTranslateMarkup() dans un traducteur. Si le document transmis par
Dreamweaver &agrave; liveDataTranslate() contient des erreurs, le serveur retransmet un message
d’erreur au format HTML. Si le traducteur (code ayant appel&eacute; liveDataTranslate())
d&eacute;termine que le serveur a renvoy&eacute; 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 &eacute;t&eacute; ex&eacute;cut&eacute;e ; Dreamweaver affiche la description dans une bo&icirc;te
de dialogue d’erreurs. La fonction setLiveDataError() doit uniquement &ecirc;tre appel&eacute;e &agrave; partir de
la fonction liveDataTranslateMarkup().
Arguments
source
• L’argument source est une cha&icirc;ne qui contient le code source, qui est analys&eacute; et affich&eacute; dans la
bo&icirc;te de dialogue du message d’erreur.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.setLiveDataMode()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Active ou d&eacute;sactive l’affichage de la fen&ecirc;tre Live Data.
Arguments
bIsVisible
• L’argument bIsVisible est une valeur bool&eacute;enne qui indique si la fen&ecirc;tre Live Data doit &ecirc;tre
visible. Si vous transmettez la valeur true &agrave; cette fonction et que Dreamweaver est d&eacute;fini pour
afficher la fen&ecirc;tre Live Data, l’effet est le m&ecirc;me que si l’utilisateur cliquait sur le bouton
Actualiser.
Valeurs renvoy&eacute;es
Aucune.
336
Chapitre 16 : Documents dynamiques
dreamweaver.setLiveDataParameters()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;finit les param&egrave;tres d’URL r&eacute;f&eacute;renc&eacute;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 &eacute;t&eacute; traduite par le serveur d’application et renvoy&eacute;e). En g&eacute;n&eacute;rant un contenu dynamique
affichable en mode Cr&eacute;ation, vous pouvez visualiser la mise en forme d’une page avec ses donn&eacute;es
dynamiques et l’ajuster, le cas &eacute;ch&eacute;ant.
Avant d’afficher les donn&eacute;es dynamiques, vous devez saisir les param&egrave;tres Live Data de tout
param&egrave;tre d’URL auquel le document fait r&eacute;f&eacute;rence. Cela &eacute;vite que le serveur Web ne renvoie des
erreurs pour des param&egrave;tres qui ne sont pas encore d&eacute;finis au stade de la simulation.
La saisie des param&egrave;tres d’URL s’effectue par paire nom/valeur. Ainsi, si les scripts de serveur d’un
document font r&eacute;f&eacute;rence aux variables d’URL ID et Name, vous devez d&eacute;finir ces param&egrave;tres
d’URL avant d’afficher les donn&eacute;es dynamiques.
Cette fonction vous permet de d&eacute;finir les valeurs Live Data par le biais de JavaScript.
Arguments
liveDataString
• L’argument liveDataString est une cha&icirc;ne qui contient les param&egrave;tres d’URL &agrave; d&eacute;finir, au
sein de paires nom/valeur.
Valeurs renvoy&eacute;es
Aucune.
Exemple
dreamweaver.setLiveDataParameters(“ID=22&amp;Name=Samuel”)
dreamweaver.showLiveDataDialog()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche la bo&icirc;te de dialogue Param&egrave;tres Live Data.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions Live data
337
Fonctions relatives aux comportements de serveur
Ces fonctions vous permettent de manipuler le panneau Comportements de serveur, accessible
sous Fen&ecirc;tre &gt; 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 &agrave; un document ou pour modifier un comportement existant, et ce par le
biais d’un programme.
Remarque : Vous pouvez abr&eacute;ger dw.serverBehaviorInspector en dw.sbi.
dreamweaver.getParticipants()
Disponibilit&eacute;
Dreamweaver UltraDev 4.
Description
La fonction JavaScript dreamweaver.getParticipants() r&eacute;pertorie les participants pr&eacute;sents
dans le document utilisateur. Une fois tous les participants du comportement trouv&eacute;s,
Dreamweaver m&eacute;morise ces listes de participants. En g&eacute;n&eacute;ral, cette fonction est utilis&eacute;e avec la
fonction findServerBehaviors() (pour plus d’informations, voir Comportements de serveur
dans Extension de Dreamweaver) pour rep&eacute;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 &agrave; localiser dans le document utilisateur. Cette cha&icirc;ne est le nom de fichier, sans
le suffixe d’extension .edml.
Valeurs renvoy&eacute;es
Cette fonction renvoie un tableau contenant toutes les instances du participant sp&eacute;cifi&eacute; (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 &eacute;l&eacute;ment pour chaque
instance de participant trouv&eacute;e dans le document utilisateur. Le tableau est tri&eacute; selon l’ordre dans
lequel les participants apparaissent dans le document. Chaque objet JavaScript pr&eacute;sente les
propri&eacute;t&eacute;s suivantes :
• La propri&eacute;t&eacute; participantNode est un pointeur reli&eacute; au nœud dans le document utilisateur et
•
•
•
•
338
consid&eacute;r&eacute; comme participant.
La propri&eacute;t&eacute; participantName est le nom du fichier EDML du participant (moins le
suffixe &laquo; .edml &raquo;).
La propri&eacute;t&eacute; parameters est un objet JavaScript qui stocke toutes les paires param&egrave;tre/valeur.
La propri&eacute;t&eacute; matchRangeMin d&eacute;finit le d&eacute;calage de caract&egrave;res &agrave; partir du nœud participant du
document jusqu’au d&eacute;but du contenu du participant.
La propri&eacute;t&eacute; matchRangeMax est un nombre entier du participant d&eacute;finissant le d&eacute;calage
depuis le d&eacute;but du nœud participant jusqu’au dernier caract&egrave;re du contenu du participant.
Chapitre 16 : Documents dynamiques
dreamweaver.serverBehaviorInspector.getServerBehaviors()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Affiche une liste de tous les comportements sur une page. Si Dreamweaver d&eacute;termine que la liste
interne des comportements de serveur n’est peut-&ecirc;tre pas &agrave; jour, il appelle la fonction
findServerBehaviors() pour chaque comportement install&eacute;. Chaque fonction renvoie un
tableau. Dreamweaver fusionne tous les tableaux en un seul tableau et le trie dans l’ordre o&ugrave;
chaque objet selectedNode de comportement appara&icirc;t dans le document. Dreamweaver stocke
le tableau fusionn&eacute; localement. La fonction getServerBehaviors() renvoie un pointeur au
tableau fusionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau d’objets JavaScript. L’appel findServerBehaviors() renvoie les objets dans le tableau.
Ils sont tri&eacute;s dans leur ordre d’apparition dans le panneau Comportements.
dreamweaver.popupServerBehavior()
Disponibilit&eacute;
Dreamweaver UltraDev 1.
Description
Applique un nouveau comportement de serveur au document ou modifie un comportement
existant. Si l’utilisateur doit d&eacute;finir les param&egrave;tres du comportement, une bo&icirc;te de dialogue
s’affiche.
Arguments
{behaviorName
ou behaviorObject}
• L’argument facultatif behaviorName est une cha&icirc;ne qui repr&eacute;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&eacute;finissez pas cet argument, Dreamweaver ex&eacute;cute le comportement de serveur
s&eacute;lectionn&eacute;. Si l’argument est le nom d’un comportement de serveur, Dreamweaver ajoute ce
comportement &agrave; la page. Si l’argument est l’un des objets du tableau renvoy&eacute; par la fonction
getServerBehaviors(), une bo&icirc;te de dialogue s’affiche pour permettre &agrave; l’utilisateur de
modifier les param&egrave;tres du comportement.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux comportements de serveur
339
Fonctions de mod&egrave;le de serveur
Dans Macromedia Dreamweaver, tous les documents ont un type de document associ&eacute;. Pour les
types de documents dynamiques, Dreamweaver associe &eacute;galement un mod&egrave;le de serveur (tel que
ASP-JS, ColdFusion ou PHP-MySQL).
Les mod&egrave;les de serveur sont utilis&eacute;s pour regrouper une fonctionnalit&eacute; sp&eacute;cifique &agrave; une
technologie de serveur. Diff&eacute;rents comportements de serveur, sources de donn&eacute;es, etc.,
apparaissent en fonction du mod&egrave;le de serveur associ&eacute; au document.
Utilisez les fonctions de mod&egrave;le de serveur pour d&eacute;terminer l’ensemble des mod&egrave;les de serveur
actuellement d&eacute;finis, le nom, la langue et la version du mod&egrave;le de serveur en cours, et si le mod&egrave;le
de serveur en cours prend en charge un ensemble nomm&eacute; de caract&egrave;res (tel que UTF-8).
Remarque : Dreamweaver lit toutes les informations contenues dans le fichier HTML du mod&egrave;le de
serveur et stocke ces informations lors du premier chargement du mod&egrave;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&eacute;es.
dom.serverModel.getAppURLPrefix()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie l’URL du dossier racine du site sur le serveur d’&eacute;valuation. Cette URL est la m&ecirc;me que
celle qui a &eacute;t&eacute; sp&eacute;cifi&eacute;e pour le serveur d’&eacute;valuation dans l’onglet Avanc&eacute; de la bo&icirc;te de dialogue
D&eacute;finition du site.
Lorsque Dreamweaver communique avec votre serveur d’&eacute;valuation, il utilise HTTP (de la m&ecirc;me
mani&egrave;re qu’un navigateur). Il utilise alors cette URL pour acc&eacute;der au dossier racine de votre site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui maintient l’URL au serveur d’application utilis&eacute; pour les donn&eacute;es dynamiques et le
d&eacute;bogage.
Exemple
Si l’utilisateur cr&eacute;e un site et pr&eacute;cise que le serveur d’&eacute;valuation est sur l’ordinateur local et que le
dossier racine est intitul&eacute; &laquo; employeeapp &raquo;, un appel &agrave; la fonction
dom.serverModel.getAppURLPrefix() renvoie la cha&icirc;ne suivante :
http://localhost/employeeapp/
dom.serverModel.getDelimiters()
Disponibilit&eacute;
Dreamweaver MX.
340
Chapitre 16 : Documents dynamiques
Description
Permet au code JavaScript d’obtenir le d&eacute;limiteur de script pour chaque mod&egrave;le de serveur, afin de
pouvoir s&eacute;parer la gestion du mod&egrave;le de serveur et celle du code utilisateur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau d’objets dans lequel tous les objets contiennent les trois propri&eacute;t&eacute;s suivantes :
• La propri&eacute;t&eacute; startPattern est une expression r&eacute;guli&egrave;re qui correspond au d&eacute;limiteur
•
•
d’ouverture de script.
La propri&eacute;t&eacute; endPattern est une expression r&eacute;guli&egrave;re qui correspond au d&eacute;limiteur de
fermeture de script.
Le mod&egrave;le participateInMerge est une valeur bool&eacute;enne qui indique si le contenu entre les
d&eacute;limiteurs utilis&eacute;s doit (true) ou non (false) prendre part &agrave; la fusion de blocs.
dom.serverModel.getDisplayName()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient le nom du mod&egrave;le de serveur qui appara&icirc;t dans l’interface utilisateur (UI).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne dont la valeur est le nom du mod&egrave;le de serveur.
dom.serverModel.getFolderName()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient le nom du dossier utilis&eacute; pour ce mod&egrave;le de serveur dans le dossier Configuration (tel que
le sous-dossier ServerModels).
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne dont la valeur est le nom du dossier.
Fonctions de mod&egrave;le de serveur
341
dom.serverModel.getServerExtension() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver UltraDev 4 ; d&eacute;conseill&eacute;e dans Dreamweaver MX.
Description
Renvoie l’extension par d&eacute;faut des fichiers exploitant le mod&egrave;le de serveur en cours (l’extension du
fichier par d&eacute;faut est la premi&egrave;re dans la liste). Si aucun document utilisateur n’est s&eacute;lectionn&eacute;,
l’objet serverModel est d&eacute;fini sur le mod&egrave;le de serveur du site actuellement s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui repr&eacute;sente les extensions de fichier prises en charge.
dom.serverModel.getServerIncludeUrlPatterns()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie la liste de propri&eacute;t&eacute;s, qui vous permet d’acc&eacute;der aux &eacute;l&eacute;ments suivants :
• Mod&egrave;les URL du traducteur
• R&eacute;f&eacute;rences du fichier
• Type
Arguments
Aucun.
Valeurs renvoy&eacute;es
Liste d’objets, un pour chaque searchPattern. Chaque objet pr&eacute;sente les propri&eacute;t&eacute;s suivantes :
342
Propri&eacute;t&eacute;
Description
pattern
Expression JavaScript r&eacute;guli&egrave;re sp&eacute;cifi&eacute;e dans le champ searchPattern d’un fichier
EDML (une expression r&eacute;guli&egrave;re est d&eacute;limit&eacute;e par deux barres obliques (//)).
fileRef
L’index de base 1 de la sous-correspondance de l’expression r&eacute;guli&egrave;re qui
correspond &agrave; la r&eacute;f&eacute;rence du fichier inclus.
type
La portion de la valeur paramName qui reste apr&egrave;s avoir &ocirc;t&eacute; le suffixe _includeUrl. Ce
type est affect&eacute; &agrave; l’attribut du type de balise &lt;MM:BeginLock&gt;. Pour avoir un exemple,
voir Server Model SSI.htm dans le dossier Configuration/Translators.
Chapitre 16 : Documents dynamiques
Exemple
Le fragment de code suivant d’un fichier participant illustre une balise searchPatterns de
traducteur :
&lt;searchPatterns whereToSearch=&quot;comment&quot;&gt;
&lt;searchPattern paramNames=&quot;,ssi_comment_includeUrl&quot;&gt;
&lt;![CDATA[/&lt;!--\s*#include\s+(file|virtual)\s*=\s*&quot;([^&quot;]*)&quot;\s*--&gt;/i]]&gt;
&lt;/searchPattern&gt;
&lt;/searchPatterns&gt;
Le mod&egrave;le de recherche contient une expression JavaScript r&eacute;guli&egrave;re qui sp&eacute;cifie deux souscorrespondances (toutes deux entre parenth&egrave;ses). La premi&egrave;re sous-correspondance est pour la
cha&icirc;ne de texte file ou virtual. La deuxi&egrave;me sous-correspondance est une r&eacute;f&eacute;rence de fichier.
Pour acc&eacute;der au mod&egrave;le URL du traducteur, votre code doit ressembler &agrave; l’exemple suivant :
var serverModel = dw.getDocumentDOM().serverModel;
var includeArray = new Array();
includeArray = serverModel.getServerIncludeUrlPatterns();
L’appel &agrave; la fonction serverModel.getServerIncludeUrlPatterns() renvoie les trois
propri&eacute;t&eacute;s suivantes :
Propri&eacute;t&eacute;
Valeur renvoy&eacute;e
pattern
/&lt;!--\s*#include\s+(file|virtual)\s*=\s*&quot;([^&quot;]*)&quot;\s*--&gt;/i
fileRef
2
type
ssi_comment
dom.serverModel.getServerInfo()
Disponibilit&eacute;
Dreamweaver MX.
Description
Renvoie des informations sp&eacute;cifiques au mod&egrave;le de serveur en cours. Ces informations figurent
dans le fichier de d&eacute;finition HTML correspondant au mod&egrave;le de serveur, situ&eacute; dans le dossier
Configuration/ServerModels.
Vous pouvez modifier les informations contenues dans le fichier de d&eacute;finition HTML ou placer
des valeurs ou fonctions de variable suppl&eacute;mentaires dans le fichier. Vous pouvez par exemple
modifier les propri&eacute;t&eacute;s serverName, serverLanguage et serverVersion. La fonction
dom.serverModel.getServerInfo() renvoie les informations ajout&eacute;es par l’auteur du mod&egrave;le
de serveur au fichier de d&eacute;finition.
Remarque : Les autres valeurs d&eacute;finies dans les fichiers de mod&egrave;les de serveur par d&eacute;faut sont
r&eacute;serv&eacute;es &agrave; un usage interne.
Les propri&eacute;t&eacute;s serverName, serverLanguage et serverVersion sont sp&eacute;cifiques, accessibles
directement au moyen des fonctions correspondantes suivantes :
•
•
•
dom.serverModel.getServerName()
dom.serverModel.getServerLanguage()
dom.serverModel.getServerVersion()
Fonctions de mod&egrave;le de serveur
343
Arguments
Aucun.
Valeurs renvoy&eacute;es
Objet JavaScript qui contient diverses informations sp&eacute;cifiques au mod&egrave;le de serveur en cours.
dom.serverModel.getServerLanguage() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver UltraDev 1 ; d&eacute;conseill&eacute;e dans Dreamweaver MX
Description
D&eacute;termine le mod&egrave;le de serveur associ&eacute; au document et renvoie cette valeur. Le langage serveur
d’un site est la valeur choisie dans le param&egrave;tre Langage de script par d&eacute;faut de l’onglet Infos du
serveur d’application de la bo&icirc;te de dialogue D&eacute;finition du site. Pour obtenir la valeur de retour,
cette fonction appelle la fonction getServerLanguage() dans l’API de mod&egrave;le de serveur.
Remarque : La liste Langage de script par d&eacute;faut existe uniquement dans Dreamweaver 4 et les
versions ant&eacute;rieures. Pour Dreamweaver MX (ou version sup&eacute;rieure), la bo&icirc;te de dialogue D&eacute;finition
du site ne r&eacute;pertorie pas les langages de script pris en charge. Toujours pour Dreamweaver MX (ou
version sup&eacute;rieure), la fonction dom.serverModel.getServerLanguage() lit la propri&eacute;t&eacute; serverLanguage
de l’objet renvoy&eacute; par un appel &agrave; la fonction getServerInfo() dans l’API de mod&egrave;le de serveur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient les langages de script pris en charge.
dom.serverModel.getServerName()
Disponibilit&eacute;
Dreamweaver 1 ; am&eacute;lior&eacute; dans la version Dreamweaver MX
Description
Extrait le nom du serveur associ&eacute; 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&ecirc;me
technologie de serveur (comme ASP.NET VB et ASP.NET C#). Parmi les valeurs possibles, on
retrouve ASP, ASP.NET, ColdFusion, JSP et PHP.
Pour extraire le nom de mod&egrave;le de serveur associ&eacute; au document, voir
dom.serverModel.getDisplayName(), page 341 ou dom.serverModel.getFolderName(), page 341.
Remarque : Pour Dreamweaver MX ou version ult&eacute;rieure, la fonction
dom.serverModel.getServerName() lit la propri&eacute;t&eacute; serverName de l’objet renvoy&eacute; par un appel &agrave; la
fonction getServerInfo() dans l’API de mod&egrave;le de serveur.
Arguments
Aucun.
344
Chapitre 16 : Documents dynamiques
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le nom du serveur.
dom.serverModel.getServerSupportsCharset()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si le mod&egrave;le de serveur associ&eacute; au document prend en charge le jeu de caract&egrave;res
nomm&eacute;.
Remarque : Dreamweaver vous permet d’appeler cette fonction &agrave; partir du calque JavaScript mais
aussi lorsque l’utilisateur modifie l’encodage dans la bo&icirc;te de dialogue des propri&eacute;t&eacute;s. Si le mod&egrave;le de
serveur ne prend pas en charge le nouvel encodage des caract&egrave;res, cette fonction renvoie la valeur
false et Dreamweaver affiche une bo&icirc;te de dialogue d’avertissement demandant &agrave; 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&icirc;ne qui d&eacute;nomme un jeu de caract&egrave;res
donn&eacute;. Cette valeur est la m&ecirc;me que celle de l’attribut &quot;charset=&quot; d’une balise meta associ&eacute;e &agrave;
un document. Les valeurs prises en charge pour un mod&egrave;le de serveur donn&eacute; sont d&eacute;finies dans
le fichier de d&eacute;finition HTML pour le mod&egrave;le de serveur, situ&eacute; dans le dossier Configuration/
ServerModels.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le mod&egrave;le de serveur prend en charge le jeu de caract&egrave;res nomm&eacute; ;
false dans le cas contraire.
dom.serverModel.getServerVersion()
Disponibilit&eacute;
Dreamweaver 1 ; am&eacute;lior&eacute; dans la version Dreamweaver MX
Description
D&eacute;termine le mod&egrave;le de serveur associ&eacute; au document et renvoie cette valeur. Chaque mod&egrave;le de
serveur a une fonction getVersionArray() (dans l’API de mod&egrave;le de serveur), qui renvoie un
tableau de couples nom-version.
Remarque : Pour Dreamweaver, la fonction dom.serverModel.getServerVersion() lit d’abord la
propri&eacute;t&eacute; serverVersion de l’objet renvoy&eacute; par un appel &agrave; la fonction getServerInfo() dans l’API de
mod&egrave;le de serveur. Si cette propri&eacute;t&eacute; n’existe pas, la fonction dom.serverModel.getServerVersion()
la lit &agrave; partir de la fonction getVersionArray().
Arguments
name
• L’argument name est une cha&icirc;ne repr&eacute;sentant le nom d’un mod&egrave;le de serveur.
Fonctions de mod&egrave;le de serveur
345
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient la version du mod&egrave;le de serveur nomm&eacute;.
dom.serverModel.testAppServer()
Disponibilit&eacute;
Dreamweaver MX.
Description
Teste s’il est possible d’&eacute;tablir une connexion au serveur d’application.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si la demande de connexion au serveur d’application a &eacute;t&eacute; accept&eacute;e.
dreamweaver.getServerModels()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient les noms de tous les mod&egrave;les de serveur actuellement d&eacute;finis. Les noms sont les m&ecirc;mes
que ceux qui apparaissent dans la zone de texte Mod&egrave;le de serveur de la bo&icirc;te de dialogue
D&eacute;finition du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes. Tous les &eacute;l&eacute;ments de cha&icirc;ne contiennent le nom d’un mod&egrave;le de serveur
actuellement d&eacute;fini.
346
Chapitre 16 : Documents dynamiques
CHAPITRE 17
Conception
Les fonctions de Conception de Macromedia Dreamweaver MX 2004 permettent d’effectuer des
op&eacute;rations en rapport avec la personnalisation de l’apparence d’un document. Ces op&eacute;rations
incluent des fonctions permettant d’appliquer le style de feuille de style en cascade (CSS) sp&eacute;cifi&eacute;,
de fractionner le cadre s&eacute;lectionn&eacute; verticalement ou horizontalement, d’aligner les calques ou
zones r&eacute;actives s&eacute;lectionn&eacute;s, d’ex&eacute;cuter le plug-in s&eacute;lectionn&eacute;, de cr&eacute;er une cellule de Mise en
forme ou de manipuler des lignes ou des colonnes d’un tableau.
Fonctions CSS
Ces fonctions permettent d’appliquer, de retirer, de cr&eacute;er et de supprimer des styles CSS. Les
m&eacute;thodes de l’objet dreamweaver.cssRuleTracker contr&ocirc;lent ou agissent sur l’&eacute;l&eacute;ment
s&eacute;lectionn&eacute; dans le panneau de suivi des r&egrave;gles CSS de l’inspecteur de s&eacute;lections. Les m&eacute;thodes de
l’objet dreamweaver.cssStylePalette contr&ocirc;lent ou agissent sur l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le
panneau Styles CSS, et non dans le document actif.
dom.applyCSSStyle()
Disponibilit&eacute;
Dreamweaver 4.
Description
Applique le style sp&eacute;cifi&eacute; &agrave; l’&eacute;l&eacute;ment sp&eacute;cifi&eacute;. Cette fonction n’est valide que pour le document
actif.
Arguments
elementNode, styleName, {classOrID}, {bForceNesting}
• L’argument elementNode d&eacute;signe un nœud d’&eacute;l&eacute;ment dans le DOM. Si l’argument
elementNode a pour valeur NULL ou est exprim&eacute; sous forme d’une cha&icirc;ne vide (&quot;&quot;), la fonction
agit sur la s&eacute;lection en cours.
• L’argument styleName est le nom d’un style CSS.
347
• L’argument facultatif classOrID est l’attribut avec lequel le style doit &ecirc;tre appliqu&eacute; (&quot;class&quot;
•
ou &quot;id&quot;). Si l’argument elementNode a pour valeur NULL ou s’il est exprim&eacute; sous forme d’une
cha&icirc;ne vide et qu’aucune balise n’entoure compl&egrave;tement la s&eacute;lection, le style est appliqu&eacute; avec
des balises SPAN. Si la s&eacute;lection est un point d’insertion, Dreamweaver utilise la m&eacute;thode
heuristique pour d&eacute;terminer &agrave; quelle balise le style doit &ecirc;tre appliqu&eacute;.
L’argument facultatif bForceNesting est une valeur bool&eacute;enne qui indique si l’imbrication est
autoris&eacute;e ou non. Si le drapeau bForceNesting est d&eacute;fini, Dreamweaver ins&egrave;re une nouvelle
balise SPAN au lieu de tenter de modifier les balises existantes dans le document. S’il n’est pas
d&eacute;fini, cet argument a la valeur false par d&eacute;faut.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Le code suivant applique le style red &agrave; la s&eacute;lection, soit en entourant cette derni&egrave;re de balises
SPAN, soit en appliquant un attribut CLASS aux balises qui entourent la s&eacute;lection :
var theDOM = dreamweaver.getDocumentDOM(’document’);
theDOM.applyCSSStyle(’’,’red’);
dom.removeCSSStyle()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime l’attribut CLASS ou ID de l’&eacute;l&eacute;ment sp&eacute;cifi&eacute; ou supprime les balises SPAN qui entourent
compl&egrave;tement l’&eacute;l&eacute;ment sp&eacute;cifi&eacute;. Cette fonction n’est valide que pour le document actif.
Arguments
elementNode, {classOrID}
• L’argument elementNode d&eacute;signe un nœud d’&eacute;l&eacute;ment dans le DOM. Si l’argument
est une cha&icirc;ne vide (&quot;&quot;), la fonction est appliqu&eacute;e &agrave; la s&eacute;lection en cours.
L’argument facultatif classOrID est l’attribut qui doit &ecirc;tre supprim&eacute; (&quot;class&quot; ou &quot;id&quot;). Si
l’argument classOrID n’est pas sp&eacute;cifi&eacute;, il prend par d&eacute;faut la valeur &quot;class&quot;. Si aucun
attribut CLASS n’est d&eacute;fini pour l’argument elementNode, les balises SPAN entourant
l’argument elementNode sont supprim&eacute;es.
elementNode
•
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.cssRuleTracker.editSelectedRule()
Disponibilit&eacute;
Dreamweaver MX 2004.
348
Chapitre 17 : Conception
Description
Permet &agrave; l’utilisateur de modifier la r&egrave;gle s&eacute;lectionn&eacute;e dans l’outil de suivi des r&egrave;gles. Cette
fonction affiche la r&egrave;gle s&eacute;lectionn&eacute;e dans la grille des propri&eacute;t&eacute;s CSS et, si cela s’av&egrave;re n&eacute;cessaire,
affiche la grille des propri&eacute;t&eacute;s ainsi que la palette qui la contient.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.cssRuleTracker.canEditSelectedRule(), page 446.
dreamweaver.cssRuleTracker.newRule()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Ouvre la bo&icirc;te de dialogue Nouveau style CSS pour permettre &agrave; l’utilisateur de cr&eacute;er une nouvelle
r&egrave;gle.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.cssStylePalette.applySelectedStyle()
Disponibilit&eacute;
Dreamweaver MX.
Description
Applique le style s&eacute;lectionn&eacute; au document actif ou &agrave; la feuille de style associ&eacute;e, en fonction de
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Styles CSS.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.cssStylePalette.canApplySelectedStyle(), page 447.
Fonctions CSS
349
dreamweaver.cssStylePalette.attachStyleSheet()
Disponibilit&eacute;
Dreamweaver 4.
Description
Affiche une bo&icirc;te de dialogue qui permet aux utilisateurs d’attacher une feuille de style au
document actif ou &agrave; l’une des feuilles de style qui y sont associ&eacute;es en fonction de l’&eacute;l&eacute;ment
s&eacute;lectionn&eacute; dans le panneau Styles CSS.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.cssStylePalette.deleteSelectedStyle()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime du document le style actuellement s&eacute;lectionn&eacute; dans le panneau Styles CSS.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.cssStylePalette.canDeleteSelectedStyle(), page 447.
dreamweaver.cssStylePalette.duplicateSelectedStyle()
Disponibilit&eacute;
Dreamweaver 3.
Description
Duplique le style actuellement s&eacute;lectionn&eacute; dans le panneau Styles CSS et affiche la bo&icirc;te de
dialogue Dupliquer le style afin de permettre &agrave; l’utilisateur d’attribuer un nom ou un s&eacute;lecteur au
nouveau style.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
350
Chapitre 17 : Conception
Activateur
dreamweaver.cssStylePalette.canDuplicateSelectedStyle(), page 447.
dreamweaver.cssStylePalette.editSelectedStyle()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue D&eacute;finition du style correspondant au style s&eacute;lectionn&eacute; dans le panneau
Styles CSS.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.cssStyle.canEditSelectedStyle(), page 448.
dreamweaver.cssStylePalette.editStyleSheet()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Modifier feuille de style.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.cssStylePalette.canEditStyleSheet(), page 448.
dreamweaver.cssStylePalette.getMediaType()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Permet d’obtenir le type de m&eacute;dia cible pour le rendu. Le type de m&eacute;dia par d&eacute;faut est &quot;screen&quot;.
Fonctions CSS
351
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne indiquant le type de m&eacute;dia cible.
Exemple
var mediaType = dw.cssStylePalette.getMediaType();
dreamweaver.cssStylePalette.getSelectedStyle()
Disponibilit&eacute;
Dreamweaver 3.0 ; fullSelector disponible dans Dreamweaver MX.
Description
Obtient le nom du style actuellement s&eacute;lectionn&eacute; dans le panneau Styles CSS.
Arguments
fullSelector
• L’argument fullSelector est une valeur bool&eacute;enne qui indique si le s&eacute;lecteur complet ou la
classe uniquement doivent &ecirc;tre renvoy&eacute;s. Si rien n’est pr&eacute;cis&eacute;, seul le nom de classe est renvoy&eacute;.
Par exemple, p.class1 est un s&eacute;lecteur qui signifie que le style est appliqu&eacute; &agrave; n’importe quelle
balise p de class1, mais il ne s’applique pas, par exemple, &agrave; une balise div de class1. Sans
l’argument fullSelector, la fonction
dreamweaver.cssStylePalette.getSelectedStyle() renvoie uniquement le nom de
classe, class1, pour le s&eacute;lecteur. L’argument fullSelector ordonne &agrave; la fonction de renvoyer
p.class1 au lieu de class1.
Valeurs renvoy&eacute;es
Lorsque l’argument fullSelector a la valeur true, la fonction renvoie soit le s&eacute;lecteur complet,
soit une cha&icirc;ne vide lorsque le nœud de la feuille de style est s&eacute;lectionn&eacute;.
Lorsque l’argument fullSelector a la valeur false ou est ignor&eacute;, une cha&icirc;ne qui repr&eacute;sente le
nom de classe du style s&eacute;lectionn&eacute; est renvoy&eacute;e. Si le style s&eacute;lectionn&eacute; n’a pas de classe ou si un
nœud de feuille de style est s&eacute;lectionn&eacute;, une cha&icirc;ne vide est renvoy&eacute;e.
Exemple
Si le style red est s&eacute;lectionn&eacute;, un appel &agrave; la fonction
dw.cssStylePalette.getSelectedStyle() renvoie &quot;red&quot;.
dreamweaver.cssStylePalette.getSelectedTarget() (d&eacute;conseill&eacute;e)
Disponibilit&eacute;
Dreamweaver 3, d&eacute;conseill&eacute;e dans Dreamweaver MX, car le menu Appliquer &agrave; n’existe plus dans
le panneau Styles CSS.
Description
Cette fonction permet d’obtenir l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le menu d&eacute;roulant Appliquer &agrave;, en
haut du panneau Styles CSS.
352
Chapitre 17 : Conception
Arguments
Aucun.
Valeurs renvoy&eacute;es
Fonction ancienne ; renvoie toujours une valeur null.
dreamweaver.cssStylePalette.getStyles()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste de tous les styles de classe que contient le document actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes repr&eacute;sentant les noms de tous les styles de classe contenus dans le document.
Exemple
Si la configuration du panneau Styles CSS est calqu&eacute;e sur l’exemple suivant, un appel &agrave; la
fonction dreamweaver.cssStylePalette.getStyles() renvoie un tableau qui contient ces
cha&icirc;nes : &quot;BreadcrumbEnd&quot;, &quot;change&quot;, &quot;doctitle&quot;, &quot;heading&quot; et &quot;highlight&quot; :
dreamweaver.cssStylePalette.newStyle()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Nouveau style.
Arguments
Aucun.
Fonctions CSS
353
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.cssStylePalette.setMediaType()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Permet de d&eacute;finir le type de m&eacute;dia cible pour le rendu. Actualise le rendu de tous les documents
ouverts.
Arguments
mediaType
• L’argument mediaType indique le nouveau type de m&eacute;dia cible.
Valeurs renvoy&eacute;es
Aucune.
Exemple
dw.cssStylePalette.setMediaType(&quot;print&quot;);
Fonctions relatives aux cadres et aux jeux de cadres
Ces fonctions permettent d’effectuer les op&eacute;rations suivantes : obtenir le nom des cadres
constituant un jeu de cadres et diviser un cadre en deux.
dom.getFrameNames()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste de tous les cadres nomm&eacute;s du jeu de cadres.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes o&ugrave; chaque cha&icirc;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&eacute;, un
tableau vide est renvoy&eacute;.
Exemple
Pour un document contenant quatre cadres, dont deux nomm&eacute;s, un appel &agrave; la fonction
dom.getFrameNames() pourrait renvoyer un tableau contenant les cha&icirc;nes suivantes :
•
•
354
&quot;navframe&quot;
&quot;main_content&quot;
Chapitre 17 : Conception
dom.isDocumentInFrame()
Disponibilit&eacute;
Dreamweaver 4.
Description
Indique si le document actif est affich&eacute; &agrave; l’int&eacute;rieur d’un jeu de cadres.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le document se trouve dans un jeu de cadres et false dans le cas
contraire.
dom.saveAllFrames()
Disponibilit&eacute;
Dreamweaver 4.
Description
Si un document est un jeu de cadres ou se trouve &agrave; l’int&eacute;rieur d’un jeu de cadres, cette fonction
enregistre tous les cadres ou les jeux de la fen&ecirc;tre de document. Si le document sp&eacute;cifi&eacute; ne se
trouve pas dans un jeu de cadres, cette fonction enregistre le document. Cette fonction ouvre la
bo&icirc;te de dialogue Enregistrer sous pour tous les documents qui n’ont pas &eacute;t&eacute; enregistr&eacute;s
pr&eacute;c&eacute;demment.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.splitFrame()
Disponibilit&eacute;
Dreamweaver 3.
Description
Fractionne le cadre s&eacute;lectionn&eacute; verticalement ou horizontalement.
Arguments
splitDirection
• L’argument splitDirection est une cha&icirc;ne qui doit indiquer l’une des directions suivantes :
&quot;up&quot;, &quot;down&quot;, &quot;left&quot;
ou &quot;right&quot;.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives aux cadres et aux jeux de cadres
355
Activateur
dom.canSplitFrame(), page 437.
Fonctions relatives aux calques et aux cartes graphiques
Ces fonctions permettent d’aligner, de redimensionner et de d&eacute;placer des calques et des zones
r&eacute;actives de carte graphique. Il est indiqu&eacute;, dans la description de chaque fonction, si cette
derni&egrave;re s’applique aux calques ou aux zones r&eacute;actives.
dom.align()
Disponibilit&eacute;
Dreamweaver 3.
Description
Aligne &agrave; gauche, &agrave; droite, en haut ou en bas les calques ou zones r&eacute;actives s&eacute;lectionn&eacute;s.
Arguments
alignDirection
• L’argument alignDirection est une cha&icirc;ne qui repr&eacute;sente le bord par rapport auquel aligner
les calques ou les zones r&eacute;actives, &agrave; savoir &quot;left&quot;, &quot;right&quot;, &quot;top&quot; ou &quot;bottom&quot;.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canAlign(), page 429.
dom.arrange()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place les zones r&eacute;actives s&eacute;lectionn&eacute;es dans le sens indiqu&eacute;.
Arguments
toBackOrFront
• L’argument toBackOrFront correspond au sens du d&eacute;placement des zones r&eacute;actives, &agrave; savoir
front ou back.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canArrange(), page 430.
356
Chapitre 17 : Conception
dom.makeSizesEqual()
Disponibilit&eacute;
Dreamweaver 3.
Description
Affecte aux calques ou aux zones r&eacute;actives s&eacute;lectionn&eacute;s la m&ecirc;me hauteur ou la m&ecirc;me largeur, ou
les deux. Le dernier calque ou la derni&egrave;re zone r&eacute;active s&eacute;lectionn&eacute;e sert de guide.
Arguments
bHoriz, bVert
• L’argument bHoriz est une valeur bool&eacute;enne qui indique si les calques ou les zones r&eacute;actives
•
doivent &ecirc;tre redimensionn&eacute;s horizontalement.
L’argument bVert est une valeur bool&eacute;enne qui indique si les calques ou les zones r&eacute;actives
doivent &ecirc;tre redimensionn&eacute;s verticalement.
Valeurs renvoy&eacute;es
Aucune.
dom.moveSelectionBy()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place les calques ou les zones r&eacute;actives s&eacute;lectionn&eacute;s horizontalement et verticalement du
nombre de pixels sp&eacute;cifi&eacute;s.
Arguments
x, y
• L’argument x est le nombre de pixels dont la s&eacute;lection doit &ecirc;tre d&eacute;plac&eacute;e horizontalement.
• L’argument y est le nombre de pixels dont la s&eacute;lection doit &ecirc;tre d&eacute;plac&eacute;e verticalement.
Valeurs renvoy&eacute;es
Aucune.
dom.resizeSelectionBy()
Disponibilit&eacute;
Dreamweaver 3.
Description
Redimensionne le calque ou la zone r&eacute;active s&eacute;lectionn&eacute;e.
Arguments
left, top, bottom, right.
Fonctions relatives aux calques et aux cartes graphiques
357
•
•
•
•
L’argument left est la nouvelle position de la limite gauche du calque ou de la zone r&eacute;active.
L’argument top est la nouvelle position de la limite sup&eacute;rieure du calque ou de la zone r&eacute;active.
L’argument bottom est la nouvelle position de la limite inf&eacute;rieure du calque ou de la zone r&eacute;active.
L’argument right est la nouvelle position de la limite droite du calque ou de la zone r&eacute;active.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Si le calque s&eacute;lectionn&eacute; poss&egrave;de les propri&eacute;t&eacute;s Gauche (left), Sommet (top), Largeur (width) et
Hauteur (height) indiqu&eacute;es, un appel &agrave; la fonction
dw.getDocumentDOM().resizeSelectionBy(–10,–30,30,10) revient &agrave; restaurer Gauche &agrave; 40,
Sommet &agrave; 20, Largeur &agrave; 240 et Hauteur &agrave; 240.
dom.setLayerTag()
Disponibilit&eacute;
Dreamweaver 3.
Description
Sp&eacute;cifie la balise HTML d&eacute;finissant le ou les calques s&eacute;lectionn&eacute;s.
Arguments
tagName
• L’argument tagName doit &ecirc;tre &quot;layer&quot;, &quot;ilayer&quot;,
&quot;div&quot;
ou &quot;span&quot;.
Valeurs renvoy&eacute;es
Aucune.
Fonctions d’environnement de mise en forme
Ces fonctions permettent d’effectuer des op&eacute;rations associ&eacute;es aux param&egrave;tres d’utilisation d’un
document. Elles permettent de modifier la source, la position et l’opacit&eacute; du trac&eacute; de l’image,
d’obtenir et de d&eacute;finir l’origine et les unit&eacute;s de mesure de la r&egrave;gle, d’activer et de d&eacute;sactiver la grille
et d’en modifier les param&egrave;tres, de d&eacute;marrer et d’arr&ecirc;ter l’ex&eacute;cution des plug-ins.
dom.getRulerOrigin()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’origine de la r&egrave;gle.
358
Chapitre 17 : Conception
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau contenant deux nombres entiers. Le premier entier correspond &agrave; la coordonn&eacute;e x de
l’origine, et le second &agrave; la coordonn&eacute;e y. Les deux valeurs sont exprim&eacute;es en pixels.
dom.getRulerUnits()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient les unit&eacute;s de mesure actuelles de la r&egrave;gle.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient l’une des valeurs suivantes :
•
•
•
&quot;in&quot;
&quot;cm&quot;
&quot;px&quot;
dom.getTracingImageOpacity()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le param&egrave;tre d’opacit&eacute; du trac&eacute; de l’image dans le document actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur comprise entre 0 et 100, ou rien si l’opacit&eacute; n’est pas d&eacute;finie.
Activateur
dom.hasTracingImage(), page 439.
dom.loadTracingImage()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions d’environnement de mise en forme
359
Description
Ouvre la bo&icirc;te de dialogue S&eacute;lectionner source de l’image. Si l’utilisateur s&eacute;lectionne une image et
clique sur OK, la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la page s’ouvre et le champ Trac&eacute; de l’image
contient une valeur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.playAllPlugins()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ex&eacute;cute tous les plug-ins dans le document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.playPlugin()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ex&eacute;cute le plug-in s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canPlayPlugin(), page 435.
dom.setRulerOrigin()
Disponibilit&eacute;
Dreamweaver 3.
360
Chapitre 17 : Conception
Description
D&eacute;finit l’origine de la r&egrave;gle.
Arguments
xCoordinate, yCoordinate
• L’argument xCoordinate est une valeur, exprim&eacute;e en pixels, sur l’axe horizontal.
• L’argument yCoordinate est une valeur, exprim&eacute;e en pixels, sur l’axe vertical.
Valeurs renvoy&eacute;es
Aucune.
dom.setRulerUnits()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit les unit&eacute;s de mesure de la r&egrave;gle.
Arguments
units
• L’argument units doit &ecirc;tre &quot;px&quot;, &quot;in&quot; ou &quot;cm&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.setTracingImagePosition()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place le coin sup&eacute;rieur gauche du trac&eacute; de l’image vers les coordonn&eacute;es sp&eacute;cifi&eacute;es. Si les
arguments ne sont pas d&eacute;finis, la bo&icirc;te de dialogue Ajuster la position du trac&eacute; de l’image s’affiche.
Arguments
x, y
• L’argument x est le nombre de pixels d&eacute;finissant la coordonn&eacute;e horizontale.
• L’argument y est le nombre de pixels d&eacute;finissant la coordonn&eacute;e verticale.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.hasTracingImage(), page 439.
Fonctions d’environnement de mise en forme
361
dom.setTracingImageOpacity()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit le pourcentage d’opacit&eacute; du trac&eacute; de l’image.
Arguments
opacityPercentage
• L’argument opacityPercentage doit &ecirc;tre un nombre compris entre 0 et 100.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.hasTracingImage(), page 439.
Exemple
L’exemple de code suivant r&egrave;gle l’opacit&eacute; du trac&eacute; de l’image sur 30 %.
dw.getDocumentDOM().setTracingOpacity(’30’);
dom.snapTracingImageToSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Aligne le coin sup&eacute;rieur gauche du trac&eacute; de l’image avec le coin sup&eacute;rieur gauche de la s&eacute;lection en
cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.hasTracingImage(), page 439.
dom.stopAllPlugins()
Disponibilit&eacute;
Dreamweaver 3.
Description
Arr&ecirc;te l’ex&eacute;cution de tous les plug-ins en cours dans le document.
362
Chapitre 17 : Conception
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.stopPlugin()
Disponibilit&eacute;
Dreamweaver 3.
Description
Arr&ecirc;te le plug-in s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si la s&eacute;lection est ex&eacute;cut&eacute;e actuellement avec un plug-in.
Activateur
dom.canStopPlugin(), page 438.
dreamweaver.arrangeFloatingPalettes()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;place les panneaux flottants visibles vers leur position par d&eacute;faut.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.showGridSettingsDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Param&egrave;tres de la grille.
Arguments
Aucun.
Fonctions d’environnement de mise en forme
363
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives au mode de Mise en forme
Ces fonctions permettent de modifier les &eacute;l&eacute;ments de mise en forme d’un document. Elles
s’appliquent aux param&egrave;tres de tableau, colonnes et cellules, y compris leur position, propri&eacute;t&eacute;s et
aspect.
dom.addSpacerToColumn()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cr&eacute;e une image d’espacement transparente d’un pixel de hauteur au bas d’une colonne d&eacute;finie du
tableau s&eacute;lectionn&eacute;. Cette fonction &eacute;choue si la s&eacute;lection courante n’est pas un tableau ou si
l’op&eacute;ration ne r&eacute;ussit pas.
Arguments
colNum
• L’argument colNum est la colonne au bas de laquelle l’image d’espacement est cr&eacute;&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
dom.createLayoutCell()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cr&eacute;e une cellule de Mise en forme dans le document actif &agrave; la position et aux dimensions
sp&eacute;cifi&eacute;es, soit &agrave; l’int&eacute;rieur d’un tableau de Mise en forme existant, soit dans une zone situ&eacute;e sous
le contenu existant sur la page. Si la cellule est cr&eacute;&eacute;e dans un tableau de Mise en forme existant,
elle ne doit ni chevaucher ni contenir d’autres cellules de Mise en forme ou des tableaux de Mise
en forme imbriqu&eacute;s. Si le rectangle n’est pas &agrave; l’int&eacute;rieur d’un tableau de Mise en forme existant,
Dreamweaver tente de cr&eacute;er un tableau de Mise en forme devant contenir la nouvelle cellule.
Cette fonction ne place pas le document en mode de Mise en forme. Elle &eacute;choue si la cellule ne
peut pas &ecirc;tre cr&eacute;&eacute;e.
Arguments
left, top, width, height
•
•
•
•
364
L’argument left est la position x de la bordure gauche de la cellule.
L’argument top est la position y de la bordure sup&eacute;rieure de la cellule.
L’argument width est la largeur de la cellule en pixels.
L’argument height est la hauteur de la cellule en pixels.
Chapitre 17 : Conception
Valeurs renvoy&eacute;es
Aucune.
dom.createLayoutTable()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cr&eacute;e un tableau de Mise en forme dans le document actif &agrave; la position et aux dimensions
sp&eacute;cifi&eacute;es, soit &agrave; l’int&eacute;rieur d’un tableau de mise en forme existant, soit dans une zone situ&eacute;e sous
le contenu existant sur la page. Si le tableau est cr&eacute;&eacute; dans un tableau de Mise en forme existant, il
ne peut pas chevaucher d’autres cellules de Mise en forme ou des tableaux de Mise en forme
imbriqu&eacute;s, mais il peut en contenir. Cette fonction ne place pas le document en mode de Mise en
forme. Elle &eacute;choue si le tableau ne peut pas &ecirc;tre cr&eacute;&eacute;.
Arguments
left, top, width, height
•
•
•
•
L’argument left est la position x de la bordure gauche du tableau.
L’argument top est la position y de la bordure sup&eacute;rieure du tableau.
L’argument width est la largeur du tableau en pixels.
L’argument height est la hauteur du tableau en pixels.
Valeurs renvoy&eacute;es
Aucune.
dom.doesColumnHaveSpacer()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;termine si une colonne contient une image d’espacement g&eacute;n&eacute;r&eacute;e par Dreamweaver. Cette
fonction &eacute;choue si la s&eacute;lection en cours n’est pas un tableau.
Arguments
colNum
• L’argument colNum est la colonne &agrave; v&eacute;rifier pour une image d’espacement.
Valeurs renvoy&eacute;es
Renvoie la valeur true si la colonne d&eacute;finie dans le tableau s&eacute;lectionn&eacute; contient une image
d’espacement g&eacute;n&eacute;r&eacute;e par Dreamweaver et false dans le cas contraire.
dom.doesGroupHaveSpacers()
Disponibilit&eacute;
Dreamweaver 4.
Fonctions relatives au mode de Mise en forme
365
Description
D&eacute;termine si le tableau s&eacute;lectionn&eacute; contient une ligne d’images d’espacement g&eacute;n&eacute;r&eacute;es par
Dreamweaver. Cette fonction &eacute;choue si la s&eacute;lection en cours n’est pas un tableau.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Renvoie la valeur true si le tableau contient une ligne d’images d’espacement et false dans le cas
contraire.
dom.getClickedHeaderColumn()
Disponibilit&eacute;
Dreamweaver 4.
Description
Si l’utilisateur clique sur un bouton de menu dans l’en-t&ecirc;te d’un tableau du mode de Mise en
forme, faisant ainsi appara&icirc;tre le menu d’en-t&ecirc;te du tableau, cette fonction renvoie l’index de la
colonne sur laquelle l’utilisateur a cliqu&eacute;. Le r&eacute;sultat n’est pas d&eacute;fini si le menu d’en-t&ecirc;te du
tableau n’est pas visible.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Nombre entier qui repr&eacute;sente l’index de la colonne.
dom.getShowLayoutTableTabs()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;termine si le document actif affiche les tabulations des tableaux de Mise en forme dans le mode
correspondant.
Arguments
Aucun.
Valeurs renvoy&eacute;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&eacute;
Dreamweaver 4.
366
Chapitre 17 : Conception
Description
D&eacute;termine le mode d’affichage du document actif, Mise en forme ou Standard.
Arguments
Aucun.
Valeurs renvoy&eacute;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.isColumnAutostretch()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;termine si une colonne doit &ecirc;tre agrandie ou r&eacute;duite automatiquement selon la taille du
document. Cette fonction &eacute;choue si la s&eacute;lection en cours n’est pas un tableau.
Arguments
colNum
• L’argument colNum est la colonne &agrave; redimensionner automatiquement ou dont la largeur est
fixe.
Valeurs renvoy&eacute;es
Renvoie la valeur true si la colonne situ&eacute;e &agrave; l’index donn&eacute; du tableau s&eacute;lectionn&eacute; doit s’agrandir
automatiquement et false dans le cas contraire.
dom.makeCellWidthsConsistent()
Disponibilit&eacute;
Dreamweaver 4.
Description
Dans le tableau s&eacute;lectionn&eacute;, cette fonction d&eacute;finit la largeur de chaque colonne de code HTML
pour qu’elle corresponde &agrave; la largeur de rendu de la colonne. Cette fonction &eacute;choue si la s&eacute;lection
courante n’est pas un tableau ou si l’op&eacute;ration ne r&eacute;ussit pas.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.removeAllSpacers()
Disponibilit&eacute;
Dreamweaver 4.
Fonctions relatives au mode de Mise en forme
367
Description
Supprime toutes les images d’espacement g&eacute;n&eacute;r&eacute;es par Dreamweaver &agrave; partir du tableau
s&eacute;lectionn&eacute;. Cette fonction &eacute;choue si la s&eacute;lection courante n’est pas un tableau ou si l’op&eacute;ration ne
r&eacute;ussit pas.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.removeSpacerFromColumn()
Disponibilit&eacute;
Dreamweaver 4.
Description
Supprime l’image d’espacement d’une colonne donn&eacute;e et supprime la ligne d’espacement s’il n’y a
plus d’images d’espacement g&eacute;n&eacute;r&eacute;es par Dreamweaver. Cette fonction &eacute;choue si la s&eacute;lection
courante n’est pas un tableau ou si l’op&eacute;ration ne r&eacute;ussit pas.
Arguments
colNum
• L’argument colNum est la colonne dans laquelle l’image d’espacement doit &ecirc;tre supprim&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
dom.setColumnAutostretch()
Disponibilit&eacute;
Dreamweaver 4.
Description
Passe d’une colonne automatiquement dimensionn&eacute;e &agrave; une colonne d’une largeur fixe et vice
versa. Si bAutostretch est d&eacute;fini sur true, la colonne situ&eacute;e &agrave; l’index donn&eacute; du tableau
s&eacute;lectionn&eacute; est d&eacute;finie pour s’agrandir automatiquement ; dans le cas contraire, elle est d&eacute;finie sur
une largeur fixe qui est celle du rendu en cours. Cette fonction &eacute;choue si la s&eacute;lection courante
n’est pas un tableau ou si l’op&eacute;ration ne r&eacute;ussit pas.
Arguments
colNum, bAutostretch
• L’argument colNum est la colonne &agrave; redimensionner automatiquement ou d&eacute;finie sur une
largeur fixe.
• L’argument bAutostretch indique si la colonne doit &ecirc;tre agrandie automatiquement (true)
ou d&eacute;finie sur une largeur fixe (false).
368
Chapitre 17 : Conception
Valeurs renvoy&eacute;es
Aucune.
dom.setShowLayoutTableTabs()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;finit 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 la valeur de l’argument bShow est
true, Dreamweaver affiche les tabulations ; si la valeur de bShow est false, Dreamweaver ne
les affiche pas.
Valeurs renvoy&eacute;es
Aucune.
dom.setShowLayoutView()
Disponibilit&eacute;
Dreamweaver 4.
Description
Met le document actif en mode de Mise en forme si bShow a pour valeur true.
Arguments
bShow
• L’argument bShow est une valeur bool&eacute;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, le document est
en mode Standard.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de modification des tableaux
Ces fonctions permettent d’ins&eacute;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&eacute;es en pixels (et vice versa) et d’effectuer d’autres op&eacute;rations standard de
modification des tableaux.
Fonctions de modification des tableaux
369
dom.convertWidthsToPercent()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction convertit en pourcentage tous les attributs WIDTH exprim&eacute;s en pixels du tableau en
cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.convertWidthsToPixels()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction convertit en pixels tous les attributs WIDTH exprim&eacute;s en pourcentage du tableau en
cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.decreaseColspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction diminue l’&eacute;tendue de colonnes de 1.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canDecreaseColspan(), page 432.
370
Chapitre 17 : Conception
dom.decreaseRowspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction diminue l’&eacute;tendue de lignes de 1.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canDecreaseRowspan(), page 432.
dom.deleteTableColumn()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction supprime du tableau la ou les colonnes s&eacute;lectionn&eacute;es.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canDeleteTableColumn(), page 432.
dom.deleteTableRow()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction supprime du tableau la ou les lignes s&eacute;lectionn&eacute;es.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de modification des tableaux
371
Activateur
dom.canDeleteTableRow(), page 433.
dom.doDeferredTableUpdate()
Disponibilit&eacute;
Dreamweaver 3.
Description
Si l’option Modification de tableau plus rapide est activ&eacute;e dans la cat&eacute;gorie G&eacute;n&eacute;ral des
pr&eacute;f&eacute;rences, cette fonction oblige la mise en forme du tableau &agrave; adopter les modifications
apport&eacute;es r&eacute;cemment, et ce sans d&eacute;placer la s&eacute;lection &agrave; l’ext&eacute;rieur du tableau. Cette fonction n’a
aucun effet si l’option Modification de tableau plus rapide n’est pas activ&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.getShowTableWidths()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Indique si les largeurs d’un tableau s’affichent en mode Standard ou Tableaux d&eacute;velopp&eacute;s (mode
autre que Mise en forme). Pour plus d’informations sur l’affichage des tabulations de tableau en
mode de Mise en forme dans Dreamweaver, voir dom.getShowLayoutTableTabs(), page 366.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si Dreamweaver affiche les largeurs du tableau en mode Standard ou
Tableaux d&eacute;velopp&eacute;s ; false dans le cas contraire.
dom.getTableExtent()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction obtient le nombre de colonnes et de lignes du tableau s&eacute;lectionn&eacute;.
Arguments
Aucun.
372
Chapitre 17 : Conception
Valeurs renvoy&eacute;es
Tableau contenant deux nombres entiers. Le premier entier correspond au nombre de colonnes, le
second au nombre de lignes. Si aucun tableau n’est s&eacute;lectionn&eacute;, aucune valeur n’est renvoy&eacute;e.
dom.increaseColspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction augmente l’&eacute;tendue de colonnes de 1.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canIncreaseColspan(), page 433.
dom.increaseRowspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction augmente l’&eacute;tendue de lignes de 1.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canDecreaseRowspan(), page 432.
dom.insertTableColumns()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction ins&egrave;re le nombre de colonnes sp&eacute;cifi&eacute; dans le tableau en cours.
Fonctions de modification des tableaux
373
Arguments
numberOfCols, bBeforeSelection.
• L’argument numberOfCols est le nombre de colonnes &agrave; ins&eacute;rer.
• L’argument bBeforeSelection est une valeur bool&eacute;enne : true indique que les colonnes
doivent &ecirc;tre ins&eacute;r&eacute;es avant la colonne contenant la s&eacute;lection ; false indique le contraire.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canInsertTableColumns(), page 434.
dom.insertTableRows()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction ins&egrave;re le nombre de lignes sp&eacute;cifi&eacute; dans le tableau en cours.
Arguments
numberOfRows, bBeforeSelection
• L’argument numberOfRows est le nombre de lignes &agrave; ins&eacute;rer.
• L’argument bBeforeSelection est une valeur bool&eacute;enne : true indique que les lignes doivent
&ecirc;tre ins&eacute;r&eacute;es au-dessus de la ligne contenant la s&eacute;lection ; false indique le contraire.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canInsertTableRows(), page 434.
dom.mergeTableCells()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction fusionne les cellules de tableau s&eacute;lectionn&eacute;es.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
374
Chapitre 17 : Conception
Activateur
dom.canMergeTableCells(), page 435.
dom.removeAllTableHeights()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction supprime tous les attributs HEIGHT du tableau s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.removeAllTableWidths()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction supprime tous les attributs WIDTH du tableau s&eacute;lectionn&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.removeColumnWidth()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Cette fonction supprime tous les attributs WIDTH d’une unique colonne s&eacute;lectionn&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de modification des tableaux
375
dom.selectTable()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne un tableau entier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canSelectTable(), page 436.
dom.setShowTableWidths()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Permet d’activer ou de d&eacute;sactiver l’affichage des largeurs d’un tableau en mode Standard ou
Tableaux d&eacute;velopp&eacute;s (mode autre que Mise en forme). Cette fonction d&eacute;finit la valeur assign&eacute;e au
document en cours et &agrave; tous les documents suivants, sauf indication contraire. Pour plus
d’informations sur l’affichage des tabulations de tableau en mode de Mise en forme dans
Dreamweaver, voir dom.setShowLayoutTableTabs(), page 369.
Arguments
bShow
• L’argument bShow est un bool&eacute;en qui indique si les largeurs de tableau doivent s’afficher
lorsque le document en cours est en mode Standard ou Tableaux d&eacute;velopp&eacute;s (mode autre que
Mise en forme). 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&eacute;es
Aucune.
dom.setTableCellTag()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction d&eacute;finit la balise de la cellule s&eacute;lectionn&eacute;e.
376
Chapitre 17 : Conception
Arguments
tdOrTh
• L’argument tdOrTh doit &ecirc;tre &quot;td&quot; ou &quot;th&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.setTableColumns()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction d&eacute;finit le nombre de colonnes du tableau s&eacute;lectionn&eacute;.
Arguments
numberOfCols
• L’argument numberOfCols indique le nombre de colonnes &agrave; d&eacute;finir dans le tableau.
Valeurs renvoy&eacute;es
Aucune.
dom.setTableRows()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction d&eacute;finit le nombre de lignes du tableau s&eacute;lectionn&eacute;.
Arguments
numberOfCols
• L’argument numberOfRows indique le nombre de lignes &agrave; d&eacute;finir dans le tableau s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.showInsertTableRowsOrColumnsDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction ouvre la bo&icirc;te de dialogue Ins&eacute;rer des lignes ou des colonnes.
Arguments
Aucun.
Fonctions de modification des tableaux
377
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canInsertTableColumns(), page 434 ou dom.canInsertTableRows(), page 434.
dom.splitTableCell()
Disponibilit&eacute;
Dreamweaver 3.
Description
Cette fonction fractionne la cellule de tableau en cours en un nombre de lignes ou de colonnes
donn&eacute;. Si vous ne d&eacute;finissez pas l’un des deux arguments, ou les deux, la bo&icirc;te de dialogue
Fractionner la cellule s’affiche.
Arguments
{colsOrRows}, {numberToSplitInto}
• L’argument facultatif colsOrRows doit &ecirc;tre &quot;columns&quot; ou &quot;rows&quot;.
• L’argument facultatif numberToSplitInto indique en combien de lignes ou de colonnes la
cellule doit &ecirc;tre fractionn&eacute;e.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canSplitTableCell(), page 438.
378
Chapitre 17 : Conception
CHAPITRE 18
Code
Les fonctions Code vous permettent d’effectuer des op&eacute;rations sur un document affich&eacute; en mode
Code. Ces op&eacute;rations comprennent l’ajout de nouvelles balises de fonction ou de menu &agrave; un
menu d’indicateurs de code, la recherche et le remplacement de mod&egrave;les de cha&icirc;nes, la
suppression de la s&eacute;lection en cours, l’impression de code complet ou s&eacute;lectionn&eacute;, la modification
de balises ou l’application de formatage de syntaxe au code s&eacute;lectionn&eacute;.
Fonctions de code
Les indicateurs de code sont des menus contextuels qui s’affichent dans Macromedia
Dreamweaver MX 2004 lorsque vous tapez certains caract&egrave;res en mode Code. Ils vous &eacute;vitent de
saisir tout le texte en proposant une liste de cha&icirc;nes susceptibles de compl&eacute;ter la cha&icirc;ne que vous
tapez. Si la cha&icirc;ne que vous tapez appara&icirc;t dans le menu, s&eacute;lectionnez-la et appuyez sur Entr&eacute;e ou
Retour pour compl&eacute;ter votre saisie. Si vous tapez &lt;, par exemple, un menu contextuel affiche une
liste des noms de balises. Plut&ocirc;t que de taper le reste du nom de la balise, vous pouvez la
s&eacute;lectionner dans le menu pour l’inclure &agrave; votre texte.
Vous pouvez ajouter des menus Indicateurs de code dans Dreamweaver en les d&eacute;finissant dans le
fichier CodeHints.xml. Pour plus d’informations sur le fichier CodeHints.xml, voir Extension de
Dreamweaver.
Vous pouvez &eacute;galement ajouter de nouveaux menus d’indicateurs de code de fa&ccedil;on dynamique via
JavaScript apr&egrave;s chargement du contenu du fichier CodeHints.xml par Dreamweaver. Par
exemple, le code JavaScript ajoute des donn&eacute;es &agrave; la liste des variables de session dans le panneau
Liaisons. Vous pouvez utiliser le m&ecirc;me code pour ajouter un menu Indicateurs de code. Dans ce
cas, 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&eacute;s Dreamweaver ne sont pas accessibles. Par
exemple, comme il n’existe pas d’accroches JavaScript pouvant ouvrir un s&eacute;lecteur de couleurs,
Dreamweaver ne peut pas exprimer le menu Valeurs des attributs &agrave; l’aide de JavaScript. Vous
pouvez uniquement ouvrir un menu d’&eacute;l&eacute;ments de texte pour ins&eacute;rer du texte.
La coloration du code vous permet de d&eacute;finir des styles de couleur de code et de modifier des
mod&egrave;les de coloration de code ou d’en cr&eacute;er de nouveaux. Vous pouvez sp&eacute;cifier ces styles et
mod&egrave;les en modifiant le fichier Colors.xml et celui de mod&egrave;le de coloration. Pour plus
d’informations sur ces fichiers, voir Extension de Dreamweaver.
379
L’API JavaScript pour les indicateurs et la coloration de code comprend les fonctions suivantes :
dreamweaver.codeHints.addMenu()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;finit dynamiquement une nouvelle balise menu dans le fichier CodeHints.xml. Si une balise de
menu est d&eacute;finie par le m&ecirc;me mod&egrave;le et le m&ecirc;me type de document, cette fonction ajoute les
&eacute;l&eacute;ments au menu existant.
Arguments
menuGroupId, pattern, labelArray, {valueArray}, {iconArray}, {doctypes},
{casesensitive}
• L’argument menuGroupId est l’attribut ID de l’une des balises menugroup.
• L’argument pattern est l’attribut de mod&egrave;le de la nouvelle balise menu.
• L’argument labelArray est un tableau de cha&icirc;nes. Chaque cha&icirc;ne constitue le texte d’un
&eacute;l&eacute;ment de menu dans le menu contextuel.
• L’argument facultatif valueArray est un tableau de cha&icirc;nes qui doit avoir la m&ecirc;me longueur
•
•
•
que l’argument labelArray. Lorsqu’un utilisateur s&eacute;lectionne un &eacute;l&eacute;ment dans le menu
contextuel, la cha&icirc;ne de ce tableau est ins&eacute;r&eacute;e dans son document. Si la cha&icirc;ne &agrave; ins&eacute;rer est
toujours identique &agrave; celle de l’&eacute;tiquette du menu, la valeur de cet argument peut &ecirc;tre null.
L’argument facultatif iconArray peut &ecirc;tre une cha&icirc;ne ou un tableau de cha&icirc;nes. S’il s’agit
d’une cha&icirc;ne, elle sp&eacute;cifie l’URL d’un fichier d’image utilis&eacute; par Dreamweaver pour tous les
&eacute;l&eacute;ments du menu. S’il s’agit d’un tableau de cha&icirc;nes, il doit &ecirc;tre de la m&ecirc;me longueur que
l’argument labelArray. Chaque cha&icirc;ne est une URL (dossier Configuration de Dreamweaver)
d&eacute;signant un fichier d’image que Dreamweaver utilise comme une ic&ocirc;ne pour l’&eacute;l&eacute;ment de
menu correspondant. Si cet argument a la valeur null, Dreamweaver affiche le menu sans les
ic&ocirc;nes.
L’argument facultatif doctypes indique que le menu est actif pour certains types de documents
uniquement. Vous pouvez sp&eacute;cifier l’argument doctypes en tant que liste d’ID de types de
documents s&eacute;par&eacute;s par des virgules. Pour obtenir une liste des types de documents
Dreamweaver, voir le fichier Configuration/Documenttypes/MMDocumentTypes.xml de
Dreamweaver.
L’argument facultatif casesensitive indique si le mod&egrave;le fait la distinction entre les
majuscules et les minuscules. Les valeurs possibles de l’argument casesensitive sont les
valeurs bool&eacute;ennes true ou false. Par d&eacute;faut, la valeur est false si vous omettez cet
argument. Dans le cas o&ugrave; l’argument casesensitive aurait la valeur true, le menu
d’indicateurs de code s’affiche uniquement si le texte entr&eacute; par l’utilisateur correspond
exactement au mod&egrave;le sp&eacute;cifi&eacute; par l’attribut de mod&egrave;le. Dans le cas o&ugrave; l’argument
casesensitive aurait la valeur false, le menu s’affiche, m&ecirc;me si le mod&egrave;le est en minuscules
et que le texte est en majuscules.
Valeurs renvoy&eacute;es
Aucune.
380
Chapitre 18 : Code
Exemple
Si l’utilisateur cr&eacute;e un jeu d’enregistrements appel&eacute; &quot;myRs&quot;, le code suivant cr&eacute;e un menu pour
myRS:
dw.codeHints.addMenu(
&quot;CodeHints_object_methods&quot;, // menu is enabled if object methods are enabled
&quot;myRS.&quot;,
// pop up menu if user types &quot;myRS.&quot;
new Array(&quot;firstName&quot;, &quot;lastName&quot;), // items in drop-down menu for myRS
new Array(&quot;firstName&quot;, &quot;lastName&quot;), // text to actually insert in document
null,
// no icons for this menu
&quot;ASP_VB, ASP_JS&quot;); // specific to the ASP doc types
dreamweaver.codeHints.addFunction()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;finit dynamiquement une nouvelle balise function. Si une balise function est d&eacute;finie par le
m&ecirc;me mod&egrave;le et le m&ecirc;me type de document, cette fonction remplace la balise function
existante.
Arguments
menuGroupId, pattern, {doctypes}, {casesensitive}
• L’argument menuGroupId est l’attribut de cha&icirc;ne d’ID d’une balise menugroup.
• L’argument pattern est une cha&icirc;ne qui sp&eacute;cifie l’attribut de mod&egrave;le de la nouvelle balise
function.
• L’argument facultatif doctypes d&eacute;finit que cette fonction est active pour certains types de
•
documents uniquement. Vous pouvez sp&eacute;cifier l’argument doctypes en tant que liste d’ID de
types de documents s&eacute;par&eacute;s par des virgules. Pour obtenir une liste des types de documents
Dreamweaver, voir le fichier Configuration/Documenttypes/MMDocumentTypes.xml de
Dreamweaver.
L’argument facultatif casesensitive indique si le mod&egrave;le fait la distinction entre les
majuscules et les minuscules. Les valeurs possibles de l’argument casesensitive sont les
valeurs bool&eacute;ennes true ou false. Par d&eacute;faut, la valeur est false si vous omettez cet
argument. Dans le cas o&ugrave; l’argument casesensitive aurait la valeur true, le menu
d’indicateurs de code s’affiche uniquement si le texte entr&eacute; par l’utilisateur correspond
exactement au mod&egrave;le sp&eacute;cifi&eacute; par l’attribut de mod&egrave;le. Si l’argument casesensitive est
false, le menu s’affiche m&ecirc;me si le mod&egrave;le est en minuscules et le texte en majuscules.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple suivant de la fonction dw.codeHints.addFunction() ajoute le mod&egrave;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(
&quot;CodeHints_Object_Methods&quot;,
Fonctions de code
381
&quot;out.newLine()&quot;,
&quot;JSP&quot;)
dreamweaver.codeHints.resetMenu()
Disponibilit&eacute;
Dreamweaver MX.
Description
R&eacute;initialise la balise de menu ou de fonction sp&eacute;cifi&eacute;e &agrave; l’&eacute;tat dans lequel elle se trouvait juste
apr&egrave;s la lecture du fichier CodeHints.xml par Dreamweaver. En d’autres termes, l’appel de cette
fonction annule l’effet des appels pr&eacute;c&eacute;dents des fonctions addMenu() et addFunction().
Arguments
menuGroupId, pattern, {doctypes}
• L’argument menuGroupId est l’attribut de cha&icirc;ne d’ID d’une balise menugroup.
• L’argument pattern est une cha&icirc;ne qui sp&eacute;cifie l’attribut de mod&egrave;le de la nouvelle balise menu
ou function &agrave; r&eacute;initialiser.
• L’argument facultatif doctypes indique que le menu est actif pour certains types de documents
uniquement. Vous pouvez sp&eacute;cifier l’argument doctypes en tant que liste d’ID de types de
documents s&eacute;par&eacute;s par des virgules. Pour obtenir une liste des types de documents
Dreamweaver, voir le fichier Configuration/Documenttypes/MMDocumentTypes.xml de
Dreamweaver.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Votre code JavaScript peut cr&eacute;er un menu Indicateurs de code qui contient toutes les variables de
session d&eacute;finies par l’utilisateur. D&egrave;s que la liste des variables de session est modifi&eacute;e, ce code met
le menu &agrave; 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&eacute;
Dreamweaver MX.
Description
Dreamweaver appelle cette fonction lorsque l’utilisateur ouvre l’&eacute;l&eacute;ment de menu Edition &gt;
Afficher les indicateurs de code. La fonction ouvre le menu Indicateurs de code &agrave; l’emplacement
de la s&eacute;lection en mode Code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
382
Chapitre 18 : Code
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.
Valeurs renvoy&eacute;es
Aucune.
Exemple
dreamweaver.reloadCodeColoring()
Fonctions relatives &agrave; 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&icirc;ne donn&eacute;e &agrave; des
op&eacute;rations plus complexes de remplacement automatique.
dreamweaver.findNext()
Disponibilit&eacute;
Dreamweaver 3 ; modifi&eacute; dans Dreamweaver MX 2004.
Description
Recherche l’instance suivante de la cha&icirc;ne de recherche pr&eacute;c&eacute;demment d&eacute;finie par
dreamweaver.setUpFind(), par dreamweaver.setUpComplexFind() ou par l’utilisateur (&agrave; l’aide de la
bo&icirc;te de dialogue Rechercher), puis la s&eacute;lectionne dans le document.
Arguments
{bUseLastSetupSearch}
• L’argument facultatif bUseLastSetupSearch est une valeur bool&eacute;enne. Si
bUseLastSetupSearch a la valeur true (valeur par d&eacute;faut si aucun argument n’est fourni), la
fonction recherche l’occurrence suivante selon les param&egrave;tres d&eacute;finis lors de l’appel pr&eacute;c&eacute;dent &agrave;
la fonction dreamweaver.setupComplexFind() ou &agrave; la fonction
dreamweaver.setupComplexFindReplace(). Si vous d&eacute;finissez bUseLastSetupSearch sur
la valeur false, la fonction ignore la recherche pr&eacute;c&eacute;dente et recherche l’instance suivante du
texte s&eacute;lectionn&eacute; dans le document.
Valeurs renvoy&eacute;es
Aucune.
Fonctions relatives &agrave; la recherche et au remplacement
383
Activateur
dreamweaver.canFindNext(), page 442.
dreamweaver.replace()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie que la s&eacute;lection actuelle correspond aux crit&egrave;res de recherche sp&eacute;cifi&eacute;s par
dreamweaver.setUpFindReplace(), par dreamweaver.setUpComplexFindReplace() ou par l’utilisateur
dans la bo&icirc;te de dialogue Remplacer ; la fonction remplace ensuite la s&eacute;lection par le texte de
substitution sp&eacute;cifi&eacute; dans la demande de recherche.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.replaceAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
Remplace chaque section du document actif correspondant aux crit&egrave;res de recherche
pr&eacute;c&eacute;demment d&eacute;finis par la fonction dreamweaver.setUpFindReplace() ou
dreamweaver.setUpComplexFindReplace() ou par l’utilisateur (dans la bo&icirc;te de dialogue Remplacer)
par le contenu de remplacement sp&eacute;cifi&eacute;.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.setUpComplexFind()
Disponibilit&eacute;
Dreamweaver 3.
Description
Pr&eacute;pare le terrain pour une recherche avanc&eacute;e de texte ou de balises en chargeant la requ&ecirc;te XML
sp&eacute;cifi&eacute;e.
Arguments
xmlQueryString
384
Chapitre 18 : Code
• L’argument xmlQueryString est une cha&icirc;ne de code XML commen&ccedil;ant par dwquery et se
terminant par /dwquery. Pour obtenir une cha&icirc;ne format&eacute;e correctement, vous pouvez d&eacute;finir
la requ&ecirc;te &agrave; l’aide de la bo&icirc;te de dialogue Rechercher, cliquer sur le bouton Enregistrer la
requ&ecirc;te, ouvrir ce fichier de requ&ecirc;te dans un &eacute;diteur de texte et copier tout ce qui est compris
entre le d&eacute;but de la balise dwquery et la fin de la balise /dwquery.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Dans l’exemple ci-apr&egrave;s, la premi&egrave;re ligne de code d&eacute;finit une recherche de balise et pr&eacute;cise que la
recherche doit porter sur le document actif ; la deuxi&egrave;me ligne ex&eacute;cute la recherche.
dreamweaver.setUpComplexFind(’&lt;dwquery&gt;&lt;queryparams matchcase=&quot;false&quot; &not;
ignorewhitespace=&quot;true&quot; useregexp=&quot;false&quot;/&gt;&lt;find&gt;&not;
&lt;qtag qname=&quot;a&quot;&gt;&lt;qattribute qname=&quot;href&quot; qcompare=&quot;=&quot;
qvalue=&quot;#&quot;&gt;&not;
&lt;/qattribute&gt;&lt;qattribute qname=&quot;onMouseOut&quot; qcompare=&quot;=&quot; qvalue=&quot;&quot; &not;
qnegate=&quot;true&quot;&gt;&lt;/qattribute&gt;&lt;/qtag&gt;&lt;/find&gt;&lt;/dwquery&gt;’);
dw.findNext();
dreamweaver.setUpComplexFindReplace()
Disponibilit&eacute;
Dreamweaver 3.
Description
Pr&eacute;pare le terrain pour une recherche avanc&eacute;e de texte ou de balises en chargeant la requ&ecirc;te XML
sp&eacute;cifi&eacute;e.
Arguments
xmlQueryString
• L’argument xmlQueryString est une cha&icirc;ne du code XML qui commence par la balise dwquery
et se termine par la balise /dwquery. Pour obtenir une cha&icirc;ne ayant format&eacute;e correctement, vous
pouvez d&eacute;finir la requ&ecirc;te &agrave; l’aide de la bo&icirc;te de dialogue Rechercher, cliquer sur le bouton
Enregistrer la requ&ecirc;te, ouvrir ce fichier de requ&ecirc;te dans un &eacute;diteur de texte et copier tout ce qui
est compris entre le d&eacute;but de la balise dwquery et la fin de la balise /dwquery.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Dans l’exemple ci-apr&egrave;s, la premi&egrave;re ligne de code d&eacute;finit une recherche de balise et pr&eacute;cise que la
recherche doit porter sur quatre fichiers ; la deuxi&egrave;me ligne ex&eacute;cute la recherche et le
remplacement.
dreamweaver.setUpComplexFindReplace(’&lt;dwquery&gt;&lt;queryparams &not;
matchcase=&quot;false&quot; ignorewhitespace=&quot;true&quot; useregexp=&quot;false&quot;/&gt;&not;
Fonctions relatives &agrave; la recherche et au remplacement
385
&lt;find&gt;&lt;qtag qname=&quot;a&quot;&gt;&lt;qattribute qname=&quot;href&quot; qcompare=&quot;=&quot; &not;
qvalue=&quot;#&quot;&gt;&lt;/qattribute&gt;&lt;qattribute qname=&quot;onMouseOut&quot; &not;
qcompare=&quot;=&quot; qvalue=&quot;&quot; qnegate=&quot;true&quot;&gt;&lt;/qattribute&gt;&lt;/qtag&gt;&not;
&lt;/find&gt;&lt;replace action=&quot;setAttribute&quot; param1=&quot;onMouseOut&quot; &not;
param2=&quot;this.style.color=’#000000’;this.style.&not;
fontWeight=’normal’&quot;/&gt;&lt;/dwquery&gt;’);
dw.replaceAll();
dreamweaver.setUpFind()
Disponibilit&eacute;
Dreamweaver 3.
Description
Pr&eacute;pare le terrain pour l’ex&eacute;cution d’une recherche de texte ou de code source HTML en
d&eacute;finissant les crit&egrave;res de recherche de l’op&eacute;ration dreamweaver.findNext() qui va suivre.
Arguments
searchObject
L’argument searchObject est un objet pour lequel les propri&eacute;t&eacute;s suivantes peuvent &ecirc;tre d&eacute;finies :
• La propri&eacute;t&eacute; searchString est le texte &agrave; rechercher.
• La propri&eacute;t&eacute; searchSource est une valeur bool&eacute;enne indiquant si la recherche doit &eacute;galement
porter sur le code source HTML.
• La propri&eacute;t&eacute; facultative {matchCase} est une valeur bool&eacute;enne indiquant si la recherche doit
•
•
respecter les majuscules et les minuscules. Si cette propri&eacute;t&eacute; n’est pas d&eacute;finie, elle prend par
d&eacute;faut la valeur false.
La propri&eacute;t&eacute; facultative {ignoreWhitespace} est une valeur bool&eacute;enne indiquant si les
diff&eacute;rences entre les espaces blancs doivent &ecirc;tre ignor&eacute;es. La propri&eacute;t&eacute;s ignoreWhitespace
prend sa valeur par d&eacute;faut, false, si la valeur de la propri&eacute;t&eacute; useRegularExpressions est
true, et true si la valeur de la propri&eacute;t&eacute; useRegularExpressions est false.
La propri&eacute;t&eacute; {useRegularExpressions} est une valeur bool&eacute;enne indiquant que la propri&eacute;t&eacute;
searchString utilise des expressions r&eacute;guli&egrave;res. Si cette propri&eacute;t&eacute; n’est pas d&eacute;finie, elle prend
par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple de code suivant montre comment cr&eacute;er un objet &agrave; rechercher (searchObject) de trois
fa&ccedil;ons diff&eacute;rentes :
var searchParams;
searchParams.searchString = ’bgcolor=&quot;#FFCCFF&quot;’;
searchParams.searchSource = true;
dreamweaver.setUpFind(searchParams);
var searchParams = {searchString: ’bgcolor=&quot;#FFCCFF&quot;’, searchSource: true};
dreamweaver.setUpFind(searchParams);
dreamweaver.setUpFind({searchString: ’bgcolor=&quot;#FFCCFF&quot;’, searchSource: &not;
true});
386
Chapitre 18 : Code
dreamweaver.setUpFindReplace()
Disponibilit&eacute;
Dreamweaver 3.
Description
Pr&eacute;pare une recherche de texte ou de code source HTML en d&eacute;finissant les crit&egrave;res de recherche et
le cadre d’application de l’op&eacute;ration dreamweaver.replace() dreamweaver.replaceAll() qui
va suivre.
Arguments
searchObject
L’argument searchObject est un objet pour lequel les propri&eacute;t&eacute;s suivantes peuvent &ecirc;tre d&eacute;finies :
• La propri&eacute;t&eacute; searchString est le texte &agrave; rechercher.
• La propri&eacute;t&eacute; replaceString est le texte &agrave; substituer au texte recherch&eacute;.
• La propri&eacute;t&eacute; searchSource est une valeur bool&eacute;enne indiquant si la recherche doit &eacute;galement
•
•
•
porter sur le code source HTML.
La propri&eacute;t&eacute; facultative {matchCase} est une valeur bool&eacute;enne indiquant si la recherche doit
respecter les majuscules et les minuscules. Si cette propri&eacute;t&eacute; n’est pas d&eacute;finie, elle prend par
d&eacute;faut la valeur false.
La propri&eacute;t&eacute; facultative {ignoreWhitespace} est une valeur bool&eacute;enne indiquant si les
diff&eacute;rences entre les espaces blancs doivent &ecirc;tre ignor&eacute;es. La propri&eacute;t&eacute; ignoreWhitespace
prend la valeur false si la propri&eacute;t&eacute; useRegularExpressions a la valeur true et prend la
valeur true si l’expression useRegularExpressions a la valeur false.
La propri&eacute;t&eacute; {useRegularExpressions} est une valeur bool&eacute;enne indiquant que la propri&eacute;t&eacute;
searchString utilise des expressions r&eacute;guli&egrave;res. Si cette propri&eacute;t&eacute; n’est pas d&eacute;finie, elle prend
par d&eacute;faut la valeur false.
Valeurs renvoy&eacute;es
Aucune.
Exemple
L’exemple de code suivant montre comment cr&eacute;er un objet &agrave; rechercher (searchObject) de trois
fa&ccedil;ons diff&eacute;rentes :
var searchParams;
searchParams.searchString = ’bgcolor=&quot;#FFCCFF&quot;’;
searchParams.searchString = ’bgcolor=&quot;#FFCCFF&quot;’;
searchParams.searchSource = true;
dreamweaver.setUpFindReplace(searchParams);
var searchParams = {searchString: ’bgcolor=&quot;#FFCCFF&quot;’, replaceString:
’bgcolor=&quot;#CCFFCC&quot;’, searchSource: true};
dreamweaver.setUpFindReplace(searchParams);
dreamweaver.setUpFindReplace({searchString: ’bgcolor=&quot;#FFCCFF&quot;’, &not;
replaceString: ’bgcolor=&quot;#CCFFCC&quot;’, searchSource: true});
Fonctions relatives &agrave; la recherche et au remplacement
387
dreamweaver.showFindDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Rechercher.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canShowFindDialog(), page 446.
dreamweaver.showFindReplaceDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Remplacer.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canShowFindDialog(), page 446.
Fonctions de modifications g&eacute;n&eacute;rales
Ces fonctions s’utilisent depuis la fen&ecirc;tre de document. Elles permettent d’ins&eacute;rer du texte, du
code HTML et des objets, d’appliquer, de modifier et de supprimer des marqueurs de police et de
caract&egrave;re, de modifier des balises et des attributs, etc.
dom.applyCharacterMarkup()
Disponibilit&eacute;
Dreamweaver 3.
388
Chapitre 18 : Code
Description
Applique &agrave; la s&eacute;lection le type de marqueur de caract&egrave;re sp&eacute;cifi&eacute;. Si la s&eacute;lection est un point
d’insertion, la fonction applique les marqueurs de caract&egrave;re sp&eacute;cifi&eacute;s au texte saisi apr&egrave;s le point
d’insertion.
Arguments
tagName
• L’argument tagName est le nom de la balise associ&eacute; au marqueur de caract&egrave;re. Il doit s’agir de
l’une des cha&icirc;nes suivantes : &quot;b&quot;, &quot;cite&quot;, &quot;code&quot;, &quot;dfn&quot;, &quot;em&quot;, &quot;i&quot;, &quot;kbd&quot;, &quot;samp&quot;, &quot;s&quot;,
ou &quot;var&quot;.
&quot;strong&quot;, &quot;tt&quot;, &quot;u&quot;
Valeurs renvoy&eacute;es
Aucune.
dom.applyFontMarkup()
Disponibilit&eacute;
Dreamweaver 3.
Description
Applique &agrave; la s&eacute;lection en cours la balise FONT, ainsi que l’attribut sp&eacute;cifi&eacute; et sa valeur.
Arguments
attribute, value
• L’argument attribute doit &ecirc;tre &quot;face&quot;, &quot;size&quot; ou &quot;color&quot;.
• L’argument value est la valeur &agrave; affecter &agrave; l’attribut, comme &quot;Arial, Helvetica, sansserif&quot;, &quot;5&quot;
ou &quot;#FF0000&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.deleteSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime la s&eacute;lection du document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de modifications g&eacute;n&eacute;rales
389
dom.editAttribute()
Disponibilit&eacute;
Dreamweaver 3.
Description
Affiche l’interface permettant de modifier l’attribut de document sp&eacute;cifi&eacute;. Dans la plupart des cas,
il s’agit d’une bo&icirc;te de dialogue. Cette fonction n’est valide que pour le document actif.
Arguments
attribute
•
attribute
est une cha&icirc;ne qui sp&eacute;cifie l’attribut de balise &agrave; modifier.
Valeurs renvoy&eacute;es
Aucune.
dom.exitBlock()
Disponibilit&eacute;
Dreamweaver 3.
Description
Quitte le bloc de paragraphe ou d’en-t&ecirc;te en cours et place le point d’insertion &agrave; l’ext&eacute;rieur de
tous les &eacute;l&eacute;ments de bloc.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.getCharSet()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie l’attribut charset dans la balise Meta du document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
L’identit&eacute; de codage du document. Par exemple, dans un document Latin1, cette fonction renvoie
iso-8859-1.
390
Chapitre 18 : Code
dom.getFontMarkup()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la valeur de l’attribut sp&eacute;cifi&eacute; de la balise FONT pour la s&eacute;lection en cours.
Arguments
attribute
• L’argument attribute doit &ecirc;tre &quot;face&quot;, &quot;size&quot; ou &quot;color&quot;.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant la valeur de l’attribut sp&eacute;cifi&eacute;, soit une cha&icirc;ne vide si l’attribut n’est pas
d&eacute;fini.
dom.getLineFromOffset()
Disponibilit&eacute;
Dreamweaver MX.
Description
Trouve le num&eacute;ro de ligne d’un d&eacute;calage de caract&egrave;re pr&eacute;cis dans le texte (le code HTML ou
JavaScript) du fichier.
Arguments
offset
• L’argument offset est un nombre entier qui repr&eacute;sente l’emplacement du caract&egrave;re &agrave; partir du
d&eacute;but du fichier.
Valeurs renvoy&eacute;es
Nombre entier qui repr&eacute;sente le num&eacute;ro de la ligne dans le document.
dom.getLinkHref()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le lien qui entoure la s&eacute;lection en cours. Revient &agrave; effectuer une boucle sur les parents et
les grands-parents du nœud en cours jusqu’&agrave; ce qu’un lien soit rencontr&eacute;, puis &agrave; appeler la
fonction getAttribute(’HREF’) sur ce lien.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne qui contient le nom du fichier li&eacute;, exprim&eacute; sous la forme d’une URL de type file://.
Fonctions de modifications g&eacute;n&eacute;rales
391
dom.getLinkTarget()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la cible du lien qui entoure la s&eacute;lection en cours. Revient &agrave; effectuer une boucle sur les
parents et les grands-parents du nœud en cours jusqu’&agrave; ce qu’un lien soit rencontr&eacute;, puis &agrave; appeler
la fonction getAttribute('TARGET') sur ce lien.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant la valeur de l’attribut TARGET sp&eacute;cifi&eacute; pour le lien, soit une cha&icirc;ne vide
si aucune cible n’est d&eacute;finie.
dom.getListTag()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le style de la liste s&eacute;lectionn&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant la balise associ&eacute;e &agrave; la liste (&quot;ul&quot;, &quot;ol&quot; ou &quot;dl&quot;), soit une cha&icirc;ne vide si
aucune balise n’est associ&eacute;e &agrave; la liste. Cette valeur est toujours renvoy&eacute;e en minuscules.
dom.getTextAlignment()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient l’alignement du bloc contenant la s&eacute;lection.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant la valeur de l’attribut ALIGN de la balise associ&eacute;e au bloc, soit une
cha&icirc;ne vide si l’attribut ALIGN n’est pas d&eacute;fini. Cette valeur est toujours renvoy&eacute;e en minuscules.
392
Chapitre 18 : Code
dom.getTextFormat()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient le format du bloc contenant la s&eacute;lection.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Soit une cha&icirc;ne contenant la balise de bloc associ&eacute;e au texte (comme &quot;p&quot;, &quot;h1&quot;, &quot;pre&quot;, etc.), soit
une cha&icirc;ne vide si aucune balise de bloc n’est associ&eacute;e &agrave; la s&eacute;lection. Cette valeur est toujours
renvoy&eacute;e en minuscules.
dom.hasCharacterMarkup()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si le marqueur de caract&egrave;re sp&eacute;cifi&eacute; est d&eacute;j&agrave; associ&eacute; &agrave; la s&eacute;lection.
Arguments
markupTagName
• L’argument markupTagName est le nom de la balise &agrave; v&eacute;rifier. Il doit s’agir de l’une des cha&icirc;nes
suivantes : &quot;b&quot;, &quot;cite&quot;, &quot;code&quot;, &quot;dfn&quot;, &quot;em&quot;, &quot;i&quot;, &quot;kbd&quot;, &quot;samp&quot;, &quot;s&quot;, &quot;strong&quot;, &quot;tt&quot;, &quot;u&quot;
ou &quot;var&quot;.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si le marqueur de caract&egrave;re sp&eacute;cifi&eacute; est associ&eacute; &agrave; la s&eacute;lection enti&egrave;re.
Cette fonction renvoie la valeur false si le marqueur sp&eacute;cifi&eacute; n’est associ&eacute; qu’&agrave; une partie de la
s&eacute;lection.
dom.indent()
Disponibilit&eacute;
Dreamweaver 3.
Description
Applique un retrait &agrave; la s&eacute;lection &agrave; l’aide des balises BLOCKQUOTE. Si la s&eacute;lection est un &eacute;l&eacute;ment de
liste, cette fonction lui applique un retrait en convertissant l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; en liste
imbriqu&eacute;e. La liste imbriqu&eacute;e est du m&ecirc;me type que la liste externe et contient un seul &eacute;l&eacute;ment (la
s&eacute;lection d’origine).
Arguments
Aucun.
Fonctions de modifications g&eacute;n&eacute;rales
393
Valeurs renvoy&eacute;es
Aucune.
dom.insertHTML()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ins&egrave;re un contenu HTML dans le document, au niveau du point d’insertion en cours.
Arguments
contentToInsert, {bReplaceCurrentSelection}
• L’argument contentToInsert est le contenu &agrave; ins&eacute;rer.
• L’argument facultatif bReplaceCurrentSelection est une valeur bool&eacute;enne qui indique si le
contenu sp&eacute;cifi&eacute; doit remplacer la s&eacute;lection en cours. Si la valeur de l’argument
bReplaceCurrentSelection est true, le contenu remplace la s&eacute;lection actuelle. Si sa valeur
est false, le contenu est ins&eacute;r&eacute; apr&egrave;s la s&eacute;lection actuelle.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Le code suivant ins&egrave;re la cha&icirc;ne HTML &lt;b&gt;130&lt;/b&gt; dans le document actuel :
var theDOM = dw.getDocumentDOM();
theDOM.insertHTML('&lt;b&gt;130&lt;/b&gt;');
Le r&eacute;sultat appara&icirc;t dans la fen&ecirc;tre de document, comme indiqu&eacute; dans la figure suivante :
dom.insertObject()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ins&egrave;re l’objet sp&eacute;cifi&eacute; et invite l’utilisateur &agrave; d&eacute;finir des param&egrave;tres, le cas &eacute;ch&eacute;ant.
Arguments
objectName
• L’argument objectName est le nom d’un objet dans le dossier Configuration/Objects.
394
Chapitre 18 : Code
Valeurs renvoy&eacute;es
Aucune.
Exemple
Un appel &agrave; la fonction dom.insertObject('Button') ins&egrave;re un bouton de formulaire dans le
document actif, apr&egrave;s la s&eacute;lection en cours. Si aucun &eacute;l&eacute;ment n’est s&eacute;lectionn&eacute;, cette fonction
ins&egrave;re le bouton au niveau du point d’insertion en cours.
Remarque : M&ecirc;me si les fichiers d’objets peuvent &ecirc;tre conserv&eacute;s dans des dossiers s&eacute;par&eacute;s, le nom
de chaque fichier doit imp&eacute;rativement &ecirc;tre unique. En effet, si le dossier Forms et le dossier
MyObjects contiennent chacun un fichier nomm&eacute; Button.htm, par exemple, Dreamweaver n’est pas
capable de faire la diff&eacute;rence entre les deux.
dom.insertText()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ins&egrave;re un contenu dans le document, au niveau du point d’insertion en cours.
Arguments
contentToInsert, {bReplaceCurrentSelection}
• L’argument contentToInsert est le contenu &agrave; ins&eacute;rer.
• L’argument facultatif bReplaceCurrentSelection est une valeur bool&eacute;enne qui indique si le
contenu sp&eacute;cifi&eacute; doit remplacer la s&eacute;lection en cours. Si la valeur de l’argument
bReplaceCurrentSelection est true, le contenu remplace la s&eacute;lection actuelle. Si sa valeur
est false, le contenu est ins&eacute;r&eacute; apr&egrave;s la s&eacute;lection actuelle.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Le code suivant ins&egrave;re le texte : &amp;lt;b&amp;gt;130&amp;lt;/b&amp;gt; dans le document en cours :
var theDOM = dreamweaver.getDocumentDOM();
theDOM.insertText(’&lt;b&gt;130&lt;/b&gt;’);
Les r&eacute;sultats apparaissent dans la fen&ecirc;tre de document, comme indiqu&eacute; dans la figure suivante :
dom.newBlock()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions de modifications g&eacute;n&eacute;rales
395
Description
Cr&eacute;e un bloc dot&eacute; de la m&ecirc;me balise et des m&ecirc;mes attributs que le bloc contenant la s&eacute;lection en
cours ou, si le pointeur se trouve &agrave; l’ext&eacute;rieur de tous les blocs, cr&eacute;e un paragraphe.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Exemple
Si la s&eacute;lection en cours se trouve &agrave; l’int&eacute;rieur d’un paragraphe centr&eacute;, un appel &agrave; la fonction
dom.newBlock() ins&egrave;re &lt;p align=&quot;center&quot;&gt; apr&egrave;s le paragraphe en cours.
dom.notifyFlashObjectChanged()
Disponibilit&eacute;
Dreamweaver 4.
Description
Indique &agrave; Dreamweaver que le fichier Flash en cours a &eacute;t&eacute; modifi&eacute;. Dreamweaver met &agrave; jour la
fen&ecirc;tre d’aper&ccedil;u en la redimensionnant, le cas &eacute;ch&eacute;ant, et en veillant &agrave; conserver le rapport
hauteur/largeur d’origine. Par exemple, le texte Flash utilise cette fonction pour mettre &agrave; jour le
texte en mode de Mise en forme &agrave; mesure que l’utilisateur en change les propri&eacute;t&eacute;s dans la bo&icirc;te
de dialogue Commande.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.outdent()
Disponibilit&eacute;
Dreamweaver 3.
Description
Applique un retrait n&eacute;gatif &agrave; la s&eacute;lection.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
396
Chapitre 18 : Code
dom.removeCharacterMarkup()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime de la s&eacute;lection le type de marqueur de caract&egrave;re sp&eacute;cifi&eacute;.
Arguments
tagName
• L’argument tagName est le nom de la balise associ&eacute; au marqueur de caract&egrave;re. Il doit s’agir de
l’une des cha&icirc;nes suivantes : &quot;b&quot;, &quot;cite&quot;, &quot;code&quot;, &quot;dfn&quot;, &quot;em&quot;, &quot;i&quot;, &quot;kbd&quot;, &quot;samp&quot;, &quot;s&quot;,
ou &quot;var&quot;.
&quot;strong&quot;, &quot;tt&quot;, &quot;u&quot;
Valeurs renvoy&eacute;es
Aucune.
dom.removeFontMarkup()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime d’une balise FONT l’attribut sp&eacute;cifi&eacute;, ainsi que sa valeur. Si, apr&egrave;s suppression de
l’attribut, il ne reste que la balise FONT, la balise FONT est &eacute;galement supprim&eacute;e.
Arguments
attribute
• L’argument attribute doit &ecirc;tre &quot;face&quot;, &quot;size&quot; ou &quot;color&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.removeLink()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime le lien hypertexte de la s&eacute;lection.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de modifications g&eacute;n&eacute;rales
397
dom.resizeSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
Redimensionne l’objet s&eacute;lectionn&eacute; et lui applique les nouvelles dimensions sp&eacute;cifi&eacute;es.
Arguments
newWidth, newHeight
• L’argument newWidth sp&eacute;cifie la nouvelle largeur d&eacute;finie pour l’objet s&eacute;lectionn&eacute; par la
fonction.
• L’argument newHeight sp&eacute;cifie la nouvelle hauteur d&eacute;finie pour l’objet s&eacute;lectionn&eacute; par la
fonction.
Valeurs renvoy&eacute;es
Aucune.
dom.setAttributeWithErrorChecking()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit l’attribut sp&eacute;cifi&eacute; sur la valeur indiqu&eacute;e pour la s&eacute;lection en cours et affiche une invite
utilisateur si le type de valeur est incorrect ou si la valeur n’est pas comprise dans la plage sp&eacute;cifi&eacute;e.
Cette fonction n’est valide que pour le document actif.
Arguments
attribute, value
• L’argument attribute sp&eacute;cifie l’attribut &agrave; d&eacute;finir pour la s&eacute;lection actuelle.
• L’argument value sp&eacute;cifie la valeur &agrave; d&eacute;finir pour l’attribut.
Valeurs renvoy&eacute;es
Aucune.
dom.setLinkHref()
Disponibilit&eacute;
Dreamweaver 3.
Description
Transforme la s&eacute;lection en lien hypertexte ou modifie la valeur de l’URL pour la balise HREF qui
entoure la s&eacute;lection en cours.
Arguments
linkHREF
398
Chapitre 18 : Code
• L’argument linkHREF est une URL (chemin relatif au document ou &agrave; la racine, ou URL
absolue) contenant le lien. Si aucun argument n’est d&eacute;fini, la bo&icirc;te de dialogue S&eacute;lectionner
fichier HTML s’affiche.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canSetLinkHref(), page 437.
dom.setLinkTarget()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit la cible du lien qui entoure la s&eacute;lection en cours. Revient &agrave; effectuer une boucle sur les
parents et les grands-parents du nœud en cours jusqu’&agrave; ce qu’un lien soit rencontr&eacute;, puis &agrave; appeler
la fonction setAttribute('TARGET') sur ce lien.
Arguments
{linkTarget}
• L’argument facultatif linkTarget est une cha&icirc;ne qui repr&eacute;sente le nom d’un cadre ou d’une
fen&ecirc;tre, ou l’une des cibles r&eacute;serv&eacute;es (&quot;_self&quot;, &quot;_parent&quot;, &quot;_top&quot; ou &quot;_blank&quot;). Si aucun
argument n’est d&eacute;fini, la bo&icirc;te de dialogue D&eacute;finir la cible s’affiche.
Valeurs renvoy&eacute;es
Aucune.
dom.setListBoxKind()
Disponibilit&eacute;
Dreamweaver 3.
Description
Modifie le type du menu SELECT s&eacute;lectionn&eacute;.
Arguments
kind
• L’argument kind doit &ecirc;tre &quot;menu&quot; ou &quot;list
box&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.showListPropertiesDialog()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions de modifications g&eacute;n&eacute;rales
399
Description
Ouvre la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la liste.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dom.canShowListPropertiesDialog(), page 437.
dom.setListTag()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;finit le style de la liste s&eacute;lectionn&eacute;e.
Arguments
listTag
• L’argument listTag est la balise associ&eacute;e &agrave; la liste. Il doit s’agir de &quot;ol&quot;, &quot;ul&quot;, &quot;dl&quot; ou d’une
cha&icirc;ne vide.
Valeurs renvoy&eacute;es
Aucune.
dom.setTextAlignment()
Disponibilit&eacute;
Dreamweaver 3.
Description
Affecte la valeur sp&eacute;cifi&eacute;e &agrave; l’attribut ALIGN du bloc contenant la s&eacute;lection.
Arguments
alignValue
• L’argument alignValue doit &ecirc;tre &quot;left&quot;, &quot;center&quot; ou &quot;right&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.setTextFieldKind()
Disponibilit&eacute;
Dreamweaver 3.
400
Chapitre 18 : Code
Description
D&eacute;finit le format du champ texte s&eacute;lectionn&eacute;.
Arguments
fieldType
• L’argument fieldType doit &ecirc;tre &quot;input&quot;, &quot;textarea&quot; ou &quot;password&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.setTextFormat()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;finit le format de bloc du texte s&eacute;lectionn&eacute;.
Arguments
blockFormat
• L’argument blockFormat est une cha&icirc;ne qui sp&eacute;cifie un des formats suivants : &quot;&quot; (aucun
format), &quot;p&quot;, &quot;h1&quot;, &quot;h2&quot;, &quot;h3&quot;, &quot;h4&quot;, &quot;h5&quot;, &quot;h6&quot; ou &quot;pre&quot;.
Valeurs renvoy&eacute;es
Aucune.
dom.showFontColorDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue du s&eacute;lecteur de couleur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.deleteSelection()
Disponibilit&eacute;
Dreamweaver 3.
Fonctions de modifications g&eacute;n&eacute;rales
401
Description
Supprime la s&eacute;lection du document actif, du panneau Site ou, sur Macintosh, il supprime la zone
de texte active dans une bo&icirc;te de dialogue ou un panneau flottant.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canDeleteSelection(), page 441.
dreamweaver.editFontList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Ouvre la bo&icirc;te de dialogue Modifier la liste des polices.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.getFontList()
Disponibilit&eacute;
Dreamweaver 3.
Description
Obtient la liste de tous les groupes de polices apparaissant dans l’inspecteur de propri&eacute;t&eacute;s de texte
et la bo&icirc;te de dialogue D&eacute;finition du style.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes dont chaque cha&icirc;ne repr&eacute;sente un &eacute;l&eacute;ment de la liste des polices.
Exemple
Si vous avez effectu&eacute; une installation par d&eacute;faut de Dreamweaver, un appel &agrave; la fonction
dreamweaver.getFontList() renvoie un tableau contenant les &eacute;l&eacute;ments suivants :
•
•
402
&quot;Arial, Helvetica, sans-serif&quot;
&quot;Times New Roman, Times, serif&quot;
Chapitre 18 : Code
•
•
•
&quot;Courier New, Courier, mono&quot;
&quot;Georgia, Times New Roman, Times, serif&quot;
&quot;Verdana, Arial, Helvetica, sans-serif&quot;
dreamweaver.getFontStyles()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie les styles pris en charge par la police TrueType sp&eacute;cifi&eacute;e.
Arguments
fontName
• L’argument fontName est une cha&icirc;ne contenant le nom de la police.
Valeurs renvoy&eacute;es
Tableau de trois valeurs bool&eacute;ennes qui indique les styles pris en charge par la police. La premi&egrave;re
valeur indique si la police prend en charge le style Gras, la deuxi&egrave;me le style Italique et la troisi&egrave;me
les styles Gras et Italique.
dreamweaver.getKeyState()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si la touche de modification sp&eacute;cifi&eacute;e est enfonc&eacute;e.
Arguments
key
• L’argument key doit correspondre &agrave; l’une des valeurs suivantes : &quot;Cmd&quot;, &quot;Ctrl&quot;, &quot;Alt&quot; ou
&quot;Shift&quot;. Sous Windows, &quot;Cmd&quot; et &quot;Ctrl&quot;
&quot;Alt&quot; d&eacute;signe la touche Option.
d&eacute;signent la touche Contr&ocirc;le ; sur Macintosh,
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si la touche est enfonc&eacute;e.
Exemple
Le code suivant v&eacute;rifie si les touches Maj et Ctrl (Windows) ou Maj et Commande (Macintosh)
sont enfonc&eacute;es avant d’effectuer une op&eacute;ration.
if (dw.getKeyState(&quot;Shift&quot;) &amp;&amp; dw.getKeyState(&quot;Cmd&quot;)){
// execute code
}
Fonctions de modifications g&eacute;n&eacute;rales
403
dreamweaver.getNaturalSize()
Disponibilit&eacute;
Dreamweaver 4.
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 &agrave; une
URL absolue pointant vers un fichier local ; il ne peut pas s’agir d’une URL relative.
Valeurs renvoy&eacute;es
Tableau contenant deux nombres entiers, le premier d&eacute;finissant la largeur de l’objet et le second sa
hauteur.
dreamweaver.getSystemFontList()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie une liste de polices &agrave; utiliser pour le syst&egrave;me. Cette fonction peut appeler toutes les
polices ou uniquement les polices TrueType. Ces polices sont requises pour l’objet Texte Flash.
Arguments
fontTypes
• L’argument fontTypes est une cha&icirc;ne qui contient soit &quot;all&quot;, soit &quot;TrueType&quot;.
Valeurs renvoy&eacute;es
Tableau de cha&icirc;nes qui contient le nom de toutes les polices ; renvoie la valeur null si aucune
police n’est trouv&eacute;e.
Fonction relative &agrave; l’impression
Cette fonction permet &agrave; l’utilisateur d’imprimer le code depuis le mode Code.
dreamweaver.PrintCode()
Disponibilit&eacute;
Dreamweaver MX.
404
Chapitre 18 : Code
Description
Sous Windows, cette fonction imprime toutes les portions de code ou seulement une s&eacute;lection de
code depuis le mode Code. Sur Macintosh, elle imprime toutes les portions de code ou seulement
une plage de pages de 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&icirc;te de dialogue d’impression
pour demander &agrave; l’utilisateur s’il souhaite imprimer tout le texte ou seulement une s&eacute;lection de
texte. Sur Macintosh, la fonction dreamweaver.PrintCode() affiche la bo&icirc;te de dialogue
d’impression pour demander &agrave; 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&eacute;lection pr&eacute;c&eacute;dente
de l’utilisateur. La valeur par d&eacute;faut est true.
L’argument document est le DOM du document &agrave; imprimer. Voir
dreamweaver.getDocumentDOM(), page 261 pour plus d’informations sur la fa&ccedil;on d’obtenir le
DOM d’un document.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le code peut s’imprimer ; false dans les autres cas.
Exemple
L’exemple suivant appelle dw.PrintCode() pour invoquer la bo&icirc;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&eacute;cuter la demande d’impression.
var theDOM = dreamweaver.getDocumentDOM(&quot;document&quot;);
if(!dreamweaver.PrintCode(true, theDOM))
{
alert(“Unable to execute your print request!”);
}
Fonctions relatives &agrave; Quick Tag Editor
Ces fonctions permettent de se d&eacute;placer d’une balise &agrave; l’autre &agrave; l’int&eacute;rieur et autour de la s&eacute;lection
en cours. Elles permettent de supprimer n’importe laquelle de ces balises, d’envelopper la s&eacute;lection
&agrave; l’int&eacute;rieur d’une nouvelle balise et d’afficher Quick Tag Editor pour permettre &agrave; l’utilisateur de
modifier certains attributs d’une balise.
dom.selectChild()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne un enfant de la s&eacute;lection en cours. Revient &agrave; s&eacute;lectionner la balise situ&eacute;e
imm&eacute;diatement &agrave; droite dans le s&eacute;lecteur de balises, en bas de la fen&ecirc;tre de document.
Fonctions relatives &agrave; Quick Tag Editor
405
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.selectParent()
Disponibilit&eacute;
Dreamweaver 3.
Description
S&eacute;lectionne le parent de la s&eacute;lection en cours. Revient &agrave; s&eacute;lectionner la balise situ&eacute;e
imm&eacute;diatement &agrave; gauche dans le s&eacute;lecteur de balises, en bas de la fen&ecirc;tre de document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.stripTag()
Disponibilit&eacute;
Dreamweaver 3.
Description
Supprime les balises qui entourent la s&eacute;lection actuelle, laissant intact leur contenu. Si la s&eacute;lection
contient plusieurs balises ou n’en contient aucune, Dreamweaver affiche un message d’erreur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.wrapTag()
Disponibilit&eacute;
Dreamweaver 3.
Description
Place la balise sp&eacute;cifi&eacute;e autour de la s&eacute;lection en cours. Si la balise n’est pas compl&egrave;te,
Dreamweaver affiche un message d’erreur.
Arguments
startTag
• L’argument startTag est la source associ&eacute;e &agrave; la balise d’ouverture.
406
Chapitre 18 : Code
Valeurs renvoy&eacute;es
Aucune.
Exemple
Le code suivant place un lien autour de la s&eacute;lection en cours.
var theDOM = dw.getDocumentDOM();
var theSel = theDOM.getSelectedNode();
if (theSel.nodeType == Node.TEXT_NODE){
theDOM.wrapTag(’&lt;a href=&quot;foo.html&quot;&gt;’);
}
dreamweaver.showQuickTagEditor()
Disponibilit&eacute;
Dreamweaver 3.
Description
Affiche Quick Tag Editor pour la s&eacute;lection en cours.
Arguments
{nearWhat}, {mode}
• L’argument facultatif nearWhat doit, s’il est sp&eacute;cifi&eacute;, &ecirc;tre &quot;selection&quot; ou &quot;tag
•
selector&quot;.
Si cet argument n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur &quot;selection&quot;.
L’argument facultatif mode doit, s’il est sp&eacute;cifi&eacute;, &ecirc;tre &quot;default&quot;, &quot;wrap&quot;, &quot;insert&quot; ou
&quot;edit&quot;. Si l’argument mode a pour valeur &quot;default&quot; ou qu’il n’est pas d&eacute;fini, Dreamweaver
utilise la m&eacute;thode heuristique afin de d&eacute;terminer le mode &agrave; utiliser pour la s&eacute;lection en cours.
Si l’argument nearWhat a pour valeur &quot;tag selector&quot;, l’argument mode est ignor&eacute;.
Valeurs renvoy&eacute;es
Aucune.
Fonctions du mode code
Ces fonctions incluent les op&eacute;rations associ&eacute;es &agrave; la modification du code source d’un document
(et tous les changements ayant une incidence sur le mode Cr&eacute;ation). Les fonctions de cette section
vous permettent d’ajouter des commandes de navigation aux modes Code au sein d’une fen&ecirc;tre de
document affich&eacute;e dans deux volets ou dans la fen&ecirc;tre de l’inspecteur de code.
dom.formatRange()
Disponibilit&eacute;
Dreamweaver MX.
Description
Applique le formatage de syntaxe automatique de Dreamweaver &agrave; une plage d&eacute;finie de caract&egrave;res
en mode Code, et ce conform&eacute;ment aux param&egrave;tres de la bo&icirc;te de dialogue Pr&eacute;f&eacute;rences &gt; Format
de code.
Fonctions du mode code
407
Arguments
startOffset, endOffset
• L’argument startOffset est un nombre entier qui repr&eacute;sente le d&eacute;but de la plage d&eacute;finie, et ce
sous la forme d’un d&eacute;calage par rapport au d&eacute;but du document.
• L’argument endOffset est un nombre entier qui repr&eacute;sente la fin de la plage d&eacute;finie, et ce sous
la forme d’un d&eacute;calage par rapport au d&eacute;but du document.
Valeurs renvoy&eacute;es
Aucune.
dom.formatSelection()
Disponibilit&eacute;
Dreamweaver MX.
Description
Applique le formatage de syntaxe automatique de Dreamweaver au contenu s&eacute;lectionn&eacute; (ce qui
revient &agrave; utiliser l’option Commandes &gt; Appliquer le format source &agrave; la s&eacute;lection), conform&eacute;ment
aux param&egrave;tres de la bo&icirc;te de dialogue Pr&eacute;f&eacute;rences &gt; Format de code.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.getShowNoscript()
Disponibilit&eacute;
Dreamweaver MX.
Description
Obtient l’&eacute;tat actuel de l’option de contenu noscript (depuis l’option de menu Affichage &gt;
Contenu Noscript). Activ&eacute;e par d&eacute;faut, la balise noscript identifie un script de page pouvant, au
choix, &ecirc;tre affich&eacute; ou non dans le navigateur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le contenu de la balise noscript est actuellement affich&eacute; ; false dans
le cas contraire.
dom.getAutoValidationCount()
Disponibilit&eacute;
Dreamweaver MX 2004.
408
Chapitre 18 : Code
Description
Obtient le nombre d’erreurs, d’avertissements et de messages d’information pour la derni&egrave;re autovalidation (ou validation en ligne) du document. Actuellement seule une v&eacute;rification du
navigateur cible est effectu&eacute;e durant l’auto-validation (voir dom.runValidation(), page 271).
Remarque : Cette fonction renvoie uniquement les r&eacute;sultats actuellement affich&eacute;s dans la fen&ecirc;tre de
r&eacute;sultats du document. Pour vous assurer que les comptes sont &agrave; jour, vous pouvez appeler
dom.runValidation() avant d’appeler cette fonction.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Un objet avec les propri&eacute;t&eacute;s suivantes :
• la propri&eacute;t&eacute; numError, qui est le nombre d’erreurs ;
• la propri&eacute;t&eacute; numWarning, qui est le nombre d’avertissements ;
• la propri&eacute;t&eacute; numInfo, qui est le nombre de messages d’information.
Exemple
theDom = dw.getDocumentDOM();
theDom.runValidation();
theDom.getAutoValidationCount();
dom.isDesignviewUpdated()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;termine si le contenu des modes Cr&eacute;ation et Texte est synchronis&eacute; pour les op&eacute;rations
Dreamweaver qui requi&egrave;rent un &eacute;tat de document correct.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si le mode Cr&eacute;ation (WYSIWIG) est synchronis&eacute; avec le texte du mode
Texte et false dans le cas contraire.
dom.isSelectionValid()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;termine si une s&eacute;lection est valide, ce qui signifie qu’elle est synchronis&eacute;e avec le mode
Cr&eacute;ation, ou s’il faut la d&eacute;placer avant qu’une op&eacute;ration n’ait lieu.
Fonctions du mode code
409
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si la s&eacute;lection en cours contient un segment de code correct ; false si le
document n’a pas encore &eacute;t&eacute; synchronis&eacute;, &eacute;tant donn&eacute; que la s&eacute;lection n’a pas &eacute;t&eacute; mise &agrave; jour.
dom.setShowNoscript
Disponibilit&eacute;
Dreamweaver MX.
Description
Active ou d&eacute;sactive l’option de contenu noscript (ce qui revient &agrave; utiliser l’option Affichage &gt;
Contenu Noscript). Activ&eacute;e par d&eacute;faut, la balise noscript identifie un script de page pouvant, au
choix, &ecirc;tre affich&eacute; ou non dans le navigateur.
Arguments
{bShowNoscript}
• L’argument facultatif bShowNoscript est une valeur bool&eacute;enne qui indique si le contenu de la
balise noscript doit &ecirc;tre affich&eacute; ; true si le contenu de la balise noscript doit &ecirc;tre affich&eacute; ;
false dans le cas contraire.
Valeurs renvoy&eacute;es
Aucune.
dom.source.arrowDown()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion vers le bas du document affich&eacute; en mode Code, ligne par ligne. Si le
contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;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&eacute;fini, il prend par d&eacute;faut la valeur 1.
• L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
410
Chapitre 18 : Code
dom.source.arrowLeft()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion vers la gauche de la ligne courante dans le mode Code. Si le contenu
est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection vers la gauche.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument facultatif nTimes est le nombre de caract&egrave;res que le point d’insertion doit sauter. Si
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
nTimes
•
Valeurs renvoy&eacute;es
Aucune.
dom.source.arrowRight()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion vers la droite de la ligne courante dans le mode Code. Si le contenu
est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection vers la droite.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument facultatif nTimes est le nombre de caract&egrave;res que le point d’insertion doit sauter. Si
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute; ; dans le cas
contraire, il ne l’est pas.
nTimes
•
Valeurs renvoy&eacute;es
Aucune.
dom.source.arrowUp()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion vers le haut du document affich&eacute; en mode Code, ligne par ligne. Si le
contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection ligne par ligne.
Fonctions du mode code
411
Arguments
{nTimes}, {bShiftIsDown}
• L’argument nTimes est le nombre de lignes que le point d’insertion doit d&eacute;placer. Si nTimes
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est s&eacute;lectionn&eacute;.
Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.source.balanceBracesTextview()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction est une extension du mode Code qui permet d’&eacute;quilibrer les parenth&egrave;ses. Vous
pouvez appeler la fonction dom.source.balanceBracesTextView() pour &eacute;tendre la s&eacute;lection
mise en surbrillance ou le point d’insertion depuis le d&eacute;but de l’instruction entre parenth&egrave;ses
jusqu’&agrave; la fin de l’instruction afin d’&eacute;quilibrer les caract&egrave;res suivants : [], {} et (). Tout nouvel
appel &eacute;tend la s&eacute;lection &agrave; des niveaux suppl&eacute;mentaires de ponctuation imbriqu&eacute;e.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.source.endOfDocument()
Disponibilit&eacute;
Dreamweaver 4.
Description
Place le point d’insertion &agrave; la fin du document actif affich&eacute; en mode Code. Si le contenu est d&eacute;j&agrave;
s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection &agrave; la fin du document.
Arguments
bShiftIsDown
• L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est s&eacute;lectionn&eacute;.
Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
412
Chapitre 18 : Code
dom.source.endOfLine()
Disponibilit&eacute;
Dreamweaver 4.
Description
Place le point d’insertion &agrave; la fin de la ligne courante. Si le contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette
fonction &eacute;tend la s&eacute;lection jusqu’&agrave; la fin de la ligne courante.
Arguments
bShiftIsDown
• L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est s&eacute;lectionn&eacute;.
Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.source.endPage()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion &agrave; la fin de la page en cours ou &agrave; la fin de la page suivante (si le point
d’insertion est d&eacute;j&agrave; &agrave; la fin d’une page). Si le contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la
s&eacute;lection page par page.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument facultatif nTimes est le nombre de pages que le point d’insertion doit sauter. Si
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
nTimes
•
Valeurs renvoy&eacute;es
Aucune.
dom.source.getCurrentLines()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie les num&eacute;ros de ligne des d&eacute;calages sp&eacute;cifi&eacute;s &agrave; partir du d&eacute;but du document.
Arguments
Aucun.
Fonctions du mode code
413
Valeurs renvoy&eacute;es
Num&eacute;ros de ligne de la s&eacute;lection en cours.
dom.source.getSelection()
Description
Obtient la s&eacute;lection du document actif, exprim&eacute;e en d&eacute;calages de caract&egrave;res dans le mode Code
du document.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Paire de nombres entiers repr&eacute;sentant les d&eacute;calages &agrave; partir du d&eacute;but du document source. Le
premier nombre entier correspond au d&eacute;but de la s&eacute;lection et le second &agrave; la fin. Si les deux
nombres sont &eacute;gaux, la s&eacute;lection est un point d’insertion. Si aucun &eacute;l&eacute;ment n’est s&eacute;lectionn&eacute; dans
la source, les deux nombres sont -1.
dom.source.getLineFromOffset()
Disponibilit&eacute;
Dreamweaver MX.
Description
Place un d&eacute;calage dans le document source.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Num&eacute;ro de la ligne, ou -1 si le d&eacute;calage est n&eacute;gatif ou se trouve apr&egrave;s la fin du fichier.
dom.source.getText()
Disponibilit&eacute;
Dreamweaver 4.
Description
Renvoie la cha&icirc;ne de texte de la source comprise entre les d&eacute;calages d&eacute;finis.
Arguments
startOffset, endOffset
• L’argument startOffset est un nombre entier qui repr&eacute;sente le d&eacute;calage &agrave; partir du d&eacute;but du
document.
• L’argument endOffset est un nombre entier qui repr&eacute;sente la fin du document.
414
Chapitre 18 : Code
Valeurs renvoy&eacute;es
Cha&icirc;ne qui repr&eacute;sente le texte du code source compris entre les d&eacute;calages start et end.
dom.source.getValidationErrorsForOffset()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
Renvoie la liste des erreurs de validation au point de d&eacute;calage sp&eacute;cifi&eacute; ou recherche l’erreur
suivante apr&egrave;s le d&eacute;calage. Si aucune n’est trouv&eacute;e dans la fonction, la valeur null est renvoy&eacute;e.
Arguments
d&eacute;calage, {searchDirection}
• L’argument offset est un nombre qui sp&eacute;cifie le d&eacute;calage dans le code pour lequel la fonction
renvoie des erreurs.
• L’argument facultatif searchDirection est une cha&icirc;ne qui sp&eacute;cifie &quot;empty&quot;, &quot;forward&quot; ou
&quot;back&quot;. Si sp&eacute;cifi&eacute;, la fonction recherche vers la fin ou le d&eacute;but du document, en partant du
d&eacute;calage d&eacute;fini, les caract&egrave;res comportant des erreurs et les renvoie. Si cela n’est pas sp&eacute;cifi&eacute;, la
fonction v&eacute;rifie la pr&eacute;sence d’erreur au point de d&eacute;calage d&eacute;fini.
Valeurs renvoy&eacute;es
Tableau d’objets ou valeur null. Chaque objet du tableau comporte les propri&eacute;t&eacute;s suivantes :
• L’objet message est une cha&icirc;ne qui contient le message d’erreur.
• L’objet floaterName est une cha&icirc;ne qui contient le nom de la fen&ecirc;tre de r&eacute;sultats. Vous pouvez
•
•
•
transmettre cette valeur aux fonctions showResults() ou setFloaterVisibility().
L’objet floaterIndex est un index d’&eacute;l&eacute;ments dans la liste de r&eacute;sultats de palette.
L’objet start est l’index d’ouverture du code soulign&eacute;.
L’objet end est l’index de fermeture du code soulign&eacute;.
Remarque : Les index de palette renvoy&eacute;s ne doivent pas &ecirc;tre conserv&eacute;s car ils varient
fr&eacute;quemment, par exemple, lors de l’ouverture ou de la fermeture de documents.
Exemple
L’exemple suivant appelle getValidationErrorsForOffset() pour v&eacute;rifier qu’il n’y a pas
d’erreur au d&eacute;calage de la s&eacute;lection actuelle. Si la fonction renvoie une erreur, le code appelle la
fonction alert() pour afficher le message d’erreur &agrave; l’utilisateur.
var offset = dw.getDocumentDOM().source.getSelection()[0];
var errors = dw.getDocumentDOM().source.getValidationErrorsForOffset(offset);
if ( errors &amp;&amp; errors.length &gt; 0 )
alert( errors[0].message );
dom.source.indentTextview()
Disponibilit&eacute;
Dreamweaver 4.
Fonctions du mode code
415
Description
D&eacute;place le texte s&eacute;lectionn&eacute; en mode Code d’une marque de tabulation vers la droite.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.source.insert()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ins&egrave;re la cha&icirc;ne sp&eacute;cifi&eacute;e dans le code source au niveau du point de d&eacute;calage d&eacute;fini &agrave; partir du
d&eacute;but du fichier source. Si le d&eacute;calage n’est pas sup&eacute;rieur ou &eacute;gal &agrave; z&eacute;ro, l’insertion &eacute;choue et la
fonction renvoie la valeur false.
Arguments
offset, string
• L’argument offset est le d&eacute;calage &agrave; partir du d&eacute;but du fichier o&ugrave; la cha&icirc;ne doit &ecirc;tre ins&eacute;r&eacute;e.
• L’argument string est la cha&icirc;ne &agrave; ins&eacute;rer.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
dom.source.nextWord()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion au d&eacute;but du mot suivant (ou des mots suivants, si sp&eacute;cifi&eacute;) en mode
Code. Si le contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection vers la droite.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument facultatif nTimes est le nombre de mots que le point d’insertion doit d&eacute;placer. Si
nTimes
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
• L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
416
Chapitre 18 : Code
dom.source.outdentTextview()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le texte s&eacute;lectionn&eacute; en mode Code d’une marque de tabulation vers la gauche.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.source.pageDown()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion vers le bas du document affich&eacute; en mode Code, page par page. Si le
contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection page par page.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument facultatif nTimes est le nombre de pages que le point d’insertion doit sauter. Si
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
nTimes
•
Valeurs renvoy&eacute;es
Aucune.
dom.source.pageUp()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion vers le haut du document affich&eacute; en mode Code, page par page. Si le
contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;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&eacute;fini, il prend par d&eacute;faut la valeur 1.
Fonctions du mode code
417
• L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.source.previousWord()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion au d&eacute;but du mot pr&eacute;c&eacute;dent (ou des mots pr&eacute;c&eacute;dents, si sp&eacute;cifi&eacute;) en
mode Code. Si le contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection vers la gauche.
Arguments
{nTimes}, {bShiftIsDown}
• L’argument facultatif nTimes est le nombre de mots que le point d’insertion doit d&eacute;placer. Si
n’est pas d&eacute;fini, il prend par d&eacute;faut la valeur 1.
L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
nTimes
•
Valeurs renvoy&eacute;es
Aucune.
dom.source.replaceRange()
Disponibilit&eacute;
Dreamweaver 4.
Description
Remplace la plage de texte source comprise entre startOffset et endOffset par string. Si
startOffset est sup&eacute;rieur &agrave; endOffset ou si l’un des d&eacute;calages n’est pas un nombre entier
positif, cette fonction n’a aucun effet et renvoie la valeur false. Si endOffset est sup&eacute;rieur au
nombre de caract&egrave;res du fichier, cette fonction remplace la plage comprise entre startOffset et
la fin du fichier. Si startOffset et endOffset sont sup&eacute;rieurs au nombre de caract&egrave;res du
fichier, cette fonction ins&egrave;re le texte &agrave; la fin du fichier.
Arguments
startOffset, endOffset, string
• L’argument startOffset est le d&eacute;calage indiquant le d&eacute;but du bloc &agrave; remplacer.
• L’argument endOffset est le d&eacute;calage indiquant la fin du bloc &agrave; remplacer.
• L’argument string est la cha&icirc;ne &agrave; ins&eacute;rer.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
418
Chapitre 18 : Code
dom.source.scrollEndFile()
Disponibilit&eacute;
Dreamweaver 4.
Description
Fait d&eacute;filer le mode Code vers le bas du document sans d&eacute;placer le point d’insertion.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.source.scrollLineDown()
Disponibilit&eacute;
Dreamweaver 4.
Description
Fait d&eacute;filer le mode Code vers le bas ligne par ligne sans d&eacute;placer le point d’insertion.
Arguments
nTimes
• L’argument nTimes est le nombre de lignes &agrave; faire d&eacute;filer. Si nTimes n’est pas d&eacute;fini, il prend
par d&eacute;faut la valeur 1.
Valeurs renvoy&eacute;es
Aucune.
dom.source.scrollLineUp()
Disponibilit&eacute;
Dreamweaver 4.
Description
Fait d&eacute;filer le mode Code vers le haut ligne par ligne sans d&eacute;placer le point d’insertion.
Arguments
nTimes
• L’argument nTimes est le nombre de lignes &agrave; faire d&eacute;filer. Si nTimes n’est pas d&eacute;fini, il prend
par d&eacute;faut la valeur 1.
Valeurs renvoy&eacute;es
Aucune.
Fonctions du mode code
419
dom.source.scrollPageDown()
Disponibilit&eacute;
Dreamweaver 4.
Description
Fait d&eacute;filer le mode Code vers le bas page par page sans d&eacute;placer le point d’insertion.
Arguments
nTimes
• L’argument nTimes est le nombre de pages &agrave; faire d&eacute;filer. Si nTimes n’est pas d&eacute;fini, il prend
par d&eacute;faut la valeur 1.
Valeurs renvoy&eacute;es
Aucune.
dom.source.scrollPageUp()
Disponibilit&eacute;
Dreamweaver 4.
Description
Fait d&eacute;filer le mode Code vers le haut page par page sans d&eacute;placer le point d’insertion.
Arguments
nTimes
• L’argument nTimes est le nombre de pages &agrave; faire d&eacute;filer. Si nTimes n’est pas d&eacute;fini, il prend
par d&eacute;faut la valeur 1.
Valeurs renvoy&eacute;es
Aucune.
dom.source.scrollTopFile()
Disponibilit&eacute;
Dreamweaver 4.
Description
Fait d&eacute;filer le mode Code vers le haut du document sans d&eacute;placer le point d’insertion.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
420
Chapitre 18 : Code
dom.source.selectParentTag()
Disponibilit&eacute;
Dreamweaver 4.
Description
Cette fonction est une extension du mode Code qui permet d’&eacute;quilibrer les balises. Vous pouvez
appeler dom.source.selectParentTag() pour &eacute;tendre la s&eacute;lection ou le point d’insertion
courant de la balise d’ouverture &agrave; la balise de fermeture. Les appels suivants &eacute;tendent la s&eacute;lection &agrave;
des balises suppl&eacute;mentaires jusqu’&agrave; ce qu’il n’y ait plus de balises de fermeture.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dom.source.setCurrentLine()
Disponibilit&eacute;
Dreamweaver 4.
Description
Place le point d’insertion au d&eacute;but de la ligne indiqu&eacute;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&eacute; au d&eacute;but de la derni&egrave;re ligne si lineNumber est sup&eacute;rieur au nombre de lignes de la
source.
Arguments
lineNumber
• L’argument lineNumber est la ligne au d&eacute;but de laquelle le point d’insertion est plac&eacute;.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true en cas de succ&egrave;s et false dans le cas contraire.
dom.source.startOfDocument()
Disponibilit&eacute;
Dreamweaver 4.
Description
Place le point d’insertion au d&eacute;but du document affich&eacute; en mode Code. Si le contenu est d&eacute;j&agrave;
s&eacute;lectionn&eacute;, cette fonction &eacute;tend la s&eacute;lection au d&eacute;but du document.
Arguments
bShiftIsDown
• L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est s&eacute;lectionn&eacute;.
Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Fonctions du mode code
421
Valeurs renvoy&eacute;es
Aucune.
dom.source.startOfLine()
Disponibilit&eacute;
Dreamweaver 4.
Description
Place le point d’insertion au d&eacute;but de la ligne courante. Si le contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette
fonction &eacute;tend la s&eacute;lection au d&eacute;but de la ligne courante.
Arguments
bShiftIsDown
• L’argument bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est s&eacute;lectionn&eacute;.
Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.source.topPage()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;place le point d’insertion en haut de la page courante ou de la page pr&eacute;c&eacute;dente (si le point
d’insertion est d&eacute;j&agrave; en haut d’une page). Si le contenu est d&eacute;j&agrave; s&eacute;lectionn&eacute;, cette fonction &eacute;tend la
s&eacute;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&eacute;fini, il prend par d&eacute;faut la valeur 1.
• L’argument facultatif bShiftIsDown est une valeur bool&eacute;enne qui indique si un contenu est
s&eacute;lectionn&eacute;. Si bShiftIsDown a la valeur true, le contenu est s&eacute;lectionn&eacute;.
Valeurs renvoy&eacute;es
Aucune.
dom.source.wrapSelection()
Disponibilit&eacute;
Dreamweaver 4.
422
Chapitre 18 : Code
Description
Ins&egrave;re le texte de startTag avant la s&eacute;lection en cours et le texte de endTag apr&egrave;s la s&eacute;lection en
cours. La fonction s&eacute;lectionne ensuite la plage enti&egrave;re entre les balises ins&eacute;r&eacute;es, en incluant ces
balises. Si la s&eacute;lection en cours est un point d’insertion, la fonction place le point d’insertion entre
startTag et endTag (startTag et endTag ne doivent pas n&eacute;cessairement &ecirc;tre des balises ; il peut
s’agir de tout segment de texte de votre choix).
Arguments
startTag, endTag
• L’argument startTag est le texte &agrave; ins&eacute;rer au d&eacute;but de la s&eacute;lection.
• L’argument endTag est le texte &agrave; ins&eacute;rer &agrave; la fin de la s&eacute;lection.
Valeurs renvoy&eacute;es
Aucune.
dom.synchronizeDocument()
Disponibilit&eacute;
Dreamweaver 4.
Description
Synchronise les modes Code et Cr&eacute;ation.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Fonctions de l’&eacute;diteur de balises et de la biblioth&egrave;que de balises
Vous pouvez utiliser les &eacute;diteurs de balises pour ins&eacute;rer de nouvelles balises, pour modifier des
balises existantes ou pour acc&eacute;der &agrave; des informations de r&eacute;f&eacute;rence sur les balises. Le s&eacute;lecteur de
balises permet aux utilisateurs d’organiser leurs balises afin qu’ils puissent s&eacute;lectionner les balises
les plus fr&eacute;quemment utilis&eacute;es. Les biblioth&egrave;ques de balises fournies avec Dreamweaver stockent
des informations concernant les balises utilis&eacute;es dans les langages de balisage standard et dans les
langages de script et de balise fr&eacute;quemment utilis&eacute;s. Vous pouvez utiliser les fonctions de l’&eacute;diteur
de balises JavaScript, du s&eacute;lecteur de balises, de la biblioth&egrave;que de balises lorsque vous devez
utiliser les &eacute;diteurs de balises et biblioth&egrave;ques de balises dans vos extensions.
dom.getTagSelectorTag()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction obtient le nœud DOM de la balise s&eacute;lectionn&eacute;e dans la barre du s&eacute;lecteur de
balises se trouvant au bas de la fen&ecirc;tre de document.
Fonctions de l’&eacute;diteur de balises et de la biblioth&egrave;que de balises
423
Arguments
Aucun.
Valeurs renvoy&eacute;es
Nœud DOM de la balise s&eacute;lectionn&eacute;e ; null si aucune balise n’est s&eacute;lectionn&eacute;e.
dreamweaver.popupInsertTagDialog()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction v&eacute;rifie les fichiers VTM pour s’assurer qu’un &eacute;diteur de balises a &eacute;t&eacute; utilis&eacute; pour la
balise. Si c’est le cas, l’&eacute;diteur de cette balise appara&icirc;t et accepte la balise de d&eacute;but. Si ce n’est pas le
cas, la balise de d&eacute;but est ins&eacute;r&eacute;e telle quelle dans le document de l’utilisateur.
Arguments
Cha&icirc;ne de balise de d&eacute;but qui comprend un des types suivants de valeurs initiales :
• une balise, comme &lt;input&gt; ;
• une balise avec des attributs, comme &lt;input
• une directive, comme &lt;%= %&gt;.
type=’text’&gt;
;
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne : true si un &eacute;l&eacute;ment est ins&eacute;r&eacute; dans le document et false dans le cas contraire.
dreamweaver.popupEditTagDialog()
Disponibilit&eacute;
Dreamweaver MX.
Description
Si une balise est s&eacute;lectionn&eacute;e, cette fonction ouvre l’&eacute;diteur de balises correspondant &agrave; cette balise
pour vous permettre de modifier la balise.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
Activateur
dreamweaver.canPopupEditTagDialog(), page 443.
dreamweaver.showTagChooser()
Disponibilit&eacute;
Dreamweaver MX.
424
Chapitre 18 : Code
Description
Cette fonction affiche la bo&icirc;te de dialogue S&eacute;lecteur de balises, la fait appara&icirc;tre au premier plan et
la rend active.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucune.
dreamweaver.showTagLibraryEditor()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction ouvre l’&eacute;diteur de la biblioth&egrave;que de balises.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Aucun.
dreamweaver.tagLibrary.getTagLibraryDOM()
Disponibilit&eacute;
Dreamweaver MX.
Description
Associ&eacute;e &agrave; l’URL d’un fichier filename.vtm, cette fonction renvoie le DOM de ce fichier afin
que son contenu soit modifi&eacute;. Cette fonction ne doit &ecirc;tre appel&eacute;e que lorsque l’&eacute;diteur de la
biblioth&egrave;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 indiqu&eacute; dans l’exemple suivant :
&quot;HTML/img.vtm&quot;
Valeurs renvoy&eacute;es
Un pointeur DOM d&eacute;signant un fichier nouveau ou plus ancien du dossier TagLibraries.
dreamweaver.tagLibrary.getSelectedLibrary()
Disponibilit&eacute;
Dreamweaver MX.
Fonctions de l’&eacute;diteur de balises et de la biblioth&egrave;que de balises
425
Description
Si un nœud de biblioth&egrave;que est s&eacute;lectionn&eacute; dans l’&eacute;diteur de la biblioth&egrave;que de balises, cette
fonction obtient le nom de la biblioth&egrave;que.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne correspondant au nom de la biblioth&egrave;que s&eacute;lectionn&eacute;e dans l’&eacute;diteur de la biblioth&egrave;que de
balises ; renvoie une cha&icirc;ne vide si aucune biblioth&egrave;que n’est s&eacute;lectionn&eacute;e.
dreamweaver.tagLibrary.getSelectedTag()
Disponibilit&eacute;
Dreamweaver MX.
Description
Si un nœud d’attribut est s&eacute;lectionn&eacute;, cette fonction obtient le nom de la balise qui contient
l’attribut.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Cha&icirc;ne correspondant au nom de la balise s&eacute;lectionn&eacute;e dans l’&eacute;diteur de la biblioth&egrave;que de
balises ; renvoie une cha&icirc;ne vide si aucune balise n’est s&eacute;lectionn&eacute;e.
dreamweaver.tagLibrary.importDTDOrSchema()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction importe un fichier DTD/Sch&eacute;ma &agrave; partir d’un serveur distant dans la biblioth&egrave;que
de balises.
Arguments
fileURL, Pr&eacute;fixe
• L’argument fileURL est le chemin du fichier DTD ou sch&eacute;ma, au format URL local.
• L’argument Prefix est la cha&icirc;ne de pr&eacute;fixe qui doit &ecirc;tre ajout&eacute;e &agrave; toutes les balises de cette
biblioth&egrave;que.
Valeurs renvoy&eacute;es
Nom de la biblioth&egrave;que de balises import&eacute;es.
426
Chapitre 18 : Code
dreamweaver.tagLibrary.getImportedTagList()
Disponibilit&eacute;
Dreamweaver MX.
Description
Cette fonction g&eacute;n&egrave;re une liste d’objets TagInfo &agrave; partir d’une biblioth&egrave;que de balises import&eacute;es.
Arguments
libname
• L’argument libname est le nom de la biblioth&egrave;que de balises import&eacute;es.
Valeurs renvoy&eacute;es
Tableau d’objets tagInfo.
Un objet taginfo contient des informations concernant une balise de la biblioth&egrave;que de balises.
Les propri&eacute;t&eacute;s suivantes sont d&eacute;finies dans un objet tagInfo :
• la propri&eacute;t&eacute; tagName, qui est une cha&icirc;ne ;
• la propri&eacute;t&eacute; attributes, qui est un tableau de cha&icirc;nes. Chaque cha&icirc;ne correspond au nom
d’un attribut d&eacute;fini pour cette balise.
Exemple :
L’exemple suivant indique que l’utilisation de la fonction
dw.tagLibrary.getImportedTagList() peut r&eacute;sulter en un tableau de balises de la
biblioth&egrave;que libName :
// &quot;fileURL&quot; et &quot;prefix&quot; ont &eacute;t&eacute; saisis par l’utilisateur,
// indiquant &agrave; la biblioth&egrave;que de balise d’importer le DTD/schema.
var libName = dw.tagLibrary.importDTDOrSchema(fileURL, prefix);
// Obtenir le tableau de balise pour cette biblioth&egrave;que.
// Il s’agit de l’objet TagInfo.
var tagArray = dw.tagLibrary.getImportedTagList(libName);
/ /Maintenant nous obtenons un objet sous forme de tableau contenant les
informations de balise.
// Nous pouvons en extraire les infos. Ceci extrait les info du premier.
// Remarque : Cela suppose qu’il y a au moins un &eacute;l&eacute;ment dans le tableau.
var firstTagName = tagArray[0].name;
var firstTagAttributes = tagArray[0].attributes;
// Remarquez que firstTagAttributes est un tableau d’attributs.
Fonctions de l’&eacute;diteur de balises et de la biblioth&egrave;que de balises
427
428
Chapitre 18 : Code
CHAPITRE 19
Activateurs
Les fonctions d’activateur de Macromedia Dreamweaver MX 2004 d&eacute;terminent si une autre
fonction peut effectuer une op&eacute;ration donn&eacute;e dans le contexte actuel. Les circonstances g&eacute;n&eacute;rales
dans lesquelles chaque fonction renvoie la valeur true sont d&eacute;crites dans la sp&eacute;cification de
fonction correspondante. Toutefois, ces descriptions ne pr&eacute;tendent pas &ecirc;tre exhaustives et ne
couvrent pas n&eacute;cessairement tous les cas o&ugrave; la fonction renverrait la valeur false.
Activateurs
Les fonctions d’activateur dans l’API JavaScript comprennent les fonctions suivantes.
dom.canAlign()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Aligner &agrave; gauche, Aligner &agrave; droite, Aligner en
haut ou Aligner en bas.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si deux calques ou zones r&eacute;actives au minimum sont s&eacute;lectionn&eacute;s.
dom.canApplyTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Appliquer &agrave; la page. Cette fonction n’est
valide que pour le document actif.
429
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le document n’est pas un &eacute;l&eacute;ment de biblioth&egrave;que ni un mod&egrave;le, et
si la s&eacute;lection n’est pas encadr&eacute;e de balises NOFRAMES.
dom.canArrange()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Mettre au premier plan ou Mettre en arri&egrave;replan.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si une zone r&eacute;active est s&eacute;lectionn&eacute;e.
dom.canClipCopyText()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Copier comme texte.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les d&eacute;calages d’ouverture et de fermeture sont diff&eacute;rents ; false
dans le cas contraire, pour indiquer qu’aucune s&eacute;lection n’a &eacute;t&eacute; effectu&eacute;e.
dom.canClipPaste()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Coller.
Arguments
Aucun.
430
Chapitre 19 : Activateurs
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le Presse-papiers contient des donn&eacute;es pouvant &ecirc;tre coll&eacute;es dans
Dreamweaver ; false dans le cas contraire.
dom.canClipPasteText()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Coller comme texte.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le Presse-papiers contient un &eacute;l&eacute;ment pouvant &ecirc;tre coll&eacute; dans
Dreamweaver comme texte ; false dans le cas contraire.
dom.canConvertLayersToTable()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Convertir les calques en tableau.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;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&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Convertir les tableaux en calques.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si tout le contenu de la section BODY du document figure dans des
tableaux et si le document n’est pas bas&eacute; sur un mod&egrave;le ; false dans le cas contraire.
Activateurs
431
dom.canDecreaseColspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration R&eacute;duire l’&eacute;tendue de colonnes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la cellule active poss&egrave;de un attribut COLSPAN et si la valeur de cet
attribut est sup&eacute;rieure ou &eacute;gale &agrave; 2 ; false dans le cas contraire.
dom.canDecreaseRowspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration R&eacute;duire l’&eacute;tendue de lignes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la cellule active poss&egrave;de un attribut ROWSPAN et si la valeur de cet
attribut est sup&eacute;rieure ou &eacute;gale &agrave; 2 ; false dans le cas contraire.
dom.canDeleteTableColumn()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Supprimer la colonne.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le point d’insertion se trouve dans une cellule ou si une cellule ou
une colonne est s&eacute;lectionn&eacute;e ; false dans le cas contraire.
432
Chapitre 19 : Activateurs
dom.canDeleteTableRow()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Supprimer la ligne.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le point d’insertion se trouve dans une cellule ou si une cellule ou
une ligne est s&eacute;lectionn&eacute;e ; false dans le cas contraire.
dom.canEditNoFramesContent()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Modifier le contenu sans cadres.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;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&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Augmenter l’&eacute;tendue de colonnes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il existe des cellules &agrave; droite de la cellule active ; false dans le cas
contraire.
Activateurs
433
dom.canIncreaseRowspan()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Augmenter l’&eacute;tendue de lignes.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il existe des cellules au-dessous de la cellule active ; false dans le
cas contraire.
dom.canInsertTableColumns()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Ins&eacute;rer une colonne.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection se trouve dans un tableau ; false si la s&eacute;lection
constitue un tableau entier ou si elle ne se trouve pas dans un tableau.
dom.canInsertTableRows()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Ins&eacute;rer une ligne.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection se trouve dans un tableau ; false si la s&eacute;lection
constitue un tableau entier ou si elle ne se trouve pas dans un tableau.
434
Chapitre 19 : Activateurs
dom.canMakeNewEditableRegion()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Nouvelle r&eacute;gion modifiable.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le document actif est un fichier de mod&egrave;le (DWT).
dom.canMarkSelectionAsEditable()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Marquer la s&eacute;lection comme modifiable.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il y a une s&eacute;lection et si le document actif est un fichier DWT ;
false dans le cas contraire.
dom.canMergeTableCells()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Fusionner les cellules.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection est un regroupement adjacent de cellules de tableau ;
false dans le cas contraire.
dom.canPlayPlugin()
Disponibilit&eacute;
Dreamweaver 3.
Activateurs
435
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Lire. Cette fonction n’est valide que
pour le document actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection peut &ecirc;tre ex&eacute;cut&eacute;e avec un plug-in.
dom.canRedo()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration R&eacute;tablir.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il reste des op&eacute;rations &agrave; r&eacute;tablir ; false dans le cas contraire.
dom.canRemoveEditableRegion()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Rendre la r&eacute;gion non modifiable.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le document actif est un mod&egrave;le ; false dans le cas contraire.
dom.canSelectTable()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration S&eacute;lectionner le tableau.
436
Chapitre 19 : Activateurs
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection ou le point d’insertion se trouve dans un tableau ;
false dans le cas contraire.
dom.canSetLinkHref()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut modifier le lien qui entoure la s&eacute;lection en cours ou en cr&eacute;er un si
n&eacute;cessaire.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection est une image, du texte ou si le point d’insertion se
trouve dans un lien ; false dans les autres cas. Une s&eacute;lection de texte se d&eacute;finit comme une
s&eacute;lection pour laquelle l’inspecteur de propri&eacute;t&eacute;s de texte s’ouvrirait.
dom.canShowListPropertiesDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut afficher la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la liste.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection est encadr&eacute;e de balises LI ; false dans le cas contraire.
dom.canSplitFrame()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Fractionner le cadre [&agrave; gauche | &agrave; droite | vers
le haut | vers le bas].
Activateurs
437
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection se trouve dans un cadre ; false dans le cas contraire.
dom.canSplitTableCell()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Fractionner la cellule.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le point d’insertion se trouve dans une cellule de tableau ou si la
s&eacute;lection est une cellule de tableau ; false dans les autres cas.
dom.canStopPlugin()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Arr&ecirc;ter.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection est ex&eacute;cut&eacute;e actuellement avec un plug-in ; false dans
les autres cas.
dom.canUndo()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Annuler.
Arguments
Aucun.
438
Chapitre 19 : Activateurs
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il reste des op&eacute;rations &agrave; annuler ; false dans le cas contraire.
dom.hasTracingImage()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si le document poss&egrave;de un trac&eacute; d’image.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le document poss&egrave;de un trac&eacute; d’image ; false dans le cas
contraire.
dreamweaver.assetPalette.canEdit()
Disponibilit&eacute;
Dreamweaver 4.
Description
Active les options de menu du panneau Actifs pour permettre leur modification.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Renvoie une valeur bool&eacute;enne : true si l’actif peut &ecirc;tre modifi&eacute; ; 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&eacute;lection de plusieurs couleurs et URL dans la liste des favoris.
dreamweaver.assetPalette.canInsertOrApply()
Disponibilit&eacute;
Dreamweaver 4.
Description
V&eacute;rifie si les options s&eacute;lectionn&eacute;es peuvent &ecirc;tre ins&eacute;r&eacute;es ou appliqu&eacute;es. Renvoie les valeurs true ou
false pour que l’insertion ou l’application des options de menu puissent &ecirc;tre activ&eacute;es ou
d&eacute;sactiv&eacute;es.
Arguments
Aucun.
Activateurs
439
Valeurs renvoy&eacute;es
Renvoie une valeur bool&eacute;enne : true si les &eacute;l&eacute;ments s&eacute;lectionn&eacute;s peuvent &ecirc;tre ins&eacute;r&eacute;s ou
appliqu&eacute;s ; false si la page active est un mod&egrave;le et que la cat&eacute;gorie en cours est Templates. La
fonction renvoie &eacute;galement la valeur false si aucun document n’est ouvert ou si un &eacute;l&eacute;ment de
biblioth&egrave;que est s&eacute;lectionn&eacute; dans le document et que la cat&eacute;gorie active est Biblioth&egrave;que.
dreamweaver.canClipCopy()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Copier.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si un contenu s&eacute;lectionn&eacute; peut &ecirc;tre copi&eacute; dans le Presse-papiers ;
false dans le cas contraire.
dreamweaver.canClipCut()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Couper.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si un contenu s&eacute;lectionn&eacute; peut &ecirc;tre coup&eacute; dans le Presse-papiers ;
false dans le cas contraire.
dreamweaver.canClipPaste()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Coller.
Arguments
Aucun.
440
Chapitre 19 : Activateurs
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu du Presse-papiers, le cas &eacute;ch&eacute;ant, peut &ecirc;tre coll&eacute; dans le
document actif, dans la fen&ecirc;tre active du panneau Site ou, sur Macintosh, dans un champ de texte
d’un panneau flottant ou d’une bo&icirc;te de dialogue ; false dans le cas contraire.
dreamweaver.canDeleteSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut supprimer la s&eacute;lection en cours. Celle-ci peut se trouver, selon le
cas, dans la fen&ecirc;tre de document, dans le panneau Site ou, sur Macintosh, dans un champ de texte
d’un panneau flottant ou d’une bo&icirc;te de dialogue.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les d&eacute;calages d’ouverture et de fermeture de la s&eacute;lection sont
diff&eacute;rents, ce qui indique qu’une s&eacute;lection est effectu&eacute;e ; false s’ils sont identiques et qu’il n’y a
donc qu’un point d’insertion.
dreamweaver.canExportCSS()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Exporter les styles CSS.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si un document contient des styles de classe d&eacute;finis dans la section
HEAD ; false dans le cas contraire.
dreamweaver.canExportTemplateDataAsXML()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si Dreamweaver peut exporter le document actif au format XML.
Arguments
Aucun.
Activateurs
441
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le document actif peut &ecirc;tre export&eacute; et false dans le cas contraire.
Exemple
Dans l’exemple suivant, dw.canExportTemplateDataAsXML() est appel&eacute; pour d&eacute;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(&quot;file:///c|/dw_temps/mytemplate.txt&quot;)
}
dreamweaver.canFindNext()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Rechercher le suivant.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si un mod&egrave;le de recherche a &eacute;t&eacute; d&eacute;fini ; false dans le cas contraire.
dreamweaver.canOpenInFrame()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Ouvrir dans un cadre.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection ou le point d’insertion se trouve dans un cadre ; false
dans le cas contraire.
dreamweaver.canPlayRecordedCommand()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Reproduire la commande enregistr&eacute;e.
442
Chapitre 19 : Activateurs
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true s’il existe un document actif et une commande enregistr&eacute;e pouvant
&ecirc;tre ex&eacute;cut&eacute;e ; false dans le cas contraire.
dreamweaver.canPopupEditTagDialog()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si la s&eacute;lection en cours est une balise et si l’&eacute;l&eacute;ment de menu Modifier la balise est actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Nom de la balise s&eacute;lectionn&eacute;e ou la valeur null si aucune balise n’est s&eacute;lectionn&eacute;e.
dreamweaver.canRedo()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration R&eacute;tablir dans le contexte en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant s’il existe des op&eacute;rations pouvant &ecirc;tre annul&eacute;es.
dreamweaver.canRevertDocument()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration R&eacute;tablir (revenir au dernier &eacute;tat enregistr&eacute;).
Arguments
documentObject
• L’argument documentObject est l’objet situ&eacute; &agrave; la racine de l’arborescence DOM d’un
document (c’est-&agrave;-dire la valeur renvoy&eacute;e par dreamweaver.getDocumentDOM()).
Activateurs
443
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le document est &agrave; l’&eacute;tat non enregistr&eacute; et s’il en existe une version
enregistr&eacute;e sur un lecteur local.
dreamweaver.canSaveAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Enregistrer tout.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si deux documents non enregistr&eacute;s, ou plus, sont ouverts.
dreamweaver.canSaveDocument()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Enregistrer sur le document sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est la racine d’un DOM de document (valeur identique &agrave; celle
renvoy&eacute;e par dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le document contient des modifications non enregistr&eacute;es.
dreamweaver.canSaveDocumentAsTemplate()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Enregistrer comme mod&egrave;le sur le document
sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est la racine d’un DOM de document (valeur identique &agrave; celle
renvoy&eacute;e par dreamweaver.getDocumentDOM()).
444
Chapitre 19 : Activateurs
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le document peut &ecirc;tre enregistr&eacute; comme mod&egrave;le.
dreamweaver.canSaveFrameset()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Enregistrer le jeu de cadres sur le document
sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est la racine d’un DOM de document (valeur identique &agrave; celle
renvoy&eacute;e par dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le document est un jeu de cadres comportant des modifications
non enregistr&eacute;es.
dreamweaver.canSaveFramesetAs()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Enregistrer le jeu de cadres sous sur le
document sp&eacute;cifi&eacute;.
Arguments
documentObject
• L’argument documentObject est la racine d’un DOM de document (valeur identique &agrave; celle
renvoy&eacute;e par dreamweaver.getDocumentDOM()).
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne qui indique si le document est un jeu de cadres.
dreamweaver.canSelectAll()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration S&eacute;lectionner tout.
Arguments
Aucun.
Activateurs
445
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant s’il est possible d’effectuer une op&eacute;ration S&eacute;lectionner tout.
dreamweaver.canShowFindDialog()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Rechercher.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne qui est true si une fen&ecirc;tre de document ou un panneau Site est ouvert.
Cette fonction renvoie la valeur false lorsque la s&eacute;lection se trouve dans la section HEAD.
dreamweaver.canUndo()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Annuler dans le contexte en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant s’il existe des op&eacute;rations pouvant &ecirc;tre annul&eacute;es.
dreamweaver.cssRuleTracker.canEditSelectedRule()
Disponibilit&eacute;
Dreamweaver MX 2004.
Description
V&eacute;rifie si l’&eacute;diteur de grille de propri&eacute;t&eacute; peut s’appliquer &agrave; la r&egrave;gle s&eacute;lectionn&eacute;e. La grille de
propri&eacute;t&eacute; pouvant afficher les r&egrave;gles dans les fichiers verrouill&eacute;s, la valeur de renvoi true ne
garantit pas que les r&egrave;gles peuvent &ecirc;tre modifi&eacute;es.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’&eacute;diteur de grille de propri&eacute;t&eacute; peut s’appliquer &agrave; la r&egrave;gle
s&eacute;lectionn&eacute;e ; false dans le cas contraire.
446
Chapitre 19 : Activateurs
Exemple
Le code suivant v&eacute;rifie que la fonction de l’activateur a &eacute;t&eacute; d&eacute;finie sur la valeur true avant
d’autoriser les modifications sur la r&egrave;gle s&eacute;lectionn&eacute;e :
if(dw.cssRuleTracker.canEditSelectedRule()){
dw.cssRuleTracker.editSelectedRule();
}
dreamweaver.cssStylePalette.canApplySelectedStyle()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si le style s&eacute;lectionn&eacute; peut &ecirc;tre appliqu&eacute; au document actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le style s&eacute;lectionn&eacute; comporte un s&eacute;lecteur de classes ; false dans
le cas contraire.
dreamweaver.cssStylePalette.canDeleteSelectedStyle()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si le style s&eacute;lectionn&eacute; peut &ecirc;tre supprim&eacute; de la s&eacute;lection en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection peut &ecirc;tre supprim&eacute;e ; false dans le cas contraire.
dreamweaver.cssStylePalette.canDuplicateSelectedStyle()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si le style s&eacute;lectionn&eacute; peut &ecirc;tre dupliqu&eacute; dans le document actif.
Arguments
Aucun.
Activateurs
447
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le style s&eacute;lectionn&eacute; peut &ecirc;tre dupliqu&eacute; ; false dans le cas
contraire.
dreamweaver.cssStyle.canEditSelectedStyle()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si le style s&eacute;lectionn&eacute; peut &ecirc;tre modifi&eacute; dans le document actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le style s&eacute;lectionn&eacute; peut &ecirc;tre modifi&eacute; ; false dans le cas contraire.
dreamweaver.cssStylePalette.canEditStyleSheet()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si la s&eacute;lection en cours contient des &eacute;l&eacute;ments de feuille de style modifiables.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la s&eacute;lection est un nœud de feuille de style ou une d&eacute;finition de
style n’est pas masqu&eacute;e et si elle est distincte de ce document ; false si la s&eacute;lection est masqu&eacute;e ou
si elle se trouve dans ce document.
dreamweaver.isRecording()
Disponibilit&eacute;
Dreamweaver 3.
Description
Indique si Dreamweaver est en train de m&eacute;moriser une commande.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si Dreamweaver est en train d’enregistrer une commande.
448
Chapitre 19 : Activateurs
dreamweaver.htmlStylePalette.canEditSelection()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut modifier, supprimer ou dupliquer la s&eacute;lection dans le panneau Styles
HTML.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si Dreamweaver peut modifier, supprimer ou dupliquer la s&eacute;lection
dans le panneau Styles HTML ; false si aucun style n’est s&eacute;lectionn&eacute; ou si l’un des styles
ind&eacute;termin&eacute;s est s&eacute;lectionn&eacute;.
dreamweaver.resultsPalette.canClear()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie que vous pouvez effacer le contenu du panneau R&eacute;sultats actuellement actif.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu peut &ecirc;tre effac&eacute; ; false dans le cas contraire.
dreamweaver.resultsPalette.canCopy()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si la fen&ecirc;tre de r&eacute;sultats peut afficher un message copi&eacute; dans son contenu.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu peut &ecirc;tre affich&eacute; ; false dans le cas contraire.
Activateurs
449
dreamweaver.resultsPalette.canCut()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si la fen&ecirc;tre de r&eacute;sultats peut afficher un message coup&eacute; dans son contenu.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu peut &ecirc;tre affich&eacute; ; false dans le cas contraire.
dreamweaver.resultsPalette.canPaste()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si la fen&ecirc;tre de r&eacute;sultats peut afficher un message coll&eacute; dans son contenu.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu peut &ecirc;tre affich&eacute; ; false dans le cas contraire.
dreamweaver.resultsPalette.canOpenInBrowser()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si le rapport en cours peut &ecirc;tre affich&eacute; dans un navigateur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu peut &ecirc;tre affich&eacute; ; false dans le cas contraire.
dreamweaver.resultsPalette.canOpenInEditor()
Disponibilit&eacute;
Dreamweaver MX.
450
Chapitre 19 : Activateurs
Description
V&eacute;rifie si le rapport en cours peut &ecirc;tre affich&eacute; dans un &eacute;diteur.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le contenu peut &ecirc;tre affich&eacute; ; false dans le cas contraire.
dreamweaver.resultsPalette.canSave()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si la bo&icirc;te de dialogue d’enregistrement peut &ecirc;tre lanc&eacute;e pour le panneau en cours.
Actuellement, les panneaux Rapports du site, V&eacute;rification du navigateur cible, Validation et
V&eacute;rificateur de lien prennent en charge la bo&icirc;te de dialogue d’enregistrement.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true, si la bo&icirc;te de dialogue d’enregistrement appara&icirc;t ; false dans le cas
contraire.
dreamweaver.resultsPalette.canSelectAll()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si un message S&eacute;lectionner tout peut &ecirc;tre transmis &agrave; la fen&ecirc;tre active.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true, si le message S&eacute;lectionner tout peut &ecirc;tre transmis ; false dans le cas
contraire.
dreamweaver.snippetpalette.canEditSnippet()
Disponibilit&eacute;
Dreamweaver MX.
Activateurs
451
Description
V&eacute;rifie si vous pouvez modifier l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; et renvoie la valeur true ou la valeur false
pour vous permettre d’activer ou de d&eacute;sactiver les &eacute;l&eacute;ments de menu destin&eacute;s &agrave; l’&eacute;dition.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si vous pouvez modifier l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; ; false dans le cas
contraire.
dreamweaver.snippetpalette.canInsert()
Disponibilit&eacute;
Dreamweaver MX.
Description
V&eacute;rifie si vous pouvez ins&eacute;rer ou appliquer l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; et renvoie la valeur true ou la
valeur false pour vous permettre d’activer ou de d&eacute;sactiver les &eacute;l&eacute;ments de menu destin&eacute;s &agrave;
l’insertion ou &agrave; l’application.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si vous pouvez ins&eacute;rer ou appliquer l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; ; false
dans le cas contraire.
site.browseDocument()
Disponibilit&eacute;
Dreamweaver 4.
Description
Ouvre tous les documents s&eacute;lectionn&eacute;s dans une fen&ecirc;tre de navigateur. Cela revient &agrave; utiliser la
commande Aper&ccedil;u dans le navigateur.
Arguments
browserName
• L’argument browserName est le nom du navigateur tel qu’il est d&eacute;fini dans les pr&eacute;f&eacute;rences
d’aper&ccedil;u dans le navigateur. Si cet argument n’est pas d&eacute;fini, le navigateur principal de
l’utilisateur est utilis&eacute; par d&eacute;faut.
Valeurs renvoy&eacute;es
Aucune.
452
Chapitre 19 : Activateurs
site.canAddLink()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Lier au [ fichier existant | nouveau fichier ].
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le document s&eacute;lectionn&eacute; dans la carte du site est un fichier
HTML ; false dans le cas contraire.
site.canChangeLink()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Modifier le lien.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si un fichier HTML ou Flash est li&eacute; au fichier s&eacute;lectionn&eacute; dans la
carte du site ; false dans le cas contraire.
site.canCheckIn()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Archiver.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si les conditions suivantes sont vraies ; false dans le cas contraire.
• Un site distant a &eacute;t&eacute; d&eacute;fini.
Activateurs
453
• Dans le cas o&ugrave; une fen&ecirc;tre de document est active, le fichier a &eacute;t&eacute; enregistr&eacute; sur un site local ou,
dans le cas o&ugrave; le panneau Site est actif, un ou plusieurs fichiers ou dossiers sont s&eacute;lectionn&eacute;s.
• La fonction Check In/Check Out est activ&eacute;e pour le site.
site.canCheckOut()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Extraire sur le ou les fichiers sp&eacute;cifi&eacute;s.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si toutes les conditions suivantes sont vraies ; false dans le cas
contraire.
• Un site distant a &eacute;t&eacute; d&eacute;fini.
• Dans le cas o&ugrave; une fen&ecirc;tre de document est active, le fichier appartient &agrave; un site local et il n’est
•
pas d&eacute;j&agrave; extrait ou, dans le cas o&ugrave; le panneau Site est actif, plusieurs fichiers ou dossiers sont
s&eacute;lectionn&eacute;s et au moins un des fichiers s&eacute;lectionn&eacute;s n’a pas encore &eacute;t&eacute; extrait.
La fonction Check In/Check Out est activ&eacute;e pour le site.
site.canCloak()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration de voilage.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction canCloak()
doit agir sur l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un dossier donn&eacute;,
indiquant que la fonction canCloak() doit agir sur le dossier sp&eacute;cifi&eacute; et l’ensemble de son
contenu.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si Dreamweaver peut ex&eacute;cuter l’op&eacute;ration de voilage sur le site en
cours ou le dossier sp&eacute;cifi&eacute; ; false dans le cas contraire.
454
Chapitre 19 : Activateurs
site.canConnect()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut se connecter au site distant.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le site distant en cours est un site FTP ; false dans le cas
contraire.
site.canFindLinkSource()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Rechercher la source du lien.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant que le lien s&eacute;lectionn&eacute; dans la carte du site n’est pas la page d’accueil.
site.canGet()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Acqu&eacute;rir.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Si l’argument est site, valeur bool&eacute;enne indiquant si un ou plusieurs fichiers ou dossiers sont
s&eacute;lectionn&eacute;s dans le panneau Site et si un site distant a &eacute;t&eacute; d&eacute;fini. Si l’argument est une URL,
valeur bool&eacute;enne indiquant si le document appartient &agrave; un site pour lequel un site distant a &eacute;t&eacute;
d&eacute;fini.
Activateurs
455
site.canLocateInSite()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Retrouver sur le site local ou Retrouver
sur le site distant (en fonction de l’argument).
Arguments
localOrRemote, siteOrURL
• L’argument localOrRemote doit &ecirc;tre local ou remote.
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
L’une des valeurs suivantes :
• si le premier argument est le mot-cl&eacute; local et le second une URL, valeur bool&eacute;enne indiquant
•
•
si le document appartient &agrave; un site ;
si le premier argument est le mot-cl&eacute; remote et le second une URL, valeur bool&eacute;enne
indiquant si le document appartient &agrave; un site pour lequel un site local a &eacute;t&eacute; d&eacute;fini et, si le type
de serveur est Local/R&eacute;seau, si le lecteur est mont&eacute; ;
si le second argument est le mot-cl&eacute; site, valeur bool&eacute;enne indiquant si les deux fen&ecirc;tres
contiennent des fichiers de site (et non la carte du site) et si la s&eacute;lection se trouve dans le volet
oppos&eacute; &agrave; l’argument.
site.canMakeEditable()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration D&eacute;sactiver le mode Lecture seule.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si Dreamweaver peut effectuer une op&eacute;ration D&eacute;sactiver le mode
Lecture seule ; false si un ou plusieurs des fichiers s&eacute;lectionn&eacute;s sont verrouill&eacute;s.
site.canMakeNewFileOrFolder()
Disponibilit&eacute;
Dreamweaver 3.
456
Chapitre 19 : Activateurs
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Nouveau fichier ou Nouveau dossier dans le
panneau Site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si des fichiers sont visibles dans le volet s&eacute;lectionn&eacute; du panneau Site ;
false dans le cas contraire.
site.canOpen()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut ouvrir les fichiers ou les dossiers actuellement s&eacute;lectionn&eacute;s dans le
panneau Site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si des fichiers ou des dossiers sont s&eacute;lectionn&eacute;s dans le panneau Site ;
false dans les autres cas.
site.canPut()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Placer.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
L’une des valeurs suivantes :
• si l’argument est le mot-cl&eacute; site, renvoie la valeur true si des fichiers ou des dossiers sont
•
s&eacute;lectionn&eacute;s dans le panneau Site et si un site distant a &eacute;t&eacute; d&eacute;fini ; renvoie la valeur false dans
les autres cas ;
si l’argument est une URL, renvoie la valeur true si le document appartient &agrave; un site pour
lequel un site distant a &eacute;t&eacute; d&eacute;fini ; renvoie la valeur false dans le cas contraire.
Activateurs
457
site.canRecreateCache()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Recr&eacute;er le cache du site.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si l’option Utiliser le cache pour acc&eacute;l&eacute;rer les mises &agrave; jour des liens
est activ&eacute;e pour le site en cours.
site.canRefresh()
Disponibilit&eacute;
Dreamweaver 3.
Description
V&eacute;rifie si Dreamweaver peut effectuer une op&eacute;ration Actualiser [local | distant].
Arguments
localOrRemote
• L’argument localOrRemote doit &ecirc;tre le mot-cl&eacute; local ou remote.
Valeurs renvoy&eacute;es
Valeur true si l’argument localOrRemote est le mot-cl&eacute; local ; sinon, une valeur bool&eacute;enne
indiquant si un site distant a &eacute;t&eacute; d&eacute;fini.
site.canRemoveLink()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Supprimer le lien.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant qu’un fichier HTML ou Flash est li&eacute; au fichier s&eacute;lectionn&eacute; dans la
carte du site.
458
Chapitre 19 : Activateurs
site.canSetLayout()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Mise en forme.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la carte du site est visible ; false dans les autres cas.
site.canSelectAllCheckedOutFiles()
Disponibilit&eacute;
Dreamweaver 4.
Description
D&eacute;termine si la fonction Archiver/Extraire est activ&eacute;e sur le site en cours.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le site autorise l’archivage et l’extraction ; false dans le cas
contraire.
site.canSelectNewer()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration S&eacute;lectionner [distants | locaux] plus
r&eacute;cents.
Arguments
localOrRemote
• L’argument localOrRemote doit &ecirc;tre le mot-cl&eacute; local ou remote.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si le document appartient &agrave; un site pour lequel un site distant a &eacute;t&eacute;
d&eacute;fini.
Activateurs
459
site.canShowPageTitles()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Afficher les titres de page.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si la carte du site est visible ; false dans le cas contraire.
site.canSynchronize()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Synchroniser.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Valeur bool&eacute;enne indiquant si un site distant a &eacute;t&eacute; d&eacute;fini.
site.canUncloak()
Disponibilit&eacute;
Dreamweaver MX.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration de suppression du voile.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre le mot-cl&eacute; site, indiquant que la fonction canUncloak()
doit agir sur l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, ou l’URL d’un dossier sp&eacute;cifique, ce
qui signifie que la fonction canUncloak() doit agir sur le dossier sp&eacute;cifi&eacute; et l’ensemble de son
contenu.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si Dreamweaver peut ex&eacute;cuter l’op&eacute;ration de suppression de voilage
sur le site en cours ou le dossier sp&eacute;cifi&eacute; ; false dans le cas contraire.
460
Chapitre 19 : Activateurs
site.canUndoCheckOut()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Annuler extraction.
Arguments
siteOrURL
• L’argument siteOrURL doit &ecirc;tre soit le mot-cl&eacute; site, indiquant que la fonction doit agir sur
l’&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans le panneau Site, soit l’URL d’un fichier.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le fichier sp&eacute;cifi&eacute; ou l’un des fichiers s&eacute;lectionn&eacute;s, au moins, a &eacute;t&eacute;
extrait.
site.canViewAsRoot()
Disponibilit&eacute;
Dreamweaver 3.
Description
D&eacute;termine si Dreamweaver peut effectuer une op&eacute;ration Afficher comme racine.
Arguments
Aucun.
Valeurs renvoy&eacute;es
Une valeur bool&eacute;enne : true si le fichier sp&eacute;cifi&eacute; est un fichier HTML ou Flash ; false dans le
cas contraire.
Activateurs
461
462
Chapitre 19 : Activateurs
INDEX
A
acc&egrave;s &agrave; la base de donn&eacute;es, fonctions 91
activateur, fonctions 429
activateurs
valeur de renvoi 429
addBehavior() 305
addDebugContextData() 182
addItem() 174
addLinkToNewFile() 223
addResultItem() 175
addSpacerToColumn() 364
affichage des tableaux 99
align() 356
API d’E/S des fichiers
DWfile.copy() 34
DWfile.createFolder() 34
DWfile.exists() 35
DWfile.getAttributes() 35
DWfile.getCreationDate() 37
DWfile.getCreationDateObj() 37
DWfile.getModificationDate() 36
DWfile.getModificationDateObj() 38
DWfile.getSize() 38
DWfile.listFolder() 38
DWfile.read() 39
DWfile.remove() 40
DWfile.setAttributes() 40
DWfile.write() 41
API d’int&eacute;gration de commande source
SCS_AfterGet() 139
SCS_AfterPut() 140
SCS_BeforeGet() 138
SCS_BeforePut() 139
SCS_canCheckin() 136
SCS_canCheckout() 135
SCS_canConnect() 135
SCS_canDelete() 137
SCS_canGet() 135
SCS_canNewFolder() 137
SCS_canPut() 136
SCS_canRename() 138
SCS_CanUndoCheckout() 137
SCS_Checkin() 129
SCS_Checkout() 129
SCS_Connect() 121
SCS_Delete() 125
SCS_Disconnect() 121
SCS_Get() 124
SCS_GetAgentInfo() 120
SCS_GetCheckoutName() 128
SCS_GetConnectionInfo() 126
SCS_GetDesignNotes() 133
SCS_GetErrorMessage() 131
SCS_GetErrorMessageLength() 131
SCS_GetFileCheckoutList() 131
SCS_GetFolderList() 123
SCS_GetFolderListLength() 122
SCS_GetMaxNoteLength() 132
SCS_GetNewFeatures() 128
SCS_GetNoteCount() 132
SCS_GetNumCheckedOut() 130
SCS_GetNumNewFeatures() 127
SCS_GetRootFolder() 122
SCS_GetRootFolderLength() 122
SCS_IsConnected() 121
SCS_IsRemoteNewer() 134
SCS_ItemExists() 126
SCS_NewFolder() 125
SCS_Rename() 125
SCS_SetDesignNotes() 133
SCS_SiteDeleted() 127
SCS_SiteRenamed() 127
SCS_UndoCheckout() 130
API d’int&eacute;gration de commandesource
463
SCS_Put() 124
API d’int&eacute;gration de Fireworks 63
bringDWToFront() 63
bringFWToFront() 64
execJsInFireworks() 64
getJsResponse() 65
mayLaunchFireworks() 66
optimizeInFireworks() 66
validateFireworks() 67
API d’objet Flash
SWFFile.createFile() 73
SWFFile.getNaturalSize() 74
SWFFile.getObjectType() 75
SWFFile.readFile() 75
API de base de donn&eacute;es 77
fonctions d’acc&egrave;s 91
fonctions de connexion 78
MMDB.deleteConnection() 78
MMDB.getColdFusionDsnList() 79
MMDB.getConnection() 79
MMDB.getConnectionList() 80
MMDB.getConnectionName() 80
MMDB.getConnectionString() 81
MMDB.getDriverName() 82
MMDB.getDriverUrlTemplateList() 82
MMDB.getLocalDsnList() 83
MMDB.getPassword() 83
MMDB.getProcedures() 94
MMDB.getRdsPassword() 84
MMDB.getRdsUserName() 84
MMDB.getRemoteDsnList() 84
MMDB.getRuntimeConnectionType() 85
MMDB.getSPColumnList() 96
MMDB.getSPColumnListNamedParams() 96
MMDB.getSPParameters() 97
MMDB.getSPParamsAsString() 98
MMDB.getTables() 99
MMDB.getUserName() 85
MMDB.getViews() 99
MMDB.hasConnectionWithName() 86
MMDB.needToPromptForRdsInfo() 86
MMDB.needToRefreshColdFusionDsnList() 87
MMDB.popupConnection() 87
MMDB.setRdsPassword() 88
MMDB.setRdsUserName() 88
MMDB.showColdFusionAdmin() 88
MMDB.showConnectionMgrDialog() 89
MMDB.showOdbcDialog() 89
MMDB.showRdsUserDialog() 89
MMDB.showRestrictDialog() 90
464
Index
MMDB.showResultset() 100
MMDB.showSPResultset() 101
MMDB.showSPResultsetNamedParams() 102
MMDB.testConnection() 90
API de bo&icirc;te de dialogue de connexion &agrave; une base de
donn&eacute;es 105
fichiers de d&eacute;finition 109
fichiers inclus g&eacute;n&eacute;r&eacute;s 108
API de connectivit&eacute; &agrave; une base de donn&eacute;es
applyConnection() 107
findConnection() 105
inspectConnection() 107
API de Design Notes
MMNotes.close() 52
MMNotes.filePathToLocalURL() 52
MMNotes.get() 53
MMNotes.getKeyCount() 53
MMNotes.getKeys() 53
MMNotes.getSiteRootForFile() 54
MMNotes.getVersionName() 54
MMNotes.getVersionNum() 55
MMNotes.localURLToFilePath() 55
API HTTP 43, 44
MMHttp.clearServerScriptsFolder() 44
MMHttp.clearTemp() 44
MMHttp.getFile() 45
MMHttp.getFileCallback() 46
MMHttp.getTextCallback() 48
MMHttp.postText() 48
MMHttp.postTextCallback() 49
API JavaBeans 113
MMJB.getClasses() 113
MMJB.getClassesFromPackage() 117
MMJB.getErrorMessage() 117
MMJB.getEvents() 114
MMJB.getMethods() 115
MMJB.getProperties() 113
API, types
base de donn&eacute;es 77
bo&icirc;te de dialogue de connexion &agrave; une base de
donn&eacute;es 105
Design Note 52
E/S de fichiers 33
HTTP 43, 44
int&eacute;gration de commande source 120
int&eacute;gration de Fireworks 63
JavaBeans 113
objet Flash 73
applications externes, fonctions 143
applications, fonctions globales 151
applyCharacterMarkup() 388
applyConnection() 107
applyCSSStyle() 347
applyFontMarkup() 389
applySelectedStyle() 349
applyTemplate() 319
arrange() 356
arrangeFloatingPalettes() 363
arrowDown() 165, 410
arrowLeft() 166, 411
arrowRight() 166, 411
arrowUp() 166, 411
assetPalette.addToFavoritesFromDocument() 295
assetPalette.addToFavoritesFromSiteAssets() 295
assetPalette.addToFavoritesFromSiteWindow() 296
assetPalette.canEdit() 439
assetPalette.canInsertOrApply() 439
assetPalette.copyToSite() 296
assetPalette.edit() 296
assetPalette.getSelectedCategory() 297
assetPalette.getSelectedItems() 297
assetPalette.getSelectedView() 298
assetPalette.insertOrApply() 298
assetPalette.locateInSite() 299
assetPalette.newAsset() 299
assetPalette.newFolder() 299
assetPalette.recreateLibraryFromDocument() 300
assetPalette.refreshSiteAssets() 300
assetPalette.removeFromFavorites() 300
assetPalette.renameNickname() 301
assetPalette.setSelectedCategory() 301
assetPalette.setSelectedView() 301
attachExternalStylesheet() 350
attributs, balise de fragment de code 325
B
backspaceKey() 167
balanceBracesTextView() 412
balise de fragment de code
attributs 325
barres d’outils, fonctions 203
bascule, fonctions 183
bases de donn&eacute;es
API 77
API de bo&icirc;te de dialogue de connexion 105
fichiers de d&eacute;finition de type de connexion 109
fonctions d’acc&egrave;s 91
fonctions de connexion 78
beep() 151
biblioth&egrave;que de balises, fonctions 423
bringAttentionToFloater() 210
bringDWToFront() 63
bringFWToFront() 64
browseDocument() 143, 452
browseForFileURL() 256
browseForFolderURL() 256
C
cadres et jeux de cadres, fonctions 354
calques en tableaux 251
canAddLinkToFile() 453
canAlign() 429
canApplyTemplate() 429
canArrange() 430
canChangeLink() 453
canCheckIn() 453
canCheckOut() 454
canClear() 449
canClipCopy() 440
canClipCopyText() 430
canClipCut() 440
canClipPaste() 430, 440
canClipPasteText() 431
canCloak() 454
canConnect() 455
canConvertLayersToTable() 431
canConvertTablesToLayers() 431
canCopy() 449
canCut() 450
canDecreaseColspan() 432
canDecreaseRowspan() 432
canDeleteTableColumn() 432
canDeleteTableRow() 433
canEditColumns() 223
canEditNoFramesContent() 433
canEditSelectedRule() 446
canEditSelection() 449
canExportCSS() 441
canExportTemplateDataAsXML() 441
canFindLinkSource() 455
canFindNext() 442
canGet() 455
canIncreaseColspan() 433
canIncreaseRowspan() 434
canInsertTableColumns() 434
canInsertTableRows() 434
canLocateInSite() 456
canMakeEditable() 456
canMakeNewEditableRegion() 435
canMakeNewFileOrFolder() 456
Index
465
canMarkSelectionAsEditable() 435
canMergeTableCells() 435
canOpen() 457
canOpenInBrowser() 450
canOpenInEditor() 450
canOpenInFrame() 442
canPaste() 450
canPlayPlugin() 435
canPlayRecordedCommand() 442
canPopupEditTagDialog() 443
canPut() 457
canRecreateCache() 458
canRedo() 436, 443
canRefresh() 458
canRemoveEditableRegion() 436
canRemoveLink() 458
canRevertDocument() 443
canSave() 451
canSaveAll() 444
canSaveDocument() 444
canSaveDocumentAsTemplate() 444
canSaveFrameset() 445
canSaveFramesetAs() 445
canSelectAll() 445, 451
canSelectAllCheckedOutFiles() 459
canSelectNewer() 459
canSelectTable() 436
canSetLayout() 459
canSetLinkHref() 437
canShowFindDialog() 446
canShowListPropertiesDialog() 437
canSplitFrame() 437
canSplitTableCell() 438
canStopPlugin() 438
canSynchronize() 460
canUncloak() 460
canUndo() 438, 446
canUndoCheckOut() 461
canViewAsRoot() 461
carte graphique, fonctions 356
cascade() 211
changeLink() 224
changeLinkSitewide() 224
checkIn() 224
checkLinks() 225
checkOut() 225
checkSpelling() 269
checkTargetBrowsers() 226, 270
chemins, fonctions 279
clavier, fonctions 165
466
Index
cleanupXHTML() 254
clear() 179
clearServerScriptsFolder() 44
clearSteps() 159
clearTemp() 44
clipCopy() 314, 317
clipCopyText() 314
clipCut() 315, 317
clipPaste() 315, 318
clipPasteText() 316
cloak() 226
closeDocument() 257
CloseNotesFile() 57
code, fonctions 379, 407
codeHints.addFunction() 381, 382
codeHints.addMenu() 380
codeHints.resetMenu() 382
codeHints.showCodeHints() 382
ColdFusion Componant Explorer 231, 235
colonnes
acquisition &agrave; partir d’instructions 91
acquisition &agrave; partir des proc&eacute;dures stock&eacute;es 96
comportements, fonctions 305
composant ColdFusion, explorateur 231
conception, fonctions 347
connection_includefile.edml 109
connectivit&eacute;, fonctions
pr&eacute;sentation 103
connexion &agrave; une base de donn&eacute;es, fonctions 78
connexions 80
acquisition de la liste des 80
noms 91
contenu de page, fonctions 295
conventions, dans le manuel 30
conversions, fonctions 251
convertLayersToTable() 251
convertTablesToLayers() 251
convertToXHTML() 254
convertWidthsToPercent() 370
convertWidthsToPixels() 370
Copy() 179
copy() 34
copySteps() 159
createDocument() 257
createFolder() 34
createLayoutCell() 364
createLayoutTable() 365
createResultsWindow() 173
createXHTMLDocument() 258
createXMLDocument() 259
cssRuleTracker.canEditSelectedRule() 446
cssStyle.canEditSelectedStyle() 448
cssStylePalette.canApplySelectedStyle() 447
cssStylePalette.canDeleteSelectedStyle() 447
cssStylePallette.canEditStyleSheet() 448
cut() 179
D
Data Manager 331
d&eacute;clarations SQL
extraction des colonnes 92
decreaseColspan() 370
decreaseRowspan() 371
defineSites() 226
d&eacute;finition de connexion, fichier 109
deleteConnection() 78
deleteKey() 167
deleteSelectedItem() 302
deleteSelectedStyle() 350
deleteSelectedTemplate() 304
deleteSelection() 227, 389, 401
deleteTableColumn() 371
deleteTableRow() 371
deployFilesToTestingServerBin() 227
description, attribut 325
Design Notes
API C 57
API JavaScript 52
exp&eacute;rience de l’utilisateur 51
structure de fichier 51
detachFromLibrary() 319
detachFromTemplate() 320
documents, fonctions globales 269
doDeferredTableUpdate() 372
doesColumnHaveSpacer() 365
doesGroupHaveSpacers() 365
dom.addBehavior() 305
dom.addSpacerToColumn() 364
dom.align() 356
dom.applyCharacterMarkup() 388
dom.applyCSSStyle() 347
dom.applyFontMarkup() 389
dom.applyTemplate() 319
dom.arrange() 356
dom.arrowDown() 165
dom.arrowLeft() 166
dom.arrowRight() 166
dom.arrowUp() 166
dom.backspaceKey() 167
dom.canAlign() 429
dom.canApplyTemplate() 429
dom.canArrange() 430
dom.canClipCopyText() 430
dom.canClipPaste() 430
dom.canClipPasteText() 431
dom.canConvertLayersToTable() 431
dom.canConvertTablesToLayers() 431
dom.canDecreaseColspan() 432
dom.canDecreaseRowspan() 432
dom.canDeleteTableColumn() 432
dom.canDeleteTableRow() 433
dom.canEditNoFramesContent() 433
dom.canIncreaseColspan() 433
dom.canIncreaseRowspan() 434
dom.canInsertTableColumns() 434
dom.canInsertTableRows() 434
dom.canMakeNewEditableRegion() 435
dom.canMarkSelectionAsEditable() 435
dom.canMergeTableCells() 435
dom.canPlayPlugin() 435
dom.canRedo() 436
dom.canRemoveEditableRegion() 436
dom.canSelectTable() 436
dom.canSetLinkHref() 437
dom.canShowListPropertiesDialog() 437
dom.canSplitFrame() 437
dom.canSplitTableCell() 438
dom.canStopPlugin() 438
dom.canUndo() 438
dom.checkSpelling() 269
dom.checkTargetBrowsers() 270
dom.cleanupXHTML() 254
dom.clipCopy 314
dom.clipCopyText() 314
dom.clipCut() 315
dom.clipPaste 315
dom.clipPasteText() 316
dom.convertLayersToTable() 251
dom.convertTablesToLayers() 251
dom.convertToXHTML() 254
dom.convertWidthsToPercent() 370
dom.convertWidthsToPixels() 370
dom.createLayoutCell() 364
dom.createLayoutTable() 365
dom.decreaseColspan() 370
dom.decreaseRowspan() 371
dom.deleteKey() 167
dom.deleteSelection() 389
dom.deleteTableColumn() 371
dom.deleteTableRow() 371
Index
467
dom.detachFromLibrary() 319
dom.detachFromTemplate() 320
dom.doDeferredTableUpdate() 372
dom.doesColumnHaveSpacer() 365
dom.doesGroupHaveSpacers() 365
dom.editAttribute() 390
dom.endOfDocument() 167
dom.endOfLine() 168
dom.exitBlock() 390
dom.forceToolbarUpdate() 203
dom.formatRange() 407
dom.formatSelection() 408
dom.getAttachedTemplate() 320
dom.getAutoValidationCount() 408
dom.getBehavior() 306
dom.getCharSet() 390
dom.getClickedHeaderColumn() 366
dom.getEditableRegionList() 320
dom.getEditNoFramesContent() 184
dom.getFocus() 209
dom.getFontMarkup() 391
dom.getFrameNames() 354
dom.getHideAllVisualAids() 184
dom.getIsLibraryDocument() 321
dom.getIsTemplateDocument() 321
dom.getIsXHTMLDocument() 255
dom.getLineFromOffset() 391
dom.getLinkHref() 391
dom.getLinkTarget() 392
dom.getListTag() 392
dom.getParseMode() 270
dom.getPreventLayerOverlaps() 184
dom.getRulerOrigin() 358
dom.getRulerUnits() 359
dom.getSelectedEditableRegion() 321
dom.getSelectedNode() 282
dom.getSelection() 282
dom.getShowAutoIndent() 185
dom.getShowFrameBorders() 185
dom.getShowGrid() 185
dom.getShowHeadView() 185
dom.getShowImageMaps() 186
dom.getShowInvalidHTML() 186
dom.getShowInvisibleElements() 186
dom.getShowLayerBorders() 187
dom.getShowLayoutTableTabs() 366
dom.getShowLayoutView() 366
dom.getShowLineNumbers() 187
dom.getShowNoscript 408
dom.getShowRulers() 187
468
Index
dom.getShowSyntaxColoring() 188
dom.getShowTableBorders() 188
dom.getShowTableWidths() 372
dom.getShowToolbar() 188
dom.getShowToolbarIconLabels() 203
dom.getShowTracingImage() 189
dom.getShowWordWrap() 189
dom.getSnapToGrid() 189
dom.getTableExtent() 372
dom.getTagSelectorTag() 423
dom.getTextAlignment() 392
dom.getTextFormat() 393
dom.getToolbarIdArray() 204
dom.getToolbarItemValue() 204
dom.getToolbarLabel() 205
dom.getToolbarVisibility() 206
dom.getTracingImageOpacity() 359
dom.getView() 209
dom.getWindowTitle() 210
dom.hasCharacterMarkup() 393
dom.hasTracingImage() 439
dom.hideInfoMessagePopup() 270
dom.increaseColspan() 373
dom.increaseRowspan() 373
dom.indent() 393
dom.insertFlashElement() 72, 163
dom.insertHTML() 394
dom.insertLibraryItem() 322
dom.insertObject() 394
dom.insertTableColumns() 373
dom.insertTableRows() 374
dom.insertText() 395
dom.isColumnAutostretch() 367
dom.isDesignViewUpdated() 409
dom.isDocumentInFrame() 355
dom.isSelectionValid() 409
dom.loadTracingImage() 359
dom.makeCellWidthsConsistent() 367
dom.makeSizesEqual() 357
dom.markSelectionAsEditable() 322
dom.mergeTableCells() 374
dom.moveSelectionBy() 357
dom.newBlock() 395
dom.newEditableRegion() 322
dom.nextParagraph() 168
dom.nextWord() 169
dom.nodeToOffsets() 283
dom.notifyFlashObjectChanged() 396
dom.offsetsToNode() 283
dom.outdent() 396
dom.pageDown() 169
dom.pageUp() 169
dom.playAllPlugins() 360
dom.playPlugin() 360
dom.previousParagraph() 170
dom.previousWord() 170
dom.reapplyBehaviors() 306
dom.redo() 155
dom.removeAllSpacers() 367
dom.removeAllTableHeights() 375
dom.removeAllTableWidths() 375
dom.removeBehavior() 307
dom.removeCharacterMarkup() 397
dom.removeColumnWidth() 375
dom.removeCSSStyle() 348
dom.removeEditableRegion() 323
dom.removeFontMarkup() 397
dom.removeLink() 397
dom.removeSpacerFromColumn() 368
dom.resizeSelection() 398
dom.resizeSelectionBy() 357
dom.runTranslator() 292
dom.runValidation() 271
dom.saveAllFrames() 355
dom.selectAll() 284
dom.selectChild() 405
dom.selectParent() 406
dom.selectTable() 376
dom.serverModel.getAppURLPrefix() 340
dom.serverModel.getDelimiters() 340
dom.serverModel.getDisplayName() 341
dom.serverModel.getFolderName() 341
dom.serverModel.getServerExtension() 342
dom.serverModel.getServerIncludeUrlPatterns() 342
dom.serverModel.getServerInfo() 343
dom.serverModel.getServerLanguage() 344
dom.serverModel.getServerName() 344
dom.serverModel.getServerSupportsCharset() 345
dom.serverModel.getServerVersion() 345
dom.serverModel.testAppServer() 346
dom.setAttributeWithErrorChecking() 398
dom.setColumnAutostretch() 368
dom.setEditNoFramesContent() 190
dom.setHideAllVisualAids() 190
dom.setLayerTag() 358
dom.setLinkHref() 398
dom.setLinkTarget() 399
dom.setListBoxKind() 399
dom.setListTag() 400
dom.setPreventLayerOverlaps() 190
dom.setRulerOrigin() 360
dom.setRulerUnits() 361
dom.setSelectedNode() 284
dom.setSelection() 285
dom.setShowFrameBorders() 191
dom.setShowGrid() 191
dom.setShowHeadView() 191
dom.setShowImageMaps() 192
dom.setShowInvalidHTML() 192
dom.setShowInvisibleElements() 192
dom.setShowLayerBorders() 193
dom.setShowLayoutTableTabs() 369
dom.setShowLayoutView() 369
dom.setShowLineNumbers() 193
dom.setShowNoscript 410
dom.setShowRulers() 193
dom.setShowSyntaxColoring() 194
dom.setShowTableBorders() 194
dom.setShowTableWidths() 376
dom.setShowToolbar() 194
dom.setShowToolbarIconLabels() 207
dom.setShowTracingImage() 195
dom.setShowWordWrap() 195
dom.setSnapToGrid() 195
dom.setTableCellTag() 376
dom.setTableColumns() 377
dom.setTableRows() 377
dom.setTextAlignment() 400
dom.setTextFieldKind() 400
dom.setTextFormat() 401
dom.setToolbarItemAttribute() 206
dom.setToolbarPosition() 207
dom.setToolbarVisibility() 208
dom.setTracingImageOpacity() 362
dom.setTracingImagePosition() 361
dom.setView() 210
dom.showFontColorDialog() 401
dom.showInfoMessagePopup() 272
dom.showInsertTableRowsOrColumnsDialog() 377
dom.showListPropertiesDialog() 399
dom.showPagePropertiesDialog() 273
dom.snapTracingImageToSelection() 362
dom.source.arrowDown() 410
dom.source.arrowLeft() 411
dom.source.arrowRight() 411
dom.source.arrowUp() 411
dom.source.balanceBracesTextView() 412
dom.source.endOfDocument() 412
dom.source.endOfLine() 413
dom.source.endPage() 413
Index
469
dom.source.getCurrentLines() 413
dom.source.getLineFromOffset() 414
dom.source.getSelection() 414
dom.source.getText() 414
dom.source.getValidationErrorsForOffset() 415
dom.source.indentTextView() 415
dom.source.insert() 416
dom.source.nextWord() 416
dom.source.outdentTextView() 417
dom.source.pageDown() 417
dom.source.pageUp() 417
dom.source.previousWord() 418
dom.source.replaceRange() 418
dom.source.scrollEndFile() 419
dom.source.scrollLineDown() 419
dom.source.scrollLineUp() 419
dom.source.scrollPageDown() 420
dom.source.scrollPageUp() 420
dom.source.scrollTopFile() 420
dom.source.selectParentTag() 421
dom.source.setCurrentLine() 421
dom.source.startOfDocument() 421
dom.source.startOfLine() 422
dom.source.topPage() 422
dom.source.wrapSelection() 422
dom.splitFrame() 355
dom.splitTableCell() 378
dom.startOfDocument() 171
dom.startOfLine() 171
dom.stopAllPlugins() 362
dom.stopPlugin() 363
dom.stripTag() 406
dom.synchronizeDocument() 423
dom.undo() 156
dom.updateCurrentPage() 323
dom.wrapTag() 406
doURLDecoding() 273
doURLEncoding() 288
dreamweaver.arrangeFloatingPalettes() 363
dreamweaver.assetPalette.addToFavoritesFromDocume
nt() 295
dreamweaver.assetPalette.addToFavoritesFromSiteAsset
s() 295
dreamweaver.assetPalette.addToFavoritesFromSiteWin
dow() 296
dreamweaver.assetPalette.canEdit() 439
dreamweaver.assetPalette.canInsertOrApply() 439
dreamweaver.assetPalette.copyToSite() 296
dreamweaver.assetPalette.edit() 296
dreamweaver.assetPalette.getSelectedCategory() 297
470
Index
dreamweaver.assetPalette.getSelectedItems() 297
dreamweaver.assetPalette.getSelectedView() 298
dreamweaver.assetPalette.insertOrApply() 298
dreamweaver.assetPalette.locateInSite() 299
dreamweaver.assetPalette.newAsset() 299
dreamweaver.assetPalette.newFolder() 299
dreamweaver.assetPalette.recreateLibraryFromDocume
nt() 300
dreamweaver.assetPalette.refreshSiteAssets() 300
dreamweaver.assetPalette.removeFromFavorites() 300
dreamweaver.assetPalette.renameNickname() 301
dreamweaver.assetPalette.setSelectedCategory() 301
dreamweaver.assetPalette.setSelectedView() 301
dreamweaver.beep() 151
dreamweaver.behaviorInspector, objet 305
dreamweaver.behaviorInspector.getBehaviorAt() 310
dreamweaver.behaviorInspector.getBehaviorCount()
310
dreamweaver.behaviorInspector.getSelectedBehavior()
311
dreamweaver.behaviorInspector.moveBehaviorDown()
311
dreamweaver.behaviorInspector.moveBehaviorUp()
312
dreamweaver.behaviorInspector.setSelectedBehavior()
313
dreamweaver.bringAttention to Floater() 210
dreamweaver.browseDocument() 143
dreamweaver.browseForFileURL() 256
dreamweaver.browseForFolderURL() 256
dreamweaver.canClipCopy() 440
dreamweaver.canClipCut() 440
dreamweaver.canClipPaste() 440
dreamweaver.canExportCSS() 441
dreamweaver.canExportTemplateDataAsXML() 441
dreamweaver.canFindNext() 442
dreamweaver.canOpenInFrame() 442
dreamweaver.canPlayRecordedCommand() 442
dreamweaver.canPopupEditTagDialog() 443
dreamweaver.canRedo() 443
dreamweaver.canRevertDocument() 443
dreamweaver.canSaveAll() 444
dreamweaver.canSaveDocument() 444
dreamweaver.canSaveDocumentAsTemplate() 444
dreamweaver.canSaveFrameset() 445
dreamweaver.canSaveFramesetAs() 445
dreamweaver.canSelectAll() 445
dreamweaver.canShowFindDialog() 446
dreamweaver.canUndo() 446
dreamweaver.cascade() 211
dreamweaver.clipCopy() 317
dreamweaver.clipCut() 317
dreamweaver.clipPaste() 318
dreamweaver.closeDocument() 257
dreamweaver.codeHints.addFunction() 381, 382
dreamweaver.codeHints.addMenu() 380
dreamweaver.codeHints.resetMenu() 382
dreamweaver.codeHints.showCodeHints() 382
dreamweaver.createDocument() 257
dreamweaver.createResultsWindow() 173
dreamweaver.createXHTMLDocument() 258
dreamweaver.createXMLDocument() 259
dreamweaver.cssRuleTracker.canEditSelectedRule()
446
dreamweaver.cssRuleTracker.editSelectedRule() 348
dreamweaver.cssRuleTracker.newRule() 349
dreamweaver.cssStyle.canEditSelectedStyle() 448
dreamweaver.cssStylePalette, objet 347
dreamweaver.cssStylePalette.applySelectedStyle() 349
dreamweaver.cssStylePalette.canApplySelectedStyle()
447
dreamweaver.cssStylePalette.canDeleteSelectedStyle()
447
dreamweaver.cssStylePalette.canDuplicateSelectedStyle(
) 447
dreamweaver.cssStylePalette.deleteSelectedStyle() 350
dreamweaver.cssStylePalette.duplicateSelectedStyle()
350
dreamweaver.cssStylePalette.editSelectedStyle() 351
dreamweaver.cssStylePalette.editStyleSheet() 351
dreamweaver.cssStylePalette.getMediaType() 351
dreamweaver.cssStylePalette.getSelectedStyle() 352
dreamweaver.cssStylePalette.getSelectedTarget() 352
dreamweaver.cssStylePalette.getStyles() 353
dreamweaver.cssStylePalette.newStyle() 353
dreamweaver.cssStylePalette.setMediaType() 354
dreamweaver.cssStylePallette.canEditStyleSheet() 448
dreamweaver.dbi.getDataSources() 330
dreamweaver.deleteSelection() 401
dreamweaver.doURLDecoding() 273
dreamweaver.doURLEncoding() 288
dreamweaver.editCommandList() 252
dreamweaver.editFontList() 402
dreamweaver.editLockedRegions() 292
dreamweaver.exportCSS() 259
dreamweaver.exportEditableRegionsAsXML() 260
dreamweaver.exportTemplateDataAsXML() 260
dreamweaver.findNext() 383
dreamweaver.getActiveWindow() 211
dreamweaver.getBehaviorElement() 307
dreamweaver.getBehaviorEvent() 308
dreamweaver.getBehaviorTag() 308
dreamweaver.getBrowserList() 144
dreamweaver.getClipboardText() 318
dreamweaver.getConfigurationPath() 279
dreamweaver.getDocumentDOM() 261
dreamweaver.getDocumentList() 211
dreamweaver.getDocumentPath() 280
dreamweaver.getElementRef() 274
dreamweaver.getExtDataArray() 331
dreamweaver.getExtDataValue() 331
dreamweaver.getExtensionEditorList() 144
dreamweaver.getExternalTextEditor() 145
dreamweaver.getExtGroups() 332
dreamweaver.getExtParticipants() 332
dreamweaver.getFlashPath() 145
dreamweaver.getFloaterVisibility() 212
dreamweaver.getFocus() 213
dreamweaver.getFontList() 402
dreamweaver.getFontStyles() 403
dreamweaver.getHideAllFloaters() 196
dreamweaver.getKeyState() 403
dreamweaver.getLiveDataInitTags() 333
dreamweaver.getLiveDataMode() 334
dreamweaver.getLiveDataParameters () 334
dreamweaver.getMenuNeedsUpdating() 172
dreamweaver.getNaturalSize() 404
dreamweaver.getNewDocumentDOM() 262
dreamweaver.getObjectRefs() 274
dreamweaver.getObjectTags() 275
dreamweaver.getParticipants() 338
dreamweaver.getPreferenceInt() 276
dreamweaver.getPreferenceString() 277
dreamweaver.getPrimaryBrowser() 146
dreamweaver.getPrimaryExtensionEditor() 146
dreamweaver.getPrimaryView() 214
dreamweaver.getRecentFileList() 262
dreamweaver.getRedoText() 156
dreamweaver.getSecondaryBrowser() 147
dreamweaver.getServerModels() 346
dreamweaver.getShowDialogsOnInsert() 151
dreamweaver.getShowStatusBar() 196
dreamweaver.getSiteRoot() 280
dreamweaver.getSnapDistance() 214
dreamweaver.getSystemFontList() 404
dreamweaver.getTempFolderPath() 280
dreamweaver.getTokens() 289
dreamweaver.getTranslatorList() 293
dreamweaver.getUndoText() 156
dreamweaver.historyPalette, objet 155
Index
471
dreamweaver.historyPalette.clearSteps() 159
dreamweaver.historyPalette.copySteps() 159
dreamweaver.historyPalette.getSelectedSteps() 159
dreamweaver.historyPalette.getStepCount() 160
dreamweaver.historyPalette.getStepsAsJavaScript() 160
dreamweaver.historyPalette.getUndoState() 161, 163
dreamweaver.historyPalette.replaySteps() 161
dreamweaver.historyPalette.saveAsCommand() 162
dreamweaver.historyPalette.setSelectedSteps() 162
dreamweaver.htmlInspector.getShowAutoIndent() 196
dreamweaver.htmlInspector.getShowHighlightInvalidH
TML() 197
dreamweaver.htmlInspector.getShowLineNumbers()
197
dreamweaver.htmlInspector.getShowSyntaxColoring()
197
dreamweaver.htmlInspector.getShowWordWrap() 198
dreamweaver.htmlInspector.setShowAutoIndent() 198
dreamweaver.htmlInspector.setShowHighightInvalidH
TML() 198
dreamweaver.htmlInspector.setShowLineNumbers()
199
dreamweaver.htmlInspector.setShowSyntaxColoring()
199
dreamweaver.htmlInspector.setShowWordWrap() 199
dreamweaver.htmlStylePalette, objet 356
dreamweaver.htmlStylePalette.canEditSelection() 449
dreamweaver.importXMLIntoTemplate() 263
dreamweaver.isRecording() 448
dreamweaver.isReporting() 221
dreamweaver.latin1ToNative() 289
dreamweaver.libraryPalette, objet 319
dreamweaver.libraryPalette.deleteSelectedItem() 302
dreamweaver.libraryPalette.getSelectedItem() 302
dreamweaver.libraryPalette.newFromDocument() 302
dreamweaver.libraryPalette.recreateFromDocument()
303
dreamweaver.libraryPalette.renameSelectedItem() 303
dreamweaver.liveDataTranslate() 335
dreamweaver.loadSitesFromPrefs() 222
dreamweaver.mapKeyCodeToChar() 171
dreamweaver.minimizeRestoreAll() 214
dreamweaver.nativeToLatin1() 290
dreamweaver.newDocument() 263
dreamweaver.newFromTemplate() 263
dreamweaver.nodeExists() 286
dreamweaver.notifyMenuUpdated() 172
dreamweaver.objectPalette.getMenuDefault() 164
dreamweaver.objectPalette.setMenuDefault() 164
dreamweaver.openDocument() 264
472
Index
dreamweaver.openDocumentFromSite() 264
dreamweaver.openInFrame() 265
dreamweaver.openWithApp() 149
dreamweaver.openWithBrowseDialog() 149
dreamweaver.openWithExternalTextEditor() 149
dreamweaver.openWithImageEditor() 150
dreamweaver.playRecordedCommand() 157
dreamweaver.popupAction() 309
dreamweaver.popupCommand() 252
dreamweaver.popupEditTagDialog() 424
dreamweaver.popupInsertTagDialog() 424
dreamweaver.popupServerBehavior() 339
dreamweaver.PrintCode() 404
dreamweaver.quitApplication() 152
dreamweaver.redo() 157
dreamweaver.referencePalette.getFontSize() 303
dreamweaver.referencePalette.setFontSize() 304
dreamweaver.refreshExtData() 333
dreamweaver.relativeToAbsoluteURL() 281
dreamweaver.releaseDocument() 265
dreamweaver.reloadCodeColoring 383
dreamweaver.reloadMenus() 173
dreamweaver.reloadObjects() 165
dreamweaver.replace() 384
dreamweaver.replaceAll() 384
dreamweaver.resultsPalette.canClear() 449
dreamweaver.resultsPalette.canCopy() 449
dreamweaver.resultsPalette.canCut() 450
dreamweaver.resultsPalette.canOpenInBrowser() 450
dreamweaver.resultsPalette.canOpenInEditor() 450
dreamweaver.resultsPalette.canPaste() 450
dreamweaver.resultsPalette.canSave() 451
dreamweaver.resultsPalette.canSelectAll() 451
dreamweaver.resultsPalette.clear() 179
dreamweaver.resultsPalette.Copy() 179
dreamweaver.resultsPalette.cut() 179
dreamweaver.resultsPalette.debugWindow.addDebugC
ontextData() 182
dreamweaver.resultsPalette.openInBrowser() 180
dreamweaver.resultsPalette.openInEditor() 181
dreamweaver.resultsPalette.paste() 180
dreamweaver.resultsPalette.save() 181
dreamweaver.resultsPalette.selectAll() 181
dreamweaver.revertDocument() 266
dreamweaver.runCommand() 253
dreamweaver.saveAll() 266
dreamweaver.saveDocument() 267
dreamweaver.saveDocumentAs() 267
dreamweaver.saveDocumentAsTemplate() 268
dreamweaver.saveFrameset() 268
dreamweaver.saveFramesetAs() 269
dreamweaver.saveSitesToPrefs() 222
dreamweaver.scanSourceString() 290
dreamweaver.selectAll() 287
dreamweaver.serverBehaviorInspector.getServerBehavio
rs() 339
dreamweaver.serverComponents.getSelectedNode()
329
dreamweaver.serverComponents.refresh() 329
dreamweaver.setActiveWindow() 215
dreamweaver.setFloaterVisibility() 215
dreamweaver.setHideAllFloaters() 200
dreamweaver.setLiveDataError() 336
dreamweaver.setLiveDataMode() 336
dreamweaver.setLiveDataParameters () 337
dreamweaver.setPreferenceInt() 277
dreamweaver.setPreferenceString() 278
dreamweaver.setPrimaryView() 216
dreamweaver.setShowStatusBar() 200
dreamweaver.setSnapDistance() 217
dreamweaver.setUpComplexFind() 384
dreamweaver.setUpComplexFindReplace() 385
dreamweaver.setUpFind() 386
dreamweaver.setUpFindReplace() 387
dreamweaver.showAboutBox() 152
dreamweaver.showDynamicData() 152
dreamweaver.showFindDialog() 388
dreamweaver.showFindReplaceDialog() 388
dreamweaver.showGridSettingsDialog() 363
dreamweaver.showLiveDataDialog() 337
dreamweaver.showPreferencesDialog() 153
dreamweaver.showProperties() 217
dreamweaver.showQuickTagEditor() 407
dreamweaver.showReportsDialog() 221
dreamweaver.showResults() 173
dreamweaver.showTagChooser() 154, 424
dreamweaver.showTagLibraryEditor() 425
dreamweaver.showTargetBrowsersDialog() 279
dreamweaver.snippetPalette.editSnippet() 326
dreamweaver.snippetPalette.getCurrentSnippetPath()
325
dreamweaver.snippetPalette.insert() 326
dreamweaver.snippetPalette.insertSnippet() 327
dreamweaver.snippetPalette.newFolder() 325
dreamweaver.snippetPalette.newSnippet() 326
dreamweaver.snippetPalette.remove() 327
dreamweaver.snippetPalette.rename() 327
dreamweaver.startRecording() 157
dreamweaver.stopRecording() 158
dreamweaver.stylePalette.attachExternalStylesheet()
350
dreamweaver.tagLibrary.getImportedTagList() 427
dreamweaver.tagLibrary.getSelectedLibrary() 425
dreamweaver.tagLibrary.getSelectedTag() 426
dreamweaver.tagLibrary.getTagLibraryDOM() 425
dreamweaver.tagLibrary.importDTDOrSchema() 426
dreamweaver.templatePalette, objet 319
dreamweaver.templatePalette.deleteSelectedTemplate()
304
dreamweaver.templatePalette.getSelectedTemplate()
304
dreamweaver.templatePalette.renameSelectedTemplate(
) 305
dreamweaver.tileHorizontally() 217
dreamweaver.tileVertically() 218
dreamweaver.toggleFloater() 218
dreamweaver.undo() 158
dreamweaver.updatePages() 324
dreamweaver.updateReference() 219
dreamweaver.useTranslatedSource() 293
dreamweaver.validateFlash() 150
duplicateSelectedStyle() 350
dw.saveSitesToPrefs() 223
DWfile.copy() 34
DWfile.createFolder() 34
DWfile.exists() 35
DWfile.getAttributes() 35
DWfile.getCreationDate() 37
DWfile.getCreationDateObj() 37
DWfile.getModificationDate() 36
DWfile.getModificationDateObj() 38
DWfile.getSize() 38
DWfile.listFolder() 38
DWfile.read() 39
DWfile.remove() 40
DWfile.setAttributes() 40
DWfile.write() 41
E
editAttribute() 390
editColumns() 228
editCommandList() 252
&eacute;diteur de balises, fonctions 423
editFontList() 402
editLockedRegions() 292
editSelectedRule() 348
editSelectedStyle() 351
editSnippet() 326
editStyleSheet() 351
Index
473
&eacute;l&eacute;ments de biblioth&egrave;que et mod&egrave;les, fonctions 319
endOfDocument() 167, 412
endOfLine() 168, 413
endPage() 413
environnement de mise en forme, fonctions 358
errata 30
&eacute;tat, codes 43
execJsInFireworks() 64
exemple getDynamicBindings() 77
exists() 35
exitBlock() 390
exportCSS() 259
exportEditableRegionsAsXML() 260
exportSite() 228
exportTemplateDataAsXML() 260
Extension Data Manager 331
F
fen&ecirc;tre de r&eacute;sultats, fonctions 173
fen&ecirc;tres, fonctions 209
feuilles de style en cascade en balises HTML 251
fichier EDML, fonctions 331
fichiers
d&eacute;finition de type de connexion 109
fragments de code 324
fichiers sur disque
copie 34
cr&eacute;ation (fichiers HTML) 257
cr&eacute;ation (fichiers non-HTML) 41
cr&eacute;ation (fichiers XHTML) 258
cr&eacute;ation (fichiers XML) 259
&eacute;criture 41
lecture 39
suppression 40
fichiers XML, fragments 324
FilePathToLocalURL() 57
findConnection() 105
findLinkSource() 230
findNext() 383
fonctions Live data 333
forceToolbarUpdate() 203
format.Range() 407
formatSelection() 408
fragments de code
description, attribut 325
name, attribut 325
preview, attribut 325
type, attribut 325
Fragments de code, panneau
fonctions 324
474
Index
FTP, connexion 178
FWLaunch.bringDWToFront() 63
FWLaunch.bringFWToFront() 64
FWLaunch.execJsInFireworks() 64
FWLaunch.getJsResponse() 65
FWLaunch.mayLaunchFireworks() 66
FWLaunch.optimizeInFireworks() 66
FWLaunch.validateFireworks() 67
G
get() 230
getActiveWindow() 211
getAppServerAccessType() 231
getAppServerPathToFiles() 231
getAppURLPrefix() 340
getAppURLPrefixForSite() 231
getAttachedTemplate() 320
getAttributes() 35
getAutoValidationCount() 408
getBehavior() 306
getBehaviorAt() 310
getBehaviorCount() 310
getBehaviorElement() 307
getBehaviorEvent() 308
getBehaviorTag() 308
getBrowserList() 144
getCharSet() 390
getCheckOutUser() 232
getCheckOutUserForFile() 232
getClasses() 113
getClassesFromPackage() 117
getClickedHeaderColumn() 366
getClipboardText() 318
getCloakingEnabled() 233
getColdFusionDsnList() 79
getColumnAndTypeList() 91
getColumnList() 92
getColumns() 92
getColumnsOfTable() 93
getConfigurationPath() 279
getConnection() 79
getConnectionList() 80
getConnectionName() 80
getConnectionState() 233
getConnectionString() 81
getCreationDate() 37
getCreationDateObj() 37
getCurrentLines() 413
getCurrentSite() 233
getDataSources() 330
getDelimiters() 340
getDisplayName() 341
getDocumentDOM() 261
getDocumentList() 211
getDocumentPath() 280
getDriverName() 82
getDriverUrlTemplateList() 82
getDynamicBindings() 77
getEditableRegionList() 320
getEditNoFramesContent() 184
getElementRef() 274
getErrorMessage() 117
getEvents() 114
getExtDataArray() 331
getExtDataValue() 331
getExtensionEditorList() 144
getExternalTextEditor() 145
getExtGroups() 332
getExtParticipants() 332
getFile() 45
getFileCallback() 46
getFlashPath() 145
getFloaterVisibility() 212
getFocus() 209, 213, 234
getFolderName() 341
getFontList() 402
getFontMarkup() 391
getFontStyles() 403
getFrameNames() 354
getHideAllFloaters() 196
getHideAllVisualAids() 184
getImportedTagList() 427
getIsLibraryDocument() 321
getIsTemplateDocument() 321
getIsXHTMLDocument() 255
getJsResponse() 65
getKeyState() 403
getLineFromOffset() 391, 414
getLinkHref() 391
getLinkTarget() 392
getLinkVisibility() 234
getListTag() 392
getLiveDataInitTags() 333
getLiveDataMode() 334
getLiveDataParameters () 334
getLocalDsnList() 83
getLocalPathToFiles() 234
getMediaType() 351
getMenuDefault() 164
getMenuNeedsUpdating() 172
getMethods() 115
getModificationDate() 36
getModificationDateObj() 38
getNaturalSize() 404
getNewDocumentDOM() 262
GetNote() 58
GetNoteLength() 58
GetNotesKeyCount() 59
GetNotesKeys() 59
getObjectRefs() 274
getObjectTags() 275
getParseMode() 270
getParticipants() 338
getPassword() 83
getPreferenceInt() 276
getPreferenceString() 277
getPreventLayerOverlaps() 184
getPrimaryBrowser() 146
getPrimaryExtensionEditor() 146
getPrimaryKeys() 94
getPrimaryView() 214
getProcedures() 94
getProperties() 113
getRdsPassword() 84
getRdsUserName() 84
getRecentFileList() 262
getRedoText() 156
getRemoteDsnList() 84
getRulerOrigin() 358
getRulerUnits() 359
getRuntimeConnectionType() 85
getSecondaryBrowser() 147
getSelectedBehavior() 311
getSelectedEditableRegion() 321
getSelectedItem() 302
getSelectedLibrary() 425
getSelectedNode() 282, 329
getSelectedSteps() 159
getSelectedStyle() 352
getSelectedTag() 426
getSelectedTarget() 352
getSelectedTemplate() 304
getSelection() 235, 282, 414
dreamweaver.getSelection() 285
getServerBehaviors() 339
getServerExtension() 342
getServerIncludeUrlPatterns() 342
getServerInfo() 343
getServerLanguage() 344
getServerModels() 346
Index
475
getServerName() 344
getServerSupportsCharset() 345
getServerVersion() 345
getShowAutoIndent() 185
getShowDependents() 200
getShowDialogsOnInsert() 151
getShowFrameBorders() 185
getShowGrid() 185
getShowHeadView() 185
getShowHiddenFiles() 201
getShowImageMaps() 186
getShowInvalidHTML() 186
getShowInvisibleElements() 186
getShowLayerBorders() 187
getShowLayoutTableTabs() 366
getShowLayoutView() 366
getShowLineNumbers() 187
getShowNoscript 408
getShowPageTitles() 201
getShowRulers() 187
getShowStatusBar() 196
getShowSyntaxColoring() 188
getShowTableBorders() 188
getShowTableWidths() 372
getShowToolbar() 188
getShowToolbarIconLabels() 203
getShowToolTips() 201
getShowTracingImage() 189
getShowWordWrap() 189
getSiteForURL() 235
getSiteRoot() 280
GetSiteRootForFile() 60
getSites() 236
getSize() 38
getSnapDistance() 214
getSnapToGrid() 189
getSPColumnList() 96
getSPColumnListNamedParams() 96
getSPParameters() 97
getSPParamsAsString() 98
getStepCount() 160
getStepsAsJavaScript() 160
getStyles() 353
getSystemFontList() 404
getTableExtent() 372
getTables() 99
getTagLibraryDOM() 425
getTagSelectorTag() 423
getTempFolderPath() 280
getText() 414
476
Index
getTextAlignment() 392
getTextCallback() 48
getTextFormat() 393
getTokens() 289
getToolbarIdArray() 204
getToolbarItemValue() 204
getToolbarLabel() 205
getToolbarVisibility() 206
getTracingImageOpacity() 359
getTranslatorList() 293
getUndoState() 161
getUndoText() 156
getUserName() 85
getValidationErrorsForOffset() 415
GetVersionName() 60
GetVersionNum() 60
getView() 209
getViews() 99
getWindowTitle() 210
H
hasCharacterMarkup() 393
hasConnectionWithName() 86
hasTracingImage() 439
hideInfoMessagePopup() 270
historique, fonctions 155
HTML
afficher code incorrect 186
conversion en XHTML 254
cr&eacute;ation d’un nouveau document 257
feuilles de style en cascade 251
insertion 394
inspecteur de styles, objet 356
htmlInspector.getShowAutoIndent() 196
htmlInspector.getShowHighlightInvalidHTML() 197
htmlInspector.getShowLineNumbers() 197
htmlInspector.getShowSyntaxColoring() 197
htmlInspector.getShowWordWrap() 198
htmlInspector.setShowAutoIndent() 198
htmlInspector.setShowHighlightInvalidHTML() 198
htmlInspector.setShowLineNumbers() 199
htmlInspector.setShowSyntaxColoring() 199
htmlInspector.setShowWordWrap() 199
I
importDTDOrSchema() 426
importSite() 236
importXMLIntoTemplate() 263
increaseColspan() 373
increaseRowspan() 373
indent() 393
indentTextView() 415
indicateurs de code
description 379
InfoPrefs 60
insert() 326, 416
insertFlashElement 72
insertFlashElement() 163
insertHTML() 394
insertion d’objets, fonctions 163
insertLibraryItem() 322
insertObject() 394
insertSnippet() 327
insertTableColumns() 373
insertTableRows() 374
insertText() 395
inspectConnection() 107
instructions SQL
acquisition des colonnes 91
affichage des r&eacute;sultats 100
invertSelection() 236
isCloaked() 237
isColumnAutostretch() 367
isDesignViewUpdated() 409
isDocumentInFrame() 355
isRecording() 448
isReporting() 221
isSelectionValid() 409
itemInfo, structure 128
L
latin1ToNative() 289
listFolder() 38
Live data, fonctions 333
liveDataTranslate() 335
loadSitesFromPrefs() 222
loadTracingImage() 359
LocalURLToFilePath() 61
locateInSite() 237
M
makeCellWidthsConsistent() 367
makeEditable() 238
makeNewDreamweaverFile() 238
makeNewFolder() 238
makeSizesEqual() 357
manipulations de fichiers, fonctions 253
mapKeyCodeToChar() 171
markSelectionAsEditable() 322
mayLaunchFireworks() 66
menu Commande, fonctions 252
menus, fonctions 172
mergeTableCells() 374
minimizeRestoreAll() 214
MMDB.deleteConnection() 78
MMDB.getColdFusionDsnList() 79
MMDB.getColumnAndTypeList() 91
MMDB.getColumnList() 92
MMDB.getColumns() 92
MMDB.getColumnsOfTable() 93
MMDB.getConnection() 79
MMDB.getConnectionList() 80
MMDB.getConnectionName() 80
MMDB.getConnectionString() 81
MMDB.getDriverName() 82
MMDB.getDriverUrlTemplateList() 82
MMDB.getLocalDsnList() 83
MMDB.getPassword() 83
MMDB.getProcedures() 94
MMDB.getRdsPassword() 84
MMDB.getRdsUserName() 84
MMDB.getRemoteDsnList() 84
MMDB.getRuntimeConnectionType() 85
MMDB.getSPColumnList() 96
MMDB.getSPColumnListNamedParams() 96
MMDB.getSPParameters() 97
MMDB.getSPParamsAsString() 98
MMDB.getTables() 99
MMDB.getUserName() 85
MMDB.getViews() 99
MMDB.hasConnectionWithName() 86
MMDB.needToPromptForRdsInfo() 86
MMDB.needToRefreshColdFusionDsnList() 87
MMDB.popupConnection() 87
MMDB.setRdsPassword() 88
MMDB.setRdsUserName() 88
MMDB.showColdFusionAdmin() 88
MMDB.showConnectionMgrDialog() 89
MMDB.showOdbcDialog() 89
MMDB.showRdsUserDialog() 89
MMDB.showRestrictDialog() 90
MMDB.showResultset() 100
MMDB.showSPResultset() 101
MMDB.showSPResultsetNamedParams() 102
MMDB.testConnection() 90
MMHttp.clearServerScriptsFolder() 44
MMHttp.clearTemp() 44
MMHttp.getFile() 45
Index
477
MMHttp.getFileCallback() 46
MMHttp.getTextCallback() 48
MMHttp.postText() 48
MMHttp.postTextCallback() 49
MMJB*(), fonctions 113
MMJB.getClasses() 113
MMJB.getClassesFromPackage() 117
MMJB.getErrorMessage() 117
MMJB.getEvents() 114
MMJB.getMethods() 115
MMJB.getProperties() 113
MMNotes, objet 52
MMNotes.close() 52
MMNotes.filePathToLocalURL() 52
MMNotes.get() 53
MMNotes.getKeyCount() 53
MMNotes.getKeys() 53
MMNotes.getSiteRootForFile() 54
MMNotes.getVersionName() 54
MMNotes.getVersionNum() 55
MMNotes.localURLToFilePath() 55
MMNotes.open() 55
MMNotes.remove() 56
MMNotes.set() 56
mode de Mise en forme, fonctions 364
modification des tableaux, fonctions 369
mots de passe, connexion &agrave; une base de donn&eacute;es 83
moveBehaviorDown() 311
moveBehaviorUp() 312
moveSelectionBy() 357
N
name, attribut 325
nativeToLatin1() 290
navigateur cible 178
needToPromptForRdsInfo() 86
needToRefreshColdFusionDsnList() 87
newBlock() 395
newDocument() 263
newEditableRegion() 322
newFromDocument() 302
newFromTemplate() 263
newHomePage() 239
newRule() 349
newSite() 239
newSnippet() 326
newStyle() 353
nextParagraph() 168
nextWord() 169, 416
nodeExists() 286
478
Index
nodeToOffsets() 283
dreamweaver.nodeToOffsets() 286
noms d’utilisateur 85
_notes, dossier 51
notifyFlashObjectChanged() 396
notifyMenuUpdated() 172
O
objets de connexion, propri&eacute;t&eacute;s 106
objets Flash, cr&eacute;ation 73
offsetsToNode() 283
dreamweaver.offsetsToNode() 287
open() 55, 239
openDocument() 264
openDocumentFromSite() 264
openInBrowser() 180
openInEditor() 181
openInFrame() 265
OpenNotesFile() 61
OpenNotesFilewithOpenFlags() 62
openWithApp() 149
openWithBrowseDialog() 149
openWithExternalTextEditor() 149
openWithImageEditor() 150
optimizeInFireworks() 66
outdent() 396
outdentTextView() 417
P
pageDown() 169, 417
pageUp() 169, 417
panneau Actifs, fonctions 295
paste() 180
pilotes JDBC 82
playAllPlugins() 360
playPlugin() 360
playRecordedCommand() 157
popupAction() 309
popupCommand() 252
popupConnection() 87
popupEditTagDialog() 424
popupInsertTagDialog() 424
popupServerBehavior() 339
postText() 48
postTextCallback 49
Presse-papiers, fonctions 314
preview, attribut 325
previousParagraph() 170
previousWord() 170, 418
PrintCode() 404
proc&eacute;dures stock&eacute;es 91
acquisition de param&egrave;tres pour 98
acquisition des colonnes &agrave; partir de 96
affichage des r&eacute;sultats 101, 102
programme de validation 178
propri&eacute;t&eacute; data des objets httpReply 43
put() 240
Q
quitApplication() 152
R
rapports 178
rapports du site 178
rapports, fonctions 221
read() 39
reapplyBehaviors() 306
recherches 178
recreateCache() 240
recreateFromDocument() 303
redo() 155, 157
referencePalette.getFontSize() 303
referencePalette.setFontSize() 304
refresh() 241, 329
refreshExtData() 333
relativeToAbsoluteURL() 281
releaseDocument() 265
reloadCodeColoring 383
reloadMenus() 173
reloadObjects() 165
remoteIsValid() 241
remove() 40, 56, 327
removeAllSpacers() 367
removeAllTableHeights() 375
removeAllTableWidths() 375
removeBehavior() 307
removeCharacterMarkup() 397
removeColumnWidth() 375
removeCSSStyle() 348
removeEditableRegion() 323
removeFontMarkup() 397
removeLink() 241, 397
RemoveNote() 62
removeSpacerFromColumn() 368
rename() 327
renameSelectedItem() 303
renameSelectedTemplate() 305
renameSelection() 242
replace() 384
replaceAll() 384
replaceRange() 418
replaySteps() 161
resizeSelection() 398
resizeSelectionBy() 357
resultsPalette.canClear() 449
resultsPalette.canCopy() 449
resultsPalette.canCut() 450
resultsPalette.canOpenInBrowser() 450
resultsPalette.canOpenInEditor() 450
resultsPalette.canPaste() 450
resultsPalette.canSave() 451
resultsPalette.canSelectAll() 451
resultsPalette.clear() 179
resultsPalette.Copy() 179
resultsPalette.cut() 179
resultsPalette.debugWindow.addDebugContextData()
182
resultsPalette.openInBrowser() 180
resultsPalette.openInEditor() 181
resultsPalette.paste() 180
resultsPalette.save() 181
resultsPalette.selectAll() 181
resWin.addItem() 174
resWin.addResultItem() 175
resWin.setCallbackCommands() 176
resWin.setColumnWidths() 176
resWin.setFileList() 177
resWin.setTitle() 177
resWin.startProcessing() 178
resWin.stopProcessing() 178
revertDocument() 266
runCommand() 253
runTranslator() 292
runValidation() 242, 271
S
save() 181
saveAll() 266
saveAllFrames() 355
saveAsCommand() 162
saveAsImage() 242
saveDocument() 267
saveDocumentAs() 267
saveDocumentAsTemplate() 268
saveFrameset() 268
saveFramesetAs() 269
saveSitesToPrefs() 222
scanSourceString() 290
Index
479
scrollEndFile() 419
scrollLineDown() 419
scrollLineUp() 419
scrollPageDown() 420
scrollPageUp() 420
scrollTopFile() 420
SCS 135
SCS_AfterPut() 139, 140
SCS_BeforeGet() 138
SCS_BeforePut() 139
SCS_canCheckin() 136
SCS_canCheckout() 135
SCS_canConnect() 135
SCS_canDelete() 137
SCS_canGet() 135
SCS_canNewFolder() 137
SCS_canPut() 136
SCS_canRename() 138
SCS_CanUndoCheckout() 137
SCS_Checkin() 129
SCS_Checkout() 129
SCS_Connect() 121
SCS_Delete() 125
SCS_Disconnect() 121
SCS_Get() 124
SCS_GetAgentInfo() 120
SCS_GetCheckoutName() 128
SCS_GetConnectionInfo() 126
SCS_GetDesignNotes() 133
SCS_GetErrorMessage() 131
SCS_GetErrorMessageLength() 131
SCS_GetFileCheckoutList() 131
SCS_GetFolderList() 123
SCS_GetFolderListLength() 122
SCS_GetMaxNoteLength() 132
SCS_GetNewFeatures() 128
SCS_GetNoteCount() 132
SCS_GetNumCheckedOut() 130
SCS_GetNumNewFeatures() 127
SCS_GetRootFolder() 122
SCS_GetRootFolderLength() 122
SCS_IsConnected() 121
SCS_IsRemoteNewer() 134
SCS_ItemExists() 126
SCS_NewFolder() 125
SCS_Put() 124
SCS_Rename() 125
SCS_SetDesignNotes() 133
SCS_SiteDeleted() 127
SCS_SiteRenamed() 127
480
Index
SCS_UndoCheckout() 130
selectAll() 181, 243, 284, 287
selectChild() 405
selectHomePage() 243
s&eacute;lection, fonctions 282
selectNewer() 243
selectParent() 406
selectParentTag() 421
selectTable() 376
serverdebuginfo 182
serveur
d&eacute;bogage 182
fonctions de comportement 338
fonctions de composants 329
set() 56
setActiveWindow() 215
setAsHomePage() 244
setAttributes() 40
setAttributeWithErrorChecking() 398
setCallbackCommands() 176
setCloakingEnabled() 244
setColumnAutostretch() 368
setColumnWidths() 176
setConnectionState() 244
setCurrentLine() 421
setCurrentSite() 245
setEditNoFramesContent() 190
setFileList() 177
setFloaterVisibility() 215
setFocus() 245
setHideAllFloaters() 200
setHideAllVisualAidst() 190
setLayerTag() 358
setLayout() 246
setLinkHref() 398
setLinkTarget() 399
setLinkVisibility() 246
setListBoxKind() 399
setListTag() 400
setLiveDataError() 336
setLiveDataMode() 336
setLiveDataParameters() 337
setMediaType() 354
setMenuDefault() 164
SetNote() 62
setPreferenceInt() 277
setPreferenceString() 278
setPreventLayerOverlaps() 190
setPrimaryView() 216
setRdsPassword() 88
setRdsUserName() 88
setRulerOrigin() 360
setRulerUnits() 361
setSelectedBehavior() 313
setSelectedNode() 284
setSelectedSteps() 162
setSelection() 246, 285, 288
setShowDependents() 202
setShowFrameBorders() 191
setShowGrid() 191
setShowHeadView() 191
setShowHiddenFiles() 202
setShowImageMaps() 192
setShowInvalidHTML() 192
setShowInvisibleElements() 192
setShowLayerBorders() 193
setShowLayoutTableTabs() 369
setShowLayoutView() 369
setShowLineNumbers() 193
setShowNoscript 410
setShowPageTitles() 202
setShowRulers() 193
setShowStatusBar() 200
setShowSyntaxColoring() 194
setShowTableBorders() 194
setShowTableWidths() 376
setShowToolbar() 194
setShowToolbarIconLabels() 207
setShowToolTips() 203
setShowTracingImage() 195
setShowWordWrap() 195
setSnapDistance() 217
setSnapToGrid() 195
setTableCellTag() 376
setTableColumns() 377
setTableRows() 377
setTextAlignment() 400
setTextFieldKind() 400
setTextFormat() 401
setTitle() 177
setToolbarItemAttribute() 206
setToolbarPosition() 207
setToolbarVisibility() 208
setTracingImageOpacity() 362
setTracingImagePosition() 361
setUndoState() 163
setUpComplexFind() 384
setUpComplexFindReplace() 385
setUpFind() 386
setUpFindReplace() 387
setView() 210
showAboutBox() 152
showColdFusionAdmin() 88
showConnectionMgrDialog() 89
showDynamicData() 152
showFindDialog() 388
showFindReplaceDialog() 388
showFontColorDialog() 401
showGridSettingsDialog() 363
showInfoMessagePopup() 272
showInsertTableRowsOrColumnsDialog() 377
showListPropertiesDialog() 399
showLiveDataDialog() 337
showOdbcDialog() 89
showPagePropertiesDialog() 273
showPreferencesDialog() 153
showProperties() 217
showQuickTagEditor() 407
showRdsUserDialog() 89
showReportsDialog() 221
showRestrictDialog() 90
showResults() 173
showResultset() 100
showSPResultset() 101
showSPResultsetNamedParams() 102
showTagChooser() 154, 424
showTagLibraryEditor() 425
showTargetBrowsersDialog() 279
site.addLinkToExistingFile() 223
site.addLinkToNewFile() 223
site.browseDocument() 452
site.canAddLinkToFile() 453
site.canChangeLink() 453
site.canCheckIn() 453
site.canCheckOut() 454
site.canCloak() 454
site.canConnect() 455
site.canEditColumns() 223
site.canFindLinkSource() 455
site.canGet() 455
site.canLocateInSite() 456
site.canMakeEditable() 456
site.canMakeNewFileOrFolder() 456
site.canOpen() 457
site.canPut() 457
site.canRecreateCache() 458
site.canRefresh() 458
site.canRemoveLink() 458
site.canSelectAllCheckedOutFiles() 459
site.canSelectNewer() 459
Index
481
site.canSetLayout() 459
site.canSynchronize() 460
site.canUncloak() 460
site.canUndoCheckOut() 461
site.canViewAsRoot() 461
site.changeLink() 224
site.changeLinkSitewide() 224
site.checkIn() 224
site.checkLinks() 225
site.checkOut() 225
site.checkTargetBrowsers() 226
site.cloak() 226
site.defineSites() 226
site.deleteSelection() 227
site.deployFilesToTestingServerBin() 227
site.editColumns() 228
site.exportSite() 228
site.findLinkSource() 230
site.get() 230
site.getAppServerAccessType() 231
site.getAppServerPathToFiles() 231
site.getAppURLPrefixForSite() 231
site.getCheckOutUser() 232
site.getCheckOutUserForFile() 232
site.getCloakingEnabled() 233
site.getConnectionState() 233
site.getCurrentSite() 233
site.getFocus() 234
site.getLinkVisibility() 234
site.getLocalPathToFiles() 234
site.getSelection() 235
site.getShowDependents() 200
site.getShowHiddenFiles() 201
site.getShowPageTitles() 201
site.getShowToolTips() 201
site.getSiteForURL() 235
site.getSites() 236
site.importSite() 236
site.invertSelection() 236
site.isCloaked() 237
site.locateInSite() 237
site.makeEditable() 238
site.makeNewDreamweaverFile() 238
site.makeNewFolder() 238
site.newHomePage() 239
site.newSite() 239
site.open() 239
site.put() 240
site.recreateCache() 240
site.refresh() 241
482
Index
site.remoteIsValid() 241
site.removeLink() 241
site.renameSelection() 242
site.runValidation() 242
site.saveAsImage() 242
site.selectAll() 243
site.selectHomePage() 243
site.selectNewer() 243
site.setAsHomePage() 244
site.setCloakingEnabled() 244
site.setConnectionState() 244
site.setCurrentSite() 245
site.setFocus() 245
site.setLayout() 246
site.setLinkVisibility() 246
site.setSelection() 246
site.setShowDependents() 202
site.setShowHiddenFiles() 202
site.setShowPageTitles() 202
site.setShowToolTips() 203
site.synchronize() 247
site.uncloak() 247
site.uncloakAll() 248
site.undoCheckOut() 248
site.viewAsRoot() 248
sites, fonctions 222
snapTracingImageToSelection() 362
snippetPalette.getCurrentSnippetPath() 325
snippetPalette.newFolder() 325
source, validation 178
splitFrame() 355
splitTableCell() 378
startOfDocument() 171, 421
startOfLine() 171, 422
startProcessing() 178
startRecording() 157
statusCode, propri&eacute;t&eacute; 43
stopAllPlugins() 362
stopPlugin() 363
stopProcessing() 178
stopRecording() 158
stripTag() 406
styles CSS, fonctions 347
SWFFile.createFile() 73
SWFFile.getNaturalSize() 74
SWFFile.getObjectType() 75
SWFFile.readFile() 75
synchronize() 247
synchronizeDocument() 423
T
tableaux 99
extraction des colonnes 93
tableaux en calques 251
testAppServer() 346
testConnection() 90
tileHorizontally() 217
tileVertically() 218
toggleFloater() 218
topPage() 422
traduction, fonctions 292
traitement des connexions, base de donn&eacute;es 78
type, attribut 325
types de connexion, cr&eacute;ation 103
U
uncloak() 247
uncloakAll() 248
undo() 156, 158
undoCheckOut() 248
updateCurrentPage() 323
updatePages() 324
updateReference() 219
useTranslatedSource() 293
V
validateFireworks() 67
validateFlash() 150
v&eacute;rification de liens 178
viewAsRoot() 248
W
wrapSelection() 422
wrapTag() 406
write() 41
X
XHTML
conversion 254
cr&eacute;ation 258
nettoyage 254
test d’un document 255
Z
zones r&eacute;actives, fonctions 356
Index
483
484
Index
">
こんにちは！私はAIチャットボットで、Adobe Dreamweaver MX 2004 Manuel utilisateurに関するサポートをするために特別にトレーニングされています。すでにドキュメントを徹底的に確認しており、必要な情報を正確に見つけたり、内容をわかりやすく説明したりできます。特定の機能に関するガイダンス、トラブルシューティングの手順、または一般的な使い方について知りたい場合でも、遠慮なく質問してください。問題やニーズについて詳細を教えていただければ、より正確かつ効果的にお手伝いできます！