QClipboard Class

멤버 함수 문서

[signal] void QClipboard::changed(QClipboard::Mode mode)

이 신호는 지정된 클립보드 mode 의 데이터가 변경될 때 발생합니다.

dataChanged(), selectionChanged() 및 findBufferChanged()도 참조하세요 .

void QClipboard::clear(QClipboard::Mode mode = Clipboard)

클립보드 내용을 지웁니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 이 함수는 전역 클립보드 콘텐츠를 지웁니다. mode 이 QClipboard::Selection 인 경우 이 함수는 전역 마우스 선택 내용을 지웁니다. mode 이 QClipboard::FindBuffer 인 경우 이 함수는 검색 문자열 버퍼를 지웁니다.

QClipboard::Mode 및 supportsSelection()도 참조하십시오 .

[signal] void QClipboard::dataChanged()

이 신호는 클립보드 데이터가 변경될 때 발생합니다.

macOS 및 Qt 버전 4.3 이상에서는 애플리케이션이 활성화된 경우에만 다른 애플리케이션에 의한 클립보드 변경이 감지됩니다.

findBufferChanged(), selectionChanged() 및 changed()도 참조하세요 .

[signal] void QClipboard::findBufferChanged()

이 신호는 찾기 버퍼가 변경될 때 발생합니다. 이 신호는 macOS에만 적용됩니다.

Qt 버전 4.3 이상에서는 애플리케이션이 활성화된 경우에만 다른 애플리케이션에 의한 클립보드 변경이 감지됩니다.

dataChanged(), selectionChanged() 및 changed()도 참조하세요 .

QImage QClipboard::image(QClipboard::Mode mode = Clipboard) const

클립보드 이미지를 반환하거나 클립보드에 이미지가 없거나 지원되지 않는 이미지 형식의 이미지가 포함된 경우 null 이미지를 반환합니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 이미지가 전역 클립보드에서 검색됩니다. mode 이 QClipboard::Selection 인 경우 이미지가 전역 마우스 선택 영역에서 검색됩니다.

setImage(), pixmap(), mimeData() 및 QImage::isNull()도 참조하세요 .

const QMimeData *QClipboard::mimeData(QClipboard::Mode mode = Clipboard) const

현재 클립보드 데이터의 QMimeData 표현에 대한 포인터를 반환합니다(지정된 mode 이 플랫폼에서 지원되지 않는 경우 nullptr 일 수 있음).

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 데이터가 전역 클립보드에서 검색됩니다. mode 이 QClipboard::Selection 인 경우 전역 마우스 선택에서 데이터가 검색됩니다. mode 이 QClipboard::FindBuffer 인 경우 검색 문자열 버퍼에서 데이터가 검색됩니다.

text(), image() 및 pixmap() 함수는 텍스트, 이미지 및 픽스맵 데이터를 검색하기 위한 간단한 래퍼입니다.

setMimeData()도 참조하세요 .

bool QClipboard::ownsClipboard() const

이 클립보드 객체가 클립보드 데이터를 소유하고 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QClipboard::ownsFindBuffer() const

이 클립보드 개체가 찾기 버퍼 데이터를 소유하고 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QClipboard::ownsSelection() const

이 클립보드 개체가 마우스 선택 데이터를 소유하고 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

QPixmap QClipboard::pixmap(QClipboard::Mode mode = Clipboard) const

클립보드 픽셀맵을 반환하거나 클립보드에 픽셀맵이 없는 경우 null을 반환합니다. 이 경우 정보가 손실될 수 있습니다. 예를 들어 이미지가 24비트이고 디스플레이가 8비트인 경우 결과는 8비트로 변환되고 이미지에 알파 채널이 있는 경우 결과에는 마스크만 있습니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 전역 클립보드에서 픽셀맵이 검색됩니다. mode 이 QClipboard::Selection 인 경우 전역 마우스 선택에서 픽셀맵이 검색됩니다.

setPixmap(), image(), mimeData() 및 QPixmap::convertFromImage()도 참조하세요 .

[signal] void QClipboard::selectionChanged()

이 신호는 선택 항목이 변경될 때 방출됩니다. 이는 선택 항목을 지원하는 창 시스템(예: X11)에만 적용됩니다. Windows 및 macOS는 선택 기능을 지원하지 않습니다.

dataChanged(), findBufferChanged() 및 changed()도 참조하세요 .

void QClipboard::setImage(const QImage &image, QClipboard::Mode mode = Clipboard)

image 을 클립보드에 복사합니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 이미지가 전역 클립보드에 저장됩니다. mode 이 QClipboard::Selection 인 경우 데이터가 전역 마우스 선택 영역에 저장됩니다.

이것은 속기입니다:

QMimeData *data = new QMimeData;
data->setImageData(image);
clipboard->setMimeData(data, mode);

image(), setPixmap() 및 setMimeData()도 참조하세요 .

void QClipboard::setMimeData(QMimeData *src, QClipboard::Mode mode = Clipboard)

클립보드 데이터를 src 로 설정합니다. 데이터의 소유권이 클립보드로 이전됩니다. 데이터를 제거하려면 clear()를 호출하거나 새 데이터로 setMimeData()를 다시 호출하세요.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 데이터가 전역 클립보드에 저장됩니다. mode 가 QClipboard::Selection 인 경우 데이터는 전역 마우스 선택 영역에 저장됩니다. mode 이 QClipboard::FindBuffer 인 경우 데이터는 검색 문자열 버퍼에 저장됩니다.

setText(), setImage() 및 setPixmap() 함수는 각각 텍스트, 이미지 및 픽셀맵 데이터를 설정하기 위한 간단한 래퍼입니다.

mimeData()도 참조하세요 .

void QClipboard::setPixmap(const QPixmap &pixmap, QClipboard::Mode mode = Clipboard)

pixmap 을 클립보드에 복사합니다. setImage ()보다 속도가 느린 이유는 QPixmap 을 QImage 으로 먼저 변환해야 하기 때문입니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 픽셀맵이 전역 클립보드에 저장됩니다. mode 이 QClipboard::Selection 인 경우 픽셀맵은 전역 마우스 선택 영역에 저장됩니다.

pixmap(), setImage() 및 setMimeData()도 참조하세요 .

void QClipboard::setText(const QString &text, QClipboard::Mode mode = Clipboard)

text 을 일반 텍스트로 클립보드에 복사합니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 텍스트는 전역 클립보드에 저장됩니다. mode 이 QClipboard::Selection 인 경우 텍스트는 전역 마우스 선택 영역에 저장됩니다. mode 이 QClipboard::FindBuffer 인 경우 텍스트가 검색 문자열 버퍼에 저장됩니다.

text() 및 setMimeData()도 참조하십시오 .

bool QClipboard::supportsFindBuffer() const

클립보드가 별도의 검색 버퍼를 지원하는 경우 true 를 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QClipboard::supportsSelection() const

클립보드가 마우스 선택을 지원하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

QString QClipboard::text(QClipboard::Mode mode = Clipboard) const

클립보드 텍스트를 일반 텍스트로 반환하거나 클립보드에 텍스트가 없는 경우 빈 문자열을 반환합니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 전역 클립보드에서 텍스트가 검색됩니다. mode 가 QClipboard::Selection 인 경우 텍스트는 전역 마우스 선택 영역에서 검색됩니다. mode 가 QClipboard::FindBuffer 인 경우 검색 문자열 버퍼에서 텍스트가 검색됩니다.

setText() 및 mimeData()도 참조하십시오 .

QString QClipboard::text(QString &subtype, QClipboard::Mode mode = Clipboard) const

이 함수는 오버로드된 함수입니다.

하위 유형 subtype 의 클립보드 텍스트를 반환하거나 클립보드에 텍스트가 없는 경우 빈 문자열을 반환합니다. subtype 이 null이면 모든 하위 유형을 사용할 수 있으며 subtype 은 선택한 하위 유형으로 설정됩니다.

mode 인수는 시스템 클립보드의 어느 부분을 사용할지 제어하는 데 사용됩니다. mode 가 QClipboard::Clipboard 인 경우 텍스트는 전역 클립보드에서 검색됩니다. mode 이 QClipboard::Selection 인 경우 전역 마우스 선택에서 텍스트가 검색됩니다.

subtype 의 일반적인 값은 "plain" 및 "html"입니다.

키 이벤트 핸들러 등에서 이 함수를 반복적으로 호출하면 속도가 느려질 수 있습니다. 이러한 경우에는 dataChanged() 신호를 대신 사용해야 합니다.

setText() 및 mimeData()도 참조하세요 .