- Qu'est-ce qu'un élément ?
- Manipulation d'un élément
- Manipulation d'un élément de 2° niveau
- Cas particuliers : Rubriques de fichier de données ou de requête
- Manipulation d'un élément de 3° niveau
- Cas particuliers : Options de menus
- Récupérer le nom d'un élément dans le code
- Présentation
- Récupérer le nom d'un élément grâce au "Drag and Drop"
Faire référence à un élément dans un événement / traitement WLangage
Qu'est-ce qu'un élément ? Le tableau suivant présente les différents éléments d'une application : | | | | Élément | Élément de 2° niveau | Élément de 3° niveau |
|---|
| Fenêtre | - Champs d'une fenêtre
- Menus d'une fenêtre
- Cases d'une barre de message
| - Champs appartenant à un superchamp ou à une barre d'outils
- Options d'un menu
- Colonnes d'une table
| Page
Frameset | - Champs d'une page
- Menus d'une page
| Colonnes d'une table | | Etat | - Champs d'un état
- Blocs d'un état
| Colonnes d'une table | | Requête | Rubriques d'une requête | | | Fichier de données | Rubriques d'un fichier de données | |
Remarque : Pour simplifier l'écriture des traitements WLangage, WINDEV, WINDEV Mobile et WEBDEV permettent de récupérer facilement le nom d'un élément dans une fenêtre de code. Pour plus de détails, consultez le paragraphe Récupérer le nom d'un élément dans le code. Manipulation d'un élément Pour manipuler un élément (page, fenêtre, état, requête ou fichier de données) dans un événement ou traitement WLangage, il suffit d'utiliser le nom de cet élément. Ce nom peut être utilisé : - soit dans une fonction WLangage.
- soit avec une propriété WLangage.
- soit en affectation directe.
Par exemple :
// Initialisation et exécution de la requête REQ_ListeClient
HExécuteRequête(REQ_ListeClient)
// Modification du nombre d'exemplaires de l'état ETAT_Client
ETAT_Client.NbCopie =10
// Récupération du titre de la fenêtre FEN_FenRecherche
ResTitre est une chaîne = FEN_FenRecherche
// Récupération du titre de la page PAGE_PageRecherche
ResTitre est une chaîne = PAGE_PageRecherche
Manipulation d'un élément de 2° niveau Pour manipuler un élément de 2° niveau (champ ou menu d'une fenêtre, champ ou menu d'une page, champ ou bloc d'un état, ...) dans un événement ou traitement WLangage, il suffit : - soit d'utiliser directement le nom de cet élément de 2° niveau. Cette syntaxe est valable uniquement si cet élément de 2° niveau est manipulé depuis la fenêtre (ou l'état) auquel il appartient.
- soit d'utiliser la notation suivante : "<NomElément>.<NomElément2°Niveau>".
Un élément de 2° niveau peut être manipulé : - soit dans une fonction WLangage.
- soit avec une propriété WLangage.
- soit en affectation directe.
Par exemple :
// Déroule la liste du champ Combo COMBO_VilleFrance
// de la fenêtre FEN_Client
ComboOuvre(COMBO_VilleFrance)
// équivalent à : ComboOuvre(FEN_Client.COMBO_VilleFrance)
// Modification de la couleur de fond du champ ChTotalHT
// dans l'état ETAT_Commande
ChTotalHT.CouleurFond = BleuClair
// équivalent à ETAT_Commande.ChTotalHT.CouleurFond = BleuClair
// Initialisation du champ de saisie SAI_Ville de la
// fenêtre FEN_Client depuis une autre fenêtre
FEN_Client.SAI_Ville = "Montpellier"
// Rafraîchissement de la zone répétée ZR_ZoneProduit
// à partir du début de la zone répétée
ZoneRépétéeAffiche(ZR_ZoneProduit, taDébut)
// équivalent à : ZoneRépétéeAffiche(PAGE_PageClient.ZR_ZoneProduit, taDébut)
Cas particuliers : Rubriques de fichier de données ou de requête Pour manipuler par programmation une rubrique d'un fichier de données ou d'une requête, il suffit : - soit d'utiliser directement le nom de la rubrique. Cette syntaxe est valable uniquement si la rubrique est manipulée à l'aide d'une fonction ou d'une propriété dans laquelle le nom du fichier de données ou de la requête à laquelle la rubrique appartient est spécifiée.
- soit d'utiliser la syntaxe suivante : "<NomFichier/NomRequête>.<NomRubrique>".
Par exemple :
// Affectation dans la rubrique CP du fichier de données Client
// de la valeur saisie dans le champ SAI_CodePostal
CLIENT.CP = SAI_CodePostal
// Avance jusqu'au 2000ième enregistrement
// du fichier CLIENT selon la rubrique NOMCLI
HLitPremier(CLIENT, NOMCLI)
HAvance(CLIENT, NOMCLI, 1999)
Manipulation d'un élément de 3° niveau Pour manipuler un élément de 3° niveau (champ appartenant à un superchamp, champ appartenant à une barre d'outils, colonne de table, ...) dans un événement ou traitement WLangage, il suffit : - soit d'utiliser directement le nom de cet élément de 3° niveau. Cette syntaxe est valable uniquement si les conditions suivantes sont réunies :
- cet élément de 3° niveau est manipulé depuis l'élément de 2° niveau auquel il appartient (superchamp, barre d'outils ou table).
- aucun autre élément de 3° niveau utilise le même nom.
- soit d'utiliser la notation suivante si l'élément de 3° niveau est manipulé depuis la fenêtre (ou l'état) auquel il appartient : "<NomElément2°Niveau>.<NomElément3°Niveau>".
- soit d'utiliser la notation suivante si l'élément de 3° niveau est manipulé depuis une autre fenêtre (ou un autre état) : "<NomElément>.<NomElément2°Niveau>.<NomElément3°Niveau>".
Un élément de 3° niveau peut être manipulé : - soit dans une fonction WLangage.
- soit avec une propriété WLangage.
- soit en affectation directe.
Par exemple :
// Modification de la largeur de la colonne COL_NomClient
// Aucune autre colonne COL_NomClient n'est présente dans la fenêtre
COL_NomClient.Largeur += 10
// Modification du nombre de caractères maximum du champ SAI_Police
// appartenant au superchamp SC_SchStyle depuis la fenêtre du superchamp
SC_SchStyle.SAI_Police.Taille += 10
// Modification de la hauteur du champ SAI_Police appartenant à la
// barre d'outils BAR_Style depuis une autre fenêtre
FEN_Client.BAR_Style.SAI_Police.Hauteur += 10
Récupérer le nom d'un élément dans le code Présentation Pour récupérer le nom d'un élément (peu importe son niveau) dans le code : - utilisez la complétion automatique.
La complétion automatique permet une saisie assistée du code WLangage. Pour plus de détails, consultez Complétion automatique. - réalisez des "Drag and Drop" entre l'élément à utiliser et la fenêtre de code.
Ces "Drag and Drop" peuvent être effectués :
Récupérer le nom d'un élément grâce au "Drag and Drop" Pour récupérer le nom d'un élément grâce au "Drag and Drop" : - Sélectionnez l'élément dont le nom doit être récupéré :
- Maintenez le bouton gauche de la souris enfoncé et déplacez l'élément :
- Relâchez le bouton de la souris à la position où le nom de l'élément doit être utilisé. Le nom de l'élément droppé apparaît.
Documentation également disponible pour…
|
|
|
|