IContainer  - AS3 Flex

Spécifie le mode de bouton du sprite. Si la valeur true est renvoyée, ce sprite se comporte comme un bouton, ce qui signifie qu’il déclenche l’affichage du curseur en forme de main lorsque le pointeur le survole et qu’il peut recevoir un événement click si l’utilisateur appuie sur la touche Entrée ou la barre d’espacement lorsque le sprite dispose du focus. Pour remplacer le curseur en forme de main par le pointeur standard, réglez la propriété useHandCursor sur false.

Bien qu’il soit préférable d’utiliser la classe SimpleButton pour créer des boutons, la propriété buttonMode permet d’affecter à un sprite une fonctionnalité similaire à celle d’un bouton. Pour inclure un sprite dans l’ordre de tabulation, réglez la propriété tabEnabled (héritée de la classe InteractiveObject et réglée sur false par défaut) sur true. Demandez-vous en outre si les enfants de votre sprite doivent prendre en charge la saisie utilisateur. La plupart des boutons n’activent pas l’interactivité avec la saisie utilisateur pour leurs objets enfant, en raison de son impact sur le flux d’événements. Pour désactiver l’interactivité avec la saisie utilisateur pour tous les objets enfant, définissez la propriété mouseChildren (héritée de la classe DisplayObjectContainer) sur false.

Si vous utilisez la propriété buttonMode avec la classe MovieClip (une sous-classe de la classe Sprite), la fonctionnalité de votre bouton risque d’être enrichie. Si vous incluez les étiquettes d’images _up, _over et _down, Flash Player gère les changements d’état automatiques (fonctionnalité similaire à celle intégrée aux versions antérieures d’ActionScript pour les clips utilisés en tant que boutons). Ces changements d’état automatiques ne sont pas disponibles pour les sprites, qui ne disposent pas de scénario et donc, pas d’images à étiqueter.

Les conteneurs utilisent un volet de contenu interne pour contrôler le défilement. La propriété creatingContentPane a la valeur true lorsque le conteneur crée le panneau de contenu. Certains événements peuvent donc être ignorés ou bloqués.

Contrôle Button désigné comme bouton par défaut pour le conteneur. Lorsque les contrôles du conteneur ont le focus, l’activation de la touche Entrée revient à cliquer sur ce contrôle Button.

Spécifie si l’objet reçoit les événements doubleClick. La valeur par défaut est false, ce qui signifie que, par défaut, une occurrence d’InteractiveObject ne reçoit pas les événements doubleClick. Si la propriété doubleClickEnabled est réglée sur true, l’occurrence reçoit les événements doubleClick qui la concernent. La propriété mouseEnabled de l’occurrence d’InteractiveObject doit également être réglée sur true pour que l’objet reçoive les événements doubleClick.

Définir cette propriété ne distribue aucun événement. Vous devez utiliser la méthode addEventListener() pour ajouter un écouteur d’événement à l’événement doubleClick.

Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé.

Récupère le FocusManager qui contrôle le focus pour ce composant et ses homologues. Chaque fenêtre contextuelle possède sa propre boucle de focus et donc sa propre instance du gestionnaire FocusManager. Pour vous assurer de parler au gestionnaire concerné, utilisez cette méthode.

Spécifie si l’objet affiche un rectangle de focus. Trois valeurs sont possibles : true, false ou null. Les valeurs true et false fonctionnent comme prévu, c’est-à-dire indiquent si le rectangle du focus s’affiche. La valeur null indique que cet objet dépend de la propriété stageFocusRect de la scène.

Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel.

Désigne un autre sprite qui fera office de zone active d’un sprite. Si la propriété hitArea n’existe pas, ou si sa valeur est null ou undefined, le sprite fait office de zone active. La valeur de la propriété hitArea peut être une référence à un objet Sprite.

Vous pouvez modifier la propriété hitArea à tout moment ; le sprite modifié accepte immédiatement le nouveau comportement de la zone active. Il n’est pas nécessaire que le sprite désigné comme zone active soit visible ; bien qu’elle ne soit pas visible, sa forme graphique est encore détectée comme zone active.

Remarque : vous devez définir sur false la propriété mouseEnabled du sprite désigné comme zone active. Dans le cas contraire, votre bouton sprite risque de ne pas fonctionner, car c’est le sprite désigné comme zone active qui reçoit les événements de saisie utilisateur et non le bouton sprite.

Position actuelle de la barre de défilement horizontale. Cette valeur est égale à la distance en pixels entre le bord gauche de la surface défilante et la partie la plus à gauche de la surface actuellement visible.

Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. Si tel est le cas, un utilisateur peut manipuler l’objet à l’aide de la souris ou du périphérique de saisie utilisateur. La valeur par défaut est true.

Cette propriété s’avère utile lorsque vous créez un bouton avec une occurrence de la classe Sprite (au lieu d’utiliser la classe SimpleButton). Si vous utilisez une occurrence de Sprite pour créer un bouton, vous pouvez le décorer à l’aide de la méthode addChild() pour ajouter d’autres occurrences de Sprite. Ce processus risque d’associer un comportement imprévu aux événements de souris, car les occurrences de Sprite ajoutées en tant qu’enfants peuvent devenir l’objet cible d’un événement de souris alors que vous vous attendiez à ce que ce dernier corresponde à l’occurrence parent. Pour vous assurer que l’occurrence parent serve d’objet cible pour les événements de souris, vous pouvez régler la propriété mouseChildren de l’occurrence parent sur false.

Définir cette propriété ne distribue aucun événement. La méthode addEventListener() vous permet de créer une fonctionnalité interactive.

Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. La valeur par défaut est true, ce qui signifie que, par défaut, toute occurrence d’InteractiveObject figurant dans la liste d’affichage reçoit des événements de souris ou d’autres événements de saisie utilisateur. Si la propriété mouseEnabled est définie sur false, l’occurrence ne reçoit aucun événement de souris (ni aucun autre événement de saisie utilisateur, tel qu’un événement de clavier). Aucun enfant de cette occurrence figurant dans la liste d’affichage n’est affecté. Pour modifier le comportement mouseEnabled de tous les enfants d’un objet figurant dans la liste d’affichage, utilisez flash.display.DisplayObjectContainer.mouseChildren.

Définir cette propriété ne distribue aucun événement. La méthode addEventListener() vous permet de créer une fonctionnalité interactive.

Renvoie le nombre d’enfants de l’objet.

Contrôle le son à l’intérieur du sprite.

Remarque : cette propriété n’affecte pas le contenu HTML d’un objet HTMLControl (dans Adobe AIR).

Détermine si les enfants de l’objet prennent ou non en charge la tabulation.

Remarque : n’utilisez pas cette propriété avec Flex. Utilisez plutôt la propriété UIComponent.hasFocusableChildren.

Eléments de l’API associés

Indique si cet objet est spécifié dans l’ordre de tabulation. Lorsque cet objet figure dans l’ordre de tabulation, la valeur est true. Sinon, elle est false. La valeur par défaut est false, sauf pour les éléments suivants :

• Pour un objet SimpleButton, la valeur est true.
• Pour un objet TextField avec type = "input", la valeur est true.
• Pour un objet Sprite ou MovieClip avec buttonMode = true, la valeur true.

Spécifie l’ordre de tabulation des objets dans un fichier SWF. La propriété tabIndex est réglée sur -1 par défaut, ce qui signifie qu’aucun index de tabulation n’est associé à l’objet.

Si un objet actuellement affiché dans le fichier SWF contient une propriété tabIndex, l’ordre de tabulation automatique est désactivé : l’ordre de tabulation est alors calculé à partir des propriétés tabIndex des objets contenus dans le fichier SWF. L’ordre de tabulation personnalisé inclut uniquement les objets dotés de propriétés tabIndex.

La propriété tabIndex peut être un entier non négatif. Les objets sont triés selon leurs propriétés tabIndex, par ordre croissant. Un objet dont la valeur de tabIndex est définie sur 1 précède celui dont la valeur de tabIndex est 2. N’appliquez pas la même valeur tabIndex à plusieurs objets.

L’ordre de tabulation personnalisé défini par la propriété tabIndex est flat. Cela signifie que les relations hiérarchiques des objets contenus dans le fichier SWF ne sont pas prises en compte. Tous les objets du fichier SWF dotés de propriétés tabIndex sont placés dans l’ordre de tabulation, qui est déterminé par l’ordre des valeurs tabIndex.

Remarque : pour définir l’ordre de tabulation des occurrences de TLFTextField, distribuez l’objet d’affichage enfant de TLFTextField en tant qu’objet InteractiveObject, puis définissez la propriété tabIndex. Par exemple :

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer.

Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true. La valeur par défaut de la propriété useHandCursor est true. Si la propriété useHandCursor est définie sur true, le curseur en forme de main utilisé pour les boutons s’affiche lorsque le pointeur survole un sprite. Si la propriété useHandCursor est définie sur false, le pointeur flèche est utilisé.

Vous pouvez modifier la propriété useHandCursor à tout moment ; le sprite modifié accepte immédiatement la nouvelle apparence du curseur.

Remarque : dans Flex ou Flash Builder, si votre sprite possède des sprites enfants, vous pouvez définir la propriété mouseChildren sur false. Par exemple, si vous souhaitez qu’un curseur en forme de main apparaisse sur une commande Flex <mx:Label>, réglez les propriétés useHandCursor et buttonMode sur true, et la propriété mouseChildren sur false.

Position actuelle de la barre de défilement verticale. Cette valeur est égale à la distance en pixels entre le bord supérieur de la surface défilante et la partie située tout en haut de la surface actuellement visible.

Renvoie un objet qui comporte quatre propriétés : left, top, right et bottom. La valeur de chaque propriété est égale à l’épaisseur du chrome (éléments visuels) autour du bord du conteneur.

Le chrome comprend l’épaisseur de la bordure. Si la propriété horizontalScrollPolicy ou verticalScrollPolicy a la valeur ScrollPolicy.ON, le chrome comprend également l’épaisseur de la barre de défilement correspondante. Si la stratégie de défilement est ScrollPolicy.AUTO, la mesure du chrome n’inclut pas l’épaisseur de la barre de défilement, même si une barre de défilement est affichée.

Les sous-classes de la classe Container doivent remplacer cette méthode, de sorte à inclure le chrome supplémentaire à prendre en compte lors du positionnement des enfants du conteneur. Par exemple, la propriété viewMetrics de la classe Panel doit renvoyer un objet dont la propriété top inclut l’épaisseur de la barre de titre du conteneur Panel.

Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. L’enfant est ajouté devant (par-dessus) tous les autres enfants dans cette occurrence de DisplayObjectContainer (pour ajouter un enfant à une position d’index spécifique, utilisez la méthode addChildAt()).

Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.

Remarque : la commande stage.addChild() risque de poser certains problèmes avec un fichier SWF publié, notamment des problèmes de sécurité et des conflits avec d’autres fichiers SWF chargés. Il n’existe qu’une seule scène au sein d’une occurrence du moteur d’exécution de Flash, quel que soit le nombre de fichiers SWF que vous chargez dans le moteur d’exécution. Ainsi, en règle générale, les objets ne devraient pas être ajoutés à la scène directement. Le seul objet que la scène devrait contenir est l’objet racine. Créez un objet DisplayObjectContainer qui contienne tous les éléments de la liste d’affichage. Le cas échéant, ajoutez ensuite cette occurrence de DisplayObjectContainer sur la scène.

Paramètres

Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. L’enfant est placé à la position d’index spécifiée. La position d’index 0 représente la fin (le bas) de la liste d’affichage pour cet objet DisplayObjectContainer.

Ainsi, l’exemple suivant illustre trois objets d’affichage appelés a, b et c, qui occupent respectivement les positions d’index 0, 2 et 1 :

Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.

Paramètres

Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point point spécifié. Par défaut, le contenu d’un domaine ne peut pas accéder aux objets d’un autre domaine, à moins d’y être autorisé via un appel de la méthode Security.allowDomain(). Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Le paramètre point est exprimé dans l’espace de coordonnées de la scène, qui risque d’être différent de l’espace de coordonnées du conteneur d’objet d’affichage (à moins que ce dernier ne corresponde à la scène). Vous pouvez utiliser les méthodes globalToLocal() et localToGlobal() pour passer d’un espace de coordonnées à l’autre.

Paramètres

Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. La recherche comprend la liste d’affichage entière, y compris cette occurrence de DisplayObjectContainer. Les petits-enfants, les arrière-petits-enfants, et ainsi de suite renvoient chacun la valeur true.

Paramètres

Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié.

Paramètres

Renvoie l’objet d’affichage enfant portant le nom spécifié. Si plusieurs objets d’affichage enfant portent le nom spécifié, la méthode renvoie le premier objet de la liste d’enfants.

La méthode getChildAt() est plus rapide que la méthode getChildByName(). La méthode getChildAt() accède à un enfant à partir d’un tableau en mémoire cache, tandis que la méthode getChildByName() doit parcourir une liste liée pour accéder à l’enfant.

Paramètres

Renvoie la position d’index d’une occurrence child de DisplayObject.

Paramètres

Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. Tout objet enfant auquel il est impossible d’accéder pour des raisons de sécurité est omis du tableau renvoyé. Pour vérifier si cette restriction de sécurité affecte le tableau renvoyé, appelez la méthode areInaccessibleObjectsUnderPoint().

Le paramètre point est exprimé dans l’espace de coordonnées de la scène, qui risque d’être différent de l’espace de coordonnées du conteneur d’objet d’affichage (à moins que ce dernier ne corresponde à la scène). Vous pouvez utiliser les méthodes globalToLocal() et localToGlobal() pour passer d’un espace de coordonnées à l’autre.

Paramètres

Supprime l’occurrence child de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. La propriété parent de l’enfant supprimé est réglée sur null et l’objet est nettoyé s’il n’existe aucune autre référence à l’enfant. Les positions d’index de tout objet d’affichage placé au-dessus de l’enfant dans DisplayObjectContainer sont diminuées d’une unité.

Le processus de nettoyage de la mémoire réaffecte l’espace mémoire non utilisé. Lorsqu’une variable ou un objet n’est plus référencé ou stocké de façon active, le nettoyeur de mémoire vide toutes ses références en mémoire qui ne sont plus utilisées.

Paramètres

Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. La propriété parent de l’enfant supprimé est réglée sur null et l’objet est nettoyé s’il n’existe aucune autre référence à l’enfant. Les positions d’index de tout objet d’affichage placé au-dessus de l’enfant dans DisplayObjectContainer sont diminuées d’une unité.

Le processus de nettoyage de la mémoire réaffecte l’espace mémoire non utilisé. Lorsqu’une variable ou un objet n’est plus référencé ou stocké de façon active, le nettoyeur de mémoire vide toutes ses références en mémoire qui ne sont plus utilisées.

Paramètres

Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. L’ordre des objets enfant est alors affecté. Ainsi, l’exemple suivant illustre trois objets d’affichage appelés a, b et c, qui occupent respectivement les positions d’index 0, 1 et 2 :

Lorsque vous utilisez la méthode setChildIndex() et spécifiez une position d’index déjà occupée, les seules positions qui changent sont celles situées entre l’ancienne et la nouvelle position de l’objet d’affichage. Toutes les autres positions restent identiques. Si un enfant est déplacé sur un index INFERIEUR à son index actuel, tous les enfants situés entre les deux sont AUGMENTES de 1 pour leur référence d’index. Si un enfant est déplacé sur un index SUPERIEUR à son index actuel, tous les enfants situés entre les deux sont DIMINUES de 1 pour leur référence d’index. Par exemple, si le conteneur d’objet d’affichage de l’exemple précédent s’appelle container, vous pouvez permuter la position des objets d’affichage a et b en appelant le code suivant :

container.setChildIndex(container.getChildAt(1), 0);

Ce code entraîne la réorganisation suivante des objets :

Paramètres

Permet à l’utilisateur de faire glisser le sprite spécifié. Il reste possible de faire glisser le sprite jusqu’à l’arrêt explicite de cette action par un appel à la méthode Sprite.stopDrag() ou lorsqu’un autre sprite est rendu déplaçable. Vous ne pouvez déplacer qu’un seul sprite à la fois.

Les objets d’affichage tridimensionnels suivent le pointeur et la méthode Sprite.startDrag() déplace l’objet dans le plan tridimensionnel défini par l’objet d’affichage. Si l’objet d’affichage est un objet bidimensionnel et l’enfant d’un objet tridimensionnel, l’objet bidimensionnel se déplace dans le plan tridimensionnel défini par l’objet parent tridimensionnel.

Paramètres

Met fin à la méthode startDrag(). Un sprite qu’il est possible de déplacer grâce à la méthode startDrag() reste déplaçable jusqu’à ce qu’une autre méthode stopDrag() soit ajoutée, ou jusqu’à ce qu’un autre sprite devienne déplaçable. Vous ne pouvez déplacer qu’un seul sprite à la fois.

Intervertit l’ordre z (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. Tous les autres objets enfant du conteneur d’objet d’affichage conservent leur position d’index.

Paramètres

Intervertit l’ordre z (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. Tous les autres objets enfant du conteneur d’objet d’affichage conservent leur position d’index.

Paramètres