StatusChanged | statuschanged-Ereignis

Geolocator.StatusChanged | statuschanged Event

Wird ausgelöst, wenn sich die Fähigkeit des Geolocator, aktualisierte Positionen bereitzustellen, ändert.

Syntax


function onStatusChanged(eventArgs) { /* Ihr Code */ }
 
// addEventListener syntax
geolocator.addEventListener("statuschanged", onStatusChanged);
geolocator.removeEventListener("statuschanged", onStatusChanged);
 
- or -

geolocator.onstatuschanged = onStatusChanged;


Ereignisinformationen

Delegat TypedEventHandler<Geolocator, StatusChangedEventArgs>

Hinweise

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

Wenn sich ein System im Verbindungsstandby befindet, können Geolocator-Objekte immer instanziiert werden, allerdings findet das Geolocator-Objekt keine Sensoren zum Aggregieren, und Aufrufe der GetGeopositionAsync-Methode führen zu einem Timeout nach 7 Sekunden, PositionChanged-Ereignislistener werden nie und StatusChanged-Ereignislistener lediglich einmal mit dem NoData-Status aufgerufen.

Beispiele

Das folgende Beispiel zeigt, wie das StatusChanged-Ereignis verarbeitet wird.



loc = new Windows.Devices.Geolocation.Geolocator();

// Add event handlers for the statuschanged event.
loc.addEventListener("statuschanged", onStatusChanged);

// Handler for statusChanged event.        
function onStatusChanged(args) {
    var newStatus = args.status;

    document.getElementById('geolocatorStatus').innerHTML =
            getStatusString(newStatus);
}

// display an appropriate error message
function getStatusString(locStatus) {

    switch (locStatus) {
        case Windows.Devices.Geolocation.PositionStatus.ready:
            // Location data is available
            return "Location is available.";
            break;

        case Windows.Devices.Geolocation.PositionStatus.initializing:
            // This status indicates that a GPS is still acquiring a fix
            return "A GPS device is still initializing.";
            break;

        case Windows.Devices.Geolocation.PositionStatus.noData:
            // No location data is currently available
            return "Data from location services is currently unavailable.";
            break;

        case Windows.Devices.Geolocation.PositionStatus.disabled:
            // The app doesn't have permission to access location,
            // either because location has been turned off.
            return "Your location is currently turned off. " +
                 "Change your settings through the Settings charm " +
                 " to turn it back on.";
            break;

         case Windows.Devices.Geolocation.PositionStatus.notInitialized:
            // This status indicates that the app has not yet requested
            // location data by calling GetGeolocationAsync() or
            // registering an event handler for the positionChanged event.
            return "Location status is not initialized because " +
                "the app has not requested location data.";
            break;

         case Windows.Devices.Geolocation.PositionStatus.notAvailable:
             // Location is not available on this version of Windows
             return "You do not have the required location services " +
                 "present on your system.";
             break;

         default:
             return "Unknown status";

    }
}

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Keine unterstützt

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

Windows.Devices.Geolocation
Windows::Devices::Geolocation [C++]

Metadaten

Windows.winmd

Capabilities

location
ID_CAP_LOCATION [Windows Phone]

Siehe auch

Geolocator
StatusChangedEventArgs

 

 

Anzeigen:
© 2017 Microsoft