Partager via


CoreApplication Classe

Définition

Permet aux applications de gérer les modifications d’état, de gérer les fenêtres et de s’intégrer à diverses infrastructures d’interface utilisateur.

public ref class CoreApplication abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreApplication final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CoreApplication
Public Class CoreApplication
Héritage
Object Platform::Object IInspectable CoreApplication
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Le système crée cet objet en tant que singleton lorsqu’il exécute l’application. Il est exécuté en tant qu’Application Single-Threaded Apartment (ASTA). Les threads créés à partir du singleton de l’application, tels que le fournisseur d’affichage (vu dans l’exemple ci-dessous), doivent être attribués en tant qu’appartement multithread (MTAThread).

Cette API est prise en charge dans plateforme Windows universelle applications uniquement, à l’exception de la propriété Properties, qui est toujours disponible.

struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
public:
    IFrameworkView CreateView()
    {
        return *this;
    }
};

...

int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    Windows::ApplicationModel::Core::CoreApplication::Run(App());
}
ref class MyFrameworkViewSource : IFrameworkViewSource
{
public:
    virtual IFrameworkView^ CreateView()
    {
        return ref new MyFrameworkView();
    }
};

// ...

[Platform::MTAThread]
int main(Platform::Array<Platform::String^>^)
{
    auto frameworkViewSource = ref new MyFrameworkViewSource();
    Windows::ApplicationModel::Core::CoreApplication::Run(frameworkViewSource);
    return 0;
}
internal class ApplicationSource : IFrameworkViewSource
{
	public virtual IFrameworkView CreateView()
	{
		return new CoreApp();
	}
}

...

[MTAThread]
public static int Main()
{
	var appSource = new ApplicationSource();
	CoreApplication.Run(appSource);
	return 0;
}

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 BackgroundActivated
1607 14393 EnablePrelaunch
1607 14393 EnteredBackground
1607 14393 LeavingBackground
1709 16299 RequestRestartAsync
1709 16299 RequestRestartForUserAsync

Propriétés

Id

Obtient l’identificateur d’application relative au package pour le processus.

MainView

Obtient le instance CoreApplicationView main pour toutes les applications en cours d’exécution qui utilisent ce instance CoreApplication.

Properties

Obtient un jeu de propriétés que l’application et les infrastructures d’interface utilisateur peuvent utiliser pour stocker des informations pendant l’exécution du processus.

Views

Obtient toutes les vues de l’application.

Méthodes

CreateNewView()

Crée une vue pour l’application.

CreateNewView(IFrameworkViewSource)

Crée une vue pour l’application.

CreateNewView(String, String)

Crée une vue pour l’application.

DecrementApplicationUseCount()

Décrémente le nombre total d’instances d’application en cours d’exécution qui utilisent cette instance CoreApplication.

EnablePrelaunch(Boolean)

Activez ou désactivez la capacité du système d’exploitation à prélancer votre application.

Exit()

Arrête l’application.

GetCurrentView()

Obtient la vue correspondant au thread actuel.

IncrementApplicationUseCount()

Incrémente le nombre total d’instances d’application en cours d’exécution qui utilisent cette instance CoreApplication.

RequestRestartAsync(String)

Redémarrez l’application.

RequestRestartForUserAsync(User, String)

Redémarrez l’application dans le contexte d’un autre utilisateur.

Run(IFrameworkViewSource)

Exécute une fabrique de fournisseur d’affichage externe pour obtenir un fournisseur d’affichage.

RunWithActivationFactories(IGetActivationFactory)

Exécute une fabrique de type activable pour obtenir un type activable externe.

Événements

BackgroundActivated

Déclenché lorsque votre application est activée par un déclencheur d’arrière-plan.

EnteredBackground

Déclenché lorsque l’application entre dans l’état en cours d’exécution en arrière-plan.

Exiting

Se produit lorsque l’application s’arrête.

LeavingBackground

Déclenché juste avant que l’interface utilisateur de l’application ne devienne visible.

Resuming

Se produit lorsqu’une application reprend.

Suspending

Se produit lorsque l’application est en cours de suspension.

UnhandledErrorDetected

Se produit lorsqu’une erreur sous-jacente est routée vers le instance CoreApplication, dans le cadre de la logique de gestion des erreurs globale.

S’applique à

Voir aussi