TreeItem:loadicon(path, [index]) method

Loads an item icon, displayed to the left of the item's text.

Parameters

path

Represent any of the following possible icon locations :

  • A string which represents the path to an ".ico" icon file, or gets the icon associated with the provided file/directory.
  • A Widget object, whose icon will be used by the item.
  • A Directory or File object, representing an ".ico" file, or gets the icon associated with the provided file/directory.
  • A Buffer object, whose binary content will represent the icon.

When no argument or a nil path value is provided, the TreeItem icon will be removed.

[index]

The icon index, an optional number starting from 1, that represent the icon to select.

Example

local ui = require "ui" -- create a simple Window local win = ui.Window("TreeItem:loadicon() sample", 316, 246) local tree = ui.Tree(win, {"Disk", "Network", "Search"}, 10, 40) local icons = { Disk = 8, Network = 19, Search = 23 } -- set Tree style property to "icons" to view TreeItems icons tree.style = "icons" -- all icons are in a resources directory for item, icon in pairs(icons) do tree.items[item]:loadicon("shell32.dll", icon) end -- shows the Window win:show() -- update user interface repeat ui.update() until not win.visible