Commandes hypertexte disponibles
Cette section couvre les commandes hypertexte disponibles suivantes :
•Afficher des messages d’alerte
•Accès à une destination nommée
•Ouverture d’applications et de fichiers externes
•Fermeture de FrameMaker et des documents FrameMaker
Afficher des messages d’alerte
Vous pouvez afficher des messages d’alerte en cliquant sur une zone active à l’aide des commandes Alerte et En-tête de message d’alerte.
remarque : Dans une sortie PDF, un message d’alerte s’affiche comme une remarque sans titre.
Affiche un message d’alerte.
Syntaxe :
alert message
Exemple :
alert Bonjour le monde
Pour afficher un titre personnalisé avec le message d’alerte :
1)Ouvrez une page de référence pour le document actif (Affichage > Pages référence).
2)Positionnez une zone de texte sur la page de référence, puis saisissez le titre personnalisé dans la zone de texte.
3)Cliquez avec le bouton droit sur la zone de texte, puis sélectionnez Propriétés de l’objet pour afficher la boîte de dialogue Propriétés de zone de texte.
4)Accédez à l’onglet Zone de texte, puis établissez la valeur d’étiquette d’enchaînement à AlertTitle.
Affiche un message d’alerte avec un titre défini par l’utilisateur.
Syntaxe :
alerttitle Titre:message
Exemple :
alerttitle Message au monde : Bonjour le monde
Accès à une destination nommée
Vous pouvez accéder à une destination spécifique d’un document FrameMaker actif ou autre. Pour ce faire, utilisez la commande Spécifier la destination nommée. Pointez ensuite sur cette destination lorsque vous créez l’une des commandes suivantes :
•Aller à la destination nommée
•Aller à la destination nommée et adapter à la page
•Ouvrir document et adapter à la page
remarque : si vous omettez la commande Spécifier la destination nommée, les commandes Aller à la destination nommée et Ouvrir document n’auront aucun effet à moins qu’elles ne fassent référence à un nom de fichier. Dans ce cas, la première page de l’autre fichier s’affiche.
Spécifier la destination nommée
Spécifiez un emplacement de destination nommée.
Syntaxe :
newlink nomlien
Exemple :
newlink commandes_hypertexte_disponibles
remarque : Le nom de la destination nommée respecte la casse et ne peut pas contenir d’espaces.
Pointeur sur la destination nommée définie par Spécifier la destination nommée. Vous pouvez pointer sur une destination nommée du document FrameMaker actif ou autre.
Syntaxe :
gotolink nomfichier:nomlien
Exemple pour une destination nommée du document actif :
gotolink commandes_hypertexte_disponibles
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
gotolink commandeshypertexte.fm:commandes_hypertexte_disponibles
important : Vous devez spécifier l’extension du fichier de destination (par exemple .fm).
Aller à la destination nommée et adapter à la page
Pointeur sur la destination nommée définie par Spécifier la destination nommée. Vous pouvez pointer sur une destination nommée du document FrameMaker actif ou autre. La fenêtre est ensuite redimensionnée selon la page du document de destination.
Syntaxe :
gotolinkfitwin nomfichier:nomlien
Exemple pour une destination nommée du document actif :
gotolinkfitwin commandes_hypertexte_disponibles
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
gotolinkfitwin commandeshypertexte.fm:commandes_hypertexte_disponibles
important : Vous devez spécifier l’extension du fichier de destination (par exemple .fm).
Pointez sur la destination nommée définie par Spécifier la destination nommée. Si la destination est un document différent, il s’ouvre dans une nouvelle fenêtre.
Syntaxe :
openlink nom_fichier:nomlien
Exemple pour une destination nommée du document actif :
openlink commandes_hypertexte_disponibles
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
openlink commandeshypertexte.fm:commandes_hypertexte_disponibles
important : Vous devez spécifier l’extension du fichier de destination.
Ouvrir document et adapter à la page
Pointez sur la destination nommée définie par Spécifier la destination nommée. Si la destination est un document différent, il s’ouvre dans une nouvelle fenêtre. La nouvelle fenêtre est alors redimensionnée selon la page du document affiché.
Syntaxe :
openlink nom_fichier:nomlien
Exemple pour une destination nommée du document actif :
openlink commandes_hypertexte_disponibles
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
openlink commandeshypertexte.fm:commandes_hypertexte_disponibles
important : Vous devez spécifier l’extension du fichier de destination.
Accès à une page spécifique
Vous pouvez accéder à une page spécifique d’un document FrameMaker actif ou autre.
Accès à la première/dernière page
Pointez sur la première ou la dernière page du document actif ou d’un autre document. La page s’affiche dans la fenêtre active.
Syntaxe :
gotolink nomfichier:firstpage
gotolink nomfichier:lastpage
Exemple pour une destination nommée du document actif :
gotolink firstpage
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
gotolink commandeshypertexte.fm:lastpage
important : Vous devez spécifier l’extension du fichier de destination.
Pointez sur une page spécifique du document en cours ou d’un autre. La page s’affiche dans la fenêtre active.
Syntaxe :
gotopage nomfichier:numpage
Exemple pour une destination nommée du document actif :
gotopage 7
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
gotopage commandeshypertexte.fm:7
important : Utilisez le numéro de page réel dans le document. Ainsi, si le document de destination MonDoc utilise une numérotation romaine et commence à la page v, la commande permettant d’afficher la troisième page est open page MonDoc.fm:vii.
Accès à la page précédente/page suivante
Pointez sur la page précédente ou la page suivante du document actif. La page s’affiche dans la fenêtre active.
Syntaxe :
previouspage
nextpage
Exemple :
previouspage
nextpage
astuce : Ajoutez les commandes hypertexte de page précédente et suivante aux maquettes d’un document pour les afficher sur chacune des pages du document.
Revenir sur/à
Vous pouvez placer des commandes hypertexte sur des pages où un utilisateur peut cliquer dessus pour revenir à la page à partir de laquelle il avait atteint la page active. Ce comportement est similaire à la fonctionnalité du bouton de retour d’un navigateur Web. Par exemple, si vous avez créé une zone de texte active sur une page pour permettre à l’utilisateur d’accéder à une autre page du document. Sur la page de destination, vous pouvez placer les commandes hypertexte Revenir en arrière ou Revenir en arrière et adapter la page.
remarque : Si la pile est vide et que vous n’avez précisé ni le nom de fichier ni le nom de lien, la page courante reste affichée.
Revenez à la page précédente. La page s’affiche dans la fenêtre active.
Syntaxe :
previouslink nomfichier:nomlien
Exemple pour une destination nommée du document actif :
previouslink commandes_hypertexte_disponibles
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
previouslink commandeshypertexte.fm:commandes_hypertexte_disponibles
important : Vous devez spécifier l’extension du fichier de destination.
Revenir en arrière et adapter la page
Revenez à la page précédente. La page s’affiche dans la fenêtre active. La nouvelle fenêtre est alors redimensionnée selon la page du document affiché.
Syntaxe :
previouslinkfitwin nomfichier:nomlien
Exemple pour une destination nommée du document actif :
previouslinkfitwin commandes_hypertexte_disponibles
Exemple pour une destination nommée d’un autre document FrameMaker (.fm) :
previouslinkfitwin commandeshypertexte.fm:commandes_hypertexte_disponibles
important : Vous devez spécifier l’extension du fichier de destination.
Ouverture de documents
Vous pouvez ouvrir des documents en tant que nouveaux documents FrameMaker (Ouvrir document en tant que Nouveau), ouvrir un document à sa première ou dernière page (Ouvrir document à la première/dernière page), ou ouvrir un document sur une page particulière (Ouvrir document au numéro de page).
Ouvrir document en tant que Nouveau
Ouvre un document (défini dans l’argument de nom de fichier) en tant que nouveau document sans nom. Le document s’affiche dans une nouvelle fenêtre tandis que la fenêtre active reste ouverte.
Syntaxe :
opennew nomfichier
Exemple :
opennew commandeshypertexte.fm
important : Vous devez spécifier l’extension du fichier de destination.
Ouvrir document à la première/dernière page
Ouvre un document sur la première ou la dernière page du document. Si la page se trouve dans un autre document (et uniquement dans ce cas), elle s’affiche dans une nouvelle fenêtre tandis que la fenêtre active reste ouverte.
Syntaxe :
openlink nomfichier:firstpage
openlink nomfichier:lastpage
Exemple :
openlink commandeshypertexte.fm:firstpage
important : Vous devez spécifier l’extension du fichier de destination.
Ouvrir document au numéro de page
Ouvre un document sur une page spécifique. Si la page se trouve dans un autre document (et uniquement dans ce cas), elle s’affiche dans une nouvelle fenêtre tandis que la fenêtre active reste ouverte.
Syntaxe :
openpage nomfichier:numpage
Exemple :
openpage commandeshypertexte.fm:7
important : Vous devez spécifier l’extension du fichier de destination.
Matrice de bouton
Définit un ensemble continu de zones cliquables dans une image et associe une commande hypertexte à chacune des zones.
Par exemple, vous pouvez prendre une capture d’écran d’une barre d’outils dans une application, puis affecter une commande hypertexte à chacun des boutons de la barre d’outils. La commande hypertexte permet à l’utilisateur d’accéder à la rubrique d’aide correspondante du bouton associé sur l’image de la barre d’outils.
Syntaxe :
matrix lignes colonnes ReferencePageFlowName
Exemple :
matrix 1 3 enchaînement_matrice_boutons
lignes
Nombre de lignes de boutons
colonnes
Nombre de boutons dans une ligne
ReferencePageFlowName
Zone de texte créée sur la page de référence du document qui définit la commande hypertexte pour chaque bouton de la matrice.
Définition d’une matrice de bouton
Définissez une matrice de bouton pour mapper les trois icônes de l’image suivante à trois commandes hypertexte correspondantes :
Image d’une matrice de bouton
1)Accédez à la page de référence pour le document en cours (Affichage > Pages référence).
2)Définissez une zone de texte sur la page de référence, puis établissez la valeur d’étiquette d’enchaînement à matrice_bouton.
La valeur d’étiquette d’enchaînement permet de mapper la zone de texte de l’image (Etape 1) à la zone de texte de la page de référence.
a)Ouvrez la boîte de dialogue Propriétés de zone de texte.
Cliquez avec le bouton droit sur la zone de texte, puis sélectionnez Propriétés de l’objet.
b)Sous l’onglet Zone de texte, saisissez matrice_bouton dans le champ Balise.
3)Dans la zone de texte, entrez la commande hypertexte pour chaque matrice de boutons.
Par exemple, vous pouvez utiliser une commande Aller à la destination nommée pour permettre à l’utilisateur d’accéder à une destination nommée lorsqu’il clique sur un bouton de la matrice.
gotolink first_button_help
gotolink second_button_help
gotolink third_button_help
4)Ajoutez l’image ci-dessus à un document FrameMaker et Définissez une zone active d’image.
5)Dans la zone de texte, ajoutez la commande hypertexte de matrice de bouton suivante :
matrix 1 3 button_matrix
L’image se compose d’une ligne d’icônes et de trois colonnes. En outre, l’étiquette d’enchaînement de la zone de texte, sur la page de référence, est définie comme matrice_bouton (Etape 2).
La commande hypertexte définie sur chaque ligne de la zone de texte de la page de référence (Etape 3) correspondant à la commande à exécuter pour chaque bouton figurant sur l’image (Etape 4).
Cela signifie que pour la commande hypertexte de matrice de bouton suivante, la zone de texte de la page de référence (enchaînement_matrice_boutons) doit contenir des commandes hypertexte sur six lignes :
matrix 2 3 button_matrix_flow
6)Vous devez Spécifier la destination nommée.
7)Pour tester la matrice de bouton, dans la boîte de dialogue Hypertexte, cliquez sur Consultation seulement.
Si vous envisagez de créer une sortie PDF ou HTML pour le document FrameMaker contenant une matrice de bouton, consultez la rubrique PDF et HTML : prise en charge des commandes hypertexte.
Aller à l’URL
Lance le navigateur et affiche la page Web spécifiée.
Syntaxe :
message URL url
Exemple :
message URL http://www.adobe.com
Ouverture d’applications et de fichiers externes
La commande hypertexte permet d’ouvrir des applications et des fichiers externes.
Syntaxe :
message system nom ou chemin d’accès de l’application, état de la fenêtre
remarque : L’argument état de la fenêtre est défini à SW_SHOWNORMAL. Si vous omettez cet argument, l’application externe s’ouvre dans le dernier état quitté.
Exemple :
Pour ouvrir Microsoft Paint dans l’état de fenêtre agrandie :
message system mspaint, SW_MAXIMIZE
Exemple :
Pour ouvrir Microsoft Word dans l’état de fenêtre réduite :
message system winword, SW_MINIMIZE
Exemple :
Pour ouvrir un document PDF spécifique, spécifiez le chemin d’accès complet au document :
message system c:/documentshypertexte.pdf
Le fichier PDF s’ouvre dans l’application par défaut.
Pour spécifier l’application pour l’ouverture du fichier :
message system acrobat c:/documentshypertexte.pdf
Les exemples ci-dessus spécifient le nom de l’application. Vous pouvez également spécifier le chemin d’accès complet au fichier .exe d’application. Par exemple, si vous avez installé plusieurs versions d’une application, d’une manière générale la dernière version est celle par défaut. Vous pouvez ouvrir une version précédente en spécifiant le chemin d’accès complet au .exe pour la version.
Exemple :
Pour ouvrir une application en spécifiant le chemin d’accès complet à l’application .exe :
message système "C:\Program Files (x86)\Adobe\AdobeFrameMaker2015\FrameMaker.exe"
remarque : Utilisez des guillemets doubles si le chemin d’accès au fichier contient des espaces.
Etats de fenêtre
Le tableau suivant répertorie les options d’états de fenêtre disponibles :
1)
|
Etat |
Définition |
|---|---|
|
SW_HIDE |
Masque la fenêtre et en active une autre. |
|
SW_MAXIMIZE |
Agrandit la fenêtre spécifiée. |
|
SW_MINIMIZE |
Réduit la taille la fenêtre spécifiée et active la fenêtre suivante dans l’ordre Alt+Tab. |
|
SW_RESTORE |
Active et affiche la fenêtre. Si la fenêtre est réduite ou agrandie, Windows la restaure à sa taille et sa position d’origine. |
|
SW_SHOW |
Active la fenêtre et l’affiche à sa taille et sa position en cours. |
|
SW_SHOWDEFAULT |
Définit l’état d’affichage en fonction de la valeur de SW_ flag spécifiée dans la structure STARTUPINFO, cette dernière étant transmise à la fonction CreateProcess par le programme ayant lancé l’application. |
|
SW_SHOWMAXIMIZED |
Active la fenêtre et l’affiche à sa taille optimale. |
|
SW_SHOWMINIMIZED |
Active la fenêtre et la réduit à sa taille minimale. |
|
SW_SHOWMINNOACTIVE |
Maintient l’affichage de la fenêtre active et affiche la fenêtre à sa taille minimale. |
|
SW_SHOWNA |
Maintient l’affichage de la fenêtre active et affiche la fenêtre dans son état actuel. |
|
SW_SHOWNOACTIVATE |
Maintient l’affichage de la fenêtre active et affiche une fenêtre selon ses dernières taille et position. |
|
SW_SHOWNORMAL |
Active et affiche une fenêtre. Si la fenêtre est réduite ou agrandie, Windows la restaure à sa taille et sa position d’origine. |
Si vous omettez la valeur étatfenêtre, l’état a pour valeur SW_SHOWNORMAL. Pour plus d’informations sur les états de la fenêtre, consultez la documentation du kit de développement des logiciels Windows.
Fermeture de FrameMaker et des documents FrameMaker
Vous pouvez utiliser des commandes hypertexte pour fermer le document actif (Fermer le document en cours) et tous les documents ouverts en consultation seulement (Fermer toutes les fenêtres hypertexte). Vous pouvez également créer une commande hypertexte permettant de quitter FrameMaker (Quitter FrameMaker).
Ferme le document FrameMaker actif en cours.
Syntaxe :
quit
Fermer toutes les fenêtres hypertexte
Ferme tous les documents FrameMaker ouverts en consultation seulement.
Syntaxe :
quitall
Quitte l’instance en cours de FrameMaker.
Syntaxe :
exit