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

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.