HwndSource Classe

Definição

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

Herança

Object

DispatcherObject

PresentationSource

HwndSource

Implementações

IDisposable IKeyboardInputSink IWin32Window

Comentários

Um HwndSource implementa uma janela Win32 que pode conter conteúdo WPF. O conteúdo do WPF na janela é organizado, medido e renderizado; e é interativo para entrada. Como o HwndSource foi projetado especificamente para interoperar com o Win32, essa classe expõe vários recursos win32 de baixo nível. Você pode usar essa classe para fazer o seguinte:

• Especifique estilos de janela, estilos de classe de janela e estilos de janela estendidos.

• Conecte o procedimento da janela.

• Forneça acesso ao identificador de janela (HWND).

• Destrua a janela.

A HwndSource classe foi projetada para interoperabilidade geral e não foi projetada como um wrapper HWND gerenciado. Em geral, ele não fornece métodos gerenciados para manipular a janela ou propriedades para inspecionar seu estado. Em vez disso, a HwndSource classe fornece acesso ao identificador de janela Win32 (HWND) por meio da Handle propriedade , que pode ser passada por meio de técnicas PInvoke para APIs win32 a fim de manipular a janela.

Construção

Muitos aspectos do HwndSource só podem ser especificados no momento da construção. Para criar um HwndSource, primeiro crie uma HwndSourceParameters estrutura e preencha-a com os parâmetros desejados. Esses parâmetros incluem o seguinte:

• A classe, a janela e os estilos de janela estendidos. Você deve usar o PInvoke para alterar os estilos depois que a janela é criada. Nem todos os estilos podem ser alterados depois que a janela é criada. Consulte a documentação do Win32 antes de alterar os estilos de janela.

• A posição inicial da janela.

• O tamanho inicial da janela, que inclui se o tamanho é especificado ou deve ser determinado do tamanho determinado do conteúdo do WPF.

• A janela pai.

• O HwndSourceHook a ser incluído na cadeia de procedimentos da janela. Se você especificar um gancho no momento da construção, ele receberá todas as mensagens para a janela. Você pode usar AddHook para adicionar um gancho depois que a janela é criada.

• As configurações de transparência. Uma janela de nível superior pode ser configurada para se misturar com as outras janelas na área de trabalho de acordo com a transparência por pixel do conteúdo do WPF. Para habilitar isso, defina a UsesPerPixelOpacity propriedade no como HwndSourceParameterstrue. Essa propriedade só pode ser especificada no momento da construção e somente por meio da assinatura do HwndSource(HwndSourceParameters) construtor e impõe várias limitações.

Depois de preencher a HwndSourceParameters estrutura, passe-a para o HwndSource(HwndSourceParameters) construtor do HwndSource.

Tempo de vida do objeto

Um HwndSource é um objeto CLR (Common Language Runtime) regular e seu tempo de vida é gerenciado pelo coletor de lixo. Como o HwndSource representa um recurso não gerenciado, HwndSource implementa IDisposable. A chamada Dispose síncrona destrói imediatamente a janela win32 se chamada do thread do proprietário. Se chamado de outro thread, a janela win32 é destruída de forma assíncrona. Chamar Dispose explicitamente do código de interoperação pode ser necessário para determinados cenários de interoperação.

Procedimentos de janela

A HwndSource classe implementa seu próprio procedimento de janela. Esse procedimento de janela é usado para processar mensagens de janela importantes, como aquelas relacionadas a layout, renderização e entrada. No entanto, você também pode enganchar o procedimento de janela para seu próprio uso. Você pode especificar seu próprio gancho durante a construção definindo a HwndSourceParameters.HwndSourceHook propriedade ou também pode usar AddHook e RemoveHook para adicionar e remover ganchos após a criação da janela. Os ganchos são chamados pela ordem de primeira saída última, que permite que seus ganchos sejam executados antes do processamento interno. Os ganchos reais são mantidos por uma referência fraca. Portanto, certifique-se de gerenciar o tempo de vida do delegado do gancho.

Para obter mais informações sobre HwndSource e outras classes de interoperação, consulte Interoperação WPF e Win32.

Observe como os construtores para HwndSource usar parâmetros semelhantes aos parâmetros para funções Win32, como CreateWindowEx.

As transformações de escala não devem ser aplicadas ao RootVisual de um HwndSource. Consulte Comentários para RootVisual.

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

• HwndHost