Process.MainWindowHandle Propriedade

Definição

Obtém o identificador de janela da janela principal do processo associado.Gets the window handle of the main window of the associated process.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };
public IntPtr MainWindowHandle { get; }
member this.MainWindowHandle : nativeint
Public ReadOnly Property MainWindowHandle As IntPtr

Valor da propriedade

IntPtr

O identificador de janela gerado pelo sistema da janela principal do processo associado.The system-generated window handle of the main window of the associated process.

Exceções

O MainWindowHandle não foi definido porque o processo foi encerrado.The MainWindowHandle is not defined because the process has exited.

Você está tentando acessar a propriedade MainWindowHandle para um processo que está sendo executado em um computador remoto.You are trying to access the MainWindowHandle property for a process that is running on a remote computer. Essa propriedade está disponível somente para processos em execução no computador local.This property is available only for processes that are running on the local computer.

Comentários

A janela principal é a janela aberta pelo processo que atualmente tem o foco (o TopLevel formulário).The main window is the window opened by the process that currently has the focus (the TopLevel form). Você deve usar o Refresh método para atualizar o Process objeto para obter o identificador de janela principal mais atualizado se ele tiver mudado.You must use the Refresh method to refresh the Process object to get the most up to date main window handle if it has changed. Em geral, como o identificador de janela é armazenado em cache, use com Refresh antecedência para garantir que você recuperará o identificador atual.In general, because the window handle is cached, use Refresh beforehand to guarantee that you'll retrieve the current handle.

Você pode obter a MainWindowHandle propriedade somente para processos em execução no computador local.You can get the MainWindowHandle property only for processes that are running on the local computer. A MainWindowHandle propriedade é um valor que identifica exclusivamente a janela associada ao processo.The MainWindowHandle property is a value that uniquely identifies the window that is associated with the process.

Um processo tem uma janela principal associada somente se o processo tiver uma interface gráfica.A process has a main window associated with it only if the process has a graphical interface. Se o processo associado não tiver uma janela principal, o MainWindowHandle valor será zero.If the associated process does not have a main window, the MainWindowHandle value is 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.The value is also zero for processes that have been hidden, that is, processes that are not visible in the taskbar. Esse pode ser o caso de processos que aparecem como ícones na área de notificação, na extrema direita da barra de tarefas.This can be the case for processes that appear as icons in the notification area, at the far right of the taskbar.

Se você acabou de iniciar um processo e deseja usar seu identificador de janela principal, considere usar o WaitForInputIdle método para permitir que o processo termine de iniciar, garantindo que o identificador da janela principal tenha sido criado.If you have just started a process and want to use its main window handle, consider using the WaitForInputIdle method to allow the process to finish starting, ensuring that the main window handle has been created. Caso contrário, uma exceção será gerada.Otherwise, an exception will be thrown.

Aplica-se a

Confira também