Interaction.AppActivate Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Aktiviert eine Anwendung, die bereits ausgeführt wird.
Überlädt
| Name | Beschreibung |
|---|---|
| AppActivate(Int32) |
Aktiviert eine Anwendung, die bereits ausgeführt wird. |
| AppActivate(String) |
Aktiviert eine Anwendung, die bereits ausgeführt wird. |
AppActivate(Int32)
Aktiviert eine Anwendung, die bereits ausgeführt wird.
public:
static void AppActivate(int ProcessId);public static void AppActivate(int ProcessId);static member AppActivate : int -> unitPublic Sub AppActivate (ProcessId As Integer)Parameter
- ProcessId
- Int32
Integer Angeben der Win32-Prozess-ID-Nummer, die diesem Prozess zugewiesen ist. Sie können die id verwenden, die von der Shell(String, AppWinStyle, Boolean, Int32), vorausgesetzt, sie ist nicht 0.
Beispiele
In diesem Beispiel werden verschiedene Verwendungsmöglichkeiten der AppActivate Funktion zum Aktivieren eines Anwendungsfensters veranschaulicht. Wenn kein Notepad-Prozess ausgeführt wird, wirft das Beispiel eine ArgumentException. Bei der Shell Prozedur wird davon ausgegangen, 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
Sie verwenden die Verwendung AppActivate , um das aktive Fenster einer Anwendung in den Fokus zu bringen. 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 diesem 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 jedoch nicht darauf aus, ob sie maximiert oder minimiert wird. Der Fokus wird vom aktivierten Anwendungsfenster entfernt, 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 die Fensterformatvorlage festzulegen.
Wenn Sie den Title Parameter verwenden, wird ein Vergleich zwischen Groß- und Kleinschreibung verwendet, AppActivate andernfalls ist eine genaue Übereinstimmung mit dem Inhalt der Titelleiste erforderlich. Sie durchsieht zuerst die Fenster der obersten Ebene und dann durch die untergeordneten Fenster. Wenn eine Übereinstimmung nicht gefunden werden kann, löst sie eine ArgumentException.
Sie können nur für Prozesse verwenden AppActivate , die Fenster besitzen. Die meisten Konsolenanwendungen besitzen keine Fenster, was bedeutet, dass sie nicht in der Liste der Prozesse angezeigt werden, die durchsucht werden AppActivate . Beim Ausführen aus einer Konsolenanwendung erstellt das System einen separaten Prozess zum Ausführen der Anwendung und gibt die Ausgabe an den Konsolenprozess zurück. Wenn Sie daher die aktuelle Prozess-ID anfordern, erhalten Sie die Prozess-ID dieses separaten Prozesses anstelle der Prozess-ID der Konsolenanwendung.
Zur Laufzeit aktiviert die AppActivate Funktion jede ausgeführte Anwendung mit einem Titel, der mit einer Prozess-ID übereinstimmt Title , die übereinstimmt ProcessId. Wenn keine genaue Übereinstimmung vorhanden ist, wird eine Anwendung aktiviert, deren Titelzeichenfolge mit Title. Wenn mehrere Anwendungen mit dem Namen angegeben Titlesind, wählt die AppActivate Funktion willkürlich eine anwendung aus, die aktiviert werden soll.
Note
Die AppActivate Funktion erfordert UIPermission auf der SafeTopLevelWindows Ebene, die sich auf die Ausführung in teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter UIPermission.
Weitere Informationen
Gilt für:
AppActivate(String)
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 -> unitPublic Sub AppActivate (Title As String)Parameter
- Title
- String
String Ausdruck, der den Titel in der Titelleiste der Anwendung angibt, die Sie aktivieren möchten. Sie können den Titel verwenden, der der Anwendung zugewiesen wurde, als sie gestartet wurde.
Beispiele
In diesem Beispiel werden verschiedene Verwendungsmöglichkeiten der AppActivate Funktion zum Aktivieren eines Anwendungsfensters veranschaulicht. Wenn kein Notepad-Prozess ausgeführt wird, wirft das Beispiel eine ArgumentException. Bei der Shell Prozedur wird davon ausgegangen, 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
Sie verwenden die Verwendung AppActivate , um das aktive Fenster einer Anwendung in den Fokus zu bringen. 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 diesem 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 jedoch nicht darauf aus, ob sie maximiert oder minimiert wird. Der Fokus wird vom aktivierten Anwendungsfenster entfernt, 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 die Fensterformatvorlage festzulegen.
Wenn Sie den Title Parameter verwenden, wird ein Vergleich zwischen Groß- und Kleinschreibung verwendet, AppActivate andernfalls ist eine genaue Übereinstimmung mit dem Inhalt der Titelleiste erforderlich. Sie durchsieht zuerst die Fenster der obersten Ebene und dann durch die untergeordneten Fenster. Wenn eine Übereinstimmung nicht gefunden werden kann, löst sie eine ArgumentException.
Sie können nur für Prozesse verwenden AppActivate , die Fenster besitzen. Die meisten Konsolenanwendungen besitzen keine Fenster, was bedeutet, dass sie nicht in der Liste der Prozesse angezeigt werden, die durchsucht werden AppActivate . Beim Ausführen aus einer Konsolenanwendung erstellt das System einen separaten Prozess zum Ausführen der Anwendung und gibt die Ausgabe an den Konsolenprozess zurück. Wenn Sie daher die aktuelle Prozess-ID anfordern, erhalten Sie die Prozess-ID dieses separaten Prozesses anstelle der Prozess-ID der Konsolenanwendung.
Zur Laufzeit aktiviert die AppActivate Funktion jede ausgeführte Anwendung mit einem Titel, der mit einer Prozess-ID übereinstimmt Title , die übereinstimmt ProcessId. Wenn keine genaue Übereinstimmung vorhanden ist, wird eine Anwendung aktiviert, deren Titelzeichenfolge mit Title. Wenn mehrere Anwendungen mit dem Namen angegeben Titlesind, wählt die AppActivate Funktion willkürlich eine anwendung aus, die aktiviert werden soll.
Note
Die AppActivate Funktion erfordert UIPermission auf der SafeTopLevelWindows Ebene, die sich auf die Ausführung in teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter UIPermission.