layer_get_all_elements


La description

Vous pouvez utiliser cette fonction pour obtenir les ID d'élément du calque donné. Vous fournissez l'ID de couche (que vous obtenez lorsque vous créez la couche en utilisant layer_create() ) ou le nom de la couche (en tant que chaîne - cela aura un impact sur les performances) et la fonction renvoie un tableau d'ID, où chaque entrée du tableau est un ID unique pour un élément de cette couche. Par exemple, si la couche est un Asset Layer, le tableau sera rempli avec les valeurs ID pour chaque ressource sprite affectée à la couche. Notez que l'utilisation du code pour travailler avec des couches signifie que vous pouvez affecter différents types d'éléments à la même couche - vous pouvez donc avoir des ressources de sprites avec des instances, par exemple - auquel cas vous pouvez utiliser la fonction layer_get_element_type pour obtenir le type d'élément auquel l'ID se rapporte.


Syntaxe:

layer_get_all_elements(layer_id)


Arguments:

Argument La description
layer_id La valeur d'ID unique du calque pour obtenir les éléments (ou le nom du calque sous forme de chaîne)


Résultats:

Array (1D, populated with Element IDs)


Exemple:

var a = layer_get_all_elements(layer);
for (var i = 0; i < array_length_1d(a); i++;)
   {
   if layer_get_element_type(a[i]) == layerelementtype_sprite
      {
      layer_sprite_destroy(a[i])
      }
   }

Le code ci-dessus obtient les ID de tous les éléments d'instance affectés à la couche de l'instance exécutant le code. Le code vérifie ensuite si l'un des éléments renvoyés sont des éléments d'image-objet et s'ils sont alors détruits.


Précédent: Fonctions de couche générales
suivant: layer_get_element_layer
© Copyright YoYo Games Ltd. 2017 Tous droits réservés