|
|
|
|
|
|
|
|
|
|
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é 2025typBoutonSegmenté | 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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|