Flash CS4 Professional ActionScript 2.0

Classe DepthManager

Nom de classe ActionScript mx.managers.DepthManager

La classe DepthManager permet de gérer les affectations de profondeur relatives des composants ou des clips, dont _root. Elle autorise également à gérer les profondeurs réservées dans un clip spécial et ceci à la profondeur la plus élevée sur _root pour les services de niveau système, tels que le curseur et les info-bulles.

REMARQUE

 

La classe DepthManager est prise en charge uniquement si vous travaillez dans un document spécifiant ActionScript 2.0 dans ses paramètres de publication.

En général, Depth Manager gère les composants automatiquement, à l'aide de son propre algorithme de « réarrangement ». Si vous n'êtes pas expérimenté en développement Flash, il n'est pas nécessaire d'utiliser ses API.

 

Pour utiliser la classe DepthManager pour des occurrences de clip, la bibliothèque ou la scène doit contenir un composant et vous devez utiliser « import mx.managers.DepthManager » au début de votre ActionScript.

L'API de tri de profondeur relative se compose des méthodes suivantes :

Les méthodes suivantes composent les API d'espace de profondeur réservée :

Méthodes de la classe DepthManager

Le tableau suivant présente les méthodes de la classe DepthManager.

Méthode

Description

DepthManager.createChildAtDepth()

Crée un enfant du symbole indiqué à la profondeur spécifiée.

DepthManager.createClassChildAtDepth()

Crée un objet de la classe indiquée à la profondeur spécifiée.

DepthManager.createClassObjectAtDepth()

Crée une occurrence de la classe indiquée à la profondeur spécifiée dans le clip spécial de profondeur la plus élevée.

DepthManager.createObjectAtDepth()

Crée un objet à une profondeur spécifiée dans le clip spécial de profondeur la plus élevée.

DepthManager.setDepthAbove()

Définit la profondeur au-dessus de l'occurrence spécifiée.

DepthManager.setDepthBelow()

Définit la profondeur sous l'occurrence spécifiée.

DepthManager.setDepthTo()

Définit la profondeur de l'occurrence spécifiée dans le clip de profondeur la plus élevée.

Propriétés de la classe DepthManager

Le tableau suivant présente les propriétés de la classe DepthManager. Les valeurs constantes indiquées sont les valeurs par défaut utilisées par l'algorithme DepthManager pour organiser la profondeur. Si vous suivez les propriétés suivantes, ces valeurs constantes s'affichent dans le panneau Sortie.

Néanmoins, une fois que vous avez implémenté une méthode DepthManager (DepthManager.setDepthTo(), par exemple) à l'aide des propriétés suivantes et que vous avez tracé la profondeur du clip ou du composant, DepthManager définit les profondeurs par incréments de 20. L'algorithme incrémente les profondeurs au cas où Flash aurait besoin d'insérer un autre élément au milieu, selon d'autres scripts, composants, etc.

Propriété

Description

DepthManager.kBottom

Propriété statique de valeur constante 202.

DepthManager.kCursor

Propriété statique de valeur constante 101.
Il s'agit de la profondeur du curseur.

DepthManager.kNotopmost

Propriété statique de valeur constante 204.

DepthManager.kTooltip

Propriété statique de valeur constante 102.
Il s'agit de la profondeur de l'info-bulle.

DepthManager.kTop

Propriété statique de valeur constante 201.

DepthManager.kTopmost

Propriété statique de valeur constante 203.