Ou comment qu'on fait?
Introduction
Cette librairie à besoin de librairies annexes pour fonctionner:
- standard.lua (Gestion de fonctions standard)
Comment ?
Implémentation dans un script:
dofile("libGUI.lua")
Création des objets:
Création d'un bouton:
Objet = libGUI.newObj(ecran,TBUTTON,x,y,width,height[, text[ ,align[, bAssoc[, image]]]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TBUTTON = objet de type Bouton.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
text = le texte que l'on veut afficher sur le bouton, l'option %B dans le texte permet d'afficher la touche de la DS associé à celui-ci.
align = alignement du texte dans l'objet._ALEFT : alignement à gauche.
_ARIGHT : alignement à droite.
_ACENTER : alignement au centre.bAssoc : la touche associée au bouton:
_BSTART : La touche START de la DS.
_BSELECT : La touche SELECT de la DS.
_BA : La touche A de la DS.
_BB : La touche B de la DS.
_BX : La touche X de la DS.
_BY : La touche Y de la DS.image : le chemin de l'image à intégrée au bouton.
Création d'un textBox:
Objet = libGUI.newObj(ecran,TTEXTBOX,x,y,width,height[, text[ ,align[, multiligne]]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TTEXTBOX = objet de type textBox.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
text = le texte que l'on veut afficher dans le textBox.
multiligne = (Booléen) indique si on affiche sur une ou plusieurs lignes.
align = alignement du texte dans l'objet._ALEFT : alignement à gauche.
_ARIGHT : alignement à droite.
_ACENTER : alignement au centre.
_ATRONQ : tronque le texte en gardant le tier du début et la fin du texte séparer par trois points si le texte est trop grand.
Création d'un lien:
Objet = libGUI.newObj(ecran,TLINK,x,y,width,height[, text])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TLINK = objet de type Lien.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
text = le texte que l'on veut afficher comme lien.
Création d'une case à cochée:
Objet = libGUI.newObj(ecran,TCHECKBOX,x,y,width,height[, text[ ,align]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TCHECKBOX = objet de type case à cochée.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
text = le texte que l'on veut afficher à coté de la case. align = alignement de la case par rapport au texte._ALEFT : alignement à gauche.
_ARIGHT : alignement à droite.
Création d'un groupe de radioButton:
Objet = libGUI.newObj(ecran,TRADIOBUTTON,x,y,width,height[, listeElement[ ,align]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TRADIOBUTTON = objet de type RadioBouton.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
listeElement = liste des éléments.ex : {"Element1","Element2","Truc","Machin"}
align = alignement des ronds en fonction du texte.
_ALEFT : alignement à gauche.
_ARIGHT : alignement à droite.
Création d'un numerique UP/DOWN:
Objet = libGUI.newObj(ecran,TNUMUPDOWN,x,y,width,height[, min[ ,max[, position]]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TNUMUPDOWN = objet de type Numerique UP/DOWN.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
min = la valeur minimum que peut prendre l'objet.
max = la valeur maximum que peut prendre l'objet.
pos : la valeur par défaut de l'objet.
Création d'une barre de progression:
Objet = libGUI.newObj(ecran,TPROGRESSBAR,x,y,width,height[, text[ ,max]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TPROGRESSBAR = objet de type barre de progression.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
text = le texte que l'on veut afficher dans la barre, des options peuvent être ajoutées dans le texte:%p permet d'afficher la position actuelle.
%m permet d'afficher la position maximale.
%P permet d'afficher le pourcentage de la position actuelle.max = valeure maximale que peut prendre la barre.
Création d'une listeView:
Objet = libGUI.newObj(ecran,TLISTVIEW,x,y,width,height[, listElement])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TLISTVIEW = objet de type Liste View.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
listElement = la liste des éléments à afficher.ex:{"Objet1","Truc","Avion"}
Création d'un ComboBox:
Objet = libGUI.newObj(ecran,TCOMBOBOX,x,y,width,height[, listElement])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TCOMBOBOX = objet de type ComboBox.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
listElement = la liste des éléments à ajouté.ex: {"Element1","Truc","Machin"}
Création d'un TableView:
Objet = libGUI.newObj(ecran,TTABLEVIEW,x,y,width,height[, tableau[, listdimcol]])
Objet = Objet créé.
ecran = ecran sur lequel l'objet sera affiché.SCREEN_UP ou SCREEN_DOWN
TTABLEVIEW = objet de type TableView.
x = coordonnée x de l'objet.
y = coordonnée y de l'objet.
width = largeur de l'objet.
height = hauteur de l'objet.
tableau = le tableau des éléments à affichés.la premiére ligne du tableau contient les titres des colonnes.
ex: {{"Titre1","Titre2","Titre3"},{"Element1","Truc","Machin"}}listdimcol = la liste des dimensions des colonnes.
elle doit contenir autant d'éléments que de colonne dans le tableau.
ex: {60,30,100} pour un tableau de 3 colonnes.
Destruction de l'objet:
libGUI.del([objet])
objet = Nom de l'objet.
Si aucun objet n'est rentré, la fonction détruit la librairie en mémoire.
Affichage de l'objet:
libGUI.show()
Replacement de l'objet à une autre position:
libGUI.move(objet,x, y)
objet = Nom de l'objet
x = Nouvelle coordonnée x en pixel
y = Nouvelle coordonnée y en pixel
Vérification des actions et modification en conséquence:
libGUI.held()
Si les doubles cliques ne sont pas bien compris dans votre script sur le hardware, utiliser le code suivant en dessous de libGUI.held():
if(Stylus.doubleClick) then libGUI.DblClk() end
Affecter une nouvelle valeur à un objet:
libGUI.set(objet,variable,valeur)
objet = nom de l'objet.
valeur = la nouvelle valeur à affecter.
variable = la variable que l'on veut modifier."text" : le texte.
"x" : la coordonné x.
"y" : la coordonné y.
"width" : la largeur.
"height" : la hauteur.
"check" : (booléen) si c'est coché ou appuyé.
"doubleClick" : (booléen) si il à été double Cliqué.
"align" : l'alignement.
"min" : la valeur minimum.
"max" : la valeur maximum.
"pos" : la position actuelle.
"scr" : l'écran d'affichage.
"inc" : l'incrément.
"element" : les elements de liste, de radiobutton ou autre.
"image" : le chemin de l'image d'un bouton.
"visible" : (booléen) indique si l'objet est visible.
"active" : (booléen) indique si l'objet est actif.
"cFond" : couleur du fond de l'objet.
"cCadre" : couleur du cadre de l'objet.
"cText" : couleur du texte de l'objet.
"cFleche" : couleur des flèches de l'objet.
"cSel" : couleur de la sélection dans l'objet.
"cTextSel" : couleur du texte de la sélection dans l'objet.
"multiline" : (Booléen) active ou désactive le multiligne d'un TextBox.
"dimcol" : liste des dimensions des colonnes d'un TableView.
Récupération d'une valeur d'un objet:
libGUI.get(objet,variable)
objet = nom de l'objet.
variable = la variable que l'on veut modifier."text" : le texte.
"x" : la coordonné x.
"y" : la coordonné y.
"width" : la largeur.
"height" : la hauteur.
"check" : (booléen) si c'est coché ou appuyé.
"doubleClick" : (booléen) si il à été double Cliqué.
"align" : l'alignement.
"min" : la valeur minimum.
"max" : la valeur maximum.
"pos" : la position actuelle.
"scr" : l'écran d'affichage.
"inc" : l'incrément.
"element" : les elements de liste, de radiobutton ou autre.
"image" : le chemin de l'image d'un bouton.
"visible" : (booléen) indique si l'objet est visible.
"active" : (booléen) indique si l'objet est actif.
"cFond" : couleur du fond de l'objet.
"cCadre" : couleur du cadre de l'objet.
"cText" : couleur du texte de l'objet.
"cFleche" : couleur des flèches de l'objet.
"cSel" : couleur de la sélection dans l'objet.
"cTextSel" : couleur du texte de la sélection dans l'objet.
"multiline" : (Booléen) multiligne d'un TextBox.
"dimcol" : liste des dimensions des colonnes d'un TableView.
Associé un bouton avec une touche de la DS:
libGUI.assocButton(objet,button)
objet = nom de l'objet.
button = nom de la touche que l'on désire associé._BSTART : La touche START de la DS.
_BSELECT : La touche SELECT de la DS.
_BA : La touche A de la DS.
_BB : La touche B de la DS.
_BX : La touche X de la DS.
_BY : La touche Y de la DS.
Récupérer l'élément sélectionné d'une liste ou de radiobutton:
libGUI.getSel(objet)
objet = nom de l'objet.
Affecter une sélection à une liste ou autre:
libGUI.setSel(objet,position)
objet = nom de l'objet.
position = position de la sélection dans l'objet.
Ajouter un élément à une listeView:
libGUI.addElement(objet,element)
objet = nom de l'objet.
element = nouvel élément à ajouté en fin de listView.
Ajouter un élément à un TableView:
libGUI.addElement(objet,element)
objet = nom de l'objet.
element = nouvelle ligne d'éléments à ajouté en fin du TableView.