Начинает операцию перетаскивания. |
Краткое описание
int dragStart(string information[, string pixmap =»»[, int dragType = DRAG_COPY[, string mimeType = «text/plain»]]); |
Параметры
Параметр | Описание |
information | Предоставляемая информация. В настоящее время информация должна быть строкового типа данных (это означает: только ТЕКСТ). В противном случае функция возвращает значение -1, и выводится сообщение об ошибке. |
pixmap | Изображение, которое отображается во время перетаскивания возле курсора. Пустая строка использует изображение по умолчанию в операционной системе. Переданное имя файла должно указываться относительно каталога изображений <путь_проекта>/pictures. Если заданное имя файла не имеет расширения, будет проверено несколько вариантов, например, .png, .xpm, .bmp. Из документации Qt: При реализации для конкретной платформы это будет использоваться где возможно. Поэтому, следует обеспечить небольшое пиксельное изображение с маской, не предполагая, что пользователь на самом деле его увидит. Предупреждение: Могут возникнуть проблемы с курсорами перетаскивания на различных графических аппаратных средствах и программном обеспечении драйверов в Windows. Снижение ускорения графики в настройках дисплея решит проблемы. |
dragType | «dragType» является одной из следующих постоянных CTRL, которые определяют, какую операцию объект перетаскивания хочет реализовать: DRAG_COPY — копирует информацию перетаскиваемого объекта DRAG_MOVE — перемещает информацию перетаскиваемого объекта DRAG_LINK — создает ссылку на информацию перетаскиваемого объекта |
mimeType | «mimeType» определяет тип перетаскиваемой информации. Поскольку в настоящее время поддерживаются только текстовые значения, можно использовать только mimeType, который начинается с «text/», например, «text/plain», «text/html» и т.д. Для получения информации по зарегистрированным типам MIME «text/» см. http://www.iana.org/assignments/media-types/text/. |
hotSpot X | Горячая точка X является растровым изображением, которое отображается во время перетаскивания возле курсора. При использовании параметров hotspot X и hotspot Y изображение может быть показано в середине курсора. Горячая точка относится к верхнему левому углу растрового изображения. Если размер изображения составляет, например, 40×60 пикселей, при задании параметров 20 и 30 изображение отображается в центре курсора. Горячая точка X и горячая точка Y могут использоваться только вместе. |
hotSopot Y | Горячая точка Y является растровым изображением, которое отображается во время перетаскивания возле курсора. При использовании параметров hotspot X и hotspot Y изображение может быть показано в середине курсора. Горячая точка относится к верхнему левому углу растрового изображения. Если размер изображения составляет, например, 40×60 пикселей, при задании параметров 20 и 30 изображение отображается в центре курсора. Горячая точка X и горячая точка Y могут использоваться только вместе. |
Возвращаемое значение
-1 в случае ошибки. В противном случае 0. |
Описание
Начинает операцию перетаскивания. ПРИМЕЧАНИЕ Если атрибутом «Draggable» является TRUE, но пользователь не реализовал ничего в сценарии DragStart, операция перетаскивания не начнется. ПРИМЕЧАНИЕ Графические объекты внутри панели-ссылки являются исключением: если они не используют функцию dragStart() в сценарии, то их $-параметры являются перетаскиваемой по умолчанию информацией. $-параметры передаются в формате $name:value\n$name:value и т.д.. Пример: $DPE:Motor1.runs $color:green |
ПРИМЕР Примеры использования этой функции см. в главе Пример перетаскивания. |
Используется для объекта
Доступность
Интерфейс пользователя |
См. также