Geolocator.StatusChanged Ereignis

Referenz

Definition

Namespace:: Windows.Devices.Geolocation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Wird ausgelöst, wenn die Möglichkeit des Geolocators , aktualisierte Speicherorte bereitzustellen, geändert wird.

// 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)

Ereignistyp

TypedEventHandler<Geolocator,StatusChangedEventArgs>

Windows-Anforderungen

App-Funktionen

location ID_CAP_LOCATION [Windows Phone]

Beispiele

In diesem Codebeispiel wird veranschaulicht, wie das StatusChanged-Ereignis behandelt wird. Das Geolocator-Objekt löst das StatusChanged-Ereignis aus, um anzugeben, dass sich die Standorteinstellungen des Benutzers geändert haben. Das Ereignis übergibt den entsprechenden Status über die Eigenschaft Status des Arguments (des Typs PositionStatus. Beachten Sie, dass diese Methode nicht vom UI-Thread aufgerufen wird und das Dispatcher-Objekt die UI-Änderungen aufruft. Weitere Informationen finden Sie unter Abrufen des aktuellen Standorts.

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;
        }
    });
}

Hinweise

Sie können mit dem StatusChangedEventArgs-Objekt , das an Ihren Ereignishandler übergeben wird, auf Informationen zum Ereignis zugreifen.

Wenn Sie einen Geofence verwenden, verwenden Sie das StatusChanged-Ereignis von GeofenceMonitor, um Änderungen an Standortberechtigungen zu überwachen, anstelle dieses Ereignisses aus der Geolocator-Klasse. Ein GeofenceMonitorStatus von Disabled entspricht einem DisabledPositionStatus . Beides gibt an, dass die App nicht über die Berechtigung für den Zugriff auf den Speicherort verfügt.

Gilt für: