gui.instantiate

Creates a GUI instance of a GUI library component.

Prototype

hInstance = gui.instantiate ( sLibraryIdentifier, sComponentInLibrary, sLocalInstanceIdentifier, [hView] )

Description

Especially for repeating GUI initializations, for instance in tabbed views.

Parameters

sLibraryIdentifier - library string
sComponentInLibrary - component string
sLocalInstanceIdentifier - new name for the instance
[hView] - optional view handle

Return values

hInstance - handle to the new instance

Sample

    --create Tray Icons
    local hTrayButton = gui.instantiate ( "com.shiva.editor.log.lib", "TrayButton", "TrayButtonMessage" ) 
    local hItem       = gui.instantiate ( "com.shiva.editor.log.lib", "CategoryTemplate", "TrayMessage" )
 
    gui.setPushButtonIcon               ( hTrayButton, hLogMessageIcon )     
    gui.setPushButtonText               ( hTrayButton, "0" )     
    gui.addCurrentModuleTrayComponent   ( hTrayButton, hItem, hItem )  
    gui.setComponentVisible             ( hTrayButton, true )
 
    hTrayButton = gui.instantiate ( "com.shiva.editor.log.lib", "TrayButton", "TrayButtonWarning" ) 
    hItem       = gui.instantiate ( "com.shiva.editor.log.lib", "CategoryTemplate", "TrayWarning" )
 
    gui.setPushButtonIcon               ( hTrayButton, hLogWarningIcon )     
    gui.setPushButtonText               ( hTrayButton, "0" )     
    gui.addCurrentModuleTrayComponent   ( hTrayButton, hItem, hItem )  
    gui.setComponentVisible             ( hTrayButton, true )

Available since ShiVa 2.0