EnableGadgetDrop

EnableGadgetDrop()

Синтаксис

EnableGadgetDrop(#Gadget , Format , Actions [, PrivateType])

Описание

Активирует Гаджет в качестве цели для операций Drag & Drop (Перетаскивание мышью) определенного формата. Когда пользователь перетаскивает данные этого формата над Гаджетом, курсор будет показывать, что здесь данные можно отпустить.

Параметры

#Gadget Это внутренний (для PureBasic) Номер активируемого Гаджета.
Format
Задаёт формат данных , который может быть одним из следующих значений или OS-специфичный ID для произвольного формата (больше информации смотрите в описании функции DragOSFormats()).
  #PB_Drop_Text   : Приём текста этим Гаджетом.
  #PB_Drop_Image  : Приём изображений этим Гаджетом.
  #PB_Drop_Files  : Приём имён файлов этим Гаджетом.
  #PB_Drop_Private: Приём "внутренних" Drag & Drop этим Гаджетом. 
Actions
Комбинация действий Drag & Drop, которые разрешены для данных. Пользователь может выбрать, какое из этих действий выполнить, нажав клавиши-модификаторы вроде Ctrl или Shift. Какие действия будут выполнены, зависит также от того, что разрешено принимающей стороной перетаскивания. Возможные действия: (их можно сочетать с помощью оператора '|')
  #PB_Drag_None: Формат данных не будет принят Гаджетом.
  #PB_Drag_Copy: Данные могут быть скопированы.
  #PB_Drag_Move: Данные могут быть перемещены.
  #PB_Drag_Link: На Данные можно сделать ссылки.
PrivateType (дополн.) Задаёт тип внутреннего Drag & Drop для приёма, только если задан формат #PB_Drop_Private. Дополнительную информацию смотрите в описании функции DragPrivate(). Этот параметр игнорируется для других форматов.

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

Ничего.

Комментарии

Можно разрешить несколько форматов для одного Гаджета. Если отправляющая сторона предоставляет несколько форматов, попавших в список разрешённых, будет принят тот, что был добавлен последним. Поэтому предпочтительный для приёма данных формат следует включать последним.

Если данные были отпущены над Гаджетом, программа получит событие #PB_Event_GadgetDrop. Функция EventGadget() укажет принимающий Гаджет, а для получения перетащенных данных можно использовать функции событий (начинающиеся с Event) этой библиотеки.

См. также

EnableWindowDrop(), EventDropType(), EventDropAction(), SetDropCallback()

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

Все

<- DragText() - Оглавление DragDrop - EnableWindowDrop()->

#Gadget	Это внутренний (для PureBasic) Номер активируемого Гаджета.
Format	Задаёт формат данных , который может быть одним из следующих значений или OS-специфичный ID для произвольного формата (больше информации смотрите в описании функции DragOSFormats()). #PB_Drop_Text : Приём текста этим Гаджетом. #PB_Drop_Image : Приём изображений этим Гаджетом. #PB_Drop_Files : Приём имён файлов этим Гаджетом. #PB_Drop_Private: Приём "внутренних" Drag & Drop этим Гаджетом.
Actions	Комбинация действий Drag & Drop, которые разрешены для данных. Пользователь может выбрать, какое из этих действий выполнить, нажав клавиши-модификаторы вроде Ctrl или Shift. Какие действия будут выполнены, зависит также от того, что разрешено принимающей стороной перетаскивания. Возможные действия: (их можно сочетать с помощью оператора '\|') #PB_Drag_None: Формат данных не будет принят Гаджетом. #PB_Drag_Copy: Данные могут быть скопированы. #PB_Drag_Move: Данные могут быть перемещены. #PB_Drag_Link: На Данные можно сделать ссылки.
PrivateType (дополн.)	Задаёт тип внутреннего Drag & Drop для приёма, только если задан формат #PB_Drop_Private. Дополнительную информацию смотрите в описании функции DragPrivate(). Этот параметр игнорируется для других форматов.