AddGadgetItem()

Синтаксис

Result = AddGadgetItem(#Gadget , Position , Text$ [, ImageID [, Flags]])

Описание

Добавляет новый элемент (Item) в указанный Гаджет.

Параметры

#Gadget	Номер идентифицирующий указанный Гаджет.
Position	Этот параметр задаёт индекс элемента, куда следует вставить новый элемент. Чтобы добавить элемент в начало используйте индекс 0. Чтобы добавить элемент в конец текущего списка элементов используйте значение -1. Помните, что когда вы добавляете элемент, все следующие за ним получают позиции на 1 большие. Для Гаджета MDIGadget() параметр 'Position' задаёт Номер окна #Window для нового дочернего окна MDI. Здесь для этого Гаджета может использоваться значение #PB_Any, в этом случае возвращаемое значение будет новым Номером, присвоенным PB.
Text$	Текст для нового элемента. При добавлении элемента в ListIconGadget(), этот параметр может содержать текст для нескольких столбцов, разделенных символом Chr (10).
ImageID (дополн.)	Дополнительное изображение, для элемента в поддерживающих его Гаджетах. Используемое изображение должно быть в стандартном размере 16x16. Используйте команду ImageID(), чтобы получить ID для этого параметра.
Flags (дополн.)	Этот параметр имеет значение только для следующих типов Гаджетов: TreeGadget() Для этого Гаджета параметр 'Flags' всегда обязателен. Он задаёт новый подуровень для элемента. Если подуровень больше, чем подуровень предыдущего элемента, новый элемент станет потомком предыдущего элемента. Если подуровень меньше, новый элемент будет добавлен после родителя предыдущего элемента. MDIGadget() Параметр 'Flags' можно использовать для задания флагов нового окна (смотрите описание функции OpenWindow()). #PB_Window_Borderless, #PB_Window_Screencentered и флаги #PB_Window_WindowCentered для окон MDI не поддерживаются.

Возвращаемое значение

Возвращаемое значение является действительным только с MDIGadget(). Если при добавлении элемента в MDIGadget() в качестве параметра 'Position' использовалось значение #PB_Any, то возвращаемое значение - это Номер, который идентифицирует новое окно MDI.

Комментарии

Добавляет Элементы в следующие Гаджеты:

- ComboBoxGadget(): поддерживает ImageID, если установлен #PB_ComboBox_Image.
- EditorGadget()
- ListIconGadget(): поддерживает ImageID.
- ListViewGadget()
- MDIGadget(): ImageID может указывать на значок для строки заголовка дочернего окна. 'Flags' могут определять параметры нового окна.
- PanelGadget(): поддерживает ImageID.
- TreeGadget(): поддерживает ImageID. Требуются 'Флаги', которые определяют новый подуровень.

См. также

RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), ComboBoxGadget(), ListIconGadget(), ListViewGadget(), MDIGadget(), PanelGadget(), TreeGadget()

Поддерживаемые OS

Все