Retrouvez gratuitement la notice de l'appareil DREAMWEAVER CS4 ADOBE au format PDF.
Téléchargez la notice de votre Éditeur HTML au format PDF gratuitement ! Retrouvez votre notice DREAMWEAVER CS4 - ADOBE et reprennez votre appareil électronique en main. Sur cette page sont publiés tous les documents nécessaires à l'utilisation de votre appareil DREAMWEAVER CS4 de la marque ADOBE.
Systems Incorporated aux Etats-Unis. Java est une marque ou une marque déposée de Sun Microsystems, Inc. aux Etats-Unis et/ou dans d’autres pays. Windows est une marque ou une marque déposée de Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays. Macintosh et Mac OS sont des marques commerciales d'Apple Computer, Inc., déposées aux Etats-Unis et dans d'autres pays. Toutes les autres marques citées sont la propriété de leurs détenteurs respectifs. This work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/3.0/us/ Ce produit inclut des logiciels développés par Apache Software Foundation (http://www.apache.org/). Le format GIF© (Graphics Interchange Format) fait l'objet d'un copyright appartenant CompuServe Incorporated. GIF est une marque de service de CompuServe Incorporated. Technologie de compression audio MPEG Layer-3 utilisée sous licence de Fraunhofer IIS et Thomson Multimedia (http://www.mp3licensing.com). Vous n'êtes pas autorisé à utiliser les données audio MP3 compressées fournies avec le Logiciel pour les diffusions en temps réel ou en direct. Si vous nécessitez un décodeur MP3 pour ce type de diffusion, vous devez acquérir une licence pour cette technologie MP3. Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com) La vidéo dans Flash Player reposent sur la technologie vidéo On2 TrueMotion. © 1992-2005 On2 Technologies, Inc. Tous droits réservés. http://www.on2.com. Ce produit est fourni avec un logiciel développé par le groupe OpenSymphony (http://www.opensymphony.com/) La technologie de compression et de décompression vidéo Sorenson Spark™ est cédée sous licence par Sorenson Media, Inc. The Proximity/Merriam-Webster Inc./Franklin Electronic Publishers Inc. Database © 1990/1994 Merriam-Webster Inc./Franklin Electronic Publishers Inc., © 1994. All Rights Reserved. Proximity Technology Inc. The Proximity/Merriam-Webster Inc./Franklin Electronic Publishers Inc. © 1990 Williams Collins Sons & Co. Ltd. © 1997 - All rights reserved Proximity Technology Inc. © 1990 Williams Collins Sons & Co. Ltd. © 1990 - All rights reserved Proximity Technology Les droits non publiés sont réservés conformément aux lois des Etats-Unis en matière de copyright. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, Etats-Unis d'Amérique. Pour les utilisateurs finals du Gouvernement des Etats-Unis, Adobe s'engage à respecter toutes les lois en vigueur en matière d'égalité, dont, le cas échéant, les dispositions du Executive Order 11246, tel qu'amendé, Section 402 de la loi Vietnam Era Veterans Readjustment Assistance Act de 1974 (38 USC 4212), et la Section 503 de la loi Rehabilitation Act de 1973, telle qu'amendée, ainsi que les dispositions des documents 41 CFR parties 60-1 à 60-60, 60-250 et 60-741. La clause d'action positive et les réglementations figurant dans la phrase qui précède seront incorporées par référence.
L'API des objets dynamiques
Fonctions d'accès à la base de données
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Fonction relative à l'impression
L'API JavaScript vous permet d'exécuter un large éventail de tâches plus réduites. L'utilisateur exécute nombre de ces tâches lorsqu'il crée ou modifie des documents Dreamweaver. Ces fonctions d'API sont regroupées selon les parties de l'interface utilisateur de Dreamweaver auxquelles elles se rapportent. Ainsi, l'API JavaScript comprend les fonctions relatives à l'espace de travail, aux documents, à la conception, etc. Les fonctions de l'API permettent de réaliser quelques-unes des tâches suivantes, et bien plus encore :
• Obtention ou définition d'une taille de police • Recherche de l'occurrence d'une chaîne de recherche dans le code HTML • Activation de la visibilité d'une barre d'outils
Ce manuel suppose une bonne maîtrise de Dreamweaver, HTML, XML, de la programmation JavaScript et, le cas échéant, de la programmation C. Pour rédiger vos propres extensions afin de créer des applications Web, vous devez connaître les langages de script côté serveur et au moins l'une des plates-formes suivantes : Active Server Pages (ASP), ASP.NET, PHP: Hypertext Preprocessor (PHP), Adobe ColdFusion ou Java Server Pages (JSP).
Pour en savoir plus sur la plate-forme Dreamweaver et l'API permettant de développer des extensions de Dreamweaver, voir Extension de Dreamweaver. Le manuel Extension de Dreamweaver décrit les fonctions des API que Dreamweaver appelle pour implémenter les objets, menus, panneaux flottants, comportements de serveur, etc., qui composent les diverses fonctionnalités de Dreamweaver. Ces API permettent d'ajouter des objets, des menus, des panneaux flottants et d'autres fonctions au produit. Extension de Dreamweaver explique également comment personnaliser Dreamweaver en modifiant et en ajoutant des balises à différents fichiers HTML et XML, de façon à ajouter des éléments de menus ou des types de documents, etc.
Pour entrer en contact avec d'autres développeurs d'extensions, rejoignez le forum de discussion consacré à l'extensibilité de Dreamweaver. Vous trouverez ce forum à l'adresse http://www.adobe.com/cfusion/webforums/forum/categories.cfm?forumid=12&catid=190&entercat=y.
Les nouvelles fonctions suivantes ont été ajoutées à l'API JavaScript de Dreamweaver CS4. Les en-têtes désignent les chapitres et les sections qui contiennent les nouvelles fonctions :
Les fonctions suivantes ont été ajoutées au chapitre Documents dynamiques. Fonctions relatives au mode En direct • « dom.getDesignViewMode() » à la page 341
• « dom.getLiveViewUsingServer() » à la page 342 • « dom.setLiveViewUsingServer() » à la page 342 • « dom.getLiveViewDefaultsToUsingServer() » à la page 343 • « dom.getLiveViewDependentsUsingServer() » à la page 343 • « dom.setLiveViewDependentsUsingServer() » à la page 343 • « dom.showLiveViewParamatersDialog() » à la page 344 • « dom.browser.getSelection() » à la page 344 • « dom.browser.getStatusText() » à la page 344 • « dom.browser.getWindow() » à la page 345 • « browserEle.loadHTML() » à la page 345
Les fonctions suivantes ont été ajoutées au chapitre Intégration de Photoshop. API des objets dynamiques • « dreamweaver.assetPalette.canUpdateSmartObjectFromOriginal() » à la page 54
• « dreamweaver.getSmartObjectState() » à la page 55 • « dreamweaver.getSmartObjectOriginalWidth() » à la page 56 • « dreamweaver.getImageWidth() » à la page 56 • « dreamweaver.getImageHeight() » à la page 56
• « dreamweaver.canUpdateSmartObjectFromOriginal() » à la page 57 • « dreamweaver.updateSmartObjectFromOriginal() » à la page 57
Les fonctions suivantes ont été ajoutées au chapitre Espace de travail. Fonctions des fichiers apparentés • « dreamweaver.getRelatedFiles() » à la page 196
• « dreamweaver.getActiveRelatedFilePath() » à la page 197 Fonctions de la barre d'information • « dom.showInfoBar() » à la page 195
Fonctions du mode Fractionnement vertical • « dreamweaver.getSplitViewOrientation() » à la page 197
• « dreamweaver.getPrimaryView() » à la page 198 • « dreamweaver.setPrimaryView() » à la page 199 • « dom.isRelatedFileViewOpen() » à la page 199 Fonctions relatives aux barres d'outils • « dreamweaver.reloadToolbars() » à la page 184
Les fonctions suivantes ont été ajoutées au chapitre Intégration de Flash. Fonctions des panneaux et des boîtes de dialogue de Flash • « dreamweaver.flash.newControl() » à la page 45
• « dreamweaver.flash.controlEvent() » à la page 48 • « dreamweaver.flash.setMenu() » à la page 50 • « dreamweaver.flash.evalScript() » à la page 51 • « dreamweaver.flash.executeScript() » à la page 52 • « dreamweaver.flash.controlExists » à la page 53
• Les accolades ({ }) placées avant et après un argument de fonction indiquent que cet argument est facultatif. • Le nom des fonctions ayant le préfixe dreamweaver.nomfonc peut être abrégé en dw.nomfonc lorsque vous écrivez le code. Ce manuel utilise le préfixe dreamweaver. complet dans les définitions de fonctions et dans l'index. Toutefois, dans de nombreux exemples, le préfixe dw. est utilisé. Conventions de dénomination Ce manuel utilise les conventions de dénomination suivantes :
• L'utilisateur — la personne utilisant Dreamweaver
Sur les plates-formes Microsoft Windows 2000, Windows XP et Mac OS X, les utilisateurs disposent de leur propre copie des fichiers de configuration. Lorsque Dreamweaver écrit dans un fichier de configuration, il le fait dans le dossier Configuration de l'utilisateur. De même, lorsqu'il lit un fichier de configuration, Dreamweaver commence par rechercher ce fichier dans le dossier Configuration de l'utilisateur, puis dans le dossier Configuration de l'application. Les fonctions DWfile procèdent de la même manière. En d'autres termes, si une extension lit ou écrit un fichier dans le dossier Configuration de l'application, elle se reporte aussi au dossier Configuration de l'utilisateur. Pour plus d'informations sur les dossiers Configuration dans un environnement multiutilisateur, voir Extension de Dreamweaver.
Toutes les fonctions de l'API d'E/S des fichiers sont des méthodes associées à l'objet DWfile.
Disponibilité Windows, par exemple, une unité de temps est égale à 100 ns et la base de temps est le 1 janvier 1600. Exemple Comme la valeur renvoyée par cette fonction n'est pas une date et une heure identifiables et qu'elle dépend de la plateforme employée, il est utile d'appeler la fonction deux fois pour comparer les valeurs renvoyées. L'exemple de code suivant renvoie les dates de modification des fichiers file1.txt et file2.txt et affiche un message d'avertissement indiquant le fichier le plus récent : var file1 = "file:///c|/temp/file1.txt"; var file2 = "file:///c|/temp/file2.txt"; var time1 = DWfile.getModificationDate(file1); var time2 = DWfile.getModificationDate(file2); if (time1 == time2){ alert("file1 and file2 were saved at the same time"); }else if (time1 < time2){ alert("file1 older that file2"); }else{ alert("file1 is newer than file2"); Windows, par exemple, une unité de temps est égale à 100 ns et la base de temps est le 1 janvier 1600.
API d'E/S des fichiers
Vous pouvez appeler cette fonction ainsi que la DWfile.getModificationDate() pour un fichier afin de comparer les dates de modification et de création : var file1 = "file:///c|/temp/file1.txt"; var time1 = DWfile.getCreationDate(file1); var time2 = DWfile.getModificationDate(file1); if (time1 == time2){ alert("file1 has not been modified since it was created"); }else if (time1 < time2){ alert("file1 was last modified on " + time2); Tableau de chaînes représentant le contenu du dossier. Exemple Le code suivant obtient une liste de tous les fichiers texte (TXT) du dossier C:/Temp et affiche la liste dans un message d'avertissement. var folderURL = "file:///c|/temp"; var fileMask = "*.txt"; var list = DWfile.listFolder(folderURL + "/" + fileMask, "files"); if (list){ alert(folderURL + " contains: " + list.join("\n")); }
• L'argument mode, s'il est fourni, doit être append. Si cet argument est omis, la chaîne écrase le contenu du fichier. Valeurs renvoyées Valeur booléenne : true si l'écriture de la chaîne dans le fichier a réussi et false dans le cas contraire. Exemple Le code suivant tente d'écrire la chaîne xxx dans le fichier mydata.txt et affiche un message d'avertissement si l'opération d'écriture réussit. Il essaie ensuite d'annexer la chaîne aaa au fichier et affiche un deuxième message d'avertissement si cette opération réussit. Après l'exécution de ce script, le fichier mydata.txt contient uniquement le texte xxxaaa. var fileURL = "file:///c|/temp/mydata.txt"; if (DWfile.write(fileURL, "xxx")){ alert("Wrote xxx to " + fileURL); } if (DWfile.write(fileURL, "aaa", "append")){ alert("Appended aaa to " + fileURL); } Pour spécifier un port différent, ajoutez deux points (:) et le numéro de port à la suite de l'URL, comme dans l'exemple suivant : MMHttp.getText("http://www.myserver.com:8025");
La propriété statusCode indique l'état de l'opération ; les valeurs possibles sont notamment :
• 400 : Demande inintelligible La valeur de la propriété data varie selon la fonction ; les valeurs possibles sont spécifiées dans les listes des fonctions individuelles. Les fonctions qui renvoient un objet ont également une version de rappel (« callback »). Les fonctions de rappel permettent aux autres fonctions de s'exécuter pendant que le serveur Web traite une requête HTTP. Ceci est utile si vous effectuez plusieurs requêtes HTTP à partir de Dreamweaver. La version de rappel d'une fonction transmet directement son ID et sa valeur de renvoi à la fonction spécifiée sous forme de premier argument.
Le code suivant, dans un fichier de commandes de menu du dossier Configuration/Menus, supprime tous les fichiers du dossier _mmServerScripts lorsque celle-ci est appelée depuis un menu : <!-- MENU-LOCATION=NONE --> <html> Si saveURL est en dehors du dossier Configuration/Temp, une valeur de prompt égale à false n'est pas prise en compte pour des raisons de sécurité.
Valeurs renvoyées Un objet représentant la réponse du serveur. La propriété data de cet objet est une chaîne contenant l'emplacement où le fichier a été enregistré, exprimé sous la forme d'une URL de type file://. Normalement, la propriété statusCode de l'objet contient le code d'état envoyé par le serveur. Toutefois, si une erreur de disque se produit lors de l'enregistrement du fichier sur le lecteur local, la propriété statusCode contient un entier représentant l'un des codes d'erreur suivants en cas d'échec de l'opération :
• 8 : Plus d'entrées de dossier
• 10 : Erreur matérielle • 11 : Violation de partage • 12 : Violation de verrouillage • 13 : Disque saturé • L'argument URL est une URL absolue sur un serveur Web ; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP.
Si l'argument saveURL spécifie un emplacement en dehors du dossier Configuration/Temp, une valeur de prompt égale à false n'est pas prise en compte pour des raisons de sécurité.
Un objet représentant la réponse du serveur. La propriété data de cet objet est une chaîne contenant l'emplacement où le fichier a été enregistré, exprimé sous la forme d'une URL de type file://. Normalement, la propriété statusCode de l'objet contient le code d'état envoyé par le serveur. Toutefois, si une erreur disque se produit lors de l'enregistrement du fichier sur le lecteur local, la propriété statusCode contient un nombre entier représentant un code d'erreur. Voir « MMHttp.getFile() » à la page 18 pour une liste des codes d'erreur possibles.
Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé.
Disponibilité Dreamweaver UltraDev 4, amélioré dans Dreamweaver MX. • L'argument URL est une URL absolue sur un serveur Web ; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP.
Configuration du serveur d'application, à partir duquel vous souhaitez extraire les scripts de serveur. Pour extraire les scripts, Dreamweaver utilise le protocole de transfert approprié (par exemple, FTP, WebDAV ou Remote File System). Dreamweaver extrait ces fichiers et les transmet à la fonction identifiée par callbackFunc. Si une erreur se produit, Dreamweaver MX la consigne dans la propriété statusCode de l'objet renvoyé.
• L'argument serverScriptsFolder est une chaîne facultative qui nomme un dossier spécifique, lié au dossier Configuration du serveur d'application, vers lequel vous souhaitez envoyer les données. Pour envoyer les données, Dreamweaver utilise le protocole de transfert approprié (par exemple, FTP, WebDAV ou Remote File System). Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé. Exemple Dans l'exemple suivant d'appel de la fonction MMHttp.postText(), supposons qu'un développeur a placé le fichier myScripts.cfm dans un dossier nommé DeployScripts, qui se trouve dans le dossier Configuration sur l'ordinateur local : MMHttp.postText( "http://ultraqa8/DeployScripts/myScripts.cfm", dossier nommé DeployScripts, qui constitue un sous-dossier du dossier racine du site Web ultraqa8. Pour déployer les fichiers, Dreamweaver utilise le protocole spécifié dans les propriétés de configuration du site. 2 Dreamweaver utilise le protocole HTTP pour envoyer les données arg1=Foo vers le serveur Web. 3 En réponse à la requête d'envoi, le serveur Web sur ultraqa8 exécute le script myScripts.cfm à l'aide des données arg1.
• L'argument URL est une URL absolue sur un serveur Web ; si http:// n'est pas indiqué dans l'URL, Dreamweaver considère qu'il s'agit du protocole HTTP.
Configuration du serveur d'application sur lequel vous voulez envoyer les données. Pour envoyer les données, Dreamweaver utilise le protocole de transfert approprié (par exemple, FTP, WebDAV ou Remote File System). Dreamweaver extrait ces données et les transmet à la fonction identifiée par callbackFunc. Si une erreur se produit, Dreamweaver la consigne dans la propriété statusCode de l'objet renvoyé.
Utilisation de Dreamweaver.
Chaque fichier Design Notes stocke des informations relatives à un seul document. Si un fichier Design Notes est associé à un ou plusieurs documents dans un dossier, Dreamweaver crée un sous-dossier _notes pour y stocker les fichiers Design Notes. Le dossier _notes et les fichiers Design Notes qu'il contient ne sont pas visibles dans la fenêtre Site, mais ils s'affichent dans le Finder Macintosh ou dans l'Explorateur Windows. Un nom de fichier Design Notes est composé du nom du fichier principal suivi de l'extension .mno. Par exemple, le fichier Design Notes associé à avocado8.gif est avocado8.gif.mno. Les fichiers Design Notes sont des fichiers XML stockant des informations sous la forme d'une série de paires clé/valeur. La clé décrit le type des informations stockées et la valeur représente les informations. Les clés sont limitées à 64 caractères. L'exemple suivant illustre le fichier Design Notes associé au fichier foghorn.gif.mno : <?xml version="1.0" encoding="iso-8859-1" ?> <info> <infoitem key="FW_source" value="file:///C|sites/dreamcentral/images/sourceFiles/¬ foghorn.png" /> être utilisée indépendamment de Dreamweaver, que celui-ci soit installé ou non.
Description Dreamweaver écrive dans le fichier. Arguments fileHandle
Valeurs renvoyées Un appel à la fonction MMNotes.filePathToLocalURL('C:/sites/webdev/index.htm') renvoie "file:///c|sites/webdev/index.htm".
Une chaîne contenant la valeur de la clé. Exemple Voir « MMNotes.getKeys() » à la page 25.
"Dreamweaver" étant donné que Fireworks utilise la même version de la bibliothèque (celle qui a été créée par l'équipe technique de Dreamweaver).
Description Cette fonction obtient le numéro de version de la bibliothèque partagée MMNotes. Un appel à la fonction MMNotes.localURLToFilePath('file:///MacintoshHD/images/moon.gif') renvoie "MacintoshHD:images:moon.gif".
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. • L'argument keyName est une chaîne contenant le nom de la clé. • L'argument valueString est une chaîne contenant la valeur. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. Exemple L'exemple suivant ouvre le fichier Design Notes associé à un fichier situé sur le site dreamcentral appelé peakhike99/index.html, ajoute une nouvelle paire clé/valeur, modifie la valeur d'une clé existante, puis ferme le fichier • L'argument localURLBuf est la zone de mémoire tampon où l'URL de type file:// est stockée. • L'argument localURLMaxLen est la taille maximale de localURLBuf. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument localURLBuf reçoit la valeur de l'URL de type file://.
• L'argument valueBuf est la zone de mémoire tampon où la valeur est stockée. • L'argument valueBufLength est le nombre entier renvoyé par GetNoteLength(noteHandle, keyName), indiquant la longueur maximale de la mémoire tampon des valeurs. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument valueBuf reçoit la valeur de la clé. Exemple Le code suivant obtient la valeur de la clé comments dans le fichier Design Notes associé au fichier welcome.html :
GetNote(noteHandle, "comments", valueBuffer, valueLength + 1); printf("Comments: %s",valueBuffer); Un nombre entier représentant la longueur de la valeur. Exemple Voir « BOOL GetNote() » à la page 29.
• L'argument keyArrayMaxLen est le nombre entier renvoyé par GetNotesKeyCount(noteHandle), indiquant le nombre maximum d'éléments contenus dans le tableau en mémoire tampon des clés. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument keyBufArray reçoit les noms de clé. Exemple Le code suivant imprime les noms de clé et les valeurs de toutes les clés du fichier Design Notes associé au fichier welcome.html : typedef char[64] InfoKey; FileHandle noteHandle = OpenNotesFile("file:///c|/sites/avocado8/iwjs/welcome.html"); if (noteHandle > 0){ int keyCount = GetNotesKeyCount(noteHandle); if (keyCount <= 0) return; InfoKey* keys = new InfoKey[keyCount]; • L'argument siteRootBuf est la zone de mémoire tampon où la racine du site est stockée. • L'argument siteRootBufMaxLen est la taille maximale de la mémoire tampon référencée par siteRootBuf. • L'argument facultatif infoPrefs est une référence à un struct dans lequel les préférences du site sont stockées. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument siteRootBuf reçoit l'adresse de la mémoire tampon qui stocke la racine du site. Si vous spécifiez l'argument infoPrefs, la fonction renvoie également les préférences de Design Notes pour le site. La structure InfoPrefs possède deux variables : bUseDesignNotes et bUploadDesignNotes, toutes deux de type BOOL.
Description Cette fonction renvoie le nom de version de la bibliothèque partagée MMNotes indiquant l'application qui l'a implémentée. • L'argument versionNameBufMaxLen est la taille maximale de la mémoire tampon référencée par versionNameBuf. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. Dreamweaver stocke "Dreamweaver" dans l'argument versionNameBuf.
• L'argument versionNumBufMaxLen est la taille maximale de la mémoire tampon référencée par versionNumBuf. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument versionNumBuf stocke le numéro de version.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 33 API de Design Notes
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. L'argument drivePathBuf reçoit le chemin de fichier local. • L'argument facultatif bReadOnly est une valeur booléenne indiquant si le fichier doit être ouvert en mode lecture seule. La valeur par défaut est false. Vous pouvez spécifier l'argument bReadOnly disponible à partir de la version 2 du fichier MMNotes.dll.
Description Cette fonction supprime la clé spécifiée (et sa valeur) du fichier Design Notes indiqué. RÉFÉRENCE DES API DE DREAMWEAVER CS4 34 API de Design Notes
Valeur booléenne : true si l'opération a réussi, false dans le cas contraire. • L'argument value est une chaîne contenant la valeur. Valeurs renvoyées Valeur booléenne : true si l'opération a réussi, false dans le cas contraire.
CS4 et pour plus de détails sur les extensions C, voir Extension de Dreamweaver.
L'objet FWLaunch permet aux extensions d'ouvrir Fireworks, d'exécuter des opérations Fireworks à l'aide de l'API JavaScript de Fireworks et de renvoyer les valeurs à Dreamweaver. Ce chapitre décrit l'API de communication FWLaunch et son utilisation.
Disponibilité Dreamweaver 3, Fireworks 3. • Erreur lors du démarrage de Fireworks, ce qui indique que la fonction n'ouvre pas une version valide de Fireworks (version 3 ou ultérieure).
(version 3 ou ultérieure).
• L'argument targetHeight (facultatif) définit la hauteur par rapport à laquelle l'image doit être redimensionnée. Valeurs renvoyées Zéro (0) si une session d'optimisation de Fireworks a été lancée avec succès pour l'image spécifiée; sinon, un code d'erreur non nul indiquant que l'une des erreurs suivantes s'est produite :
• Erreur lors du démarrage de Fireworks, ce qui indique que la fonction n'ouvre pas une version valide de Fireworks (version 2 ou ultérieure).
{versionNumber} Pour plus d'informations sur l'ajout de contenu Flash à des objets ou des commandes Dreamweaver, voir Extension de Dreamweaver.
L'API des objets Flash permet aux développeurs d'extensions de construire des objets pour créer des fichiers SWF simples via Flash Generator. Cette API fournit un moyen de définir des paramètres dans un modèle Flash Generator pour réaliser un fichier SWF ou d'image. Elle permet de créer de nouveaux objets Flash mais aussi de lire et de manipuler des objets Flash existants. Le fichier de modèle Flash Generator SWT contient toutes les informations indispensables à la construction d'un fichier d'objet Flash. Ces fonctions d'API permettent de créer un fichier SWF (ou un fichier d'image) à partir d'un fichier SWT. Le fichier SWF est créé en remplaçant les paramètres du fichier SWT par des valeurs réelles. Pour plus d'informations sur Flash, consultez le manuel correspondant. Les fonctions suivantes sont des méthodes de l'objet SWFFile.
Etend le contenu de l'image de sortie pour qu'il s'adapte exactement à la taille de sortie indiquée.
• L'argument controlID est une valeur de chaîne. • L'argument controlType spécifie si le panneau est une extension standard ("standard"), une extension standard approuvée ("trusted") ou une extension plus (toute autre valeur). S'il s'agit d'une extension plus, la valeur est un identificateur connu spécifiquement de l'application hôte et qui indique le type d'intégration personnalisée requise. Si l'application ne comprend pas le type d'intégration personnalisée, elle renvoie une erreur.
JavaScript de Dreamweaver à partir du fichier .swf au moyen d'une interface externe, vous pouvez fournir un fichier .js contenant des fonctions que vous pourrez ensuite appeler depuis le fichier .swf. Pour plus d'informations, voir l'appel dw.flash.executeScript.
laquelle le panneau peut être réduit. Cette option est facultative. Si la valeur minSize n'est pas précisée, elle utilise par défaut la largeur et la hauteur définies dans defaultGeometry. Il est dès lors impossible de redimensionner le panneau. { width: Number, height: Number }
{ width: Number, height: Number }
• L'argument inXMLString est une chaîne. Transmettez le inXMLString suivant pour appeler la fonction dans le fichier Flash flashCallback et transmettez une chaîne unique, 'Hello', en tant qu'argument. <invoke name="flashCallback" returntype="xml"> <arguments> <string>Hello</string> L'exemple suivant est la mise en oeuvre de la fonction flashcallback implémentée dans flashcallback.mxml. Dans l'exemple suivant, ajoutez la fonction flashcallback. Cette fonction doit être appelée à partir d'applications externes. public function initApp():void { ExternalInterface.addCallback("flashCallback",flashCallback); }
• Si cette chaîne concerne un panneau, toute la zone définissable par l'utilisateur du menu de survol est remplacée. L'application réserve certains éléments de survol fixes.
• Si cette chaîne est une chaîne XML dans un schéma restant à déterminer pour la définition de sections de menus, ce formulaire est fourni pour une compatibilité future.
• Le code PlugPlugErrorCode_unknown indique que la fonction a échoué pour une raison inconnue. Exemple L'exemple suivant sert à configurer le menu :
Intégration de Flash
{ var menuItem = {}; menuItem.menuId = menuID; //!< unique menu ID, if NULL menu is disabled menuItem.nameUtf8 = menuName; //!< Item title, if "---" item is a separator menuItem.extensionId = extensionID; //!< optional extension ID, used for panels only menuItem.submenu = submenu; //!< if non-NULL, this is a submenu return menuItem; L'exemple suivant spécifie la définition du gestionnaire de rappel dans « Configuration/flash/Flickr.js » : function onSelectMenuItem(menuID) { if (menuID == 'id1') { var flashCallbackString = '<invoke name= " flash Callback" returntype="xml"> <arguments><string>Hello</string></arguments></invoke>'; dw.flash.control Event('Flickr', flashCallbackString); return("PlugPlugRequestCompleted"); } else { alert ( ' You selected: menuID = ' + menuID); return ( " PlugPlugRequestCompleted"); • Le fichier .js défini dans le paramètre scriptPath pour les extensions non basées sur CSXS.
Intégration de Flash
Intégration de Flash
{ alert('hello ' + nameStr); var appLanguage = dw.getAppLanguage(); var returnStr = '<object><property id="strResult"><string>Language: ' + appLanguage Les fonctions des objets dynamiques traitent des opérations relatives à l'intégration de Dreamweaver et de Photoshop. Ces fonctions permettent d'effectuer les opérations suivantes :
• Récupération de la hauteur et de la largeur d'une image
Disponibilité Les fonctions de l'API de base de données sont utilisées au moment de la conception, lorsque les utilisateurs développent leurs applications Web, et non au moment de l'exécution, c'est-à-dire lorsque l'application Web est déployée. Il est possible d'utiliser ces fonctions dans n'importe quelle extension. En fait, les API de comportement de serveur, de format des données et de source de données de Adobe® Dreamweaver® CS4 utilisent toutes ces fonctions de base de données.
L'exemple suivant illustre la façon dont la fonction de comportement de serveur, getDynamicBindings(), est définie pour Recordset.js. Cet exemple utilise la fonction MMDB.getColumnAndTypeList() : function getDynamicBindings(ss) { var serverModel = dw.getDocumentDOM().serverModel.getServerName(); var bindingsAndTypeArray = new Array(); var connName=ss.connectionName; var statement = ss.source; var rsName= ss.rsName; // remove SQL comments statement = statement.replace(/\/\*[\S\s]*?\*\//g, " "); var bIsSimple = ParseSimpleSQL(statement); statement = stripCFIFSimple(statement); if (bIsSimple) { statement = RemoveWhereClause(statement,false); } else { var pa = new Array(); if (ss.ParamArray != null) { for (var i = 0; i < ss.ParamArray.length; i++) { pa[i] = new Array(); pa[i][0] = ss.ParamArray[i].name; pa[i][1] = ss.ParamArray[i].value; Fonctions de connexion à une base de données Les fonctions de connexion à une base de données vous permettent d'établir et de gérer toutes les connexions, y compris les connexions ADO de Dreamweaver, ColdFusion et JDBC. Ces fonctions interagissent avec le Gestionnaire de connexions uniquement ; elles n'accèdent pas aux bases de données. Pour les fonctions qui accèdent aux bases de données, voir « Fonctions d'accès à la base de données » à la page 71. Dans le cadre de la gestion des connexions de bases de données, vous pouvez obtenir le nom d'utilisateur et le mot de passe afin d'accomplir des activités telles que :
• Ouverture d'une boîte de dialogue de connexion à une base de données
Disponibilité • L'argument facultatif driverName définit l'argument connString de manière plus précise. Valeurs renvoyées Chaîne de nom de connexion correspondant à la chaîne de connexion. Exemple Le code suivant renvoie la chaîne "EmpDB" : var connectionName = MMDB.getConnectionName ¬ ("dsn=EmpDB;uid=;pwd=");
API de base de données
Extrait les DSN ODBC du serveur de site. Les fonctions getRDSUserName() et getRDSPassword() sont utilisées lorsque le modèle de serveur du site en cours est ColdFusion. Cette fonction offre aux développeurs la possibilité de spécifier une chaîne de paramètre URL à annexer à l'URL Remote Connectivity générée par MMDB.getRemoteDsnList(). Si le développeur fournit une chaîne de paramètre, cette fonction la transmet aux scripts de connectivité HTTP. Arguments {urlParams}
API de base de données
• Si la liste d'arguments ne comporte que connRec (une référence de connexion), popupConnection() provoque le lancement de la boîte de dialogue de connexion en mode d'édition dans Dreamweaver, pour que vous puissiez y modifier la connexion nommée. Dans ce mode, la zone de texte du nom s'affiche en grisé.
Arguments dialogFileName ou connRec ou connrec, bDuplicate
Configuration/Connections/server-model. Ce fichier HTML définit la boîte de dialogue qui crée une connexion. Ce fichier doit déployer trois fonctions d'API JavaScript : findConnection(), inspectConnection() et applyConnection(). En général, vous créez un fichier JavaScript qui implémente ces fonctions, puis vous intégrez ce fichier au fichier HTML. Pour plus d'informations sur la création d'une connexion, voir « API de connectivité à une base de données » à la page 83.
• bDuplicate est une valeur booléenne. Valeurs renvoyées Aucune. La boîte de dialogue de connexion définie s'ouvre.
API de base de données
Disponibilité • password est le mot de passe initial. Valeurs renvoyées Objet contenant les nouvelles valeurs dans les propriétés username et password. Si l'une des propriétés n'est pas définie, ceci indique que l'utilisateur a annulé la boîte de dialogue.
API de base de données
Disponibilité • L'argument schema est la valeur de schéma initiale. Valeurs renvoyées Objet contenant les nouvelles valeurs dans les propriétés catalog et schema. Si l'une des propriétés n'est pas définie, ceci indique que l'utilisateur a annulé la boîte de dialogue.
• type indique, lorsque useHTTP est une valeur false, quelle DLL utiliser pour se connecter à une base de données au moment de la conception, pour tester les paramètres de connexion.
• dsn est le nom de la source de données. • driver est le pilote JDBC. • username est le nom d'utilisateur. • L'argument password est le mot de passe. • L'argument useHTTP est une valeur booléenne. Une valeur true spécifie que Dreamweaver doit utiliser une connexion HTTP au moment de la conception ; dans le cas contraire, Dreamweaver utilise une DLL. Valeurs renvoyées Valeur booléenne, true si le test de connexion est réussi, false dans le cas contraire.
API de base de données
Les fonctions d'accès à la base de données vous permettent de faire une recherche dans la base de données. L'accès aux informations de base de données permet par exemple d'extraire les métadonnées qui décrivent le schéma ou la structure d'une base de données. Ces métadonnées incluent des informations telles que les noms des tables, des colonnes, des procédures stockées et des affichages. Vous pouvez également afficher les résultats de l'exécution d'une requête de base de données ou d'une procédure stockée. Lorsque vous accédez à une base de données par le biais de cette API, vous utilisez des instructions SQL (Structured Query Language). Pour l'ensemble des fonctions qui gèrent une connexion à une base de données, voir « Fonctions de connexion à une base de données » à la page 59. La liste suivante décrit certains des arguments communs à toutes les fonctions disponibles :
MMDB.getConnectionList(). Cette dernière vous permet d'obtenir par programmation une liste de tous les noms de connexion.
MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée. Si vous fournissez des noms de paramètres, les valeurs spécifiées dans paramValuesArray doivent être dans l'ordre dans lequel les noms ont été spécifiés dans paramNameArray.
Disponibilité Un tableau de chaînes qui représente une liste de colonnes (et leur type) qui correspondent à la déclaration SELECT, ou bien une erreur si la déclaration SQL n'est pas valide ou si la connexion n'a pas pu s'établir.
API de base de données
Le code var columnArray = MMDB.getColumnAndTypeList("EmpDB","Select * from Employees") renvoie le tableau de chaînes suivant : columnArray[0] columnArray[1] columnArray[2] columnArray[3] columnArray[4] columnArray[5]
Exemple Le code var columnArray = MMDB.getColumnList("EmpDB","Select * from Employees") renvoie le tableau de chaînes suivant : columnArray[0] = "EmpName" columnArray[1] = "EmpFirstName" columnArray[2] = "Age"
API de base de données
Dreamweaver doit utiliser pour établir une connexion de base de données à une source de données active.
Valeurs renvoyées Un tableau d'objets, à raison d'un objet par colonne. Chaque objet définit les trois propriétés suivantes pour la colonne à laquelle il est associé. Nom de propriété
API de base de données
Un tableau de chaînes dont chaque chaîne est le nom d'une colonne de la table. Exemple L'instruction MMDB.getColumnsOfTable ("EmpDB","Employees"); renvoie les chaînes suivantes : ["EmpID", "FirstName", "LastName"]
Exemple L'exemple suivant renvoie la clé primaire de la table spécifiée. var connName var tableName var primaryKeys
API de base de données
Un tableau d'objets de procédure dans lequel chaque objet de procédure a les trois propriétés suivantes : Nom de propriété
Dreamweaver sur certains systèmes peut prendre beaucoup de temps. Si votre base de données contient un schéma ou un catalogue, vous pouvez l'utiliser pour limiter le nombre d'éléments de base de données que Dreamweaver récupère au moment de la conception. Pour commencer, créez un schéma ou un catalogue dans votre application de base de données de façon à pouvoir ensuite l'appliquer dans Dreamweaver. Consultez la documentation de votre système de base de données ou consultez votre administrateur système. Exemple Le code suivant extrait une liste de procédures : var procObjects = MMDB.getProcedures(connectionName); for (i = 0; i < procObjects.length; i++) { var thisProcedure = procObjects[i] thisSchema =Trim(thisProcedure.schema) if (thisSchema.length == 0) { thisSchema = Trim(thisProcedure.catalog) • L'argument paramValuesArray est un tableau contenant une liste de valeurs tests de paramètre au moment de la conception. Spécifiez les valeurs de paramètre dans l'ordre attendu par la procédure stockée. Vous pouvez utiliser la fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée. Valeurs renvoyées Tableau de chaînes représentant la liste des colonnes. Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte. Exemple Le code suivant peut renvoyer une liste de colonnes de jeux de résultats générées à partir de la procédure stockée exécutée, getNewEmployeesMakingAtLeast : var paramValueArray = new Array("2/1/2000", "50000") var columnArray = MMDB.getSPColumnList("EmpDB", ¬ "getNewEmployeesMakingAtLeast", paramValueArray) The following values return: columnArray[0] = "EmpID", columnArray[1] = "LastName", ¬ columnArray[2] ="startDate", columnArray[3] = "salary" RÉFÉRENCE DES API DE DREAMWEAVER CS4 77 API de base de données
Valeurs renvoyées Tableau de chaînes représentant la liste des colonnes. Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte. Exemple Le code suivant peut renvoyer une liste de colonnes de jeux de résultats générées à partir de la procédure stockée exécutée, getNewEmployeesMakingAtLeast : var paramNameArray = new Array("startDate", "salary") var paramValueArray = new Array("2/1/2000", "50000") var columnArray = MMDB.getSPColumnListNamedParams("EmpDB", ¬ "getNewEmployeesMakingAtLeast", paramNameArray, paramValueArray)
API de base de données
2 : Le paramètre est utilisé uniquement pour la sortie. Dans ce cas, vous
Vous pouvez utiliser la valeur une fois la méthode renvoyée. 3 : Le paramètre est utilisé pour l'entrée et la sortie. 4 : Le paramètre contient une valeur de retour.
L'exemple suivant extrait les objets de paramètre pour la procédure spécifiée et crée une infobulle pour chaque objet qui utilise ses propriétés. var paramNameObjs = MMDB.getSPParameters(connName,procName); for (i = 0; i < paramNameObjs.length; i++) { var paramObj = paramNameObjs[i]; var tooltiptext = paramObj.datatype; tooltiptext+=" "; tooltiptext+=GetDirString(paramObj.directiontype); Chaîne délimitée par virgules contenant la liste des paramètres requis par la procédure stockée. Les noms, la direction et le type de données des paramètres sont inclus, séparés par des points-virgules (;). Exemple Le code MMDB.getSPParamsAsString ("EmpDB","getNewEmployeesMakingAtLeast") peut renvoyer une chaîne de nom de formulaire startDate;direction:in;datatype:date, salary;direction:in;datatype:integer.
API de base de données
Pour startDate, la direction est in et le type de données est date. Pour salary, la direction est in et le type de données est date.
Disponibilité Dreamweaver UltraDev 1. L'instruction MMDB.getTables ("EmpDB"); pourrait produire un tableau de deux objets. Les propriétés du premier objet peuvent ressembler à l'exemple suivant : object1[table:"Employees", schema:"personnel", catalog:"syscat"]
API de base de données
Tableau d'objets de mode possédant chacun trois propriétés : catalog, schema et view. Catalog ou schema permet de restreindre/filtrer le nombre de modes d'affichage rattachés à un nom de schéma individuel ou à un nom de catalogue défini comme faisant partie des informations de connexion. Exemple • L'argument paramValuesArray est un tableau contenant une liste de valeurs tests de paramètre au moment de la conception. Spécifiez les valeurs de paramètre dans l'ordre attendu par la procédure stockée. Vous pouvez utiliser la fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée. Valeurs renvoyées Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte, sinon, elle ne renvoie rien. Exemple Le code suivant affiche le résultat de la procédure stockée exécutée : var paramValueArray = new Array("2/1/2000", "50000") MMDB.showSPResultset("EmpDB", "getNewEmployeesMakingAtLeast", ¬ paramValueArray)
API de base de données
• L'argument paramNameArray est un tableau contenant une liste de noms de paramètres. Vous pouvez utiliser la fonction MMDB.getSPParamsAsString() pour obtenir les paramètres de la procédure stockée.
Valeurs renvoyées Cette fonction renvoie une erreur lorsque l'instruction SQL ou la chaîne de connexion est incorrecte, sinon, elle ne renvoie rien. Exemple Le code suivant affiche le résultat de la procédure stockée exécutée : var paramNameArray = new Array("startDate", "salary") var paramValueArray = new Array("2/1/2000", "50000") MMDB.showSPResultsetNamedParams("EmpDB","getNewEmployees¬ MakingAtLeast", paramNameArray, paramValueArray) L'utilisateur peut sélectionner votre nouveau type de connexion de plusieurs manières :
Dans la boîte de dialogue Jeu d'enregistrements, il peut agrandir la fenêtre de la liste Connexion.
Les étapes suivantes expliquent le processus de création d'un nouveau type de connexion : 1 Définissez la mise en forme de la boîte de dialogue de connexion.
Assurez-vous que ce fichier HTML contient bien une référence au fichier de mise en œuvre JavaScript défini à l'étape 2, Créez un fichier JavaScript mettant en œuvre au moins les éléments suivants, comme le montre l'exemple suivant : <head> <script SRC="../myConnectionImpl.js"></script> </head> Par exemple, la boîte de dialogue de connexion ADO par défaut pour un document ASP JavaScript sur une plateforme Windows est stockée dans le dossier ASP_Js/Win et est intitulée Connection_ado_conn_string.htm. Remarque : Pendant l'exécution, Dreamweaver établit de manière dynamique la liste des types de connexion disponibles dans l'ensemble des boîtes de dialogue présentes dans le dossier ASP_Js/Win. Le dossier Configuration/ServerModels contient des fichiers HTML qui définissent chaque modèle de serveur. Chaque fichier HTML contient la fonction getServerModelFolderName() qui renvoie le nom du dossier associé au modèle de serveur. L'exemple suivant indique la fonction pour le type de document ASP JavaScript :
API de connectivité à une base de données
{ return "ASP_JS"; } 2 Créez un fichier JavaScript qui implémente au moins les éléments suivants : Elément
Type de connexion, nom de la source de données, etc.
Remarque : Le fichier HTML défini à l'étape 1, Définissez la mise en forme de la boîte de dialogue de connexion, doit contenir ce fichier de mise en œuvre du type de connexion. Ces deux étapes constituent les conditions minimales pour créer une nouvelle boîte de dialogue de connexion, sauf si vous avez besoin de définir des paramètres de connexion autres que ceux fournis dans le fichier standard connection_includefile.edml. Remarque : Le titre de la boîte de dialogue que voit l'utilisateur se trouve dans la balise title, spécifiée dans le document HTML. Les fonctions répertoriées dans la section suivante permettent de créer une boîte de dialogue de connexion. En plus d'implémenter les appels pour la génération des fichiers inclus réservés à l'utilisateur, vous pouvez enregistrer votre type de connectivité dans la section du modèle de serveur du fichier XML de connexion. Pour plus d'informations sur l'API de connectivité à une base de données, associée à la création d'une nouvelle connexion, voir « Fonctions de connexion à une base de données » à la page 59.
Pour créer un nouveau type de connexion, y compris la boîte de dialogue avec laquelle les utilisateurs interagissent, vous devez implémenter les trois fonctions suivantes : findConnection(), inspectConnection() et applyConnection(). Vous devez rédiger ces trois fonctions et les inclure dans le fichier de mise en œuvre JavaScript associé à votre nouveau type de connexion (voir Etape 2, Créez un fichier JavaScript qui implémente au moins les éléments suivants :).
API de connectivité à une base de données
HTML et en extrait les propriétés. Vous pouvez mettre en œuvre findConnection() pour utiliser les modèles de recherche dans les fichiers XML afin d'extraire les informations renvoyées à partir de applyConnection(). Si vous souhaitez voir un exemple de ce type de mise en œuvre, étudiez les deux fichiers JavaScript suivants :
• Le fichier connection_common.js se trouve dans le dossier Configuration/Connections/Shared. Lorsque l'utilisateur ouvre un site, Dreamweaver parcourt tous les fichiers dans le dossier Connections, les ouvre et transmet leur contenu à la fonction findConnection(). Si le contenu d'un fichier correspond aux critères d'une connexion valide, findConnection() renvoie un objet de connexion. Dreamweaver répertorie ensuite tous les objets de connexion dans le panneau Explorateur de base de données. Lorsque l'utilisateur ouvre une boîte de dialogue de connexion et choisit de créer une nouvelle connexion ou de dupliquer ou encore de modifier une connexion existante, Dreamweaver déclenche la fonction inspectConnection() et retransmet le même objet de connexion créé par findConnection(). Ce processus permet à Dreamweaver de renseigner la boîte de dialogue en utilisant les informations de connexion. Lorsque l'utilisateur clique sur OK dans une boîte de dialogue de connexion, Dreamweaver déclenche la fonction applyConnection() pour construire la page HTML, placée dans le fichier inclus de connexion résidant dans le
Lorsque l'utilisateur ajoute à une page un comportement de serveur qui utilise la connexion, tel qu'un jeu d'enregistrements ou une procédure stockée, Dreamweaver ajoute une instruction à la page qui comprend le fichier inclus de connexion.
Disponibilité API de connectivité à une base de données
Remarque : Les développeurs peuvent ajouter des propriétés personnalisées (par exemple, métadonnées) à la source HTML, qui renvoie applyConnection() avec les propriétés standard.
Disponibilité Dreamweaver appelle cette fonction pour initialiser les données de la boîte de dialogue pour définir une connexion lorsque l'utilisateur modifie une connexion existante. Ce processus permet à Dreamweaver de renseigner la boîte de dialogue en utilisant les informations de connexion appropriées. Argument paramètres L'argument parameters est le même objet que celui qui est renvoyé par la fonction findConnection(). Valeurs renvoyées Aucune. Remarque : Les connexions étant partagées, définissez la valeur allowMultiple sur false. Elle garantit que le fichier de connexion n'est inclus qu'une fois dans le document. En outre, elle garantit que le script de serveur reste sur la page si d'autres comportements de serveur l'utilisent. Vous trouverez quelques exemples de fichiers inclus que applyConnection() génère pour divers modèles de serveur par défaut illustrés dans les sections suivantes. Remarque : Pour créer un format de fichier inclus de connexion, définissez un nouveau fichier de mappage EDML, similaire à connection_includefile.edml, comme l'explique la section « Fichier de définition pour votre type de connexion » à la page 88.
API de connectivité à une base de données
Le fichier inclus ASP et JavaScript doit être nommé MyConnection1.asp, où MyConnection1 est le nom de la connexion. L'exemple suivant est un fichier inclus pour une chaîne de connexion ADO : <% Le fichier inclus UltraDev 4 ColdFusion doit être nommé MyConnection1.cfm, où MyConnection1 est le nom de votre connexion. L'exemple suivant illustre le fichier inclus pour une connexion ColdFusion à un tableau de produits : <!-- FileName="Connection_cf_dsn.htm" "dsn=products" --> <!-- Type="ADO" --> <!-- Catalog="" --> Pour tous les modèles de serveur, il existe un fichier connection_includefile.edml qui définit le type de connexion et associe les propriétés définies dans le fichier inclus aux éléments de l'interface Dreamweaver. Par défaut, Dreamweaver fournit des fichiers de définition, un pour chacun des modèles de serveur prédéfinis, comme l'illustre le tableau suivant.
API de connectivité à une base de données
Remarque : Si vous changez le format de votre fichier inclus ou si vous définissez un fichier inclus pour un nouveau modèle de serveur, vous devez associer les paramètres de connexion avec l'interface utilisateur de Dreamweaver, Live Data et Aperçu dans le navigateur. L'exemple suivant de fichier EDML, associé au modèle de serveur ASP JS par défaut, met en correspondance toutes les variables de page de connexion avec leurs valeurs dynamiques respectives avant d'envoyer la page au serveur. Pour plus d'informations sur EDML et les modèles de recherche d'expression régulière, voir « Comportements de serveur » dans Extension de Dreamweaver.
API de connectivité à une base de données
<quickSearch> <![CDATA[// HTTP=]]></quickSearch> Lors de la création d'un type de connexion personnalisée, vous pouvez utiliser n'importe quel fichier de correspondance dans vos boîtes de dialogue personnalisées. Si vous créez un fichier de correspondance, vous pouvez utiliser un nom différent de connection_includefile pour votre fichier EDML. Si vous utilisez un autre nom, vous devez l'utiliser dans votre fichier de mise en œuvre JavaScript lorsque vous indiquez la valeur assignée à la variable PARTICIPANT_FILE comme le montre l'exemple suivant : var PARTICIPANT_FILE = "myConnection_mappingfile";
Pour créer un menu Site > Commande source auquel vous pouvez ajouter des éléments personnalisés, ajoutez le code suivant. Ajoutez le code dans le menu Site, dans le fichier menus.xml : <menu name="Source Control" id="DWMenu_MainSite_Site_Source¬ Control"><menuitem dynamic name="None"file="Menus/MM/¬ File_SCSItems.htm" id="DWMenu_MainSite_Site_NewFeatures_¬ Notes, Dreamweaver appelle la version de la DLL de la fonction API correspondante (Connect(), Disconnect(), Get(), Put(), Checkin(), Checkout(), Undocheckout() et Synchronize()). La DLL est responsable de la gestion de la requête, notamment de l'affichage des boîtes de dialogue qui rassemblent les informations ou qui permettent à l'utilisateur d'interagir avec la DLL. La DLL affiche également des informations ou des messages d'erreur. Le système de commande source peut éventuellement prendre en charge les Design Notes et la fonction d'archivage/extraction. Pour activer les Design Notes dans les systèmes de commande source, l'utilisateur Dreamweaver doit choisir l'onglet Design Notes dans la boîte de dialogue Modifier les sites et cocher la case qui permet d'activer cette fonctionnalité (cette procédure s'applique également aux systèmes FTP et de réseau local). Si le système de commande source ne prend pas en charge les Design Notes et que l'utilisateur souhaite les utiliser, Dreamweaver transporte les fichiers Design Note (.mno) pour gérer les Design Notes (de la même façon qu'avec les systèmes FTP et de réseau local). Les fonctions d'archivage et d'extraction sont traitées différemment ; si le système de commande source les prend en charge, l'utilisateur ne peut pas éviter leur utilisation dans la boîte de dialogue Design Notes. Si l'utilisateur essaie de court-circuiter le système de commande source, un message d'erreur s'affiche.
API d'intégration de commande source
Pour ajouter une fonctionnalité de système de commande source à Dreamweaver, rédigez un gestionnaire GetNewFeatures qui renvoie un jeu d'éléments de menu et les fonctions C correspondantes. Si, par exemple, vous rédigez une bibliothèque Sourcesafe et que vous souhaitez permettre aux utilisateurs de Dreamweaver de consulter l'historique d'un fichier, vous pouvez rédiger un gestionnaire GetNewFeatures qui renvoie l'élément de menu Historique et le nom de la fonction C history. Ainsi, sous Windows, si un utilisateur clique avec le bouton droit de la souris sur un fichier, l'élément Historique s'affiche dans le menu. Si l'utilisateur choisit alors l'élément de menu Historique, Dreamweaver appelle la fonction correspondante, qui se charge de transmettre les fichiers sélectionnés à la DLL. La DLL affiche ensuite la boîte de dialogue Historique, ce qui permet à l'utilisateur d'interagir avec elle de la même façon que Sourcesafe.
L'API d'intégration de commande source comporte des fonctions obligatoires et facultatives. Les fonctions répertoriées dans cette section sont obligatoires.
Description Demande à la DLL de renvoyer son nom et sa description, qui sont affichés dans la boîte de dialogue Modifier les sites. Le nom apparaît dans le menu déroulant Accès (par exemple, Sourcesafe, WebDav, Perforce) et la description s'affiche juste en dessous du menu. Arguments char name[32], char version[32], char description[256], const char *dwAppVersion
Commande source de la boîte de dialogue Modifier les sites. La description ne doit pas compter plus de 256 caractères.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
API d'intégration de commande source
• folderLen est un nombre entier qui indique la longueur de l'argument remotePath. Il s'agit de la valeur renvoyée par la fonction GetRootFolderLength. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Nombre entier qui indique le nombre d'éléments dans le dossier en cours. Si la fonction renvoie < 0, Dreamweaver considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est prise en charge.
API d'intégration de commande source
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers distants. • L'argument numItems est le nombre d'éléments dans chaque liste. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• numItems est le nombre d'éléments dans remotePathList. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Si les valeurs de oldRemotePath et de newRemotePath sont respectivement "$/folder1/file1" et "$/folder1/subfolder1/file1", le fichier file1 est alors déplacé dans le sous-dossier subfolder1. Pour savoir si l'invocation de cette fonction constitue un déplacement ou l'attribution d'un nouveau nom, vérifiez les chemins parents des deux valeurs d'entrée ; s'ils sont identiques, il s'agit de l'opération « renommer ». Arguments void *connectionData, const char *oldRemotePath, const char *newRemotePath
• newRemotePath est le nom du chemin d'accès au nouveau fichier ou dossier distant. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument connectionData est un descripteur des données que l'agent veut recevoir de Dreamweaver lorsqu'il appelle d'autres fonctions API.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument enablerList est renseigné par la DLL ; il indique les routines de la DLL à appeler lorsque Dreamweaver a besoin de déterminer si l'élément de menu correspondant est activé.
API d'intégration de commande source
La signature de fonction suivante définit les fonctions et les activateurs transmis par appel de la fonction SCS_GetNewFeatures() dans les arguments functionlist et enablerList. bool (*scFunction)(void *connectionData, const char *remotePathList[], const char *localPathList[], const int numItems)
Valeur booléenne : true en cas de réussite, false dans le cas contraire. • emailAddress est l'adresse électronique de l'utilisateur en cours. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers distants. • successList est une liste de valeurs booléennes complétée par la DLL pour permettre à Dreamweaver de connaître les fichiers dont l'archivage a réussi.
API d'intégration de commande source
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument localPathList est une liste miroir des noms de chemin d'accès aux fichiers ou aux dossiers locaux. • successList est une liste de valeurs booléennes complétée par la DLL pour permettre à Dreamweaver de connaître les fichiers dont l'extraction a réussi.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• successList est une liste de valeurs booléennes complétée par la DLL pour permettre à Dreamweaver de connaître les fichiers dont l'extraction a été annulée avec succès.
API d'intégration de commande source
Dreamweaver considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est prise en charge.
Description Renvoie une liste d'utilisateurs dont un fichier a été extrait. Si cette liste est vide, c'est que personne n'a de fichier extrait. • checkOutList est une liste de chaînes qui correspond aux utilisateurs disposant du fichier extrait. Chaque chaîne ne doit pas avoir plus de 64 caractères.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
API d'intégration de commande source
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Nombre entier qui indique la taille de la Design Note la plus longue associée au fichier. Si la fonction renvoie < 0, Dreamweaver considère cette réponse comme une erreur et tente de récupérer le message d'erreur de la DLL si elle est prise en charge.
Description Récupère des paires clé-valeur des méta-informations pour le fichier ou le dossier spécifié. Si cette fonction n'est pas prise en charge par le système de commande source, Dreamweaver récupère ces informations depuis fichier MNO. • valueList est une liste de valeurs de Design Note correspondant aux clés de Design Note, comme "Awaiting Signoff".
API d'intégration de commande source
• L'argument keyList est une liste de clés de Design Note, comme "Status". • valueList est une liste de valeurs de Design Note correspondant aux clés de Design Note, comme "Awaiting Signoff".
à la DLL de connaître la taille des listes spécifiées. Si noteCount a pour valeur 0, toutes les Design Notes sont supprimées du fichier.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• remoteIsNewerList est une liste de nombres entiers complétée par la DLL pour permettre à Dreamweaver d'identifier le fichier le plus récent du côté distant. Les valeurs suivantes sont admises : 1 indique que la version distante est la plus récente ; -1 indique que la version locale est la plus récente ; 0 indique que les deux versions sont identiques.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Si les activateurs facultatifs ne sont pas pris en charge par le système de commande source ou que l'application n'est pas connectée au serveur, Dreamweaver détermine le moment où les éléments de menu sont activés, en fonction des informations dont il dispose concernant les fichiers distants.
• L'argument numItems est le nombre d'éléments dans chaque liste.
API d'intégration de commande source
• L'argument numItems est le nombre d'éléments dans chaque liste. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers à placer dans le système de commande source.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument remotePathList est une liste miroir de noms de chemin d'accès aux fichiers ou aux dossiers distants. • L'argument numItems est le nombre d'éléments dans chaque liste. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• localPathList est une liste de noms de chemin d'accès aux fichiers ou aux dossiers locaux à placer dans le système de commande source.
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
API d'intégration de commande source
Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Valeur booléenne : true en cas de réussite, false dans le cas contraire.
Pour acquérir un groupe de fichiers, Dreamweaver effectue des appels vers la DLL dans l'ordre suivant : SCS_BeforePut(connectionData); SCS_Put(connectionData,localPathList1,remotePathList1,successList1); Configuration/ExtensionHelp/browseHelp.htm#helpyou », par exemple). Valeurs renvoyées Aucune. Exemple La fonction suivante utilise la fonction dreamweaver.browseDocument() pour ouvrir la page d'accueil Adobe dans un navigateur : function goToadobe(){ dreamweaver.browseDocument('http://www.adobe.com/'); L'aide complète est contenue dans les quatre types de fichiers suivants. Pour plus d'informations sur les fichiers d'aide, consultez la documentation de votre système d'exploitation.
Le manuel d'aide se compose de fichiers d'aide HTML, d'images et d'index. Sous Windows, le manuel d'aide est un fichier portant l'extension .chm. Sur Macintosh, le manuel d'aide est undossier. Les fichiers du manuel d'aide se trouvent dans le dossier d'aide de Dreamweaver.
Le fichier help.xml établit des correspondances entre les ID et le nom des manuels d'aide. Par exemple, le code XML ci-dessous établit une correspondance entre l'ID du manuel d'aide de Dreamweaver et le nom des fichiers contenant cette aide, sous Windows comme sur Macintosh : <?xml version = "1.0" ?> <help-books><book-id id="DW_Using" winmapping="UsingDreamweaver.chm" mac-mapping="Dreamweaver Help"/> </help-books> Le fichier helpDoc.js vous permet d'établir une correspondance entre des noms de variables que vous pouvez utiliser à la place de l'ID du manuel et de la chaîne de page. Le fichier helpDoc.js établit une correspondance entre un ID de contenu et une page HTML dans un manuel d'aide spécifique. Dreamweaver utilise le fichier helpDoc.js lorsqu'il appelle l'aide à partir de JavaScript.
Dreamweaver transmet cette chaîne à la fonction inspectDynamicDataRef() pour déterminer si la chaîne correspond à l'un des nœuds de l'arborescence. Si la chaîne correspond à un nœud, celui-ci est sélectionné lorsque la boîte de dialogue réapparaît. Vous pouvez également transmettre une chaîne vide qui n'initialise pas la boîte de dialogue. Par exemple, aucune boîte de dialogue n'est initialisée lorsqu'elle est utilisée pour créer un nouvelélément.
Valeurs renvoyées Chaîne qui représente l'objet de données dynamique, si l'utilisateur clique sur OK.
Valeurs renvoyées Valeur booléenne indiquant si la tâche d'inactivité a été enregistrée correctement. Exemple L'exemple suivant entraîne l'émission par le système d'un bip sonore toutes les 5 secondes : dw.registerIdleHandler("acme_beep_task", function() { dw.beep();}, 5); • L'id est une chaîne unique permettant d'identifier la tâche d'inactivité enregistrée à supprimer. Il s'agit du même ID qui a été utilisé initialement pour enregistrer la tâche. Valeurs renvoyées Valeur booléenne indiquant si la tâche d'inactivité a été supprimée correctement. Exemple L'exemple suivant supprime la tâche d'inactivité nommée "dw_beep_task" de la file d'attente des tâches d'inactivité : dw.revokeIdleHandler("acme_beep_task"); Les fonctions de communication avec Bridge permettent la communication entre Dreamweaver et l'application Bridge. Cette communication permet notamment à l'utilisateur de rechercher facilement des fichiers dans Bridge à partir de Dreamweaver.
Disponibilité • navigation à l'aide de fonctions de clavier ; • rechargement de menus ; • manipulation de fenêtres de résultats autonomes ou intégrées ; • Définition d'options • positionnement d'une barre d'outils ; • obtention ou définition du focus. Historique. Par étape, on entend une modification apportée à un document (ou à une sélection dans le document) pouvant être reproduite. Les méthodes de l'objet dreamweaver.historyPalette permettent de contrôler ou d'agir sur la sélection dans le panneau Historique et non dans le document actif.
Disponibilité Un appel à la fonction dreamweaver.historyPalette.replaySteps([0,2,3]) réexécute la première, la troisième et la quatrième étapes dans le panneau Historique.
L'exemple suivant enregistre la quatrième, la sixième et la huitième étapes du panneau Historique comme une commande : dreamweaver.historyPalette.saveAsCommand([3,5,7]);
• L'argument defaultId correspond à la chaîne définissant le nouvel objet par défaut dans le champ insertbar.xml.
Valeur booléenne : true si la configuration de la nouvelle valeur par défaut réussit et false dans le cas contraire. Exemple L'exemple suivant définit l'objet Flash en qualité d'objet par défaut pour le menu Support : dw.objectPalette.setMenuDefault("DW_Media", "DW_Flash");
• L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet argument n'est pas défini, il prend par défaut la valeur false. Valeurs renvoyées Aucune. • L'argument facultatif bShiftIsDown est une valeur booléenne qui indique s'il faut étendre la sélection. Si cet argument n'est pas défini, il prend par défaut la valeur false. Valeurs renvoyées Aucune. Déplace le point d'insertion au début de la ligne. Arguments Fonctions relatives aux menus Ces fonctions permettent d'optimiser et de recharger les menus dans Dreamweaver. Les fonctions dreamweaver.getMenuNeedsUpdating() et dreamweaver.notifyMenuUpdated() sont spécialement conçues pour empêcher l'exécution de routines de mise à jour superflues sur les menus dynamiques intégrés à Dreamweaver. Pour plus d'informations, voir « dreamweaver.getMenuNeedsUpdating() » à la page 146 et « dreamweaver.notifyMenuUpdated() » à la page 147.
Disponibilité Fonctions de la fenêtre de résultats Les fonctions de la fenêtre de résultats vous permettent de dialoguer avec les panneaux intégrés du groupe de panneaux Résultats ou de créer une fenêtre indépendante contenant des colonnes de données formatées.
Ces fonctions produisent l'affichage dans le groupe de panneaux Résultats. Le groupe de panneaux Résultats présente des panneaux à onglets sur les recherches, la validation de la source, les rapports au niveau du site, la vérification de compatibilité avec les navigateurs, le débogage de serveur, les connexions FTP et les vérifications de liens. Panneaux enfants spécifiques Les panneaux enfants suivants sont des fenêtres de résultats intégrées qui existent toujours dans l'interface Dreamweaver et auxquelles il est possible d'accéder directement.
URL, la fonction sélectionne le premier élément visible de ce document. Valeurs renvoyées Aucune. Exemple L'exemple suivant vérifie la présence d'erreurs au début de la sélection en cours dans le document. Si des erreurs sont détectées, elles sont affichées dans la fenêtre spécifiée (floaterName) du panneau de résultats. Dans le cas contraire, il ouvre la fenêtre Vérification de compatibilité avec les navigateurs du panneau de résultats et affiche le premier • L'argument strFilePath est le chemin d'accès complet à l'URL du fichier à traiter. • L'argument strIcon est le chemin d'accès à l'icône à utiliser. Pour afficher une icône intégrée, utilisez une valeur comprise entre 1 et 10 plutôt que le chemin d'accès complet à l'icône (utilisez la valeur 0 pour n'afficher aucune icône). L'illustration ci-dessous indique les icônes correspondant aux chiffres allant de 1 à 10 :
(généralement le nom de fichier).
• L'argument iLineNo est le nombre de lignes figurant dans le fichier (facultatif). • L'argument iStartSel indique le début du décalage dans le fichier (facultatif, mais s'il est présent, il faut également utiliser l'argument iEndSel).
Valeurs renvoyées Aucune. • L'argument arrColumns est un tableau de noms de colonnes à utiliser dans le contrôle de liste. Valeurs renvoyées Référence d'objet à la fenêtre créée.
« dreamweaver.createResultsWindow() » à la page 153. La fonction resWin.addItem() ne peut pas être utilisée avec les fenêtres de résultats intégrées, notamment avec les fenêtres Validation, Vérifier la compatibilité avec les navigateurs ou Rapports du site. Arguments resultWindowObj, strIcon, strDesc, itemData, iStartSel, iEndSel, colNdata
• L'argument strIcon est une chaîne indiquant le chemin d'accès à l'icône à utiliser. Pour afficher une icône intégrée, utilisez une valeur comprise entre 1 et 10 plutôt que le chemin d'accès complet à l'icône. Utilisez la valeur 0 pour n'afficher aucune icône. L'illustration ci-dessous indique les icônes correspondant aux chiffres allant de 1 à 10 :
• L'argument itemData est une chaîne qui peut vous servir à stocker des données particulières relatives à l'élément à ajouter (numéro de ligne du document, par exemple).
Valeurs renvoyées Valeur booléenne : true si l'élément a été ajouté, false dans le cas contraire. Exemple L'exemple suivant crée une fenêtre de résultats du nom de resWin dont les colonnes s'intitulent Frodo, Sam et Gollum. L'appel de la fonction resWin.addItem() ajoute une icône de dossier ainsi que les trois chaînes (msg1, msg2 et msg3) dans les trois colonnes définies pour la fenêtre. var resWin = dw.createResultsWindow("Test Window", ["Frodo", "Sam", "Gollum"]); resWin.addItem(resWin, "3", "Description", null, null, null, ["msg1", "msg2", "msg3"]);
Disponibilité Espace de travail
• L'argument bRecursive est une valeur booléenne indiquant si la répétition doit être récurrente (true) ou non (false). Valeurs renvoyées Aucune. • les exceptions ; • les requêtes SQL ; • les requêtes d'objets ; • les variables ; • la plage de tracé.
RÉFÉRENCE DES API DE DREAMWEAVER CS4 160 Espace de travail
<context> • L'argument bShow est une valeur booléenne : true indique que la mise en surbrillance du code HTML incorrect est visible, et false qu'elle ne l'est pas. Valeurs renvoyées Espace de travail
Disponibilité étiquettes, de vous procurer les étiquettes des éléments de barre d'outils dans la fenêtre en cours, de positionner les barres d'outils et d'obtenir leur ID. Pour plus d'informations sur la création ou la modification des barres d'outils, consultez la rubrique « Barres d'outils » dans l'aide Extension de Dreamweaver.
Disponibilité Une chaîne représentant la valeur de l'élément de barre d'outils. Exemple L'exemple de fonction receiveArguments() suivant figure dans une commande de barre d'outils qui régit le comportement d'un champ de texte Size ; il obtient la valeur du champ Size sous la forme d'un argument, puis lit la valeur du champ Units afin de générer une valeur valide pour la fonction de propriété CSS font-size :
} else{ dom.removeFontMarkupAsStyle('font-size'); L'exemple suivant stocke l'étiquette de myEditbar dans la variable label : var label = dom.getToolbarLabel("myEditbar");
• L'argument toolbarItemId est une chaîne qui indique l'ID de l'élément de la barre d'outils. • L'argument attrName est une chaîne qui indique le nom de l'attribut à définir. Les valeurs autorisées sont 'image', 'overImage', 'disabledImage' et 'tooltip'.
Valeurs renvoyées Aucune. Cette fonction ordonne à Dreamweaver s'afficher les étiquettes des boutons qui en possèdent. Dreamweaver affiche toujours les étiquettes des commandes qui ne sont pas des boutons, si elles sont définies. Arguments bShow. • L'argument toolbar_id est l'ID de la barre d'outils, qui correspond à la valeur de l'attribut ID de la balise toolbar définie dans le fichier toolbars.xml.
Les valeurs possibles de l'argument position sont décrites dans la liste suivante :
• relative_to="toolbar_id" est requis si position spécifie below. Dans les autres cas, cet argument est ignoré. Indique l'ID de la barre d'outils en dessous de laquelle cette barre d'outils doit être placée. Valeurs renvoyées Aucune. Exemple L'exemple suivant place myEditbar en dessous de la barre d'outils myPicturebar : Remarque : Certaines fonctions de cette section fonctionnent uniquement sous Windows. Leur description indique si tel est le cas.
Disponibilité • la chaîne "frameset" si un jeu de cadres ou l'un des cadres qui le composent est sélectionné ; • la chaîne "none" si la zone active ne figure pas dans le document (si elle se trouve dans l'inspecteur Propriétés ou dans un autre panneau flottant, par exemple).
Disponibilité Dreamweaver 4, mise à jour dans CS4. Remarque : Le résultat n'influe pas sur la barre Insertion, mais bien sur le panneau Insertion. Arguments Aucun. Les valeurs de floaterName pour les panneaux intégrés sont les chaînes se trouvant à droite des noms de panneaux dans la liste suivante :
Comportements = "behaviors" • la chaîne "textView" si le mode Texte est actif ; • la chaîne "html" si l'inspecteur de code est actif ; • la chaîne floaterName, si bAllowFloaters a pour valeur true et si un panneau flottant est actif, floaterName correspondant à "objects", "properties", "launcher", "library", "css styles", "html styles", "behaviors", "timelines", "layers", "frames", "templates" ou "history" ;
Actifs = "assets" Comportements = "behaviors" Liaisons = "data sources" Inspecteur de code = "html" Espace de travail
Tableau de chaînes qui contient tous les fichiers apparentés analysés sous la forme d'URL locales absolues.
Disponibilité Espace de travail
Dreamweaver ajuste les limites du code situé avant la balise de d'ouverture et du code situé après la balise de fermeture pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement en cours. Si défini sur false, Dreamweaver fractionne les fragments de code qui se trouvent avant la balise d'ouverture et après la balise de fermeture, exactement comme indiqué par la sélection. Valeurs renvoyées Aucune. Exemple L'exemple suivant ajuste les limites du code avant la balise d'ouverture et après la balise de fermeture pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement : var currentDOM = dw.getDocumentDOM(); currentDOM.collapseFullTagInverse(true); Dreamweaver ajuste les limites du code situé avant et après la sélection en cours pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement en cours. Si défini sur false, Dreamweaver fractionne le fragment de code exactement comme indiqué par la sélection. Valeurs renvoyées Aucune. Exemple L'exemple suivant modifie puis fractionne toutes les portions de code situées avant et après le code sélectionné en mode Code : var currentDOM = dw.getDocumentDOM(); currentDOM.collapseSelectedCodeFragmentInverse(true); Etend tous les fragments de code réduits dans la sélection en cours en mode Code. Si la sélection est déjà étendue, cette fonction ne fait rien. Arguments Dreamweaver ajuste les limites du code situé avant la balise de d'ouverture et du code situé après la balise de fermeture pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement existants. Si défini sur false, Dreamweaver fractionne le code situé avant la balise d'ouverture et le code situé après la balise de fermeture, sans le modifier. Valeurs renvoyées Aucune. Exemple L'exemple suivant effectue un fractionnement intelligent sur les sections de code qui apparaissent avant la balise d'ouverture et après la balise de fermeture de la sélection en cours : dreamweaver.htmlInspector.collapseFullTagInverse(true); Dreamweaver ajuste les limites des sections de code situé avant et après la sélection en cours pour effectuer un fractionnement intelligent qui conserve la mise en retrait et l'espacement en cours. Si défini sur false, Dreamweaver fractionne les sections de code exactement comme indiqué par la sélection. Valeurs renvoyées Aucune. Exemple L'exemple suivant fractionne toutes les portions de code avant et après le code sélectionné dans l'inspecteur de code, exactement comme indiqué par la sélection : dreamweaver.htmlInspector.collapseSelectedCodeFragmentInverse(false); Remarque : Il existe deux barres d'outils de codage, l'une pour le mode Code et l'autre pour l'inspecteur ed code. Les deux sont personnalisées dans le ficher Configuration/Toolbars/toolbars.xml.
Disponibilité Cependant, s'il n'y a pas de sélection, la fonction ne sélectionne aucun élément. Si la valeur du texte spécifié dans l'argument afterText est null, la fonction insère le texte spécifié dans l'argument beforeText au début de chaque ligne dans la sélection en cours. Arguments beforeText, afterText
Valeurs renvoyées Aucune. Cette fonction supprime des commentaires. Si vous n'indiquez aucun argument, elle supprime tous les types de commentaires de la sélection en cours, à l'exception des inclusions côté serveur et des commentaires spécifiques Dreamweaver. En cas de commentaires imbriqués, elle supprime uniquement le commentaire externe. S'il n'y a pas de sélection en cours, elle supprime uniquement le premier commentaire de la ligne sur laquelle se trouve le curseur. Si vous indiquez des arguments, la fonction supprime uniquement les commentaires correspondant aux valeurs spécifiées dans les arguments beforeText et afterText, même si les commentaires correspondants sont imbriqués dans d'autres types de commentaires. Arguments beforeText, afterText
Valeurs renvoyées Aucune. Les fonctions des couleurs suivantes vous permettent de vérifier que les extensions possèdent le même habillage que l'interface utilisateur de l'application.
Disponibilité Ces fonctions permettent d'accéder aux fonctionnalités de création de rapports et notamment de lancer, de contrôler et de personnaliser le processus de création de rapports. Pour plus d'informations, consultez la rubrique « Rapports » dans l'aide Extension de Dreamweaver.
Disponibilité • obtenir, placer, archiver et extraire des fichiers ; • sélectionner et désélectionner des fichiers ; • créer et supprimer des fichiers ; • obtenir des informations sur les sites définis par l'utilisateur ; • importer et exporter les informations du site.
Disponibilité • L'argument obligatoire file2 est une chaîne contenant le chemin d'accès complet au second fichier à comparer.
Valeurs renvoyées Aucune. Activateur Voir « site.canCloak() » à la page 492. Cet exemple déploie les fichiers image1.jpg et script1.js dans le dossier bin du serveur d'évaluation : site.deployFilesToTestingServerBin("image1.jpg", "script1.js");
• L'heure de test, qui indique pour le fichier situé sur le serveur d'évaluation, l'horodatage de la dernière commande acquérir ou placer sur le serveur d'évaluation. Si le fichier dwsync.xml ne contient pas d'informations pour le fichier, un message s'affiche et indique qu'aucune information n'est disponible. Si l'heure est définie dans le fichier XML, elle s'affiche au format date/heure correspondant aux paramètres régionaux (par exemple, 24/6/05 14:43). Si l'heure n'est pas définie dans l'entrée correspondant au fichier, un tiret (-) est affiché. Cette fonction agit sur le fichier sélectionné dans l'affichage local des fichiers, si 'site' est transmis, ou sur le fichier correspondant à l'URL locale, si une URL est transmise.
Arguments siteName, {askAboutLoginInfo}, {warnAboutSCS}, {savePath}
Valeurs renvoyées Aucune. Exemple Si trois sites sont définis (avocado8, dreamcentral et testsite, par exemple), un appel à la fonction site.setCurrentSite("dreamcentral") fait de dreamcentral le site en cours. Remarque : Pour les chemins de dossier, ne tapez pas la barre oblique (/) à la fin du chemin.
• Conversion d'une URL relative en URL absolue • Obtention du nœud sélectionné • Réalisation d'un codage d'URL sur une chaîne • Exécution d'un traducteur sur le document
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.
Disponibilité Ces fonctions permettent de créer, d'ouvrir et d'enregistrer des documents (y compris XML et XHTML), de convertir des documents HTML existants en XHTML et d'exporter des styles CSS vers des fichiers externes. Elles permettent également de rechercher des fichiers ou des dossiers, de créer des fichiers à partir de modèles, de fermer des documents et d'obtenir la liste des fichiers récemment ouverts.
Disponibilité • les éléments img ne disposant pas d'un attribut alt et ne pouvant pas être résolus ; • les éléments area ne disposant pas d'un attribut alt et ne pouvant pas être résolus.
Disponibilité • Une déclaration doctype • L'attribut xmlns dans l'élément html • Une section head • Un élément title • Une section body Pendant la conversion, la fonction dom.convertToXHTML() convertit les balises et les attributs HTML purs en minuscules, écrit des balises et des attributs HTML à l'aide d'une syntaxe XHTML correcte et ajoute des attributs HTML manquants où cela est possible. Cette fonction traite les balises et les attributs tiers en fonction des paramètres de la boîte de dialogue Préférences. Si le document est un modèle, la fonction dom.convertToXHTML() alerte l'utilisateur mais n'effectue pas la conversion. Arguments Aucun. Valeurs renvoyées Un tableau de six nombres entiers qui quantifient le nombre d'éléments suivants : • les éléments script ne disposant pas d'un attribut type et ne pouvant pas être résolus ; • les éléments style ne disposant pas d'un attribut type et ne pouvant pas être résolus ; • les éléments img ne disposant pas d'un attribut alt et ne pouvant pas être résolus ; • les éléments area ne disposant pas d'un attribut alt et ne pouvant pas être résolus.
Cet argument est facultatif. Valeurs renvoyées Une chaîne contenant le nom du fichier, exprimé sous la forme d'une URL de type file://.
Configuration/DocumentTypes/MMDocumentTypes.xml de Dreamweaver dans l'attribut id de la balise documenttype. L'argument type peut par exemple avoir la valeur "HTML", "ASP-JS", "ASP-VB", "ColdFusion", "CFC", "JSP", "ASP.NET_VB", ou toute valeur similaire. Pour obtenir la liste complète des types disponibles, consultez le fichier MMDocumentTypes.xml. Si vous ne définissez pas l'argument type, il adopte la valeur "HTML".
Valeurs renvoyées Objet document correspondant au nouveau document créé. Il s'agit de la valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
• La valeur document désigne le document actif contenant la sélection en cours. • La valeur parent désigne le jeu de cadres parent (si le document sélectionné se trouve dans un cadre). • Les valeurs parent.frames[number] et parent.frames['frameName'] désignent un document figurant dans un cadre spécifique du jeu de cadres contenant le document actif.
Remarque : Si l'argument a pour valeur "document", l'appelant doit être la fonction applyBehavior(), deleteBehavior(), objectTag() ou toute fonction d'un fichier de commande ou d'inspecteur Propriétés pouvant modifier le document. Valeurs renvoyées L'objet document JavaScript à la racine de l'arborescence. Exemples L'exemple suivant utilise la fonction dreamweaver.getDocumentDOM() pour accéder au document actif : var theDOM = dreamweaver.getDocumentDOM("document");
Remarque : Cette fonction provoque une erreur si elle est appelée à partir d'un fichier d'objet ou d'action de comportement. Arguments fileName
Valeurs renvoyées L'objet document correspondant au fichier spécifié, soit la même valeur renvoyée par la fonction dreamweaver.getDocumentDOM().
Remarque : Cette fonction ne s'applique qu'aux documents référencés par une URL, qui ne sont pas ouverts dans un cadre ou dans une fenêtre de document et qui ne correspondent pas à des fichiers d'extension (les fichiers d'extensions externes sont chargés en mémoire au démarrage et n'en sont libérés que lorsque vous quittez Dreamweaver).
URL relative, elle est relative au fichier de l'extension. Dans Dreamweaver 2, cet argument est obligatoire. Dans Dreamweaver 4, si l'argument fileURL est omis et si le fichier a été enregistré précédemment, ce dernier est enregistré au même endroit ; sinon, la boîte de dialogue Enregistrer sous s'affiche. Valeurs renvoyées Valeur booléenne indiquant le succès (true) ou l'échec (false) de l'opération. Activateur Voir « dreamweaver.canSaveDocument() » à la page 479. éléments du document.
Disponibilité "xml", il valide le document en tant que XML.
(ou validation en ligne). Plutôt que d'être affichées dans la fenêtre de résultats de la validation (voir « dom.source.getValidationErrorsForOffset() » à la page 449 and « dom.getAutoValidationCount() » à la page 442), les erreurs sont soulignées dans le mode Code.
Remarque : La validation automatique (définie par la valeur "auto-explicit" ou "auto-implicit" de l'argument controlString) n'est disponible que pour la vérification du navigateur cible.
"auto-implicit". L'argument bShowInfoMessage est une valeur booléenne. true affiche un message
Objet fenêtre des résultats de la validation. Exemple Dans l'exemple suivant, une validation régulière est effectuée lorsque l'utilisateur sélectionne Fichier > Vérifier la page > Valider le marqueur (ou Valider le document actuel dans le panneau Validation) : dw.getDocumentDOM().runValidation('');
La fenêtre de résultats de la validation ne s'affiche pas et le nombre d'erreurs dans le document n'apparaît pas sur la barre d'outils du document : dw.getDocumentDOM().runValidation('auto-implicit', false);
Disponibilité Dreamweaver MX 2004. ID du fichier toolbars.xml.
• L'argument timeout est un nombre indiquant le temps d'affichage du message en millisecondes. Si sa valeur est 0 (valeur par défaut), le message reste affiché pendant une durée illimitée. Le message disparaît automatiquement lorsque l'utilisateur clique dessus, passe à un autre document ou lorsque la durée d'affichage spécifiée arrive à expiration. Valeurs renvoyées Aucune. Exemple Dans l'exemple ci-dessous, deux messages s'affichent sous forme d'infobulles. La première ligne de code affiche le message "This message is in the center" au centre du document. Le second appel de la fonction showInfoMessagePopup() affiche le message "Don't forget the title for the Window" pour la zone de texte ID, Dreamweaver renvoie "unnamed <tag>". Si le navigateur ne prend pas en charge une référence par nom,
• L'argument key est une chaîne qui spécifie l'entrée de la valeur à extraire. • L'argument default_value est la valeur par défaut renvoyée par Dreamweaver si l'entrée est introuvable. Il doit s'agir d'un entier non signé compris entre 0 et 65535 ou d'un entier signé compris entre -32768 et 32767. Valeurs renvoyées Valeur entière de l'entrée spécifiée dans la section ou valeur par défaut si la fonction ne trouve pas l'entrée. Renvoie 0 si la valeur de l'entrée spécifiée n'est pas un entier.
• L'argument default_value est la valeur de chaîne par défaut renvoyée par Dreamweaver si l'entrée est introuvable. Valeurs renvoyées Chaîne de la préférence demandée ou valeur par défaut si la chaîne est introuvable. Exemple L'exemple suivant renvoie la valeur du paramètre Editeur de texte de la section Mon extension des Préférences. Si la section Mon extension n'existe pas ou si le paramètre Editeur de texte n'est pas défini, la fonction renvoie la valeur par défaut spécifiée par la variable txtEditor. var txtEditor = getExternalTextEditor(); //set default text Editor value txtEditor = dreamweaver.getPreferenceString("My Extension", "Text Editor", txtEditor);
Dreamweaver la crée.
Valeurs renvoyées Valeur true en cas de succès et false dans le cas contraire. Exemple L'exemple suivant définit l'entrée Distance d'accrochage en fonction de la valeur de la variable snapDist de la catégorie Mon extension dans les Préférences : var snapDist = getSnapDistance(); if(snapDist > 0) { dreamweaver.setPreferenceInt("My Extension", "Snap Distance", snapDist); }
Arguments section, key, new_value
Valeurs renvoyées Valeur true en cas de succès et false dans le cas contraire. Exemple var txtEditor = getExternalTextEditor(); dreamweaver.setPreferenceString("My Extension", "Text Editor", txtEditor);
Document "parent.frames[number]" et "parent.frames['frameName']" désignent un document figurant dans un cadre
Valeurs renvoyées Soit une chaîne contenant l'URL du document défini si le fichier a été enregistré, soit une chaîne vide si le fichier n'a pas été enregistré.
Temp n'a été trouvé, la fonction en crée un. Les fichiers partagés qui ne sont pas transitoires doivent être enregistrés dans le dossier Configuration/Shared. Arguments Aucun. Valeurs renvoyées Chemin d'accès au dossier, exprimé sous la forme d'une URL de type file://. • L'argument relURL est l'URL à convertir. Valeurs renvoyées URL absolue. La valeur renvoyée est générée conformément aux principes suivants :
• Si relURL est une URL relative à un document, la valeur renvoyée est une combinaison de docPath et relURL. • Si relURL est une URL relative à la racine, la valeur renvoyée est une combinaison de siteRoot et relURL.
Ces fonctions permettent d'obtenir et de définir la sélection dans les documents ouverts. Pour savoir comment obtenir et définir la sélection dans le panneau Site, voir « Fonctions relatives aux sites » à la page 213.
Disponibilité RÉFÉRENCE DES API DE DREAMWEAVER CS4 274 Document
Si les deux valeurs sont identiques, la sélection en cours correspond à un point d'insertion. Pour les sélections complexes (lorsque la sélection se compose de plusieurs cellules de tableau, calques ou zones réactives de carte graphique), tableau contenant 2n nombres entiers, où n représente le nombre d'éléments sélectionnés. Le premier entier de chaque paire correspond au décalage de caractères de l'ouverture de la sélection (balise d'ouverture TD, DIV, SPAN, LAYER, ILAYER ou MAP comprise) ; le second entier correspond au décalage de caractères à la fermeture de la sélection (balise de fermeture TD, DIV, SPAN, LAYER, ILAYER ou MAP). Si plusieurs rangées d'un tableau sont sélectionnées, le décalage de chaque cellule de chaque rangée est renvoyé. La sélection n'inclut jamais les balises TR.
Disponibilité RÉFÉRENCE DES API DE DREAMWEAVER CS4 277 Document
SRC="myImage.gif" comme sélection dans IMG SRC="myImage.gif", la sélection est étendue pour inclure également la balise IMG. Valeurs renvoyées Aucune.
Disponibilité document avant la fin de la balise d'ouverture. Elle renvoie une valeur booléenne qui indique si l'analyse doit continuer.
PHP. La fonction directive() accepte deux arguments : une chaîne contenant la directive et le décalage du document, qui correspond au nombre d'octets contenus dans le document avant la fin de la balise de fermeture. La fonction renvoie une valeur booléenne qui indique si l'analyse doit continuer.
Arguments HTMLstr, parserCallbackObj Extension C. Vous obtiendrez également de meilleures performances si la fonction parserCallbackObj définit uniquement les fonctions de rappel dont elle a besoin. Valeurs renvoyées Valeur booléenne, true si l'opération a réussi et false dans le cas contraire. Exemple La séquence d'étapes suivante offre un exemple d'utilisation de la fonction dreamweaver.scanSourceString() : 1 Créez une implémentation pour une ou plusieurs des sept fonctions de rappel. 2 Ecrivez un script qui appelle la fonction dreamweaver.scanSourceString(). 3 La fonction dreamweaver.scanSourceString() transmet une chaîne contenant le code HTML et les pointeurs
Ces fonctions permettent d'agir directement sur les traducteurs de données ou sur les résultats de la traduction. Elles permettent d'exécuter ou d'obtenir des informations sur un traducteur, de modifier le contenu d'une région verrouillée et de stipuler que le code traduit doit être utilisé lors de l'obtention et de la définition de décalages de sélection.
Disponibilité • L'argument bAllowEdits est une valeur booléenne : true indique que les modifications sont interdites et false le contraire. Dreamweaver restaure automatiquement l'état par défaut (non modifiable) des régions verrouillées lorsque l'exécution du script qui appelle la fonction prend fin. Valeurs renvoyées La valeur par défaut de l'argument est false. Lorsque le script appelant la fonction dw.useTranslatedSource() prend fin, Dreamweaver utilise automatiquement le code source non converti pour les appels suivants de dw.getSelection(), dw.setSelection(), dw.nodeToOffsets() et dw.offsetsToNode(), sauf si la fonction dw.useTranslatedSource() est appelée explicitement avec l'argument false avant la fin de l'exécution du script. Valeurs renvoyées Aucune.
Une chaîne contenant la référence au document source XML associé au document XSLT actif. Si la référence à la source XML est une référence distante, la fonction renvoie le chemin d'accès à l'emplacement temporaire du fichier téléchargé. Exemple L'exemple suivant obtient la référence au document source XML associé à c:\myxslt\myxsltdocument.xsl : var theXMLSource = MMXSLT.getXMLSourceURI("file:///c:/myxslt/myxsltdocument.xsl");
L'exemple suivant ouvre la boîte de dialogue Document source XML sans indiquer de valeur : MMXSLT.launchXMLSourceDialog()
• Manipulation d'éléments en les coupant et en les collant dans le Presse-papiers • Application d'un modèle • Insertion d'un fragment de code • Création d'ensembles de données XML Spry • Modification améliorée de Spry et d'autres widgets • Insertion de widgets • Création de mises en page qui fonctionnent dans divers navigateurs, grâce aux fonctions de vérification de la compatibilité avec les navigateurs
Ces fonctions, programmées dans l'API comme panneau d'actifs, vous permettent de gérer et d'utiliser les éléments contenus dans le panneau Actifs (modèles, bibliothèques, images, contenu Adobe Shockwave et Adobe Flash, URL, couleurs et scripts).
Disponibilité Ajoute les éléments sélectionnés dans la liste des sites à la liste des favoris et donne à chaque élément un surnom. Cette fonction ne supprime pas les éléments de la liste des sites. Arguments Aucun. Valeurs renvoyées Aucune. • La chaîne value est le chemin entier, l'URL complète ou la valeur chromatique, selon l'élément sélectionné. • La chaîne type, qui peut être "folder" ou l'une des catégories suivantes : "templates",
Crée un nouveau dossier ayant un nom par défaut (sans nom) dans la catégorie en cours et place une zone de texte autour du nom. Cette fonction est uniquement disponible dans la liste des favoris. Arguments Supprime les éléments sélectionnés de la liste des favoris. Cette fonction ne supprime pas les fichiers du disque, sauf dans le cas d'une bibliothèque ou d'un modèle où l'utilisateur est invité à confirmer l'opération avant que le fichier ne soit supprimé. Cette fonction est uniquement disponible dans la liste des favoris ou si la catégorie est Library ou Templates. Ces fonctions vous permettent d'associer des comportements à un objet ou de les en dissocier, d'identifier les comportements associés à un objet, d'obtenir des informations sur un objet auquel est associé un comportement, etc. Les méthodes de l'objet dreamweaver.behaviorInspector contrôlent ou agissent uniquement sur la sélection dans le panneau Comportements et non sur la sélection dans le document actif.
Disponibilité (par exemple, onClick, onMouseOver ou onLoad). Si cet argument n'est pas défini, toutes les actions sont supprimées de l'élément.
Aucune. • lorsque le panneau Comportements associe un événement à un empaqueteur de lien et que ce dernier n'existe pas ; • lorsque cette fonction se trouve en dehors d'un fichier d'action. Exemple La fonction dreamweaver.getBehaviorElement() peut être utilisée de la même façon que « dreamweaver.getBehaviorTag() » à la page 299 afin de déterminer si l'action sélectionnée est appropriée pour la balise HTML sélectionnée. Elle s'en distingue par le fait qu'elle donne accès à plus d'informations au sujet de la balise et de ses attributs. Si vous écrivez une action qui ne peut être appliquée qu'à un lien hypertexte (A HREF) qui ne prend pas pour cible un autre cadre ou une autre fenêtre, vous pouvez utiliser la fonction getBehaviorElement(). Vous pouvez utiliser la fonction getBehaviorElement() au sein de la fonction qui initialise l'interface utilisateur pour la boîte de dialogue Paramètres. Ce principe est illustré dans l'exemple suivant : function initializeUI(){ var theTag = dreamweaver.getBehaviorElement(); var CANBEAPPLIED = (theTag.tagName == "A" && ¬ theTag.getAttribute("HREF") != null && ¬ theTag.getAttribute("TARGET") == null); if (CANBEAPPLIED) { // display the action user interface } else{ // display a helpful message that tells the user Remarque : Cette fonction peut être appelée au sein de la fonction objectTag() ou dans tout script de fichier de commande ou dans le fichier de l'inspecteur Propriétés.
Configuration/Behaviors/Actions. Ce fichier contient une action de comportement JavaScript (par exemple, « Swap Image.htm »).
"onMouseOver" et "MM_changeProp('document.moon','document.moon','src','sun.gif','MG')".
Disponibilité « dreamweaver.behaviorInspector.getSelectedBehavior() » à la page 301
Disponibilité Précharger les images et Changer la propriété de l'événement onMouseOver. Pour toute autre position, la fonction dreamweaver.behaviorInspector.moveBehaviorUp() n'a aucun effet, car un seul comportement est associé aux événements onClick et onFocus et le comportement figurant à la position 2 se trouve déjà au début du groupe onMouseDown.
« dreamweaver.behaviorInspector.getSelectedBehavior() » à la page 301
Spécifier une position à laquelle ne correspond aucune action revient à spécifier –1. Valeurs renvoyées Aucune. Exemple L'appel de la fonction dreamweaver.behaviorInspector.setSelection(2) sélectionne l'action Changer la propriété qui est associée à l'événement onMouseDown : Coupe la sélection et la place dans le Presse-papiers, avec toutes les balises HTML correspondantes. Arguments Contenu de page
{strPasteOption} Contenu de page
Ces fonctions permettent d'effectuer des opérations associées aux éléments de bibliothèque et aux modèles, telles que la création, la mise à jour et la rupture de liens entre un document et un élément de la bibliothèque ou un modèle. Les méthodes de l'objet dreamweaver.libraryPalette contrôlent ou agissent sur la sélection dans les éléments de bibliothèque du panneau Actifs, et non dans le document actif. De même, les méthodes de l'objet dreamweaver.templatePalette contrôlent ou agissent sur la sélection dans les objets de modèle du panneau Actifs.
Disponibilité Valeur booléenne qui indique si le document est un fichier LBI. Valeur booléenne qui indique si le document est un fichier DWT. Un index dans le tableau renvoyé par la fonction dom.getEditbableRegionList(). Pour plus d’informations, voir « dom.getEditableRegionList() » à la page 311. Exemple Le code suivant affiche une boîte de dialogue présentant le contenu de la région modifiable sélectionnée : var theDOM = dw.getDocumentDOM(); var edRegs = theDOM.getEditableRegionList(); var selReg = theDOM.getSelectedEditableRegion(); alert(edRegs[selReg].innerHTML);
Configuration\Snippets. Les fragments de code fournis avec Dreamweaver sont stockés dans les dossiers suivants :
• Commentaires Les fichiers de fragment de code sont des documents XML. Par conséquent, vous pouvez spécifier le codage dans la directive XML de la manière suivante : <?XML version="1.0" encoding="utf-8">
<snippet name="Detect Flash" description="VBscript to check for Flash ActiveX control" preview="code" factory="true" type="wrap" > Vous pouvez faire appel aux méthodes suivantes pour ajouter les fonctions du panneau Fragments de code à vos extensions.
Applique le fragment sélectionné dans le panneau Fragment de code à la sélection en cours. Arguments Contenu de page
Aucun. Pour affecter une valeur d'attribut contenant de la syntaxe devant être reconnue en tant que référence d'entité, vous devez créer un nœud Attr ainsi que des nœuds Text et EntityReference, créer l'arborescence secondaire appropriée et utiliser setAttributeNode afin de l'affecter en tant que valeur d'un attribut. Arguments name, value
• L'argument value est une chaîne de type DOMString correspondant à la valeur à définir pour l'attribut. Valeurs renvoyées Aucune.
• L'argument insideHead est une valeur booléenne indiquant si le bloc JavaScript doit être inséré dans la section head ou dans la section body. La valeur par défaut est true ; elle spécifie l'insertion du code dans la section head. Si la valeur est false, le code est inséré dans la section body juste avant </body>. Cet argument est facultatif. Valeurs renvoyées Aucune.
{ • L'argument referenceType est nécessaire pour que l'auteur d'extension insère une référence de fichier dans la section head. Les valeurs autorisées pour referenceType sont les suivantes :
RÉFÉRENCE DES API DE DREAMWEAVER CS4 323 Contenu de page
Valeurs renvoyées Tableau de chaînes qui s'expriment sous la forme d'URL file://. Chaque chaîne représente un fichier qui a été inclus dans la section head du document par l'intermédiaire d'un script ou d'une balise link. Exemple function objectTag() { également être utilisées dans d'autres types d'extensions (telles que des commandes). Remarque : Les valeurs que ces fonctions renvoient représentent les styles en vigueur en mode Création. Lorsque les fonctions sont utilisées dans des fichiers de problèmes dans le cadre d'une vérification de compatibilité avec les navigateurs, Dreamweaver filtre automatiquement les styles en fonction de la façon dont les navigateurs cible les traiteraient (par exemple, les styles définis à l'aide de Star HTML sont pris en compte si le navigateur cible est Internet Explorer version 6 ou ultérieure), mais ce filtrage n'est pas effectué lorsque vous utilisez les fonctions en dehors du contexte d'une vérification de compatibilité avec les navigateurs.
Disponibilité Contenu de page
Exemple var dom = dw.getDocumentDOM(); var myDiv = dom.getElementsByTagName('myDiv'); var float = myDiv.getComputedStyleProp("float"); if (float == "left") alert("This div is floated left.");
Valeurs renvoyées Un objet en lecture seule contenant des propriétés de style qui sont accessibles à partir de leur nom. Exemple var dom = dw.getDocumentDOM(); var myDiv = dom.getElementById('myDiv'); var props = window.getDeclaredStyle(myDiv); var marleft = ""; var units = ""; if (typeof(props.marginLeft) != "undefined"){ marleft = props.marginLeft; units = marleft.replace(/\d+/,""); // remove digits, leaving units alert(units); // should show %, px, pt, em, etc. } else alert("no margin-left property has been set for myDiv."); • container est l'élément contenant pour lequel une largeur minimale est requise. Valeurs renvoyées Un entier représentant la largeur d'affichage minimale du conteneur spécifié, en pixels, ou -1 n'est pas un conteneur ou si sa largeur minimale ne peut pas être déterminée. Exemple var dom = dw.getDocumentDOM(); var myDiv = dom.getElementById('myDiv'); var props = window.getComputedStyle(myDiv); var minW = dom.getMinDisplayWidth(myDiv); var setW = props.width; if (minW > setW) alert("Depending on the browser, your content will either be \n" + "clipped, or the container will expand beyond its set width."); Aucun Valeurs renvoyées Tableau de nœuds d'élément.
[...] var blocks = DOM.getBlockElements(); var dProps = null, children = null; for (var i=0; i < blocks.length; i++){ • Obtention d'une liste de toutes les sources de données dans le document de l'utilisateur • Affichage de contenu dynamique en mode Création • Application d'un comportement de serveur à un document • Obtention des noms de tous les modèles de serveur actuellement définis
Ces fonctions permettent d'accéder au nœud sélectionné dans la commande d'arborescence Composants de serveur qui apparaît dans le panneau Composants. Vous pouvez également les utiliser pour actualiser l'affichage de l'arborescence de composants.
Disponibilité PHP/MySQL. Le sous-dossier de chaque modèle contient des fichiers HTML et EDML associés aux sources de données de ce modèle de serveur. Pour plus d'informations sur l'utilisation de sources de données dans Dreamweaver, voir Sources de données dans Extension de Dreamweaver.
Disponibilité • La propriété imageFile est le chemin de fichier contenant l'icône (une image GIF) qui représente le nœud parent dans les boîtes de dialogue Données dynamiques et Texte dynamique ou dans le panneau Liaisons. La propriété imageFile est toujours définie.
Configuration/DataSources/ASP_Js, définit la propriété dataSource sur session.htm. Cette propriété est toujours définie.
Documents dynamiques
La propriété name est toujours définie, mais il peut s'agir d'une chaîne vide ("") si aucun comportement de serveur n'est associé à la source de données (tel qu'une variable de session).
Disponibilité • expanded est une valeur booléenne indiquant si le nœud du jeu de données doit être développé ou réduit. Valeurs renvoyées Aucune. Exemple dw.dbi.setExpanded(dsName, true); • En exécutant toutes les demandes de données pour le modèle de serveur en cours, l 'EDM agit comme un filtre de modèle de serveur.
Disponibilité L'exemple suivant extrait la valeur de l'attribut d'emplacement pour la balise insertText du participant recordset_main : dw.getExtDataValue("recordset_main", "insertText", "location");
• L'argument qualifier(s) est une liste, de longueur variable, de qualificateurs de nœuds ayant la propriété requise, séparés par des virgules. Valeurs renvoyées Dreamweaver attend un tableau de noms de groupes ayant la propriété requise, si elle est spécifiée, et la propriété correspondante, si elle est spécifiée.
Disponibilité Dreamweaver UltraDev 4. Vous pouvez utiliser les autres fonctions Live Data lorsque vous implémentez la fonction liveDataTranslateMarkup() pour l'API du traducteur.
Disponibilité Avant d'afficher les données dynamiques, vous devez saisir les paramètres Live Data de tout paramètre d'URL auquel le document fait référence. Cela évite que le serveur Web ne renvoie des erreurs pour des paramètres qui ne sont pas encore définis au stade de la simulation. La saisie des paramètres d'URL s'effectue par paire nom/valeur. Ainsi, si les scripts de serveur d'un document font référence aux variables d'URL ID et Name, vous devez définir ces paramètres d'URL avant d'afficher les données dynamiques. Vous pouvez saisir les paramètres Live Data depuis les endroits suivants :
• Dans le champ de texte URL qui apparaît dans la partie supérieure du document lorsque vous cliquez sur le bouton Affichage des données dynamiques, situé dans la barre d'outils. Pour les paramètres ID et Name mentionnés ci-dessus, vous pouvez saisir les paires suivantes : ID Name
• Elle analyse les données saisies par l'utilisateur. Si vous cliquez sur l'icône Arrêter, la fonction est immédiatement terminée.
• Elle envoie une requête HTTP au serveur Live Data, en utilisant les paramètres définis dans la boîte de dialogue Paramètres Live Data.
• Elle supprime le fichier temporaire du serveur Live Data. • Elle arrête la lecture du fichier d'animation. • Elle renvoie la réponse HTML à l'appelant. Arguments string
Valeurs renvoyées Objet httpReply. Cet objet est le même que la valeur renvoyée par la fonction MMHttp.getText(). Si l'utilisateur clique sur l'icône Arrêter, le code httpReply.statusCode de la valeur de retour est égal à 200 (état OK) et sa valeur httpReply.data est égale à une chaîne vide. Pour plus d'informations sur l'objet httpReply, voir « L'API HTTP » à la page 16.
Avant d'afficher les données dynamiques, vous devez saisir les paramètres Live Data de tout paramètre d'URL auquel le document fait référence. Cela évite que le serveur Web ne renvoie des erreurs pour des paramètres qui ne sont pas encore définis au stade de la simulation. La saisie des paramètres d'URL s'effectue par paire nom/valeur. Ainsi, si les scripts de serveur d'un document font référence aux variables d'URL ID et Name, vous devez définir ces paramètres d'URL avant d'afficher les données dynamiques. Cette fonction vous permet de définir les valeurs Live Data par le biais de JavaScript.
Documents dynamiques
• Obtention des valeurs par défaut du mode En direct • Obtention et définition des éléments dépendants du mode En direct • Consultation des paramètres du mode En direct
Disponibilité Aucun Valeurs renvoyées Aucun.
DOM renvoyé par la balise est du même type que dom.browser, mais il ne s'agit pas de la même instance. La fonction dom.browser n'est pas utilisable dans les commandes ; vous devez obtenir l'objet de navigateur dans le DOM. Voici un exemple de cette balise : <mm:browsercontol id="myBrowser" style="width: 500px; height:300px;" />
L'exemple suivant illustre le fonctionnement de ces événements : var browserEle = document.getElementById("myBrowser"); browserEle.addEventListener("BrowserControlBeforeNavigation", function(e){ if (e.requestedLocation = "foo.com") e.preventDefault(); //don't allow navigation to this site!}, true);
Documents dynamiques Comportements de serveur. Vous pouvez utiliser ces fonctions pour rechercher tous les comportements de serveur sur une page. Vous pouvez aussi les utiliser pour appliquer un nouveau comportement à un document ou pour modifier un comportement existant, et ce par le biais d'un programme. Remarque : Vous pouvez abréger dw.serverBehaviorInspector en dw.sbi.
Disponibilité « Comportements de serveur » dans Extension de Dreamweaver) pour repérer les instances d'un comportement dans le document utilisateur. Arguments edmlFilename
Valeurs renvoyées Cette fonction renvoie un tableau contenant toutes les instances du participant spécifié (ou, dans le cas d'un fichier groupe, une instance d'un participant dans le groupe) apparaissant dans le document utilisateur. Le tableau contient des objets JavaScript, avec un élément pour chaque instance de participant trouvée dans le document utilisateur. Le tableau est trié selon l'ordre dans lequel les participants apparaissent dans le document. Chaque objet JavaScript possède les propriétés suivantes :
• La propriété participantName est le nom du fichier EDML du participant (sans l'extension .edml). • La propriété parameters est un objet JavaScript qui stocke toutes les paires paramètre/valeur. • La propriété matchRangeMin définit le décalage de caractères à partir du nœud participant du document jusqu'au début du contenu du participant.
Si vous ne définissez pas cet argument, Dreamweaver exécute le comportement de serveur sélectionné. Si l'argument est le nom d'un comportement de serveur, Dreamweaver ajoute ce comportement à la page. Si l'argument est l'un des objets du tableau renvoyé par la fonction getServerBehaviors(), une boîte de dialogue s'affiche pour permettre à l'utilisateur de modifier les paramètres du comportement. Valeurs renvoyées Aucune.
Dans Dreamweaver, tous les documents ont un type de document associé. Pour les types de documents dynamiques, Dreamweaver associe également un modèle de serveur (tel que ASP-JS, ColdFusion ou PHP-MySQL). Les modèles de serveur sont utilisés pour regrouper une fonctionnalité spécifique à une technologie de serveur. Différents comportements de serveur, sources de données, etc., apparaissent en fonction du modèle de serveur associé au document.
Documents dynamiques
Remarque : Dreamweaver lit toutes les informations contenues dans le fichier HTML du modèle de serveur et stocke ces informations lors du premier chargement du modèle de serveur. Lorsqu'une extension appelle des fonctions telles que dom.serverModel.getServerName(), dom.serverModel.getServerLanguage() et dom.serverModel.getServerVersion(), ces fonctions renvoient les valeurs stockées.
Disponibilité • Le modèle participateInMerge est une valeur booléenne qui indique si le contenu entre les délimiteurs utilisés doit (true) ou non (false) prendre part à la fusion de blocs.
Disponibilité Remarque : Les autres valeurs définies dans les fichiers de modèles de serveur par défaut sont réservées à un usage interne. Les propriétés serverName, serverLanguage et serverVersion sont spécifiques, accessibles directement au moyen des fonctions correspondantes suivantes :
Arguments Aucun. Valeurs renvoyées Chaîne qui contient le nom du serveur. • L'argument name est une chaîne représentant le nom d'un modèle de serveur. Valeurs renvoyées Chaîne qui contient la version du modèle de serveur nommé.
• Manipulation de lignes ou de colonnes de tableau
CSS de l'inspecteur de sélections. Les méthodes de l'objet dreamweaver.cssStylePalette contrôlent ou agissent sur la sélection dans le panneau Styles CSS, et non dans le document actif.
Disponibilité • "embed" - incorporer le fichier CSS dans la section head du document. • "link" - établir un lien vers cssFileName.
Création • preventOverwrite est une valeur booléenne où true : lors de la création d'un nouveau fichier CSS, échoue si le fichier existe déjà ; false : écrase le fichier s'il existe déjà. Valeurs renvoyées Valeur booléenne : true si la mise en page a été appliquée, false dans le cas contraire. Exemple dw.getLayoutNames(); var theDOM = dw.getDocumentDOM(); alert (theDOM.canApplyLayout()); if (theDOM.canApplyLayout()) theDOM.applyLayout(1, "embed"); else alert("can't apply layout to this doc");
Valeurs renvoyées Aucune. (""), la fonction est appliquée à la sélection en cours.
Valeurs renvoyées RÉFÉRENCE DES API DE DREAMWEAVER CS4 362 Création être renvoyés. Si rien n'est précisé, seul le nom de classe est renvoyé. Par exemple, p.class1 est un sélecteur qui signifie que le style est appliqué à n'importe quelle balise p de class1, mais il ne s'applique pas, par exemple, à une balise div de class1. Sans l'argument fullSelector , la fonction dreamweaver.cssStylePalette.getSelectedStyle() renvoie uniquement le nom de classe, class1, pour le sélecteur. L'argument fullSelector ordonne à la fonction de renvoyer p.class1 au lieu de class1. Valeurs renvoyées Lorsque l'argument fullSelector a la valeur true, la fonction renvoie soit le sélecteur complet, soit une chaîne vide lorsque le nœud de la feuille de style est sélectionné. Lorsque l'argument fullSelector a la valeur false ou est ignoré, une chaîne qui représente le nom de classe du style sélectionné est renvoyée. Si le style sélectionné n'a pas de classe ou si un nœud de feuille de style est sélectionné, une chaîne vide est renvoyée.
Contours des blocs de mise en forme est activée. Si la valeur est "divs", les arguments color et width permettent de mettre en surbrillance tous les divs et autres blocs de mise en forme. Si la valeur est "selectedDiv", les arguments color et width permettent de mettre en surbrillance tout div ou bloc de mise en forme sélectionné.
• L'argument facultatif style est une chaîne qui indique le style du contour. Les valeurs possibles sont les suivantes : "SOLID", "DOTTED", "DASHED" et "OUTSET". La valeur "OUTSET" est applicable aux calques uniquement. Cet argument est ignoré lorsque la valeur de l'argument forWhat est "selectedDiv".
Aucune. Ces fonctions permettent d'aligner, de redimensionner et de déplacer des calques et des zones réactives de carte d'images. Il est indiqué, dans la description de chaque fonction, si cette dernière s'applique aux calques ou aux zones réactives.
Disponibilité • L'argument bottom est la nouvelle position de la limite inférieure du calque ou de la zone réactive. • L'argument right est la nouvelle position de la limite droite du calque ou de la zone réactive. Valeurs renvoyées Aucune. Exemple Si le calque sélectionné possède les propriétés Gauche (left), Sommet (top), Largeur (width) et Hauteur (height) indiquées, un appel à la fonction dw.getDocumentDOM().resizeSelectionBy(10,30,30,10) revient à restaurer Gauche à 40, Sommet à 20, Largeur à 240 et Hauteur à 240.
Disponibilité • L'argument yCoordinate est une valeur, exprimée en pixels, sur l'axe vertical. Valeurs renvoyées Aucune.
Création L'exemple suivant vérifie si les ID de blocs sont affichés et, si ce n'est pas le cas, les affiche :
Exemple L'exemple suivant obtient la valeur de l'échelle du mode actuel. Il effectue aussi un zoom avant, s'il le peut et si l'échelle est inférieure ou égale à 100% : if (canZoom() && dreamweaver.activeViewScale <= 1.0) { zoomIn(); }
Disponibilité • L'argument bBeforeSelection est une valeur booléenne : true indique que les lignes doivent être insérées au-dessus de celle qui contient la sélection, et false indique le contraire. Valeurs renvoyées Aucune. Activateur Voir « dom.canInsertTableRows() » à la page 468. Pour plus d'informations sur la définition de l'affichage des tabulations de tableau en mode de Mise en forme dans Dreamweaver, consultez la section « dom.setShowLayoutTableTabs() » à la page 390. Arguments bShow
Les indicateurs de code sont des menus contextuels qui s'affichent dans Adobe® Dreamweaver® CS4 lorsque vous tapez certains caractères en mode Code. Ils vous évitent de saisir tout le texte en proposant une liste de chaînes susceptibles de compléter la chaîne que vous tapez. Si la chaîne que vous tapez apparaît dans le menu, sélectionnez-la et appuyez sur Entrée ou Retour pour compléter votre saisie. Si vous tapez <, par exemple, un menu contextuel affiche une liste des noms de balises. Plutôt que de taper le reste du nom de la balise, vous pouvez la sélectionner dans le menu pour l'inclure à votre texte. Vous pouvez ajouter des menus Indicateurs de code dans Dreamweaver en les définissant dans le fichier CodeHints.xml. Pour plus d'informations sur le fichier CodeHints.xml, voir Extension de Dreamweaver. Vous pouvez également ajouter de nouveaux menus d'indicateurs de code de façon dynamique via JavaScript après chargement du contenu du fichier CodeHints.xml par Dreamweaver. Par exemple, le code JavaScript ajoute des données à la liste des variables de session dans le panneau Liaisons. Vous pouvez utiliser le même code pour ajouter un menu Indicateurs de code. Ainsi, Dreamweaver affiche un menu de variables de session lorsqu'un utilisateur tape Session en mode Code. Le fichier CodeHints.xml et l'API JavaScript contiennent un sous-ensemble utile du moteur Indicateurs de code, mais certaines fonctionnalités de Dreamweaver ne sont pas accessibles. Par exemple, comme il n'existe pas d'accroche JavaScript pouvant afficher un sélecteur de couleur, Dreamweaver ne peut pas exprimer le menu Valeurs des attributs à l'aide de JavaScript. Vous pouvez uniquement afficher un menu d'éléments de texte permettant d'insérer du texte. La coloration du code vous permet de définir des styles de couleur de code et de modifier des modèles de coloration de code ou d'en créer de nouveaux. Vous pouvez spécifier ces styles et modèles en modifiant le fichier Colors.xml et celui de modèle de coloration. Pour plus d'informations sur ces fichiers, voir Extension de Dreamweaver. L'API JavaScript pour les indicateurs et la coloration de code comprend les fonctions suivantes :
Disponibilité • L'argument facultatif valueArray est un tableau de chaînes qui doit avoir la même longueur que l'argument labelArray. Lorsqu'un utilisateur sélectionne un élément dans le menu contextuel, la chaîne de ce tableau est
• L'argument facultatif doctypes indique que le menu est actif pour certains types de documents uniquement. Vous pouvez spécifier l'argument doctypes en tant que liste d'ID de types de documents séparés par des virgules. Pour obtenir une liste des types de documents de Dreamweaver, consultez le fichier Configuration/Documenttypes/MMDocumentTypes.xml.
Les valeurs possibles de l'argument casesensitive sont les valeurs booléennes true ou false. Par défaut, la valeur est false si vous omettez cet argument. Si l'argument casesensitive a la valeur true, le menu des indicateurs de code s'affiche. Ce menu ne s'affiche que si le texte tapé par l'utilisateur correspond au modèle spécifié par l'attribut de modèle. Dans le cas où l'argument casesensitive aurait la valeur false, le menu s'affiche, même si le modèle est en minuscules et que le texte est enmajuscules.
Cet argument est facultatif.
• Un bloc de code • L'argument type sert à définir les types de menus d'interface utilisateur. Cet argument est facultatif ; sa valeur par défaut est "Enumerated drop down UI". Les autres valeurs possibles sont color, font et url.
Valeurs renvoyées Aucune. • L'argument facultatif doctypes définit que cette fonction est active pour certains types de documents uniquement. Vous pouvez spécifier l'argument doctypes en tant que liste d'ID de types de documents séparés par des virgules. Pour obtenir une liste des types de documents de Dreamweaver, consultez le fichier Configuration/Documenttypes/MMDocumentTypes.xml.
Les valeurs possibles de l'argument casesensitive sont les valeurs booléennes true ou false. Par défaut, la valeur est false si vous omettez cet argument. Si l'argument casesensitive a la valeur true, le menu des indicateurs de code s'affiche. Ce menu ne s'affiche que si le texte tapé par l'utilisateur correspond au modèle spécifié par l'attribut de modèle. Si l'argument casesensitive est false, le menu s'affiche même si le modèle est en minuscules et le texte en majuscules.
• L'argument icon définit le chemin d'accès à une icône personnalisée à utiliser dans le menu déroulant de la fonction. Cet argument est facultatif.
• Un bloc de code Valeurs renvoyées Aucune. Exemple L'exemple suivant de la fonction dw.codeHints.addFunction() ajoute le modèle de nom de fonction out.newLine() au groupe de menu d'indicateurs de code CodeHints_Object_Methods et l'active uniquement pour les documents de type JSP : dw.codeHints.addFunction( RÉFÉRENCE DES API DE DREAMWEAVER CS4 415 Code
Rechercher, cliquer sur le bouton Enregistrer la requête, ouvrir ce fichier de requête dans un éditeur de texte et copier tout ce qui est compris entre le début de la balise dwquery et la fin de la balise /dwquery. Remarque : Dans une requête, certains caractères spéciaux, tels que la barre oblique inverse (\), doivent être ignorés. Par conséquent, pour utiliser une barre oblique inverse dans une requête, vous devez écrire \\.
Remarque : Dans une requête, certains caractères spéciaux, tels que la barre oblique inverse (\), doivent être ignorés. Par conséquent, pour utiliser une barre oblique inverse dans une requête, vous devez écrire \\. Valeurs renvoyées Aucune. Exemple Dans l'exemple ci-après, la première ligne de code définit une recherche de balise et précise que la recherche doit porter sur quatre fichiers ; la deuxième ligne exécute la recherche et le remplacement. dreamweaver.setUpComplexFindReplace('<dwquery><queryparams ¬ matchcase="false" ignorewhitespace="true" useregexp="false"/>¬ • La propriété searchString est le texte à rechercher. • La propriété searchSource est une valeur booléenne indiquant si la recherche doit également porter sur le code sourceHTML.
Valeurs renvoyées Aucune. • La propriété replaceString est le texte à substituer au texte recherché. • La propriété searchSource est une valeur booléenne indiquant si la recherche doit également porter sur le code sourceHTML.
Valeurs renvoyées Aucune. • L'argument facultatif bReplaceCurrentSelection est une valeur booléenne qui indique si le contenu spécifié doit remplacer la sélection en cours. Si la valeur de l'argument bReplaceCurrentSelection est true, le contenu remplace la sélection actuelle. Si sa valeur est false, le contenu est inséré après la sélection actuelle. Valeurs renvoyées Aucune. Exemple Le code suivant insère la chaîne HTML <b>130</b> dans le document actuel : var theDOM = dw.getDocumentDOM(); theDOM.insertHTML('<b>130</b>'); Button.htm, par exemple, Dreamweaver n'est pas capable de faire la différence entre les deux.
Disponibilité • L'argument facultatif bReplaceCurrentSelection est une valeur booléenne qui indique si le contenu spécifié doit remplacer la sélection en cours. Si la valeur de l'argument bReplaceCurrentSelection est true, le contenu remplace la sélection actuelle. Si sa valeur est false, le contenu est inséré après la sélection actuelle. Valeurs renvoyées Aucune. Exemple Le code suivant insères le texte <b>130</b> dans le document actuel : var theDOM = dreamweaver.getDocumentDOM(); theDOM.insertText('<b>130</b>'); • L'argument value spécifie la valeur à définir pour l'attribut. Valeurs renvoyées Aucune.
Valeurs renvoyées Aucune. Activateur Voir « dom.canSetLinkHref() » à la page 471. • L'argument document est le DOM du document à imprimer. Pour plus d'informations sur la façon d'obtenir le DOM d'un document, voir « dreamweaver.getDocumentDOM() » à la page 254. Valeurs renvoyées Valeur booléenne, true si l'impression du code est possible, false dans le cas contraire. Exemple L'exemple suivant appelle dw.PrintCode() pour lancer la boîte de dialogue d'impression pour le document utilisateur. Si la fonction renvoie la valeur false, le code affiche un message d'alerte informant l'utilisateur qu'il n'est pas possible d'exécuter la demande d'impression. var theDOM = dreamweaver.getDocumentDOM("document"); if(!dreamweaver.PrintCode(true, theDOM)) { alert("Unable to execute your print request!"); } • L'argument bAlwaysBalance est une valeur booléenne qui indique si la sélection doit être équilibrée avant d'être enveloppée. Cet argument est facultatif.
HTML valide. Cet argument est facultatif. • la propriété numInfo, qui est le nombre de messages d'information. Exemple theDom = dw.getDocumentDOM(); theDom.runValidation(); theDom.getAutoValidationCount();
Aucun Valeurs renvoyées Valeur booléenne : true si la fenêtre Navigation dans le code est ouverte, false s'il est impossible de l'ouvrir parce que la sélection actuelle ne contient pas de cibles de navigation.
• L'argument endOffset est un nombre entier qui représente la fin du document. Valeurs renvoyées Chaîne qui représente le texte du code source compris entre les décalages start et end.
• L'argument facultatif searchDirection est une chaîne qui spécifie "empty", "forward" ou "back". Si spécifié, la fonction recherche vers la fin ou le début du document, en partant du décalage défini, les caractères comportant des erreurs et les renvoie. Si cela n'est pas spécifié, la fonction vérifie la présence d'erreur au point de décalage défini. Valeurs renvoyées Tableau d'objets ou valeur null. Chaque objet du tableau possède les propriétés suivantes :
• L'objet floaterName est une chaîne qui contient le nom de la fenêtre de résultats. Vous pouvez transmettre cette valeur aux fonctions showResults() ou setFloaterVisibility().
• L'objet start est l'index d'ouverture du code souligné. • L'objet end est l'index de fermeture du code souligné. Remarque : Les index de palette renvoyés ne doivent pas être conservés car ils varient fréquemment, par exemple, lors de l'ouverture ou de la fermeture de documents. Exemple L'exemple suivant appelle getValidationErrorsForOffset() pour vérifier qu'il n'y a pas d'erreur au décalage de la sélection actuelle. Si la fonction renvoie une erreur, le code appelle la fonction alert() pour afficher le message d'erreur à l'utilisateur. var offset = dw.getDocumentDOM().source.getSelection()[0]; var errors = dw.getDocumentDOM().source.getValidationErrorsForOffset(offset); if ( errors && errors.length > 0 ) alert( errors[0].message );
• L'argument offset est le décalage à partir du début du fichier où la chaîne doit êtreinsérée. • L'argument string est la chaîne à insérer. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument string est la chaîne à insérer. Valeurs renvoyées Valeur booléenne : true en cas de réussite, false dans le cas contraire.
• L'argument bShiftIsDown est une valeur booléenne qui indique si un contenu est sélectionné. Si bShiftIsDown a la valeur true, le contenu est sélectionné. Valeurs renvoyées RÉFÉRENCE DES API DE DREAMWEAVER CS4 457 Code
Valeurs renvoyées Aucune.
Vous pouvez utiliser les éditeurs de balises pour insérer de nouvelles balises, pour modifier des balises existantes ou pour accéder à des informations de référence sur les balises. Le sélecteur de balises permet aux utilisateurs d'organiser leurs balises afin qu'ils puissent sélectionner les balises les plus fréquemment utilisées. Les bibliothèques de balises fournies avec Dreamweaver stockent des informations concernant les balises utilisées dans les langages de balisage standard et dans les langages de script et de balise fréquemment utilisés. Vous pouvez utiliser les fonctions de l'éditeur de balises JavaScript, du sélecteur de balises, de la bibliothèque de balises lorsque vous devez utiliser les éditeurs de balises et bibliothèques de balises dans vos extensions.
Disponibilité • une balise, comme <input> ; • une balise avec des attributs, comme <input • une directive, comme <%=
Valeurs renvoyées Nom de la bibliothèque de balises importées.
• la propriété attributes, qui est un tableau de chaînes. Chaque chaîne correspond au nom d'un attribut défini pour cette balise.
Valeur booléenne, true si le style sélectionné peut être dupliqué, false dans le cas contraire.
Valeur booléenne, true si le style sélectionné est modifiable, false dans le cas contraire.
Valeur booléenne, true si le style sélectionné est modifiable, false dans le cas contraire.
Valeur booléenne, true si le style sélectionné peut être renommé, false dans le cas contraire.
• La fonction Archiver/Extraire est activée pour le site.
• si le disque dur est monté, si le type de serveur est Local/Réseau. • Valeur booléenne qui indique si les deux fenêtres contiennent des fichiers du site et si la sélection se trouve dans le volet en face de l'argument. La valeur booléenne est renvoyée si le second argument est le mot clé site.
Disponibilité • si l'argument est une URL, renvoie la valeur true si le document appartient à un site pour lequel un site distant a été défini ; renvoie la valeur false dans le cas contraire.
Disponibilité Définition de la taille 159 Définition du style 366 Données dynamiques 122 Enregistrer comme commande 135 Enregistrer comme modèle 261 Propriétés de la page 266 Rechercher 420 Remplacer 421 à propos 128 fonctions de l'éditeur de balises et de la bibliothèque de balises 458
Notice Facile