Interaction.AppActivate 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.
Ativa um aplicativo que já está em execução.
Sobrecargas
| Nome | Description |
|---|---|
| AppActivate(Int32) |
Ativa um aplicativo que já está em execução. |
| AppActivate(String) |
Ativa um aplicativo que já está em execução. |
AppActivate(Int32)
Ativa um aplicativo que já está em execução.
public:
static void AppActivate(int ProcessId);public static void AppActivate(int ProcessId);static member AppActivate : int -> unitPublic Sub AppActivate (ProcessId As Integer)Parâmetros
- ProcessId
- Int32
Integer especificando o número de ID do processo Win32 atribuído a esse processo. Você pode usar a ID retornada pelo Shell(String, AppWinStyle, Boolean, Int32), desde que não seja zero.
Exemplos
Este exemplo ilustra vários usos da AppActivate função para ativar uma janela do aplicativo. Se um processo do Bloco de Notas não estiver em execução, o exemplo gerará um ArgumentException. O Shell procedimento pressupõe que os aplicativos estejam nos caminhos especificados.
Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.
AppActivate(notepadID)
Comentários
Você usa AppActivate para colocar a janela ativa de um aplicativo em foco. Você pode não ter um identificador ou uma referência à janela ativa ou mesmo saber qual janela está ativa em um determinado momento. Nesse caso, você não pode usar o Focus método.
A AppActivate função altera o foco para o aplicativo ou janela nomeado, mas não afeta se ela é maximizada ou minimizada. O foco se afasta da janela do aplicativo ativado quando o usuário toma alguma ação para alterar o foco ou fechar a janela. Você pode usar a Shell função para iniciar um aplicativo e definir o estilo da janela.
Se você usar o Title parâmetro, AppActivate usará uma comparação que não diferencia maiúsculas de minúsculas, mas, caso contrário, exigirá uma correspondência exata com o conteúdo da barra de título. Ele primeiro examina as janelas de nível superior e, em seguida, através das janelas filho. Se ele não conseguir encontrar uma correspondência, ele lançará um ArgumentException.
Você pode usar AppActivate somente com processos que possuem janelas. A maioria dos aplicativos de console não possui janelas, o que significa que eles não aparecem na lista de processos pesquisados AppActivate . Ao executar a partir de um aplicativo de console, o sistema cria um processo separado para executar o aplicativo e retorna a saída para o processo do console. Consequentemente, quando você solicita a ID do processo atual, obtém a ID do processo desse processo separado, em vez da ID do processo do aplicativo de console.
Em tempo de execução, a AppActivate função ativa qualquer aplicativo em execução com um título que corresponde Title ou com uma ID de processo correspondente ProcessId. Se não houver correspondência exata, ele ativará qualquer aplicativo cuja cadeia de caracteres de título termina com Title. Se houver mais de um aplicativo nomeado Title, a AppActivate função escolherá arbitrariamente um para ativar.
Observação
A AppActivate função requer UIPermission no nível, o SafeTopLevelWindows que pode afetar sua execução em situações de confiança parcial. Para obter mais informações, consulte UIPermission.
Confira também
Aplica-se a
AppActivate(String)
Ativa um aplicativo que já está em execução.
public:
static void AppActivate(System::String ^ Title);public static void AppActivate(string Title);static member AppActivate : string -> unitPublic Sub AppActivate (Title As String)Parâmetros
- Title
- String
String expressão especificando o título na barra de título do aplicativo que você deseja ativar. Você pode usar o título atribuído ao aplicativo quando ele foi iniciado.
Exemplos
Este exemplo ilustra vários usos da AppActivate função para ativar uma janela do aplicativo. Se um processo do Bloco de Notas não estiver em execução, o exemplo gerará um ArgumentException. O Shell procedimento pressupõe que os aplicativos estejam nos caminhos especificados.
Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.
AppActivate(notepadID)
Comentários
Você usa AppActivate para colocar a janela ativa de um aplicativo em foco. Você pode não ter um identificador ou uma referência à janela ativa ou mesmo saber qual janela está ativa em um determinado momento. Nesse caso, você não pode usar o Focus método.
A AppActivate função altera o foco para o aplicativo ou janela nomeado, mas não afeta se ela é maximizada ou minimizada. O foco se afasta da janela do aplicativo ativado quando o usuário toma alguma ação para alterar o foco ou fechar a janela. Você pode usar a Shell função para iniciar um aplicativo e definir o estilo da janela.
Se você usar o Title parâmetro, AppActivate usará uma comparação que não diferencia maiúsculas de minúsculas, mas, caso contrário, exigirá uma correspondência exata com o conteúdo da barra de título. Ele primeiro examina as janelas de nível superior e, em seguida, através das janelas filho. Se ele não conseguir encontrar uma correspondência, ele lançará um ArgumentException.
Você pode usar AppActivate somente com processos que possuem janelas. A maioria dos aplicativos de console não possui janelas, o que significa que eles não aparecem na lista de processos pesquisados AppActivate . Ao executar a partir de um aplicativo de console, o sistema cria um processo separado para executar o aplicativo e retorna a saída para o processo do console. Consequentemente, quando você solicita a ID do processo atual, obtém a ID do processo desse processo separado, em vez da ID do processo do aplicativo de console.
Em tempo de execução, a AppActivate função ativa qualquer aplicativo em execução com um título que corresponde Title ou com uma ID de processo correspondente ProcessId. Se não houver correspondência exata, ele ativará qualquer aplicativo cuja cadeia de caracteres de título termina com Title. Se houver mais de um aplicativo nomeado Title, a AppActivate função escolherá arbitrariamente um para ativar.
Observação
A AppActivate função requer UIPermission no nível, o SafeTopLevelWindows que pode afetar sua execução em situações de confiança parcial. Para obter mais informações, consulte UIPermission.