MapPolygon QML Type

MapPolygonタイプは、Map上に多角形を表示します。詳細...

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

プロパティ

• 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 の順序付きリストで指定された多角形をMap上に表示します。最良の外観と結果を得るためには、多角形は単純（自己交差しない）であるべきです。

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

このプロパティは、ポリゴンを塗りつぶすために使用される色を保持します。

デフォルト値はtransparentです。

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も参照してください 。