QPainterPath::contains - Docs too brief
-
@bool QPainterPath::contains ( const QRectF & rectangle ) const
Returns true if the given rectangle is inside the path, otherwise returns false.@
Does it mean completely contained? Partially contained? All corners contained? All lines contained?
-
Judging from other places (QRectF), it's probably something like "more or less completely contained". It's usually hard to say for sure when dealing with floating point numbers.
-
Ok, I know about the limitations concerning whether edges are included or not.
But for example, if I have a painter path in form of a pac man (circle with open triangular mouth), and a rectangle which is completely inside the pac man's bounding rectangle, but partially visible in the mouth - is that rectangle considered "contained"? -
That is a quite specific use case. You can test, and maybe update the documentation with your findings (or file a bug report for that).
-
It's just an example to illustrate that the word "contained" alone is not as clear as one would hope.
I wouldn't dare to update the documentation based on some trial and error. The docs need to describe how the method is expected to perform (and any deviation from that is then a good basis for a bug report).
