Интерфейс ListItem

Объект ListItem представляет собой один элемент в компоненте ListView, этот компонент является коллекцией данных объектов. Подробнее...

Полный список членов класса

Открытые члены

 SetPosition ([in] ULONG Left,[in] ULONG Top)
 Позволяет задать позицию элемента.

Свойства

BSTR RW Text []
 Текст элемента.
LONG RW ImageIndex []
 Индекс изображения в списке изображений владельца.
VARIANT_BOOL RW Selected []
 Свойство позволяет определить выделен ли элемент.
VARIANT_BOOL RW Checked []
 Свойство позволяет определить состояние переключателя у элемента.
BSTR RW SubItems [[in] LONG Index] []
 Свойство позволяет определить текст подэлемента, этот текст отображается в дополнительных колонках у объекта ListView, которому принадлежит данный элемент.
LONG RW SubItemImage [[in] LONG Index] []
 Индекс изображения подэлемента в списке изображений владельца.
LONG R Index []
 Свойство определяет индекс элемента в той коллекции, в которой он находится.
VARIANT RW UserData []
 Свойство UserData - некоторое значение, определяемое и используемое разработчиком в соответствии со своими желаниями.
BSTR RW Hint []
 Позволяет задать подсказку для элемента.
ULONG RW Group []
 Позволяет задать номер группы для элемента.
LONG RW Left []
 Позволяет задать или определить позицию элемента по горизонтали.
LONG RW Top []
 Позволяет задать или определить позицию элемента по вертикали.
IDispatch *RW Font []
 Позволяет задать шрифт (Font) элемента.
ULONG RW TextBkColor []
 Позволяет задать цвет фона элемента.
IDispatch *R SubItemsEx [[in] LONG Index] []
 Позволяет получить объект ListSubItem для задания дополнительных параметров подэлемента (т.

Подробное описание

Объект ListItem представляет собой один элемент в компоненте ListView, этот компонент является коллекцией данных объектов.

Методы

SetPosition ( [in] ULONG  Left,
[in] ULONG  Top 
)

Позволяет задать позицию элемента.

Используется, если определены рабочие области (WorkAreas). Пример (JScript): 

o = new ActiveXObject("Scripting.WindowSystemObject")

fs = new ActiveXObject("Scripting.FileSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 450
f.ClientHeight = 550
f.CenterControl()
f.Text = "ListView Work Areas Demo"

f.BorderWidth = 10
f.MinWidth = 500
f.MinHeight = 350

Box = f.CreateListView(10,10,250,300)
Box.HotTrack = true
Box.Align = o.Translate("AL_CLIENT")

Ext = new ActiveXObject("Scripting.WindowSystemObjectExtensions")
Box.LargeImages = Ext.SystemImageListLarge

Box.WorkAreas.Add(10,10,180,180)
Box.WorkAreas.Add(200,200,200,200)

for (i = 0; i<10; i++)
{
        Item = Box.Add("Item "+i)
        Item.ImageIndex = Ext.GetFileSysIconIndexLarge("1.txt",o.Translate("FILE_ATTRIBUTE_ARCHIVE"))
        if ((i % 2) == 0)
        {
                Item.SetPosition(210,210)
        }
}
Box.Arrange()

f.Show()

o.Run()
Результат:
ListViewWorkAreas.jpg
Начиная с:
1.1.10.

Полный список свойств

VARIANT_BOOL RW Checked

Свойство позволяет определить состояние переключателя у элемента.

Заметки:
Переключатели видны если свойство CheckBoxes у объекта ListView, которому принадлежит данный элемент, имеет значение "TRUE".

IDispatch* RW Font

Позволяет задать шрифт (Font) элемента.

Свойство CustomDraw родительского компонента ListView должно быть "TRUE".

Начиная с:
1.1.12.

ULONG RW Group

Позволяет задать номер группы для элемента.

Используется, если определены группы (Groups). Пример (JScript): 

o = new ActiveXObject("Scripting.WindowSystemObject")
o.EnableVisualStyles = true

fs = new ActiveXObject("Scripting.FileSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 550
f.ClientHeight = 650
f.CenterControl()

Box = f.CreateListView(10,10,250,300)
Box.HotTrack = true
Box.Align = o.Translate("AL_CLIENT")

Ext = new ActiveXObject("Scripting.WindowSystemObjectExtensions")
Box.LargeImages = Ext.SystemImageListLarge
Box.SmallImages = Ext.SystemImageListSmall
Box.Style = o.Translate("LV_VIEW_ICON")

var Data = ["1.txt","1.jpg","1.png","1.exe","1.bat","1.com","1.js","1.vbs","1.bmp","1.ini","1.xml"]

Group1 = Box.Groups.Add("Group 1")
Group2 = Box.Groups.Add("Group 2")

Group1.SubTitle = "The group 1 description where"
Group1.Task = "Task"
Group1.DescriptionTop = "DescriptionTop"
Group1.DescriptionBottom = "DescriptionBottom"
Group1.SubsetTitle = "SubsetTitle"
Group1.HeaderAlign = o.Translate("AL_CENTER")
Group1.FooterAlign = o.Translate("AL_CENTER")
Group1.Collapsible = true
Group1.Footer = "Group 1 Footer Text"
Group2.Footer = "Group 2 Footer Text"

for (i = 0; i<Data.length; i++)
{
        Item = Box.Add("Item "+i+": "+Data[i])
        Item.ImageIndex = Ext.GetFileSysIconIndexLarge(Data[i],o.Translate("FILE_ATTRIBUTE_ARCHIVE"))
        Item.SubItems(0) = "The first line for "+i
        Item.SubItems(1) = "The second line for (a b c d e f g h j k)"+i
        Item.Group = i % 2
}

Box.OnGroupLinkClick = OnGroupLinkClick

function OnGroupLinkClick(Sender,Group){
        f.MessageBox(Group.Header + " clicked")
}


f.Show()

o.Run()
Результат:
ListViewGroups.jpg
Начиная с:
1.1.10.

BSTR RW Hint

Позволяет задать подсказку для элемента.

InfoTip должно быть равно "TRUE".

Начиная с:
1.1.10.

LONG RW ImageIndex

Индекс изображения в списке изображений владельца.

LONG R Index

Свойство определяет индекс элемента в той коллекции, в которой он находится.

LONG RW Left

Позволяет задать или определить позицию элемента по горизонтали.

Используется, если определены рабочие области (WorkAreas). Пример (JScript): 

o = new ActiveXObject("Scripting.WindowSystemObject")

fs = new ActiveXObject("Scripting.FileSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 450
f.ClientHeight = 550
f.CenterControl()
f.Text = "ListView Work Areas Demo"

f.BorderWidth = 10
f.MinWidth = 500
f.MinHeight = 350

Box = f.CreateListView(10,10,250,300)
Box.HotTrack = true
Box.Align = o.Translate("AL_CLIENT")

Ext = new ActiveXObject("Scripting.WindowSystemObjectExtensions")
Box.LargeImages = Ext.SystemImageListLarge

Box.WorkAreas.Add(10,10,180,180)
Box.WorkAreas.Add(200,200,200,200)

for (i = 0; i<10; i++)
{
        Item = Box.Add("Item "+i)
        Item.ImageIndex = Ext.GetFileSysIconIndexLarge("1.txt",o.Translate("FILE_ATTRIBUTE_ARCHIVE"))
        if ((i % 2) == 0)
        {
                Item.SetPosition(210,210)
        }
}
Box.Arrange()

f.Show()

o.Run()
Результат:
ListViewWorkAreas.jpg
Начиная с:
1.1.10.

VARIANT_BOOL RW Selected

Свойство позволяет определить выделен ли элемент.

LONG RW SubItemImage[[in] LONG Index] (  ) 

Индекс изображения подэлемента в списке изображений владельца.

Аргументы:
Index индекс подэлемента

BSTR RW SubItems[[in] LONG Index] (  ) 

Свойство позволяет определить текст подэлемента, этот текст отображается в дополнительных колонках у объекта ListView, которому принадлежит данный элемент.

Аргументы:
Index индекс подэлемента
Заметки:
Свойство Style объекта ListView должно иметь значение LVS_REPORT для отображения колонок.

подэлементы нумеруются начиная с 0.

IDispatch* R SubItemsEx[[in] LONG Index] (  ) 

Позволяет получить объект ListSubItem для задания дополнительных параметров подэлемента (т.

е. отображения содержимого в соответствующей дополнительной колонке).

Аргументы:
Index индекс подэлемента (т. е. индекс дополнительной колонки, нумерация с 0)
Возвращаемые значения:
pVal Объект ListSubItem.
Начиная с:
1.1.12.

BSTR RW Text

Текст элемента.

ULONG RW TextBkColor

Позволяет задать цвет фона элемента.

Свойство CustomDraw родительского компонента ListView должно быть "TRUE". Если равно COLOR_NONE то используется цвет родительского компонента Color. Значение по умолчанию: COLOR_NONE.

Начиная с:
1.1.12.

LONG RW Top

Позволяет задать или определить позицию элемента по вертикали.

Используется, если определены рабочие области (WorkAreas). Пример (JScript): 

o = new ActiveXObject("Scripting.WindowSystemObject")

fs = new ActiveXObject("Scripting.FileSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 450
f.ClientHeight = 550
f.CenterControl()
f.Text = "ListView Work Areas Demo"

f.BorderWidth = 10
f.MinWidth = 500
f.MinHeight = 350

Box = f.CreateListView(10,10,250,300)
Box.HotTrack = true
Box.Align = o.Translate("AL_CLIENT")

Ext = new ActiveXObject("Scripting.WindowSystemObjectExtensions")
Box.LargeImages = Ext.SystemImageListLarge

Box.WorkAreas.Add(10,10,180,180)
Box.WorkAreas.Add(200,200,200,200)

for (i = 0; i<10; i++)
{
        Item = Box.Add("Item "+i)
        Item.ImageIndex = Ext.GetFileSysIconIndexLarge("1.txt",o.Translate("FILE_ATTRIBUTE_ARCHIVE"))
        if ((i % 2) == 0)
        {
                Item.SetPosition(210,210)
        }
}
Box.Arrange()

f.Show()

o.Run()
Результат:
ListViewWorkAreas.jpg
Начиная с:
1.1.10.

VARIANT RW UserData

Свойство UserData - некоторое значение, определяемое и используемое разработчиком в соответствии со своими желаниями.

Документация по WSO 1.1. Последние изменения:Wed Aug 12 18:10:58 2015. (C) Веретенников А. Б. 2004-2015