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`에 명시되어 있습니다. 기본 제안 동작은 허용된 동작 중에서 ‘이동(Move)’, ‘복사(Copy)’, ‘링크(Link)’ 순서로 선택됩니다.

참고: 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 에서 네이티브 커서 사용으로 되돌리려면 cursor 로 null QPixmap 을 전달하십시오.

참고: 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()도 참조하십시오 .