HasActivePlayback(handle)

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

説明

HasActivePlayback 関数は、オブジェクトに現在アクティブな再生があるかどうか(例: シーケンスにアクティブなキューがあるか)を表す boolean 値を返します。

引数

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

戻り値

  • Result:
    再生状態を表す boolean 値を返します。
    • true: アクティブな再生があります。
    • false: アクティブな再生はありません。

例

選択されているシーケンスにアクティブな再生があるどうかについて出力します。

Copy Code
Lua
return function()
    -- Stores the handle of the selected sequence.
    local selectedSequence = SelectedSequence() 

    -- The following 'if' gives different feedback based on the playback status.
    if selectedSequence:HasActivePlayback() then
        Printf("Sequence '" ..selectedSequence.name.. "' has active playback.")
    else
        Printf("Sequence '" ..selectedSequence.name.. "' has NO active playback.")
    end
end