spark.layouts.supportClassesLayoutBase La classe LayoutBase définit la classe de base pour tous les mises en forme Spark. The <s:LayoutBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:LayoutBase 
    Properties
    clipAndEnableScrolling="false"
    dropIndicator="defined by the skin class"
    horizontalScrollPosition="0"
    target="null"
    typicalLayoutElement="null"
    useVirtualLayout="false"
    verticalScrollPosition="0"
  />
  
]]>
mx.utils:OnDemandEventDispatcher La classe LayoutBase définit la classe de base pour tous les mises en forme Spark. Pour créer une présentation personnalisée fonctionnant avec les conteneurs Spark, vous devez développer la classe LayoutBase ou l’une de ses sous-classes.

Au minimum, les sous-classes doivent implémenter la méthode updateDisplayList(), qui positionne et dimensionne les éléments de la classe GroupBase target, ainsi que la méthode measure(), qui calcule la taille par défaut de target.

Les sous-classes peuvent remplacer les méthodes telles que getElementBoundsAboveScrollRect() et getElementBoundsBelowScrollRect() pour personnaliser la manière dont la cible se comporte lorsqu’elle est connectée à des barres de défilement.

Les sous-classes prenant en charge la virtualisation doivent respecter la propriété useVirtualLayout et doivent uniquement extraire des éléments de présentation dans le rectangle scrollRect (valeur de getScrollRect()) en utilisant la méthode getVirtualElementAt() depuis updateDisplayList().

LayoutBase Constructeur. Constructeur. calculateDragScrollDelta Calcule la longueur de défilement pour l’objet dropLocation spécifié lors d’une opération glisser-déposer. La longueur de l’opération glisser-défiler, ou null si le glissement-défilement n’est pas nécessaire. dropLocationspark.layouts.supportClasses:DropLocationObjet DropLocation valide préalablement obtenu par l’appel de la méthode calculateDropLocation(). elapsedTimeDurée, en millisecondes, depuis le début de l’opération de glissement-défilement. Calcule la longueur de défilement pour l’objet dropLocation spécifié lors d’une opération glisser-déposer. Appelé par la méthode showDropIndicator() pour calculer le défilement lors de l’opération de glissement-défilement. spark.layouts.supportClasses.DropLocationcalculateDropIndex()calculateDropIndicatorBounds()calculateDropIndex Renvoie l’index dans lequel un nouvel élément doit être inséré lorsque l’utilisateur relâche la souris sur les coordonnées spécifiées à l’issue d’un glisser-déposer. Index de dépôt ou -1 si l’opération n’est pas disponible aux coordonnées spécifiées. xCoordonnée x de l’opération glisser-déposer, selon les coordonnées locales. yCoordonnée y de l’opération glisser-déposer, selon les coordonnées locales de la cible de dépôt. Renvoie l’index dans lequel un nouvel élément doit être inséré lorsque l’utilisateur relâche la souris sur les coordonnées spécifiées à l’issue d’un glisser-déposer. Appelé par la méthode calculatedDropLocation(). calculateDropLocation()calculateDropIndicatorBounds Calcule les limites de l’indicateur de dépôt qui fournit des informations visuelles à l’utilisateur sur l’emplacement d’insertion des éléments à l’issue d’une opération glisser-déposer.Limites de l’indicateur de dépôt ou null. dropLocationspark.layouts.supportClasses:DropLocationObjet DropLocation valide préalablement renvoyé par la méthode calculateDropLocation(). Calcule les limites de l’indicateur de dépôt qui fournit des informations visuelles à l’utilisateur sur l’emplacement d’insertion des éléments à l’issue d’une opération glisser-déposer. Appelé par la méthode showDropIndicator(). spark.layouts.supportClasses.DropLocationcalculateDropIndex()calculateDragScrollDelta()calculateDropLocation Calcule l’emplacement de dépôt dans le fournisseur de données de la cible de dépôt pour l’objet dragEvent spécifié. Renvoie l’emplacement de cet événement ou null si l’opération de dépôt n’est pas disponible. spark.layouts.supportClasses:DropLocationdragEventEvénement de glissement distribué par DragManager. Calcule l’emplacement de dépôt dans le fournisseur de données de la cible de dépôt pour l’objet dragEvent spécifié. showDropIndicator()hideDropIndicator()clearVirtualLayoutCache Lorsque useVirtualLayout est true, cette méthode peut être utilisée par la cible de mise en forme pour effacer les informations de mise en forme en cache lors de la modification de la cible. Lorsque useVirtualLayout est true, cette méthode peut être utilisée par la cible de mise en forme pour effacer les informations de mise en forme en cache lors de la modification de la cible.

Par exemple, lorsqu’une propriété dataProvider ou itemRenderer d’une classe DataGroup est modifiée, les tailles des éléments mis en cache ne sont plus valides.

Lorsque la propriété useVirtualLayout est définie sur false, cette méthode est appelée automatiquement.

Les sous-classes qui prennent en charge useVirtualLayout = true doivent remplacer cette méthode.

elementAdded Appelée par la cible après ajout d’un élément de présentation et avant validation de la taille et de la liste d’affichage de la cible.indexIndex de l’élément ayant été ajouté. Appelée par la cible après ajout d’un élément de présentation et avant validation de la taille et de la liste d’affichage de la cible. Les présentations mises en cache par état d’élément (par exemple, les présentations virtuelles) peuvent remplacer cette méthode pour mettre à jour leur cache.

L’appel de cette méthode par la cible garantit uniquement qu’un élément de présentation existera à l’index spécifié à l’heure updateDisplayList() ; par exemple, une classe DataGroup comportant une présentation virtuelle appellera cette méthode lorsqu’un élément dataProvider est ajouté.

Par défaut, cette méthode n’a aucune action.

elementRemoved
elementRemoved Cette méthode doit être appelée par la cible après suppression d’un élément de présentation et avant validation de la taille et de la liste d’affichage de la cible.indexIndex de l’élément ayant été ajouté. Cette méthode doit être appelée par la cible après suppression d’un élément de présentation et avant validation de la taille et de la liste d’affichage de la cible. Les présentations mises en cache par état d’élément (par exemple, les présentations virtuelles) peuvent remplacer cette méthode pour mettre à jour leur cache.

La cible appelle cette méthode uniquement pour garantir qu’un élément de mise en forme n’existe plus à l’index spécifié lors de l’exécution de la méthode updateDisplayList(). Par exemple, une classe DataGroup avec une mise en forme virtuelle appelle cette méthode lorsqu’un élément est ajouté à la propriété dataProvider.

Par défaut, cette méthode n’a aucun effet.

elementAdded
getElementBoundsAboveScrollRect Renvoie les limites du premier élément de présentation qui englobe ou est au-dessus du bord supérieur du rectangle scrollRect. Limites du premier élément qui englobe ou est au-dessus du bord supérieur du rectangle scrollRect. scrollRectRectangle scrollRect de la cible. Renvoie les limites du premier élément de présentation qui englobe ou est au-dessus du bord supérieur du rectangle scrollRect.

Il s’agit d’une méthode pratique utilisée par l’implémentation par défaut de la méthode getVerticalScrollPositionDelta(). Les sous-classes faisant appel à l’implémentation par défaut de la méthode getVerticalScrollPositionDelta() doivent remplacer cette méthode pour fournir un rectangle de sélection précis comportant des propriétés top et bottom valides.

Par défaut, cette méthode renvoie un rectangle avec width=0, height=1, dont le bord supérieur est inférieur de un par rapport au bord supérieur du rectangle scrollRect et left=0.

Les sous-classes doivent remplacer cette méthode pour fournir un rectangle de sélection précis comportant des propriétés top et bottom valides.

getElementBoundsLeftOfScrollRectgetElementBoundsRightScrollRectgetElementBoundsBelowScrollRectgetVerticalScrollPositionDelta
getElementBoundsBelowScrollRect Renvoie les limites du premier élément de présentation qui englobe ou est en dessous du bord inférieur du rectangle scrollRect. Limites du premier élément qui englobe ou est en dessous du bord inférieur du rectangle scrollRect. scrollRectRectangle scrollRect de la cible. Renvoie les limites du premier élément de présentation qui englobe ou est en dessous du bord inférieur du rectangle scrollRect.

Il s’agit d’une méthode pratique utilisée par l’implémentation par défaut de la méthode getVerticalScrollPositionDelta(). Les sous-classes faisant appel à l’implémentation par défaut de la méthode getVerticalScrollPositionDelta() doivent remplacer cette méthode pour fournir un rectangle de sélection précis comportant des propriétés top et bottom valides.

Par défaut, cette méthode renvoie un rectangle avec width=0, height=1, dont le bord inférieur est supérieur de un par rapport au bord inférieur du rectangle scrollRect et left=0.

getElementBoundsLeftOfScrollRectgetElementBoundsRightScrollRectgetElementBoundsAboveScrollRectgetVerticalScrollPositionDelta
getElementBoundsLeftOfScrollRect Renvoie les limites du premier élément de présentation qui englobe ou est à gauche du bord gauche du rectangle scrollRect. Limites du premier élément qui englobe ou est à gauche du bord gauche du rectangle scrollRect. scrollRectRectangle scrollRect de la cible. Renvoie les limites du premier élément de présentation qui englobe ou est à gauche du bord gauche du rectangle scrollRect.

Il s’agit d’une méthode pratique utilisée par l’implémentation par défaut de la méthode getHorizontalScrollPositionDelta(). Les sous-classes faisant appel à l’implémentation par défaut de la méthode getHorizontalScrollPositionDelta() doivent remplacer cette méthode pour fournir un rectangle de délimitation précis comportant des propriétés left et right valides.

Par défaut, cette méthode renvoie un rectangle avec width=1, height=0, dont le bord gauche est inférieur de un par rapport au bord gauche du rectangle scrollRect et top=0.

getElementBoundsRightOfScrollRectgetElementBoundsAboveScrollRectgetElementBoundsBelowScrollRectgetHorizontalScrollPositionDelta
getElementBoundsRightOfScrollRect Renvoie les limites du premier élément de présentation qui englobe ou est à droite du bord droit du rectangle scrollRect. Limites du premier élément qui englobe ou est à droite du bord droit du rectangle scrollRect. scrollRectRectangle scrollRect de la cible. Renvoie les limites du premier élément de présentation qui englobe ou est à droite du bord droit du rectangle scrollRect.

Il s’agit d’une méthode pratique utilisée par l’implémentation par défaut de la méthode getHorizontalScrollPositionDelta(). Les sous-classes faisant appel à l’implémentation par défaut de la méthode getHorizontalScrollPositionDelta() doivent remplacer cette méthode pour fournir un rectangle de délimitation précis comportant des propriétés left et right valides.

Par défaut, cette méthode renvoie un rectangle avec width=1, height=0, dont le bord droit est supérieur de un par rapport au bord droit du rectangle scrollRect et top=0.

getElementBoundsLeftOfScrollRectgetElementBoundsAboveScrollRectgetElementBoundsBelowScrollRectgetHorizontalScrollPositionDelta
getElementBounds Renvoie les limites de présentation de l’élément spécifié en tant que rectangle ou null si l’index n’est pas valide, l’élément correspondant est nul ou includeInLayout=false, ou si la propriété target de la mise en forme est nulle.Les limites de mise en forme de l’élément spécifié. indexIndex de l’élément de présentation. Renvoie les limites de présentation de l’élément spécifié en tant que rectangle ou null si l’index n’est pas valide, l’élément correspondant est nul ou includeInLayout=false, ou si la propriété target de la mise en forme est nulle.

Les sous-classes de présentation qui prennent en charge useVirtualLayout=true doivent remplacer cette méthode afin de calculer une valeur potentiellement approximative pour les éléments non visibles.

mx.core.ILayoutElement.getLayoutBoundsX()mx.core.ILayoutElement.getLayoutBoundsY()mx.core.ILayoutElement.getLayoutBoundsWidth()mx.core.ILayoutElement.getLayoutBoundsHeight()
getHorizontalScrollPositionDelta Renvoie la modification de la position de défilement horizontal pour traiter différentes options de défilement. Modification de la position de défilement horizontal. navigationUnitPrend les valeurs suivantes :
  • END Renvoie le delta de défilement provoquant la justification à droite du rectangle scrollRect sur la zone de contenu.
  • HOME Renvoie le delta de défilement provoquant la justification à gauche du rectangle scrollRect sur la zone de contenu.
  • LEFT Renvoie le delta de défilement provoquant la justification à gauche du rectangle scrollRect avec le premier élément qui englobe ou qui se situe à gauche du bord gauche du rectangle scrollRect.
  • PAGE_LEFT Renvoie le delta de défilement provoquant la justification à droite du rectangle scrollRect avec le premier élément qui englobe ou qui se situe à gauche du bord gauche du rectangle scrollRect.
  • PAGE_RIGHT Renvoie le delta de défilement provoquant la justification à gauche du rectangle scrollRect avec le premier élément qui englobe ou qui se situe à droite du bord droit du rectangle scrollRect.
  • RIGHT Renvoie le delta de défilement provoquant la justification à droite du rectangle scrollRect avec le premier élément qui englobe ou qui se situe à droite du bord droit du rectangle scrollRect.

L’implémentation appelle les méthodes getElementBoundsLeftOfScrollRect() et getElementBoundsRightOfScrollRect() pour déterminer les limites des éléments. Les classes de présentation remplacent généralement ces méthodes à la place de la méthode getHorizontalScrollPositionDelta().

Renvoie la modification de la position de défilement horizontal pour traiter différentes options de défilement. Ces options sont définies par la classe NavigationUnit : END, HOME, LEFT, PAGE_LEFT, PAGE_RIGHT et RIGHT.
spark.core.NavigationUnitgetElementBoundsLeftOfScrollRectgetElementBoundsRightOfScrollRectgetHorizontalScrollPositionDelta
getNavigationDestinationIndex Méthode de délégation qui détermine vers quel élément naviguer en fonction de l’élément actuel mis en focus et de l’entrée utilisateur en termes de constante NavigationUnit.Index de l’élément suivant auquel sauter. Renvoie la valeur -1 si la présentation ne reconnaît pas la constante navigationUnit. currentIndexIndex actuel de l’élément mis en focus. navigationUnitConstante NavigationUnit qui détermine vers quel élément naviguer ensuite. arrowKeysWrapFocusSi la valeur est true et que l’utilisateur navigue à l’aide des touches de direction, le composant l’enveloppe dès qu’une extrémité est atteinte. Méthode de délégation qui détermine vers quel élément naviguer en fonction de l’élément actuel mis en focus et de l’entrée utilisateur en termes de constante NavigationUnit. Cette méthode est utilisée par des sous-classes de ListBase pour gérer la navigation par clavier. La classe ListBase mappe les entrées utilisateur aux constantes NavigationUnit.

Les sous-classes peuvent remplacer cette méthode pour calculer d’autres valeurs basées sur l’index actuel et la frappe de touche détectée.

getScrollPositionDeltaToElement Calcule les deltas horizontalScrollPosition et verticalScrollPosition requis pour faire défiler l’élément à l’index spécifié afin de l’afficher.Point qui contient un décalage par rapport à horizontalScrollPosition et verticalScrollPosition provoquant le défilement de l’élément spécifié afin de l’afficher, ou null si aucune modification n’est nécessaire. Si l’élément spécifié est partiellement visible et d’une taille supérieure au rectangle de défilement, ce qui signifie qu’il est déjà le seul élément visible, renvoyez la valeur null. Si l’index spécifié n’est pas valide, ou la cible comporte la valeur null, renvoyez null. Si l’élément à l’index spécifié comporte la valeur null ou includeInLayout comporte la valeur false, renvoyez null. indexIndex de l’élément à faire défiler pour être affiché. Calcule les deltas horizontalScrollPosition et verticalScrollPosition requis pour faire défiler l’élément à l’index spécifié afin de l’afficher.

Cette méthode tente de minimiser la modification de verticalScrollPosition et horizontalScrollPosition.

Si clipAndEnableScrolling comporte la valeur true et que l’élément à l’index spécifié n’est pas entièrement visible par rapport au rectangle scrollRect de la cible, renvoie le delta à ajouter à horizontalScrollPosition et verticalScrollPosition qui fera défiler l’élément de manière à l’afficher entièrement dans les limites du rectangle scrollRect.

clipAndEnableScrollingverticalScrollPositionhorizontalScrollPositionudpdateScrollRect()
getScrollRect Renvoie les limites du rectangle de défilement de la cible dans les coordonnées de présentation.Limites du rectangle scrollRect de la cible dans les coordonnées de présentation, null si la cible ou clipAndEnableScrolling comporte la valeur false. Renvoie les limites du rectangle de défilement de la cible dans les coordonnées de présentation. Les méthodes de présentation ne doivent pas obtenir le rectangle de défilement de la cible directement. getVerticalScrollPositionDelta Renvoie la modification de la position de défilement vertical pour traiter différentes options de défilement.Modification de la position de défilement vertical. navigationUnitPrend les valeurs suivantes :
  • DOWN Renvoie le delta de défilement provoquant la justification en bas du rectangle scrollRect avec le premier élément qui englobe ou qui se situe en dessous du bord inférieur du rectangle scrollRect.
  • END Renvoie le delta de défilement provoquant la justification en bas du rectangle scrollRect sur la zone de contenu.
  • HOME Renvoie le delta de défilement provoquant la justification en haut du rectangle scrollRect sur la zone de contenu.
  • PAGE_DOWN Renvoie le delta de défilement provoquant la justification en haut du rectangle scrollRect avec le premier élément qui englobe ou qui se situe en dessous du bord inférieur du rectangle scrollRect.
  • PAGE_UP
  • Renvoie le delta de défilement provoquant la justification en bas du rectangle scrollRect avec le premier élément qui englobe ou qui se situe au-dessus du bord supérieur du rectangle scrollRect.
  • UP Renvoie le delta de défilement provoquant la justification en haut du rectangle scrollRect avec le premier élément qui englobe ou qui se situe au-dessus du bord supérieur du rectangle scrollRect.

L’implémentation appelle les méthodes getElementBoundsAboveScrollRect() et getElementBoundsBelowScrollRect() pour déterminer les limites des éléments. Les classes de présentation remplacent généralement ces méthodes à la place de la méthode getVerticalScrollPositionDelta().

Renvoie la modification de la position de défilement vertical pour traiter différentes options de défilement. Ces options sont définies par la classe NavigationUnit : DOWN, END, HOME, PAGE_DOWN, PAGE_UP et UP.
spark.core.NavigationUnitgetElementBoundsAboveScrollRectgetElementBoundsBelowScrollRectgetVerticalScrollPositionDelta
hideDropIndicator Masque l’indicateur de dépôt créé par la méthode showDropIndicator() précédemment affiché, le supprime de la liste d’affichage et stoppe également l’opération de glissement-défilement. Masque l’indicateur de dépôt créé par la méthode showDropIndicator() précédemment affiché, le supprime de la liste d’affichage et stoppe également l’opération de glissement-défilement. showDropIndicator()dropIndicatormeasure Mesure la taille par défaut de la cible en fonction de son contenu et éventuellement la taille minimale par défaut de la cible. Mesure la taille par défaut de la cible en fonction de son contenu et éventuellement la taille minimale par défaut de la cible.

Il s’agit d’une méthode que vous devez remplacer lorsque vous créez une sous-classe de la classe LayoutBase. L’autre méthode est updateDisplayList(). Vous n’appelez pas ces méthodes directement. Flex appelle cette méthode dans le cadre d’un passage de présentation. Un passage de présentation consiste en trois phases.

Premièrement, si les propriétés de la cible ne sont pas valides, la classe LayoutManager appelle la méthode commitProperties de la cible.

Deuxièmement, si la taille de la cible n’est pas valide, la classe LayoutManager appelle la méthode validateSize() de la cible. La méthode validateSize() de la cible appelle à son tour la méthode measure() de la présentation pour calculer la taille par défaut de la cible, sauf si elle a été explicitement spécifiée par les propriétés explicitWidth et explicitHeight de la cible. Si la taille par défaut change, Flex invalide la liste d’affichage de la cible.

Enfin, si la liste d’affichage de la cible n’est pas valide, la classe LayoutManager appelle la méthode validateDisplayList de la cible. La méthode validateDisplayList de la cible appelle à son tour la méthode updateDisplayList de la présentation pour dimensionner et positionner les éléments de la cible.

Lorsque vous implémentez cette méthode, vous devez spécifier les propriétés measuredWidth et measuredHeight de la cible pour définir la taille par défaut de la cible. Vous pouvez également définir les propriétés measuredMinWidth et measuredMinHeight pour définir la taille minimale par défaut. Une implémentation standard est itérée via les éléments de la cible et utilise les méthodes définies par la classe ILayoutElement pour accumuler les tailles préférées et/ou minimales des éléments, puis définit les propriétés measuredWidth, measuredHeight, measuredMinWidth et measuredMinHeight de la cible.

updateDisplayList
scrollPositionChanged Appelé lorsque les propriétés verticalScrollPosition ou horizontalScrollPosition changent. Appelé lorsque les propriétés verticalScrollPosition ou horizontalScrollPosition changent.

L’implémentation par défaut met à jour la propriété scrollRect de la cible en appelant la méthode updateScrollRect(). Les sous-classes peuvent remplacer cette méthode pour calculer d’autres valeurs basées sur la position scrollPosition ou le rectangle scrollRect actuel.

updateScrollRect()
showDropIndicator Définit la taille, la position et les parents de l’indicateur de dépôt en fonction de l’emplacement de dépôt spécifié. dropLocationspark.layouts.supportClasses:DropLocationSpécifie l’emplacement d’affichage de l’indicateur de dépôt. L’emplacement de dépôt est obtenu par la méthode computeDropLocation(). Définit la taille, la position et les parents de l’indicateur de dépôt en fonction de l’emplacement de dépôt spécifié. Utilisez la méthode calculateDropLocation() pour obtenir l’objet DropLocation.

Lance/arrête le glissement-défilement lorsque les conditions nécessaires sont remplies.

dropIndicatorhideDropIndicator()
updateDisplayList Dimensionne et positionne les éléments de la cible. widthIndique la largeur de la cible, en pixels, des coordonnées de la cible. heightIndique la hauteur du composant, en pixels, des coordonnées de la cible. Dimensionne et positionne les éléments de la cible.

Il s’agit d’une méthode que vous devez remplacer lorsque vous créez une sous-classe de la classe LayoutBase. L’autre méthode est measure(). Vous n’appelez pas ces méthodes directement. Flex appelle cette méthode dans le cadre d’un passage de présentation. Un passage de présentation consiste en trois phases.

Premièrement, si les propriétés de la cible ne sont pas valides, la classe LayoutManager appelle la méthode commitProperties de la cible.

Deuxièmement, si la taille de la cible n’est pas valide, la classe LayoutManager appelle la méthode validateSize() de la cible. La méthode validateSize() de la cible appelle à son tour la méthode measure() de la présentation pour calculer la taille par défaut de la cible, sauf si elle a été explicitement spécifiée par les propriétés explicitWidth et explicitHeight de la cible. Si la taille par défaut change, Flex invalide la liste d’affichage de la cible.

Enfin, si la liste d’affichage de la cible n’est pas valide, la classe LayoutManager appelle la méthode validateDisplayList de la cible. La méthode validateDisplayList de la cible appelle à son tour la méthode updateDisplayList de la présentation pour dimensionner et positionner les éléments de la cible.

Une implémentation standard est itérée via les éléments de la cible et utilise les méthodes définies par la classe ILayoutElement pour positionner et redimensionner les éléments. La présentation doit alors également calculer et définir les propriétés contentWidth et contentHeight de la cible pour définir la région de défilement de la cible.

measure
updateScrollRect Appelé par la cible à la fin de sa liste updateDisplayList pour que la présentation mette à jour son rectangle scrollRect. wLargeur de la cible. hHauteur de la cible. Appelé par la cible à la fin de sa liste updateDisplayList pour que la présentation mette à jour son rectangle scrollRect.

Si clipAndEnableScrolling est true, l’implémentation par défaut définit l’origine du rectangle scrollRect de la cible sur verticalScrollPosition, horizontalScrollPosition. Il définit sa taille en fonction des paramètres width, height (largeur et la hauteur de la cible non mise de l’échelle).

Si clipAndEnableScrolling comporte la valeur false, l’implémentation par défaut définit le rectangle scrollRect sur null.

targetflash.display.DisplayObject.scrollRectupdateDisplayList()
clipAndEnableScrolling false dropIndicator Objet DisplayObject utilisé par cette présentation pour l’indicateur de dépôt au cours d’une opération glisser-déposer. Objet DisplayObject utilisé par cette présentation pour l’indicateur de dépôt au cours d’une opération glisser-déposer. En règle générale, vous ne définissez pas cette propriété directement. Vous définissez une partie d’habillage dropIndicator dans la classe d’habillage de la cible de dépôt.

Le contrôle List définit cette propriété en réponse à un événement DragEvent.DRAG_ENTER. La classe List initialise cette propriété avec une occurrence de son composant d’habillage dropIndicator. La classe List efface cette propriété en réponse à un événement DragEvent.DRAG_EXIT.

horizontalScrollPosition 0 target Le conteneur GroupBase dont les éléments sont mesurés, dimensionnés et positionnés par cette mise en forme.spark.components.supportClasses:GroupBasenull Le conteneur GroupBase dont les éléments sont mesurés, dimensionnés et positionnés par cette mise en forme.

Les sous-classes peuvent remplacer l’accesseur d’initialisation pour effectuer des actions spécifiques aux cibles. Par exemple, une présentation 3D peut définir ici la propriété maintainProjectionCenter de la cible.

updateDisplayListmeasure
typicalLayoutElement Utilisé par les présentations lorsque des tailles de ligne/colonne fixes sont demandées mais qu’une taille spécifique n’est pas spécifié. null Utilisé par les présentations lorsque des tailles de ligne/colonne fixes sont demandées mais qu’une taille spécifique n’est pas spécifié. Utilisé par les présentations virtuelles pour estimer la taille des éléments de présentation n’ayant pas fait l’objet d’un défilement pour être affichés.

Cette propriété fait référence à un composant utilisé par Flex pour définir la hauteur de tous les conteneurs enfant, comme l’illustre l’exemple suivant :

      <s:Group>
        <s:layout>
          <s:VerticalLayout variableRowHeight="false"
              typicalLayoutElement="{b3}"/> 
        </s:layout>
        <s:Button id="b1" label="Button 1"/>
        <s:Button id="b2" label="Button 2"/>
        <s:Button id="b3" label="Button 3" fontSize="36"/>
        <s:Button id="b4" label="Button 4" fontSize="24"/>
      </s:Group>

Si cette propriété n’a pas été définie et que la cible n’est pas nulle, le premier élément de présentation de la cible est mis en cache et renvoyé.

La valeur par défaut est le premier élément de mise en forme de la cible.

targetspark.layouts.VerticalLayout.variableRowHeightspark.layouts.HorizontalLayout.variableColumnWidth
useVirtualLayout Un conteneur peut contenir n’importe quel nombre d’enfants. false Un conteneur peut contenir n’importe quel nombre d’enfants. Toutefois, chaque enfant nécessite une occurrence d’un rendu d’élément. Si le conteneur comporte de nombreux enfants, vous remarquerez peut-être une dégradation des performances au fur et à mesure que vous ajoutez d’autres enfants au conteneur.

Au lieu de créer un rendu d’élément pour chaque enfant, vous pouvez configurer le conteneur pour qu’il utilise une mise en forme virtuelle. La mise en forme virtuelle permet au conteneur de réutiliser les fonctionnalités de rendu d’élément pour créer uniquement des rendus d’élément pour les enfants du conteneur actuellement visibles. Lorsqu’un enfant est déplacé hors de l’écran, ce qui est possible en faisant défiler le conteneur, un nouvel enfant faisant l’objet d’un défilement à l’écran peut réutiliser son rendu d’élément.

Pour configurer l’utilisation d’une mise en forme virtuelle par un conteneur, définissez la propriété useVirtualLayout sur true pour la mise en forme associée au conteneur. Seul le conteneur DataGroup ou SkinnableDataContainer avec la présentation définie sur VerticalLayout, HorizontalLayout ou TileLayout prend en charge la présentation virtuelle. Les sous-classes de mise en page qui ne prennent pas en charge la virtualisation doivent empêcher la modification de cette propriété.

Remarque : la classe BasicLayout renvoie une erreur d’exécution, si vous définissez useVirtualLayout sur true.

Lorsque la valeur est true, les mises en page qui prennent en charge la virtualisation doivent utiliser target.getVirtualElementAt(), plutôt que , getElementAt() et doivent seulement obtenir les éléments dont ils anticipent qu’ils seront visibles étant donnée la valeur du rectangle getScrollRect().

Lorsque la valeur est true, la classe de mise en forme doit être en mesure de calculer les index des éléments de mise en page qui chevauchent le rectangle scrollRect dans sa méthode updateDisplayList() basée exclusivement sur les informations mises en cache et non en lisant éléments de mise en forme et en examinant leurs limites.

En général les mises en page virtuelles mettent à jour leurs informations mises en cache dans updateDisplayList(), en fonction de la taille et de l’emplacement calculés pour les éléments dans la vue.

De même, à l’instant measure(), les mises en page virtuelles doivent mettre à jour les propriétés de taille mesurée de la cible en fonction de l’élément typicalLayoutElement et d’autres informations de mise en page mises en cache, et non en mesurant les éléments.

Les conteneurs coopèrent avec les présentations dont la propriété useVirtualLayout est définie sur true en recyclant les rendus d’éléments précédemment construits mais qui ne sont plus utilisés. Un élément est considéré comme n’étant plus utilisé si son index ne figure pas dans la plage des index getVirtualElementAt() demandés au cours de la dernière invocation updateDisplayList() du conteneur.

getScrollRecttypicalLayoutElement
verticalScrollPosition 0
DropLocation La classe DropLocation contient des informations décrivant l’emplacement de dépôt des données glissées au cours d’une opération glisser-déposer. Object La classe DropLocation contient des informations décrivant l’emplacement de dépôt des données glissées au cours d’une opération glisser-déposer.

La classe DropLocation est créée par la classe LayoutBase lorsque la classe List appelle la méthode calculateDropLocation() de la présentation en réponse à un objet dragOver.

La classe DropLocation est utilisée par la présentation pour des opérations telles que le calcul des limites de l’indicateur de dépôt et des deltas de glissement-défilement.

spark.layouts.supportClasses.LayoutBase.calculateDropLocation()spark.layouts.supportClasses.LayoutBase.calculateDropIndicatorBounds()DropLocation Constructeur. Constructeur. dragEvent Evénement DragEvent associée à cet emplacement. null Evénement DragEvent associée à cet emplacement. dropIndex Index de dépôt correspondant à l’événement. -1 Index de dépôt correspondant à l’événement. dropPoint Point de l’événement en coordonnées locales de la cible de la mise en forme. null Point de l’événement en coordonnées locales de la cible de la mise en forme.