gui.getComponentFromInstance

Get the handle from an instantiated component.

Prototype

hComponent = gui.getComponentFromInstance ( hInstance, sComponentIdentifier )

Description

We need this function because getComponent cannot determine for instance which editbox you want if you have 3 instances with an editbox inside.

Parameters

hInstance - instance handle
sComponentIdentifier - component identifier string you are searching for

Return values

hComponent - handle to the component associated with the identifier string, or nil

Sample

function onPropertyViewControlColorSliderRGBChanged ( hView, hComponent, nValue )
 
    local hInstance = gui.getParentComponent ( hComponent )
 
    local hSliderRed   = gui.getComponentFromInstance ( hInstance, "red"    )
    local hSliderGreen = gui.getComponentFromInstance ( hInstance, "green"  )
    local hSliderBlue  = gui.getComponentFromInstance ( hInstance, "blue"   )
    local hButton      = gui.getComponentFromInstance ( hInstance, "button" )
 
    -- etc.

Available since ShiVa 2.0