MapPolyline QML Type

MapPolyline タイプは、地図上にポリラインを表示します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• MapPolyline はQML Maps プラグインの一部です。

プロパティ

• autoFadeIn : bool
• line
  • line.color : color
  • line.width : int
• path : list<coordinate>
• referenceSurface : enum (since 6.5)

方法

• void addCoordinate(coordinate)
• coordinate containsCoordinate(coordinate) (since QtLocation 5.6)
• coordinate coordinateAt(index) (since QtLocation 5.6)
• void insertCoordinate(index, coordinate) (since QtLocation 5.6)
• int pathLength() (since QtLocation 5.6)
• void removeCoordinate(coordinate)
• void removeCoordinate(index) (since QtLocation 5.6)
• void replaceCoordinate(index, coordinate) (since QtLocation 5.6)
• void setPath(geoPath path)

詳細な説明

MapPolyline タイプは、coordinates の順序付きリストとして指定されたポリラインを地図上に表示します。

座標は、addCoordinate およびremoveCoordinate メソッドを使用して、いつでも追加または削除できます。また、QML の他のリスト要素と同様に変更することも可能です:

mapPolyline.path[0].latitude = 5;

デフォルトでは、ポリラインは太さ1ピクセルの黒い線として表示されます。これは、line.width およびline.color プロパティを使用して変更できます。

使用例

以下のスニペットは、オーストラリアのブリスベン近郊で、「疑問符」（？）の上部のような形状を描く、4つのポイントを持つMapPolylineを示しています。描画される線の幅は3ピクセルで、色は緑色です。

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, longitude: 153.5 }
        ]
    }
}

プロパティのドキュメント

autoFadeIn : bool

このプロパティは、非常に低いズームレベルから地図を拡大した際に、アイテムが自動的にフェードインするかどうかを指定します。デフォルトでは、true です。このプロパティをfalse に設定すると、地図上のアイテムは常にQtQuick::Item::opacity プロパティで指定された不透明度（デフォルトは 1.0）で表示されます。

line group

このプロパティは、線プロパティグループの一部です。線プロパティグループには、線の描画に使用される幅と色が格納されています。

幅はピクセル単位で指定され、地図のズームレベルとは無関係です。デフォルト値は、幅1ピクセルの黒い枠線に相当します。

線を表示しない場合は、幅を 0 に設定するか、透明色を使用してください。

path : list<coordinate>

このプロパティには、ポリラインを定義する座標の順序付きリストが格納されています。

referenceSurface : enum [since 6.5]

このプロパティは、ポリラインの基準面を決定します。QLocation::ReferenceSurface::Map に設定すると、ポリラインの頂点は地図上で直線によって結ばれます。QLocation::ReferenceSurface::Globe に設定すると、頂点は大円経路に沿って結ばれ、球面上の2点を結ぶ最短経路が描写されます。デフォルト値はQLocation::ReferenceSurface::Map です。

このプロパティは Qt 6.5 で導入されました。

メソッドのドキュメント

void addCoordinate(coordinate)

指定されたcoordinate をパスの末尾に追加します。

「 insertCoordinate 」、「removeCoordinate 」、および「path 」も参照してください 。

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

指定されたcoordinate がパスに含まれている場合、trueを返します。

このメソッドは、QtLocation 5.6で導入されました。

[since QtLocation 5.6] coordinate coordinateAt(index)

指定されたindex におけるポリラインの座標を取得します。インデックスがパスの範囲外にある場合、無効な座標が返されます。

このメソッドはQtLocation 5.6で導入されました。

[since QtLocation 5.6] void insertCoordinate(index, coordinate)

指定されたindex にあるパスに、coordinate を挿入します。

このメソッドは QtLocation 5.6 で導入されました。

addCoordinate 、removeCoordinate 、およびpathも参照してください 。

[since QtLocation 5.6] int pathLength()

ポリラインの座標の数を返します。

このメソッドはQtLocation 5.6で導入されました。

pathも参照してください 。

void removeCoordinate(coordinate)

coordinate をパスから削除します。同じ座標が複数存在する場合、最後に追加されたものが削除されます。

coordinate がパスに含まれていない場合、このメソッドは何も行いません。

addCoordinate 、insertCoordinate 、およびpathも参照してください 。

[since QtLocation 5.6] void removeCoordinate(index)

指定されたindex の位置にある座標をパスから削除します。

index が無効な場合、このメソッドは何も行いません。

このメソッドは QtLocation 5.6 で導入されました。

addCoordinate 、insertCoordinate 、およびpathも参照してください 。

[since QtLocation 5.6] void replaceCoordinate(index, coordinate)

指定されたindex にある現在のパスの座標を、新しいcoordinate に置き換えます。

このメソッドは QtLocation 5.6 で導入されました。

addCoordinate 、insertCoordinate 、removeCoordinate 、およびpathも参照してください 。

void setPath(geoPath path)

geoPath 型を使用して、path を設定します。

「path」も参照してください 。