MapPolyline QML Type

MapPolyline タイプは、地図上に折れ線を表示します。詳細...

• 継承されたメンバを含むすべてのメンバの一覧
• MapPolyline はQML Maps Plugin に含まれています。

プロパティ

• 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 型は、座標の順序付きリストで指定されたポリラインを地図上に表示する。

座標は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

このプロパティは line プロパティグループの一部です。line プロパティグループは、線を描画するために使用される幅と色を保持します。

幅はピクセル単位で、地図のズームレベルとは無関係です。デフォルト値は幅 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 がパスの一部であれば真を返します。

このメソッドは 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も参照のこと 。