Déclaration d'une variable de type Champ

c est un Champ

Nouveauté 2024
Lors de la déclaration d'une variable de type Champ, il est possible de préciser le type du champ via la syntaxe suivante :

<Nom de la variable> est un Champ <type champ = <Type du champ>>

où <Type de champ> correspond à la constante correspondant au type de champ à créer (voir ci-dessous).

Exemple :

MonChamp est un Champ <type champ = typBouton>

Les différentes constantes utilisables pour définir le type du champ sont les suivantes :

typActiveX	17	Champ ActiveX Non disponible.
typAgenda	76	Champ Agenda Non disponible.
typAsc	18	Champ Ascenseur Non disponible.
typAttribut	41	Attribut d'un champ Zone répétée Non disponible.
typBandeauDéfilant	122	Champ Bandeau défilant Non disponible.
typBarreDeNavigation	117	Champ Barre de navigation Non disponible.
typBarreOutils	22	Champ Barre d'outils Non disponible.
typBoîteAOutils	29	Champ Boîte à outils Non disponible.
typBouton	4	Champ Bouton
typCalendrier	47	Champ Calendrier
typCaptcha	82	Champ Captcha Non disponible.
typCarte	92	Champ Carte Non disponible.
typCarrousel	37	Champ Carrousel Non disponible.
typCaseBarreDeMessage	40002	Case de barre de message Non disponible.
typCellule	50014	Champ Cellule Non disponible.
typCelluleDeBarreDeNavigation	115	Champ Cellule présent dans un champ Barre de navigation. Non disponible.
typCelluleDisposition	127	Cellule d'un champ Disposition. Non disponible.
typCelluleFlexBox	139	Cellule d'un champ FlexBox. Non disponible.
typCelluleMiseEnPage	84	Champ Cellule utilisé pour la mise en page de type Zoning. Non disponible.
typChampFormaté	50001	Champ d'affichage formaté Non disponible.
typChampHTML	50002	Champ HTML Non disponible.
typChampMenu	50007	Menu d'une page WEBDEV Non disponible.
typChampMenuContextuel	141	Menu contextuel dans une page WEBDEV Non disponible.
typCheminDeNavigation	50011	Champ Chemin de navigation Non disponible.
typClicage	30001	Champ Image cliquable (champ Image d'une fenêtre ayant l'option "Cette image est une zone de cliquage" cochée). Non disponible.
typCodeBarres	26	Champ Code-barres Non disponible.
typColonne	56	Colonne de table Non disponible.
typComboAVS	10001	Champ Combo avec saisie
typComboSNS	10002	Champ Combo sans saisie
typComposantWeb	121	Champ Composant Web Non disponible.
typConférence	25	Champ Conférence Non disponible.
typConteneurNatif	125	Champ Conteneur natif Non disponible.
typCube	38	Champ Cube Non disponible.
typDate	20002	Champ de saisie de type date
typDisposition	126	Champ Disposition Non disponible.
typDurée	20006	Champ de saisie de type durée
typEditeurDeDiagrammes	130	Champ Editeur de diagrammes Non disponible.
Nouveauté 2024 typÉditeurCode	146	Champ Editeur de code Non disponible.
typEditeurHtml	134	Champ Editeur HTML Non disponible.
typEditeurImages	124	Champ Editeur d'images Non disponible.
typEditeurImagesMobile	138	Champ Editeur d'images sur Mobile Non disponible.
typFen	1	Fenêtre
typFenêtreInterne	31	Fenêtre Interne
typFil	118	Champ Fil Non disponible.
typFlash	50008	Champ de type Flash Non disponible.
typFlex	48	Champ de type Flex Non disponible.
typForme	20	Champ Forme/Dessin
typGantt	110	Colonne de type Diagramme de Gantt (champ Table ou Table hiérarchique). Non disponible.
typGraphe	33	Champ Graphe d'une fenêtre / page Non disponible.
typGrp	58	Groupe de champs Non disponible.
typHeure	20003	Champ de saisie de type heure
typHTML	23	Libellé HTML
typIFrame	50013	Champ IFrame Non disponible.
typImage	8	Champ Image
typInterr	5	Champ Interrupteur
typInterrupteurABascule	132	Champ Interrupteur à bascule Non disponible.
typJauge	10	Champ Jauge
typJaugeInfinie	113	Champ Jauge infinie Non disponible.
typJava	50004	Champ Java Non disponible.
typKanban	140	Champ Kanban Non disponible.
typLecteurPDF		Champ Lecteur PDF Non disponible.
typLibellé	3	Champ Libellé
typLibelléHTML	50006	Champ Libellé HTML Non disponible.
typLien	50005	Champ Lien Non disponible.
typLienSocial	103	Champ Réseau social Non disponible.
typLigne	50003	Champ Ligne Non disponible.
typListe	7	Champ Liste
typListeImage	27	Champ Liste image
typListeKanban	142	Champ Liste de Kanban Non disponible.
typMapArea	50010	Champ Image cliquable Non disponible.
typModèleDeChamp	43	Champ de type Modèle de champs.
typMonétaire	20005	Champ de saisie de type monétaire
typMultimédia	39	Champ Multimédia Non disponible.
typNotation	85	Champ Notation Non disponible.
typNoteRepositionnable	119	Champ Note repositionnable Non disponible.
typNum	20004	Champ de saisie de type numérique
typOle	15	Champ OLE Non disponible.
typOnglet	16	Champ Onglet
typOptionInterrupteurABascule	133	Option d'un champ Interrupteur à bascule Non disponible.
typOptionMenu	40001	Option de menu Non disponible.
typOrganigramme	86	Champ Organigramme Non disponible.
typPage	1	Page Non disponible.
typPageCornée	79	Champ Page cornée Non disponible.
typPageInterne	31	Page interne Non disponible.
typPanneau	131	Champ Panneau dockable Non disponible.
typPlanDeBandeauDéfilant	123	Plan associé à un champ Bandeau défilant Non disponible.
typPlanDeSite	45	Champ Plan du site Non disponible.
typPlanning	80	Planning Non disponible.
typPopup	90	Page popup Non disponible.
typPotentiomètre	12	Champ Potentiomètre Non disponible.
typPotentiomètreIntervalle	72	Potentiomètre d'intervalle Non disponible.
typPotentiomètreRotatif	13	Potentiomètre rotatif Non disponible.
typRangeSlider	72	Champ Range Slider Non disponible.
typRéglette	50009	Champ Réglette Non disponible.
typRegroupementRuban		Regroupement de ruban Non disponible.
typRuban	87	Champ Ruban Non disponible.
typRupture		Rupture dans un champ Zone répétée Non disponible.
typSélect	6	Champ Sélecteur
typSéparateur	28	Champ Séparateur Non disponible.
typSilverlight	46	Champ SilverLight Non disponible.
typSpin	11	Champ Spin
typSuperChamp	40	Superchamp
typTable	9	Champ Table
typTableauCroiséDynamique	102	Champ Tableau croisé dynamique Non disponible.
typTableauDeBord	111	Champ Tableau de bord
typTableHierarchique	35	Champ Table hiérarchique
typTableur	114	Champ Tableur Non disponible.
typTexte	20001	Champ de saisie de type texte
typTiroir	34	Champ Tiroir Non disponible.
typTraitementDeTexte	120	Champ Traitement de texte Non disponible.
typTreeMap	74	Champ TreeMap Non disponible.
typTreeView	19	Champ Arbre
typUpload	73	Champ Upload Non disponible.
typVidéo	78	Champ Vidéo Non disponible.
typVignette	50012	Champ Vignette Non disponible.
typWebCam	24	Champ Web Camera
typXaml	36	Champ Xaml Non disponible.
typZoneMultiligne	97	Champ Zone multiligne Non disponible.
typZoneRépétée	30	Champ Zone répétée
typZoneRépétéeLinéaire	77	Champ Zone répétée linéaire Non disponible.
typZoneTexteRiche	109	Champ Zone de texte Non disponible.

Affectation d'une variable de type Champ

• un champ existant dans une fenêtre ou un état.
• un champ créé avec la fonction ChampCrée.

// Affectation avec un champ existant
c est un Champ
c <- SAI_Saisie1

// Affectation en utilisant l'indirection
// La variable référence le champ SAI_SAISIE2
c <- {"SAI_SAISIE2"}

// Affectation avec un champ créé avec la fonction ChampCrée
c est un Champ
c <- ChampCrée("BOUTON_1", typBouton, 30, 40, 140, 20)

// Affectation avec un champ existant
c est un Champ
c <- SAI_Saisie1

// Modification de la valeur 
c = SAI_Saisie3 // Code équivalent : SAI_Saisie1.Valeur = SAI_Saisie3.Valeur
c = "Texte" // Code équivalent : SAI_Saisie1.Valeur = "Texte"

Utilisation d'une variable de type Champ dans une procédure

• le code de la procédure est du type :
  

  PROCÉDURE MaProcédure(C est un Champ)
  C = "Il est " + HeureSys()

• l'appel de la procédure est du type :
  

  MaProcédure(SAI_Saisie1)

Nouveauté 2024
Méthode 2 : Utilisation de la syntaxe précisant le type de champ utilisé :

• le code de la procédure est du type :
  

  PROCÉDURE MaProcédure(C est un Champ <type champ = typSaisie)
  C = "Il est " + HeureSys()

• l'appel de la procédure est du type :
  

  MaProcédure(SAI_Saisie1)

Avantage : Si l'appel de la procédure utilise un champ d'un type différent de celui attendu, une erreur de compilation est affichée : "Le passage du champ en paramètre n'est pas compatible avec le champ attendu."

Optimisation des traitements avec indirection

C est un Champ <-{s, indChamp}
C.Largeur = 10
C.Hauteur = 20

{s, indChamp}..Largeur = 10
{s, indChamp}..Hauteur = 20

Propriétés associées à une variable de type Champ

Ainsi, si une variable de type Champ est utilisée pour manipuler un champ de saisie, toutes les propriétés WLangage disponibles sur le champ de saisie sont utilisables sur la variable de type Champ.

Nouveauté 2024
En spécifiant le type du champ dès la déclaration de la variable de type Champ, seules les propriétés du type de champ indiqué sont proposées sous l'éditeur de code.

Fonctions manipulant une variable de type Champ

Nouveauté 2024
En spécifiant le type du champ dès la déclaration de la variable de type Champ, seules les fonctions manipulant le type de champ indiqué sont proposées sous l'éditeur de code.