MapPolygon QML Type

MapPolygon 型は、マップ上にポリゴンを表示します。詳細...

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

プロパティ

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

方法

• void addCoordinate(coordinate)
• void removeCoordinate(coordinate)

詳細な説明

MapPolygon 型は、coordinates の順序付きリストとして指定されたポリゴンをマップ上に表示します。最適な表示と結果を得るためには、ポリゴンは単純なもの（自己交差しないもの）である必要があります。

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

mapPolygon.path[0].latitude = 5;

「直線」の辺（一辺の緯度がすべて同じ、もう一辺の緯度もすべて同じ）を持つ長方形を描画する場合、MapRectangle 型はよりシンプルな 2 点 API を提供します。

デフォルトでは、ポリゴンは塗りつぶしなしで、1ピクセルの黒い枠線で表示されます。外観を変更するには、color 、border.color 、およびborder.width プロパティを使用します。

使用例

以下のスニペットは、オーストラリアのブリスベン付近に 3 つの頂点を持つ三角形を表示するために MapPolygon を使用している例です。三角形は緑色で塗りつぶされ、1 ピクセルの黒い枠線が引かれています。

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 }
        ]
    }
}

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

autoFadeIn : bool

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

border group

このプロパティは、border プロパティグループの一部です。border プロパティグループには、ポリゴンの境界線を描画するために使用される幅と色が定義されています。

幅はピクセル単位で指定され、地図のズームレベルには依存しません。

デフォルト値は、幅 1 ピクセルの黒い境界線に相当します。線を表示しない場合は、幅を 0 にするか、透明色を使用してください。

color : color

このプロパティには、ポリゴンの塗りつぶしに使用する色が格納されます。

デフォルト値は透明です。

path : list<coordinate>

このプロパティには、ポリゴンを定義する座標の順序付きリストが格納されます。パスに含まれる異なる座標が3つ未満の場合、未定義の挙動が生じます。

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

referenceSurface : enum [since 6.5]

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

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

メソッドのドキュメント

void addCoordinate(coordinate)

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

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

void removeCoordinate(coordinate)

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

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

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