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