QRect Class

Documentation des fonctions membres

[constexpr noexcept] QRect::QRect()

Crée un rectangle nul.

Voir aussi ` isNull()`.

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)

Construit un rectangle dont les sommets sont définis par les coordonnées topLeft et bottomRight, ces deux points inclus.

Si bottomRight est situé plus haut et plus à gauche que topLeft, le rectangle défini n'inclut pas les coins.

Voir également setTopLeft(), setBottomRight() et span().

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QSize &size)

Construit un rectangle dont le coin est défini par topLeft et dont la longueur est définie par size.

Voir également setTopLeft() et setSize().

[constexpr noexcept] QRect::QRect(int x, int y, int width, int height)

Crée un rectangle dont le coin supérieur gauche est situé à l'adresse (x, y) et dont les dimensions sont width et height.

Voir aussi setRect().

[constexpr noexcept] void QRect::adjust(int dx1, int dy1, int dx2, int dy2)

Ajoute respectivement dx1, dy1, dx2 et dy2 aux coordonnées existantes du rectangle.

Voir également adjusted() et setRect().

[constexpr noexcept] QRect QRect::adjusted(int dx1, int dy1, int dx2, int dy2) const

Renvoie un nouveau rectangle auquel sont respectivement ajoutées les coordonnées dx1, dy1, dx2 et dy2 aux coordonnées existantes de ce rectangle.

Voir également adjust().

[constexpr noexcept] int QRect::bottom() const

Renvoie la coordonnée y du bord inférieur du rectangle.

Notez que, pour des raisons historiques, cette fonction renvoie top() + height() - 1 ; utilisez y() + height() pour récupérer la véritable coordonnée y.

Voir également setBottom(), bottomLeft() et bottomRight().

[constexpr noexcept] QPoint QRect::bottomLeft() const

Renvoie la position du coin inférieur gauche du rectangle. Notez que, pour des raisons historiques, cette fonction renvoie QPoint(left(), top() + height() - 1).

Voir également setBottomLeft(), bottom() et left().

[constexpr noexcept] QPoint QRect::bottomRight() const

Renvoie la position du coin inférieur droit du rectangle.

Notez que, pour des raisons historiques, cette fonction renvoie QPoint(left() + width() -1, top() + height() - 1).

Voir également setBottomRight(), bottom() et right().

[constexpr noexcept] QPoint QRect::center() const

Renvoie le point central du rectangle.

Voir également moveCenter().

[noexcept] bool QRect::contains(const QPoint &point, bool proper = false) const

Renvoie true si l'point donné se trouve à l'intérieur ou sur le bord du rectangle, sinon renvoie false. Si proper est vrai, cette fonction ne renvoie true que si l'point donné se trouve à l'intérieur du rectangle (c'est-à-dire pas sur le bord).

Voir également intersects().

[noexcept] bool QRect::contains(const QRect &rectangle, bool proper = false) const

Renvoie « true » si l'rectangle donné se trouve à l'intérieur de ce rectangle. Sinon, renvoie « false ». Si « proper » est vrai, cette fonction ne renvoie « true » que si l'rectangle se trouve entièrement à l'intérieur de ce rectangle (et non sur un bord).

[noexcept] bool QRect::contains(int x, int y) const

Renvoie « true » si le point (x, y) se trouve à l'intérieur de ce rectangle, sinon renvoie « false ».

[noexcept] bool QRect::contains(int x, int y, bool proper) const

Renvoie « true » si le point (x, y) se trouve à l'intérieur ou sur le bord du rectangle ; sinon, renvoie « false ». Si « proper » est vrai, cette fonction ne renvoie « true » que si le point se trouve entièrement à l'intérieur du rectangle (et non sur le bord).

[constexpr] void QRect::getCoords(int *x1, int *y1, int *x2, int *y2) const

Extrait la position du coin supérieur gauche du rectangle vers *x1 et *y1, et la position du coin inférieur droit vers *x2 et *y2.

Voir également setCoords() et getRect().

[constexpr] void QRect::getRect(int *x, int *y, int *width, int *height) const

Récupère la position du coin supérieur gauche du rectangle dans *x et *y, ainsi que ses dimensions dans *width et *height.

Voir également setRect() et getCoords().

[constexpr noexcept] int QRect::height() const

Renvoie la hauteur du rectangle.

Voir également setHeight(), width() et size().

[noexcept] QRect QRect::intersected(const QRect &rectangle) const

Renvoie l'intersection de ce rectangle et de l'rectangle donné. Notez que r.intersected(s) équivaut à r & s.

Voir également intersects(), united() et operator&=().

[noexcept] bool QRect::intersects(const QRect &rectangle) const

Renvoie « true » si ce rectangle recoupe le rectangle donné rectangle (c'est-à-dire s'il existe au moins un pixel situé à l'intérieur des deux rectangles), sinon renvoie « false ».

Le rectangle d’intersection peut être récupéré à l’aide de la fonction intersected().

Voir également contains().

[constexpr noexcept] bool QRect::isEmpty() const

Renvoie true si le rectangle est vide, sinon renvoie false.

Un rectangle vide présente une relation left() > right() ou top() > bottom(). Un rectangle vide n'est pas valide (c'est-à-dire isEmpty() == !isValid()).

Utilisez la fonction normalized() pour récupérer un rectangle dont les coins ont été permutés.

Voir également isNull(), isValid() et normalized().

[constexpr noexcept] bool QRect::isNull() const

Renvoie « true » si le rectangle est un rectangle nul ; sinon, renvoie « false ».

Un rectangle nul est un rectangle dont la largeur et la hauteur sont toutes deux définies sur 0 (c'est-à-dire que right() == left() - 1 et bottom() == top() - 1). Un rectangle nul est également vide et n'est donc pas valide.

Voir également isEmpty() et isValid().

[constexpr noexcept] bool QRect::isValid() const

Renvoie ` true ` si le rectangle est valide, sinon renvoie ` false`.

Un rectangle valide satisfait les conditions suivantes : left() ≤ right() et top() ≤ bottom(). Notez que les opérations non triviales, telles que les intersections, ne sont pas définies pour les rectangles non valides. Un rectangle valide n'est pas vide (c'est-à-dire isValid() == !isEmpty()).

Voir également isNull(), isEmpty() et normalized().

[constexpr noexcept] int QRect::left() const

Renvoie la coordonnée x du bord gauche du rectangle. Équivalent à x().

Voir également setLeft(), topLeft() et bottomLeft().

[constexpr noexcept] QRect QRect::marginsAdded(const QMargins &margins) const

Renvoie un rectangle agrandi selon la fonction « margins ».

Voir également operator+=(), marginsRemoved() et operator-=().

[constexpr noexcept] QRect QRect::marginsRemoved(const QMargins &margins) const

Supprime l'margins e du rectangle, ce qui le réduit.

Voir également marginsAdded(), operator+=() et operator-=().

[constexpr noexcept] void QRect::moveBottom(int y)

Déplace le rectangle verticalement, en maintenant son bord inférieur à la coordonnée d'y spécifiée. La taille du rectangle reste inchangée.

Voir également bottom(), setBottom() et moveTop().

[constexpr noexcept] void QRect::moveBottomLeft(const QPoint &position)

Déplace le rectangle en conservant son coin inférieur gauche à l'position indiquée. La taille du rectangle reste inchangée.

Voir également setBottomLeft(), moveBottom() et moveLeft().

[constexpr noexcept] void QRect::moveBottomRight(const QPoint &position)

Déplace le rectangle en conservant son coin inférieur droit à l'position indiquée. La taille du rectangle reste inchangée.

Voir également setBottomRight(), moveRight() et moveBottom().

[constexpr noexcept] void QRect::moveCenter(const QPoint &position)

Déplace le rectangle en conservant son centre à l'position e indiquée. La taille du rectangle reste inchangée.

Voir aussi center().

[constexpr noexcept] void QRect::moveLeft(int x)

Déplace le rectangle horizontalement, en laissant le bord gauche du rectangle à la coordonnée x indiquée. La taille du rectangle reste inchangée.

Voir également ` left()`, ` setLeft()` et ` moveRight()`.

[constexpr noexcept] void QRect::moveRight(int x)

Déplace le rectangle horizontalement, en laissant le bord droit du rectangle à la coordonnée x indiquée. La taille du rectangle reste inchangée.

Voir également right(), setRight() et moveLeft().

[constexpr noexcept] void QRect::moveTo(const QPoint &position)

Déplace le rectangle en conservant son coin supérieur gauche à l'position e indiquée.

[constexpr noexcept] void QRect::moveTo(int x, int y)

Déplace le rectangle en conservant son coin supérieur gauche à la position indiquée (x, y). La taille du rectangle reste inchangée.

Voir également translate() et moveTopLeft().

[constexpr noexcept] void QRect::moveTop(int y)

Déplace le rectangle verticalement, en maintenant son bord supérieur à la coordonnée d'y spécifiée. La taille du rectangle reste inchangée.

Voir également top(), setTop() et moveBottom().

[constexpr noexcept] void QRect::moveTopLeft(const QPoint &position)

Déplace le rectangle en conservant son coin supérieur gauche à la coordonnée indiquée position. La taille du rectangle reste inchangée.

Voir également setTopLeft(), moveTop() et moveLeft().

[constexpr noexcept] void QRect::moveTopRight(const QPoint &position)

Déplace le rectangle en conservant son coin supérieur droit à la coordonnée spécifiée position. La taille du rectangle reste inchangée.

Voir également setTopRight(), moveTop() et moveRight().

[noexcept] QRect QRect::normalized() const

Renvoie un rectangle normalisé, c'est-à-dire un rectangle dont la largeur et la hauteur sont non négatives.

Si width() < 0, la fonction permute les coins gauche et droit, et permute les coins supérieur et inférieur si height() < 0. Les coins passent alors de non inclusifs à inclusifs.

Voir également isValid() et isEmpty().

[constexpr noexcept] int QRect::right() const

Renvoie la coordonnée x du bord droit du rectangle.

Notez que, pour des raisons historiques, cette fonction renvoie left() + width() - 1 ; utilisez x() + width() pour obtenir la véritable coordonnée x.

Voir également setRight(), topRight() et bottomRight().

[constexpr noexcept] void QRect::setBottom(int y)

Définit le bord inférieur du rectangle à la coordonnée y indiquée. Peut modifier la hauteur, mais ne modifie jamais le bord supérieur du rectangle.

Voir également bottom() et moveBottom().

[constexpr noexcept] void QRect::setBottomLeft(const QPoint &position)

Définit le coin inférieur gauche du rectangle à l'adresse position. La taille peut varier, mais le coin supérieur droit du rectangle reste toujours inchangé.

Voir également bottomLeft() et moveBottomLeft().

[constexpr noexcept] void QRect::setBottomRight(const QPoint &position)

Définit le coin inférieur droit du rectangle aux coordonnées position. La taille peut varier, mais le coin supérieur gauche du rectangle reste toujours inchangé.

Voir également bottomRight() et moveBottomRight().

[constexpr noexcept] void QRect::setCoords(int x1, int y1, int x2, int y2)

Définit les coordonnées du coin supérieur gauche du rectangle sur (x1, y1) et celles de son coin inférieur droit sur (x2, y2).

Voir également getCoords() et setRect().

[constexpr noexcept] void QRect::setHeight(int height)

Définit la hauteur du rectangle à la valeur indiquée height. Le bord inférieur est modifié, mais pas le bord supérieur.

Voir également height() et setSize().

[constexpr noexcept] void QRect::setLeft(int x)

Définit le bord gauche du rectangle à la coordonnée x indiquée. Peut modifier la largeur, mais ne modifie jamais le bord droit du rectangle.

Équivalent à ` setX()`.

Voir également left() et moveLeft().

[constexpr noexcept] void QRect::setRect(int x, int y, int width, int height)

Définit les coordonnées du coin supérieur gauche du rectangle sur (x, y), et sa taille sur les valeurs indiquées width et height.

Voir également getRect() et setCoords().

[constexpr noexcept] void QRect::setRight(int x)

Définit le bord droit du rectangle à la coordonnée indiquée ( x ). Cela peut modifier la largeur, mais ne modifie jamais le bord gauche du rectangle.

Voir également ` right()` et ` moveRight()`.

[constexpr noexcept] void QRect::setSize(const QSize &size)

Définit la taille du rectangle selon les coordonnées indiquées size. Le coin supérieur gauche n'est pas déplacé.

Voir également size(), setWidth() et setHeight().

[constexpr noexcept] void QRect::setTop(int y)

Définit le bord supérieur du rectangle à la coordonnée « y » indiquée. Peut modifier la hauteur, mais ne modifie jamais le bord inférieur du rectangle.

Équivalent à ` setY()`.

Voir également top() et moveTop().

[constexpr noexcept] void QRect::setTopLeft(const QPoint &position)

Définit le coin supérieur gauche du rectangle à l'adresse indiquée position. La taille peut varier, mais le coin inférieur droit du rectangle reste toujours inchangé.

Voir également topLeft() et moveTopLeft().

[constexpr noexcept] void QRect::setTopRight(const QPoint &position)

Définit le coin supérieur droit du rectangle à l'adresse donnée position. La taille peut varier, mais le coin inférieur gauche du rectangle reste toujours inchangé.

Voir également topRight() et moveTopRight().

[constexpr noexcept] void QRect::setWidth(int width)

Définit la largeur du rectangle selon la valeur indiquée width. Le bord droit est modifié, mais pas le bord gauche.

Voir également ` width()` et ` setSize()`.

[constexpr noexcept] void QRect::setX(int x)

Définit le bord gauche du rectangle à la coordonnée d'x ion indiquée. Peut modifier la largeur, mais ne modifie jamais le bord droit du rectangle.

Équivalent à ` setLeft()`.

Voir également x(), setY() et setTopLeft().

[constexpr noexcept] void QRect::setY(int y)

Définit le bord supérieur du rectangle à la coordonnée y indiquée. Peut modifier la hauteur, mais ne modifie jamais le bord inférieur du rectangle.

Équivalent à ` setTop()`.

Voir également y(), setX() et setTopLeft().

[constexpr noexcept] QSize QRect::size() const

Renvoie la taille du rectangle.

Voir également setSize(), width() et height().

[static constexpr noexcept, since 6.0] QRect QRect::span(const QPoint &p1, const QPoint &p2)

Renvoie un rectangle délimité par les deux points p1 et p2, en incluant ces deux points ainsi que toute la zone située entre eux.

Cette fonction a été introduite dans Qt 6.0.

[noexcept] CGRect QRect::toCGRect() const

Crée un CGRect à partir d'un QRect.

Voir aussi QRectF::fromCGRect().

[constexpr noexcept, since 6.4] QRectF QRect::toRectF() const

Renvoie ce rectangle sous forme de rectangle avec une précision en virgule flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir également QRectF::toRect().

[constexpr noexcept] int QRect::top() const

Renvoie la coordonnée y du bord supérieur du rectangle. Équivalent à y().

Voir également setTop(), topLeft() et topRight().

[constexpr noexcept] QPoint QRect::topLeft() const

Renvoie la position du coin supérieur gauche du rectangle.

Voir également setTopLeft(), top() et left().

[constexpr noexcept] QPoint QRect::topRight() const

Renvoie la position du coin supérieur droit du rectangle.

Notez que, pour des raisons historiques, cette fonction renvoie QPoint(left() + width() -1, top()).

Voir également setTopRight(), top() et right().

[constexpr noexcept] void QRect::translate(int dx, int dy)

Déplace le rectangle de dx sur l'axe x et de dy sur l'axe y, par rapport à la position actuelle. Les valeurs positives déplacent le rectangle vers la droite et vers le bas.

Voir également moveTopLeft(), moveTo() et translated().

[constexpr noexcept] void QRect::translate(const QPoint &offset)

Déplace le rectangle offset.x() le long de l'axe x et offset.y() le long de l'axe y, par rapport à la position actuelle.

[constexpr noexcept] QRect QRect::translated(int dx, int dy) const

Renvoie une copie du rectangle décalée de dx sur l'axe x et de dy sur l'axe y, par rapport à la position actuelle. Les valeurs positives déplacent le rectangle vers la droite et vers le bas.

Voir aussi translate().

[constexpr noexcept] QRect QRect::translated(const QPoint &offset) const

Renvoie une copie du rectangle translatée de offset.x() le long de l'axe x et de offset.y() le long de l'axe y, par rapport à la position courante.

[constexpr noexcept] QRect QRect::transposed() const

Renvoie une copie du rectangle dont la largeur et la hauteur ont été inversées :

QRect r = {15, 51, 42, 24};
r = r.transposed(); // r == {15, 51, 24, 42}

Voir aussi QSize::transposed().

[noexcept] QRect QRect::united(const QRect &rectangle) const

Renvoie le rectangle englobant de ce rectangle et de l'rectangle donné.

Voir aussi intersected().

[constexpr noexcept] int QRect::width() const

Renvoie la largeur du rectangle.

Voir aussi setWidth(), height() et size().

[constexpr noexcept] int QRect::x() const

Renvoie la coordonnée x du bord gauche du rectangle. Équivalent à left().

Voir également setX(), y() et topLeft().

[constexpr noexcept] int QRect::y() const

Renvoie la coordonnée y du bord supérieur du rectangle. Équivalent à top().

Voir également setY(), x() et topLeft().

[noexcept] QRect QRect::operator&(const QRect &rectangle) const

Renvoie l'intersection entre ce rectangle et l'rectangle donné. Renvoie un rectangle vide s'il n'y a pas d'intersection.

Voir également ` operator&=()` et ` intersected()`.

[noexcept] QRect &QRect::operator&=(const QRect &rectangle)

Coupe ce rectangle avec l'rectangle, donné.

Voir également intersected() et operator&().

[constexpr noexcept] QRect &QRect::operator+=(const QMargins &margins)

Ajoute l'margins e au rectangle, ce qui l'agrandit.

Voir également marginsAdded(), marginsRemoved() et operator-=().

[constexpr noexcept] QRect &QRect::operator-=(const QMargins &margins)

Renvoie un rectangle réduit selon la fonction « margins ».

Voir également marginsRemoved(), operator+=() et marginsAdded().

[noexcept] QRect QRect::operator|(const QRect &rectangle) const

Renvoie le rectangle englobant de ce rectangle et de l'rectangle donné.

Voir également operator|=() et united().

[noexcept] QRect &QRect::operator|=(const QRect &rectangle)

Réunit ce rectangle à celui indiqué sur rectangle.

Voir aussi united() et operator|().