Le WIKI francophone consacré à Windows Phone et à Android ...

Pointui Home 2 - Control

RSS
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.

  • Paramètre
    • opacity valeur comprise entre 0 (transparence complète) à 100 (complètement opaque).


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.

  • Paramètres
    • destX, destY coordonnées (abscisse, ordonnée) du point de destination cible où déplacer le contrôle
    • maxSpeed nombre de pixels pour déplacer chaque image lors d'un déplacement à vitesse maximale
    • startEasing nombre de pixels pour accélérer chaque image jusqu'à atteindre maxSpeed.
    • endEasing valeur comprise entre 0.0 (prend effet immédiatement, dès que l'animation débute) et 1.0 (prend effet lorsque le contrôle a parcouru 100% de la distance qui le sépare de sa destination ; en d'autres mots, aucun effet d'animation). Par exemple, une valeur de 0.5 permet de lancer lanimation lorsque le contrôle a parcouru 50% de la distance. Ce parmètre permet de ralentir la vitesse du contrôle lorsqu'il approche de sa destination finale.
    • startDelay nombre d'images en pause dans l'animation avant qu'elle ne démarre.


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.

  • Paramètres
    • startOpacity valeur comprise entre 0 (complètement transparent) à 100 (complètement opaque). Si le contrôle n'est pas affichée avec l'opacité spécifiée quand l'animation démarre, elle sera automatiquement appliquée. Additionnellement, une valeur -1 peut être utilisée si le niveau d'opacité courant du contrôle ne doit pas être altéré.
    • targetOpacity valeur du niveau d'opacité à atteindre
    • startDelay nombre d'images en pause dans l'animation avant qu'elle ne démarre.


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.

  • Paramètres
    • allSides espacement en pixels à appliquer sur tous les côtés du contrôle.
    • topAndBottom espacement à appliquer sur les bords haut et bas du contrôle.
    • leftAndRight espacement à appliquer sur les bords gauche et droit du contrôle.
    • top, right, bottom, left espacements à appliquer aux bords haut, droit, bas et gauche du contrôle.


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.

  • Paramètres
    • control contrôle sur lequel se baser pour le positionnement.
    • horizontalAlign peut prendre une des valeurs suivantes :
      • "Left" cadré à gauche
      • "Center" centré
      • "Right" cadré à droite
    • verticalAlign peut prendre une des valeurs suivantes :
      • "Top" cadré en haut
      • "Center" centré
      • "Bottom" cadré en bas


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.

Copyright 2012 CordoWEB