Adobe 38040334 API Reference - Page 149

DREAMWEAVER CS3 144 API Reference • The itemData argument is a string you can use to store specific data about the item being added such as a document line number. • The iStartSel argument is the start of selection offset in the file. Specify the value null if you are not specifying an offset. • The iEndSel argument is the end of selection offset in the file. Specify the value null if you are not specifying an offset. • The colNdata argument is an array of strings that provide the data for each column (that is, if there are 3 columns, an array of 3 strings). Returns A Boolean value: true if the item was added successfully; false otherwise. Example The following example creates a Results window called resWin that has the column headings: Frodo, Sam, and Gollum. The call to the resWin.addItem() function adds a folder icon and then the three strings, msg1, msg2, and msg3 into the three columns defined for the window. var resWin = dw.createResultsWindow("Test Window", ["Frodo", "Sam", "Gollum"]); resWin.addItem(resWin, "3", "Description", null, null, null, ["msg1", "msg2", "msg3"]); resWin.getItem() Availability Dreamweaver 4. Description Retrieves an array of items that include the name of the command that added the item and the same strings that were passed to the addItem() function. Arguments itemIndex • The itemIndex argument is the index of the item whose data is to be retrieved. Returns An array of strings. The first element in the array is the name of the command that added the item; the remaining elements are the same strings that were passed to the addItem() function. resWin.getItemCount() Availability Dreamweaver 4. Description Retrieves the number of items in the list. Arguments None.