QRectF Class

Documentation des fonctions membres

[constexpr noexcept] QRectF::QRectF()

Construit un rectangle nul.

Voir aussi isNull().

[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)

Construit un rectangle QRectF à partir de QRect rectangle .

Voir également toRect() et QRect::toRectF().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

Construit un rectangle avec les coins topLeft et bottomRight.

Voir aussi setTopLeft() et setBottomRight().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

Construit un rectangle avec le coin donné topLeft et le coin donné size.

Voir aussi setTopLeft() et setSize().

[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

Construit un rectangle dont le coin supérieur gauche est (x, y) et dont les paramètres sont width et height. Tous les paramètres doivent être finis.

Voir aussi setRect().

[constexpr noexcept] void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)

Ajoute dx1, dy1, dx2 et dy2 respectivement aux coordonnées existantes du rectangle. Tous les paramètres doivent être finis.

Voir aussi adjusted() et setRect().

[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

Renvoie un nouveau rectangle avec dx1, dy1, dx2 et dy2 ajoutés respectivement aux coordonnées existantes de ce rectangle. Tous les paramètres doivent être finis.

Voir aussi adjust().

[constexpr noexcept] qreal QRectF::bottom() const

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

Voir aussi setBottom(), bottomLeft() et bottomRight().

[constexpr noexcept] QPointF QRectF::bottomLeft() const

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

Voir aussi setBottomLeft(), bottom() et left().

[constexpr noexcept] QPointF QRectF::bottomRight() const

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

Voir aussi setBottomRight(), bottom() et right().

[constexpr noexcept] QPointF QRectF::center() const

Renvoie le point central du rectangle.

Voir également moveCenter().

[noexcept] bool QRectF::contains(const QPointF &point) const

Renvoie true si l'objet donné point se trouve à l'intérieur ou au bord du rectangle ; sinon, renvoie false.

Voir aussi intersects().

[noexcept] bool QRectF::contains(const QRectF &rectangle) const

Renvoie true si l'objet donné rectangle se trouve à l'intérieur de ce rectangle ; sinon, renvoie false.

[noexcept] bool QRectF::contains(qreal x, qreal y) const

Renvoie true si le point (x, y) se trouve à l'intérieur ou sur le bord du rectangle ; sinon, renvoie false.

[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)

Crée un QRectF à partir du CGRect rect.

Voir aussi toCGRect().

[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)

Convertit le DOMRect (https://www.w3.org/TR/geometry-1/) domRect en QRectF. Le comportement est indéfini si le paramètre fourni n'est pas un DOMRect.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi toDOMRect().

[constexpr] void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *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 aussi setCoords() et getRect().

[constexpr] void QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *height) const

Extrait la position du coin supérieur gauche du rectangle vers *x et *y, et ses dimensions vers *width et *height.

Voir aussi setRect() et getCoords().

[constexpr noexcept] qreal QRectF::height() const

Renvoie la hauteur du rectangle.

Voir aussi setHeight(), width() et size().

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

Renvoie l'intersection de ce rectangle et de l'adresse rectangle. Notez que r.intersected(s) est équivalent à r & s.

Voir aussi intersects(), united(), et operator&=().

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

Renvoie true si ce rectangle intersecte le rectangle donné rectangle (c'est-à-dire qu'il existe une zone de chevauchement non vide entre eux), sinon renvoie false.

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

Voir aussi contains().

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

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

Un rectangle vide a width() <= 0 ou height() <= 0. 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 sont intervertis.

Voir aussi isNull(), isValid() et normalized().

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

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

La largeur et la hauteur d'un rectangle nul sont fixées à 0. Un rectangle nul est également vide et n'est donc pas valide.

Voir aussi isEmpty() et isValid().

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

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

Un rectangle valide a une valeur width() > 0 et height() > 0. 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 que isValid() == !isEmpty()).

Voir aussi isNull(), isEmpty(), et normalized().

[constexpr noexcept] qreal QRectF::left() const

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

Voir aussi setLeft(), topLeft() et bottomLeft().

[constexpr noexcept] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

Renvoie un rectangle agrandi par margins.

Voir aussi operator+=(), marginsRemoved(), et operator-=().

[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

Supprime le site margins du rectangle, en le rétrécissant.

Voir aussi marginsAdded(), operator+=() et operator-=().

[constexpr noexcept] void QRectF::moveBottom(qreal y)

Déplace le rectangle verticalement, en laissant le bord inférieur du rectangle à la coordonnée finie y donnée. La taille du rectangle reste inchangée.

Voir aussi bottom(), setBottom() et moveTop().

[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &position)

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

Voir aussi setBottomLeft(), moveBottom() et moveLeft().

[constexpr noexcept] void QRectF::moveBottomRight(const QPointF &position)

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

Voir aussi setBottomRight(), moveBottom() et moveRight().

[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)

Déplace le rectangle en laissant le point central à l'adresse position. La taille du rectangle reste inchangée.

Voir aussi center().

[constexpr noexcept] void QRectF::moveLeft(qreal x)

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

Voir aussi left(), setLeft() et moveRight().

[constexpr noexcept] void QRectF::moveRight(qreal x)

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

Voir aussi right(), setRight() et moveLeft().

[constexpr noexcept] void QRectF::moveTo(qreal x, qreal y)

Déplace le rectangle en laissant le coin supérieur gauche à la position donnée (x, y). La taille du rectangle reste inchangée. Les deux paramètres doivent être finis.

Voir également translate() et moveTopLeft().

[constexpr noexcept] void QRectF::moveTo(const QPointF &position)

Déplace le rectangle en laissant le coin supérieur gauche à la valeur donnée position.

[constexpr noexcept] void QRectF::moveTop(qreal y)

Déplace le rectangle verticalement, en laissant la ligne supérieure du rectangle à la coordonnée finie donnée y. La taille du rectangle reste inchangée.

Voir aussi top(), setTop() et moveBottom().

[constexpr noexcept] void QRectF::moveTopLeft(const QPointF &position)

Déplace le rectangle en laissant le coin supérieur gauche à l'adresse position. La taille du rectangle reste inchangée.

Voir aussi setTopLeft(), moveTop() et moveLeft().

[constexpr noexcept] void QRectF::moveTopRight(const QPointF &position)

Déplace le rectangle en laissant le coin supérieur droit à l'adresse position. La taille du rectangle reste inchangée.

Voir aussi setTopRight(), moveTop() et moveRight().

[noexcept] QRectF QRectF::normalized() const

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

Si width() < 0, la fonction échange les coins gauche et droit, et elle échange les coins supérieur et inférieur si height() < 0.

Voir également isValid() et isEmpty().

[constexpr noexcept] qreal QRectF::right() const

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

Voir aussi setRight(), topRight() et bottomRight().

[constexpr noexcept] void QRectF::setBottom(qreal y)

Fixe le bord inférieur du rectangle à la coordonnée finie y donnée. Peut modifier la hauteur, mais ne modifiera jamais le bord supérieur du rectangle.

Voir aussi bottom() et moveBottom().

[constexpr noexcept] void QRectF::setBottomLeft(const QPointF &position)

Fixe le coin inférieur gauche du rectangle à la valeur donnée position. Peut modifier la taille, mais ne modifiera jamais le coin supérieur droit du rectangle.

Voir aussi bottomLeft() et moveBottomLeft().

[constexpr noexcept] void QRectF::setBottomRight(const QPointF &position)

Fixe le coin inférieur droit du rectangle à la valeur donnée position. Peut modifier la taille, mais ne modifiera jamais le coin supérieur gauche du rectangle.

Voir aussi bottomRight() et moveBottomRight().

[constexpr noexcept] void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal y2)

Définit les coordonnées du coin supérieur gauche du rectangle à (x1, y1), et les coordonnées du coin inférieur droit à (x2, y2). Tous les paramètres doivent être finis.

Voir aussi getCoords() et setRect().

[constexpr noexcept] void QRectF::setHeight(qreal height)

Fixe la hauteur du rectangle à la valeur finie donnée height. Le bord inférieur est modifié, mais pas le bord supérieur.

Voir aussi height() et setSize().

[constexpr noexcept] void QRectF::setLeft(qreal x)

Fixe le bord gauche du rectangle à la coordonnée finie x donnée. Peut modifier la largeur, mais ne modifiera jamais le bord droit du rectangle.

Équivalent à setX().

Voir aussi left() et moveLeft().

[constexpr noexcept] void QRectF::setRect(qreal x, qreal y, qreal width, qreal height)

Définit les coordonnées du coin supérieur gauche du rectangle à (x, y), et sa taille à width et height. Tous les paramètres doivent être finis.

Voir aussi getRect() et setCoords().

[constexpr noexcept] void QRectF::setRight(qreal x)

Fixe le bord droit du rectangle à la coordonnée finie x donnée. Peut modifier la largeur, mais ne modifiera jamais le bord gauche du rectangle.

Voir aussi right() et moveRight().

[constexpr noexcept] void QRectF::setSize(const QSizeF &size)

Fixe la taille du rectangle à la valeur finie donnée size. Le coin supérieur gauche n'est pas déplacé.

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

[constexpr noexcept] void QRectF::setTop(qreal y)

Fixe le bord supérieur du rectangle à la coordonnée finie y donnée. Peut changer la hauteur, mais ne changera jamais le bord inférieur du rectangle.

Équivalent à setY().

Voir aussi top() et moveTop().

[constexpr noexcept] void QRectF::setTopLeft(const QPointF &position)

Fixe le coin supérieur gauche du rectangle à l'adresse position. Peut modifier la taille, mais ne modifiera jamais le coin inférieur droit du rectangle.

Voir aussi topLeft() et moveTopLeft().

[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)

Fixe le coin supérieur droit du rectangle à l'adresse position. Peut modifier la taille, mais ne modifiera jamais le coin inférieur gauche du rectangle.

Voir aussi topRight() et moveTopRight().

[constexpr noexcept] void QRectF::setWidth(qreal width)

Fixe la largeur du rectangle à la valeur finie donnée width. Le bord droit est modifié, mais pas le bord gauche.

Voir aussi width() et setSize().

[constexpr noexcept] void QRectF::setX(qreal x)

Fixe le bord gauche du rectangle à la coordonnée finie x donnée. Peut modifier la largeur, mais ne modifiera jamais le bord droit du rectangle.

Équivalent à setLeft().

Voir aussi x(), setY() et setTopLeft().

[constexpr noexcept] void QRectF::setY(qreal y)

Fixe le bord supérieur du rectangle à la coordonnée finie y donnée. Peut changer la hauteur, mais ne changera jamais le bord inférieur du rectangle.

Équivalent à setTop().

Voir aussi y(), setX() et setTopLeft().

[constexpr noexcept] QSizeF QRectF::size() const

Renvoie la taille du rectangle.

Voir aussi setSize(), width() et height().

[noexcept] QRect QRectF::toAlignedRect() const

Renvoie un QRect basé sur les valeurs de ce rectangle qui est le plus petit rectangle entier possible qui contient complètement ce rectangle.

Voir aussi toRect().

[noexcept] CGRect QRectF::toCGRect() const

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

Voir aussi fromCGRect().

[since 6.5] emscripten::val QRectF::toDOMRect() const

Convertit cet objet en un DOMRect (https://www.w3.org/TR/geometry-1/).

Cette fonction a été introduite dans Qt 6.5.

Voir aussi fromDOMRect().

[constexpr noexcept] QRect QRectF::toRect() const

Renvoie une adresse QRect basée sur les valeurs de ce rectangle. Notez que les coordonnées du rectangle retourné sont arrondies à l'entier le plus proche.

Voir aussi QRectF(), toAlignedRect(), et QRect::toRectF().

[constexpr noexcept] qreal QRectF::top() const

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

Voir aussi setTop(), topLeft() et topRight().

[constexpr noexcept] QPointF QRectF::topLeft() const

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

Voir aussi setTopLeft(), top() et left().

[constexpr noexcept] QPointF QRectF::topRight() const

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

Voir aussi setTopRight(), top() et right().

[constexpr noexcept] void QRectF::translate(qreal dx, qreal dy)

Déplace le rectangle dx le long de l'axe x et dy le long de l'axe y, par rapport à la position actuelle. Les valeurs positives déplacent le rectangle vers la droite et vers le bas. Les deux paramètres doivent être finis.

Voir aussi moveTopLeft(), moveTo() et translated().

[constexpr noexcept] void QRectF::translate(const QPointF &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] QRectF QRectF::translated(qreal dx, qreal dy) const

Renvoie une copie du rectangle qui a été translaté de dx le long de l'axe x et de dy le long de l'axe y, par rapport à la position actuelle. Les valeurs positives déplacent le rectangle vers la droite et vers le bas. Les deux paramètres doivent être finis.

Voir aussi translate().

[constexpr noexcept] QRectF QRectF::translated(const QPointF &offset) const

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

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

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

QRectF r = {1.5, 5.1, 4.2, 2.4};
r = r.transposed(); // r == {1.5, 5.1, 2.4, 4.2}

Voir aussi QSizeF::transposed().

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

Renvoie le rectangle de délimitation de ce rectangle et de rectangle.

Voir aussi intersected().

[constexpr noexcept] qreal QRectF::width() const

Renvoie la largeur du rectangle.

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

[constexpr noexcept] qreal QRectF::x() const

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

Voir aussi setX(), y() et topLeft().

[constexpr noexcept] qreal QRectF::y() const

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

Voir aussi setY(), x() et topLeft().

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

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

Voir aussi operator&=() et intersected().

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

Intersection de ce rectangle avec le rectangle donné rectangle.

Voir aussi intersected() et operator&().

[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)

Ajoute le site margins au rectangle, en l'agrandissant.

Voir aussi marginsAdded(), marginsRemoved() et operator-=().

[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)

Renvoie un rectangle rétréci par la valeur margins.

Voir aussi marginsRemoved(), operator+=(), et marginsAdded().

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

Renvoie le rectangle de délimitation de ce rectangle et de rectangle.

Voir aussi united() et operator|=().

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

Réunit ce rectangle avec le rectangle donné rectangle.

Voir aussi united() et operator|().