GeoCoordinateWatcher.MovementThreshold Propriedade

Definição

Namespace:

System.Device.Location

Assembly:

System.Device.dll

A distância que deve ser percorrida, em metros, em relação à coordenada do último evento PositionChanged antes que o localizador gere outro evento PositionChanged.

public:
 property double MovementThreshold { double get(); void set(double value); };

public double MovementThreshold { get; set; }

member this.MovementThreshold : double with get, set

Public Property MovementThreshold As Double

Valor da propriedade

Double

Distância em metros.

Comentários

O limite de movimento padrão é zero, o que significa que qualquer alteração no local detectada pelo provedor de localização atual causa um PositionChanged evento e uma atualização na Position propriedade .

Observação

O limite de movimento não garante que os eventos serão recebidos no limite solicitado. A plataforma tenta atender às solicitações de um limite de movimento específico, mas, em alguns casos, os eventos não serão gerados no limite solicitado.

Nota Nas versões do Windows anteriores ao Windows 7, as seguintes condições se aplicam:

• Todos os System.Device.Location objetos que têm construtores podem ser criados, mas a Status propriedade sempre terá o valor Disabled.

• O local indicado pela Location propriedade de Position sempre será Unknown.

• Nenhum evento de local será gerado.

O diagrama a seguir representa as coordenadas de localização que o provedor de localização (por exemplo, um dispositivo GPS) fornece ao computador. P1, no diagrama, representa os dados de localização incluídos em um PositionChanged evento e P2, P3 e P4 representam pontos dentro do limite de movimento. Portanto, quando o provedor de localização fornece dados indicando um local nesses pontos (P1, P2, P3 e P4), nenhum PositionChanged evento é gerado e Position retorna P1. O ponto P5 está fora da MovementThreshold distância, portanto, nesse ponto, Position é atualizado e um PositionChanged evento é gerado.