Struct qt_gui::QPolygon

source ·
#[repr(C)]
pub struct QPolygon { /* private fields */ }
Expand description

The QPolygon class provides a vector of points using integer precision.

C++ class: QPolygon.

C++ documentation:

The QPolygon class provides a vector of points using integer precision.

A QPolygon object is a QVector<QPoint>. The easiest way to add points to a QPolygon is to use QVector's streaming operator, as illustrated below:

QPolygon polygon; polygon << QPoint(10, 20) << QPoint(20, 30);

In addition to the functions provided by QVector, QPolygon provides some point-specific functions.

Each point in a polygon can be retrieved by passing its index to the point() function. To populate the polygon, QPolygon provides the setPoint() function to set the point at a given index, the setPoints() function to set all the points in the polygon (resizing it to the given number of points), and the putPoints() function which copies a number of given points into the polygon from a specified index (resizing the polygon if necessary).

QPolygon provides the boundingRect() and translate() functions for geometry functions. Use the QMatrix::map() function for more general transformations of QPolygons.

The QPolygon class is implicitly shared.

Implementations§

source§

impl QPolygon

source

pub unsafe fn bounding_rect(&self) -> CppBox<QRect>

Returns the bounding rectangle of the polygon, or QRect(0, 0, 0, 0) if the polygon is empty.

Calls C++ function: QRect QPolygon::boundingRect() const.

C++ documentation:

Returns the bounding rectangle of the polygon, or QRect(0, 0, 0, 0) if the polygon is empty.

See also QVector::isEmpty().

source

pub unsafe fn contains_point( &self, pt: impl CastInto<Ref<QPoint>>, fill_rule: FillRule ) -> bool

Returns true if the given point is inside the polygon according to the specified fillRule; otherwise returns false.

Calls C++ function: bool QPolygon::containsPoint(const QPoint& pt, Qt::FillRule fillRule) const.

C++ documentation:

Returns true if the given point is inside the polygon according to the specified fillRule; otherwise returns false.

This function was introduced in Qt 4.3.

source

pub unsafe fn copy_from( &self, other: impl CastInto<Ref<QPolygon>> ) -> Ref<QPolygon>

Copy-assignment operator.

Calls C++ function: QPolygon& QPolygon::operator=(const QPolygon& other).

C++ documentation:

Copy-assignment operator.

source

pub unsafe fn intersected( &self, r: impl CastInto<Ref<QPolygon>> ) -> CppBox<QPolygon>

Returns a polygon which is the intersection of this polygon and r.

Calls C++ function: QPolygon QPolygon::intersected(const QPolygon& r) const.

C++ documentation:

Returns a polygon which is the intersection of this polygon and r.

Set operations on polygons will treat the polygons as areas. Non-closed polygons will be treated as implicitly closed.

This function was introduced in Qt 4.3.

source

pub unsafe fn intersects(&self, r: impl CastInto<Ref<QPolygon>>) -> bool

Available on cpp_lib_version="5.11.3" or cpp_lib_version="5.12.2" or cpp_lib_version="5.13.0" or cpp_lib_version="5.14.0" only.

Returns true if the current polygon intersects at any point the given polygon p. Also returns true if the current polygon contains or is contained by any part of p.

Calls C++ function: bool QPolygon::intersects(const QPolygon& r) const.

C++ documentation:

Returns true if the current polygon intersects at any point the given polygon p. Also returns true if the current polygon contains or is contained by any part of p.

Set operations on polygons will treat the polygons as areas. Non-closed polygons will be treated as implicitly closed.

This function was introduced in Qt 5.10.

See also intersected().

source

pub unsafe fn new() -> CppBox<QPolygon>

Constructs a polygon with no points.

Calls C++ function: [constructor] void QPolygon::QPolygon().

C++ documentation:

Constructs a polygon with no points.

See also QVector::isEmpty().

source

pub unsafe fn from_int(size: c_int) -> CppBox<QPolygon>

Constructs a polygon of the given size. Creates an empty polygon if size == 0.

Calls C++ function: [constructor] void QPolygon::QPolygon(int size).

C++ documentation:

Constructs a polygon of the given size. Creates an empty polygon if size == 0.

See also QVector::isEmpty().

source

pub unsafe fn from_q_vector_of_q_point( v: impl CastInto<Ref<QVectorOfQPoint>> ) -> CppBox<QPolygon>

Constructs a polygon containing the specified points.

Calls C++ function: [constructor] void QPolygon::QPolygon(const QVector<QPoint>& v).

C++ documentation:

Constructs a polygon containing the specified points.

See also setPoints().

source

pub unsafe fn from_q_rect_bool( r: impl CastInto<Ref<QRect>>, closed: bool ) -> CppBox<QPolygon>

Constructs a polygon from the given rectangle. If closed is false, the polygon just contains the four points of the rectangle ordered clockwise, otherwise the polygon's fifth point is set to rectangle.topLeft().

Calls C++ function: [constructor] void QPolygon::QPolygon(const QRect& r, bool closed = …).

C++ documentation:

Constructs a polygon from the given rectangle. If closed is false, the polygon just contains the four points of the rectangle ordered clockwise, otherwise the polygon’s fifth point is set to rectangle.topLeft().

Note that the bottom-right corner of the rectangle is located at (rectangle.x() + rectangle.width(), rectangle.y() + rectangle.height()).

See also setPoints().

source

pub unsafe fn from_int_int( n_points: c_int, points: *const c_int ) -> CppBox<QPolygon>

Calls C++ function: [constructor] void QPolygon::QPolygon(int nPoints, const int* points).

source

pub unsafe fn from_q_rect(r: impl CastInto<Ref<QRect>>) -> CppBox<QPolygon>

Constructs a polygon from the given rectangle. If closed is false, the polygon just contains the four points of the rectangle ordered clockwise, otherwise the polygon's fifth point is set to rectangle.topLeft().

Calls C++ function: [constructor] void QPolygon::QPolygon(const QRect& r).

C++ documentation:

Constructs a polygon from the given rectangle. If closed is false, the polygon just contains the four points of the rectangle ordered clockwise, otherwise the polygon’s fifth point is set to rectangle.topLeft().

Note that the bottom-right corner of the rectangle is located at (rectangle.x() + rectangle.width(), rectangle.y() + rectangle.height()).

See also setPoints().

source

pub unsafe fn new_copy(other: impl CastInto<Ref<QPolygon>>) -> CppBox<QPolygon>

Constructs a copy of the given polygon.

Calls C++ function: [constructor] void QPolygon::QPolygon(const QPolygon& other).

C++ documentation:

Constructs a copy of the given polygon.

See also setPoints().

source

pub unsafe fn point_3a(&self, i: c_int, x: *mut c_int, y: *mut c_int)

Extracts the coordinates of the point at the given index to *x and *y (if they are valid pointers).

Calls C++ function: void QPolygon::point(int i, int* x, int* y) const.

C++ documentation:

Extracts the coordinates of the point at the given index to *x and *y (if they are valid pointers).

See also setPoint().

source

pub unsafe fn point_1a(&self, i: c_int) -> CppBox<QPoint>

This is an overloaded function.

Calls C++ function: QPoint QPolygon::point(int i) const.

C++ documentation:

This is an overloaded function.

Returns the point at the given index.

source

pub unsafe fn put_points_2_int_int( &self, index: c_int, n_points: c_int, points: *const c_int )

Calls C++ function: void QPolygon::putPoints(int index, int nPoints, const int* points).

source

pub unsafe fn put_points_2_int_q_polygon_int( &self, index: c_int, n_points: c_int, from: impl CastInto<Ref<QPolygon>>, from_index: c_int )

This is an overloaded function.

Calls C++ function: void QPolygon::putPoints(int index, int nPoints, const QPolygon& from, int fromIndex = …).

C++ documentation:

This is an overloaded function.

Copies nPoints points from the given fromIndex ( 0 by default) in fromPolygon into this polygon, starting at the specified index. For example:

QPolygon polygon1; polygon1.putPoints(0, 3, 1,2, 0,0, 5,6); // polygon1 is now the three-point polygon(1,2, 0,0, 5,6);

QPolygon polygon2; polygon2.putPoints(0, 3, 4,4, 5,5, 6,6); // polygon2 is now (4,4, 5,5, 6,6);

polygon1.putPoints(2, 3, polygon2); // polygon1 is now the five-point polygon(1,2, 0,0, 4,4, 5,5, 6,6);

source

pub unsafe fn put_points_2_int_q_polygon( &self, index: c_int, n_points: c_int, from: impl CastInto<Ref<QPolygon>> )

This is an overloaded function.

Calls C++ function: void QPolygon::putPoints(int index, int nPoints, const QPolygon& from).

C++ documentation:

This is an overloaded function.

Copies nPoints points from the given fromIndex ( 0 by default) in fromPolygon into this polygon, starting at the specified index. For example:

QPolygon polygon1; polygon1.putPoints(0, 3, 1,2, 0,0, 5,6); // polygon1 is now the three-point polygon(1,2, 0,0, 5,6);

QPolygon polygon2; polygon2.putPoints(0, 3, 4,4, 5,5, 6,6); // polygon2 is now (4,4, 5,5, 6,6);

polygon1.putPoints(2, 3, polygon2); // polygon1 is now the five-point polygon(1,2, 0,0, 4,4, 5,5, 6,6);

source

pub unsafe fn set_point_3a(&self, index: c_int, x: c_int, y: c_int)

Sets the point at the given index to the point specified by (x, y).

Calls C++ function: void QPolygon::setPoint(int index, int x, int y).

C++ documentation:

Sets the point at the given index to the point specified by (x, y).

See also point(), putPoints(), and setPoints().

source

pub unsafe fn set_point_2a(&self, index: c_int, p: impl CastInto<Ref<QPoint>>)

This is an overloaded function.

Calls C++ function: void QPolygon::setPoint(int index, const QPoint& p).

C++ documentation:

This is an overloaded function.

Sets the point at the given index to the given point.

source

pub unsafe fn set_points(&self, n_points: c_int, points: *const c_int)

Resizes the polygon to nPoints and populates it with the given points.

Calls C++ function: void QPolygon::setPoints(int nPoints, const int* points).

C++ documentation:

Resizes the polygon to nPoints and populates it with the given points.

The example code creates a polygon with two points (10, 20) and (30, 40):

static const int points[] = { 10, 20, 30, 40 }; QPolygon polygon; polygon.setPoints(2, points);

See also setPoint() and putPoints().

source

pub unsafe fn subtracted( &self, r: impl CastInto<Ref<QPolygon>> ) -> CppBox<QPolygon>

Returns a polygon which is r subtracted from this polygon.

Calls C++ function: QPolygon QPolygon::subtracted(const QPolygon& r) const.

C++ documentation:

Returns a polygon which is r subtracted from this polygon.

Set operations on polygons will treat the polygons as areas. Non-closed polygons will be treated as implicitly closed.

This function was introduced in Qt 4.3.

source

pub unsafe fn swap(&self, other: impl CastInto<Ref<QPolygon>>)

Swaps polygon other with this polygon. This operation is very fast and never fails.

Calls C++ function: void QPolygon::swap(QPolygon& other).

C++ documentation:

Swaps polygon other with this polygon. This operation is very fast and never fails.

This function was introduced in Qt 4.8.

source

pub unsafe fn to_q_variant(&self) -> CppBox<QVariant>

Returns the polygon as a QVariant

Calls C++ function: QVariant QPolygon::operator QVariant() const.

C++ documentation:

Returns the polygon as a QVariant

source

pub unsafe fn translate_2a(&self, dx: c_int, dy: c_int)

Translates all points in the polygon by (dx, dy).

Calls C++ function: void QPolygon::translate(int dx, int dy).

C++ documentation:

Translates all points in the polygon by (dx, dy).

See also translated().

source

pub unsafe fn translate_1a(&self, offset: impl CastInto<Ref<QPoint>>)

This is an overloaded function.

Calls C++ function: void QPolygon::translate(const QPoint& offset).

C++ documentation:

This is an overloaded function.

Translates all points in the polygon by the given offset.

See also translated().

source

pub unsafe fn translated_2a(&self, dx: c_int, dy: c_int) -> CppBox<QPolygon>

Returns a copy of the polygon that is translated by (dx, dy).

Calls C++ function: QPolygon QPolygon::translated(int dx, int dy) const.

C++ documentation:

Returns a copy of the polygon that is translated by (dx, dy).

This function was introduced in Qt 4.6.

See also translate().

source

pub unsafe fn translated_1a( &self, offset: impl CastInto<Ref<QPoint>> ) -> CppBox<QPolygon>

This is an overloaded function.

Calls C++ function: QPolygon QPolygon::translated(const QPoint& offset) const.

C++ documentation:

This is an overloaded function.

Returns a copy of the polygon that is translated by the given offset.

This function was introduced in Qt 4.6.

See also translate().

source

pub unsafe fn united(&self, r: impl CastInto<Ref<QPolygon>>) -> CppBox<QPolygon>

Returns a polygon which is the union of this polygon and r.

Calls C++ function: QPolygon QPolygon::united(const QPolygon& r) const.

C++ documentation:

Returns a polygon which is the union of this polygon and r.

Set operations on polygons, will treat the polygons as areas, and implicitly close the polygon.

This function was introduced in Qt 4.3.

See also intersected() and subtracted().

Methods from Deref<Target = QVectorOfQPoint>§

source

pub unsafe fn add_assign_q_vector_of_q_point( &self, l: impl CastInto<Ref<QVectorOfQPoint>> ) -> Ref<QVectorOfQPoint>

Appends the items of the other vector to this vector and returns a reference to this vector.

Calls C++ function: QVector<QPoint>& QVector<QPoint>::operator+=(const QVector<QPoint>& l).

C++ documentation:

Appends the items of the other vector to this vector and returns a reference to this vector.

See also operator+() and append().

source

pub unsafe fn add_assign_q_point( &self, t: impl CastInto<Ref<QPoint>> ) -> Ref<QVectorOfQPoint>

This is an overloaded function.

Calls C++ function: QVector<QPoint>& QVector<QPoint>::operator+=(const QPoint& t).

C++ documentation:

This is an overloaded function.

Appends value to the vector.

See also append() and operator<<().

source

pub unsafe fn append_q_point(&self, t: impl CastInto<Ref<QPoint>>)

Inserts value at the end of the vector.

Calls C++ function: void QVector<QPoint>::append(const QPoint& t).

C++ documentation:

Inserts value at the end of the vector.

Example:

QVector<QString> vector; vector.append(“one”); vector.append(“two”); QString three = “three”; vector.append(three); // vector: [“one”, “two”, “three”] // three: “three”

This is the same as calling resize(size() + 1) and assigning value to the new last element in the vector.

This operation is relatively fast, because QVector typically allocates more memory than necessary, so it can grow without reallocating the entire vector each time.

See also operator<<(), prepend(), and insert().

source

pub unsafe fn append_q_vector_of_q_point( &self, l: impl CastInto<Ref<QVectorOfQPoint>> )

This is an overloaded function.

Calls C++ function: void QVector<QPoint>::append(const QVector<QPoint>& l).

C++ documentation:

This is an overloaded function.

Appends the items of the value vector to this vector.

This function was introduced in Qt 5.5.

See also operator<<() and operator+=().

source

pub unsafe fn at(&self, i: c_int) -> Ref<QPoint>

Returns the item at index position i in the vector.

Calls C++ function: const QPoint& QVector<QPoint>::at(int i) const.

C++ documentation:

Returns the item at index position i in the vector.

i must be a valid index position in the vector (i.e., 0 <= i < size()).

See also value() and operator[]().

source

pub unsafe fn back_mut(&self) -> Ref<QPoint>

This function is provided for STL compatibility. It is equivalent to last().

Calls C++ function: QPoint& QVector<QPoint>::back().

C++ documentation:

This function is provided for STL compatibility. It is equivalent to last().

source

pub unsafe fn back(&self) -> Ref<QPoint>

This is an overloaded function.

Calls C++ function: const QPoint& QVector<QPoint>::back() const.

C++ documentation:

This is an overloaded function.

source

pub unsafe fn capacity(&self) -> c_int

Returns the maximum number of items that can be stored in the vector without forcing a reallocation.

Calls C++ function: int QVector<QPoint>::capacity() const.

C++ documentation:

Returns the maximum number of items that can be stored in the vector without forcing a reallocation.

The sole purpose of this function is to provide a means of fine tuning QVector's memory usage. In general, you will rarely ever need to call this function. If you want to know how many items are in the vector, call size().

See also reserve() and squeeze().

source

pub unsafe fn clear(&self)

Removes all the elements from the vector.

Calls C++ function: void QVector<QPoint>::clear().

C++ documentation:

Removes all the elements from the vector.

Note: Until Qt 5.6, this also released the memory used by the vector. From Qt 5.7, the capacity is preserved. To shed all capacity, swap with a default-constructed vector:

QVector<T> v ...; QVector<T>().swap(v); Q_ASSERT(v.capacity() == 0);

or call squeeze().

See also squeeze().

source

pub unsafe fn const_data(&self) -> Ptr<QPoint>

Returns a const pointer to the data stored in the vector. The pointer can be used to access the items in the vector. The pointer remains valid as long as the vector isn't reallocated.

Calls C++ function: const QPoint* QVector<QPoint>::constData() const.

C++ documentation:

Returns a const pointer to the data stored in the vector. The pointer can be used to access the items in the vector. The pointer remains valid as long as the vector isn’t reallocated.

This function is mostly useful to pass a vector to a function that accepts a plain C++ array.

See also data() and operator[]().

source

pub unsafe fn const_first(&self) -> Ref<QPoint>

Returns a const reference to the first item in the vector. This function assumes that the vector isn't empty.

Calls C++ function: const QPoint& QVector<QPoint>::constFirst() const.

C++ documentation:

Returns a const reference to the first item in the vector. This function assumes that the vector isn’t empty.

This function was introduced in Qt 5.6.

See also constLast(), isEmpty(), and first().

source

pub unsafe fn const_last(&self) -> Ref<QPoint>

Returns a const reference to the last item in the vector. This function assumes that the vector isn't empty.

Calls C++ function: const QPoint& QVector<QPoint>::constLast() const.

C++ documentation:

Returns a const reference to the last item in the vector. This function assumes that the vector isn’t empty.

This function was introduced in Qt 5.6.

See also constFirst(), isEmpty(), and last().

source

pub unsafe fn contains(&self, t: impl CastInto<Ref<QPoint>>) -> bool

Returns true if the vector contains an occurrence of value; otherwise returns false.

Calls C++ function: bool QVector<QPoint>::contains(const QPoint& t) const.

C++ documentation:

Returns true if the vector contains an occurrence of value; otherwise returns false.

This function requires the value type to have an implementation of operator==().

See also indexOf() and count().

source

pub unsafe fn copy_from( &self, v: impl CastInto<Ref<QVectorOfQPoint>> ) -> Ref<QVectorOfQPoint>

Assigns other to this vector and returns a reference to this vector.

Calls C++ function: QVector<QPoint>& QVector<QPoint>::operator=(const QVector<QPoint>& v).

C++ documentation:

Assigns other to this vector and returns a reference to this vector.

source

pub unsafe fn count_1a(&self, t: impl CastInto<Ref<QPoint>>) -> c_int

Returns the number of occurrences of value in the vector.

Calls C++ function: int QVector<QPoint>::count(const QPoint& t) const.

C++ documentation:

Returns the number of occurrences of value in the vector.

This function requires the value type to have an implementation of operator==().

See also contains() and indexOf().

source

pub unsafe fn count_0a(&self) -> c_int

This is an overloaded function.

Calls C++ function: int QVector<QPoint>::count() const.

C++ documentation:

This is an overloaded function.

Same as size().

source

pub unsafe fn data_mut(&self) -> Ptr<QPoint>

Returns a pointer to the data stored in the vector. The pointer can be used to access and modify the items in the vector.

Calls C++ function: QPoint* QVector<QPoint>::data().

C++ documentation:

Returns a pointer to the data stored in the vector. The pointer can be used to access and modify the items in the vector.

Example:

QVector<int> vector(10); int data = vector.data(); for (int i = 0; i < 10; ++i) data[i] = 2 i;

The pointer remains valid as long as the vector isn't reallocated.

This function is mostly useful to pass a vector to a function that accepts a plain C++ array.

See also constData() and operator[]().

source

pub unsafe fn data(&self) -> Ptr<QPoint>

This is an overloaded function.

Calls C++ function: const QPoint* QVector<QPoint>::data() const.

C++ documentation:

This is an overloaded function.

source

pub unsafe fn detach(&self)

Calls C++ function: void QVector<QPoint>::detach().

source

pub unsafe fn empty(&self) -> bool

This function is provided for STL compatibility. It is equivalent to isEmpty(), returning true if the vector is empty; otherwise returns false.

Calls C++ function: bool QVector<QPoint>::empty() const.

C++ documentation:

This function is provided for STL compatibility. It is equivalent to isEmpty(), returning true if the vector is empty; otherwise returns false.

source

pub unsafe fn ends_with(&self, t: impl CastInto<Ref<QPoint>>) -> bool

Returns true if this vector is not empty and its last item is equal to value; otherwise returns false.

Calls C++ function: bool QVector<QPoint>::endsWith(const QPoint& t) const.

C++ documentation:

Returns true if this vector is not empty and its last item is equal to value; otherwise returns false.

This function was introduced in Qt 4.5.

See also isEmpty() and last().

source

pub unsafe fn fill_2a( &self, t: impl CastInto<Ref<QPoint>>, size: c_int ) -> Ref<QVectorOfQPoint>

Assigns value to all items in the vector. If size is different from -1 (the default), the vector is resized to size size beforehand.

Calls C++ function: QVector<QPoint>& QVector<QPoint>::fill(const QPoint& t, int size = …).

C++ documentation:

Assigns value to all items in the vector. If size is different from -1 (the default), the vector is resized to size size beforehand.

Example:

QVector<QString> vector(3); vector.fill(“Yes”); // vector: [“Yes”, “Yes”, “Yes”]

vector.fill(“oh”, 5); // vector: [“oh”, “oh”, “oh”, “oh”, “oh”]

See also resize().

source

pub unsafe fn fill_1a( &self, t: impl CastInto<Ref<QPoint>> ) -> Ref<QVectorOfQPoint>

Assigns value to all items in the vector. If size is different from -1 (the default), the vector is resized to size size beforehand.

Calls C++ function: QVector<QPoint>& QVector<QPoint>::fill(const QPoint& t).

C++ documentation:

Assigns value to all items in the vector. If size is different from -1 (the default), the vector is resized to size size beforehand.

Example:

QVector<QString> vector(3); vector.fill(“Yes”); // vector: [“Yes”, “Yes”, “Yes”]

vector.fill(“oh”, 5); // vector: [“oh”, “oh”, “oh”, “oh”, “oh”]

See also resize().

source

pub unsafe fn first_mut(&self) -> Ref<QPoint>

Returns a reference to the first item in the vector. This function assumes that the vector isn't empty.

Calls C++ function: QPoint& QVector<QPoint>::first().

C++ documentation:

Returns a reference to the first item in the vector. This function assumes that the vector isn’t empty.

See also last(), isEmpty(), and constFirst().

source

pub unsafe fn first(&self) -> Ref<QPoint>

This is an overloaded function.

Calls C++ function: const QPoint& QVector<QPoint>::first() const.

C++ documentation:

This is an overloaded function.

source

pub unsafe fn front_mut(&self) -> Ref<QPoint>

This function is provided for STL compatibility. It is equivalent to first().

Calls C++ function: QPoint& QVector<QPoint>::front().

C++ documentation:

This function is provided for STL compatibility. It is equivalent to first().

source

pub unsafe fn front(&self) -> Ref<QPoint>

This is an overloaded function.

Calls C++ function: const QPoint& QVector<QPoint>::front() const.

C++ documentation:

This is an overloaded function.

source

pub unsafe fn index_mut(&self, i: c_int) -> Ref<QPoint>

Returns the item at index position i as a modifiable reference.

Calls C++ function: QPoint& QVector<QPoint>::operator[](int i).

C++ documentation:

Returns the item at index position i as a modifiable reference.

i must be a valid index position in the vector (i.e., 0 <= i < size()).

Note that using non-const operators can cause QVector to do a deep copy.

See also at() and value().

source

pub unsafe fn index(&self, i: c_int) -> Ref<QPoint>

This is an overloaded function.

Calls C++ function: const QPoint& QVector<QPoint>::operator[](int i) const.

C++ documentation:

This is an overloaded function.

Same as at(i).

source

pub unsafe fn index_of_2a( &self, t: impl CastInto<Ref<QPoint>>, from: c_int ) -> c_int

Returns the index position of the first occurrence of value in the vector, searching forward from index position from. Returns -1 if no item matched.

Calls C++ function: int QVector<QPoint>::indexOf(const QPoint& t, int from = …) const.

C++ documentation:

Returns the index position of the first occurrence of value in the vector, searching forward from index position from. Returns -1 if no item matched.

Example:

QVector<QString> vector; vector << “A” << “B” << “C” << “B” << “A”; vector.indexOf(“B”); // returns 1 vector.indexOf(“B”, 1); // returns 1 vector.indexOf(“B”, 2); // returns 3 vector.indexOf(“X”); // returns -1

This function requires the value type to have an implementation of operator==().

See also lastIndexOf() and contains().

source

pub unsafe fn index_of_1a(&self, t: impl CastInto<Ref<QPoint>>) -> c_int

Returns the index position of the first occurrence of value in the vector, searching forward from index position from. Returns -1 if no item matched.

Calls C++ function: int QVector<QPoint>::indexOf(const QPoint& t) const.

C++ documentation:

Returns the index position of the first occurrence of value in the vector, searching forward from index position from. Returns -1 if no item matched.

Example:

QVector<QString> vector; vector << “A” << “B” << “C” << “B” << “A”; vector.indexOf(“B”); // returns 1 vector.indexOf(“B”, 1); // returns 1 vector.indexOf(“B”, 2); // returns 3 vector.indexOf(“X”); // returns -1

This function requires the value type to have an implementation of operator==().

See also lastIndexOf() and contains().

source

pub unsafe fn insert_2a(&self, i: c_int, t: impl CastInto<Ref<QPoint>>)

Inserts value at index position i in the vector. If i is 0, the value is prepended to the vector. If i is size(), the value is appended to the vector.

Calls C++ function: void QVector<QPoint>::insert(int i, const QPoint& t).

C++ documentation:

Inserts value at index position i in the vector. If i is 0, the value is prepended to the vector. If i is size(), the value is appended to the vector.

Example:

QVector<QString> vector; vector << “alpha” << “beta” << “delta”; vector.insert(2, “gamma”); // vector: [“alpha”, “beta”, “gamma”, “delta”]

For large vectors, this operation can be slow (linear time), because it requires moving all the items at indexes i and above by one position further in memory. If you want a container class that provides a fast insert() function, use QLinkedList instead.

See also append(), prepend(), and remove().

source

pub unsafe fn insert_3a( &self, i: c_int, n: c_int, t: impl CastInto<Ref<QPoint>> )

This is an overloaded function.

Calls C++ function: void QVector<QPoint>::insert(int i, int n, const QPoint& t).

C++ documentation:

This is an overloaded function.

Inserts count copies of value at index position i in the vector.

Example:

QVector<double> vector; vector << 2.718 << 1.442 << 0.4342; vector.insert(1, 3, 9.9); // vector: [2.718, 9.9, 9.9, 9.9, 1.442, 0.4342]

source

pub unsafe fn is_detached(&self) -> bool

Calls C++ function: bool QVector<QPoint>::isDetached() const.

source

pub unsafe fn is_empty(&self) -> bool

Returns true if the vector has size 0; otherwise returns false.

Calls C++ function: bool QVector<QPoint>::isEmpty() const.

C++ documentation:

Returns true if the vector has size 0; otherwise returns false.

See also size() and resize().

source

pub unsafe fn is_shared_with( &self, other: impl CastInto<Ref<QVectorOfQPoint>> ) -> bool

Calls C++ function: bool QVector<QPoint>::isSharedWith(const QVector<QPoint>& other) const.

source

pub unsafe fn last_mut(&self) -> Ref<QPoint>

Returns a reference to the last item in the vector. This function assumes that the vector isn't empty.

Calls C++ function: QPoint& QVector<QPoint>::last().

C++ documentation:

Returns a reference to the last item in the vector. This function assumes that the vector isn’t empty.

See also first(), isEmpty(), and constLast().

source

pub unsafe fn last(&self) -> Ref<QPoint>

This is an overloaded function.

Calls C++ function: const QPoint& QVector<QPoint>::last() const.

C++ documentation:

This is an overloaded function.

source

pub unsafe fn last_index_of_2a( &self, t: impl CastInto<Ref<QPoint>>, from: c_int ) -> c_int

Returns the index position of the last occurrence of the value value in the vector, searching backward from index position from. If from is -1 (the default), the search starts at the last item. Returns -1 if no item matched.

Calls C++ function: int QVector<QPoint>::lastIndexOf(const QPoint& t, int from = …) const.

C++ documentation:

Returns the index position of the last occurrence of the value value in the vector, searching backward from index position from. If from is -1 (the default), the search starts at the last item. Returns -1 if no item matched.

Example:

QList<QString> vector; vector << “A” << “B” << “C” << “B” << “A”; vector.lastIndexOf(“B”); // returns 3 vector.lastIndexOf(“B”, 3); // returns 3 vector.lastIndexOf(“B”, 2); // returns 1 vector.lastIndexOf(“X”); // returns -1

This function requires the value type to have an implementation of operator==().

See also indexOf().

source

pub unsafe fn last_index_of_1a(&self, t: impl CastInto<Ref<QPoint>>) -> c_int

Returns the index position of the last occurrence of the value value in the vector, searching backward from index position from. If from is -1 (the default), the search starts at the last item. Returns -1 if no item matched.

Calls C++ function: int QVector<QPoint>::lastIndexOf(const QPoint& t) const.

C++ documentation:

Returns the index position of the last occurrence of the value value in the vector, searching backward from index position from. If from is -1 (the default), the search starts at the last item. Returns -1 if no item matched.

Example:

QList<QString> vector; vector << “A” << “B” << “C” << “B” << “A”; vector.lastIndexOf(“B”); // returns 3 vector.lastIndexOf(“B”, 3); // returns 3 vector.lastIndexOf(“B”, 2); // returns 1 vector.lastIndexOf(“X”); // returns -1

This function requires the value type to have an implementation of operator==().

See also indexOf().

source

pub unsafe fn length(&self) -> c_int

Same as size() and count().

Calls C++ function: int QVector<QPoint>::length() const.

C++ documentation:

Same as size() and count().

Provided for compatibility with QList.

This function was introduced in Qt 5.2.

See also size(), count(), and QList::length().

source

pub unsafe fn mid_2a(&self, pos: c_int, len: c_int) -> CppBox<QVectorOfQPoint>

Returns a sub-vector which contains elements from this vector, starting at position pos. If length is -1 (the default), all elements after pos are included; otherwise length elements (or all remaining elements if there are less than length elements) are included.

Calls C++ function: QVector<QPoint> QVector<QPoint>::mid(int pos, int len = …) const.

C++ documentation:

Returns a sub-vector which contains elements from this vector, starting at position pos. If length is -1 (the default), all elements after pos are included; otherwise length elements (or all remaining elements if there are less than length elements) are included.

source

pub unsafe fn mid_1a(&self, pos: c_int) -> CppBox<QVectorOfQPoint>

Returns a sub-vector which contains elements from this vector, starting at position pos. If length is -1 (the default), all elements after pos are included; otherwise length elements (or all remaining elements if there are less than length elements) are included.

Calls C++ function: QVector<QPoint> QVector<QPoint>::mid(int pos) const.

C++ documentation:

Returns a sub-vector which contains elements from this vector, starting at position pos. If length is -1 (the default), all elements after pos are included; otherwise length elements (or all remaining elements if there are less than length elements) are included.

source

pub unsafe fn move_(&self, from: c_int, to: c_int)

Moves the item at index position from to index position to.

Calls C++ function: void QVector<QPoint>::move(int from, int to).

C++ documentation:

Moves the item at index position from to index position to.

Provided for compatibility with QList.

This function was introduced in Qt 5.6.

See also QList::move().

source

pub unsafe fn pop_back(&self)

This function is provided for STL compatibility. It is equivalent to removeLast().

Calls C++ function: void QVector<QPoint>::pop_back().

C++ documentation:

This function is provided for STL compatibility. It is equivalent to removeLast().

source

pub unsafe fn pop_front(&self)

This function is provided for STL compatibility. It is equivalent to removeFirst().

Calls C++ function: void QVector<QPoint>::pop_front().

C++ documentation:

This function is provided for STL compatibility. It is equivalent to removeFirst().

source

pub unsafe fn prepend(&self, t: impl CastInto<Ref<QPoint>>)

Inserts value at the beginning of the vector.

Calls C++ function: void QVector<QPoint>::prepend(const QPoint& t).

C++ documentation:

Inserts value at the beginning of the vector.

Example:

QVector<QString> vector; vector.prepend(“one”); vector.prepend(“two”); vector.prepend(“three”); // vector: [“three”, “two”, “one”]

This is the same as vector.insert(0, value).

For large vectors, this operation can be slow (linear time), because it requires moving all the items in the vector by one position further in memory. If you want a container class that provides a fast prepend() function, use QList or QLinkedList instead.

See also append() and insert().

source

pub unsafe fn push_back(&self, t: impl CastInto<Ref<QPoint>>)

This function is provided for STL compatibility. It is equivalent to append(value).

Calls C++ function: void QVector<QPoint>::push_back(const QPoint& t).

C++ documentation:

This function is provided for STL compatibility. It is equivalent to append(value).

source

pub unsafe fn push_front(&self, t: impl CastInto<Ref<QPoint>>)

This function is provided for STL compatibility. It is equivalent to prepend(value).

Calls C++ function: void QVector<QPoint>::push_front(const QPoint& t).

C++ documentation:

This function is provided for STL compatibility. It is equivalent to prepend(value).

source

pub unsafe fn remove_1a(&self, i: c_int)

This is an overloaded function.

Calls C++ function: void QVector<QPoint>::remove(int i).

C++ documentation:

This is an overloaded function.

Removes the element at index position i.

See also insert(), replace(), and fill().

source

pub unsafe fn remove_2a(&self, i: c_int, n: c_int)

This is an overloaded function.

Calls C++ function: void QVector<QPoint>::remove(int i, int n).

C++ documentation:

This is an overloaded function.

Removes count elements from the middle of the vector, starting at index position i.

See also insert(), replace(), and fill().

source

pub unsafe fn remove_all(&self, t: impl CastInto<Ref<QPoint>>) -> c_int

Removes all elements that compare equal to t from the vector. Returns the number of elements removed, if any.

Calls C++ function: int QVector<QPoint>::removeAll(const QPoint& t).

C++ documentation:

Removes all elements that compare equal to t from the vector. Returns the number of elements removed, if any.

Provided for compatibility with QList.

This function was introduced in Qt 5.4.

See also removeOne() and QList::removeAll().

source

pub unsafe fn remove_at(&self, i: c_int)

Removes the element at index position i. Equivalent to

Calls C++ function: void QVector<QPoint>::removeAt(int i).

C++ documentation:

Removes the element at index position i. Equivalent to


  remove(i);

Provided for compatibility with QList.

This function was introduced in Qt 5.2.

See also remove() and QList::removeAt().

source

pub unsafe fn remove_first(&self)

Removes the first item in the vector. Calling this function is equivalent to calling remove(0). The vector must not be empty. If the vector can be empty, call isEmpty() before calling this function.

Calls C++ function: void QVector<QPoint>::removeFirst().

C++ documentation:

Removes the first item in the vector. Calling this function is equivalent to calling remove(0). The vector must not be empty. If the vector can be empty, call isEmpty() before calling this function.

This function was introduced in Qt 5.1.

See also remove(), takeFirst(), and isEmpty().

source

pub unsafe fn remove_last(&self)

Removes the last item in the vector. Calling this function is equivalent to calling remove(size() - 1). The vector must not be empty. If the vector can be empty, call isEmpty() before calling this function.

Calls C++ function: void QVector<QPoint>::removeLast().

C++ documentation:

Removes the last item in the vector. Calling this function is equivalent to calling remove(size() - 1). The vector must not be empty. If the vector can be empty, call isEmpty() before calling this function.

This function was introduced in Qt 5.1.

See also remove(), takeLast(), removeFirst(), and isEmpty().

source

pub unsafe fn remove_one(&self, t: impl CastInto<Ref<QPoint>>) -> bool

Removes the first element that compares equal to t from the vector. Returns whether an element was, in fact, removed.

Calls C++ function: bool QVector<QPoint>::removeOne(const QPoint& t).

C++ documentation:

Removes the first element that compares equal to t from the vector. Returns whether an element was, in fact, removed.

Provided for compatibility with QList.

This function was introduced in Qt 5.4.

See also removeAll() and QList::removeOne().

source

pub unsafe fn replace(&self, i: c_int, t: impl CastInto<Ref<QPoint>>)

Replaces the item at index position i with value.

Calls C++ function: void QVector<QPoint>::replace(int i, const QPoint& t).

C++ documentation:

Replaces the item at index position i with value.

i must be a valid index position in the vector (i.e., 0 <= i < size()).

See also operator[]() and remove().

source

pub unsafe fn reserve(&self, size: c_int)

Attempts to allocate memory for at least size elements. If you know in advance how large the vector will be, you should call this function to prevent reallocations and memory fragmentation.

Calls C++ function: void QVector<QPoint>::reserve(int size).

C++ documentation:

Attempts to allocate memory for at least size elements. If you know in advance how large the vector will be, you should call this function to prevent reallocations and memory fragmentation.

If size is an underestimate, the worst that will happen is that the QVector will be a bit slower. If size is an overestimate, you may have used more memory than the normal QVector growth strategy would have allocated—or you may have used less.

An alternative to reserve() is calling resize(). Whether or not that is faster than reserve() depends on the element type, because resize() default-constructs all elements, and requires assignment to existing entries rather than calling append(), which copy- or move-constructs. For simple types, like int or double, resize() is typically faster, but for anything more complex, you should prefer reserve().

Warning: If the size passed to resize() was underestimated, you run out of allocated space and into undefined behavior. This problem does not exist with reserve(), because it treats the size as just a hint.

See also squeeze() and capacity().

source

pub unsafe fn resize(&self, size: c_int)

Sets the size of the vector to size. If size is greater than the current size, elements are added to the end; the new elements are initialized with a default-constructed value. If size is less than the current size, elements are removed from the end.

Calls C++ function: void QVector<QPoint>::resize(int size).

C++ documentation:

Sets the size of the vector to size. If size is greater than the current size, elements are added to the end; the new elements are initialized with a default-constructed value. If size is less than the current size, elements are removed from the end.

Since Qt 5.6, resize() doesn't shrink the capacity anymore. To shed excess capacity, use squeeze().

See also size().

source

pub unsafe fn set_sharable(&self, sharable: bool)

Calls C++ function: void QVector<QPoint>::setSharable(bool sharable).

source

pub unsafe fn shrink_to_fit(&self)

Available on cpp_lib_version="5.11.3" or cpp_lib_version="5.12.2" or cpp_lib_version="5.13.0" or cpp_lib_version="5.14.0" only.

This function is provided for STL compatibility. It is equivalent to squeeze().

Calls C++ function: void QVector<QPoint>::shrink_to_fit().

C++ documentation:

This function is provided for STL compatibility. It is equivalent to squeeze().

This function was introduced in Qt 5.10.

source

pub unsafe fn size(&self) -> c_int

Returns the number of items in the vector.

Calls C++ function: int QVector<QPoint>::size() const.

C++ documentation:

Returns the number of items in the vector.

See also isEmpty() and resize().

source

pub unsafe fn squeeze(&self)

Releases any memory not required to store the items.

Calls C++ function: void QVector<QPoint>::squeeze().

C++ documentation:

Releases any memory not required to store the items.

The sole purpose of this function is to provide a means of fine tuning QVector's memory usage. In general, you will rarely ever need to call this function.

See also reserve() and capacity().

source

pub unsafe fn starts_with(&self, t: impl CastInto<Ref<QPoint>>) -> bool

Returns true if this vector is not empty and its first item is equal to value; otherwise returns false.

Calls C++ function: bool QVector<QPoint>::startsWith(const QPoint& t) const.

C++ documentation:

Returns true if this vector is not empty and its first item is equal to value; otherwise returns false.

This function was introduced in Qt 4.5.

See also isEmpty() and first().

source

pub unsafe fn swap(&self, other: impl CastInto<Ref<QVectorOfQPoint>>)

Swaps vector other with this vector. This operation is very fast and never fails.

Calls C++ function: void QVector<QPoint>::swap(QVector<QPoint>& other).

C++ documentation:

Swaps vector other with this vector. This operation is very fast and never fails.

This function was introduced in Qt 4.8.

source

pub unsafe fn swap_items_at(&self, i: c_int, j: c_int)

Available on cpp_lib_version="5.14.0" only.

Exchange the item at index position i with the item at index position j. This function assumes that both i and j are at least 0 but less than size(). To avoid failure, test that both i and j are at least 0 and less than size().

Calls C++ function: void QVector<QPoint>::swapItemsAt(int i, int j).

C++ documentation:

Exchange the item at index position i with the item at index position j. This function assumes that both i and j are at least 0 but less than size(). To avoid failure, test that both i and j are at least 0 and less than size().

This function was introduced in Qt 5.14.

source

pub unsafe fn take_at(&self, i: c_int) -> CppBox<QPoint>

Removes the element at index position i and returns it.

Calls C++ function: QPoint QVector<QPoint>::takeAt(int i).

C++ documentation:

Removes the element at index position i and returns it.

Equivalent to

T t = at(i); remove(i); return t;

Provided for compatibility with QList.

This function was introduced in Qt 5.2.

See also takeFirst(), takeLast(), and QList::takeAt().

source

pub unsafe fn take_first(&self) -> CppBox<QPoint>

Removes the first item in the vector and returns it. This function assumes the vector is not empty. To avoid failure, call isEmpty() before calling this function.

Calls C++ function: QPoint QVector<QPoint>::takeFirst().

C++ documentation:

Removes the first item in the vector and returns it. This function assumes the vector is not empty. To avoid failure, call isEmpty() before calling this function.

This function was introduced in Qt 5.1.

See also takeLast() and removeFirst().

source

pub unsafe fn take_last(&self) -> CppBox<QPoint>

Removes the last item in the list and returns it. This function assumes the vector is not empty. To avoid failure, call isEmpty() before calling this function.

Calls C++ function: QPoint QVector<QPoint>::takeLast().

C++ documentation:

Removes the last item in the list and returns it. This function assumes the vector is not empty. To avoid failure, call isEmpty() before calling this function.

If you don't use the return value, removeLast() is more efficient.

This function was introduced in Qt 5.1.

See also takeFirst() and removeLast().

source

pub unsafe fn value_1a(&self, i: c_int) -> CppBox<QPoint>

Returns the value at index position i in the vector.

Calls C++ function: QPoint QVector<QPoint>::value(int i) const.

C++ documentation:

Returns the value at index position i in the vector.

If the index i is out of bounds, the function returns a default-constructed value. If you are certain that i is within bounds, you can use at() instead, which is slightly faster.

See also at() and operator[]().

source

pub unsafe fn value_2a( &self, i: c_int, default_value: impl CastInto<Ref<QPoint>> ) -> CppBox<QPoint>

This is an overloaded function.

Calls C++ function: QPoint QVector<QPoint>::value(int i, const QPoint& defaultValue) const.

C++ documentation:

This is an overloaded function.

If the index i is out of bounds, the function returns defaultValue.

Trait Implementations§

source§

impl CppDeletable for QPolygon

source§

unsafe fn delete(&self)

Destroys the polygon.

Calls C++ function: [destructor] void QPolygon::~QPolygon().

C++ documentation:

Destroys the polygon.

source§

impl Deref for QPolygon

source§

fn deref(&self) -> &QVectorOfQPoint

Calls C++ function: QVector<QPoint>* static_cast<QVector<QPoint>*>(QPolygon* ptr).

§

type Target = QVectorOfQPoint

The resulting type after dereferencing.
source§

impl Mul<Ref<QMatrix>> for &QPolygon

source§

fn mul(self, m: Ref<QMatrix>) -> CppBox<QPolygon>

Calls C++ function: QPolygon operator*(const QPolygon& a, const QMatrix& m).

§

type Output = CppBox<QPolygon>

The resulting type after applying the * operator.
source§

impl Mul<Ref<QTransform>> for &QPolygon

source§

fn mul(self, m: Ref<QTransform>) -> CppBox<QPolygon>

Calls C++ function: QPolygon operator*(const QPolygon& a, const QTransform& m).

§

type Output = CppBox<QPolygon>

The resulting type after applying the * operator.
source§

impl StaticDowncast<QPolygon> for QVectorOfQPoint

source§

unsafe fn static_downcast(ptr: Ptr<QVectorOfQPoint>) -> Ptr<QPolygon>

Calls C++ function: QPolygon* static_cast<QPolygon*>(QVector<QPoint>* ptr).

source§

impl StaticUpcast<QVectorOfQPoint> for QPolygon

source§

unsafe fn static_upcast(ptr: Ptr<QPolygon>) -> Ptr<QVectorOfQPoint>

Calls C++ function: QVector<QPoint>* static_cast<QVector<QPoint>*>(QPolygon* ptr).

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T, U> CastInto<U> for T
where U: CastFrom<T>,

source§

unsafe fn cast_into(self) -> U

Performs the conversion. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> StaticUpcast<T> for T

source§

unsafe fn static_upcast(ptr: Ptr<T>) -> Ptr<T>

Convert type of a const pointer. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.