IntToHandle(integer)

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

Version 2.0

説明

IntToHandle 関数は、整数をハンドルに変換します。整数は、実際のハンドルと関連付けられている必要があります。

ハンドルの詳細や関連関数については、ハンドルを参照してください。

引数

integer:
オブジェクトのハンドルと関連付けられた整数です。

戻り値

handle:
指定した整数と関連付けらているオブジェクトのハンドルを返します。

例

選択されているシーケンスのハンドルと関連付けられている整数を出力します。また、その整数をハンドルに変換し、それを用いてシーケンス名を出力します。

Copy Code

Lua

return function()
    -- Convert the handle of the currently selected sequence to an integer
    local handleInt = HandleToInt(SelectedSequence())
    -- Print the handle integer
    Printf("The handle integer number of the selected sequence: %i", HandleToInt(SelectedSequence()))
    -- Convter the integer back to a hanndle and use it to get the sequence name
    Printf("The name of the selected sequence is: %s", IntToHandle(handleInt).name)
end