Process.MainWindowHandle Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.Process.dll

Исходный код:

Process.Unix.cs

Получает дескриптор главного окна связанного процесса.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };

public IntPtr MainWindowHandle { get; }

member this.MainWindowHandle : nativeint

Public ReadOnly Property MainWindowHandle As IntPtr

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

IntPtr

nativeint

Созданный системой дескриптор главного окна связанного процесса.

Исключения

InvalidOperationException

Свойство MainWindowHandle не определено, так как процесс завершился.

NotSupportedException

Вы пытаетесь получить доступ к свойству MainWindowHandle процесса, запущенного на удаленном компьютере. Это свойство доступно только для процессов, запущенных на локальном компьютере.

Комментарии

Окно main — это окно, открытое процессом, который в данный момент находится в фокусе TopLevel (форма). Для обновления Process объекта необходимо использовать Refresh метод , чтобы получить наиболее актуальный main дескриптор окна, если он был изменен. Как правило, так как дескриптор окна кэширован, используйте Refresh заранее, чтобы гарантировать, что вы получите текущий дескриптор.

Свойство можно получить MainWindowHandle только для процессов, выполняющихся на локальном компьютере. Свойство MainWindowHandle является значением, уникальным образом определяющим окно, связанное с процессом.

Процесс имеет окно main, связанное с ним, только если процесс имеет графический интерфейс. Если связанный процесс не имеет окна main, значение равно нулюMainWindowHandle. Значение также равно нулю для скрытых процессов, то есть процессов, которые не видны на панели задач. Это может быть для процессов, которые отображаются в виде значков в области уведомлений в правой части панели задач.

Если вы только что начали процесс и хотите использовать его main дескриптор окна, рассмотрите WaitForInputIdle возможность использования метода , чтобы процесс завершился, убедись, что дескриптор окна main был создан. В противном случае будет создаваться исключение.

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

• MainWindowTitle
• MainModule