QCursor Class

멤버 함수 설명서

QCursor::QCursor()

기본 화살표 모양을 가진 커서를 생성합니다.

QCursor::QCursor(Qt::CursorShape shape)

지정된 형상( shape)을 사용하여 커서를 생성합니다.

도형 목록은 ` Qt::CursorShape `을 참조하십시오.

setShape()도 참조하십시오 .

[explicit] QCursor::QCursor(const QPixmap &pixmap, int hotX = -1, int hotY = -1)

사용자 정의 픽스맵 커서를 생성합니다.

pixmap 는 이미지입니다. 일반적으로 이 이미지에 마스크를 지정합니다( QPixmap::setMask()를 사용하여 설정). hotX 및 hotY 는 커서의 핫스팟을 정의합니다.

hotX 가 음수인 경우, pixmap().width()/2 로 설정됩니다. hotY 가 음수인 경우, pixmap().height()/2 로 설정됩니다.

유효한 커서 크기는 디스플레이 하드웨어(또는 기본 윈도우 시스템)에 따라 다릅니다. 32 x 32 커서는 모든 플랫폼에서 지원되므로 이 크기를 사용하는 것이 좋습니다. 일부 플랫폼에서는 16 x 16, 48 x 48 및 64 x 64 커서도 지원합니다.

QPixmap::QPixmap() 및 QPixmap::setMask()도 참조하십시오 .

QCursor::QCursor(const QBitmap &bitmap, const QBitmap &mask, int hotX = -1, int hotY = -1)

사용자 정의 비트맵 커서를 생성합니다.

bitmap mask 가 비트맵을 구성합니다. 와 는 커서의 핫스팟을 정의합니다. hotX hotY

hotX 가 음수인 경우, bitmap().width()/2 로 설정됩니다. hotY 가 음수인 경우, bitmap().height()/2 로 설정됩니다.

커서의 bitmap (B) 비트와 mask (M) 비트는 다음과 같이 결합됩니다:

• B=1이고 M=1이면 검은색이 됩니다.
• B=0이고 M=1일 때 흰색이 됩니다.
• B=0이고 M=0일 때는 투명합니다.
• B=1이고 M=0인 경우, Windows에서는 XOR 연산 결과가 나오지만, 그 외 모든 플랫폼에서는 정의되지 않은 결과가 나타납니다.

비트맵에서 0픽셀을 그리려면 전역 Qt 색상 Qt::color0 를 사용하고, 1픽셀을 그리려면 Qt::color1 를 사용하십시오.

유효한 커서 크기는 디스플레이 하드웨어(또는 기본 윈도우 시스템)에 따라 다릅니다. 이 크기는 모든 플랫폼에서 지원되므로 32 x 32 커서를 사용하는 것이 좋습니다. 일부 플랫폼에서는 16 x 16, 48 x 48 및 64 x 64 커서도 지원합니다.

QBitmap::QBitmap() 및 QBitmap::setMask()도 참조하십시오 .

QCursor::QCursor(const QCursor &c)

c 의 복사본을 생성합니다.

[noexcept] QCursor::QCursor(QCursor &&other)

other 에서 커서를 이동 생성합니다. 이동된 후에는 other 에 대해 유효한 연산은 소멸과 (이동 및 복사) 할당뿐입니다. 이동된 인스턴스에 대해 다른 멤버 함수를 호출할 경우 그 결과는 정의되지 않습니다.

[noexcept] QCursor::~QCursor()

커서를 제거합니다.

QBitmap QCursor::bitmap() const

커서 비트맵을 반환하거나, 표준 커서 중 하나인 경우 null 비트맵을 반환합니다.

QPoint QCursor::hotSpot() const

커서의 핫스팟을 반환하며, 표준 커서 중 하나인 경우에는 (0, 0)을 반환합니다.

QBitmap QCursor::mask() const

커서 비트맵 마스크를 반환하거나, 표준 커서 중 하나인 경우 null 비트맵을 반환합니다.

QPixmap QCursor::pixmap() const

커서 픽스맵을 반환합니다. 이 함수는 커서가 픽스맵 커서인 경우에만 유효합니다.

[static] QPoint QCursor::pos()

주 화면의 커서(핫스팟) 위치를 전역 화면 좌표계로 반환합니다.

QWidget::mapFromGlobal()를 호출하여 위젯 좌표계로 변환할 수 있습니다.

setPos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal(), QGuiApplication::primaryScreen()도 참조하십시오 .

[static] QPoint QCursor::pos(const QScreen *screen)

screen 의 커서(핫스팟) 위치를 전역 화면 좌표계로 반환합니다.

QWidget::mapFromGlobal()를 호출하여 위젯 좌표계로 변환할 수 있습니다.

setPos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal()도 참조하십시오 .

[static] void QCursor::setPos(int x, int y)

주 화면의 커서(핫스팟)를 전체 화면 좌표계(x, y)로 이동합니다.

QWidget::mapToGlobal()를 호출하여 위젯 좌표를 전역 화면 좌표로 변환할 수 있습니다.

pos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal() 및 QGuiApplication::primaryScreen()도 참조하십시오 .

[static] void QCursor::setPos(QScreen *screen, int x, int y)

screen 의 커서(핫스팟)를 전체 화면 좌표계(x, y)로 이동합니다.

QWidget::mapToGlobal()를 호출하여 위젯 좌표를 전역 화면 좌표로 변환할 수 있습니다.

pos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal()도 참조하십시오 .

[static] void QCursor::setPos(const QPoint &p)

커서(핫스팟)를 전역 화면상의 p 지점으로 이동합니다.

[static] void QCursor::setPos(QScreen *screen, const QPoint &p)

커서(핫스팟)를 p 지점에 있는 screen 의 전역 화면 위치로 이동합니다.

void QCursor::setShape(Qt::CursorShape shape)

shape 로 지정된 모양으로 커서를 설정합니다.

커서 모양 목록에 대해서는 Qt::CursorShape 를 참조하십시오.

shape()도 참조하십시오 .

Qt::CursorShape QCursor::shape() const

커서 모양 식별자를 반환합니다.

setShape()도 참조하십시오 .

[noexcept] void QCursor::swap(QCursor &other)

이 커서를 other 로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QCursor::operator QVariant() const

커서를 ` QVariant` 형식으로 반환합니다.

[noexcept] QCursor &QCursor::operator=(QCursor &&other)

other 를 이 QCursor 인스턴스에 이동-할당합니다.

QCursor &QCursor::operator=(const QCursor &c)

이 커서에 ` c `를 할당하고, 이 커서에 대한 참조를 반환합니다.