MapPolygon QML Type
MapPolygonタイプは、Map上に多角形を表示します。詳細...
| Import Statement: | import QtLocation 6.8 |
| Since: | QtLocation 5.5 |
- 継承されたメンバを含むすべてのメンバの一覧
- 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 の順序付きリストで指定します。最良の外観と結果を得るために、多角形は単純であるべきです（自己交差しない）。
ポリゴンに追加された後、パス上のcoordinates を直接変更することはできません。代わりに、path を var にコピーし、そのコピーを修正して、path に再割り当てしてください。
var path = mapPolygon.path; path[0].latitude = 5; mapPolygon.path = path;
座標はaddCoordinate とremoveCoordinate メソッドを使っていつでも追加・削除できます。
まっすぐな "辺（一方の辺の緯度が同じで、他方の辺の緯度も同じ）を持つ長方形を描画する場合、MapRectangle 型はよりシンプルな2点APIを提供します。
デフォルトでは、多角形は塗りつぶしのない1ピクセルの黒枠で表示されます。見た目を変更するには、color 、border.color 、border.width プロパティを使用します。
注意： MapPolygon は地理的なアイテムであるため、（MouseArea またはPointHandler を使用して）MapPolygon をドラッグすると、その頂点は地理座標空間で再計算されます。辺は同じ地理的長さ（頂点間の緯度と経度の差）を保持しますが、まっすぐなままです。異なる緯度へドラッグすると、見かけ上のアイテムの伸縮が起こる。
使用例
次のスニペットは、オーストラリアのブリスベン近郊に 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 プロパティグループの一部です。border プロパティグループは、ポリゴンの境界を描画するために使用される幅と色を保持します。
幅はピクセル単位で、地図のズームレベルとは無関係です。
デフォルト値は幅1ピクセルの黒枠に対応します。線を引かない場合は、幅 0 または透明色を使用します。
color : color |
このプロパティは多角形の塗りつぶしに使用される色を保持します。
デフォルト値は透明である。
path : list<coordinate> |
このプロパティは、多角形を定義する座標の順序付きリストを保持します。パス内の座標が3つ未満だと、未定義の動作になります。
addCoordinate およびremoveCoordinateも参照してください 。
referenceSurface : enum |
このプロパティはポリゴンの参照サーフェスを決定します。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も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
