Process.MainWindowHandle Propriedade
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.
Obtém a alavanca da janela principal do processo associado.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrValor de Propriedade
nativeint
O handler da janela gerada pelo sistema da janela principal do processo associado.
Exceções
O MainWindowHandle não está definido porque o processo terminou.
Está a tentar aceder à MainWindowHandle propriedade de um processo que está a correr num computador remoto. Esta propriedade está disponível apenas para processos que estão a correr no computador local.
Observações
A janela principal é a janela aberta pelo processo que atualmente tem o foco (a TopLevel forma). Deve usar o Refresh método para atualizar o Process objeto para obter o handle da janela principal mais atualizado caso tenha sido alterado. De um modo geral, como o handle da janela está armazenado em cache, use Refresh previamente para garantir que recupera o handle atual.
Só podes obter a MainWindowHandle propriedade para processos que estão a correr no computador local. A MainWindowHandle propriedade é um valor que identifica de forma única a janela associada ao processo.
Um processo tem uma janela principal associada apenas se o processo tiver uma interface gráfica. Se o processo associado não tiver uma janela principal, o MainWindowHandle valor é zero. O valor também é zero para processos que foram ocultos, ou seja, processos que não são visíveis na barra de tarefas. Isto pode acontecer com processos que aparecem como ícones na área de notificações, no extremo direito da barra de tarefas.
Se acabou de iniciar um processo e quiser usar a maçaneta da janela principal, considere usar o WaitForInputIdle método para permitir que o processo termine de começar, garantindo que a maçaneta da janela principal foi criada. Caso contrário, uma exceção será lançada.