QDrag Class

        QDrag *drag = new QDrag(this);
        QMimeData *mimeData = new QMimeData;

        mimeData->setText(commentEdit->toPlainText());
        drag->setMimeData(mimeData);

    drag->setHotSpot(QPoint(drag->pixmap().width()/2,
                            drag->pixmap().height()));

멤버 함수 문서

[explicit] QDrag::QDrag(QObject *dragSource)

dragSource 에 지정된 위젯에 대한 새 드래그 객체를 생성합니다.

[virtual noexcept] QDrag::~QDrag()

드래그 개체를 파괴합니다.

[signal] void QDrag::actionChanged(Qt::DropAction action)

이 신호는 드래그와 연결된 action 이 변경될 때 발생합니다.

targetChanged()도 참조하세요 .

[static] void QDrag::cancel()

Qt에 의해 시작된 드래그 연산을 취소합니다.

exec()도 참조하세요 .

Qt::DropAction QDrag::defaultAction() const

이 드래그 작업에 대해 제안된 기본 드롭 동작을 반환합니다.

exec() 및 supportedActions()도 참조하세요 .

QPixmap QDrag::dragCursor(Qt::DropAction action) const

action 에 대한 드래그 커서를 반환합니다.

setDragCursor()도 참조하세요 .

Qt::DropAction QDrag::exec(Qt::DropActions supportedActions = Qt::MoveAction)

끌어서 놓기 작업을 시작하고 완료되면 요청된 끌어서 놓기 동작을 나타내는 값을 반환합니다. 사용자가 선택할 수 있는 끌어서 놓기 동작은 supportedActions 에 지정되어 있습니다. 기본 제안 동작은 허용된 동작 중에서 다음 순서로 선택됩니다: 이동, 복사, 링크.

참고: Linux 및 macOS에서는 끌어서 놓기 작업에 다소 시간이 걸릴 수 있지만 이 기능이 이벤트 루프를 차단하지는 않습니다. 작업이 수행되는 동안 다른 이벤트는 여전히 애플리케이션에 전달됩니다. Windows에서는 작업 중에 Qt 이벤트 루프가 차단됩니다.

cancel()도 참조하세요 .

Qt::DropAction QDrag::exec(Qt::DropActions supportedActions, Qt::DropAction defaultDropAction)

끌어서 놓기 작업을 시작하고 완료되면 요청된 끌어서 놓기 동작을 나타내는 값을 반환합니다. 사용자가 선택할 수 있는 끌어서 놓기 동작은 supportedActions 에 지정되어 있습니다.

defaultDropAction 은 사용자가 수정자 키를 사용하지 않고 끌기를 수행할 때 어떤 동작이 제안될지 결정합니다.

참고: Linux 및 macOS에서는 끌어서 놓기 작업에 다소 시간이 걸릴 수 있지만 이 기능이 이벤트 루프를 차단하지는 않습니다. 작업이 수행되는 동안 다른 이벤트는 여전히 애플리케이션에 전달됩니다. Windows에서는 작업 중에 Qt 이벤트 루프가 차단됩니다. 그러나 Windows에서 QDrag::exec()는 GUI의 응답성을 유지하기 위해 processEvents()가 자주 호출되도록 합니다. 드래그 작업이 활성화되어 있는 동안 루프나 작업이 호출되면 드래그 작업이 차단됩니다.

QPoint QDrag::hotSpot() const

커서의 왼쪽 상단 모서리를 기준으로 핫스팟의 위치를 반환합니다.

setHotSpot()도 참조하세요 .

QMimeData *QDrag::mimeData() const

드래그 객체에 의해 캡슐화된 MIME 데이터를 반환합니다.

setMimeData()도 참조하세요 .

QPixmap QDrag::pixmap() const

끌어서 놓기 작업에서 데이터를 표현하는 데 사용되는 픽셀맵을 반환합니다.

setPixmap()도 참조하세요 .

void QDrag::setDragCursor(const QPixmap &cursor, Qt::DropAction action)

action 에 대해 드래그 cursor 를 설정합니다. 이렇게 하면 기본 네이티브 커서를 재정의할 수 있습니다. action 에 대한 기본 커서 사용으로 되돌리려면 QPixmap 을 cursor 으로 null을 전달합니다.

참고: IgnoreAction에 대한 드래그 커서 설정은 모든 플랫폼에서 작동하지 않을 수 있습니다. X11 및 macOS에서 작동하는 것으로 테스트되었습니다. Windows에서는 지원되지 않습니다.

dragCursor()도 참조하세요 .

void QDrag::setHotSpot(const QPoint &hotspot)

hotspot 에 지정된 지점에 사용되는 픽셀맵의 왼쪽 상단 모서리를 기준으로 핫스팟의 위치를 설정합니다.

참고: X11에서는 핫스팟으로 인해 커서 바로 아래에 픽셀맵이 표시되는 경우 픽셀맵이 마우스 움직임을 따라잡지 못할 수 있습니다.

hotSpot()도 참조하세요 .

void QDrag::setMimeData(QMimeData *data)

지정된 MIME data 으로 전송할 데이터를 설정합니다. 데이터의 소유권은 QDrag 객체로 전송됩니다.

mimeData()도 참조하세요 .

void QDrag::setPixmap(const QPixmap &pixmap)

드래그 앤 드롭 작업에서 데이터를 표현하는 데 사용되는 픽스맵으로 pixmap 을 설정합니다. 드래그가 시작되기 전에만 픽스맵을 설정할 수 있습니다.

pixmap()도 참조하세요 .

QObject *QDrag::source() const

끌기 개체의 소스를 반환합니다. 끌어서 놓기 작업이 시작된 위젯입니다.

Qt::DropActions QDrag::supportedActions() const

이 드래그 작업에 대해 가능한 드롭 동작 집합을 반환합니다.

exec() 및 defaultAction()도 참조하세요 .

QObject *QDrag::target() const

끌어서 놓기 작업의 대상을 반환합니다. 끌어서 놓기 개체가 놓인 위젯입니다.

[signal] void QDrag::targetChanged(QObject *newTarget)

이 신호는 끌어서 놓기 작업의 대상이 변경될 때 발생하며 newTarget 이 새 대상이 됩니다.

target() 및 actionChanged()도 참조하세요 .