gui.findListItem

Prototype

  1. hListItem = gui.findListItem ( hComponent, kDataRole, vValue, [iColumn=1], [hStartListItem=nil] )

Description

hComponent -/- valid list handle
kDataRole -/- predefined data role constant
vValue -/-
iColumn -/- optional column parameter 1..n, default 1
hStartListItem -/-

Return values

hListItem - handle to found list item on success, otherwise nil

Sample

  1. function updateMainViewFileItemThumbnails ( hFile, bUpdateFileInfos, bUpdateFileStatus, bUpdateFileTargetProfile, _hList, hItem )
  2.  
  3.     local hList = _hList or gui.getComponent ( "MainView.list.thumbnails" )
  4.     if ( hList ) then
  5.         if ( hItem == nil ) then
  6.             -- Find existing item for hFile        
  7.             hItem = gui.findListItem ( hList, hFile )
  8.             if (  hItem == nil ) then

Available since ShiVa 2.0