HwndSource Clase

Definición

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

Herencia

Object

DispatcherObject

PresentationSource

HwndSource

Implementaciones

IDisposable IKeyboardInputSink IWin32Window

Comentarios

Implementa HwndSource una ventana win32 que puede contener contenido de WPF. El contenido de WPF en la ventana se organiza, mide y representa; y es interactivo para la entrada. Dado que está HwndSource diseñado específicamente para interoperar con Win32, esta clase expone varias características de Win32 de bajo nivel. Puede usar esta clase para hacer lo siguiente:

• Especifique estilos de ventana, estilos de clase de ventana y estilos de ventana extendidos.

• Enlace el procedimiento de ventana.

• Proporcione acceso al identificador de ventana (HWND).

• Destruye la ventana.

La HwndSource clase está diseñada para la interoperabilidad general y no está diseñada como contenedor HWND administrado. En general, no proporciona métodos administrados para manipular la ventana o las propiedades para inspeccionar su estado. En su lugar, la HwndSource clase proporciona acceso al identificador de ventana de Win32 (HWND) a través de la Handle propiedad , que se puede pasar mediante técnicas de PInvoke a las API de Win32 para manipular la ventana.

Construcción

Muchos aspectos de solo HwndSource se pueden especificar en tiempo de construcción. Para crear un HwndSourceobjeto , primero cree una HwndSourceParameters estructura y rellénela con los parámetros deseados. Estos parámetros incluyen lo siguiente:

• Los estilos de clase, ventana y ventana extendida. Debe usar PInvoke para cambiar los estilos después de crear la ventana. No todos los estilos se pueden cambiar después de crear la ventana. Consulte la documentación de Win32 antes de cambiar los estilos de ventana.

• Posición inicial de la ventana.

• Tamaño inicial de la ventana, que incluye si se especifica el tamaño o se debe determinar a partir del tamaño determinado del contenido de WPF.

• La ventana primaria.

• que HwndSourceHook se va a incluir en la cadena de procedimientos de ventana. Si especifica un enlace en tiempo de construcción, recibe todos los mensajes de la ventana. Puede usar AddHook para agregar un enlace después de crear la ventana.

• Configuración de transparencia. Se puede configurar una ventana de nivel superior para combinar con las demás ventanas del escritorio según la transparencia por píxel del contenido de WPF. Para habilitarlo, establezca la UsesPerPixelOpacity propiedad en HwndSourceParameterstrue. Esta propiedad solo se puede especificar en tiempo de construcción, y solo a través de la firma del HwndSource(HwndSourceParameters) constructor, e impone varias limitaciones.

Después de rellenar la HwndSourceParameters estructura, pásela al HwndSource(HwndSourceParameters) constructor de .HwndSource

Duración de objetos

Es HwndSource un objeto de Common Language Runtime (CLR) normal y el recolector de elementos no utilizados administra su duración. Dado que HwndSource representa un recurso no administrado, HwndSource implementa IDisposable. La llamada Dispose sincrónica destruye inmediatamente la ventana win32 si se llama desde el subproceso propietario. Si se llama desde otro subproceso, la ventana Win32 se destruye de forma asincrónica. Llamar Dispose explícitamente desde el código de interoperación podría ser necesario para determinados escenarios de interoperación.

Procedimientos de ventana

La HwndSource clase implementa su propio procedimiento de ventana. Este procedimiento de ventana se usa para procesar mensajes de ventana importantes, como los relacionados con el diseño, la representación y la entrada. Sin embargo, también puede enlazar el procedimiento de ventana para su propio uso. Puede especificar su propio enlace durante la construcción estableciendo la HwndSourceParameters.HwndSourceHook propiedad , o también puede usar AddHook y RemoveHook para agregar y quitar enlaces después de crear la ventana. Los enlaces se llaman por último orden en primer lugar, lo que permite que los enlaces se ejecuten antes del procesamiento integrado. Los ganchos reales se mantienen mediante una referencia débil. Por lo tanto, asegúrese de administrar la duración del delegado de enlace.

Para obtener más información sobre HwndSource y otras clases de interoperación, vea Interoperación de WPF y Win32.

Observe cómo los constructores para HwndSource tomar parámetros similares a los parámetros de las funciones Win32, como CreateWindowEx.

Las transformaciones de escalado no se deben aplicar a RootVisual de .HwndSource Vea Comentarios para RootVisual.

Constructores

Propiedades

Métodos

Eventos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• HwndHost