geoRectangle QML Value Type

geoRectangle型は矩形の地理的領域を表す。詳細...

Import Statement: import QtPositioning

プロパティ

詳細説明

geoRectangle型は、長方形の地理的領域を表すgeoShape 。この型はQGeoRectangle の直接表現であり、矩形の左上隅と右下隅を表すcoordinates の組によって定義される。座標はtopLeftbottomRight 属性からアクセスできます。

長方形は、左上か右下の座標が無効か、左上の座標が右下の座標より南にある場合、無効とみなされます。

矩形の四隅の座標はtopLefttopRightbottomLeftbottomRight 属性でアクセスできます。center 属性は、矩形の中心の座標を得るのに使えます。widthheight 属性は、矩形の幅と高さを度単位で取得するのに使えます。これらの属性の一つを設定すると、他の属性もそれに応じて調整されます。

制限事項

ジオ矩形は決して極を横切ることはできません。

ジオ矩形の高さや中心が極を横切るように調整された場合、高さは矩形が極に接するが横切らないように修正され、中心座標は矩形の中心のままとなる。

使用例

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 が無効な場合、高さを設定することはできません。QtPositioning Qt 5.5 より前のリリースでは、無効な geoRectangles でも高さを設定することができました。


topLeft : geoCoordinate

このプロパティは、このgeoRectangle の左上座標を保持します。


topRight : geoCoordinate

このプロパティは、このgeoRectangle の右上座標を保持します。


width : double

このプロパティは、このgeoRectangle の幅を保持します(度単位)。詳細についてはQGeoRectangle::setWidth() を参照。

注: geoRectangle が無効な場合、幅を設定することはできません。QtPositioning Qt 5.5 より前のリリースでは、無効な geoRectangles でも幅を設定することができました。


© 2025 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.