Geolocator.StatusChanged Evento

Definição

Namespace:

Windows.Devices.Geolocation

Gerado quando a capacidade do geolocalizador para fornecer alterações de localização atualizadas.

// Register
event_token StatusChanged(TypedEventHandler<Geolocator, StatusChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void StatusChanged(event_token const* cookie) const;

// Revoke with event_revoker
Geolocator::StatusChanged_revoker StatusChanged(auto_revoke_t, TypedEventHandler<Geolocator, StatusChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<Geolocator,StatusChangedEventArgs> StatusChanged;

function onStatusChanged(eventArgs) { /* Your code */ }
geolocator.addEventListener("statuschanged", onStatusChanged);
geolocator.removeEventListener("statuschanged", onStatusChanged);
- or -
geolocator.onstatuschanged = onStatusChanged;

Public Custom Event StatusChanged As TypedEventHandler(Of Geolocator, StatusChangedEventArgs) 

Tipo de evento

TypedEventHandler<Geolocator,StatusChangedEventArgs>

Requisitos do Windows

Funcionalidades do aplicativo

location ID_CAP_LOCATION [Windows Phone]

Exemplos

Este exemplo de código demonstra como o evento StatusChanged é tratado. O objeto Geolocator dispara o evento StatusChanged para indicar que as configurações de localização do usuário foram alteradas. Esse evento passa o status correspondente por meio da propriedade status do do argumento (do tipo PositionStatus). Observe que esse método não é chamado do thread da interface do usuário e o objeto Dispatcher invoca as alterações da interface do usuário. Para obter mais informações, consulte Obter o local atual.

using Windows.UI.Core;
...
async private void OnStatusChanged(Geolocator sender, StatusChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        // Show the location setting message only if status is disabled.
        LocationDisabledMessage.Visibility = Visibility.Collapsed;

        switch (e.Status)
        {
            case PositionStatus.Ready:
                // Location platform is providing valid data.
                // notify user: Location platform is ready
                break;

            case PositionStatus.Initializing:
                // Location platform is attempting to acquire a fix. 
                // notify user: Location platform is attempting to obtain a position
                break;

            case PositionStatus.NoData:
                // Location platform could not obtain location data.
                // notify user: Not able to determine the location
                break;

            case PositionStatus.Disabled:
                // The permission to access location data is denied by the user or other policies.
                // notify user: Access to location is denied

                // Clear cached location data if any
                break;

            case PositionStatus.NotInitialized:
                // The location platform is not initialized. This indicates that the application 
                // has not made a request for location data.

                // notify user: No request for location is made yet
                break;

            case PositionStatus.NotAvailable:
                // The location platform is not available on this version of the OS.

                // notify user: Location is not available on this version of the OS
                break;

            default:
                // unknown result
                break;
        }
    });
}

Comentários

Você pode acessar informações sobre o evento com o objeto StatusChangedEventArgs que é passado para o manipulador de eventos.

Ao usar uma cerca geográfica, use o evento StatusChanged doGeofenceMonitor para monitorar alterações nas permissões de localização em vez desse evento da classe Geolocator. Um geofenceMonitorStatus desabi litado é equivalente a um DesabilitadoPositionStatus – ambos indicam que o aplicativo não tem permissão para acessar o local.

Confira também

• StatusChangedEventArgs
• Obter o local atual
• Obter o local atual
• configurar uma de cerca geográfica
• de exemplo de localização geográfica