CoreWindow Klasse

Definition

Namespace:

Windows.UI.Core

Stellt die UWP-App mit Eingabeereignissen und grundlegenden Verhalten der Benutzeroberfläche dar.

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

Vererbung

Object Platform::Object IInspectable CoreWindow

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

ICoreWindow ICorePointerRedirector

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Neue Instanzen dieser Klasse werden abgerufen, indem Sie CoreApplication.CreateNewView aufrufen und dann die CoreWindow-Eigenschaft für die zurückgegebene CoreApplicationView-instance überprüfen. Alternativ können Sie vorhandene CoreWindow-Instanzen für eine ausgeführte App aus der CoreApplication.Views-Eigenschaft oder durch Aufrufen von CoreWindow.GetForCurrentThread abrufen, wie im folgenden Beispiel gezeigt.

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

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX).

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1511	10586	PointerRoutedAway
1511	10586	PointerRoutedReleased
1511	10586	PointerRoutedTo
1607	14393	ClosestInteractiveBoundsRequested
1607	14393	GetCurrentKeyEventDeviceId
1703	15063	ResizeCompleted
1703	15063	ResizeStarted
1709	16299	ActivationMode
1709	16299	DispatcherQueue
1903	18362	UIContext

Eigenschaften

ActivationMode	Ruft einen Wert ab, der den Aktivierungsstatus des Fensters angibt.
AutomationHostProvider	Ruft den Automatisierungsanbieter ab, der diesem Fenster zugewiesen ist.
Bounds	Ruft einen Rect-Wert ab, der den Ursprung, die Höhe und die Breite des Clientbereichs des Fensters in geräteunabhängigen Pixeln (DEVICE-Independent Pixels, DIPs) enthält.
CustomProperties	Ruft den Satz benutzerdefinierter Eigenschaften für das Fenster ab.
Dispatcher	Ruft den Ereignisverteiler für das Fenster ab.
DispatcherQueue	Ruft die DispatcherQueue für das Fenster ab.
FlowDirection	Ruft den horizontalen Ursprung der Ausrichtung der Lesereihenfolge des Fensters ab oder legt diesen fest. Wenn die von der Benutzeroberfläche angegebene Sprache rechtsbündig ausgerichtet ist (z. B. in Arabisch oder Hebräisch), befindet sich der horizontale Ursprung des Leselayouts für das Fenster am rechten Rand.
IsInputEnabled	Ruft einen Wert ab, der angibt, ob die Eingabe für die App aktiviert ist, oder legt diesen fest.
PointerCursor	Ruft den von der App verwendeten Zeigercursor ab oder legt diesen fest.
PointerPosition	Ruft die Clientkoordinaten des Zeigers ab.
UIContext	Ruft den Kontextbezeichner für das Kernfenster ab.
Visible	Ruft einen Wert ab, der angibt, ob das Fenster sichtbar ist.

Methoden

Activate()	Aktiviert das Fenster. Diese Methode wird aufgerufen, um das Fenster auf dem Bildschirm anzuzeigen.
Close()	Schließt ein sekundäres Fenster und beendet die Nachrichtenschleife.
GetAsyncKeyState(VirtualKey)	Ruft den Zustand eines virtuellen Schlüssels asynchron ab.
GetCurrentKeyEventDeviceId()	Ruft die eindeutige ID für das Eingabegerät ab, das dieses Schlüsselereignis generiert hat. GetCurrentKeyEventDeviceId wird nicht für alle Eingabegeräte unterstützt.
GetForCurrentThread()	Ruft den CoreWindow-instance für den derzeit aktiven Thread ab.
GetKeyState(VirtualKey)	Ruft den Zustand eines virtuellen Schlüssels ab.
ReleasePointerCapture()	Entfernt zeigereingaben von der App, wenn sie zuvor über SetPointerCapture zugeordnet wurden, und stellt die normale Zeigereingabeverarbeitung wieder her.
SetPointerCapture()	Ordnet die Zeigereingabe der App zu. Sobald ein Zeiger erfasst wurde, werden alle nachfolgenden Ereignisse, die diesem Zeiger zugeordnet sind, von der App ausgelöst.

Ereignisse

Activated	Wird ausgelöst, wenn die Aktivierung oder Deaktivierung des Fensters abgeschlossen ist.
AutomationProviderRequested	Wird ausgelöst, wenn eine Anforderung für einen Automatisierungshandler generiert wird.
CharacterReceived	Wird ausgelöst, wenn ein neues Zeichen von der Eingabewarteschlange empfangen wird.
Closed	Tritt auf, wenn ein Fenster geschlossen wird (oder die App ganz beendet wird).
ClosestInteractiveBoundsRequested	Hinweis Nicht für den allgemeinen Gebrauch vorgesehen. Tritt auf, wenn ein Frameworkeingabe-Manager das begrenzungsbezogene Rechteck eines interaktiven Elements innerhalb eines bestimmten umgebenden Rechtecks anfordert und einem bestimmten Zeiger am nächsten kommt.
InputEnabled	Tritt auf, wenn die Eingabe für die App aktiviert oder deaktiviert ist.
KeyDown	Das Ereignis, das ausgelöst wird, wenn eine Nicht-Systemtaste gedrückt wird. Der Delegattyp für dieses Ereignis ist TypedEventHandler<TSender,TResult>, wobei TSender vom Typ CoreWindow und TResult vom Typ KeyEventArgs ist.
KeyUp	Das Ereignis, das ausgelöst wird, wenn eine Nicht-Systemtaste nach einem Drücken freigegeben wird. Der Delegattyp für dieses Ereignis ist TypedEventHandler<TSender,TResult>, wobei TSender vom Typ CoreWindow und TResult vom Typ KeyEventArgs ist.
PointerCaptureLost	Tritt auf, wenn ein Zeiger auf eine andere App wechselt. Dieses Ereignis wird nach PointerExited ausgelöst und ist das letzte Ereignis, das von der App für diesen Zeiger empfangen wird.
PointerEntered	Tritt auf, wenn ein Zeiger in das Begrenzungsfeld der App bewegt wird.
PointerExited	Tritt auf, wenn sich der Zeiger außerhalb des Begrenzungsrahmens der App bewegt.
PointerMoved	Tritt auf, wenn sich ein Zeiger innerhalb des Begrenzungsrahmens der App bewegt.
PointerPressed	Tritt auf, wenn auf eine Maustaste geklickt wird oder die Digitalisiereroberfläche mit einem Finger oder Stift innerhalb des begrenzungsenden Rechtecks der App berührt wurde. Eine Interaktionssitzung beginnt, wenn ein einzelner Kontakt erkannt wird, und endet, wenn dieser Kontakt und alle nachfolgenden Kontakte in derselben Sitzung nicht mehr erkannt werden. Dieses Ereignis wird für den ersten Kontakt ausgelöst, der in der Interaktionssitzung erkannt wurde. Details für alle anderen gleichzeitigen Kontaktzeiger werden über ein PointerPointProperties-Objekt verfügbar gemacht (abgerufen durch Abrufen der Properties-Eigenschaft aus einem PointerPoint-Objekt ).
PointerReleased	Tritt auf, wenn eine gedrückte Maustaste losgelassen wird oder ein Touch- oder Stiftkontakt von der Digitalisiereroberfläche innerhalb des begrenzungsenden Rechtecks der App (oder außerhalb des begrenzungsenden Rechtecks, wenn der Zeiger erfasst wird) angehoben wird.
PointerRoutedAway	Tritt für das Eingabeobjekt auf, das zeigereingaben empfängt, wenn der Zeiger an ein anderes Eingabeobjekt umgeleitet wird (möglicherweise in einem separaten Prozess).
PointerRoutedReleased	Tritt für alle Eingabeobjekte auf, die jemals mit einem Zeiger verknüpft sind, aber derzeit keine Eingabe von empfangen, der ein CoreIndependentInputSource.PointerReleased-Ereignis für ein Eingabeobjekt auslöst.
PointerRoutedTo	Tritt auf, wenn erfasste Zeigereingaben, die zuvor an ein anderes Objekt übermittelt wurden, in die Übermittlung an dieses Objekt übergehen.
PointerWheelChanged	Das Ereignis, das ausgelöst wird, wenn das Mausrad gedreht wird. Der Delegattyp für dieses Ereignis ist TypedEventHandler<TSender,TResult>, wobei TSender vom Typ CoreWindow und TResult vom Typ PointerEventArgs ist.
ResizeCompleted	Tritt auf, wenn ein Benutzer die Größenänderung des Fensters beendet.
ResizeStarted	Tritt auf, wenn ein Benutzer beginnt, die Größe des Fensters zu ändern.
SizeChanged	Tritt auf, wenn die Fenstergröße geändert wird.
TouchHitTesting	Tritt auf, wenn ein Berührungskontaktbereich das umgebende Rechteck (oder Polygon) eines Fensters überschneidet, das für Touchtreffertests registriert ist.
VisibilityChanged	Wird ausgelöst, wenn die Fenstersichtbarkeit geändert wird.

Weitere Informationen

• CoreApplicationView
• CreateNewView(IFrameworkViewSource)
• Views
• Beispiel für benutzerdefinierte Direct2D-Bildeffekte (Windows 10)