DragText()

Синтаксис

Result = DragText(Text$ [, Actions])

Описание

Начинает операцию Drag & Drop (Перетаскивание мышью) с текстовыми данными.

Параметры

Text$

Задаёт текст для перетаскивания.

Actions (дополн.)

Комбинация действий Drag & Drop, которые разрешены для данных. Если параметр не задан, единственным разрешённым действием будет то #PB_Drag_Copy. Возможные действия: (их можно сочетать с помощью оператора '|'), #PB_Drag_Copy: Можно копировать текст #PB_Drag_Move: Можно перемещать текст #PB_Drag_Link: Можно создать ссылку на текст Пользователь может выбрать, какое из этих действий выполнить, нажав клавиши-модификаторы вроде Ctrl или Shift. Какие действия будут выполнены, зависит также от того, что разрешено принимающей стороной перетаскивания. (В MacOSX действия считаются лишь предложениями. Принимающая сторона перетаскивания может выбрать другое действие.)

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

Возвращает одно из упомянутых выше значений действий Drag & Drop чтобы сообщить, какое действие выполнил пользователь, или значение #PB_Drag_None, если пользователь прервал выполнение операции Drag & Drop.

Обратите внимание на то, что если возвращено значение #PB_Drag_Move, то удалить перетащенные текстовые данные из вашего приложения должны вы.

Комментарии

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

См. также

DragFiles(), DragImage(), DragPrivate(), DragOSFormats(), SetDragCallback()

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

Windows, Linux