Package | spark.components |
Classe | public class ToggleButton |
Héritage | ToggleButton ToggleButtonBase ButtonBase SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Sous-classes | AXMToggleButton, ButtonBarButton |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Etant donné que ce composant ne définit pas d’habillage pour le thème mobile, Adobe recommande de ne pas l’utiliser dans une application mobile. Alternativement, vous pouvez définir votre propre habillage mobile pour le composant. Pour plus d’informations, voir Notions de base sur l’habillage mobile. |
Le composant ToggleButton définit un bouton bascule. Le fait de cliquer sur le bouton permet de passer alternativement de l’état relevé à l’état abaissé. Si vous cliquez sur le bouton alors que celui-ci est à l’état relevé, il passe à l’état abaissé. Vous devez cliquer à nouveau sur le bouton pour repasser à l’état relevé.
Cet état peut être obtenu ou défini par programmation, par le biais de la propriété selected
.
Pour utiliser ce composant d’un composant à base de listes (par exemple List ou DataGrid) créez une option de rendu d’élément. Pour plus d’informations sur la création d’une option de rendu d’élément, consultez la section Options personnalisées de rendu d’élément Spark.
Le contrôle ToggleButton possède les caractéristiques par défaut suivantes :
Caractéristique | Description |
---|---|
Taille par défaut | Suffisamment large pour afficher l’étiquette de texte du contrôle |
Taille minimale | 21 pixels de large et 21 pixels de haut |
Taille minimale | 10000 pixels de large et 10000 pixels de haut |
Classe d’habillage par défaut | spark.skins.spark.ToggleButtonSkin |
The <s:ToggleButton>
tag inherits all of the tag
attributes of its superclass and adds no tag attributes:
<s:ToggleButton/>
Propriété MXML par défautlabel
Eléments de l’API associés
Méthode | Défini par | ||
---|---|---|---|
Constructeur. | ToggleButton | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Ajoute un client de style non visuel à cette instance de composant. | UIComponent | ||
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é. | DisplayObjectContainer | ||
Place en attente une fonction à appeler ultérieurement. | UIComponent | ||
Définit une propriété de style depuis cette instance de composant. | UIComponent | ||
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. | DisplayObjectContainer | ||
Convertit un objet Point de coordonnées de contenu en coordonnées globales. | UIComponent | ||
Convertit un objet Point de coordonnées de contenu en coordonnées locales. | UIComponent | ||
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. | UIComponent | ||
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. | UIComponent | ||
Crée une référence id pour cet objet IUIComponent sur son objet document parent. | UIComponent | ||
Supprime la référence d’id à cet objet IUIComponent sur son objet de document parent. | UIComponent | ||
Renvoie un objet UITextFormat correspondant aux styles du texte pour ce composant UIComponent. | UIComponent | ||
[override]
Distribue un événement dans le flux d’événements. | UIComponent | ||
Affiche ou masque l’indicateur de focus autour de ce composant. | UIComponent | ||
drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Trace par programmation un rectangle dans l’objet Graphics de cet habillage. | UIComponent | ||
Appelé par l’instance d’effet lors de la fin de sa lecture sur le composant. | UIComponent | ||
Appelé par l’instance d’effet lors du début de sa lecture sur le composant. | UIComponent | ||
Termine tous les effets en cours de lecture sur le composant. | UIComponent | ||
Exécute toutes les liaisons dont l’objet UIComponent est la destination. | UIComponent | ||
Appelée après la fin de l’impression. | UIComponent | ||
Fournit l’objet d’automatisation à l’index spécifié. | UIComponent | ||
Fournit la liste d’objets d’automatisation. | UIComponent | ||
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | ||
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | UIComponent | ||
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | UIComponent | ||
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | ||
Recherche les sélecteurs de type de cette instance UIComponent. | UIComponent | ||
Renvoie une valeur de contrainte de présentation, ce qui revient à obtenir le style de contrainte pour ce composant. | UIComponent | ||
Méthode pratique pour déterminer si la hauteur explicite ou mesurée doit être utilisée
| UIComponent | ||
Méthode pratique pour déterminer si la largeur explicite ou mesurée doit être utilisée
| UIComponent | ||
Récupère l’objet ayant actuellement le focus. | UIComponent | ||
Renvoie la hauteur de présentation de l’élément. | UIComponent | ||
Renvoie la largeur de la présentation de l’élément. | UIComponent | ||
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | UIComponent | ||
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | UIComponent | ||
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | UIComponent | ||
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | UIComponent | ||
Renvoie la hauteur maximale de l’élément. | UIComponent | ||
Renvoie la largeur maximale de l’élément. | UIComponent | ||
Renvoie la hauteur minimale de l’élément. | UIComponent | ||
Renvoie la largeur minimale de l’élément. | UIComponent | ||
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. | DisplayObjectContainer | ||
Renvoie la hauteur préférée de l’élément. | UIComponent | ||
Renvoie la largeur préférée de l’élément. | UIComponent | ||
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | ||
Renvoie l’élément de l’objet dataProvider utilisé par le composant Repeater spécifié pour produire ce composant Repeater, ou null si ce composant Repeater n’est pas répété. | UIComponent | ||
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant. | UIComponent | ||
Convertit un objet Point de coordonnées globales en coordonnées de contenu. | UIComponent | ||
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | ||
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | ||
Renvoie true si la valeur currentCSSState n’est pas nulle. | UIComponent | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Détermine si l’état spécifié a été défini sur ce composant UIComponent. | UIComponent | ||
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | ||
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | ||
Renvoie une matrice de zone pouvant être transmise à la méthode drawRoundRect() en tant que paramètre rot lors du tracé d’un dégradé horizontal. | UIComponent | ||
Initialise la structure interne de ce composant. | UIComponent | ||
Initialise différentes propriétés qui effectuent le suivi des instances répétées de ce composant. | UIComponent | ||
Marque un composant de sorte que sa méthode updateDisplayList() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | ||
Appelé par les éléments d’un composant pour indiquer que leur propriété de profondeur a changé. | UIComponent | ||
Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change. | UIComponent | ||
Marque un composant de sorte que sa méthode commitProperties() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | ||
Marque un composant de sorte que sa méthode measure() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | ||
Marque le composant de sorte que le nouvel état de l’habillage soit défini lors d’une actualisation d’écran ultérieure. | SkinnableComponent | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | ||
Convertit un objet Point de coordonnées locales en coordonnées de contenu. | UIComponent | ||
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | ||
Renvoie la valeur true si cssState correspond à currentCSSState. | UIComponent | ||
Détermine si l’instance est identique au, ou est une sous-classe du, type donné. | UIComponent | ||
Mesure le texte HTML spécifié, pouvant contenir des balises HTML telles que <font> et <b>, en supposant qu’il s’affiche sur un objet UITextField à une seule ligne, avec un format UITextFormat déterminé par les styles de ce composant UIComponent. | UIComponent | ||
Mesure le texte spécifié, en supposant qu’il s’affiche sur un objet UITextField (ou UIFTETextField) à une seule ligne, avec un format UITextFormat déterminé par les styles de ce composant UIComponent. | UIComponent | ||
Déplace le composant vers une position spécifiée dans son parent. | UIComponent | ||
Propage les modifications de style aux enfants. | UIComponent | ||
Renvoie true si la chaîne de propriétés du propriétaire pointe de l’enfant vers ce composant UIComponent. | UIComponent | ||
Appelé par Flex lorsqu’un composant UIComponent est ajouté à ou supprimé d’un parent. | UIComponent | ||
Prépare un objet IFlexDisplayObject pour l’impression. | UIComponent | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Génère ou régénère le cache de style CSS pour ce composant et, si le paramètre recursive a la valeur true, pour tous les descendants de ce composant également. | UIComponent | ||
Pour chaque événement d’effet, enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement. | UIComponent | ||
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Supprime un client de style non visuel de cette instance de composant. | UIComponent | ||
Réexécute l’événement spécifié. | UIComponent | ||
Affiche un clavier virtuel. | InteractiveObject | ||
Résout un enfant en utilisant l’ID fourni. | UIComponent | ||
[statique]
Reprend le traitement en arrière-plan des méthodes mises en attente par la méthode callLater(), après un appel à la méthode suspendBackgroundProcessing(). | UIComponent | ||
Dimensionne l’objet. | UIComponent | ||
Définit une valeur de contrainte de présentation, ce qui revient à définir le style de contrainte pour ce composant. | UIComponent | ||
Définir l’état actuel. | UIComponent | ||
Définit le focus sur ce composant. | UIComponent | ||
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | UIComponent | ||
Définit la taille de la présentation de l’élément. | UIComponent | ||
Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères. | UIComponent | ||
Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères. | UIComponent | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit une propriété de style pour cette instance de composant. | UIComponent | ||
Appelé lorsque la propriété visible est modifiée. | UIComponent | ||
Permet à l’utilisateur de faire glisser le sprite spécifié. | Sprite | ||
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile. | Sprite | ||
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine. | DisplayObjectContainer | ||
Met fin à la méthode startDrag(). | Sprite | ||
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles. | Sprite | ||
Détecte les modifications apportées aux propriétés de style. | UIComponent | ||
Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés. | UIComponent | ||
[statique]
Bloque le traitement en arrière-plan des méthodes placées en attente par callLater(), jusqu’à l’appel de la méthode resumeBackgroundProcessing(). | UIComponent | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Renvoie une chaîne indiquant l’emplacement de l’objet dans la hiérarchie des objets DisplayObject de l’application. | FlexSprite | ||
transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent. | UIComponent | ||
Méthode utilitaire permettant de transformer un point spécifié dans les coordonnées locales de cet objet en emplacement dans les coordonnées du parent de l’objet. | UIComponent | ||
Valide la position et la taille des enfants, et trace d’autres effets visuels. | UIComponent | ||
Valide et actualise les propriétés et la présentation de cet objet, puis le retrace si nécessaire. | UIComponent | ||
Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties(). | UIComponent | ||
Valide la taille mesurée du composant si la méthode LayoutManager.invalidateSize() est appelée avec cette interface ILayoutManagerClient, puis la méthode validateSize() est appelée lorsqu’il est temps d’effectuer les mesures. | UIComponent | ||
Traite à la fois les événements valid et invalid d’une classe Validator assignée à ce composant. | UIComponent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Renvoie une matrice de zone pouvant être transmise à la méthode drawRoundRect() en tant que paramètre rot lors du tracé d’un dégradé vertical. | UIComponent | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
Ce composant utilise des habillages constitués de parties d’habillage. Ne définissez pas les parties d’habillage directement. L’habillage du composant définit les parties d’habillage.
Pour appliquer un habillage au composant, implémentez un habillage qui définit les états suivants. Bien que vous deviez implémenter tous les états d’habillage, l’état de l’habillage peut être vide. Un état d’habillage vide indique qu’aucune modification n’a été apportée à l’état d’habillage par défaut.
ToggleButton | () | Constructeur |
public function ToggleButton()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
<?xml version="1.0"?> <!-- Simple example to demonstrate the Spark ToggleButton control --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> <![CDATA[ // Event handler function to print a message // describing the Spark ToggleButton selected state. // Toggle the fontWeight of the Label between bold and normal private function printMessage(evt:Event):void { if (evt.target.selected){ message.text += "fontWeight: bold" + "\n"; lbl.setStyle("fontWeight", "bold"); togBtn.label = "Bold"; } else{ message.text += "fontWeight: normal" + "\n"; lbl.setStyle("fontWeight", "normal"); togBtn.label = "Normal"; } } ]]> </fx:Script> <s:Panel title="Spark ToggleButton Control Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:VGroup left="10" right="10" top="10" bottom="10"> <s:ToggleButton id="togBtn" label="Normal" click="printMessage(event);" /> <s:Label id="lbl" text="Label" /> <s:TextArea id="message" height="100%" width="100%" color="#0000FF" /> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 09:30 AM Z