Interaction.AppActivate Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Ativa uma aplicação que já está a correr.

Sobrecargas

Name Description
AppActivate(Int32)

Ativa uma aplicação que já está a correr.
AppActivate(String)

Ativa uma aplicação que já está a correr.

AppActivate(Int32)

Ativa uma aplicação que já está a correr.

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 a este processo. Pode usar o ID devolvido pelo Shell(String, AppWinStyle, Boolean, Int32), desde que não seja zero.

Exemplos

Este exemplo ilustra várias utilizações da AppActivate função para ativar uma janela de aplicação. Se um processo do Bloco de Notas não estiver a correr, o exemplo lança um ArgumentExceptionarquivo . O Shell procedimento assume que as aplicações estão 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)

Observações

Usas AppActivate para focar a janela ativa de uma aplicação. Pode não ter um handle ou uma referência à janela ativa, ou sequer saber qual janela está ativa num dado momento. Nesse caso, não pode usar o Focus método.

A AppActivate função altera o foco para a aplicação ou janela nomeada, mas não afeta se é maximizada ou minimizada. O foco afasta-se da janela da aplicação ativada quando o utilizador toma alguma ação para alterar o foco ou fechar a janela. Podes usar a Shell função para iniciar uma aplicação e definir o estilo da janela.

Se usares o Title parâmetro, AppActivate usa uma comparação insensível a maiúsculas, mas de resto requer uma correspondência exata com o conteúdo da barra de título. Primeiro olha pelas janelas do nível superior e depois pelas janelas crianças. Se não conseguir encontrar uma correspondência, lança um ArgumentException.

Só podes usar AppActivate com processos que possuem janelas. A maioria das aplicações de consola não possui janelas, o que significa que não aparecem na lista de processos que AppActivate pesquisam. Ao ser executado a partir de uma aplicação de consola, o sistema cria um processo separado para executar a aplicação e devolve a saída ao processo de consola. Consequentemente, quando solicita o ID do processo atual, obtém o ID do processo separado, em vez do ID do processo da aplicação de consola.

Em tempo de execução, a AppActivate função ativa qualquer aplicação em execução com um título que corresponda Title ou com um ID de processo que corresponda ProcessIda . Se não houver correspondência exata, ativa qualquer aplicação cuja cadeia de títulos termine em Title. Se existirem mais do que uma aplicação nomeada Title, a AppActivate função escolhe arbitrariamente uma a ativar.

Note

A AppActivate função requer UIPermission ao SafeTopLevelWindows nível, o que pode afetar a sua execução em situações de confiança parcial. Para obter mais informações, consulte UIPermission .

Ver também

Aplica-se a

AppActivate(String)

Ativa uma aplicação que já está a correr.

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

String Expressão que especifica o título na barra de título da aplicação que queres ativar. Pode usar o título atribuído à aplicação quando foi lançada.

Exemplos

Este exemplo ilustra várias utilizações da AppActivate função para ativar uma janela de aplicação. Se um processo do Bloco de Notas não estiver a correr, o exemplo lança um ArgumentExceptionarquivo . O Shell procedimento assume que as aplicações estão 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)

Observações

Usas AppActivate para focar a janela ativa de uma aplicação. Pode não ter um handle ou uma referência à janela ativa, ou sequer saber qual janela está ativa num dado momento. Nesse caso, não pode usar o Focus método.

A AppActivate função altera o foco para a aplicação ou janela nomeada, mas não afeta se é maximizada ou minimizada. O foco afasta-se da janela da aplicação ativada quando o utilizador toma alguma ação para alterar o foco ou fechar a janela. Podes usar a Shell função para iniciar uma aplicação e definir o estilo da janela.

Se usares o Title parâmetro, AppActivate usa uma comparação insensível a maiúsculas, mas de resto requer uma correspondência exata com o conteúdo da barra de título. Primeiro olha pelas janelas do nível superior e depois pelas janelas crianças. Se não conseguir encontrar uma correspondência, lança um ArgumentException.

Só podes usar AppActivate com processos que possuem janelas. A maioria das aplicações de consola não possui janelas, o que significa que não aparecem na lista de processos que AppActivate pesquisam. Ao ser executado a partir de uma aplicação de consola, o sistema cria um processo separado para executar a aplicação e devolve a saída ao processo de consola. Consequentemente, quando solicita o ID do processo atual, obtém o ID do processo separado, em vez do ID do processo da aplicação de consola.

Em tempo de execução, a AppActivate função ativa qualquer aplicação em execução com um título que corresponda Title ou com um ID de processo que corresponda ProcessIda . Se não houver correspondência exata, ativa qualquer aplicação cuja cadeia de títulos termine em Title. Se existirem mais do que uma aplicação nomeada Title, a AppActivate função escolhe arbitrariamente uma a ativar.

Note

A AppActivate função requer UIPermission ao SafeTopLevelWindows nível, o que pode afetar a sua execução em situações de confiança parcial. Para obter mais informações, consulte UIPermission .

Ver também

Aplica-se a