Children(handle)

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object API » Children(handle)

Version 2.0

説明

Children 関数は、オブジェクトの子のハンドル・テーブルを作成します。

引数

handle:
light_userdata 型のハンドルです。オブジェクトでコロン記法を用いる場合は省略できます(後述の例を参照)。

戻り値

table:
子オブジェクトのテーブルを返します。子がない場合は、空のテーブルを返します。

例

選択されているデータプールの最初のシーケンスにあるキューの名前を返します。

Copy Code

Lua

return function()
    -- Stores the handle for sequence 1 in a variable.
    local mySequence = DataPool().Sequences[1]
    -- Use the "Children()" funciton to store a table with all the children in a new variable.
    local cues = mySequence:Children()
    -- For loop that uses the length operator on the cue variable.
    for i = 1, #cues do
        -- Text is printed for each child.
        Printf("Sequence 1 Child " .. i .. " = " .. cues[i].name)
    end
end