QRectF Class

Documentation sur les fonctions membres

[constexpr noexcept] QRectF::QRectF()

Crée un rectangle nul.

Voir également isNull().

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

Crée un rectangle QRectF à partir de l'QRect rectangle fournie.

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

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

Crée un rectangle dont les sommets sont définis par les coordonnées topLeft et bottomRight.

Voir également setTopLeft() et setBottomRight().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &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] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

Construit un rectangle dont le coin supérieur gauche est situé à l'ordonnée (x) et à la coordonnée ( y), et dont les dimensions sont données par width et height. Tous les paramètres doivent être finis.

Voir également setRect().

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

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

Voir également adjusted() et setRect().

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

Renvoie un nouveau rectangle auquel sont ajoutées respectivement les valeurs dx1, dy1, dx2 et dy2 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 également setBottom(), bottomLeft() et bottomRight().

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

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

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

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

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

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

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

Renvoie le point central du rectangle.

Voir aussi moveCenter().

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

Renvoie « true » si l'point on fournie se trouve à l'intérieur ou sur le bord du rectangle ; sinon, renvoie « false ».

Voir également intersects().

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

Renvoie ` true ` si l'rectangle on fournie 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 objet ` QRectF ` à partir d'un `CGRect` rect.

Voir aussi toCGRect().

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

Convertit l'domRect DOMRect (https://www.w3.org/TR/geometry-1/) 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 également 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 également setCoords() et getRect().

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

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

Voir également setRect() et getCoords().

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

Renvoie la hauteur du rectangle.

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

[noexcept] QRectF QRectF::intersected(const QRectF &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 QRectF::intersects(const QRectF &rectangle) const

Renvoie ` true ` si ce rectangle recoupe le rectangle ` rectangle ` donné (c'est-à-dire s'il existe une zone de chevauchement non vide entre les deux), sinon renvoie ` false`.

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

Voir également contains().

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

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

Un rectangle vide a une valeur de 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 ont été permutés.

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

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

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

Un rectangle nul a une largeur et une hauteur toutes deux égales à 0. Un rectangle nul est également vide, et n'est donc pas valide.

Voir également isEmpty() et isValid().

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

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

Un rectangle valide présente 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 isValid() == !isEmpty()).

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

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

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

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

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

Renvoie un rectangle agrandi selon l'margins.

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

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

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

Voir également 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 indiquée. La taille du rectangle reste inchangée.

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

[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &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 QRectF::moveBottomRight(const QPointF &position)

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

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

[constexpr noexcept] void QRectF::moveCenter(const QPointF &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 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 également 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 x indiquée. La taille du rectangle reste inchangée.

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

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

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

Voir également translate() et moveTopLeft().

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

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

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

Déplace le rectangle verticalement, en maintenant le bord supérieur du rectangle à la coordonnée finie y indiquée. La taille du rectangle reste inchangée.

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

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

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

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

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

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

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

[noexcept] QRectF QRectF::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 elle permute 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 également setRight(), topRight() et bottomRight().

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

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

Voir également bottom() et moveBottom().

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

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

Voir également bottomLeft() et moveBottomLeft().

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

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

Voir également 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 celles de son coin inférieur droit à (x2, y2). Tous les paramètres doivent être finis.

Voir également getCoords() et setRect().

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

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

Voir également height() et setSize().

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

Définit le bord gauche du rectangle à la coordonnée finie donnée de l'x. Peut modifier la largeur, mais ne modifie jamais le bord droit du rectangle.

Équivalent à ` setX()`.

Voir également 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 sur (x, y), et sa taille sur les valeurs fournies width et height. Tous les paramètres doivent être des nombres finis.

Voir également getRect() et setCoords().

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

Définit le bord droit du rectangle à la coordonnée finie donnée de l'x. Peut modifier la largeur, mais ne modifie jamais le bord gauche du rectangle.

Voir également right() et moveRight().

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

Définit la taille du rectangle sur la valeur finie size. Le coin supérieur gauche n'est pas déplacé.

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

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

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

Équivalent à ` setY()`.

Voir également top() et moveTop().

[constexpr noexcept] void QRectF::setTopLeft(const QPointF &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 QRectF::setTopRight(const QPointF &position)

Définit le coin supérieur droit du rectangle à la coordonné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 QRectF::setWidth(qreal width)

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

Voir également width() et setSize().

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

Définit le bord gauche du rectangle à la coordonnée donnée de l'x e fini. Peut modifier la largeur, mais ne modifie jamais le bord droit du rectangle.

Équivalent à ` setLeft()`.

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

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

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

Équivalent à ` setTop()`.

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

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

Renvoie la taille du rectangle.

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

[noexcept] QRect QRectF::toAlignedRect() const

Renvoie un ` QRect ` basé sur les valeurs de ce rectangle ; il s'agit du plus petit rectangle entier possible qui contient entièrement 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 également fromDOMRect().

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

Renvoie un objet ` QRect ` basé sur les valeurs de ce rectangle. Notez que les coordonnées du rectangle renvoyé sont arrondies à l'entier le plus proche.

Voir également 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 également setTop(), topLeft() et topRight().

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

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

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

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

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

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

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

Déplace le rectangle 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 également 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 décalé 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 également translate().

[constexpr noexcept] QRectF QRectF::translated(const QPointF &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 actuelle.

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

Renvoie une copie du rectangle dont la largeur et la hauteur ont été inversé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 englobant de ce rectangle et de l'rectangle donné.

Voir aussi intersected().

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

Renvoie la largeur du rectangle.

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

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

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

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

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

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

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

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

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

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

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

Coupe ce rectangle avec l'rectangle e donnée.

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

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

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

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

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

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

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

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

Renvoie le rectangle englobant formé par ce rectangle et l'rectangle donné.

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

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

Réunit ce rectangle à celui indiqué à l'adresse rectangle.

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