StatusChangedEventArgs Klasse

Definition

Namespace:

Windows.Devices.Geolocation

Stellt Informationen für das StatusChanged-Ereignis bereit .

public ref class StatusChangedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class StatusChangedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class StatusChangedEventArgs

Public NotInheritable Class StatusChangedEventArgs

Vererbung

Object Platform::Object IInspectable StatusChangedEventArgs

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
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 case
                break;
        }
    });
}

Hinweise

Dieses Objekt ist das Argument, das an den Handler für das StatusChanged-Ereignis übergeben wird .

Eigenschaften

Status

Die aktualisierte status des Geolocator-Objekts.

Weitere Informationen

• Geolocationbeispiel (Windows 10)