HasActivePlayback(handle)

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

説明

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

引数

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

戻り値

  • boolean:
    再生状態を示す 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