Process.WaitForInputIdle Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Faz com que o componente Process aguarde até o processo associado entrar em um estado ocioso.
Sobrecargas
| WaitForInputIdle() |
Faz com que o componente Process aguarde por tempo indefinido até que o processo associado entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem. |
| WaitForInputIdle(Int32) |
Faz com que o componente Process a aguarde o número especificado de milissegundos para que o processo entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem. |
| WaitForInputIdle(TimeSpan) |
Faz com que o Process componente aguarde o especificado |
WaitForInputIdle()
- Origem:
- Process.cs
- Origem:
- Process.cs
- Origem:
- Process.cs
Faz com que o componente Process aguarde por tempo indefinido até que o processo associado entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.
public:
bool WaitForInputIdle();public bool WaitForInputIdle ();member this.WaitForInputIdle : unit -> boolPublic Function WaitForInputIdle () As BooleanRetornos
true se o processo associado tiver atingido um estado ocioso.
Exceções
O processo não tem uma interface gráfica.
- ou -
Erro desconhecido. O processo não conseguiu entrar em um estado ocioso.
- ou -
O processo já terminou.
- ou -
Nenhum processo está associado a esse objeto Process.
Comentários
Use WaitForInputIdle() para forçar o processamento do aplicativo a aguardar até que o loop de mensagem retorne ao estado ocioso. Quando um processo com uma interface do usuário está em execução, seu loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional. Em seguida, o processo retorna ao loop de mensagem. Diz-se que um processo está em um estado ocioso quando está aguardando mensagens dentro de um loop de mensagem. Esse estado é útil, por exemplo, quando seu aplicativo precisa aguardar até que um processo inicial termine de criar sua janela main antes que o aplicativo se comunique com essa janela.
Se um processo não tiver um loop de mensagem, WaitForInputIdle() gerará um InvalidOperationException.
A WaitForInputIdle() sobrecarga instrui o Process componente a aguardar indefinidamente para que o processo fique ocioso no loop de mensagem. Essa instrução pode fazer com que um aplicativo pare de responder. Por exemplo, se o processo for gravado para sempre sair de seu loop de mensagem imediatamente, como no fragmento while(true)de código .
Confira também
Aplica-se a
WaitForInputIdle(Int32)
- Origem:
- Process.cs
- Origem:
- Process.cs
- Origem:
- Process.cs
Faz com que o componente Process a aguarde o número especificado de milissegundos para que o processo entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.
public:
bool WaitForInputIdle(int milliseconds);public bool WaitForInputIdle (int milliseconds);member this.WaitForInputIdle : int -> boolPublic Function WaitForInputIdle (milliseconds As Integer) As BooleanParâmetros
- milliseconds
- Int32
Um valor de 1 a Int32.MaxValue que especifica a quantidade de tempo, em milissegundos, para aguardar o processo associado ficar ocioso. Um valor de 0 especifica um retorno imediato e um valor de -1 especifica uma espera infinita.
Retornos
true se o processo associado tiver atingido um estado ocioso; caso contrário, false.
Exceções
O processo não tem uma interface gráfica.
- ou -
Erro desconhecido. O processo não conseguiu entrar em um estado ocioso.
- ou -
O processo já terminou.
- ou -
Nenhum processo está associado a esse objeto Process.
Comentários
Use WaitForInputIdle(Int32) para forçar o processamento do aplicativo a aguardar até que o loop de mensagem retorne ao estado ocioso. Quando um processo com uma interface do usuário está em execução, seu loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional. Em seguida, o processo retorna ao loop de mensagem. Diz-se que um processo está em um estado ocioso quando está aguardando mensagens dentro de um loop de mensagem. Esse estado é útil, por exemplo, quando seu aplicativo precisa aguardar até que um processo inicial termine de criar sua janela main antes que o aplicativo se comunique com essa janela.
Se um processo não tiver um loop de mensagem, WaitForInputIdle(Int32) gerará um InvalidOperationException.
A WaitForInputIdle(Int32) sobrecarga instrui o Process componente a aguardar uma quantidade finita de tempo para que o processo fique ocioso no loop de mensagem. Se o processo associado não ficar ocioso até o final do intervalo porque o loop ainda está processando mensagens, false será retornado ao procedimento de chamada.
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.
Confira também
Aplica-se a
WaitForInputIdle(TimeSpan)
- Origem:
- Process.cs
- Origem:
- Process.cs
- Origem:
- Process.cs
Faz com que o Process componente aguarde o especificado timeout para que o processo associado entre em um estado ocioso.
Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.
public:
bool WaitForInputIdle(TimeSpan timeout);public bool WaitForInputIdle (TimeSpan timeout);member this.WaitForInputIdle : TimeSpan -> boolPublic Function WaitForInputIdle (timeout As TimeSpan) As BooleanParâmetros
- timeout
- TimeSpan
O período de tempo, em milissegundos, para esperar que o processo associado fique ocioso.
Retornos
true se o processo associado tiver atingido um estado ocioso; caso contrário, false.
Exceções
O processo não tem uma interface gráfica.
- ou -
Erro desconhecido. O processo não conseguiu entrar em um estado ocioso.
- ou -
O processo já terminou.
- ou -
Nenhum processo está associado a esse objeto Process.
Comentários
Use WaitForInputIdle(TimeSpan) para forçar o processamento do aplicativo a aguardar até que o loop de mensagem retorne ao estado ocioso.
Quando um processo com uma interface do usuário está em execução, seu loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional.
Em seguida, o processo retorna ao loop de mensagem. Diz-se que um processo está em um estado ocioso quando está aguardando mensagens dentro de um loop de mensagem.
Esse estado é útil, por exemplo, quando seu aplicativo precisa aguardar até que um processo inicial termine de criar sua janela main antes que o aplicativo se comunique com essa janela.
