HwndSource Klasse

Definition

public ref class HwndSource : System::Windows::PresentationSource, IDisposable, System::Windows::Interop::IKeyboardInputSink, System::Windows::Interop::IWin32Window

public class HwndSource : System.Windows.PresentationSource, IDisposable, System.Windows.Interop.IKeyboardInputSink, System.Windows.Interop.IWin32Window

type HwndSource = class
    inherit PresentationSource
    interface IDisposable
    interface IWin32Window
    interface IKeyboardInputSink

type HwndSource = class
    inherit PresentationSource
    interface IDisposable
    interface IKeyboardInputSink
    interface IWin32Window

Public Class HwndSource
Inherits PresentationSource
Implements IDisposable, IKeyboardInputSink, IWin32Window

Vererbung

Object

DispatcherObject

PresentationSource

HwndSource

Implementiert

IDisposable IKeyboardInputSink IWin32Window

Hinweise

Ein HwndSource implementiert ein Win32-Fenster, das WPF-Inhalte enthalten kann. Der WPF-Inhalt im Fenster wird angeordnet, gemessen und gerendert. und ist interaktiv für die Eingabe. Da die speziell für die HwndSource Zusammenarbeit mit Win32 konzipiert ist, macht diese Klasse mehrere Win32-Features auf niedriger Ebene verfügbar. Sie können diese Klasse verwenden, um Folgendes zu tun:

• Geben Sie Fensterstile, Fensterklassenstile und erweiterte Fensterstile an.

• Schließen Sie die Fensterprozedur an.

• Gewähren des Zugriffs auf das Fensterhandle (HWND).

• Zerstören Sie das Fenster.

Die HwndSource -Klasse ist für die allgemeine Interoperabilität konzipiert und nicht als verwalteter HWND-Wrapper konzipiert. Im Allgemeinen werden keine verwalteten Methoden zum Bearbeiten des Fensters oder der Eigenschaften zum Überprüfen des Zustands bereitgestellt. Stattdessen bietet die HwndSource -Klasse zugriff auf das Win32-Fensterhandle (HWND) über die Handle -Eigenschaft, die mithilfe von PInvoke-Techniken an Win32-APIs übergeben werden kann, um das Fenster zu bearbeiten.

Bauwesen

Viele Aspekte des HwndSource können nur zur Bauzeit angegeben werden. Um eine HwndSourcezu erstellen, erstellen Sie zuerst eine HwndSourceParameters Struktur, und füllen Sie sie mit den gewünschten Parametern auf. Diese Parameter umfassen Folgendes:

• Die Klassen-, Fenster- und erweiterten Fensterstile. Sie müssen PInvoke verwenden, um die Formatvorlagen zu ändern, nachdem das Fenster erstellt wurde. Nach dem Erstellen des Fensters können nicht alle Stile geändert werden. Lesen Sie die Win32-Dokumentation, bevor Sie fensterstile ändern.

• Die Anfangsposition des Fensters.

• Die anfängliche Größe des Fensters, die beinhaltet, ob die Größe angegeben ist oder aus der ermittelten Größe des WPF-Inhalts bestimmt werden soll.

• Das übergeordnete Fenster.

• Die HwndSourceHook , die in die Fensterprozedurkette eingeschlossen werden soll. Wenn Sie zur Bauzeit einen Hook angeben, empfängt er alle Meldungen für das Fenster. Sie können verwenden AddHook , um einen Hook hinzuzufügen, nachdem das Fenster erstellt wurde.

• Die Transparenzeinstellungen. Ein Fenster der obersten Ebene kann so konfiguriert werden, dass es mit den anderen Fenstern auf dem Desktop gemäß der Transparenz pro Pixel des WPF-Inhalts kombiniert wird. Um dies zu aktivieren, legen Sie die UsesPerPixelOpacity -Eigenschaft in auf HwndSourceParameters fest true. Diese Eigenschaft kann nur zur Bauzeit und nur über die HwndSource(HwndSourceParameters) Konstruktorsignatur angegeben werden, und es werden mehrere Einschränkungen festgelegt.

Nachdem Sie die HwndSourceParameters Struktur aufgefüllt haben, übergeben Sie sie an den HwndSource(HwndSourceParameters) Konstruktor für HwndSource.

Lebensdauer eines Objekts

Ein HwndSource ist ein reguläres CLR-Objekt (Common Language Runtime), dessen Lebensdauer vom Garbage Collector verwaltet wird. Da die HwndSource eine nicht verwaltete Ressource darstellt, HwndSource implementiert IDisposable. Das synchrone Aufrufen Dispose zerstört das Win32-Fenster, wenn es vom Besitzerthread aufgerufen wird. Wenn es von einem anderen Thread aufgerufen wird, wird das Win32-Fenster asynchron zerstört. Das explizite Aufrufen Dispose des interoperabilitätscodes kann für bestimmte Interoperationsszenarien erforderlich sein.

Fensterprozeduren

Die HwndSource -Klasse implementiert eine eigene Fensterprozedur. Diese Fensterprozedur wird verwendet, um wichtige Fenstermeldungen zu verarbeiten, z. B. solche, die sich auf Layout, Rendering und Eingabe beziehen. Sie können die Fensterprozedur jedoch auch für Ihre eigene Verwendung einbinden. Sie können ihren eigenen Hook während der Konstruktion angeben, indem Sie die HwndSourceParameters.HwndSourceHook -Eigenschaft festlegen, oder Sie können auch und RemoveHook verwendenAddHook, um Hooks hinzuzufügen und zu entfernen, nachdem das Fenster erstellt wurde. Die Hooks werden nach der Last-in-First-Out-Reihenfolge aufgerufen, sodass Ihre Hooks vor der integrierten Verarbeitung ausgeführt werden können. Die tatsächlichen Hooks werden von einem schwachen Verweis gehalten. Stellen Sie daher sicher, dass Sie die Lebensdauer Ihres Hookdelegaten verwalten.

Weitere Informationen zu HwndSource und anderen Interoperationsklassen finden Sie unter WPF und Win32 Interoperation.

Beachten Sie, dass die Konstruktoren für HwndSource Parameter verwenden, die den Parametern für Win32-Funktionen wie CreateWindowEx ähneln.

Skalierungstransformationen sollten nicht auf die RootVisual eines HwndSourceangewendet werden. Weitere Informationen finden Sie unter Hinweise zu RootVisual.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• HwndHost