geoRectangle QML Value Type
geoRectangle 型は、長方形の地理的領域を表します。詳細...
| Import Statement: | import QtPositioning |
プロパティ
- bottomLeft : geoCoordinate
- bottomRight : geoCoordinate
- center : geoCoordinate
- height : double
- topLeft : geoCoordinate
- topRight : geoCoordinate
- width : double
詳細な説明
geoRectangle 型は、長方形の地理的領域を表すgeoShape です。この型は、QGeoRectangle を直接表すものです。これは、長方形の左上隅と右下隅を表すcoordinates のペアによって定義されます。座標は、topLeft およびbottomRight 属性から取得できます。
左上または右下の座標が無効である場合、あるいは左上の座標が右下の座標よりも南側にある場合、その矩形は無効とみなされます。
矩形の4つの角の座標は、topLeft 、topRight 、bottomLeft 、およびbottomRight 属性から取得できます。center 属性を使用すると、矩形の中心の座標を取得できます。width およびheight 属性を使用すると、矩形の幅と高さを度単位で取得できます。これらの属性のいずれかを設定すると、他の属性もそれに応じて調整されます。
制限事項
geoRectangleは極点を通過することはできません。
geoRectangleの高さまたは中心が調整され、その結果、極のいずれかにまたがるような場合、高さは、長方形が極に接触はするがまたがらないように修正され、中心座標は引き続き長方形の中心に位置するよう調整されます。
使用例
geoRectangle 値を作成するには、QtPositioning.rectangle() 関数を使用します:
import QtPositioning
Item {
property geoRectangle region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1),
QtPositioning.coordinate(-27.6, 153.2))
}C++ と統合する場合、C++ から QML に渡されるQGeoRectangle 値は自動的に geoRectangle 値に変換され、その逆も同様であることに注意してください。
プロパティのドキュメント
bottomLeft : geoCoordinate
このプロパティは、このgeoRectangle の左下座標を保持しています。
bottomRight : geoCoordinate
このプロパティは、このgeoRectangle の右下の座標を保持しています。
center : geoCoordinate
このプロパティは、このgeoRectangle の中心座標を保持します。詳細については、QGeoRectangle::setCenter() を参照してください。
height : double
このプロパティは、このgeoRectangle の高さ(度単位)を保持します。詳細については、QGeoRectangle::setHeight() を参照してください。
注: geoRectangle が無効な場合 、高さを設定することはできません。Qt 5.5以前のQtPositioning では、無効な であっても高さを設定することが可能でした。
topLeft : geoCoordinate
このプロパティは、このgeoRectangle の左上座標を保持しています。
topRight : geoCoordinate
このプロパティは、このgeoRectangle の右上の座標を保持しています。
width : double
このプロパティは、このgeoRectangle の幅(度単位)を保持します。詳細については、QGeoRectangle::setWidth() を参照してください。
注: geoRectangle が無効な場合 、幅を設定することはできません。Qt 5.5以前のQtPositioning では、無効な であっても幅の設定が許可されていました。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.