PureBasic

AddGadgetColumn()

Синтаксис

AddGadgetColumn(#Gadget , Position , Title$ , Width)

Описание


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

Параметры

#Gadget Номер идентифицирующий указанный Гаджет.
Position Параметр задаёт индекс столбца, куда следует вставить новый элемент. Индексация столбцов начинается с 0, что соответствует самому левому столбцу, и увеличивается на 1 с каждым столбцом вправо. Когда вы добавляете столбец, все прежние столбцы справа от нового столбца получают позицию на единицу большую, чем прежняя.
Title$ Текст для заголовка столбца.
Width Начальная ширина нового столбца.

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

Ничего.

Комментарии

Эта команда может использоваться со следующими типами Гаджетов:

- ListIconGadget()
- ExplorerListGadget()

Для Гаджета ExplorerListGadget() с помощью этой функции вы можете задать абсолютно произвольную форму отображения информации, убрав сначала стандартные столбцы с помощью функции RemoveGadgetColumn() а затем добавив новые по вашему выбору. Учтите, что столбец 'Имя' не обязательно должен быть первым в Гаджете.
Примечание. Чтобы обновить содержание Гаджета после добавления новых столбцов, используйте функцию SetGadgetText(). Для того, чтобы заполнить пользовательский столбец (который не является одним из столбцов изначально поддерживаемых Гаджетом), вызывайте функцию SetGadgetItemText() для каждого элемента после получения события #PB_EventType_Change для Гаджета.
При добавлении столбца используйте одну из следующих констант в поле Title$ для создания столбца, содержимое которого автоматически обновляется Гаджетом, или используйте любую строку в качестве заголовка чтобы создать пустой столбец, который вы сможете заполнять с помощью функции SetGadgetItemText(). 
  #PB_Explorer_Name       : показывает имя файла/директории
  #PB_Explorer_Size       : показывает размер файла в Кб
  #PB_Explorer_Type       : показывает строку описания типа файла
  #PB_Explorer_Attributes : показывает атрибуты файла/директории
  #PB_Explorer_Created    : показывает время создания файла/директории
  #PB_Explorer_Modified   : показывает время последнего изменения файла/директории
  #PB_Explorer_Accessed   : показывает время последнего доступа к файлу/директории

Пример

If OpenWindow(0, 0, 0, 400, 150, "Список с иконками - Добавляет Столбец", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ListIconGadget(0, 10, 10, 380, 100, "Стандартный Столбец", 150, #PB_ListIcon_GridLines)
    ButtonGadget(1, 10, 120, 150, 20, "Добавляет новый Столбец")
    index = 1    ; "Стандартный Столбец" уже занял индекс 0
    Repeat
        Event = WaitWindowEvent()
        If Event = #PB_Event_Gadget
            If EventGadget() = 1
                AddGadgetColumn(0, index, "Столбец "+Str(index), 80)
                index + 1
            EndIf
        EndIf
    Until Event = #PB_Event_CloseWindow
EndIf

См. также

RemoveGadgetColumn(), ListIconGadget(), ExplorerListGadget()

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

Все

Оглавление Gadget - AddGadgetItem() ->