EnableWindowDrop

EnableWindowDrop()

Синтаксис

EnableWindowDrop(#Window , Format , Actions [, PrivateType])

Описание

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

Параметры

#Window Это внутренний (для 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) этой библиотеки.

См. также

EnableGadgetDrop(), EventDropType(), EventDropAction(), SetDropCallback()

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

Все

<- EnableGadgetDrop() - Оглавление DragDrop - EventDropAction()->

#Window	Это внутренний (для 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(). Этот параметр игнорируется для других форматов.