titre_site.jpg (51607 octets)

Class Editor

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.

evaltag.jpg (107190 octets)

 

    vdb5.gif (351 octets) Description

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


Plus2_5-Icon.jpg (1250 octets) Les balises HTML supportées

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   vdb5.gif (351 octets)   Plus2_5-Icon.jpg (1250 octets)

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

 

ico_duflp.gif (1875 octets) dUFLP :

(en cours de recherche)

 

bug_jpg.jpg (2635 octets)  Les difficultées rencontrées :   /  Les problèmes connus :     / A surveiller  / Bien comprendre

RAS

 
 

retour

Sources :

Aide Visual dbase V5.7
Aide dBase Plus 2.6.0

 

Balises HTML acceptées :

From: "Marty Kay"
Subject: Re: Editor controls
Date: Thu, 3 Nov 2011 11:37:31 -0400
Newsgroups: dbase.how-to

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.