ExplorerComboGadget

ExplorerComboGadget()

Синтаксис

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

Описание

Создаёт Гаджет "Комбо-Проводник" (Explorer Combo Gadget), позволяющий Вам отображать путь к текущему каталогу и все его родительские каталоги, так что пользователь может выбрать любой из них. Вы можете найти такой ComboBox, например, в функции OpenFileRequester().

Параметры

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

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

Directory$ Имя, включая полный путь, изначально отображаемого текущего каталога , пустая строка указывает на корневой каталог.

Если установлен флаг #PB_Explorer_DrivesOnly, значением Directory$ может быть только буква диска. Все, что следует за буквой диска в этом случае, будет проигнорировано.
Flags (дополн.)
Флаги, позволяющие изменить поведение Гаджета. Это может быть комбинацией следующих значений:
  #PB_Explorer_DrivesOnly   : Гаджет будет отображать только диски, которые вы можете выбрать.
  #PB_Explorer_Editable     : Гаджет будет доступен для редактирования с функцией автозаполнения.
                   С этим флагом он действует точно так же, как тот что в Windows Explorer.
  #PB_Explorer_NoMyDocuments: Папка "Мои документы" не будет отображаться как отдельный элемент.

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

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

Комментарии

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

- GetGadgetText(): Возвращает полный путь и имя каталога или диска, который в данный момент выбран текущим. Эту функцию можно использовать, чтобы узнать выбор пользователя, после получения события для этого Гаджета.
- SetGadgetText(): Указывает полный путь и имя каталога, который будет отображён на экране в качестве текущего.

Пример

If OpenWindow(0, 0, 0, 400, 45, "Гаджет Комбо-Проводник", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
ExplorerComboGadget(0, 10, 10, 380, 25, GetHomeDirectory(), #PB_Explorer_Editable)
Repeat
Event = WaitWindowEvent()
Until Event = #PB_Event_CloseWindow
EndIf

См. также

GetGadgetText(), SetGadgetText(), ExplorerListGadget(), ExplorerTreeGadget(), ComboBoxGadget()

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

Все

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

#Gadget	Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового Гаджета.
Directory$	Имя, включая полный путь, изначально отображаемого текущего каталога , пустая строка указывает на корневой каталог. Если установлен флаг #PB_Explorer_DrivesOnly, значением Directory$ может быть только буква диска. Все, что следует за буквой диска в этом случае, будет проигнорировано.
Flags (дополн.)	Флаги, позволяющие изменить поведение Гаджета. Это может быть комбинацией следующих значений: #PB_Explorer_DrivesOnly : Гаджет будет отображать только диски, которые вы можете выбрать. #PB_Explorer_Editable : Гаджет будет доступен для редактирования с функцией автозаполнения. С этим флагом он действует точно так же, как тот что в Windows Explorer. #PB_Explorer_NoMyDocuments: Папка "Мои документы" не будет отображаться как отдельный элемент.