Interaction.AppActivate Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee activeert u een toepassing die al wordt uitgevoerd.
Overloads
| Name | Description |
|---|---|
| AppActivate(Int32) |
Hiermee activeert u een toepassing die al wordt uitgevoerd. |
| AppActivate(String) |
Hiermee activeert u een toepassing die al wordt uitgevoerd. |
AppActivate(Int32)
Hiermee activeert u een toepassing die al wordt uitgevoerd.
public:
static void AppActivate(int ProcessId);public static void AppActivate(int ProcessId);static member AppActivate : int -> unitPublic Sub AppActivate (ProcessId As Integer)Parameters
- ProcessId
- Int32
Integer geef het Win32-proces-id-nummer op dat aan dit proces is toegewezen. U kunt de id gebruiken die wordt geretourneerd door de Shell(String, AppWinStyle, Boolean, Int32), mits deze niet nul is.
Voorbeelden
In dit voorbeeld ziet u verschillende toepassingen van de AppActivate functie om een toepassingsvenster te activeren. Als een Notepad-proces niet actief is, gooit het voorbeeld een ArgumentException. Bij Shell de procedure wordt ervan uitgegaan dat de toepassingen zich in de opgegeven paden bevinden.
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)
Opmerkingen
U gebruikt AppActivate om het actieve venster van een toepassing in de focus te brengen. Mogelijk hebt u geen ingang of verwijzing naar het actieve venster of weet u zelfs niet welk venster op een bepaald moment actief is. In dat geval kunt u de Focus methode niet gebruiken.
De AppActivate functie wijzigt de focus in de benoemde toepassing of het benoemde venster, maar heeft geen invloed op of deze is gemaximaliseerd of geminimaliseerd. De focus wordt verwijderd van het geactiveerde toepassingsvenster wanneer de gebruiker actie onderneemt om de focus te wijzigen of het venster te sluiten. U kunt de Shell functie gebruiken om een toepassing te starten en de vensterstijl in te stellen.
Als u de Title parameter gebruikt, gebruikt u een niet-hoofdlettergevoelige vergelijking, AppActivate maar anders is een exacte overeenkomst met de inhoud van de titelbalk vereist. Het kijkt eerst door de vensters op het hoogste niveau en vervolgens door de onderliggende vensters. Als het geen match kan vinden, gooit het een ArgumentException.
U kunt alleen gebruiken AppActivate met processen die eigen vensters hebben. De meeste consoletoepassingen hebben geen eigen vensters, wat betekent dat ze niet worden weergegeven in de lijst met processen die AppActivate worden doorzocht. Wanneer het systeem wordt uitgevoerd vanuit een consoletoepassing, maakt het systeem een afzonderlijk proces om de toepassing uit te voeren en retourneert de uitvoer naar het consoleproces. Wanneer u daarom de huidige proces-id aanvraagt, krijgt u de proces-id van dit afzonderlijke proces, in plaats van de proces-id van de consoletoepassing.
Tijdens runtime activeert de AppActivate functie elke actieve toepassing met een titel die overeenkomt Title met of met een proces-id die overeenkomt ProcessIdmet. Als er geen exacte overeenkomst is, wordt een toepassing geactiveerd waarvan de titeltekenreeks eindigt op Title. Als er meer dan één toepassing met de naam is, Titlekiest de AppActivate functie er willekeurig een om te activeren.
Note
De AppActivate functie vereist UIPermission op het SafeTopLevelWindows niveau, wat van invloed kan zijn op de uitvoering ervan in gedeeltelijke vertrouwenssituaties. Zie voor meer informatie UIPermission .
Zie ook
Van toepassing op
AppActivate(String)
Hiermee activeert u een toepassing die al wordt uitgevoerd.
public:
static void AppActivate(System::String ^ Title);public static void AppActivate(string Title);static member AppActivate : string -> unitPublic Sub AppActivate (Title As String)Parameters
- Title
- String
String expressie die de titel opgeeft in de titelbalk van de toepassing die u wilt activeren. U kunt de titel gebruiken die aan de toepassing is toegewezen toen deze werd gestart.
Voorbeelden
In dit voorbeeld ziet u verschillende toepassingen van de AppActivate functie om een toepassingsvenster te activeren. Als een Notepad-proces niet actief is, gooit het voorbeeld een ArgumentException. Bij Shell de procedure wordt ervan uitgegaan dat de toepassingen zich in de opgegeven paden bevinden.
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)
Opmerkingen
U gebruikt AppActivate om het actieve venster van een toepassing in de focus te brengen. Mogelijk hebt u geen ingang of verwijzing naar het actieve venster of weet u zelfs niet welk venster op een bepaald moment actief is. In dat geval kunt u de Focus methode niet gebruiken.
De AppActivate functie wijzigt de focus in de benoemde toepassing of het benoemde venster, maar heeft geen invloed op of deze is gemaximaliseerd of geminimaliseerd. De focus wordt verwijderd van het geactiveerde toepassingsvenster wanneer de gebruiker actie onderneemt om de focus te wijzigen of het venster te sluiten. U kunt de Shell functie gebruiken om een toepassing te starten en de vensterstijl in te stellen.
Als u de Title parameter gebruikt, gebruikt u een niet-hoofdlettergevoelige vergelijking, AppActivate maar anders is een exacte overeenkomst met de inhoud van de titelbalk vereist. Het kijkt eerst door de vensters op het hoogste niveau en vervolgens door de onderliggende vensters. Als het geen match kan vinden, gooit het een ArgumentException.
U kunt alleen gebruiken AppActivate met processen die eigen vensters hebben. De meeste consoletoepassingen hebben geen eigen vensters, wat betekent dat ze niet worden weergegeven in de lijst met processen die AppActivate worden doorzocht. Wanneer het systeem wordt uitgevoerd vanuit een consoletoepassing, maakt het systeem een afzonderlijk proces om de toepassing uit te voeren en retourneert de uitvoer naar het consoleproces. Wanneer u daarom de huidige proces-id aanvraagt, krijgt u de proces-id van dit afzonderlijke proces, in plaats van de proces-id van de consoletoepassing.
Tijdens runtime activeert de AppActivate functie elke actieve toepassing met een titel die overeenkomt Title met of met een proces-id die overeenkomt ProcessIdmet. Als er geen exacte overeenkomst is, wordt een toepassing geactiveerd waarvan de titeltekenreeks eindigt op Title. Als er meer dan één toepassing met de naam is, Titlekiest de AppActivate functie er willekeurig een om te activeren.
Note
De AppActivate functie vereist UIPermission op het SafeTopLevelWindows niveau, wat van invloed kan zijn op de uitvoering ervan in gedeeltelijke vertrouwenssituaties. Zie voor meer informatie UIPermission .