| Package | flash.events |
| Classe | public class ThrottleEvent |
| Héritage | ThrottleEvent  Event Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Cet événement est un événement de diffusion, c’est-à-dire qu’il est distribué par tous les objets EventDispatcher pour lesquels un écouteur est enregistré pour cet événement. Pour plus d’informations sur les événements de diffusion, voir la classe DisplayObject.
Remarque : cet événement n’a ni « phase de capture », ni « phase de propagation », ce qui signifie que des écouteurs d’événement doivent être ajoutés directement aux cibles potentielles, que la cible soit dans la liste d’affichage ou non.
Flash Player peut réduire le contenu à une cadence inférieure (la cadence est réduite à une valeur généralement comprise entre 2 et 8 ips). Le contenu peut être ralenti lorsque son onglet est masqué ou réduit. Sur un périphérique mobile, le contenu peut être ralenti lorsque le rétroéclairage est désactivé ou lorsque l’économiseur d’écran est activé. Avant de ralentir le contenu, un événement ThrottleEvent est distribué avec ThrottleEvent.state=ThrottleType.THROTTLE. La propriété ThrottleEvent.targetFrameRate contient la valeur de la nouvelle cadence cible.
Le contenu peut exécuter du code dans l’écouteur d’événement en vue de préparer le ralentissement. C’est l’occasion d’avertir le contenu externe que le contenu ralenti est beaucoup moins réactif. Il est par exemple possible qu’une méthode FileReference.upload() ou FileReference.download() en cours soit annulée. Par ailleurs, si le contenu communique avec un autre fichier SWF à l'aide de LocalConnection, il convient d’informer ce fichier SWF que le contenu sera moins réactif. Notez que le contenu ralenti peut ne pas être en mesure de mener à terme des actions asynchrones avant l’activation du ralentissement. Le contenu passe en mode de ralentissement lorsque l'écouteur d'événement est renvoyé.
Flash Player peut mettre en pause le contenu. Par exemple, le contenu peut être mis en pause lorsqu’il défile hors écran sur un périphérique mobile alors qu’aucun fichier audio ou vidéo n’est en cours de lecture. Avant la mise en pause du contenu, un événement ThrottleEvent est distribué avec ThrottleEvent.state=ThrottleType.PAUSE et ThrottleEvent.targetFrameRate=0. De la même façon que lorsque le contenu reçoit un événement ThrottleType.THROTTLE, le contenu peut exécuter du code dans l’écouteur d’événement en vue de préparer la pause. Lorsque l’écouteur d’événement est renvoyé, le contenu passe en état de pause. Lorsqu’il est en pause, le contenu ne réagit pas à l’interaction de l’utilisateur, notamment aux clics de souris ou aux saisies clavier. Cependant, il est toujours possible de recevoir les événements réseau ActionScript.
Lorsque Flash Player reprend la lecture du contenu à partir d’un état de ralentissement ou de pause, un événement ThrottleEvent est distribué avec ThrottleEvent.state=ThrottleType.RESUME. La propriété ThrottleEvent.targetFrameRate décrit la cadence ; elle est généralement égale à Stage.frameRate. La lecture du contenu peut reprendre lorsque n’importe quelle partie de la scène devient visible ou lorsque l’utilisateur sollicite la reprise de la lecture du contenu.
Les plates-formes qui prennent en charge le ralentissement et la mise en pause sont les suivantes : Flash Player Desktop Mac et Windows, AIR Mobile et Flash Player Android. Les plates-formes suivantes ne distribuent pas automatiquement l’événement ThrottleEvent, car elles ne prennent pas encore en charge la réduction et la mise en pause : AIR pour TV, AIR for Desktop et Flash Player Linux Desktop.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | |
| cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | |
| eventPhase : uint [lecture seule]
Phase actuelle du flux d’événements. | Event | |
| state : String [lecture seule]
Décrit l’état qu’est sur le point d’adopter le lecteur : ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [lecture seule]
Cible de l’événement. | Event | |
| targetFrameRate : Number [lecture seule]
Cadence ciblée par Flash Player ou AIR après la distribution de l'événement ThrottleEvent. | ThrottleEvent | ||
| type : String [lecture seule]
Type d’événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Crée un objet Event contenant des informations sur l’événement ThrottleEvent. | ThrottleEvent | ||
[override]
Crée une copie de l’objet ThrottleEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine. | ThrottleEvent | ||
|
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | |
|
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 | |
|
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | |
|
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements. | Event | |
|
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 répertoriant toutes les propriétés de l’objet ThrottleEvent. | ThrottleEvent | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| Constante | Défini par | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [statique]
Définit la valeur de la propriété type d’un objet d’événement ThrottleEvent. | ThrottleEvent | ||
state | propriété |
state:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
Décrit l’état qu’est sur le point d’adopter le lecteur : ThrottleType.THROTTLE, ThrottleType.PAUSEou ThrottleType.RESUME.
Implémentation
public function get state():StringEléments de l’API associés
targetFrameRate | propriété |
targetFrameRate:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
Cadence ciblée par Flash Player ou AIR après la distribution de l'événement ThrottleEvent.
Par exemple, si le contenu est mis en pause, targetFrameRate est 0. Si le contenu est ralenti, la propriété targetFrameRate est généralement comprise entre 2 et 8 en fonction de plusieurs facteurs, notamment selon la plate-forme sur laquelle le contenu est exécuté et selon qu’un fichier audio est en cours de lecture ou pas. Si le contenu est renvoyé à la cadence prévue après une pause ou un ralentissement, la propriété targetFrameRate est égale à Stage.frameRate.
Implémentation
public function get targetFrameRate():NumberEléments de l’API associés
ThrottleEvent | () | Constructeur |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
Crée un objet Event contenant des informations sur l’événement ThrottleEvent. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.
Paramètrestype:String — Type de l’événement. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n’existe qu’un seul type d’événement ThrottleEvent : ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles héritée.
| |
cancelable:Boolean (default = false)cancelable héritée.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate est 0. Si le contenu est ralenti, la propriété targetFrameRate est généralement comprise entre 2 et 8 en fonction de plusieurs facteurs, notamment selon la plate-forme sur laquelle le contenu est exécuté et selon qu’un fichier audio est en cours de lecture ou pas. Si le contenu est renvoyé à la cadence prévue après une pause ou un ralentissement, la propriété targetFrameRate est égale à Stage.frameRate.
|
Eléments de l’API associés
clone | () | méthode |
override public function clone():Event| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
Crée une copie de l’objet ThrottleEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
Valeur renvoyéeEvent — Nouvel objet ThrottleEvent dont les propriétés ont la même valeur que celles de l’objet d’origine.
|
toString | () | méthode |
override public function toString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
Renvoie une chaîne répertoriant toutes les propriétés de l’objet ThrottleEvent. La chaîne est écrite au format suivant :
[ThrottleEvent type=valeur bubbles=valeur cancelable=valeur state=valeur targetFrameRate=valeur]
String — Chaîne répertoriant toutes les propriétés de l’objet ThrottleEvent.
|
THROTTLE | Constante |
public static const THROTTLE:String = "throttle"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.2 |
Définit la valeur de la propriété type d’un objet d’événement ThrottleEvent.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Toute occurrence de DisplayObject à laquelle est associé un écouteur pour l’événement throttle. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE ou ThrottleType.RESUME. |
targetFrameRate | Décrit la cadence ciblée par Flash Player ou AIR après la distribution de l’événement ThrottleEvent. Par exemple, si le contenu est en pause, la propriété targetFrameRate est égale à 0. Si le contenu est ralenti, la propriété targetFrameRate est généralement comprise entre 2 et 8 en fonction de plusieurs facteurs, notamment selon la plate-forme sur laquelle le contenu est exécuté et selon qu’un fichier audio est en cours de lecture ou pas. Si le contenu est renvoyé à la cadence prévue après une pause ou un ralentissement, la propriété targetFrameRate est égale à Stage.frameRate. |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z