CoreApplication Classe

Référence

Définition

Espace de noms:: Windows.ApplicationModel.Core

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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: ContractVersionAttribute MarshalingBehaviorAttribute

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 à

Partager via