CoreApplicationView Klasse

Definition

Namespace:

Windows.ApplicationModel.Core

Stellt ein App-Fenster und seinen Thread dar.

public ref class CoreApplicationView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class CoreApplicationView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class CoreApplicationView

Public NotInheritable Class CoreApplicationView

Vererbung

Object Platform::Object IInspectable CoreApplicationView

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

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

Hinweise

Der folgende Codeausschnitt veranschaulicht die Aktivierung von CoreApplicationView und dem zugehörigen CoreWindow in einer Ansichtsanbieterimplementierung.

struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
...
    void Initialize(CoreApplicationView const& applicationView)
    {
        applicationView.Activated({this, &App::OnActivated });
    }

    void OnActivated(CoreApplicationView const& /* applicationView */, IActivatedEventArgs const& /* args */)
    {
        // Activate the application window, making it visible and enabling it to receive events.
        CoreWindow::GetForCurrentThread().Activate();
    }
}

ref class MyFrameworkView : public IFrameworkView
{
// ...
virtual void Initialize(
        _In_ CoreApplicationView^ applicationView
        )
    {
        applicationView->Activated +=
            ref new TypedEventHandler<CoreApplicationView^, IActivatedEventArgs^>(this, &MyFrameworkView::OnActivated);
    }

// ...

void OnActivated(
        _In_ CoreApplicationView^ applicationView,
        _In_ IActivatedEventArgs^ args
        )
    {
        // Activate the application window, making it visible and enabling it to receive events.
        CoreWindow::GetForCurrentThread()->Activate();
    }

// ...
}

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1703	15063	Eigenschaften
1709	16299	DispatcherQueue

Eigenschaften

CoreWindow	Ruft das App-Fenster ab, das der aktuellen Ansicht zugeordnet ist.
Dispatcher	Ruft den Ereignisnachrichtenverteiler ab, der der aktuellen Ansicht zugeordnet ist.
DispatcherQueue	Ruft die DispatcherQueue für das Fenster ab.
IsComponent	Ruft ab, ob die App als Komponente gestartet wurde, die in eine andere App eingebettet ist. Diese Eigenschaft ist für die interne Verwendung reserviert und nicht für die Verwendung in Ihrem Code vorgesehen.
IsHosted	Ruft den Wert ab, der angibt, ob diese App-Ansicht gehostet wird oder nicht.
IsMain	Ruft einen Wert ab, der angibt, ob diese App-Ansicht die Standard App-Ansicht ist oder nicht.
Properties	Ruft Eigenschaften ab, die die App der Ansicht zuordnen kann.
TitleBar	Ruft die der aktuellen Ansicht zugeordnete Titelleiste ab.

Ereignisse

Activated	Tritt auf, wenn die Ansicht aktiviert wird.
HostedViewClosing	Gibt an, dass die gehostete Ansicht geschlossen wird. Bietet eine Möglichkeit für Szenarien mit gehosteten Fenstern, den Abriss der gehosteten Ansicht zu verzögern.

Weitere Informationen

• GetCurrentView()
• DirectX-Swapchainimplementierungsbeispiel
• CoreApplication.CreateNewView