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

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

setMimeData()도 참조하십시오 .

bool QClipboard::ownsClipboard() const

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

bool QClipboard::ownsFindBuffer() const

이 클립보드 객체가 ‘find’ 버퍼 데이터를 소유하고 있으면 ` 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 를 클립보드에 복사합니다. 이 함수는 QPixmap 을 먼저 QImage 로 변환해야 하므로, setImage()보다 처리 속도가 느리다는 점에 유의하십시오.

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