Interaction.AppActivate Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

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

Przeciążenia

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

AppActivate(Int32)

Źródło:

Interaction.vb

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 identyfikatora procesu Win32 przypisanego do tego procesu. Można użyć identyfikatora zwróconego Shell(String, AppWinStyle, Boolean, Int32)przez element , pod warunkiem, że nie jest to zero.

Przykłady

W tym przykładzie pokazano różne zastosowania AppActivate funkcji do aktywowania okna aplikacji. Jeśli proces Notatnika nie jest uruchomiony, w przykładzie jest zgłaszany 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 ustawiania fokusu aktywnego okna aplikacji. Być może nie masz uchwytu lub odwołania do aktywnego okna, a nawet nie wiesz, które okno jest aktywne w danym momencie. 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 odchodzi od okna aktywowanej aplikacji, gdy użytkownik podejmuje pewne działania w celu zmiany fokusu lub zamknięcia okna. 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, zwraca wartość 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 wybierze jedną aplikację do aktywowania.

Uwaga

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ż

• Shell(String, AppWinStyle, Boolean, Int32)
• Focus()
• ArgumentException

AppActivate(String)

Źródło:

Interaction.vb

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

W tym przykładzie pokazano różne zastosowania AppActivate funkcji do aktywowania okna aplikacji. Jeśli proces Notatnika nie jest uruchomiony, w przykładzie jest zgłaszany 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 ustawiania fokusu aktywnego okna aplikacji. Być może nie masz uchwytu lub odwołania do aktywnego okna, a nawet nie wiesz, które okno jest aktywne w danym momencie. 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 odchodzi od okna aktywowanej aplikacji, gdy użytkownik podejmuje pewne działania w celu zmiany fokusu lub zamknięcia okna. 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, zwraca wartość 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 wybierze jedną aplikację do aktywowania.

Uwaga

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ż

• Shell(String, AppWinStyle, Boolean, Int32)
• Focus()
• ArgumentException