QCursor Class

Documentation sur les fonctions membres

QCursor::QCursor()

Crée un curseur avec la forme de flèche par défaut.

QCursor::QCursor(Qt::CursorShape shape)

Crée un curseur avec l'shape spécifiée.

Voir Qt::CursorShape pour obtenir la liste des formes.

Voir également setShape().

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

Crée un curseur pixmap personnalisé.

pixmap est l'image. On lui attribue généralement un masque (défini à l'aide de ` QPixmap::setMask()`). ` hotX ` et ` hotY ` définissent la zone active du curseur.

Si hotX est négatif, il est défini sur pixmap().width()/2. Si hotY est négatif, il est défini sur pixmap().height()/2.

Les tailles de curseur valides dépendent du matériel d'affichage (ou du système de fenêtrage sous-jacent). Nous recommandons d'utiliser des curseurs de 32 x 32, car cette taille est prise en charge sur toutes les plateformes. Certaines plateformes prennent également en charge les curseurs de 16 x 16, 48 x 48 et 64 x 64.

Voir également QPixmap::QPixmap() et QPixmap::setMask().

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

Crée un curseur bitmap personnalisé.

bitmap et mask constituent le bitmap. hotX et hotY définissent la zone sensible du curseur.

Si hotX est négatif, il est défini sur bitmap().width()/2. Si hotY est négatif, il est défini sur bitmap().height()/2.

Les bits d’ bitmap (B) et de mask (M) du curseur sont combinés comme suit :

• B=1 et M=1 donnent du noir.
• B = 0 et M = 1 donne du blanc.
• B = 0 et M = 0 donne la transparence.
• B=1 et M=0 donne un résultat XOR sous Windows, des résultats indéfinis sur toutes les autres plateformes.

Utilisez l’ Qt::color0 de couleur globale Qt pour dessiner des pixels de 0 et Qt::color1 pour dessiner des pixels de 1 dans les images bitmap.

Les tailles de curseur valides dépendent du matériel d'affichage (ou du système de fenêtrage sous-jacent). Nous recommandons d'utiliser des curseurs de 32 x 32, car cette taille est prise en charge sur toutes les plateformes. Certaines plateformes prennent également en charge les curseurs de 16 x 16, 48 x 48 et 64 x 64.

Voir également QBitmap::QBitmap() et QBitmap::setMask().

QCursor::QCursor(const QCursor &c)

Crée une copie du curseur c.

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

Crée un curseur à partir de ` other`. Une fois le curseur déplacé, les seules opérations valides sur ` other ` sont la destruction et l'affectation (par déplacement ou par copie). Les effets de l'appel de toute autre fonction membre sur une instance à partir de laquelle le curseur a été déplacé sont indéfinis.

[noexcept] QCursor::~QCursor()

Supprime le curseur.

QBitmap QCursor::bitmap() const

Renvoie l'image bitmap du curseur, ou une image bitmap nulle s'il s'agit d'un des curseurs standard.

QPoint QCursor::hotSpot() const

Renvoie la position du curseur, ou (0, 0) s'il s'agit d'un des curseurs standard.

QBitmap QCursor::mask() const

Renvoie le masque bitmap du curseur, ou un bitmap nul s'il s'agit d'un des curseurs standard.

QPixmap QCursor::pixmap() const

Renvoie l'image du curseur. Cette fonction n'est valable que si le curseur est un curseur de type « pixmap ».

[static] QPoint QCursor::pos()

Renvoie la position du curseur (point actif) de l'écran principal en coordonnées globales de l'écran.

Vous pouvez appeler la fonction ` QWidget::mapFromGlobal()` pour la convertir en coordonnées de widget.

Voir également setPos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal() et QGuiApplication::primaryScreen().

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

Renvoie la position du curseur (zone sensible) de l'screen, exprimée en coordonnées globales de l'écran.

Vous pouvez appeler la fonction ` QWidget::mapFromGlobal()` pour la convertir en coordonnées du widget.

Voir également ` setPos()`, ` QWidget::mapFromGlobal()` et ` QWidget::mapToGlobal()`.

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

Déplace le curseur (zone sensible) de l'écran principal vers la position globale à l'écran (x, y).

Vous pouvez appeler la fonction ` QWidget::mapToGlobal()` pour convertir les coordonnées d’un widget en coordonnées globales de l’écran.

Voir également pos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal() et QGuiApplication::primaryScreen().

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

Déplace le curseur (zone sensible) de l'screen vers la position globale à l'écran (x, y).

Vous pouvez appeler la fonction ` QWidget::mapToGlobal()` pour convertir les coordonnées du widget en coordonnées globales de l'écran.

Voir également pos(), QWidget::mapFromGlobal() et QWidget::mapToGlobal().

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

Déplace le curseur (zone interactive) vers la position globale à l'écran correspondant au point p.

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

Déplace le curseur (zone sensible) vers la position globale à l'écran de l'screen, au point p.

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

Définit le curseur sur la forme identifiée par shape.

Voir Qt::CursorShape pour la liste des formes de curseur.

Voir également shape().

Qt::CursorShape QCursor::shape() const

Renvoie l'identifiant de la forme du curseur.

Voir aussi setShape().

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

Permute ce curseur avec celui de other. Cette opération est très rapide et ne pose jamais de problème.

QCursor::operator QVariant() const

Renvoie le curseur sous la forme d'un objet de type ` QVariant`.

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

Cette opération attribue « other » à cette instance de « QCursor ».

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

Attribue la valeur « c » à ce curseur et renvoie une référence à ce curseur.