|
|
|
|
|
|
|
|
|
|
- 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
- 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 :
HExécuteRequête(REQ_ListeClient)
ETAT_Client.NbCopie =10
ResTitre est une chaîne = FEN_FenRecherche
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 :
ComboOuvre(COMBO_VilleFrance)
ChTotalHT.CouleurFond = BleuClair
FEN_Client.SAI_Ville = "Montpellier"
ZoneRépétéeAffiche(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 :
CLIENT.CP = SAI_CodePostal
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 :
COL_NomClient.Largeur += 10
SC_SchStyle.SAI_Police.Taille += 10
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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|