Flash CS4 Professional ActionScript 2.0

Interface TreeDataProvider

L'interface TreeDataProvider est un ensemble de propriétés et de méthodes qui n'a pas besoin d'être instancié pour être utilisé. Si une classe Tree est comprise dans un fichier SWF, toutes les occurrences XML de ce fichier contiennent l'interface TreeDataProvider. Les nœuds d'une arborescence sont autant d'objets XML contenant l'interface TreeDataProvider.

REMARQUE

 

L'interface TreeDataProvider est prise en charge uniquement si vous travaillez dans un document spécifiant ActionScript 2.0 dans ses paramètres de publication.

Il est recommandé d'utiliser les méthodes de TreeDataProvider pour créer du code XML pour la propriété Tree.dataProvider, car seule l'interface TreeDataProvider diffuse des événements qui actualisent l'affichage de l'arborescence. Il s'agit d'événements gérés par la classe Tree ; vous ne devez pas écrire de fonctions pour gérer ces événements. (Les méthodes de la classe XML intégrée ne diffusent pas de tels événements.)

Utilisez les méthodes de TreeDataProvider pour contrôler le modèle et l'affichage des données. Utilisez les méthodes de la classe XML intégrée pour les tâches en lecture seule (parcourir la hiérarchie de l'arborescence, par exemple).

Vous pouvez sélectionner la propriété qui contrôle le texte à afficher en spécifiant une propriété labelField ou labelFunction. Par exemple, le code myTree.labelField = "firstName"; renvoie une requête sur la valeur de la propriété myTreeDP.attributes.fred pour le texte d'affichage.

Méthodes de l'interface TreeDataProvider

Le tableau suivant répertorie les méthodes de l'interface TreeDataProvider.

Méthode

Description

TreeDataProvider.addTreeNode()

Ajoute un nœud enfant à la racine de l'arborescence.

TreeDataProvider.addTreeNodeAt()

Ajoute un nœud enfant à un endroit spécifié sur le nœud parent.

TreeDataProvider.getTreeNodeAt()

Renvoie l'enfant spécifié d'un nœud.

TreeDataProvider.removeTreeNode()

Supprime un nœud et tous les descendants du nœud à partir du parent du nœud.

TreeDataProvider.removeTreeNodeAt()

Supprime un nœud et tous les descendants du nœud à partir de la position dans l'index du nœud enfant.

Propriétés de l'interface TreeDataProvider

Le tableau suivant répertorie les propriétés de l'interface TreeDataProvider.

Propriété

Description

TreeDataProvider.attributes.data

Spécifie les données à associer à un nœud.

TreeDataProvider.attributes.label

Spécifie le texte à afficher à côté d'un nœud.