gui.appendListItem

Adds a new empty item to a list.

Prototype

hListItem = gui.appendListItem ( hComponent )

Parameters

hComponent - valid GUI component handle

Return values

hListItem - list item handle

Sample

function onMainViewRefreshAdditionalFilesList ( hList, sAdditionalFiles )
 
    if ( hList ) then
        local tFiles = string.explode ( sAdditionalFiles, ";" )
 
        if ( tFiles ) then
            gui.removeAllListItems ( hList )
 
            for i = 1, #tFiles do
                local sFile = tFiles[i] -- TODO: trim spaces
 
                if  ( sFile ~= "" ) then
                    local hItem = gui.appendListItem ( hList )
 
                    if ( hItem ) then
                        gui.setListItemText ( hItem, sFile )
                    end
 
                end
 
            end
        end
    end 
end 

Available since ShiVa 2.0