mx.controls.sliderClassesSlider La classe Slider est la classe de base des contrôles de curseur Flex.The Slider class cannot be used as an MXML tag. Use the <mx:HSlider> and <mx:VSlider> tags instead. However, the Slider class does define tag attributes used by the <mx:HSlider> and <mx:VSlider> tags.

The Slider class inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:tagname
    Properties
    allowThumbOverlap="false|true"
    allowTrackClick="true|false"
    dataTipFormatFunction="undefined"
    direction="horizontal|vertical"
    labels="undefined"
    liveDragging="false|true"
    maximum="10"
    minimum="0"
    showDataTip="true|false"
    sliderDataTipClass="sliderDataTip"
    sliderThumbClass="SliderThumb"
    snapInterval="0"
    thumbCount="1"
    tickInterval="0"
    tickValues="undefined"
    value="The value of the minimum property."
 
    Styles
    borderColor="0x919999"
    dataTipOffset="16"
    dataTipPrecision="2"
    dataTipStyleName="undefined"
    fillAlphas="[0.6, 0.4, 0.75, 0.65]"
    fillColors="[0xFFFFFF, 0xCCCCCC, 0xFFFFFF, 0xEEEEEE;]"
    labelOffset="-10"
    labelStyleName="undefined"
    showTrackHighlight="false"
    slideDuration="300"
    slideEasingFunction="undefined"
    thumbDisabledSkin="SliderThumbSkin"
    thumbDownSkin="SliderThumbSkin"
    thumbOffset="0"
    thumbOverSkin="SliderThumbSkin"
    thumbUpSkin="SliderThumbSkin"
    tickColor="0x6F7777"
    tickLength="3"
    tickOffset="-6"
    tickThickness="1"
    trackColors="[ 0xEEEEEE, 0xFFFFFF ]"
    tracHighlightSkin="SliderHighlightSkin"
    trackMargin="undefined"
    trackSkin="SliderTrackSkin"
  
    Events
    change="No default"
    thumbDrag="No default"
    thumbPress="No default"
    thumbRelease="No default"
  />
]]>mx.core:UIComponent La classe Slider est la classe de base des contrôles de curseur Flex. Le curseur permet aux utilisateurs de sélectionner une valeur en le déplaçant entre les deux extrémités de la glissière. La valeur actuelle du curseur est déterminée par son emplacement relatif entre ses extrémités, ce qui correspond aux valeurs minimum et maximum du curseur. La classe Slider se subdivise en sous-classes HSlider et VSlider. thumbRelease Distribué lorsque le curseur est relâché, ce qui signifie que l’utilisateur relâche le bouton de la souris après un événement thumbPress.mx.events.SliderEvent.THUMB_RELEASEmx.events.SliderEvent Distribué lorsque le curseur est relâché, ce qui signifie que l’utilisateur relâche le bouton de la souris après un événement thumbPress. thumbPress Distribué lorsque le curseur est activé, ce qui signifie que l’utilisateur appuie sur le bouton de la souris sur le curseur.mx.events.SliderEvent.THUMB_PRESSmx.events.SliderEvent Distribué lorsque le curseur est activé, ce qui signifie que l’utilisateur appuie sur le bouton de la souris sur le curseur. thumbDrag Distribué lorsque l’utilisateur clique sur le curseur, puis le déplace avec sa souris.mx.events.SliderEvent.THUMB_DRAGmx.events.SliderEvent Distribué lorsque l’utilisateur clique sur le curseur, puis le déplace avec sa souris. Cet événement est toujours précédé d’un événement thumbPress. change Distribué lorsqu’une interaction du clavier ou de la souris modifie la valeur de la glissière.mx.events.SliderEvent.CHANGEmx.events.SliderEvent Distribué lorsqu’une interaction du clavier ou de la souris modifie la valeur de la glissière.

Si la valeur de la propriété liveDragging est true, l’événement est diffusé en permanence tant que l’utilisateur déplace le curseur. Si la valeur de la propriété liveDragging est false, l’événement est distribué lorsque l’utilisateur relâche le curseur.

Slider Constructeur. Constructeur. getThumbAt Retourne le curseur à l’emplacement d’index donné.Référence à l’objet SliderThumb. mx.controls.sliderClasses:SliderThumbindexNuméro d’index de base zéro du curseur. Retourne le curseur à l’emplacement d’index donné. Utilisez cette méthode pour styliser et personnaliser chaque curseur d’un contrôle de glissière. measure Calcule la quantité d’espace utilisée par le composant. Calcule la quantité d’espace utilisée par le composant. Un contrôle de glissière horizontale calcule sa hauteur en examinant la position de ses étiquettes, graduations et curseurs par rapport au rail. La hauteur du contrôle équivaut à la position inférieure de l’élément le plus bas soustraite à la position supérieure de l’élément le plus haut. La largeur par défaut d’un contrôle de glissière horizontale est de 250 pixels. Pour un contrôle de glissière verticale, les mesures de la largeur et de la hauteur sont inversées. setThumbValueAt Cette méthode permet de définir la valeur d’un curseur et d’actualiser l’affichage.indexLe numéro d’index de base zéro du curseur dont la valeur doit être définie, la valeur 0 correspondant au premier curseur. valueValeur à affecter au curseur. Cette méthode permet de définir la valeur d’un curseur et d’actualiser l’affichage. updateDisplayList Positionne les éléments du contrôle.unscaledWidthIndique la largeur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleX du composant. unscaledHeightIndique la hauteur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleY du composant. Positionne les éléments du contrôle. Le rail, les curseurs, les étiquettes et les graduations sont tous positionnés et dimensionnés avec cette méthode. Le rail est dimensionné en fonction de la longueur des étiquettes et de la marge du rail. Si vous spécifiez un objet trackMargin, la taille du rail est égale à la largeur disponible moins l’objet trackMargin fois 2.

Les graduations sont espacées à intervalles réguliers le long du rail depuis le début. Une graduation supplémentaire est insérée à la fin du rail si ce n’est pas déjà le cas (si l’intervalle entre les graduations n’est pas un multiple de la valeur maximale). La position y de la graduation est fonction du paramètre tickOffset. Un décalage de 0 place le bas de la graduation en haut du rail. Les décalages négatifs déplacent les graduations vers le haut et les décalages positifs les déplacent vers le bas le long du rail.

Les étiquettes sont placées à intervalles réguliers le long du rail. Elles sont toujours centrées horizontalement au-dessus de leur position d’intervalle, sauf si le paramètre trackMargin est trop petit. Si vous spécifiez un paramètre trackMargin, la première et dernière étiquettes se positionnent sur les bordures gauche et droite du contrôle. Les étiquettes ne sont pas recadrées ou redimensionnées si elles se chevauchent. Par conséquent, n’oubliez pas d’allouer assez d’espace pour qu’elles tiennent sur le rail. La position y est fonction de la propriété labelOffset. Un décalage de 0 place le bas de l’étiquette en haut du rail. Contrairement aux graduations, les étiquettes ne peuvent pas être positionnées pour chevaucher le rail. Si le décalage est un nombre positif, le haut de l’étiquette est positionné sous le bas du rail.

Les curseurs sont positionnés de façon à chevaucher le rail. Leur position x est déterminée par leur valeur. La position y est contrôlée par la propriété thumbOffset. Un décalage de 0 place le centre du curseur au centre du rail. Un décalage négatif déplace les curseurs vers le haut, tandis qu’un décalage positif les déplace vers le bas.

Les placements des graduations, étiquettes et curseurs ne dépendent pas les uns des autres. Ils ne tenteront pas de se repositionner s’ils se chevauchent.

Les mêmes règles s’appliquent à un contrôle de curseur vertical. Dans la description ci-dessus, remplacez la largeur par la hauteur, la hauteur par la largeur, la gauche par le haut, la droite par le bas, la position x par la position y et la position y par la position x.

allowThumbOverlap S’il est défini sur false, chaque curseur ne peut être déplacé que vers le bord du curseur adjacent.falsefalse S’il est défini sur false, chaque curseur ne peut être déplacé que vers le bord du curseur adjacent. S’il est défini sur true, chaque curseur peut être déplacé dans n’importe quelle position sur le rail. allowTrackClick Indique que le curseur est déplacé lorsqu’un utilisateur clique sur le rail.truetrue Indique que le curseur est déplacé lorsqu’un utilisateur clique sur le rail. liveDragging Indique si le glissement direct est activé pour le curseur.falsefalse Indique si le glissement direct est activé pour le curseur. Si la valeur est false, Flex définit les propriétés value et values et distribue l’événement change lorsque l’utilisateur arrête de faire glisser le curseur. Si la valeur est true, Flex définit les propriétés value et values et distribue l’événement change de façon continue au fur et à mesure que l’utilisateur déplace le curseur. showDataTip Si la valeur est true, une astuce sur les données contenant la valeur actuelle du curseur s’affiche lors de l’interaction utilisateur.truetrue Si la valeur est true, une astuce sur les données contenant la valeur actuelle du curseur s’affiche lors de l’interaction utilisateur. dataTipFormatFunction Fonction de rappel qui met en forme le texte des astuces sur les données.undefined Fonction de rappel qui formate le texte de l’astuce sur les données. La fonction accepte un seul nombre comme argument et retourne une chaîne formatée.

La fonction présente la signature suivante :

      funcName(value:Number):String

L’exemple suivant ajoute le symbole du dollar au texte des astuces sur les donnéeset met en forme le texte à l’aide de la propriété dataTipPrecision d’un contrôle Slider appelé ’slide’ : 

      import mx.formatters.NumberBase;
      function myDataTipFormatter(value:Number):String { 
          var dataFormatter:NumberBase = new NumberBase(".", ",", ".", ""); 
          return   "$ " + dataFormatter.formatPrecision(String(value), slide.getStyle("dataTipPrecision")); 
      }
direction Orientation du contrôle Slider.SliderDirection.HORIZONTAL Orientation du contrôle Slider. Les valeurs possibles dans MXML sont "horizontal" ou "vertical".

Dans ActionScript, utilisez les constantes suivantes pour définir cette propriété : SliderDirection.VERTICAL et SliderDirection.HORIZONTAL.

Les contrôles HSlider et VSlider définissent cette propriété pour vous. Vous ne la définissez pas lorsque vous utilisez ces contrôles. mx.controls.sliderClasses.SliderDirectionlabels Tableau de chaînes utilisé pour les étiquettes de curseur.undefined Tableau de chaînes utilisé pour les étiquettes de curseur. Flex place les étiquettes au début du rail et les espaces de façon régulière entre le début du rail et la fin du rail.

Par exemple, si le tableau contient trois éléments, le premier est placé au début du rail, le deuxième au milieu du rail et le dernier à la fin du rail.

Si une seule étiquette est spécifiée, elle est placée au début du rail. Par défaut, les étiquettes sont placées au-dessus des graduations (s’il en existe) ou au-dessus du rail. Pour aligner les étiquettes sur les graduations, vérifiez que le nombre de graduations est égal à celui des étiquettes.

maximum Valeur maximale acceptée pour le contrôle Slider.10 Valeur maximale acceptée pour le contrôle Slider. minimum Valeur minimale acceptée pour le contrôle Slider.0 Valeur minimale acceptée pour le contrôle Slider. sliderDataTipClass Référence à la classe à utiliser pour l’astuce sur les données.SliderDataTip Référence à la classe à utiliser pour l’astuce sur les données. sliderThumbClass Référence à la classe à utiliser pour chaque curseur.SliderThumb Référence à la classe à utiliser pour chaque curseur. snapInterval Spécifie la valeur d’incrémentation du curseur lorsque l’utilisateur déplace celui-ci.0 Spécifie la valeur d’incrémentation du curseur lorsque l’utilisateur déplace celui-ci. Par exemple, si snapInterval est défini sur 2, la valeur minimum de 0 et la valeur maximum de 10, le curseur s’accroche aux valeurs 0, 2, 4, 6, 8 et 10 dès que l’utilisateur le déplace. La valeur 0 signifie que le curseur se déplace de façon continue entre les valeurs minimum et maximum. thumbCount Nombre de curseurs autorisés pour le contrôle Slider.1 Nombre de curseurs autorisés pour le contrôle Slider. Les valeurs possibles sont 1 ou 2. Si la valeur est 1, la propriété value contient la valeur actuelle du curseur. Si la valeur est 2, la propriété values contient un tableau de valeurs représentant la valeur de chaque curseur. thumbStyleFilters Jeu de styles à transmettre du contrôle Slider aux curseurs. Jeu de styles à transmettre du contrôle Slider aux curseurs. mx.styles.StyleProxytickInterval Espacement entre les graduations par rapport à la valeur maximale du contrôle.0 Espacement entre les graduations par rapport à la valeur maximale du contrôle. Flex affiche des graduations dès que vous définissez la propriété tickInterval sur une valeur non nulle.

Par exemple, si la propriété tickInterval a la valeur 1 et si maximum a la valeur 10, une graduation ayant un espacement correspondant à un dixième de la longueur du curseur est appliquée. Aucune graduation ne s’affiche si la valeur est de 0. Si la propriété tickValues est définie sur un tableau non vide, cette propriété est ignorée.

tickValues Positions des graduations sur le curseur.undefined Positions des graduations sur le curseur. Les positions correspondent aux valeurs sur le curseur et doivent se trouver entre les valeurs minimum et maximum. Par exemple, si la propriété tickValues a la valeur [0, 2.5, 7.5, 10] et maximum a la valeur 10, une graduation est insérée aux positions suivantes le long du curseur : début du curseur, 1/4 de la trajectoire à partir de la gauche, 3/4 de la trajectoire à partir de la gauche et fin du curseur.

Si cette propriété est définie sur un tableau non vide, la propriété tickIntervalest ignorée.

value Contient la position du curseur et est un nombre compris entre les propriétés minimum et maximum. Contient la position du curseur et est un nombre compris entre les propriétés minimum et maximum. Utilisez la propriété value lorsque thumbCount a la valeur 1. Lorsque la valeur de thumbCount est supérieure à 1, utilisez à la place la propriété values. La valeur par défaut est égale à la propriété minimum. values Un tableau de valeurs pour chaque curseur de défilement lorsque thumbCount est supérieur à 1. Un tableau de valeurs pour chaque curseur de défilement lorsque thumbCount est supérieur à 1. SliderDirection La classe SliderDirection définit les valeurs constantes de la propriété direction de la classe Slider.Object La classe SliderDirection définit les valeurs constantes de la propriété direction de la classe Slider. mx.controls.sliderClasses.SliderHORIZONTAL Indique qu’un curseur horizontal doit être affiché.horizontal Indique qu’un curseur horizontal doit être affiché. Le contrôle HSlider utilise cette constante. VERTICAL Indique qu’un curseur vertical doit être affiché.vertical Indique qu’un curseur vertical doit être affiché. Le contrôle VSlider utilise cette constante. SliderDataTip La classe SliderDataTip définit l’info-bulle utilisée dans le contrôle mx.controls.Slider.mx.controls:ToolTip La classe SliderDataTip définit l’info-bulle utilisée dans le contrôle mx.controls.Slider. La classe n’ajoute aucune fonctionnalité supplémentaire à mx.controls.ToolTip. Elle permet uniquement d’appliquer un style du sélecteur de type. mx.controls.HSlidermx.controls.VSlidermx.controls.sliderClasses.Slidermx.controls.sliderClasses.SliderLabelmx.controls.sliderClasses.SliderThumbSliderDataTip Constructeur. Constructeur. SliderLabel La classe SliderLabel définit l’étiquette utilisée dans le composant mx.controls.Slider.mx.controls:Label La classe SliderLabel définit l’étiquette utilisée dans le composant mx.controls.Slider. La classe n’ajoute aucune fonctionnalité supplémentaire à mx.controls.Label. Elle permet d’appliquer un style du sélecteur de type. mx.controls.HSlidermx.controls.VSlidermx.controls.sliderClasses.Slidermx.controls.sliderClasses.SliderDataTipmx.controls.sliderClasses.SliderThumbSliderLabel Constructeur. Constructeur. SliderThumb La classe SliderThumb représente un curseur d’un contrôle Slider.mx.controls:Button La classe SliderThumb représente un curseur d’un contrôle Slider. La classe SliderThumb ne peut être utilisée que dans le contexte d’un contrôle Slider. Vous pouvez créer une sous-classe de la classe SliderThumb et l’utiliser avec un contrôle Slider en définissant la propriété sliderThumbClass du contrôle Slider à votre sous-classe. mx.controls.HSlidermx.controls.VSlidermx.controls.sliderClasses.Slidermx.controls.sliderClasses.SliderDataTipmx.controls.sliderClasses.SliderLabelSliderThumb Constructeur. Constructeur. xPosition Indique la position du centre du curseur sur l’axe x. Indique la position du centre du curseur sur l’axe x.