Process.MainWindowHandle Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Origem:

Process.Unix.cs

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 : nativeint

Public ReadOnly Property MainWindowHandle As IntPtr

Valor da propriedade

IntPtr

nativeint

O identificador de janela gerado pelo sistema da janela principal do processo associado.

Exceções

InvalidOperationException

O MainWindowHandle não foi definido porque o processo foi encerrado.

NotSupportedException

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.

Confira também

• MainWindowTitle
• MainModule