gre.set focus

gre.set_focus(
    fqn
)
            

Set the focus to a control as described by its fully qualified name. This function returns true if the control could be found and was focusable and focus could be set to it. If the control can be found but is not focusable then false will be returned. If the control can't be found then nil will be returned.

When the fully qualified name indicates the row and column of a table, then this function will set the active table cell rather than adjusting the control focus.

-- Set the focus to MyControl
local didApply = gre.set_focus("MyLayer.MyControl")
if(not didApply) then
    print("Failed to set focus")
end

-- Set to focus to the second row item in a table
local didApply = gre.set_focus("MyLayer.MyTable.2.1")
if(not didApply) then
    print("Failed to set table cell focus")
end