ChampCrée (Fonction)
En anglais : ControlCreate
Crée un nouveau champ de n'importe quel type dans une fenêtre par programmation.
c est un Champ
c < - ChampCrée ( "BOUTON_1" , typBouton , 30 , 40 , 140 , 20 )
c . Libellé = "Cliquez moi"
c . Traitement [ trtClic ] = maProcédure
ChampCrée ( "SAISIE_1" , typDate , 30 , 40 , 140 , 20 )
chmp est un Champ
chmp < - ChampCrée ( "DATE" , typDate , 150 , 150 , 80 , 20 )
chmp . LargeurLibellé = 40
chmp . Libellé = "Date"
cTable est un Champ
cTable < - ChampCrée ( "cTable" , typTable , 0 , 0 , 300 , 250 , Vrai )
cTable . Ancrage = ancreLargeur + ancreHauteur
col1 est un Champ < - ChampCrée ( "cTable.COL1" , typColonne )
col1 . TypeSaisie = typSaisieTexte
col2 est un Champ < - ChampCrée ( "cTable.COL2" , typColonne )
col2 . TypeSaisie = typSaisieHeure
col3 est un Champ < - ChampCrée ( "cTable.COL3" , typColonne )
col3 . TypeSaisie = typSaisieNum
TableAjouteLigne ( cTable , "Col 1" , "1224" , "25" )
Syntaxe
<Résultat> = ChampCrée(<Nom> , <Type> [, <X> [, <Y> [, <Largeur> [, <Hauteur> [, <Visible>]]]]])
<Résultat> : Variable de type Champ
Le champ créé peut être manipulé via une variable de type Champ . Dans ce cas, l'affectation doit être réalisée avec l'opérateur '<-' . Si la fonction ChampCrée est utilisée directement, le champ est créé dans la fenêtre et est visible par défaut.
<Nom> : Chaîne de caractères
Nom à donner au nouveau champ. Ce nom permettra de manipuler le champ par programmation. Si ce nom existe déjà, une erreur WLangage est affichée. Si ce paramètre correspond à une chaîne vide (""), un nom unique est automatiquement créé. Cas particuliers :
Création d'un champ dans un champ "Parent" : il suffit d'indiquer le nom complet du champ à créer. Par exemple : "Onglet[1].Bouton2". Création d'une colonne de saisie dans un champ Table : il suffit d'indiquer le type typColonne et le nom du champ Table avant le nom de la colonne. Par exemple :
c < - ChampCrée ( "TABLE1.COL3" , typColonne )
c . Largeur = 100
c . TypeSaisie = typSaisieDate
Création d'une colonne simple dans un champ Table : il suffit d'indiquer le type de la colonne voulu et le nom du champ Table avant le nom de la colonne. Par exemple :
c2 est un Champ < - ChampCrée ( "Table1.Col3" , typImage )
c2 . Largeur = 50
Création de volets d'onglet : il suffit d'indiquer le type typVoletOnglet et le nom de l'onglet. Par exemple :ChampCrée ( "ONGLET1" , typVoletOnglet )
Création d'un champ de saisie de type Jeton de texte : Il suffit de créer un champ de saisie de type texte puis d'activer la gestion des jetons. Par exemple : MonChamp est un Champ < - ChampCrée ( "test" , typTexte , 10 , 10 , 250 , 25 )
MonChamp . JetonActif = Vrai
<Type> : Constante de type Entier
Type de champ à créer : typActiveX Champ ActiveX typAgenda Champ Agenda typAsc Champ Ascenseur typBarreOutils Champ Barre d'outils typBoîteAOutils Champ Boîte à outils typBouton Champ Bouton typBouton Champ Bouton. Nouveauté 2025 typBoutonSegmenté Champ Bouton segmenté. typCalendrier Champ Calendrier typCarrousel Champ Carrousel typCarte Champ Carte typClicage Champ Image cliquable (champ Image d'une fenêtre ayant l'option "Cette image est une zone de cliquage" cochée). typCodeBarres Champ Code-barres typColonne Champ Colonne de table typComboAVS Champ Combo avec saisie typComboSNS Champ Combo sans saisie typConférence Champ Conférence typConteneurNatif Champ Conteneur natif typCube Champ Cube typDate Champ de saisie de type date typDurée Champ de saisie de type durée typEditeurCode Champ Editeur de code typEditeurDeDiagrammes Champ Editeur de diagrammes
typEditeurHtml Champ Editeur HTML
typEditeurImages Champ Editeur d'images typEditeurImagesMobile Champ Editeur d'images Mobile typFenêtreInterne Champ Fenêtre Interne typFil Champ Fil typForme Champ Forme/Dessin typGantt Colonne de type Diagramme de Gantt typGraphe Champ Graphe typHeure Champ de saisie de type heure typHTML Champ d'affichage HTML typImage Champ Image typInterr Champ Interrupteur typInterrupteurABascule Champ Interrupteur à bascule typJauge Champ Jauge typJaugeInfinie Champ Jauge infinie typKanban Champ Kanban
typLecteurPDF Champ Lecteur PDF typLibellé Champ Libellé typListe Champ Liste typListeImage Champ Liste image typListeKanban Champ Liste de Kanban
typMonétaire Champ de saisie de type monétaire typMultimédia Champ Multimédia typNotation Champ Notation typNoteRepositionnable Champ Note repositionnable typNum Champ de saisie de type numérique typOle Champ OLE typOnglet Champ Onglet typOrganigramme Champ Organigramme typPanneau Champ Panneau dockable typPlanning Champ Planning typPotentiomètre Champ Potentiomètre typPotentiomètreRotatif Champ Potentiomètre rotatif typRangeSlider Champ Range Slider typRuban Champ Ruban typSélect Champ Sélecteur
typSéparateur Champ Séparateur typSpin Champ Spin typSuperChamp Superchamp typTable Champ Table typTableauCroiséDynamique Champ Tableau croisé dynamique typTableauDeBord Champ Tableau de bord typTableHierarchique Champ Table hiérarchique typTableur Champ Tableur typTexte Champ de saisie de type texte typTiroir Champ Tiroir typTraitementDeTexte Champ Traitement de texte typTreeMap Champ TreeMap typTreeView Champ Arbre typVoletOnglet Champ Volet d'onglet typWebCam Champ Web Camera typXaml Champ Xaml typZoneMultiligne Champ Zone multiligne typZoneRépétée Champ Zone répétée
Si le type est invalide, une erreur WLangage est affichée. <X> : Entier optionnel
Abscisse du champ à créer (position sur l'axe des X) en pixels. Position horizontale du coin haut gauche du champ par rapport au coin haut gauche de la zone client de la fenêtre (c'est-à-dire la fenêtre sans les barres de titre et de menu ni le cadre). Ce paramètre correspond à la propriété XInitial . Si ce paramètre n'est pas précisé, l'abscisse du champ est 0.
Il est ensuite possible de modifier cette valeur avec la propriété
X .
<Y> : Entier optionnel
Ordonnée du champ à créer (position sur l'axe des Y) en pixels. Position verticale du coin haut gauche du champ par rapport au coin haut gauche de la zone client de la fenêtre (c'est-à-dire la fenêtre sans les barres de titre et de menu ni le cadre). Ce paramètre correspond à la propriété YInitial . Si ce paramètre n'est pas précisé, l'ordonnée du champ est 0.
Il est ensuite possible de modifier cette valeur avec la propriété
Y .
<Largeur> : Entier optionnel
Largeur du champ à créer (exprimée en pixels). Ce paramètre correspond à la propriété LargeurInitiale . Si ce paramètre n'est pas précisé, la largeur du champ est 0.
Il est ensuite possible de modifier cette valeur avec la propriété
Largeur .
<Hauteur> : Entier optionnel
Hauteur du champ à créer (exprimée en pixels). Ce paramètre correspond à la propriété HauteurInitiale . Si ce paramètre n'est pas précisé, la hauteur du champ est 0.
Il est ensuite possible de modifier cette valeur avec la propriété
Hauteur .
<Visible> : Booléen optionnel
Vrai (valeur par défaut) si le champ doit être visible, Faux pour créer un champ invisible. Il est ensuite possible de modifier cette valeur avec la propriété
Visible .
Remarques
Si plusieurs champs sont créés dans la même fenêtre en une seule opération, il est conseillé de désactiver la propriété AffichageActif avant la création des champs puis de la réactiver après : l'affichage des nouveaux champs sera optimisé et l'effet d'apparition progressive des champs sera supprimé. Pour paramétrer les caractéristiques du champ créé, utilisez les propriétés associées au type de champ créé : Si le champ est créé directement, il est possible d'utiliser l'opérateur d'indirection pour manipuler le champ par son nom : ChampCrée ( "BOUTON_1" , typBouton , 30 , 40 , 140 , 20 )
{ "BOUTON_1" } . . Libellé = "Envoyer un email"
{ "BOUTON_1" } . . Traitement [ trtClic ] = maProcédure
Si le champ créé est associé à une variable de type Champ , il suffit d'utiliser directement les propriétés du champ sur la variable : c est un Champ
c < - ChampCrée ( "BOUTON_1" , typBouton , 30 , 40 , 140 , 20 )
c . Libellé = "Cliquez moi"
c . Traitement [ trtClic ] = maProcédure
Pour changer le style du champ créé : utilisez la fonction ChangeStyle . Il suffit d'affecter au champ un style présent dans la feuille de styles du projet. utilisez la propriété Style . Cette propriété permet de copier le style d'un champ existant dans un autre champ. Pour définir les différents traitements/événements associés au champ, utilisez la propriété Traitement . Pour supprimer un champ créé avec la fonction ChampCrée , utilisez la fonction ChampSupprime . Classification Métier / UI : Code UI
Composante : wd300obj.dll
Documentation également disponible pour…