| Package | spark.core |
| Interface | public interface IViewport extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| Implémenteurs | GroupBase, RichEditableText |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Seule, une fenêtre ne peut pas être déplacée par l’utilisateur de l’application. Cependant, vous pouvez combiner une fenêtre à des barres de défilement pour que l’utilisateur puisse la faire défiler afin de voir le contenu intégral du composant. Utilisez le composant Scroller pour ajouter des barres de défilement au composant.
Eléments de l’API associés
Propriétés publiques
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | IVisualElement | |
| baseline : Object
Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle. | ILayoutElement | |
| baselinePosition : Number [lecture seule]
Coordonnée y de la ligne de base de la première ligne de texte du composant. | ILayoutElement | |
| bottom : Object
Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage. | ILayoutElement | |
| clipAndEnableScrolling : Boolean
Si la valeur est true, indique d’écrêter les enfants aux limites de la fenêtre. | IViewport | ||
| contentHeight : Number [lecture seule]
La hauteur du contenu de la fenêtre d’affichage. | IViewport | ||
| contentWidth : Number [lecture seule]
La largeur du contenu de la fenêtre d’affichage. | IViewport | ||
| depth : Number
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. | IVisualElement | |
| designLayer : DesignLayer
Spécifie l’instance DesignLayer facultative associée à cet élément visuel. | IVisualElement | |
| hasLayoutMatrix3D : Boolean [lecture seule]
Contient true si l’élément possède une matrice 3D. | ILayoutElement | |
| height : Number
Indique la hauteur de l’objet d’affichage, en pixels. | IVisualElement | |
| horizontalCenter : Object
Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage. | ILayoutElement | |
| horizontalScrollPosition : Number
Coordonnée x de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut (0,0) correspond à l’angle supérieur gauche du composant. | IViewport | ||
| includeInLayout : Boolean
Indique si ce composant est inclus dans la présentation du conteneur parent. | ILayoutElement | |
| is3D : Boolean [lecture seule]
Contient true lorsque l’élément est en 3D. | IVisualElement | |
| layoutDirection : String
Spécifie la direction de mise en forme souhaitée pour un élément : l’une des valeurs LayoutDirection.LTR (de gauche à droite), LayoutDirection.RTL (de droite à gauche) ou null (héritée). | ILayoutDirectionElement | |
| left : Object
Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage. | ILayoutElement | |
| owner : DisplayObjectContainer
Propriétaire de cet objet IVisualElement. | IVisualElement | |
| parent : DisplayObjectContainer [lecture seule]
Conteneur ou composant parent de ce composant. | IVisualElement | |
| percentHeight : Number
Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. | ILayoutElement | |
| percentWidth : Number
Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. | ILayoutElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent. | IVisualElement | |
| right : Object
Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage. | ILayoutElement | |
| top : Object
Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage. | ILayoutElement | |
| verticalCenter : Object
Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage. | ILayoutElement | |
| verticalScrollPosition : Number
Coordonnée y de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut est (0,0) correspondant au coin supérieur gauche du composant. | IViewport | ||
| visible : Boolean
Contrôle la visibilité de cet élément visuel. | IVisualElement | |
| width : Number
Indique la largeur de l’objet d’affichage, en pixels. | IVisualElement | |
| x : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | IVisualElement | |
| y : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | IVisualElement | |
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
| 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. | IEventDispatcher | |
|
Distribue un événement dans le flux d’événements. | IEventDispatcher | |
|
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | ILayoutElement | |
|
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | ILayoutElement | |
Renvoie la quantité à ajouter à la position horizontalScrollPosition actuelle de la fenêtre selon laquelle l’unité de défilement demandée doit faire défiler l’affichage. | IViewport | ||
|
Renvoie la hauteur de présentation de l’élément. | ILayoutElement | |
|
Renvoie la largeur de la présentation de l’élément. | ILayoutElement | |
|
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | ILayoutElement | |
|
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | ILayoutElement | |
|
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | ILayoutElement | |
|
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | ILayoutElement | |
|
Renvoie la hauteur maximale de l’élément. | ILayoutElement | |
|
Renvoie la largeur maximale de l’élément. | ILayoutElement | |
|
Renvoie la hauteur minimale de l’élément. | ILayoutElement | |
|
Renvoie la largeur minimale de l’élément. | ILayoutElement | |
|
Renvoie la hauteur préférée de l’élément. | ILayoutElement | |
|
Renvoie la largeur préférée de l’élément. | ILayoutElement | |
Renvoie la quantité à ajouter à la position verticalScrollPosition actuelle de la fenêtre selon laquelle l’unité de défilement demandée doit faire défiler l’affichage. | IViewport | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | IEventDispatcher | |
|
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. | ILayoutDirectionElement | |
|
Supprime un écouteur de l’objet EventDispatcher. | IEventDispatcher | |
|
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | ILayoutElement | |
|
Définit la taille de la présentation de l’élément. | ILayoutElement | |
|
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. | ILayoutElement | |
|
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. | ILayoutElement | |
| 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. | ILayoutElement | |
|
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é. | IEventDispatcher | |
Détails de la propriété
clipAndEnableScrolling | propriété |
clipAndEnableScrolling:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Si la valeur est true, indique d’écrêter les enfants aux limites de la fenêtre. Si la valeur est false, les enfants du conteneur s’étendent au-delà des limites du conteneur, quelle que soit la spécification de taille du composant.
La valeur par défaut est false.
Implémentation
public function get clipAndEnableScrolling():Boolean public function set clipAndEnableScrolling(value:Boolean):voidEléments de l’API associés
contentHeight | propriété |
contentHeight:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La hauteur du contenu de la fenêtre d’affichage. Si la valeur de clipAndEnabledScrolling est true, la valeur contentHeight de la fenêtre d’affichage définit la limite pour le défilement vertical et la hauteur réelle de la fenêtre d’affichage définit la quantité de contenu visible. Pour faire défiler le contenu verticalement, modifiez la position verticalScrollPosition entre 0 et contentHeight - height.
Les implémentations de cette propriété doivent être liables et doivent générer des événements de type propertyChange.
Implémentation
public function get contentHeight():NumbercontentWidth | propriété |
contentWidth:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La largeur du contenu de la fenêtre d’affichage. Si la valeur de clipAndEnabledScrolling est true, la valeur contentWidth de la fenêtre d’affichage définit la limite pour le défilement vertical et la largeur réelle de la fenêtre d’affichage définit la quantité de contenu visible. Pour faire défiler le contenu horizontalement, modifiez la position verticalScrollPosition entre 0 et contenWidth - Width.
Les implémentations de cette propriété doivent être liables et doivent générer des événements de type propertyChange.
Implémentation
public function get contentWidth():NumberhorizontalScrollPosition | propriété |
horizontalScrollPosition:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Coordonnée x de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut est (0,0) correspondant au coin supérieur gauche du composant. Si la valeur de clipAndEnableScrolling est true, définir cette propriété entraîne généralement la définition de la fenêtre sur :
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)
Les implémentations de cette propriété doivent être liables et doivent générer des événements de type propertyChange.
La valeur par défaut est 0.
Implémentation
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidEléments de l’API associés
verticalScrollPosition | propriété |
verticalScrollPosition:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Coordonnée y de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut est (0,0) correspondant au coin supérieur gauche du composant. Si la valeur de clipAndEnableScrolling est true, définir cette propriété entraîne généralement la définition de la fenêtre sur :
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)
Les implémentations de cette propriété doivent être liables et doivent générer des événements de type propertyChange.
La valeur par défaut est 0.
Implémentation
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidEléments de l’API associés
Détails de la méthode
getHorizontalScrollPositionDelta | () | méthode |
public function getHorizontalScrollPositionDelta(navigationUnit:uint):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la quantité à ajouter à la position horizontalScrollPosition actuelle de la fenêtre selon laquelle l’unité de défilement demandée doit faire défiler l’affichage.
Paramètres
navigationUnit:uint — Quantité de défilement. La valeur doit être l’une des constantes spark.core.NavigationUnit suivantes :
LEFT ou RIGHT. Pour faire défiler l’affichage jusqu’à la première ou la dernière colonne, utilisez HOME ou END.
|
Number — Nombre de pixels à ajouter à horizontalScrollPosition.
|
Eléments de l’API associés
getVerticalScrollPositionDelta | () | méthode |
public function getVerticalScrollPositionDelta(navigationUnit:uint):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la quantité à ajouter à la position verticalScrollPosition actuelle de la fenêtre selon laquelle l’unité de défilement demandée doit faire défiler l’affichage.
Paramètres
navigationUnit:uint — Quantité de défilement. La valeur de l’unité doit être l’une des constantes spark.core.NavigationUnit suivantes :
UP ou DOWN. Pour faire défiler l’affichage jusqu’à la première ou la dernière ligne, utilisez HOME ou END.
|
Number — Nombre de pixels à ajouter à verticalScrollPosition.
|
Eléments de l’API associés
Exemples Comment utiliser cet exemple
IViewportExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate Spark IViewport interface -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:mx="library://ns.adobe.com/flex/mx"
xmlns:s="library://ns.adobe.com/flex/spark" >
<s:layout>
<s:HorizontalLayout/>
</s:layout>
<s:Panel title="IViewport Component Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:Label text="The Group container implements IViewport. Therefore, you can clip its contents and use it with scrollbars."
color="blue"
top="10"/>
<s:Group id="myGroup" width="100" height="100"
clipAndEnableScrolling="true"
horizontalScrollPosition="50" verticalScrollPosition="50"
left="100" top="40">
<mx:Image width="300" height="400"
source="@Embed(source='/assets/logo.jpg')"/>
</s:Group>
<s:VScrollBar viewport="{myGroup}" height="100" left="210" top="40"/>
<s:HScrollBar viewport="{myGroup}" width="100" left="100" top="150"/>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z