CoreWindow Classe

Définition

Espace de noms:

Windows.UI.Core

Représente l’application UWP avec des événements d’entrée et des comportements d’interface utilisateur de base.

public ref class CoreWindow sealed : ICorePointerRedirector, ICoreWindow

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class CoreWindow final : ICorePointerRedirector, ICoreWindow

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class CoreWindow : ICorePointerRedirector, ICoreWindow

Public NotInheritable Class CoreWindow
Implements ICorePointerRedirector, ICoreWindow

Héritage

Object Platform::Object IInspectable CoreWindow

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

ICoreWindow ICorePointerRedirector

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

Les nouvelles instances de cette classe sont obtenues en appelant CoreApplication.CreateNewView, puis en inspectant la propriété CoreWindow sur le instance CoreApplicationView retourné. Vous pouvez également obtenir des instances CoreWindow existantes pour une application en cours d’exécution à partir de la propriété CoreApplication.Views , ou en appelant CoreWindow.GetForCurrentThread, comme indiqué dans l’exemple suivant.

// App.cpp
...
// An implementation of IFrameworkView::Run.
void Run()
{
    CoreWindow window{ CoreWindow::GetForCurrentThread() };
    window.Activate();

    CoreDispatcher dispatcher{ window.Dispatcher() };
    dispatcher.ProcessEvents(CoreProcessEventsOption::ProcessUntilQuit);
}

// The CoreApplication::Run call indirectly calls the App::Run function above.
int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    CoreApplication::Run(App());
}

void MyCoreWindowEvents::Run() // this is an implementation of IFrameworkView::Run() used to show context
{
    CoreWindow::GetForCurrentThread()->Activate();

    /...

    CoreWindow::GetForCurrentThread()->Dispatcher->ProcessEvents(CoreProcessEventsOption::ProcessUntilQuit);
}

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX).

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1511	10586	PointerRoutedAway
1511	10586	PointerRoutedReleased
1511	10586	PointerRoutedTo
1607	14393	ClosestInteractiveBoundsRequested
1607	14393	GetCurrentKeyEventDeviceId
1703	15063	ResizeCompleted
1703	15063	RedimensionnementDémarré
1709	16299	ActivationMode
1709	16299	DispatcherQueue
1903	18362	UIContext

Propriétés

ActivationMode	Obtient une valeur qui indique l’état d’activation de la fenêtre.
AutomationHostProvider	Obtient le fournisseur d’automatisation affecté à cette fenêtre.
Bounds	Obtient une valeur Rect qui contient l’origine, la hauteur et la largeur de la zone cliente de la fenêtre, en pixels indépendants de l’appareil (DIPs).
CustomProperties	Obtient l’ensemble de propriétés personnalisées pour la fenêtre.
Dispatcher	Obtient le répartiteur d’événements pour la fenêtre.
DispatcherQueue	Obtient le DispatcherQueue de la fenêtre.
FlowDirection	Obtient ou définit l’origine horizontale de l’alignement de l’ordre de lecture de la fenêtre. Si la langue spécifiée par l’interface utilisateur est alignée à droite (par exemple, en arabe ou en hébreu), l’origine horizontale de la disposition de lecture de la fenêtre se trouve sur le bord droit.
IsInputEnabled	Obtient ou définit une valeur qui indique si l’entrée est activée pour l’application.
PointerCursor	Obtient ou définit le curseur de pointeur utilisé par l’application.
PointerPosition	Obtient les coordonnées client du pointeur.
UIContext	Obtient l’identificateur de contexte de la fenêtre principale.
Visible	Obtient une valeur qui indique si la fenêtre est visible.

Méthodes

Activate()	Active la fenêtre. Cette méthode est appelée pour présenter la fenêtre à l’écran.
Close()	Ferme une fenêtre secondaire et quitte la boucle du message.
GetAsyncKeyState(VirtualKey)	Récupère de manière asynchrone l’état d’une clé virtuelle.
GetCurrentKeyEventDeviceId()	Récupère l’ID unique de l’appareil d’entrée qui a généré cet événement clé. GetCurrentKeyEventDeviceId n’est pas pris en charge pour tous les appareils d’entrée.
GetForCurrentThread()	Obtient le instance CoreWindow pour le thread actif.
GetKeyState(VirtualKey)	Récupère l’état d’une clé virtuelle.
ReleasePointerCapture()	Dissocie l’entrée de pointeur de l’application, si elle est précédemment associée via SetPointerCapture, et restaure le traitement normal des entrées de pointeur.
SetPointerCapture()	Associe l’entrée de pointeur à l’application. Une fois qu’un pointeur est capturé, tous les événements suivants associés à ce pointeur sont déclenchés par l’application.

Événements

Activated	Est déclenché lorsque la fenêtre termine l’activation ou la désactivation.
AutomationProviderRequested	Est déclenché lorsqu’une demande pour un gestionnaire Automation est générée.
CharacterReceived	Est déclenché lorsqu’un nouveau caractère est reçu par la file d’attente d’entrée.
Closed	Se produit lorsqu’une fenêtre est fermée (ou que l’application se termine complètement).
ClosestInteractiveBoundsRequested	Notes Non destiné à une utilisation générale. Se produit lorsqu’un gestionnaire d’entrées d’infrastructure demande le rectangle englobant d’un élément interactif dans un rectangle englobant spécifique et le plus proche d’un pointeur spécifique.
InputEnabled	Se produit lorsque l’entrée est activée ou désactivée pour l’application.
KeyDown	Événement déclenché lorsqu’une touche non système est enfoncée. Le type de délégué pour cet événement est TypedEventHandler<TSender,TResult>, où TSender est de type CoreWindow et TResult est de type KeyEventArgs.
KeyUp	Événement déclenché lorsqu’une clé non système est relâchée après une pression. Le type de délégué pour cet événement est TypedEventHandler<TSender,TResult>, où TSender est de type CoreWindow et TResult est de type KeyEventArgs.
PointerCaptureLost	Se produit lorsqu’un pointeur se déplace vers une autre application. Cet événement est déclenché après PointerExited et est l’événement final reçu par l’application pour ce pointeur.
PointerEntered	Se produit lorsqu’un pointeur se déplace dans le cadre englobant de l’application.
PointerExited	Se produit lorsque le pointeur se déplace en dehors de la zone englobante de l’application.
PointerMoved	Se produit lorsqu’un pointeur se déplace dans le cadre englobant de l’application.
PointerPressed	Se produit lorsque vous cliquez sur un bouton de la souris ou que la surface du numériseur a été touchée par un doigt ou un stylet, dans le rectangle englobant de l’application. Une session d’interaction démarre lorsqu’un contact unique est détecté et se termine lorsque ce contact et tous les contacts suivants de la même session ne sont plus détectés. Cet événement est déclenché pour le premier contact détecté dans la session d’interaction. Les détails de tous les autres pointeurs de contact simultanés sont exposés via un objet PointerPointProperties (obtenu en obtenant la propriété Properties à partir d’un objet PointerPoint ).
PointerReleased	Se produit lorsqu’un bouton appuyé de la souris est relâché ou qu’un contact tactile ou stylet est levé de la surface du numériseur, dans le rectangle englobant de l’application (ou à l’extérieur du rectangle englobant, si le pointeur est capturé).
PointerRoutedAway	Se produit sur l’objet d’entrée qui reçoit l’entrée de pointeur lorsque le pointeur est redirigé vers un autre objet d’entrée (éventuellement dans un processus distinct).
PointerRoutedReleased	Se produit sur tous les objets d’entrée jamais associés à un pointeur qui déclenche un événement CoreIndependentInputSource.PointerReleased sur un objet d’entrée.
PointerRoutedTo	Se produit lorsque l’entrée de pointeur capturée est précédemment remise à un autre objet, et qu’elle est remise à cet objet.
PointerWheelChanged	Événement déclenché lors de la rotation de la roulette de la souris. Le type de délégué pour cet événement est TypedEventHandler<TSender,TResult>, où TSender est de type CoreWindow et TResult est de type PointerEventArgs.
ResizeCompleted	Se produit lorsqu’un utilisateur termine le redimensionnement de la fenêtre.
ResizeStarted	Se produit lorsqu’un utilisateur commence à redimensionner la fenêtre.
SizeChanged	Se produit lorsque la taille de la fenêtre est modifiée.
TouchHitTesting	Se produit lorsqu’une zone de contact tactile croise le rectangle englobant (ou polygone) d’une fenêtre inscrite pour le test d’accès tactile.
VisibilityChanged	Est déclenché lorsque la visibilité de la fenêtre est modifiée.

Voir aussi

• CoreApplicationView
• CreateNewView(IFrameworkViewSource)
• Views
• Exemple d’effets d’image personnalisés Direct2D (Windows 10)