Champ (Type de variable)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des champs

Déclaration d'une variable de type Champ
Affectation d'une variable de type Champ
Utilisation d'une variable de type Champ dans une procédure
Optimisation des traitements avec indirection
Propriétés associées à une variable de type Champ
Fonctions manipulant une variable de type Champ

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Champ (Type de variable)

En anglais : Control

Le type Champ permet de définir toutes les caractéristiques d'un champ. Ce champ peut être un champ créé dynamiquement avec la fonction ChampCrée ou un champ existant dans une fenêtre ou un état.

La fonction ChampCrée n'est pas disponible.

Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.

Exemple

Remarques

Déclaration d'une variable de type Champ

Pour déclarer une variable de type Champ, il suffit d'utiliser la syntaxe suivante :

<Nom de la variable> est un Champ

Exemple :

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 Non disponible.
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 Non disponible.
typComboSNS	10002	Champ Combo sans saisie Non disponible.
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 Non disponible.
typDisposition	126	Champ Disposition Non disponible.
typDurée	20006	Champ de saisie de type durée Non disponible.
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 Non disponible.
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 Non disponible.
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 Non disponible.
typHTML	23	Libellé HTML Non disponible.
typIFrame	50013	Champ IFrame Non disponible.
typImage	8	Champ Image
typInterr	5	Champ Interrupteur Non disponible.
typInterrupteurABascule	132	Champ Interrupteur à bascule Non disponible.
typJauge	10	Champ Jauge Non disponible.
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 Non disponible.
typListeImage	27	Champ Liste image Non disponible.
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 Non disponible.
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 Non disponible.
typOle	15	Champ OLE Non disponible.
typOnglet	16	Champ Onglet Non disponible.
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 Non disponible.
typSuperChamp	40	Superchamp
typTable	9	Champ Table Non disponible.
typTableauCroiséDynamique	102	Champ Tableau croisé dynamique Non disponible.
typTableauDeBord	111	Champ Tableau de bord Non disponible.
typTableHierarchique	35	Champ Table hiérarchique Non disponible.
typTableur	114	Champ Tableur Non disponible.
typTexte	20001	Champ de saisie de type texte Non disponible.
typTiroir	34	Champ Tiroir Non disponible.
typTraitementDeTexte	120	Champ Traitement de texte Non disponible.
typTreeMap	74	Champ TreeMap Non disponible.
typTreeView	19	Champ Arbre Non disponible.
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 Non disponible.
typXaml	36	Champ Xaml Non disponible.
typZoneMultiligne	97	Champ Zone multiligne Non disponible.
typZoneRépétée	30	Champ Zone répétée Non disponible.
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

Une variable de type Champ peut être utilisée pour manipuler :

un champ existant dans une fenêtre ou un état.

L'affectation d'une variable de type Champ doit être réalisée avec l'opérateur '<-'.

Exemples :

// 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"}

Attention : L'opérateur '=' ne doit pas être utilisé pour l'affectation d'une variable de type Champ. Cet opérateur permet de transférer la valeur d'un champ dans un autre champ de même type. Par exemple :

// 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"

Remarque : Pour savoir si la variable de type Champ a été affectée, utilisez la propriété Type sur la variable.

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

Le type Champ peut être un paramètre d'une procédure.

Méthode 1 : Utilisation de la syntaxe sans préciser le type du champ :

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)
```

Dans ce cas, si le type du champ n'est pas celui attendu, aucune vérification n'est effectuée à la compilation.

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

Le type Champ peut être utilisé pour optimiser les traitements utilisant les indirections. Il est possible par exemple d'écrire :

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

plutôt que le code suivant :

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

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

Le type Champ permet de manipuler tous les types de champs d'une fenêtre ou d'un état. Les propriétés disponibles dépendent du type de champ manipulé.

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.

Pour connaître les propriétés d'un champ, consultez la page d'aide du champ : le lien "Voir aussi" permet d'accéder à toutes les propriétés du champ. Pour plus de détails, consultez Champs d'une fenêtre.

Fonctions manipulant une variable de type Champ

Toutes les fonctions WLangage manipulant des champs peuvent être utilisées sur une variable de type Champ. Bien entendu, seules les fonctions WLangage correspondant au type de champ manipulé sont disponibles.

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.

Ainsi, il est possible d'utiliser les fonctions TableXXX sur une variable de type Champ manipulant un champ Table.

Voir Aussi

Version minimum requise

Version 19

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/04/2024

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