Fournit un écran vide à remplir avec des contrôles. Les autres types d'écran comme
ListScreen
hérite de cette classe.
Propriétés
Controls (ControlCollection)
Les contrôles qui sont à afficher sur l'écran doivent appartenir à la hiérarchie de contrôle qui est contenue dans la collection Controls de l'écran. Étant donné que chaque contrôle possède également une collection Controls, il n'est pas nécessaire d'ajouter tous les contrôles dans la collection Controls de l'écran, car ils peuvent être les enfants d'autres contrôles existant sur l'écran.
Exemple
class EcranExemple : Screen
Label lblTexte;
void load()
{
Controls.Add(lblTexte);
}
TransitionControls(Collection)
Contient les contrôles qui doivent être surveillés afin de savoir si une animation de transition est terminée. Habituellement, seuls un ou deux contrôles sont ajoutés à cette collection au sein des méthodes
AimateIn()
et
AnimateOut()
.
Exemple
void AnimateOut()
{
//disparition progressive de l'image du logo
imgPointui.AnimateClear();
imgPointui.AnimateFade(-1, 0, 8);
//Ne pas autoriser la fin de l'animation de transition
//avant que le logo ait complètement disparu
TransitionControls.Add(imgPointui);
}
Attributes(NameValueCollection)
Délivre un espace générique pour stocker des couples clé/valeur.
Méthodes
void AnimateIn()
Appelé lorsque l'écran est sur le point d'être affiché et offre la possibilité à l'écran de démarrer des animations.
void AnimateOut()
Appelé lorsque l'écran est sur le point d'être remplacé par un nouvel écran (avec FlowStack.Return()
ou FlowStack.Branch()
) et offre la possibilité à l'écran de démarrer des animations de sortie d'écran.
void FlagLayoutRequired()
Prévient dès que possible que l'écran doit être redessiné à l'aide la méthode Layout()
. Il est recommandé d'utiliser cette méthode plutôt que d'appeler explicitement la méthode Layout()
afin d'éviter des dessins redondants.
void SetSoftkeys(String leftSoftKeyID, String leftSoftkeyText, String rightSoftKeyID, String rightSoftKeyText))
Définit le texte à afficher sur les softkeys (menus gauche et droit) et l'identifiant du bouton qui sera retourné par la méthode SoftKeyButtonClick()
qui est appelée lorsque l'utilisateur clique sur un bouton softkey (menu).
void Load()
Appelé une fois pour l'écran lors de son chargement. C'est souvent lorsque la hiérarchie de contrôle est configurée en utilisant Controls.Add()
, et quand les objets sont initialisés.
void Layout(int screenWidth, int screenHeight)
Appelé chaque fois que l'application pense que son écran doit être redessiné. Par exemple lors d'un changement d'orientation de l'écran (rotation). FlagLayoutRequired()
peut également être utilisé pour forcer le dessin d'un écran.
void OrientationChanged(int screenWidth, int screenHeight)
Appelé chaque fois que l'orientation de l'écran change.
bool SoftKeyButtonClick(String buttonID)
Appelé quand l'utilisateur clique sur un menu (softkey) L'identifiant correspondra à un des deux identifiants (gauche ou droit) défini dans la méthode SetSoftkeys()
.
int GetHeight()
Retourne la hauteur de l'écran en pixels.
int GetWidth()
Retourne la largeur de l'écran en pixels.
void SetTitleVisible(bool visible)
Définit si la barre de titre doit être visible ou pas.
void SetID(String id)
Définit l'identifiant unique de l'écran.
void SetTitlePosition(Label control)
Positionne le contrôle à placer sur la barre de titre.