QGeoPath Class
QGeoPath クラスは地理パスを定義します。詳細...
| Header: | #include <QGeoPath> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Inherits: | QGeoShape |
プロパティ
パブリック関数
| QGeoPath() | |
| QGeoPath(const QGeoShape &other) | |
| QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0) | |
| QGeoPath(const QGeoPath &other) | |
| ~QGeoPath() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | clearPath() |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
| const QList<QGeoCoordinate> & | path() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| void | setPath(const QList<QGeoCoordinate> &path) |
| void | setWidth(const qreal &width) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPath | translated(double degreesLatitude, double degreesLongitude) const |
| qreal | width() const |
| QGeoPath & | operator=(const QGeoPath &other) |
詳細説明
パスは、QGeoCoordinate オブジェクトの順序付きリストによって定義されます。
パス内の隣接する各2つの要素は、両要素を通る一定の方位の最短線分によって接続されることを意図している。このタイプの接続は、長手方向には日付変更線を横切ることができるが、極を横切ることはない。
これは、この形状に対してQGeoShape::boundingGeoRectangle() が返すバウンディングボックスの計算に関連しており、左上隅の緯度はパスポイントセット内の最大緯度に設定されます。同様に、右下隅の緯度はパス点集合の最小緯度となる。
このクラスはQ_GADGET です。C++ や QML から直接使用することができます。
QGeoPath は、座標を含んでいなければ無効であり、また空でもあります。
注： デフォルトで構築された QGeoPath は、座標を含まないため、無効でもあり空でもある。
プロパティ Documentation
path : const QVariantList
このプロパティは、ジオパスの座標のリストを保持します。
注： 座標をその場で処理することはできません。このプロパティの値を変更するには、座標の完全なリストを取得し、それらを処理し、新しい値をプロパティに割り当てます。
width : qreal
このプロパティは、パスの幅をメートル単位で保持します。
関数にアクセスします：
| qreal | width() const |
| void | setWidth(const qreal &width) |
メンバー関数ドキュメント
QGeoPath::QGeoPath()
新しい空のジオパスを構築します。
QGeoPath::QGeoPath(const QGeoShape &other)
other の内容から新しいジオパスを構築する。
QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)
座標のリスト (path およびwidth) から新しいジオパスを構築する。
QGeoPath::QGeoPath(const QGeoPath &other)
other の内容から新しいジオ パスを構築します。
[noexcept] QGeoPath::~QGeoPath()
このパスを破棄する。
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
coordinate をパスに追加する。
注： この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
void QGeoPath::clearPath()
パスをクリアします。
[invokable] bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const
パスが要素の一つとしてcoordinate を含む場合、true を返します。
注： この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QGeoCoordinate QGeoPath::coordinateAt(qsizetype index) const
index における座標を返します。
注： この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QGeoPath::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
指定されたindex にcoordinate を挿入します。
注： この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] double QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
要素indexFrom から要素indexTo までのパスの長さをメートル単位で返します。この長さは、隣接する点の各ペアの最短距離の合計になるように意図されています。
indexTo が -1 （デ フ ォ ル ト 値） の と き は、 長 さ は、 最後の座標 と 最初の座標 と の間の距離を含む （閉ループ）。パスの長さを取得するには、indexFrom には 0 を、indexTo にはQGeoPath::size() - 1 を使用します。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
const QList<QGeoCoordinate> &QGeoPath::path() const
パスのすべての要素を返します。
setPath()も参照してください 。
[invokable] void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)
パスから最後に出現したcoordinate を削除します。
注意： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QGeoPath::removeCoordinate(qsizetype index)
index の位置にある要素をパスから削除します。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] void QGeoPath::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
指定されたindex にあるパス要素をcoordinate で置き換えます。
注： この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
void QGeoPath::setPath(const QList<QGeoCoordinate> &path)
path のすべての要素を設定します。
path()も参照してください 。
[invokable] qsizetype QGeoPath::size() const
パスの要素数を返す。
注意： この関数はメタオブジェクトシステム経由でもQMLからも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QString QGeoPath::toString() const
ジオパスのプロパティを文字列として返します。
注意： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照。
[invokable] void QGeoPath::translate(double degreesLatitude, double degreesLongitude)
このジオパスをdegreesLatitude 北方向とdegreesLongitude 東方向に変換します。
degreesLatitude とdegreesLongitude の負の値は、それぞれ南方向と西方向への変換に対応します。
注意： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const
degreesLatitude を北へ、degreesLongitude を東へ変換したジオパスのコピーを返します。
degreesLatitude とdegreesLongitude の負の値は、それぞれ南方向と西方向への変換に対応します。
注意: この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
translate()も参照してください 。
qreal QGeoPath::width() const
パスの幅をメートル単位で返します。この情報はcontains メソッドで使用されます。デフォルト値は 0 です。
注釈 width プロパティのゲッター関数。
setWidth()も参照してください 。
QGeoPath &QGeoPath::operator=(const QGeoPath &other)
このジオパスにother を割り当て、このジオパスへの参照を返します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
