MapRectangle QML Type

MapRectangle タイプは Map 上に長方形を表示します。詳細...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

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

プロパティ

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

詳細説明

MapRectangle 型は Map 上に矩形を表示します。矩形はちょうど4つの頂点と4つの "まっすぐな "辺を持つ多角形の特殊なケースです。この場合、"直線 "とは、左上の点が右上の点（上の辺）と同じ緯度を持ち、左下の点が右下の点（下の辺）と同じ緯度を持つことを意味します。同様に、左辺の点は同じ経度を持ち、右辺の点は同じ経度を持つ。

矩形を指定するには、topLeft とbottomRight の点が必要で、どちらもcoordinate で与えられる。

デフォルトでは、矩形は透明な塗りつぶしと1ピクセルの太さの黒枠で表示されます。これはcolor ・border.color ・border.width プロパティで変更できます。

注： MapPolygon タイプと同様に、MapRectangle は地理的アイテムであるため、MapRectangle をドラッグするとその頂点が地理座標空間で再計算されます。異なる緯度へドラッグするとアイテムの見かけ上の伸張が発生しますが、その辺はまっすぐなままです。

使用例

次のスニペットはオーストラリアのブリスベン近郊の (-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.color : color
border.width : int

このプロパティは 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 の左上座標を保持し、経度、緯度、高度を取得するために使用できます。

このプロパティは、Qt 6.5 で導入されました。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。