Интерфейс ListControl

Класс ListControl является базовым классом для компонентов - списков. Подробнее...

Граф наследования:ListControl:

Граф связей класса ListControl:

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

Свойства
LONG RW	ItemIndex []
	Свойство определяет индекс выбранной строки.
LONG RW	ItemHeight []
	Свойство определяет высоту отображаемых строк в компоненте.
VARIANT RW	ItemData [[in] LONG Index] []
	Компоненты - списки позволяют хранить вместе со строкой некоторое произвольное значение, определяемое этим свойством.
VARIANT_BOOL RW	Sorted []
	Свойство определяет автоматическую сортировку строк в алфавитном порядке.
VARIANT_BOOL RW	IntegralHeight []
	Свойство определяет автоматическую корректировку высоты компонента, для того чтобы строки отображались в компоненте по вертикали целиком.
LONG RW	HorizontalExtent []
	Свойство определяет длину внутренней области списка, автоматически создается горизонтальная полоса прокрутки.
IDispatch *RW	Images []
	Свойство позволяет определить параметры объекта ImageList, определяющего набор картинок для элементов.
LONG RW	ImageIndex [[in] LONG Index] []
	Свойство определяет индекс изображения элемента в списке изображений родительского компонента.
VARIANT_BOOL RW	CustomDraw []
	Позволяет задавать цвет и шрифт отдельным элементам в обработчике события OnDrawItem.
VARIANT W	OnDrawItem []
	Свойство позволяет задать обработчик события OnDropDown через 2-й уровень.
VARIANT W	BackgroundImage []
	Свойство позволяет устанавить изображение для фона.
VARIANT_BOOL RW	CustomDrawSelection []
	Если указано "TRUE", то шрифт и фон выделенного элемента могут должны определяться в обработчике события OnDrawItem.

---

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

Класс ListControl является базовым классом для компонентов - списков.

События: компонент поддерживает события группы ListControlEvents.

---

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

VARIANT W BackgroundImage

Свойство позволяет устанавить изображение для фона.

Аргументы:

Image

изображение, параметр может быть: имя файла с изображением поддерживаемых форматов объект Picture который мог быть ранее создан методом LoadImage объекта WindowSystemObject

Начиная с:

1.1.12.

VARIANT_BOOL RW CustomDraw

Позволяет задавать цвет и шрифт отдельным элементам в обработчике события OnDrawItem.

Требуется задать значение "TRUE", чтобы элементы могли отображаться разным цветом. Значение по умолчанию: "FALSE".

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")
f = o.CreateForm(0,0,0,0)

f.ClientWidth = 250
f.ClientHeight = 220
f.CenterControl()

Box = f.CreateListBox(10,10,250,300)
Box.Align = o.Translate("AL_CLIENT")
Box.Font.Size = 16

for (i = 0; i<10; i++)
{
        Box.Add("Item "+i)
}

function OnDrawItem(Box,Item)
{
        i = Item.Index
        if (i % 2 == 0)
        {
                Item.Font.Color = 0x0000FF00
                Item.Font.Size = 12
        } else
        {
                Item.TextBkColor = 0x00E0E0FF
        }
}

Box.OnDrawItem = OnDrawItem
Box.CustomDraw = true

f.Show()

o.Run()

Результат:

Начиная с:

1.1.12.

VARIANT_BOOL RW CustomDrawSelection

Если указано "TRUE", то шрифт и фон выделенного элемента могут должны определяться в обработчике события OnDrawItem.

Значение по умолчанию: "FALSE". Если CustomDrawSelection = "FALSE" и CustomDraw = "TRUE" то шрифт и цвет элемента может быть изменен в обработчике OnDrawItem, но если элемент выделен, то для в качестве цвета фона и цвета шрифта будут использоваться системные цвета.

См. также:

CustomDraw.

Начиная с:

1.1.12.

LONG RW HorizontalExtent

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

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

o.EnableVisualStyles = true

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

f.Text = "WSO"
f.ClientWidth = 350
f.ClientHeight = 180
f.CenterControl()

ListBox1 = f.CreateListBox(10,10,150,150)

with (ListBox1)
{
        for (i = 1; i<50; i++)
                Add("Item "+i)
}

ListBox2 = f.CreateListBox(170,10,150,150)
ListBox2.HorizontalExtent = 300

with (ListBox2)
{
        for (i = 1; i<50; i++)
                Add("Item "+i)
}


f.Show()

o.Run()

Результат:

LONG RW ImageIndex[[in] LONG Index]

(

)

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

Значение по умолчанию: "-1", что означает что индекс неопределен.

Аргументы:

Index

Индекс элемента.

Начиная с:

1.1.12.

IDispatch* RW Images

Свойство позволяет определить параметры объекта ImageList, определяющего набор картинок для элементов.

Для элементов можно задавать индекс в этом списке через свойство ImageIndex.

Заметки:

можно задать существующий объект, так и просто обратиться к свойству для чтения, при этом объект создается автоматически если требуется.

См. также:

ImageIndex.

Начиная с:

1.1.12.

VARIANT_BOOL RW IntegralHeight

Свойство определяет автоматическую корректировку высоты компонента, для того чтобы строки отображались в компоненте по вертикали целиком.

Значение по умолчанию: "TRUE".

VARIANT RW ItemData[[in] LONG Index]

(

)

Компоненты - списки позволяют хранить вместе со строкой некоторое произвольное значение, определяемое этим свойством.

LONG RW ItemHeight

Свойство определяет высоту отображаемых строк в компоненте.

LONG RW ItemIndex

Свойство определяет индекс выбранной строки.

VARIANT W OnDrawItem

Свойство позволяет задать обработчик события OnDropDown через 2-й уровень.

Начиная с:

1.1.12.

VARIANT_BOOL RW Sorted

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

Значение по умолчанию: "FALSE".

---