Afficher/Modifier modèles

Utilisez cette commande pour afficher la boîte de dialogue Modifier des modèles.  Un modèle est un texte prédéfini qui peut être automatiquement rappelé pour être inséré dans un fichier.  Le menu déroulant Groupe de modèles permet de sélectionner les modèles qui seront répertoriés dans le volet Modèles.  

 

Les modèles s'organisent en trois groupes : globaux, d'environnements et de langues. Les modèles globaux sont toujours disponibles ; les modèles d'environnements ne sont disponibles que lorsque l'environnement auquel ils sont associés est chargé ; les modèles de langues sont associés aux langues spécifiées pour la coloration syntaxique et ne sont disponibles que lors de l'édition de fichiers dont l'extension correspond à la langue spécifiée.

 

Vous pouvez définir un nombre illimité de modèles. Chacun des 20 premiers modèles globaux peut être rappelé au moyen des touches de raccourci Alt+0 à Alt+9, puis Maj+Alt+0 à Maj+Alt+9. Tout autre modèle peut être rappelé au moyen de la boîte de dialogue Insertion d'un modèle ou de touches de raccourci définies par l'utilisateur.

 

Si besoin est, chaque modèle peut être associé à un nom. Dans l'affirmative, ce nom s'affichera dans les info-bulles de la barre d'outils ainsi que dans la liste des modèles lors de l'insertion d'un modèle.

En cas d'utilisation de l'environnement par défaut, les modèles globaux sont enregistrés dans le fichier UETMPLTE.DAT dans le répertoire par défaut ou dans le répertoire spécifié sous la branche Répertoires, sous configuration, dans le menu Avancé. Les environnements intégrés ainsi que les environnements définis par l'utilisateur enregistrent les modèles de type environnement dans un fichier relatif à l'environnement spécifié, consigné dans le répertoire de ce dernier. Les modèles de langues sont enregistrés dans le répertoire par défaut des fichiers de mots, selon les langues spécifiées dans ces derniers auxquelles ils sont associés.

Variables génériques

 

À l'aide de la syntaxe [+VariableName+], l'utilisateur peut définir des variables "génériques" dans un modèle. Lorsque le modèle est inséré, le mode d'édition met ces variables génériques en surbrillance. L'utilisateur peut alors renommer les valeurs qui s'y trouvent. Toutes les occurrences des variables correspondantes sont alors mises à jour.  Activer la touche de retrait (Tab) permet d'activer les variables une à une. Par exemple, si l'utilisateur insère le modèle 

 

// function [+function+]

[+scope+] function [+function+] () {

  ^

}

 

et tape "maFonc" pour la variable [+function+] et "prive" pour la variable [+scope+], le résultat suivant s'affiche :

 

// function maFonc

privé function maFonc () {

  ^ <-- Le signe d'insertion clignote ici.

}

 

Activer la touche Echap ou Entrée permet d'insérer le modèle dans le document actif de façon permanente. Le mode d'édition de modèle n'est plus actif.

 

Un modèle peut contenir des chaînes de caractères spéciales qui sont traduites au moment de l'appel du modèle. Ces chaînes de caractères spéciales sont :

 

[DATE_DMY]	Traduit la date courante avec le format JOUR/MOIS/ANNEE.
[DATE_MDY]	Traduit la date courante avec le format MOIS/JOUR/ANNEE.
[DATE_TEXT]	Traduit la date courante avec la date affichée en tant que texte.
[TIME]	Traduit l'heure courante avec le format 24 HEURES.
^	Indique la position à laquelle le curseur doit être placé après que le modèle a été inséré.
[FULL_FILE_NAME]	Traduit le nom du fichier du document actif avec le chemin complet.
[FILE_PATH]	Traduit l'unité de lecteur et le chmein du document actif.
[FILE_NAME]	Traduit le nom de fichier racine du document actif.
[FILE_EXTENSION]	Traduit l'extension de fichier du document actif.
[FILE_EXTENSION_NP]	Traduit l'extension de fichier du document actif sans le "point', par exemple "txt".
[$REPLACE$]	est remplacé par le texte sélectionné dans le document actif.  La sélection sera convertie en majuscules lorsqu'elle est insérée dans le modèle.
[$replace$]	est remplacé par le texte sélectionné dans le document actif.  La casse du texte sélectionné ne sera pas modifiée lors de l'insertion du texte dans le modèle.

 

Remarque - ^ réfère au caractère '^' NON à la touche CTRL + valeur.

 

De plus, pour un formatage étendu de la date et de l'heure, UltraEdit supporte les fonctionnalités supplémentaires suivantes :

 

Heure

Pour spécifier L'HEURE UTILISATEUR, utilisez la syntaxe suivante dans votre modèle :

 

Pour une heure locale, utilisez les marques suivantes :

[TIME_USER]…ici la chaîne de l'heure formatée…[TIME_USER_END]

 

Pour une heure système, utilisez les marques suivantes :

[TIME_USER_SYS]…ici la chaîne de l'heure formatée…[TIME_USER_SYS_END]

 

Le format de la chaîne de l'heure se définit comme suit :

 

Si vous utilisez des espaces pour séparer les éléments dans la chaîne formatée, ces espaces apparaîtront à la même position dans le modèle. Les lettres doivent être en majuscules ou en minuscules comme présenté (par exemple, "ss", et non "SS"). Les caractères dans la chaîne formatée entourés d'une apostrophe apparaîtront à la même position et inchangés dans le modèle.

 

Chaîne	Signification
h	Heures sans le zéro précédent les heures contenant un chiffre unique; format 12-heures
hh	Heures avec le zéro précédent les heures contenant un chiffre unique; format 12-heures
H	Heures sans le zéro précédent les heures contenant un chiffre unique; format 24-heures
HH	Heures avec le zéro précédent les heures contenant un chiffre unique; format 24-heures
m	Minutes sans le zéro précédent les minutes contenant un chiffre unique
mm	Minutes avec le zéro précédent les minutes contenant un chiffre unique
s	Secondes sans le zéro précédent les secondes contenant un chiffre unique
ss	Secondes avec le zéro précédent les secondes contenant un chiffre unique
t	Un marqueur de temps sur un caractère, tel que A ou P
tt	Un marquer de temps sur plusieurs caractères, tel que AM ou PM

 

Par exemple, pour obtenir la chaîne 

 

"11:29:40 PM"

 

utilisez le format :

 

"hh':'mm':'ss tt"

 

Cette chaîne DOIT être entre des marqueurs, par exemple :

 

[TIME_USER]hh':'mm':'ss tt[TIME_USER_END]

 

Date

Pour spécifier LA DATE UTILISATEUR, utilisez la syntaxe suivante dans votre modèle :

 

Pour une date locale, utilisez les marques suivantes :

[DATE_USER]…ici la chaîne de l'heure formatée…[DATE_USER_END]

 

Pour une date système, utilisez les marques suivantes :

[DATE_USER_SYS…ici la chaîne de l'heure formatée…[DATE_USER_SYS_END]

 

Le format de la chaîne de la date se définit comme suit :

 

Si vous utilisez des espaces pour séparer les éléments dans la chaîne formatée, ces espaces apparaîtront à la même position dans le modèle. Les lettres doivent être en majuscules ou en minuscules comme présenté (par exemple, "MM", et non "mm"). Les caractères dans la chaîne formatée entourés d'une apostrophe apparaîtront à la même position et inchangés dans le modèle.

 

Chaîne	Signification
d	Jour du mois en numéraire sans le zéro devant si le numéro est composé que d'un seul chiffre
dd	Jour du mois en numéraire avec un zéro devant si le numéro est composé que d'un seul chiffre
ddd	Jour de la semaine abrégé en 3 lettres
dddd	Jour de la semaine avec son nom complet
M	Mois en numéraire sans le zéro devant si le numéro est composé que d'un seul chiffre
MM	Mois en numéraire avec un zéro devant si le numéro est composé que d'un seul chiffre
MMM	Mois abrégé en 3 lettres
MMMM	Mois avec son nom complet
y	Année en 2 chiffres et sans zéro devant si les années sont inférieures à 10
yy	Année en 2 chiffres et avec un zéro devant si les années sont inférieures à 10
yyyy	Année représentée par ses 4 chiffres

 

Par exemple, pour obtenir la chaîne :

 

"Mer, Aou 31 94"

 

utilisez le format :

 

"ddd',' MMM dd yy"

 

Cette chaîne DOIT être entre des marqueurs, par exemple :

 

[DATE_USER]ddd',' MMM dd yy[DATE_USER_END]  

 

Insertion de modèle

Si l'option Suggestion automatique de modèle intelligent en cours de saisie est activée, sous Avancé -> Configuration -> Modèles, et si l'utilisateur s'interrompt au cours de la saisie d'une chaîne correspondant à un nom de modèle défini, UltraEdit "suggère" un modèle en fonction des derniers caractères saisis. L'utilisateur peut alors appuyer sur la touche de retrait (Tab) afin d'insérer le modèle suggéré.

 

Par exemple, si l'utilisateur dispose d'un modèle C/C++ nommé "vide", et s'il édite un fichier *.cpp, tape "vide" puis s'interrompt brièvement, UltraEdit insère automatiquement le modèle "vide" selon un mode de "suggestion" spécial.  Pour achever l'insertion du modèle, l'utilisateur doit alors appuyer sur la touche de retrait (Tab).  Le délai qui s'écoule avant que l'utilisateur puisse voir un modèle suggéré se définit dans le champ "après une interruption de" sous Avancé -> Configuration -> Modèles.

 

Pendant l'édition, l'utilisateur peut également appuyer sur Ctrl+Espace pour appeler la boîte de dialogue de remplissage automatique. Tout modèle défini dont le nom correspond à la chaîne placée en regard du signe d'insertion sera alors également répertorié dans la boîte de dialogue de remplissage automatique.  L'utilisateur peut y choisir un modèle et l'insérer le cas échéant.