layer_get_all_elements()

Game Maker Language リファレンス > 組み込み関数 用途別 > リソース操作・ルーム > 一般的なレイヤー関数 > layer_get_all_elements()

layer_get_all_elements() †

この関数は、指定したレイヤーのElement IDを取得できます。 レイヤーID（ layer_create() を使用してレイヤーを作成するときに取得する）またはレイヤー名（文字列として。これはパフォーマンスに影響します）を指定すると、関数はIDの配列を返します。 その配列のIDは、そのレイヤー上のElement IDです。 たとえば、レイヤーがアセットレイヤーの場合、配列には、レイヤーに割り当てられている各スプライトアセットのID値が入力されます。 コードを使用してレイヤーを操作することは、異なるレイヤータイプを同じレイヤーに割り当てることができることを意味します。たとえば、スプライトアセットをインスタンスと一緒に持つことができます。たとえば、この場合、関数 layer_get_element_type() を使用してElementのタイプを取得できます。 IDは関連しています。

注記

Element IDの種類については layer_get_element_type() を参照

構文 †

layer_get_all_elements(layer_id)

layer_id

Element ID を取得するレイヤID（またはアセットブラウザ上でのレイヤー名の文字列）

戻り値 †

Array

Element ID の配列

例 †

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])
  }
}

上記のコードは、コードを実行しているインスタンスのレイヤーに割り当てられているすべてのインスタンスのElement IDを取得します。 次に、コードは、返されたElementのいずれかがスプライトアセットであるかどうかを確認し、そうである場合は破棄されます。