MapRectangle QML Type

MapRectangle 型は、マップ上に長方形を表示します。詳細...

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

プロパティ

• autoFadeIn : bool
• border
  • border.color : color
  • border.width : int
• bottomRight : coordinate
• color : color
• opacity : real
• referenceSurface : enum (since 6.5)
• topLeft : coordinate

詳細な説明

MapRectangle 型は、マップ上に長方形を表示します。長方形は、頂点が正確に 4 つで、4 本の「直線」のエッジを持つ Polygon の特殊なケースです。 この場合、「直線」とは、左上の点が右上の点（上辺）と同じ緯度であり、左下の点が右下の点（下辺）と同じ緯度であることを意味します。 同様に、左側の点はすべて同じ経度を持ち、右側の点はすべて同じ経度を持ちます。

この矩形を指定するには、topLeft およびbottomRight の座標が必要であり、いずれもgeoCoordinate で指定されます。

デフォルトでは、矩形は透明な塗りつぶしと、1ピクセル幅の黒い枠線で表示されます。これは、color 、border.color 、およびborder.width プロパティを使用して変更できます。

使用例

以下のスニペットは、オーストラリアのブリスベン近郊の (-27, 153) から (-28, 153.5) までを範囲とする MapRectangle を含む地図を示しています。この矩形は緑色で塗りつぶされ、2 ピクセルの黒い枠線が付けられています。

Map {
    MapRectangle {
        color: 'green'
        border.width: 2
        topLeft {
            latitude: -27
            longitude: 153
        }
        bottomRight {
            latitude: -28
            longitude: 153.5
        }
    }
}

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

autoFadeIn : bool

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

border group

このプロパティは、border プロパティグループの一部です。border プロパティグループには、矩形の境界線を描画するために使用される幅と色が定義されています。幅はピクセル単位で指定され、地図のズームレベルには依存しません。

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

bottomRight : coordinate

このプロパティには、MapRectangle の右下座標が格納されており、これを使用してその経度、緯度、高度を取得することができます。

color : color

このプロパティは、長方形の塗りつぶし色を指定します。塗りつぶしをしない場合は、透明な色を使用してください。

opacity : real

このプロパティは、アイテムの不透明度を保持します。不透明度は、0（完全に透明）から1（完全に不透明）までの数値で指定されます。デフォルト値は1です。

不透明度が 0 のアイテムでも、マウスイベントは引き続き受信されます。マウスイベントを停止するには、アイテムの visible プロパティを false に設定してください。

referenceSurface : enum [since 6.5]

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

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

topLeft : coordinate

このプロパティには、MapRectangle の左上座標が格納されており、これを使用してその経度、緯度、高度を取得することができます。