Freigeben über


Interaction.AppActivate Methode

Definition

Aktiviert eine Anwendung, die bereits ausgeführt wird.

Überlädt

AppActivate(Int32)

Aktiviert eine Anwendung, die bereits ausgeführt wird.

AppActivate(String)

Aktiviert eine Anwendung, die bereits ausgeführt wird.

AppActivate(Int32)

Quelle:
Interaction.vb
Quelle:
Interaction.vb
Quelle:
Interaction.vb

Aktiviert eine Anwendung, die bereits ausgeführt wird.

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

Parameter

ProcessId
Int32

Integer zum Angeben der diesem Prozess zugewiesene Win32-Prozess-ID. Sie können die von der Shell(String, AppWinStyle, Boolean, Int32) zurückgegebene ID verwenden, sofern diese nicht 0 (null) ist.

Beispiele

In diesem Beispiel werden verschiedene Verwendungsmöglichkeiten der AppActivate Funktion zum Aktivieren eines Anwendungsfensters veranschaulicht. Wenn ein Editor-Prozess nicht ausgeführt wird, löst das Beispiel eine ArgumentException aus. Die Shell-Prozedur geht davon aus, dass sich die Anwendungen in den angegebenen Pfaden befinden.

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)

Hinweise

AppActivate Verwenden Sie, um das aktive Fenster einer Anwendung in den Fokus zu rücken. Möglicherweise verfügen Sie nicht über ein Handle oder einen Verweis auf das aktive Fenster oder wissen sogar, welches Fenster zu einem bestimmten Zeitpunkt aktiv ist. In einem solchen Fall können Sie die Focus -Methode nicht verwenden.

Die AppActivate Funktion ändert den Fokus auf die benannte Anwendung oder das benannte Fenster, wirkt sich aber nicht darauf aus, ob sie maximiert oder minimiert wird. Der Fokus entfernt sich vom aktivierten Anwendungsfenster, wenn der Benutzer eine Aktion ausführt, um den Fokus zu ändern oder das Fenster zu schließen. Sie können die Shell Funktion verwenden, um eine Anwendung zu starten und den Fensterstil festzulegen.

Wenn Sie den Title -Parameter verwenden, wird ein Vergleich ohne Beachtung der Groß-/Kleinschreibung verwendet, AppActivate andernfalls ist eine genaue Übereinstimmung mit dem Inhalt der Titelleiste erforderlich. Zunächst werden die Fenster der obersten Ebene und dann die untergeordneten Fenster durchgeblickt. Wenn keine Übereinstimmung gefunden werden kann, wird ein ArgumentExceptionausgelöst.

Sie können nur mit Prozessen verwenden AppActivate , die Fenster besitzen. Die meisten Konsolenanwendungen besitzen keine Fenster, was bedeutet, dass sie nicht in der Liste der Prozesse angezeigt werden, die AppActivate durchsucht werden. Beim Ausführen von einer Konsolenanwendung erstellt das System einen separaten Prozess zum Ausführen der Anwendung und gibt die Ausgabe an den Konsolenprozess zurück. Wenn Sie also die aktuelle Prozess-ID anfordern, erhalten Sie die Prozess-ID dieses separaten Prozesses und nicht die Prozess-ID der Konsolenanwendung.

Zur Laufzeit aktiviert die AppActivate Funktion jede ausgeführte Anwendung mit einem Titel, der mit oder mit einer Prozess-ID übereinstimmt Title , die mit übereinstimmt ProcessId. Wenn keine genaue Übereinstimmung vorhanden ist, wird jede Anwendung aktiviert, deren Titelzeichenfolge mit Titleendet. Wenn es mehrere Anwendungen mit dem Namen gibt Title, wählt die AppActivate Funktion willkürlich eine aus, die aktiviert werden soll.

Hinweis

Die AppActivate Funktion benötigt UIPermission auf der SafeTopLevelWindows Ebene, was sich auf ihre Ausführung in Teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter UIPermission.

Weitere Informationen

Gilt für:

AppActivate(String)

Quelle:
Interaction.vb
Quelle:
Interaction.vb
Quelle:
Interaction.vb

Aktiviert eine Anwendung, die bereits ausgeführt wird.

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

Parameter

Title
String

String-Ausdruck, der den Titel auf der Titelleiste der Anwendung angibt, die Sie aktivieren möchten. Sie können den der Anwendung beim Start zugewiesenen Titel verwenden.

Beispiele

In diesem Beispiel werden verschiedene Verwendungsmöglichkeiten der AppActivate Funktion zum Aktivieren eines Anwendungsfensters veranschaulicht. Wenn ein Editor-Prozess nicht ausgeführt wird, löst das Beispiel eine ArgumentException aus. Die Shell-Prozedur geht davon aus, dass sich die Anwendungen in den angegebenen Pfaden befinden.

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)

Hinweise

AppActivate Verwenden Sie, um das aktive Fenster einer Anwendung in den Fokus zu rücken. Möglicherweise verfügen Sie nicht über ein Handle oder einen Verweis auf das aktive Fenster oder wissen sogar, welches Fenster zu einem bestimmten Zeitpunkt aktiv ist. In einem solchen Fall können Sie die Focus -Methode nicht verwenden.

Die AppActivate Funktion ändert den Fokus auf die benannte Anwendung oder das benannte Fenster, wirkt sich aber nicht darauf aus, ob sie maximiert oder minimiert wird. Der Fokus entfernt sich vom aktivierten Anwendungsfenster, wenn der Benutzer eine Aktion ausführt, um den Fokus zu ändern oder das Fenster zu schließen. Sie können die Shell Funktion verwenden, um eine Anwendung zu starten und den Fensterstil festzulegen.

Wenn Sie den Title -Parameter verwenden, wird ein Vergleich ohne Beachtung der Groß-/Kleinschreibung verwendet, AppActivate andernfalls ist eine genaue Übereinstimmung mit dem Inhalt der Titelleiste erforderlich. Zunächst werden die Fenster der obersten Ebene und dann die untergeordneten Fenster durchgeblickt. Wenn keine Übereinstimmung gefunden werden kann, wird ein ArgumentExceptionausgelöst.

Sie können nur mit Prozessen verwenden AppActivate , die Fenster besitzen. Die meisten Konsolenanwendungen besitzen keine Fenster, was bedeutet, dass sie nicht in der Liste der Prozesse angezeigt werden, die AppActivate durchsucht werden. Beim Ausführen von einer Konsolenanwendung erstellt das System einen separaten Prozess zum Ausführen der Anwendung und gibt die Ausgabe an den Konsolenprozess zurück. Wenn Sie also die aktuelle Prozess-ID anfordern, erhalten Sie die Prozess-ID dieses separaten Prozesses und nicht die Prozess-ID der Konsolenanwendung.

Zur Laufzeit aktiviert die AppActivate Funktion jede ausgeführte Anwendung mit einem Titel, der mit oder mit einer Prozess-ID übereinstimmt Title , die mit übereinstimmt ProcessId. Wenn keine genaue Übereinstimmung vorhanden ist, wird jede Anwendung aktiviert, deren Titelzeichenfolge mit Titleendet. Wenn es mehrere Anwendungen mit dem Namen gibt Title, wählt die AppActivate Funktion willkürlich eine aus, die aktiviert werden soll.

Hinweis

Die AppActivate Funktion benötigt UIPermission auf der SafeTopLevelWindows Ebene, was sich auf ihre Ausführung in Teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter UIPermission.

Weitere Informationen

Gilt für: