L'éditeur est un outil qui permet à l'utilisateur de visualiser et de modifier un fichier texte ou un champ Mémo. Dans les dernières versions il est possible d'apporter un formatage à l'aide de balises HTML simples. Pour savoir si votre version le supporte, il suffit de vérifier l'existence de la propriété evalTags dans l'inspecteur.
|
Un objet éditeur permet d'effectuer l'édition de texte dans un
formulaire et laisse les utilisateurs visualiser et modifier le contenu de fichiers texte,
de champs Mémo ou de champs Caractère.
La propriété DataLink permet de spécifier le fichier texte ou le champ Mémo auquel
accéder. Pour accéder à un fichier texte, il faut utiliser le mot réservé FILE, par
exemple :
"FILE MONTEXT.TXT"
Pour accéder à un champ Mémo ou à un champ Caractère, on utilise le nom du champ et
l'alias de la table le contenant.
On détermine les dimensions de l'objet éditeur avec la clause FROM...TO de la commande
DEFINE ou avec les propriétés Height et Width. Les barres de défilement permettent à
l'utilisateur de se déplacer horizontalement et verticalement dans l'affichage lorsque le
contenu dépasse les dimensions de l'objet éditeur.
Pour placer l'objet éditeur dans le formulaire , on utilise les propriétés Top et Left.
Deux paramètres peuvent être spécifiés lors de la création d'un objet éditeur avec
l'opérateur NEW :
<référence au formulaire parent>--Une référence d'objet
pointant sur le formulaire parent.
<nom d'objet expC>--Une chaîne de caractères affectée à la
propriété Name du nouvel objet éditeur. Cette valeur est facultative.
Par exemple, pour créer un formulaire contenant un objet éditeur :
MyForm = NEW FORM( )
MyEdit = NEW EDITOR(MyForm, "MonEdit")
La propriété Name du nouvel objet éditeur contient "MonEdit".
Propriétés
Le tableau suivant énumère les propriétés de la classe objet Editor. Pour plus
d'informations sur chaque propriété, voir l'aide en ligne.
Propriété Méthode Evènement |
Valeur par défaut |
Description |
Before |
N/D |
Spécifie quel objet est précédé par l'objet éditeur dans l'ordre de tabulation du formulaire parent |
Border |
.F. |
Détermine si l'objet éditeur est entouré d'une bordure |
ClassName |
EDITOR |
Identifie la classe de l'objet éditeur |
ColorNormal |
WindowText/Window |
Définit la couleur de l'objet éditeur |
Copy( ) |
N/D |
Copie le texte sélectionné dans le Presse-papiers Windows |
Cut( ) |
N/D |
Coupe le texte sélectionné et le place dans le Presse-papiers Windows |
CUATab |
.T. |
Détermine le comportement du curseur lorsqu'on appuie sur la touche Tab |
DataLink |
Chaîne vide |
Associe l'objet éditeur à un fichier texte, à un champ Mémo ou à un champ Caractère |
Enabled |
.T. |
Détermine si l'objet éditeur peut être sélectionné |
FontBold |
.T. |
Détermine si les caractères sont affichés en gras |
FontItalic |
.F. |
Détermine si les caractères sont affichés en italique |
FontName |
MS Sans Serif |
Spécifie la fonte à employer pour les caractères affichés |
FontSize |
N/D |
Spécifie, exprimée en points, la taille de la fonte |
FontStrikeOut |
.F. |
Détermine si le texte affiché est barré |
FontUnderline |
.F. |
Détermine si le texte affiché est souligné |
Height |
N/D |
Définit la hauteur |
HelpFile |
Chaîne vide |
Identifie un fichier d'aide Windows (.HLP) contenant des rubriques d'aide contextuelle |
HelpID |
Chaîne vide |
Spécifie l'identifiant contextuel ou le mot clé d'une rubrique d'aide Windows |
hWnd |
N/D |
Renvoie le descripteur de l'objet éditeur |
ID |
-1 |
Identifie l'objet éditeur avec une valeur numérique |
Keyboard( ) |
N/D |
Transmet une chaîne de caractères à l'objet éditeur, ce qui a pour effet de simuler une saisie utilisateur |
Left |
N/D |
Définit la position du bord gauche |
LineNo |
1 |
Définit la ligne en cours dans l'objet éditeur |
Modify |
.T. |
Détermine si l'utilisateur peut modifier les données dans l'objet éditeur |
MousePointer |
0 |
Spécifie le type de pointeur de souris lorsque le pointeur se trouve sur l'objet éditeur |
Move( ) |
N/D |
Déplace ou redimensionne l'objet éditeur |
Name |
EDITEUR1 |
Spécifie le nom de l'objet éditeur |
OnChange |
N/D |
Exécute un sous-programme lorsque l'utilisateur modifie le texte dans l'objet éditeur |
OnDesignOpen |
N/D |
Exécute un sous-programme lorsqu'un formulaire ou un contrôle est ouvert depuis le concepteur de formulaire. |
OnGotFocus |
N/D |
Exécute un sous-programme lorsque l'objet éditeur reçoit la focalisation |
OnHelp |
N/D |
Exécute un sous-programme lorsque l'utilisateur appuie sur F1 |
OnLeftDblClick |
N/D |
Exécute un sous-programme lorsque l'utilisateur double-clique sur l'objet éditeur |
OnLeftMouseDown |
N/D |
Exécute un sous-programme lorsque l'utilisateur clique avec le bouton gauche de la souris sur l'objet éditeur |
OnLeftMouseUp |
N/D |
Exécute un sous-programme lorsque l'utilisateur relâche le bouton gauche de la souris alors que le pointeur est sur l'objet éditeur |
OnLostFocus |
N/D |
Exécute un sous-programme lorsque la focalisation est perdue |
OnMiddleDblClick |
N/D |
Exécute un sous-programme lorsque l'utilisateur double-clique sur l'objet éditeur avec le bouton du milieu de la souris |
OnMiddleMouseDown |
N/D |
Exécute un sous-programme lorsque l'utilisateur clique sur l'objet éditeur avec le bouton du milieu de la souris |
OnMiddleMouseUp |
N/D |
Exécute un sous-programme lorsque l'utilisateur relâche le bouton du milieu de la souris alors que le pointeur est sur l'objet éditeur |
OnMouseMove |
N/D |
Exécute un sous-programme lorsque l'utilisateur déplace le pointeur de la souris au-dessus de l'objet éditeur |
OnOpen |
N/D |
Exécute un sous-programme lorsque le formulaire parent est ouvert |
OnRightDblClick |
N/D |
Exécute un sous-programme lorsque l'utilisateur double-clique sur l'objet éditeur avec le bouton droit de la souris |
OnRightMouseDown |
N/D |
Exécute un sous-programme lorsque l'utilisateur clique sur l'objet éditeur avec le bouton droit de la souris |
OnRightMouseUp |
N/D |
Exécute un sous-programme lorsque l'utilisateur relâche le bouton droit de la souris alors que le pointeur est sur l'objet éditeur |
PageNo |
N/D |
Dans un formulaire composé de plusieurs pages, spécifie la page sur laquelle l'objet éditeur apparaît |
Parent |
N/D |
Une référence d'objet pointant sur le formulaire parent |
Paste( ) |
N/D |
Copie le texte du Presse-papiers Windows à la position en cours du curseur |
Release( ) |
N/D |
Efface de la mémoire la définition de l'objet éditeur |
Scrollbar |
1 (On) |
Détermine si l'objet éditeur dispose d'une barre de défilement |
SetFocus( ) |
N/D |
Donne la focalisation à l'objet éditeur |
StatusMessage |
Chaîne vide |
Spécifie un message à afficher dans la barre d'état quand l'objet éditeur détient la focalisation |
TabStop |
.T. |
Détermine si l'utilisateur peut donner la focalisation à l'objet éditeur en appuyant sur Tab ou sur Maj+Tab |
Top |
N/D |
Définit la position de la bordure supérieure |
Undo( ) |
N/D |
Annule l'effet de la dernière action Cut( ), Copy( ) ou Paste( ) |
Valid |
N/D |
Spécifie une condition devant être vraiepour que l'utilisateur puisse retirer la focalisation à l'objet éditeur |
Value |
Chaîne vide |
Détermine le contenu de l'objet éditeur |
Visible |
.T. |
Détermine si l'objet éditeur est visible ou caché |
When |
N/D |
Spécifie une condition devant être vraie pour que l'utilisateur puisse donner la focalisation à l'objet éditeur |
Width |
N/D |
Définit la largeur |
Wrap |
.F. |
Détermine si l'objet éditeur fait passer automatiquement le texte à la ligne |
|
Depuis ses dernières versions, le composant Éditeur comprend et affiche les balises de base de formatage HTML. Par contre à ce jour, octobre 2011, la liste des balises acceptées ne figure pas dans l'aide. Voici celles qui sont acceptées
Tag
Description
------------ ------------------
br LineBreakTag
p ParagraphTag
font FontTag
i ItalicTag
b BoldTag
u UnderlineTag
h1 Header1Tag
h2 Header2Tag
h3 Header3Tag
h4 Header4Tag
h5 Header5Tag
h6 Header6Tag
img ImgTag
a AnchorTag
strong StrongTag
em EmTag
big BigTag
small SmallTag
cite CiteTag
address AddressTag
strike StrikeoutTag
tt TypewriterTag
code CodeTag
sub SubscriptTag
sup SuperscriptTag
blockquote BlockQuoteTag
ul UnorderedListTag
ol OrderedListTag
li ListItemTag
pre PreformattedTag
font color FontColorTag
font size FontSizeTag
font face FontFaceTag
a href HyperLinkTag
a name InternalAnchorTag
p align ParaAlignTag
h1 align Header1AlignTag
h2 align Header2AlignTag
h3 align Header3AlignTag
h4 align Header4AlignTag
h5 align Header5AlignTag
h6 align Header6AlignTag
img src ImgSrcTag
img width ImgWidthTag
img height ImgHeightTag
img align ImgAlignTag
img border ImgBorderTag
img alt ImgAltTag
img hspace ImgHorzSpace
img vspace ImgVertSpace
Code
|
Dans l'exemple suivant, on définit un formulaire doté d'un objet Table contenant les champs C_SOCIETE et CONTACT de la table CONTACT, le champ Mémo associé est affiché à droite dans un objet éditeur. Les boutons Précédent et Suivant déplacent le pointeur d'enregistrement en avant ou en arrière, et le bouton Fermer propose à l'utilisateur un autre moyen de fermer le formulaire :
| LOCAL f f=NEW EntryForm() f.OPEN() CLASS EntryForm OF FORM this.Top=2 this.Left=2 this.Width=72 this.Height=20 this.View = "Contact.DBF" this.Text= "Modifiez comme demandé" DEFINE BROWSE Br1 OF THIS; PROPERTY; Top 4,; Left 3,; Width 32,; Height 12 DEFINE TEXT Text1 OF THIS; PROPERTY; Text "Table des contacts",; Width 72,; Top 1,; Left 0,; Alignment 1,; Height 2.50,; FontBold .T.,; FontSize 14.00,; ColorNormal "R/W" DEFINE EDITOR ED1 OF THIS; PROPERTY; Top 4,; Left 37,; Width 32,; Height 12,; DataLink "CONTACT->NOTES" DEFINE PUSHBUTTON Back OF THIS; PROPERTY Text "Préc.", Height 2,; Top 17, Left 22,; OnClick {;SKIP-1}, FontBold .T. DEFINE PUSHBUTTON Next OF THIS; PROPERTY TEXT "Suivant", Height 2,; Top 17, Left 32,; OnClick {;SKIP}, FontBold .T. DEFINE PUSHBUTTON Exit OF THIS; PROPERTY Text "Fermer", Height 2,; Top 17, Left 42,; OnClick {;Form.Close( )}, FontBold .T. ENDCLASS //Code issu de l'aide de Vdb5.7 |
|
(en cours de recherche)
|
RAS
Sources :
Aide Visual dbase V5.7
Aide dBase Plus 2.6.0
| Balises HTML acceptées : From: "Marty
Kay" |
Retour à l'accueil
Les informations de cette page sont données à titre indicatif et ne se substituent pas à celles contenues dans l'Aide de votre version de dBase qui reste la meilleure documentation.
Si vous voyez des erreurs, ou souhaitez apporter des compléments, n'hésitez pas à le signaler.
Dernière modification : mercredi 09 novembre 2011
© M.Abraham.
Les
difficultées rencontrées : / Les problèmes connus :
/ A surveiller / Bien comprendre