MapPolyline QML Type

El tipo MapPolyline muestra una polilínea en un mapa. Más...

• Lista de todos los miembros, incluyendo los heredados
• MapPolyline es parte de QML Maps Plugin.

Propiedades

• autoFadeIn : bool
• line
  • line.color : color
  • line.width : int
• path : list<coordinate>
• referenceSurface : enum (since 6.5)

Métodos

• void addCoordinate(coordinate)
• coordinate containsCoordinate(coordinate) (since QtLocation 5.6)
• coordinate coordinateAt(index) (since QtLocation 5.6)
• void insertCoordinate(index, coordinate) (since QtLocation 5.6)
• int pathLength() (since QtLocation 5.6)
• void removeCoordinate(coordinate)
• void removeCoordinate(index) (since QtLocation 5.6)
• void replaceCoordinate(index, coordinate) (since QtLocation 5.6)
• void setPath(geoPath path)

Descripción detallada

El tipo MapPolyline muestra una polilínea en un mapa, especificada en términos de una lista ordenada de coordenadas.

Las coordenadas pueden añadirse o eliminarse en cualquier momento mediante los métodos addCoordinate y removeCoordinate. También pueden modificarse como cualquier otro elemento de lista en QML:

mapPolyline.path[0].latitude = 5;

Por defecto, la polilínea se muestra como una línea negra de 1 píxel de grosor. Esto puede cambiarse utilizando las propiedades line.width y line.color.

Ejemplo de uso

El siguiente fragmento muestra una MapPolyline con 4 puntos, formando una figura como la parte superior de un "signo de interrogación" (?), cerca de Brisbane, Australia. La línea dibujada tiene 3 píxeles de ancho y es de color verde.

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, longitude: 153.5 }
        ]
    }
}

Documentación de propiedades

autoFadeIn : bool

Esta propiedad establece si el elemento se desvanece automáticamente al hacer zoom en el mapa a partir de niveles de zoom muy bajos. Por defecto es true. Establecer esta propiedad a false hace que el elemento del mapa tenga siempre la opacidad especificada con la propiedad QtQuick::Item::opacity, que por defecto es 1.0.

line group

Esta propiedad forma parte del grupo de propiedades de línea. El grupo de propiedades de línea contiene la anchura y el color utilizados para dibujar la línea.

La anchura se expresa en píxeles y es independiente del nivel de zoom del mapa. Los valores por defecto corresponden a un borde negro con una anchura de 1 píxel.

Para que no haya línea, utilice una anchura de 0 o un color transparente.

path : list<coordinate>

Esta propiedad contiene la lista ordenada de coordenadas que definen la polilínea.

referenceSurface : enum [since 6.5]

Esta propiedad determina la superficie de referencia de la polilínea. Si se establece en QLocation::ReferenceSurface::Map los vértices de las polilíneas se conectan con líneas rectas en el mapa. Si se establece en QLocation::ReferenceSurface::Globe, los vértices se conectan siguiendo el camino del gran círculo, que describe la conexión más corta de dos puntos en una esfera. El valor por defecto es QLocation::ReferenceSurface::Map.

Esta propiedad se introdujo en Qt 6.5.

Documentación del método

void addCoordinate(coordinate)

Añade el coordinate especificado al final de la ruta.

Véase también insertCoordinate, removeCoordinate, y path.

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

Devuelve true si el coordinate dado es parte de la ruta.

Este método se introdujo en QtLocation 5.6.

[since QtLocation 5.6] coordinate coordinateAt(index)

Obtiene la coordenada de la polilínea en la dirección index. Si el índice está fuera de los límites de la trayectoria, se devuelve una coordenada no válida.

Este método se introdujo en QtLocation 5.6.

[since QtLocation 5.6] void insertCoordinate(index, coordinate)

Inserta un coordinate a la ruta en el index dado.

Este método se introdujo en QtLocation 5.6.

Véase también addCoordinate, removeCoordinate, y path.

[since QtLocation 5.6] int pathLength()

Devuelve el número de coordenadas de la polilínea.

Este método se introdujo en QtLocation 5.6.

Véase también path.

void removeCoordinate(coordinate)

Elimina coordinate de la ruta. Si hay varias instancias de la misma coordenada, se elimina la que se haya añadido en último lugar.

Si coordinate no está en la ruta, este método no hace nada.

Véase también addCoordinate, insertCoordinate, y path.

[since QtLocation 5.6] void removeCoordinate(index)

Elimina una coordenada de la ruta en la dirección index.

Si index no es válido, este método no hace nada.

Este método fue introducido en QtLocation 5.6.

Ver también addCoordinate, insertCoordinate, y path.

[since QtLocation 5.6] void replaceCoordinate(index, coordinate)

Reemplaza la coordenada en la ruta actual en el index dado con el nuevo coordinate.

Este método se introdujo en QtLocation 5.6.

Véase también addCoordinate, insertCoordinate, removeCoordinate, y path.

void setPath(geoPath path)

Establece el path utilizando un tipo geoPath.

Véase también path.