MapRectangle QML Type

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

• 継承されたメンバを含むすべてのメンバの一覧
• 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 の点が必要で、どちらも座標で与えられます。

デフ ォル ト では、 矩形は透過塗 り と 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 の左上座標を保持し、経度、緯度、高度を取得するために使用できます。