Mode d'emploi MACROMEDIA DREAMWEAVER MX 2004 GUIDE DES API DE DREAMWEAVER

[. . . ] Guide des API de Dreamweaver Marques commerciales Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware, Authorware Star, Backstage, Bright Tiger, Clustercats, Cold Fusion, Contribute, Design in Motion, Director, Dream Templates, Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, Generator, HomeSite, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Flash, Macromedia M Logo & Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel, Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic, Open Sesame!, Roundtrip HTML, Shockwave, Sitespring, SoundEdit, Titlemaker, UltraDev, Web Design 101, what the web can be et Xtra sont des marques commerciales ou des marques déposées de Macromedia, Inc. aux Etats-Unis ou dans d'autres juridictions ou pays. Les autres noms de produit, logos, concepts, titres, mots ou phrases mentionnés dans cette publication peuvent être des marques commerciales, des marques de service ou des noms commerciaux de Macromedia, Inc. ou d'autres entités et peuvent être déposés dans certaines juridictions ou certains pays. [. . . ] below affiche la barre d'outils au début de la ligne qui se trouve juste en dessous de la barre d'outils spécifiée dans l'argument relative_to. Dreamweaver indique une erreur si la barre d'outils ne trouve pas la barre d'outils spécifiée dans l'argument relative_to. floating affiche la barre d'outils au-dessus du document, en mode flottant. Dreamweaver place automatiquement la barre d'outils de sorte qu'elle soit décalée par rapport aux autres barres d'outils flottantes. Sur Macintosh, floating est traité de la même façon que top. relative_to="toolbar_id" est obligatoire lorsque l'argument position est défini sur la valeur 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 : dom. setToolbarPosition("myEditbar", "below", "myPicturebar"); dom. setToolbarVisibility() Disponibilité Dreamweaver MX. Description Cette fonction affiche ou masque la barre d'outils spécifiée. Arguments toolbar_id, bShow · L'argument toolbar_id est l'ID de la barre d'outils, qui correspond à la valeur de l'attribut ID · de la balise toolbar définie dans le fichier toolbars. xml. L'argument bShow est une valeur booléenne qui indique si la barre d'outils doit être affichée ou masquée. Si bShow a pour valeur true, la fonction dom. setToolbarVisibility() rend la barre d'outils visible. Si bShow a pour valeur false, la fonction dom. setToolbarVisibility() rend la barre d'outils invisible. Valeurs renvoyées Aucune. 208 Chapitre 12 : Espace de travail Exemple L'exemple suivant vérifie si la barre d'outils myEditbar est visible dans la fenêtre de document. Si ce n'est pas le cas, il l'affiche : var dom = dw. getDocumentDOM(); if(dom != null && dom. getToolbarVisibility("myEditbar") == false) { dom. setToolbarVisibility("myEditbar", true); { Fonctions relatives aux fenêtres Ces fonctions permettent d'agir sur la fenêtre de document et sur les panneaux flottants. Elles permettent d'afficher et de masquer les panneaux flottants, de déterminer la partie active de la fenêtre de document et de définir le document actif. Pour les opérations relatives au panneau Site, voir Fonctions relatives aux sites, page 222. Remarque : Certaines fonctions de cette section fonctionnent uniquement sous Windows. Leur description indique si tel est le cas. dom. getFocus() Disponibilité Dreamweaver 3. Description Cette fonction détermine quelle partie du document est actuellement active. Arguments Aucun. Valeurs renvoyées L'une des chaînes suivantes : · · · · la chaîne "head" si la zone HEAD est active ; la chaîne "body" si la zone BODY ou NOFRAMES est active ; la chaîne "frameset" si un jeu de cadres ou l'un des cadres qui le composent est sélectionné ; la chaîne "none" si la zone active ne figure pas dans le document (si elle se trouve dans l'inspecteur de propriétés ou dans un autre panneau flottant, par exemple). dom. getView() Disponibilité Dreamweaver 4. Description Cette fonction détermine quel mode est visible. Arguments Aucun. Fonctions relatives aux fenêtres 209 Valeurs renvoyées "design", "code" ou "split", selon le mode d'affichage visible. dom. getWindowTitle() Disponibilité Dreamweaver 3. Description Cette fonction obtient le titre de la fenêtre contenant le document. Arguments Aucun. Valeurs renvoyées Chaîne contenant le texte qui apparaît entre les balises TITLE du document, ou rien si le document ne figure pas dans une fenêtre ouverte. dom. setView() Disponibilité Dreamweaver 4. Description Cette fonction affiche ou masque le mode Création ou Code pour produire un affichage contenant uniquement le mode Création ou Code ou les deux. Arguments viewString · L'argument viewString correspond au mode à afficher ; il doit avoir l'une des valeurs suivantes : "design", "code" ou "split". Valeurs renvoyées Aucune. dreamweaver. bringAttentionToFloater() Disponibilité Dreamweaver MX. Description Place au premier plan le panneau ou l'inspecteur spécifié et attire l'attention sur cet élément en le faisant clignoter (fonctionnalité légèrement différente de dw. toggleFloater()). Arguments floaterName · L'argument floaterName correspond au nom de la fenêtre, du panneau ou de l'inspecteur. 210 Chapitre 12 : Espace de travail Valeurs renvoyées Aucune. Exemple L'exemple suivant ouvre le panneau Actifs et le fait clignoter : dw. bringAttentionToFloater("library"); dreamweaver. cascade() Disponibilité Dreamweaver MX (sous Windows uniquement). Description Affiche en cascade les fenêtres de document en commençant dans l'angle supérieur gauche et en décalant légèrement chaque fenêtre par rapport à la précédente. Arguments Aucun. Valeurs renvoyées Aucune. Exemple L'exemple suivant affiche les documents ouverts en cascade : dw. cascade() dreamweaver. getActiveWindow() Disponibilité Dreamweaver 3. Description Cette fonction obtient le document figurant dans la fenêtre active. Arguments Aucun. Valeurs renvoyées Objet document correspondant au document qui figure dans la fenêtre active ou, si le document figure dans un cadre, objet document correspondant au jeu de cadres. dreamweaver. getDocumentList() Disponibilité Dreamweaver 3. Fonctions relatives aux fenêtres 211 Description Cette fonction obtient la liste de tous les documents ouverts. Arguments Aucun. Valeurs renvoyées Tableau d'objets document, chacun correspondant à une fenêtre de document ouverte. Si une fenêtre de document contient un jeu de cadres, l'objet document désigne le jeu de cadres et non le contenu des cadres. dreamweaver. getFloaterVisibility() Disponibilité Dreamweaver 3. Description Cette fonction vérifie si le panneau ou l'inspecteur spécifié est visible. Arguments floaterName · L'argument floaterName est le nom du panneau flottant. Si floaterName ne correspond à aucun nom de panneau intégré, Dreamweaver recherche dans le dossier Configuration/Floaters un fichier appelé floaterName. htm dans lequel floaterName correspond au nom d'un panneau flottant. Les valeurs de floaterName pour les panneaux Dreamweaver intégrés sont les chaînes se trouvant à droite des noms de panneaux dans la liste suivante : Actifs = "assets" Comportements = "behaviors" Inspecteur de code = "html" Composants = "server components" Styles CSS = "css styles" Liaisons = "data sources" Cadres = "frames" Historique = "history" Styles HTML = "html styles" Barre Insérer = "objects" Calques = "layers" Bibliothèque = "library" Vérificateur de lien (Résultats) = "linkchecker" Propriétés = "properties" 212 Chapitre 12 : Espace de travail Référence = "reference" Rapports (Résultats) = "reports" Recherche (Résultats) = "search" Comportements de serveur = "server behaviors" Site = "site" Fichiers du site = "site files" Carte du site = "site map" Fragments de code = "snippets" Inspecteur de balises = "tag inspector" Vérification du navigateur cible (Résultats) = "btc" Modèles = "templates" Validation (Résultats) = "validation" Valeurs renvoyées Une valeur booléenne : true si le panneau flottant est visible et se trouve au premier plan, false si ce n'est pas le cas ou que Dreamweaver ne trouve pas de panneau flottant nommé floaterName. dreamweaver. getFocus() Disponibilité Dreamweaver 4. Description Cette fonction détermine la partie de l'application actuellement active. Arguments bAllowFloaters · L'argument bAllowFloaters est une valeur booléenne : true si la fonction doit renvoyer le nom du panneau flottant (si un panneau flottant est actif ) et false dans le cas contraire. Valeurs renvoyées L'une des chaînes suivantes : · · · · · La chaîne "document" si la fenêtre de document est active ; La chaîne "site" si le panneau Site est actif ; La chaîne "textView" si le mode Texte est actif ; La chaîne "html" si l'inspecteur de code est actif ; La chaîne floaterName si bAllowFloaters a pour valeur true et si un panneau flottant est actif, floaterName correspondant à "objects", "properties", "launcher", "library", "css styles", "html styles", "behaviors", "timelines", "layers", "frames", "templates" ou "history" ; Fonctions relatives aux fenêtres 213 · La chaîne "none" (Macintosh) si aucune fenêtre de document ni le panneau Site ne sont ouverts. [. . . ] dreamweaver. resultsPalette. canSelectAll() Disponibilité Dreamweaver MX. Description Vérifie si un message Sélectionner tout peut être transmis à la fenêtre active. Arguments Aucun. Valeurs renvoyées Une valeur booléenne : true, si le message Sélectionner tout peut être transmis ; false dans le cas contraire. dreamweaver. snippetpalette. canEditSnippet() Disponibilité Dreamweaver MX. Activateurs 451 Description Vérifie si vous pouvez modifier l'élément sélectionné et renvoie la valeur true ou la valeur false pour vous permettre d'activer ou de désactiver les éléments de menu destinés à l'édition. Arguments Aucun. Valeurs renvoyées Une valeur booléenne : true si vous pouvez modifier l'élément sélectionné ; false dans le cas contraire. dreamweaver. snippetpalette. canInsert() Disponibilité Dreamweaver MX. Description Vérifie si vous pouvez insérer ou appliquer l'élément sélectionné et renvoie la valeur true ou la valeur false pour vous permettre d'activer ou de désactiver les éléments de menu destinés à l'insertion ou à l'application. Arguments Aucun. Valeurs renvoyées Une valeur booléenne : true si vous pouvez insérer ou appliquer l'élément sélectionné ; false dans le cas contraire. site. browseDocument() Disponibilité Dreamweaver 4. Description Ouvre tous les documents sélectionnés dans une fenêtre de navigateur. [. . . ]