ExplorerTreeGadget

ExplorerTreeGadget()

Синтаксис

Result = ExplorerTreeGadget(#Gadget , x , y , Width , Height , Directory$ , [, Flags])

Описание

Создает Гаджет "Дерево Проводника" (Explorer Tree Gadget), который отображает древовидный список файлов и каталогов, точно так же, как это делает Проводник (Explorer). Этот Гаджет позволяет пользователю перемещаться по файловой системе и выбирать файлы или каталоги.

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.

x, y, Width, Height Позиция и размеры нового Гаджета.

Directory$ Имя, изначально выбранного каталога. Это имя может включать одну или несколько масок, например "C:\*.pb;*.pbi". Если масок нет, имя каталога должно заканчиваться символом '\'. Отсутствие имени каталога приведёт к отображению корневого перечня дисков. Отсутствие масок понимается как маска по умолчанию '*.*'. Так что параметр Directory$ со значением "" отобразит корневой перечень дисков и установит маску '*.*'.
Flags (дополн.)
Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  #PB_Explorer_BorderLess          : Создать Гаджет без границ.
  #PB_Explorer_AlwaysShowSelection : Выделение отображается даже если Гаджет не активирован.
  #PB_Explorer_NoLines             : Скрыть линии, соединяющие узлы дерева.
  #PB_Explorer_NoButtons           : Скрыть кнопки разворачивания узлов в виде символов '+'.

  #PB_Explorer_NoFiles             : Не показывать файлы.
  #PB_Explorer_NoDriveRequester    : Не показывать запрос 'пожалуйста, вставьте диск X:'.
  #PB_Explorer_NoMyDocuments       : Не показывать каталог 'Мои документы' в виде отдельного элемента.
  #PB_Explorer_AutoSort            : Содержимое автоматически упорядочивается по имени.

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

Возвращает не нулевое значение в случае успешного создания Гаджета, в противном случае возвращает ноль. Если в качестве параметра #Gadget использовалось значение #PB_Any, то в случае успеха, возвращаемым значением будет сгенерированный Номер Гаджета.

Комментарии

Вы можете добавить 'Всплывающую мини-подсказку' к этому Гаджету с помощью функции GadgetToolTip().

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

- GetGadgetText(): Возвращает полный путь к выбранному в данный момент каталогу.
- SetGadgetText(): Изменяет отображаемый в данный момент каталог и текущую маску для отображаемых файлов.
- GetGadgetState(): Возвращает тип выбранного элемента (#PB_Explorer_File или #PB_Explorer_Directory).

Этот Гаджет поддерживает функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType':
#PB_Gadget_FrontColor: Цвет текста. #PB_Gadget_BackColor : Цвет фона. #PB_Gadget_LineColor : Цвет линий и кнопок, если они отображаются.
ExplorerTreeGadget() поддерживает следующие События, о которых сообщает EventType():
#PB_EventType_Change : Выделение было изменено. #PB_EventType_LeftClick : Пользователь кликнул на элементе левой кнопкой мыши. #PB_EventType_RightClick : Пользователь кликнул на элементе правой кнопкой мыши. #PB_EventType_LeftDoubleClick : Пользователь сделал двойной клик на элементе левой кнопкой мыши. #PB_EventType_RightDoubleClick : Пользователь сделал двойной клик на элементе правой кнопкой мыши. #PB_EventType_DragStart : Пользователь попытался начать перетаскивание (Drag & Drop).
После события #PB_EventType_DragStart библиотека Drag & Drop может использоваться для запуска операции Drag & Drop (Перетаскивание мышью).

Пример

If OpenWindow(0, 0, 0, 300, 300, "Гаджет Дерево Проводника", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
ExplorerTreeGadget(0, 10, 10, 280, 280, "*.pb;*.pbi")
Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf

См. также

GetGadgetText(), SetGadgetText(), GetGadgetState(), GetGadgetColor(), SetGadgetColor(), ExplorerComboGadget(), ExplorerListGadget(), TreeGadget()

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

Все

<- ExplorerListGadget() - Оглавление Gadget - FrameGadget()->

��dv�

#Gadget	Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового Гаджета.
Directory$	Имя, изначально выбранного каталога. Это имя может включать одну или несколько масок, например "C:\.pb;.pbi". Если масок нет, имя каталога должно заканчиваться символом '\'. Отсутствие имени каталога приведёт к отображению корневого перечня дисков. Отсутствие масок понимается как маска по умолчанию '.'. Так что параметр Directory$ со значением "" отобразит корневой перечень дисков и установит маску '.'.
Flags (дополн.)	Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): #PB_Explorer_BorderLess : Создать Гаджет без границ. #PB_Explorer_AlwaysShowSelection : Выделение отображается даже если Гаджет не активирован. #PB_Explorer_NoLines : Скрыть линии, соединяющие узлы дерева. #PB_Explorer_NoButtons : Скрыть кнопки разворачивания узлов в виде символов '+'. #PB_Explorer_NoFiles : Не показывать файлы. #PB_Explorer_NoDriveRequester : Не показывать запрос 'пожалуйста, вставьте диск X:'. #PB_Explorer_NoMyDocuments : Не показывать каталог 'Мои документы' в виде отдельного элемента. #PB_Explorer_AutoSort : Содержимое автоматически упорядочивается по имени.