WindowInteropHelper.EnsureHandle Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria o HWND da janela se o HWND ainda não foi criado.
public:
IntPtr EnsureHandle();[System.Security.SecurityCritical]
public IntPtr EnsureHandle();public IntPtr EnsureHandle();[<System.Security.SecurityCritical>]
member this.EnsureHandle : unit -> nativeintmember this.EnsureHandle : unit -> nativeintPublic Function EnsureHandle () As IntPtrDevoluções
nativeint
Um IntPtr que representa o HWND.
- Atributos
Observações
Use o EnsureHandle método quando quiser separar a criação do handle de janela (HWND) da exibição real do file gerido Window. Isto é útil quando se tem um cliente de automação que consegue realizar as suas tarefas sem necessidade de mostrar uma janela.
Se a janela nativa ainda não tiver sido criada, este método cria a janela nativa, define a Handle propriedade e devolve o HWND. Se a janela nativa já foi criada, o handle da janela nativa existente é devolvido.
Se a janela nativa for criada como resultado da chamada deste método, o SourceInitialized evento é levantado.
Consultar a Handle propriedade após o EnsureHandle método ser chamado devolve o handler da janela existente. A árvore visual só é associada à janela depois de o Show método ser chamado.
Chamar o EnsureHandle método mais do que uma vez não cria novas janelas. Chamar o EnsureHandle método quando o handle já foi criado por uma chamada ao Show método não cria um novo handle de janela. Uma janela nativa só é criada quando não existe um handle quando o EnsureHandle método é chamado.
Propriedades de janelas definidas usando APIs nativas via p/invoke podem não aparecer nas APIs de janelas geridas. Por exemplo, se definir a janela para ser mais alta usando a flag nativa MS_EX_TOPMOST após o EnsureHandle método ser chamado, a Topmost propriedade não garante que reflita a configuração nativa.
