Interaction.AppActivate Metoda

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic

Zestaw:: Microsoft.VisualBasic.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Aktywuje aplikację, która jest już uruchomiona.

Przeciążenia

Nazwa	Opis
AppActivate(Int32)	Aktywuje aplikację, która jest już uruchomiona.
AppActivate(String)	Aktywuje aplikację, która jest już uruchomiona.

AppActivate(Int32)

Aktywuje aplikację, która jest już uruchomiona.

public:
 static void AppActivate(int ProcessId);

public static void AppActivate(int ProcessId);

static member AppActivate : int -> unit

Public Sub AppActivate (ProcessId As Integer)

Parametry

ProcessId: Int32

Integer określenie numeru identyfikatora procesu Win32 przypisanego do tego procesu. Możesz użyć identyfikatora zwróconego Shell(String, AppWinStyle, Boolean, Int32)przez element , pod warunkiem, że nie jest zero.

Przykłady

W tym przykładzie pokazano różne zastosowania AppActivate funkcji do aktywowania okna aplikacji. Jeśli proces Notatnika nie jest uruchomiony, przykład zgłasza błąd ArgumentException. Procedura Shell zakłada, że aplikacje znajdują się w określonych ścieżkach.

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)

Uwagi

Służy AppActivate do stosowania aktywnego okna aplikacji w centrum uwagi. Być może nie masz uchwytu lub odwołania do aktywnego okna, a nawet nie wiesz, które okno jest aktywne w danej chwili. W takim przypadku nie można użyć Focus metody .

Funkcja AppActivate zmienia fokus na nazwaną aplikację lub okno, ale nie ma wpływu na to, czy jest zmaksymalizowana, czy zminimalizowana. Fokus jest odsunął się od okna aktywowanej aplikacji, gdy użytkownik podejmuje jakąś akcję, aby zmienić fokus lub zamknąć okno. Możesz użyć Shell funkcji , aby uruchomić aplikację i ustawić styl okna.

Jeśli używasz parametru Title , używa porównania bez uwzględniania wielkości liter, AppActivate ale w przeciwnym razie wymaga dokładnego dopasowania do zawartości paska tytułu. Najpierw przegląda okna najwyższego poziomu, a następnie przez okna podrzędne. Jeśli nie można odnaleźć dopasowania, zgłasza błąd ArgumentException.

Można używać AppActivate tylko z procesami, które są właścicielami okien. Większość aplikacji konsolowych nie jest właścicielem okien, co oznacza, że nie są wyświetlane na liście procesów, które wyszukują AppActivate . Podczas uruchamiania z poziomu aplikacji konsolowej system tworzy oddzielny proces uruchamiania aplikacji i zwraca dane wyjściowe do procesu konsoli. W związku z tym, gdy zażądasz bieżącego identyfikatora procesu, otrzymasz identyfikator procesu tego oddzielnego procesu, a nie identyfikator procesu aplikacji konsolowej.

W czasie AppActivate wykonywania funkcja aktywuje dowolną uruchomioną aplikację z tytułem zgodnym Title z identyfikatorem procesu lub zgodnym ProcessIdz . Jeśli nie ma dokładnego dopasowania, aktywuje ona dowolną aplikację, której ciąg tytułu kończy się ciągiem Title. Jeśli istnieje więcej niż jedna aplikacja o nazwie Title, AppActivate funkcja dowolnie wybiera jedną, która ma być aktywowana.

Note

Funkcja AppActivate wymaga UIPermission na SafeTopLevelWindows poziomie, co może mieć wpływ na jego wykonywanie w sytuacjach częściowego zaufania. Aby uzyskać więcej informacji, zobacz UIPermission .

Zobacz też

Dotyczy

AppActivate(String)

Aktywuje aplikację, która jest już uruchomiona.

public:
 static void AppActivate(System::String ^ Title);

public static void AppActivate(string Title);

static member AppActivate : string -> unit

Public Sub AppActivate (Title As String)

Parametry

Title: String

String wyrażenie określające tytuł na pasku tytułu aplikacji, którą chcesz aktywować. Możesz użyć tytułu przypisanego do aplikacji po jej uruchomieniu.

Przykłady

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)

Uwagi

Note

Zobacz też

Dotyczy

Opinia

Czy ta strona była pomocna?