Process.MainWindowHandle Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает дескриптор окна главного окна связанного процесса.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrЗначение свойства
nativeint
Дескриптор окна, созданного системой, основного окна связанного процесса.
Исключения
Значение MainWindowHandle не определено, так как процесс завершился.
Вы пытаетесь получить доступ к свойству MainWindowHandle для процесса, работающего на удаленном компьютере. Это свойство доступно только для процессов, выполняемых на локальном компьютере.
Комментарии
Главное окно — это окно, открытое процессом, который в настоящее время имеет фокус ( TopLevel форму). Чтобы обновить объект, необходимо использовать Refresh метод, чтобы Process получить самый актуальный дескриптор главного окна, если он изменился. Как правило, так как дескриптор окна кэшируется, используйте Refresh заранее, чтобы гарантировать, что вы получите текущий дескриптор.
Свойство можно получить MainWindowHandle только для процессов, выполняемых на локальном компьютере. Это MainWindowHandle значение, однозначно определяющее окно, связанное с процессом.
Процесс имеет главное окно, связанное с ним, только если процесс имеет графический интерфейс. Если связанный процесс не имеет главного окна, MainWindowHandle значение равно нулю. Значение также равно нулю для процессов, которые были скрыты, то есть процессы, которые не отображаются на панели задач. Это может быть делом для процессов, которые отображаются как значки в области уведомлений в правой части панели задач.
Если вы только что запустили процесс и хотите использовать его основной дескриптор окна, рассмотрите возможность использования WaitForInputIdle метода, чтобы процесс был завершен, гарантируя создание дескриптора главного окна. В противном случае возникнет исключение .
