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 × 32 のカーソルの使用を推奨します。一部のプラットフォームでは、16 × 16、48 × 48、および 64 × 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 を割り当て、このカーソルへの参照を返します。