Process.MainWindowHandle Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém o identificador de janela 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 da propriedade
nativeint
O identificador de janela gerado pelo sistema da janela principal do processo associado.
Exceções
O MainWindowHandle não foi definido porque o processo foi encerrado.
Você está tentando acessar a propriedade MainWindowHandle para um processo que está sendo executado em um computador remoto. Essa propriedade está disponível somente para processos em execução no computador local.
Comentários
A janela main é a janela aberta pelo processo que atualmente tem o foco (o TopLevel formulário). Você deve usar o Refresh método para atualizar o Process objeto para obter o identificador de janela mais atualizado main se ele tiver sido alterado. Em geral, como o identificador de janela é armazenado em cache, use Refresh com antecedência para garantir que você recuperará o identificador atual.
Você pode obter a MainWindowHandle propriedade somente para processos que estão em execução no computador local. A MainWindowHandle propriedade é um valor que identifica exclusivamente a janela associada ao processo.
Um processo tem uma janela main associada a ele somente se o processo tiver uma interface gráfica. Se o processo associado não tiver uma janela main, o MainWindowHandle valor será zero. O valor também é zero para processos que foram ocultos, ou seja, processos que não estão visíveis na barra de tarefas. Esse pode ser o caso de processos que aparecem como ícones na área de notificação, na extrema direita da barra de tarefas.
Se você acabou de iniciar um processo e deseja usar seu identificador de janela main, considere usar o WaitForInputIdle método para permitir que o processo seja iniciado, garantindo que o identificador de janela main tenha sido criado. Caso contrário, uma exceção será gerada.
