Process.MainWindowHandle Свойство

Определение

Получает дескриптор главного окна связанного процесса.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

Значение свойства

IntPtr

Созданный системой дескриптор главного окна связанного процесса.The system-generated window handle of the main window of the associated process.

Исключения

Свойство MainWindowHandle не определено, так как процесс завершился.The MainWindowHandle is not defined because the process has exited.

Вы пытаетесь получить доступ к свойству MainWindowHandle процесса, запущенного на удаленном компьютере.You are trying to access the MainWindowHandle property for a process that is running on a remote computer. Это свойство доступно только для процессов, запущенных на локальном компьютере.This property is available only for processes that are running on the local computer.

Комментарии

Главное окно — это окно, открытое процессом, который в данный момент имеет фокус ( TopLevel форма).The main window is the window opened by the process that currently has the focus (the TopLevel form). Необходимо использовать метод, Refresh чтобы обновить объект, Process чтобы получить наиболее актуальный обработчик основного окна, если он был изменен.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. В общем случае, поскольку обработчик окна кэшируется, сначала следует использовать, Refresh чтобы получить текущий маркер.In general, because the window handle is cached, use Refresh beforehand to guarantee that you'll retrieve the current handle.

Свойство можно получить MainWindowHandle только для процессов, запущенных на локальном компьютере.You can get the MainWindowHandle property only for processes that are running on the local computer. MainWindowHandleСвойство — это значение, уникально идентифицирующее окно, связанное с процессом.The MainWindowHandle property is a value that uniquely identifies the window that is associated with the process.

С процессом связано главное окно, только если процесс имеет графический интерфейс.A process has a main window associated with it only if the process has a graphical interface. Если связанный процесс не имеет главного окна, MainWindowHandle это значение равно нулю.If the associated process does not have a main window, the MainWindowHandle value is zero. Значение также равно нулю для процессов, которые были скрыты, то есть процессов, которые не отображаются на панели задач.The value is also zero for processes that have been hidden, that is, processes that are not visible in the taskbar. Это может быть так для процессов, которые отображаются в виде значков в области уведомлений в правом углу панели задач.This can be the case for processes that appear as icons in the notification area, at the far right of the taskbar.

Если вы только что начали процесс и хотите использовать его основной обработчик окна, рассмотрите возможность использования WaitForInputIdle метода для завершения процесса запуска, гарантируя создание обработчика основного окна.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. В противном случае будет создаваться исключение.Otherwise, an exception will be thrown.

Применяется к

См. также раздел