Interaction.AppActivate Metod

Definition

Namnområde:
Microsoft.VisualBasic
Sammansättning:
Microsoft.VisualBasic.Core.dll
Sammansättning:
Microsoft.VisualBasic.dll

Aktiverar ett program som redan körs.

Överlagringar

Name Description
AppActivate(Int32)

Aktiverar ett program som redan körs.
AppActivate(String)

Aktiverar ett program som redan körs.

AppActivate(Int32)

Källa:
Interaction.vb
Källa:
Interaction.vb
Källa:
Interaction.vb
Källa:
Interaction.vb
Källa:
Interaction.vb

Aktiverar ett program som redan körs.

public:
 static void AppActivate(int ProcessId);
public static void AppActivate(int ProcessId);
static member AppActivate : int -> unit
Public Sub AppActivate (ProcessId As Integer)

Parametrar

ProcessId
Int32

Integer ange det Win32-process-ID som tilldelats den här processen. Du kan använda det ID som returneras av Shell(String, AppWinStyle, Boolean, Int32), förutsatt att det inte är noll.

Exempel

Det här exemplet illustrerar olika användningar av AppActivate funktionen för att aktivera ett programfönster. Om en Anteckningar-process inte körs genererar exemplet en ArgumentException. Proceduren Shell förutsätter att programmen finns i de angivna sökvägarna.

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)

Kommentarer

Du använder AppActivate för att sätta ett programs aktiva fönster i fokus. Du kanske inte har ett handtag eller en referens till det aktiva fönstret, eller ens vet vilket fönster som är aktivt vid en viss tidpunkt. I sådana fall kan du inte använda Focus metoden.

Funktionen AppActivate ändrar fokus till det namngivna programmet eller fönstret men påverkar inte om det maximeras eller minimeras. Fokus flyttas bort från det aktiverade programfönstret när användaren vidtar åtgärder för att ändra fokus eller stänga fönstret. Du kan använda Shell funktionen för att starta ett program och ange fönsterformatet.

Om du använder parametern TitleAppActivate använder du en skiftlägeskänslig jämförelse men kräver annars en exakt matchning med innehållet i namnlisten. Den tittar först genom de översta fönstren och sedan genom de underordnade fönstren. Om den inte kan hitta en matchning utlöser den en ArgumentException.

Du kan bara använda AppActivate med processer som äger fönster. De flesta konsolprogram äger inte fönster, vilket innebär att de inte visas i listan över processer som AppActivate söker. När du kör från ett konsolprogram skapar systemet en separat process för att köra programmet och returnerar utdata till konsolprocessen. När du begär det aktuella process-ID:t får du därför process-ID:t för den här separata processen i stället för konsolprogrammets process-ID.

Vid körning AppActivate aktiverar funktionen alla program som körs med en rubrik som matchar Title eller med ett process-ID som matchar ProcessId. Om det inte finns någon exakt matchning aktiveras alla program vars rubriksträng slutar med Title. Om det finns fler än ett program med namnet TitleAppActivate väljer funktionen godtyckligt en som ska aktiveras.

Note

Funktionen AppActivate kräver UIPermission på nivån SafeTopLevelWindows , vilket kan påverka dess körning i situationer med partiellt förtroende. Mer information finns i UIPermission .

Se även

Gäller för

AppActivate(String)

Källa:
Interaction.vb
Källa:
Interaction.vb
Källa:
Interaction.vb
Källa:
Interaction.vb
Källa:
Interaction.vb

Aktiverar ett program som redan körs.

public:
 static void AppActivate(System::String ^ Title);
public static void AppActivate(string Title);
static member AppActivate : string -> unit
Public Sub AppActivate (Title As String)

Parametrar

Title
String

String uttryck som anger rubriken i namnlisten för det program som du vill aktivera. Du kan använda rubriken som tilldelades programmet när det startades.

Exempel

Det här exemplet illustrerar olika användningar av AppActivate funktionen för att aktivera ett programfönster. Om en Anteckningar-process inte körs genererar exemplet en ArgumentException. Proceduren Shell förutsätter att programmen finns i de angivna sökvägarna.

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)

Kommentarer

Du använder AppActivate för att sätta ett programs aktiva fönster i fokus. Du kanske inte har ett handtag eller en referens till det aktiva fönstret, eller ens vet vilket fönster som är aktivt vid en viss tidpunkt. I sådana fall kan du inte använda Focus metoden.

Funktionen AppActivate ändrar fokus till det namngivna programmet eller fönstret men påverkar inte om det maximeras eller minimeras. Fokus flyttas bort från det aktiverade programfönstret när användaren vidtar åtgärder för att ändra fokus eller stänga fönstret. Du kan använda Shell funktionen för att starta ett program och ange fönsterformatet.

Om du använder parametern TitleAppActivate använder du en skiftlägeskänslig jämförelse men kräver annars en exakt matchning med innehållet i namnlisten. Den tittar först genom de översta fönstren och sedan genom de underordnade fönstren. Om den inte kan hitta en matchning utlöser den en ArgumentException.

Du kan bara använda AppActivate med processer som äger fönster. De flesta konsolprogram äger inte fönster, vilket innebär att de inte visas i listan över processer som AppActivate söker. När du kör från ett konsolprogram skapar systemet en separat process för att köra programmet och returnerar utdata till konsolprocessen. När du begär det aktuella process-ID:t får du därför process-ID:t för den här separata processen i stället för konsolprogrammets process-ID.

Vid körning AppActivate aktiverar funktionen alla program som körs med en rubrik som matchar Title eller med ett process-ID som matchar ProcessId. Om det inte finns någon exakt matchning aktiveras alla program vars rubriksträng slutar med Title. Om det finns fler än ett program med namnet TitleAppActivate väljer funktionen godtyckligt en som ska aktiveras.

Note

Funktionen AppActivate kräver UIPermission på nivån SafeTopLevelWindows , vilket kan påverka dess körning i situationer med partiellt förtroende. Mer information finns i UIPermission .

Se även

Gäller för