layer_get_id()

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

layer_get_id() †

この関数は、文字列指定でレイヤーIDを取得できます。 IDEでは、すべてのレイヤーに名前とタイプがあり、コードを通じてそれらを編集または変更できるようにするには、レイヤーID値を指定する必要があります。 この関数は、レイヤーの名前（文字列）（IDEで記述されている）を使用してこのIDを取得するために使用されます。 関数 layer_create() を使用してコードを通じて新しいレイヤーを作成すると、その関数は代わりに一意のID値を返します（動的に作成されたレイヤーは名前を取得しません）。 現在のルームに存在しないレイヤーの名前を指定すると、エラーが発生し、プロジェクトがクラッシュすることに注意してください。

構文 †

layer_get_id(layer_name)

layer_name

レイヤー名(文字列)

戻り値 †

Layer ID (Real), or -1

レイヤーID。存在しない場合は -1

例 †

var near = instance_nearest(x, y, obj_Tree);
var layer_id = layer_get_id("Instances Front");
layer_add_instance(layer_id, near);

上記のコードは、最初に指定されたx/yに最も近いインスタンスのインデックスを取得し、ローカル変数に格納します。 次に、"Instances Front" という名前のレイヤーの一意のインスタンスレイヤーIDを取得し、見つかったインスタンスをそのレイヤーに移動します。