Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

HwndSource-Klasse

 

Veröffentlicht: Oktober 2016

Stellt Windows Presentation Foundation (WPF)-Inhalt in einem Win32-Fenster dar.

Namespace:   System.Windows.Interop
Assembly:  PresentationCore (in PresentationCore.dll)


public class HwndSource : PresentationSource, IDisposable, IWin32Window, 
	IKeyboardInputSink

NameBeschreibung
System_CAPS_pubmethodHwndSource(HwndSourceParameters)

Initialisiert eine neue Instanz der der HwndSource Klasse, indem Sie eine Struktur, die die ursprünglichen Einstellungen enthält.

System_CAPS_pubmethodHwndSource(Int32, Int32, Int32, Int32, Int32, Int32, Int32, String, IntPtr)

Initialisiert eine neue Instanz der der HwndSource Klasse mit der angegebenen Klasse Formatvorlage Stil erweiterten Stil, X-y-Position, Breite, Höhe, Name und übergeordnetes Fenster.

System_CAPS_pubmethodHwndSource(Int32, Int32, Int32, Int32, Int32, Int32, Int32, String, IntPtr, Boolean)

Initialisiert eine neue Instanz der HwndSource -Klasse mit der angegebenen Klasse Formatvorlage Stil Stil, X-y-Position, Breite, Höhe, Name und übergeordneten Fenster erweitert und durch Angabe, ob das Fenster automatisch angepasst wird.

System_CAPS_pubmethodHwndSource(Int32, Int32, Int32, Int32, Int32, String, IntPtr)

Initialisiert eine neue Instanz der der HwndSource Klasse mit der angegebenen Klasse Formatvorlage Stil erweiterten Stil, X-y-Position, Name und übergeordnetes Fenster.

NameBeschreibung
System_CAPS_pubpropertyAcquireHwndFocusInMenuMode

Ruft den Wert ab, der bestimmt, ob der Win32-Fokus für das Fenster mit WPF für diese erhalten HwndSource.

System_CAPS_pubpropertyChildKeyboardInputSinks

Ruft eine Sequenz von registrierten Eingabe senken.

System_CAPS_pubpropertyCompositionTarget

Ruft den visuellen Manager für das gehostete Fenster ab.

System_CAPS_pubpropertySystem_CAPS_staticDefaultAcquireHwndFocusInMenuMode

Ruft ab oder legt den Standardwert AcquireHwndFocusInMenuMode Wert für neue Instanzen von HwndSource.

System_CAPS_pubpropertyDispatcher

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.(Geerbt von „DispatcherObject“.)

System_CAPS_pubpropertyHandle

Ruft das Fensterhandle für HwndSource.

System_CAPS_pubpropertyIsDisposed

Ruft einen Wert, der angibt, ob Dispose aufgerufen wurde auf diesem HwndSource.(Überschreibt PresentationSource.IsDisposed.)

System_CAPS_protpropertyKeyboardInputSiteCore

Ruft ab oder legt einen Verweis auf den Container der Komponente IKeyboardInputSite Schnittstelle.

System_CAPS_pubpropertyRestoreFocusMode

Ruft die RestoreFocusMode für das Fenster.

System_CAPS_pubpropertyRootVisual

Ruft ab oder legt die RootVisual des Fensters.(Überschreibt PresentationSource.RootVisual.)

System_CAPS_pubpropertySizeToContent

Ruft ab oder legt fest, ob und wie die Fenster an seinen Inhalt angepasst wird.

System_CAPS_pubpropertyUsesPerPixelOpacity

Ruft einen Wert ab, der deklariert, ob der Durchlässigkeitswert pro Pixel des Quellfensterinhalts berücksichtigt wird.

NameBeschreibung
System_CAPS_pubmethodAddHook(HwndSourceHook)

Fügt einen Ereignishandler, der alle Fensternachrichten empfängt.

System_CAPS_protmethodAddSource()

Fügt eine PresentationSource abgeleitete Klasseninstanz, die Liste der bekannten Präsentationsquellen.(Geerbt von „PresentationSource“.)

System_CAPS_pubmethodCheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diese DispatcherObject.(Geerbt von „DispatcherObject“.)

System_CAPS_protmethodClearContentRenderedListeners()

Legt die Liste der Listener für die ContentRendered Ereignis null.(Geerbt von „PresentationSource“.)

System_CAPS_pubmethodCreateHandleRef()

Ruft das Fensterhandle für das HwndSource. Das Fensterhandle wird als Teil des verpackt eine HandleRef Struktur.

System_CAPS_pubmethodDispose()

Gibt alle verwaltete Ressourcen, die von verwendet werden, die HwndSource, und löst das Disposed Ereignis.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodSystem_CAPS_staticFromHwnd(IntPtr)

Gibt die HwndSource Objekt des angegebenen Fensters.

System_CAPS_protmethodGetCompositionTargetCore()

Ruft das visuelle Ziel des Fensters ab.(Überschreibt PresentationSource.GetCompositionTargetCore().)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_protmethodHasFocusWithinCore()

Ruft einen Wert, der angibt, ob die Senke oder eine der enthaltenen Komponenten den Fokus besitzt.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodOnDpiChanged(HwndDpiChangedEventArgs)

Wird aufgerufen, wenn der DPI-Wert für das Fenster sich ändert.

System_CAPS_protmethodOnMnemonicCore(MSG, ModifierKeys)

Wird aufgerufen, wenn eines der mnemonischen Zeichen (Zugriffstasten) dieser Senke aufgerufen wird.

System_CAPS_protmethodRegisterKeyboardInputSinkCore(IKeyboardInputSink)

Registriert die IKeyboardInputSink Schnittstelle einer enthaltenen Komponente.

System_CAPS_pubmethodRemoveHook(HwndSourceHook)

Entfernt die Ereignishandler, die hinzugefügt wurden AddHook.

System_CAPS_protmethodRemoveSource()

Entfernt eine PresentationSource abgeleitete Klasseninstanz aus der Liste der bekannten Präsentationsquellen.(Geerbt von „PresentationSource“.)

System_CAPS_protmethodRootChanged(Visual, Visual)

Stellt eine Benachrichtigung bereit, die den Stamm Visual hat sich geändert.(Geerbt von „PresentationSource“.)

System_CAPS_protmethodTabIntoCore(TraversalRequest)

Legt den Fokus auf den ersten Tabstopp oder den letzten Tabstopp der Senke.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_protmethodTranslateAcceleratorCore(MSG, ModifierKeys)

Verarbeitet die Eingaben über die Tastatur auf Nachrichtenebene Schlüssel aus.

System_CAPS_protmethodTranslateCharCore(MSG, ModifierKeys)

WM_CHAR und WM_SYSCHAR, WM_DEADCHAR und WM_SYSDEADCHAR Eingabenachrichten vor verarbeitet die OnMnemonic Methode wird aufgerufen.

System_CAPS_pubmethodVerifyAccess()

Erzwingt, dass der aufrufende Thread den Zugriff auf diese kann DispatcherObject.(Geerbt von „DispatcherObject“.)

NameBeschreibung
System_CAPS_pubeventAutoResized

Tritt auf, wenn das Layout bewirkt, dass die HwndSource automatisch angepasst wird.

System_CAPS_pubeventContentRendered

Tritt auf, wenn der Inhalt gerendert wurde und für Benutzerinteraktionen bereit ist.(Geerbt von „PresentationSource“.)

System_CAPS_pubeventDisposed

Tritt auf, wenn die Dispose Methode für dieses Objekt aufgerufen wird.

System_CAPS_pubeventDpiChanged

Tritt auf, wenn der DPI-Wert des Monitors dieses Hwnd sich geändert hat, oder das Hwnd zu einem Monitor mit einem anderen DPI-Wert verschoben wird.

System_CAPS_pubeventSizeToContentChanged

Tritt auf, wenn sich der Wert der SizeToContent-Eigenschaft ändert.

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIKeyboardInputSink.HasFocusWithin()

Eine Beschreibung dieses Elements finden Sie unter IList.Remove.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIKeyboardInputSink.OnMnemonic(MSG, ModifierKeys)

Eine Beschreibung dieses Elements finden Sie unter OnMnemonic.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIKeyboardInputSink.RegisterKeyboardInputSink(IKeyboardInputSink)

Eine Beschreibung dieses Elements finden Sie unter RegisterKeyboardInputSink.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIKeyboardInputSink.TabInto(TraversalRequest)

Eine Beschreibung dieses Elements finden Sie unter TabInto.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIKeyboardInputSink.TranslateAccelerator(MSG, ModifierKeys)

Eine Beschreibung dieses Elements finden Sie unter TranslateAccelerator.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIKeyboardInputSink.TranslateChar(MSG, ModifierKeys)

Eine Beschreibung dieses Elements finden Sie unter TranslateChar.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIKeyboardInputSink.KeyboardInputSite

Eine Beschreibung dieses Elements finden Sie unter KeyboardInputSite.

System_CAPS_security Sicherheit Hinweis

Many members of this class are unavailable in the Internet security zone.

An T:System.Windows.Interop.HwndSource implements a TLA2#tla_win32 window that can contain TLA2#tla_winclient content. The TLA2#tla_winclient content in the window is arranged, measured, and rendered; and is interactive to input. Because the T:System.Windows.Interop.HwndSource is specifically designed to interoperate with TLA2#tla_win32, this class exposes several low-level TLA2#tla_win32 features. You can use this class to do the following:

  • Specify window styles, window class styles, and extended window styles.

  • Hook the window procedure.

  • Provide access to the window handle (HWND).

  • Destroy the window.

The T:System.Windows.Interop.HwndSource class is designed for general interoperability and is not designed as a managed HWND wrapper. In general, it does not provide managed methods for manipulating the window or properties for inspecting its state. Instead, the T:System.Windows.Interop.HwndSource class provides access to the TLA2#tla_win32 window handle (HWND) through the P:System.Windows.Interop.HwndSource.Handle property, which can be passed by means of PInvoke techniques to TLA2#tla_win32 TLA2#tla_api#plural in order to manipulate the window.

Construction

Many aspects of the T:System.Windows.Interop.HwndSource can only be specified at construction time. To create an T:System.Windows.Interop.HwndSource, first create an T:System.Windows.Interop.HwndSourceParameters structure and populate it with the desired parameters. These parameters include the following:

  • The class, window, and extended window styles. You must use PInvoke to change the styles after the window is created. Not all styles can be changed after the window is created. Consult the TLA2#tla_win32 documentation before changing window styles.

  • The initial position of the window.

  • The initial size of the window, which includes whether the size is specified or should be determined from the determined size of the TLA2#tla_winclient content.

  • The parent window.

  • The T:System.Windows.Interop.HwndSourceHook to include in the window procedure chain. If you specify a hook at construction time, it receives all messages for the window. You can use M:System.Windows.Interop.HwndSource.AddHook(System.Windows.Interop.HwndSourceHook) to add a hook after the window is created.

  • The transparency settings. A top-level window can be configured to blend with the other windows on the desktop according to the per-pixel transparency of the TLA2#tla_winclient content. To enable this, set the P:System.Windows.Interop.HwndSourceParameters.UsesPerPixelOpacity property in the T:System.Windows.Interop.HwndSourceParameters to true. This property can only be specified at construction time, and only through the M:System.Windows.Interop.HwndSource.#ctor(System.Windows.Interop.HwndSourceParameters) constructor signature, and it imposes several limitations.

After you populate the T:System.Windows.Interop.HwndSourceParameters structure, pass it to the M:System.Windows.Interop.HwndSource.#ctor(System.Windows.Interop.HwndSourceParameters) constructor for the T:System.Windows.Interop.HwndSource.

Object Lifetime

An T:System.Windows.Interop.HwndSource is a regular TLA#tla_clr object, and its lifetime is managed by the garbage collector. Because the T:System.Windows.Interop.HwndSource represents an unmanaged resource, T:System.Windows.Interop.HwndSource implements T:System.IDisposable. Synchronously calling M:System.Windows.Interop.HwndSource.Dispose immediately destroys the TLA2#tla_win32 window if called from the owner thread. If called from another thread, the TLA2#tla_win32 window is destroyed asynchronously. Calling M:System.Windows.Interop.HwndSource.Dispose explicitly from the interoperating code might be necessary for certain interoperation scenarios.

Window Procedures

The T:System.Windows.Interop.HwndSource class implements its own window procedure. This window procedure is used to process important window messages, such as those related to layout, rendering, and input. However, you can also hook the window procedure for your own use. You can specify your own hook during construction by setting the P:System.Windows.Interop.HwndSourceParameters.HwndSourceHook property, or you can also use M:System.Windows.Interop.HwndSource.AddHook(System.Windows.Interop.HwndSourceHook) and M:System.Windows.Interop.HwndSource.RemoveHook(System.Windows.Interop.HwndSourceHook) to add and remove hooks after the window is created. The hooks are called by last-in first-out order, which enables your hooks to execute before the built-in processing. The actual hooks are held by a weak reference. Therefore, make sure that you manage the lifetime of your hook delegate.

For more information about T:System.Windows.Interop.HwndSource and other interoperation classes, see WPF and Win32 Interoperation.

Notice how the constructors for T:System.Windows.Interop.HwndSource take parameters that resemble the parameters for TLA#tla_win32 functions such as CreateWindowExhttp://go.microsoft.com/fwlink/?LinkID=98462.

Scale transformations should not be applied to the P:System.Windows.Interop.HwndSource.RootVisual of an T:System.Windows.Interop.HwndSource. See Remarks for P:System.Windows.Interop.HwndSource.RootVisual.

.NET Framework
Verfügbar seit 3.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: