DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Options et manipulations
  • 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"
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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êteRubriques d'une requête
Fichier de donnéesRubriques d'un fichier de données
Les options de menu et les rubriques d'un fichier de données font l'objet d'une manipulation particulière. Pour plus de détails, consultez les paragraphes Cas particulier : Rubriques et Cas particulier : Options de menu.
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
WINDEVWEBDEV - Code ServeurWindowsCode Utilisateur (MCU)

Cas particuliers : Options de menus

Pour manipuler par programmation une option de menu, il suffit :
  • soit d'utiliser directement le nom de l'option. Cette syntaxe est valable uniquement si l'option de menu est manipulée depuis le menu ou depuis la fenêtre associée au menu.
  • soit d'utiliser une des syntaxes suivantes : "<NomFenêtre>.<NomOption>" ou "<NomFenêtre>.<NomMenu>.<NomOption>".
Par exemple :
// Changement de la couleur de la police de l'option OPT_FicheClient
// du menu MENU_Client depuis la fenêtre de ce menu
OPT_FicheClient.Couleur = BleuFoncé
 
// Changement de la couleur de la police de l'option OPT_FicheClient
// du menu MENU_Client depuis une autre fenêtre
FEN_Client.MENU_Client.OPT_FicheClient.Couleur = BleuFoncé
// équivalent à : FEN_Client.OPT_FicheClient.Couleur = BleuFoncé
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 :

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" :
  1. Sélectionnez l'élément dont le nom doit être récupéré :
    • soit dans le volet "Explorateur de Projet".
    • soit depuis un éditeur (éditeur de fenêtres pour récupérer le nom d'un champ par exemple).
  2. Maintenez le bouton gauche de la souris enfoncé et déplacez l'élément :
  3. 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.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale