BG_FormCreate : création d'un formulaire

Prototype :
int BG_FormCreate (
      const string sBGFormName,
      const string sBGParam,
      const int iBGLeft,
      const int iBGTop,
      const int iBGWidth,
      const int iBGHeight,
      pfBG_FormProc = NULL);


sBGFormName
Nom interne du formulaire.
Ne doit pas être vide.
Ne doit pas contenir de caractère "."
Ce nom doit être unique parmis toutes les fenêtres.
Une fenêtre principale doit être ouverte (voir BG_WindowMainCreate).

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

iLeft
Position gauche de la fenêtre.
Valeur indiquée en pixels.

iTop
Position haute de la fenêtre.
Valeur indiquée en pixels.

iWidth
Largeur de la fenêtre.
Valeur indiquée en pixels.

iHeight
Hauteur de la fenêtre.
Valeur indiquée en pixels.

pfBG_FormProc
Nom d'une fonction de gestion des messages.
Ce paramètre est facultatif, la valeur par défaut est "".
Le prototype de la fonction est :
int Nom_procedure (
      const string sBGFormName,
      const string sBGItemName,
      const string sBGMessage,
      HWND hBGCurWnd,
      UINT message,
      WPARAM wParam,
      LPARAM lParam)

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
Cette fonction créé et affiche le formulaire.
Avant d'utiliser cette fonction, il faut déclarer son contenu avec BG_FormItemAdd.

Exemples
BG_FormItemAdd(...); BG_FormCreate ("MonFormulaire", "modal=true", 0, 0, 640, 480);
=> // création d'un formulaire modal de 640 X 480 pixels.

BG_FormItemAdd(...); BG_FormCreate ("MonFormulaire2", "name=Form2;bkcol=grey", 10, 10, 700, 500, FormProc);
=> // création d'un formulaire non modal, nommé Form2, les messages sont envoyés vers FormProc.

Voir la page Exemples pour un source complet.