Freigeben über


CoreWindow Klasse

Definition

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

public ref class CoreWindow sealed : ICoreWindow
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 : 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 : 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 ICoreWindow
Public NotInheritable Class CoreWindow
Implements ICorePointerRedirector, ICoreWindow
Vererbung
Object Platform::Object IInspectable CoreWindow
Attribute
Implementiert

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.

Gilt für:

Weitere Informationen