Pointui Home 2 - Control

Modifié le samedi, 07 février 2009 15:53 par Montecristoff — Catégorisé en: Pointui Home

Classe de base pour tous les contrôles graphiques visibles de l'interface.

Propriétés

Controls(ControlCollection)
Contient les contrôles enfants de ce contrôle. Les contrôles enfants peuvent être ajoutés ou supprimés de cette collection. La hiérarchie des contrôles est généralement configurée dans la méthode Load() du contrôle.

Attributes(NameValueCollection)
Délivre un espace générique pour stocker des couples clé/valeur. Ceci est très utile pour les applets descendantes car elles peuvent stocker leur collection Attributes qui supporte un simple chargement et enregistrement dans le système de fichiers. Consulter NameValueCollection et FileWrite() pour plus d'informations à ce sujet.

Evènements

OnClick(Control sender, int x, int y)
Capture le clic de l'utilisateur sur le contrôle donné. L'évènement se produira seulement si le contrôle et tous les contrôles parent présents sur l'écran sont visibles et que chacun de ces contrôles contient le point (x,y).

OnClickHold(Control sender, int x, int y)
Capture le clic de l'utilisateur et le maintien pour une période donnée sur le contrôle. L'évènement se produira seulement si le contrôle et tous les contrôles parent présents sur l'écran sont visibles et que chacun de ces contrôles contient le point (x,y) et que l'utilisateur ne bouge pas son stylet (ou son doigt) durant l'action.

Méthodes

void SetBounds(int x, int y)
Déplace un contrôle aux coordonnées spécifiées, qui sont relatives aux limite du contour du contrôle parent.


void SetBounds(int x, int y, int w)
Déplace un contrôle aux coordonnées spécifiées, qui sont relatives aux limite du contour du contrôle parent et définit la largeur du contrôle.

void SetBounds(int x, int y, int w, int h)
Déplace un contrôle aux coordonnées spécifiées, qui sont relatives aux limites du contour du contrôle parent et définit la largeur ainsi que la hauteur du contrôle.

int GetLeft()
Retourne le bord gauche du contrôle sous la forme d'un entier corresponant à sa position relative par rapport aux bords du contrôle parent.

int GetTop()
Retourne le bord haut du contrôle sous la forme d'un entier corresponant à sa position relative par rapport aux bords du contrôle parent.

int GetWidth()
Retourne la largeur du contrôle.

int GetHeight()
Retourne la hauteur du contrôle.

void SetClipping(int x, int y, int w, int h)
Spécifie l'aire dans laquelle sera appliqué le redimensionnement. Les descendants de la classe Control en tiennent compte pour le rendu de leur contenu et ne dessineront pas en dehors de l'aire spécifiée.

void SetOpacity(int opacity)
Définit le niveau d'opacité du contrôle à appliquer lors du dessin du contrôle. Chaque contrôle interprète cette valeur à sa façon. Pas exemple, un contrôle Image utilisera directement cette valeur pour restituer son image à l'écran et traitera l'image en fonction de l'opacité désirée.



void SetSelected(bool selected)
Définit si le contrôle est sélectionné ou pas. Par exemple, cette méthode sera utilisée sur le contrôle Button afin de déterminer quelle image affichée (état normal ou état sélectionné).

void SetVisible(bool visible)
Définit si le contrôle est visible ou pas. En masquant un contrôle (visible = false), tous ses contrôles enfant seront automatiquement masqués.

void AnimateClear()
Efface toutes les animations qui existaient pour le contrôle. Il est recommandé d'appeler cette méthode avant d'appliquer les animations aux contrôles qui possèdent des animations récurrentes. Cela permet d'éviter que des animations parallèles rentrent en conflit les unes avec les autres. Par exemple, si vous définissez deux animations AnimateMove() successives afin qu'elle se déroule en même temps, chacune essaiera de déplacer le contrôle à sa position respective et le contrôle risque de finir sa course sur une position non attendue.


void AnimateMove(int destX, int destY, float maxSpeed)
void AnimateMove(int destX, int destY, float maxSpeed, float startEasing)
void AnimateMove(int destX, int destY, float maxSpeed, float startEasing, float endEasing)
void AnimateMove(int destX, int destY, float maxSpeed, float startEasing, float endEasing, int startDelay)

Déplace le contrôle de sa position courante à la destination spécifiée (position destX, destY), qui sont les coordonnées relatives aux limites du contour du contrôle parent.



void AnimateFade(int startOpacity, int targetOpacity, float speed)
void AnimateFade(int startOpacity, int targetOpacity, float speed, float startDelay)

Effet de fondu en ouveture ou en fermeture sur le contrôle.



void AnimateAscend()

void SetTabStop(bool tabStopEnabled)
Définit si le contrôle doit être accessible dans le chemin de navigation avec le DPad (ou tout autre bouton physique).

void SetPadding(int allSides)
void SetPadding(int topAndBottom, int leftAndRight)
void SetPadding(int top, int right, int bottom, int left)

Définit l'espacement du contrôle par rapport aux bords (ajustement du cadrage). L'impact que cela aura sur chaque contrôle dépend de la manière dont le contrôle interprète cette valeur. Par exemple, un contrôle Label ajustera la position du texte en se basant sur la justification spécifiée.



void AlignTo(Control control, String horizontalAlign, String verticalAlign)

Positionne le contrôle par rapport au contrôle spécifié dans la méthode en fonction des valeurs de justification horizontale et verticale.



void BringToFront()
Place le contrôle en première position pour l'ordre de tabulation (prise de focus avec le Dpad) par rapport aux contrôles frères ou soeurs (i.e. de même niveau hiérarchique).

void SendToback()
Place le contrôle en dernière position pour l'ordre de tabulation (prise de focus avec le Dpad) par rapport aux contrôles frères ou soeurs (i.e. de même niveau hiérarchique).

void SetID(String id)
Définit d'identifiant du contrôle qui peut être utilisé pour l'identifier de manière unique.

void Load()
Cette méthode est appelée par le système une fois que le contrôle a été initialisé. Elle est primordiale et contient du code pour définir la hiérarchie du contrôle et initialise toutes ses valeurs.