BG_FormItemAdd : ajout d'un champ (item) dans un formulaire

Prototype :
int BG_FormItemAdd (
      const string sBGFormName,
      const string sBGItemName,
      const string sBGItemType,
      const int iBGOrder,
      const int iBGLeft,
      const int iBGTop,
      const int iBGWidth,
      const int iBGHeight,
      const string sBGParam = "");


sBGFormName
Nom interne du formulaire.
Ne doit pas être vide.
Ne doit pas contenir de caractère "."
Ce nom sera utilisé dans BG_FormCreate.

sBGItemName
Nom interne du champ.
Ne doit pas être vide.
Ne doit pas déjà exister dans le même formulaire.

sBGItemType
Type du champ, à choisir parmis :
- BG_ITEM_STATIC : texte simple (=label, = static)
- BG_ITEM_RECT : rectangle
- BG_ITEM_EDIT : champ de saisie
- BG_ITEM_BUTTONSYS : bouton système (= bouton standard Windows)
- BG_ITEM_BUTTON : bouton BipGDI (avec plus d'options)
- BG_ITEM_CHECKSYS : case à cocher système (sans label)
- BG_ITEM_COMBOSYS : liste de sélection système

iBGOrder
Numéro d'ordre du champ.
De 1 à n, ce numéro doit être unique dans un formulaire.
Ce numéro donne l'ordre d'affichage des champs et l'ordre d'avancement du curseur avec la touche TAB.

iLeft
Position gauche du champ.
Valeur indiquée en pixels.

iTop
Position haute du champ.
Valeur indiquée en pixels.

iWidth
Largeur du champ.
Valeur indiquée en pixels.

iHeight
Hauteur du champ.
Valeur indiquée en pixels.

sBGParam
Chaine de caractère contenant les paramètres.
La chaine peut être vide.
Paramètres gérés : voir la page dédié aux paramètres

Valeur de retour
Est égal à 0, si aucune erreur est intervenue durant le déroulement de la fonction.
Sinon le code de l'erreur est retourné.

Divers
Si un champ avec le même nom existe déjà dans le même formulaire, il est écrasé.
A utiliser avant d'afficher un formulaire avec BG_FormCreate.

Exemples
BG_FormItemAdd ("titre", BG_ITEM_STATIC, "MonFormulaire", 1, 50, 10, 600, 40,"value=Mon Titre;txhpos=center;txvpos=center;ftname=Arial;ftsize=16;ftbold=true;brdsize=1;brdcol=blue");
=> Création d'un champ texte centré avec police Arial et bordure bleue, contenu : "Mon Titre"

BG_FormItemAdd ("edit", BG_ITEM_EDIT, "Monformulaire", 2, 180, 65, 400, 25, "remark=Champ de saisie simple");
=> Création d'un champ de saisie simple avec une remarque dans la status bar

int iError = BG_FormItemAdd ("ok", BG_ITEM_BUTTON, "MonFormulaire", 3, 300, 400, 100, 30,"button=ok;value=OK;bkcol=green;remark=Ferme le formulaire");
=> Création d'un bouton OK (avec sortie automatique grace à "button=ok"), couleur de fond verte, ordre troisième position

Voir la page Exemples pour un source complet.