VisualuRuby(tmp) Reference

VRTreeview

vr/vrcomctl.rb

VRTreeview

Treeview.

Methods

hitem is an Integer value identifying treeview item.

insertItem(hparent,hafter,text,lparam=0,textsize=text.size)

Inserts a new item below hparent and after hafter, the text is text and lparam=lparam.

insertMultiItems(hparent,hafter,items)

Inserts new items below hparent and after hafter. items is a structured array of item array. [text,lparam, child item array as optional].

addItem(hparent,text,lparam=0,textsize=text.size)

Adds a new item below hparent at the last.

addMultiItems(hparent,items)

Same as insertMultiItems( hparent,last,items )

deleteItem(hitem)

Deletes the item.

clearItems

Deletes all items.

countItems

Counts items.

selectItem(hitem)

Selects the item.

expandItem(hitem,mode)

Expand or Collapse item. mode means; 1: collapse, 2: expand, 3:toggle

indent

Returns the indent width.

indent=

Sets the indent width.

hittest(x,y)

Inspect the item index which is at the co-ordinate(x,y)

hittest2(x,y)

Returns the item information which is at the co-ordinate(x,y). The information is the array [x,y,part,index,subitem]

getNextItem(hitem,code)

Searches for an item described by start and code. code is the series of TVGN_???? in commctrl.h

topItem

The top item in the listview. (not the visible top item)

root

The virtual root item which is not visible and touched.

last

The last item in the listview (not the visible last item)

selectedItem()

Returns the selected item. aliased as selected

getParentOf(hitem)

Returns the parent item of hitem.

getChildOf(hitem)

Returns the first child item of hitem.

getNextSiblingOf(hitem)

Returns the next sibling item of hitem.

setImagelist(imagelist)

Set imagelist for displaying icons of items. imagelist must be a kind of SWin::Imagelist.

setItemIconOf(hitem,img,simg)

Sets image ids of the item. img for normal state image and simg for selected state image. Both of them are Integers of id in ImageList and img and simg can be ignored by setting nil instead of integer. The imagelist is set by setImagelist method.

getItemIconOf(hitem)

Returns images id of the item.

setItemLParamOf(hitem,lparam)

Sets lparam of the item.

getItemLParamOf(hitem)

Returns lparam of the item.

setItemTextOf(hitem,text)

Sets text of the item.

getItemTextOf(hitem,textsize=128)

Returns text of the item.

setItemStateOf(hitem,state)

Sets state of the item.

• 1 : focused
• 2 : selected
• 4 : cut
• 8 : drophilited
• 16 : bold
• 32 : expanded

getItemStateOf(hitem)

Returns state of the item.

Event handlers

????_selchanged(hitem,lparam)

fired when selected item is changed to hitem whose lparam is lparam.

????_itemexpanded(hitem,state,lparam)

fired when the hitem item is expanded or closed.

????_deleteitem(hitem,lparam)

fired when the item is deleted.

????_begindrag(hitem,state,lparam)

????_beginrdrag(hitem,state,lparam)