GetUISettings(handle)

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

説明

The GetUISettings function returns a text string with the name of the UI settings for the object.

引数

  • handle:
    The function takes a handle of the type "light_userdata" as an argument.
    It can be omitted when using the colon notation on an object.

    The Colon Notation is a way to omit the handle as the first argument when using the Object functions.

    This is the general syntax with the colon notation: object:function()

    This is the general syntax with standard handle notation: object.function(object)

    Learn more in the Lua Functions - Object API topic.

戻り値

  • string:
    The function returns a text string with the name of the object's UI settings.

This example prints the name of the selected sequence's settings.

Lua
return function()
-- SelectedSequence() creates a handle to the selected sequence.
local selectedSequence = SelectedSequence()
-- Get the name of the editor for the sequence object.
local seqSettings = selectedSequence:GetUISettings()
-- Print some feedback.
if seqSettings ~= nil then
Printf("The name of the settings is: " .. seqSettings)
else
Printf("The object doesn not appear to have an editor.")
end
end