Interaction.AppActivate Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Ativa um aplicativo que já está em execução.

Sobrecargas

AppActivate(Int32)	Ativa um aplicativo que já está em execução.
AppActivate(String)	Ativa um aplicativo que já está em execução.

AppActivate(Int32)

Origem:

Interaction.vb

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 -> unit

Public Sub AppActivate (ProcessId As Integer)

Parâmetros

ProcessId

Int32

Integer especificando o número de identificação do processo Win32 atribuído ao processo. Você pode usar a identificação 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 procedimento Shell 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. Talvez você não tenha um identificador ou uma referência à janela ativa ou mesmo saiba 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 ele é maximizado ou minimizado. O foco se afasta da janela do aplicativo ativado quando o usuário executa 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 , usará uma comparação que não diferencia maiúsculas de minúsculas, AppActivate mas, caso contrário, exigirá uma correspondência exata com o conteúdo da barra de título. Primeiro, ele 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ê só pode usar AppActivate 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 de 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 corresponda Title ou com uma ID de processo que corresponda ProcessIda . Se não houver correspondência exata, ele ativará qualquer aplicativo cuja cadeia de caracteres de título termine com Title. Se houver mais de um aplicativo chamado 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

• Shell(String, AppWinStyle, Boolean, Int32)
• Focus()
• ArgumentException

AppActivate(String)

Origem:

Interaction.vb

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 -> unit

Public Sub AppActivate (Title As String)

Parâmetros

Title

String

Expressão String que especifica o título na barra de título do aplicativo que você deseja ativar. Você poderá 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 procedimento Shell 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. Talvez você não tenha um identificador ou uma referência à janela ativa ou mesmo saiba 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 ele é maximizado ou minimizado. O foco se afasta da janela do aplicativo ativado quando o usuário executa 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 , usará uma comparação que não diferencia maiúsculas de minúsculas, AppActivate mas, caso contrário, exigirá uma correspondência exata com o conteúdo da barra de título. Primeiro, ele 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ê só pode usar AppActivate 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 de 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 corresponda Title ou com uma ID de processo que corresponda ProcessIda . Se não houver correspondência exata, ele ativará qualquer aplicativo cuja cadeia de caracteres de título termine com Title. Se houver mais de um aplicativo chamado 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

• Shell(String, AppWinStyle, Boolean, Int32)
• Focus()
• ArgumentException