StatusChangedEventArgs Classe

Definizione

Spazio dei nomi:

Windows.Devices.Geolocation

Fornisce informazioni per l'evento StatusChanged .

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

Ereditarietà

Object Platform::Object IInspectable StatusChangedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	location ID_CAP_LOCATION [Windows Phone]

Esempio

In questo esempio di codice viene illustrato come viene gestito l'evento StatusChanged . L’oggetto Geolocator attiva l’evento StatusChanged per indicare che le impostazioni di posizione dell’utente sono cambiate. L’evento passa lo stato corrispondente tramite la proprietà Status dell’argomento (di tipo PositionStatus). Tieni presente che questo metodo non viene chiamato dal thread dell'interfaccia utente e che l'oggetto Dispatcher richiama le modifiche dell'interfaccia utente. Per altre info, vedi Ottenere la posizione corrente.

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

Commenti

Questo oggetto è l'argomento passato al gestore per l'evento StatusChanged .

Proprietà

Status

Stato aggiornato dell'oggetto Geolocator .

Vedi anche

• Esempio di georilevazione (Windows 10)