Process.WaitForInputIdle Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Дает компоненту Process команду ожидать входа связанного процесса в состояние простоя.
Перегрузки
| WaitForInputIdle() |
Дает компоненту Process команду ожидать перехода связанного процесса в состояние простоя в течение неограниченного времени. Эта перегрузка применяется только к процессам с пользовательским интерфейсом и, следовательно, с циклом сообщений. |
| WaitForInputIdle(Int32) |
Дает компоненту Process команду ожидать входа связанного процесса в состояние простоя в течение указанного времени в миллисекундах. Эта перегрузка применяется только к процессам с пользовательским интерфейсом и, следовательно, с циклом сообщений. |
WaitForInputIdle()
Дает компоненту Process команду ожидать перехода связанного процесса в состояние простоя в течение неограниченного времени. Эта перегрузка применяется только к процессам с пользовательским интерфейсом и, следовательно, с циклом сообщений.
public:
bool WaitForInputIdle();public bool WaitForInputIdle ();member this.WaitForInputIdle : unit -> boolPublic Function WaitForInputIdle () As BooleanВозвращаемое значение
Значение true, если связанный процесс достиг состояния простоя.
Исключения
Процесс не имеет графического интерфейса.
-или- Произошла неизвестная ошибка. Процессу не удалось перейти в состояние бездействия.
-или- Этот процесс уже завершился.
-или- Нет процессов, связанных с этим объектом Process.
Комментарии
Используется для WaitForInputIdle() принудительной обработки приложения, пока цикл сообщений не вернется в состояние простоя. При выполнении процесса с пользовательским интерфейсом его цикл сообщений выполняется каждый раз, когда Windows сообщение отправляется в процесс операционной системой. Затем процесс возвращается в цикл сообщений. Как сообщается, процесс находится в состоянии простоя, когда он ожидает сообщений внутри цикла сообщений. Это состояние полезно, например, когда приложению необходимо дождаться завершения начального процесса создания главного окна, прежде чем приложение будет взаимодействовать с этим окном.
Если в процессе нет цикла сообщений, WaitForInputIdle() вызывает исключение InvalidOperationException.
Перегрузка WaitForInputIdle() указывает Process компоненту ждать неограниченное время, пока процесс перестает работать в цикле сообщений. Эта инструкция может привести к тому, что приложение перестает отвечать на запросы. Например, если процесс записывается для немедленного выхода из цикла сообщений, как в фрагменте while(true)кода.
См. также раздел
Применяется к
WaitForInputIdle(Int32)
Дает компоненту Process команду ожидать входа связанного процесса в состояние простоя в течение указанного времени в миллисекундах. Эта перегрузка применяется только к процессам с пользовательским интерфейсом и, следовательно, с циклом сообщений.
public:
bool WaitForInputIdle(int milliseconds);public bool WaitForInputIdle (int milliseconds);member this.WaitForInputIdle : int -> boolPublic Function WaitForInputIdle (milliseconds As Integer) As BooleanПараметры
- milliseconds
- Int32
Значение от 1 до MaxValue, определяющее количество времени в миллисекундах, в течение которого ожидается переход связанного процесса в состояние простоя. Значение "0" указывает немедленный возврат, а значение "-1" указывает неопределенно долгое ожидание.
Возвращаемое значение
Значение true, если связанный процесс достиг состояния простоя; в противном случае — значение false.
Исключения
Процесс не имеет графического интерфейса.
-или- Произошла неизвестная ошибка. Процессу не удалось перейти в состояние бездействия.
-или- Этот процесс уже завершился.
-или- Нет процессов, связанных с этим объектом Process.
Комментарии
Используется для WaitForInputIdle(Int32) принудительной обработки приложения, пока цикл сообщений не вернется в состояние простоя. При выполнении процесса с пользовательским интерфейсом его цикл сообщений выполняется каждый раз, когда Windows сообщение отправляется в процесс операционной системой. Затем процесс возвращается в цикл сообщений. Как сообщается, процесс находится в состоянии простоя, когда он ожидает сообщений внутри цикла сообщений. Это состояние полезно, например, когда приложению необходимо дождаться завершения начального процесса создания главного окна, прежде чем приложение будет взаимодействовать с этим окном.
Если в процессе нет цикла сообщений, WaitForInputIdle(Int32) вызывает исключение InvalidOperationException.
Перегрузка WaitForInputIdle(Int32) указывает Process компоненту дождаться ограниченного времени, пока процесс перестает работать в цикле сообщений. Если связанный процесс неактивен к концу интервала, так как цикл по-прежнему обрабатывает сообщения, false возвращается в вызывающую процедуру.
Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".