Interaction.AppActivate Метод

Определение

Пространство имен:
Microsoft.VisualBasic
Сборка:
Microsoft.VisualBasic.dll

Активирует приложение, которое уже запущено.

Перегрузки

Имя Описание
AppActivate(Int32)

Активирует приложение, которое уже запущено.
AppActivate(String)

Активирует приложение, которое уже запущено.

AppActivate(Int32)

Активирует приложение, которое уже запущено.

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

Параметры

ProcessId
Int32

Integer указание идентификатора процесса Win32, назначенного этому процессу. Вы можете использовать идентификатор, возвращаемый параметром Shell(String, AppWinStyle, Boolean, Int32), если он не равен нулю.

Примеры

В этом примере показано использование AppActivate функции для активации окна приложения. Если Блокнот не запущен, в примере возникнет ArgumentExceptionисключение. В процедуре Shell предполагается, что приложения находятся в указанных путях.

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)

Комментарии

Вы используете AppActivate для привлечения активного окна приложения в фокус. Возможно, у вас нет дескриптора или ссылки на активное окно или даже знать, какое окно активно в данный момент. В таком случае нельзя использовать Focus метод.

Функция AppActivate изменяет фокус на именованное приложение или окно, но не влияет на то, является ли она развернутой или свернутой. Фокус перемещается от активированного окна приложения, когда пользователь принимает некоторое действие, чтобы изменить фокус или закрыть окно. Функцию Shell можно использовать для запуска приложения и настройки стиля окна.

Если используется Title параметр, используется сравнение без учета регистра, AppActivate но в противном случае требуется точное совпадение с содержимым строки заголовка. Сначала он просматривает окна верхнего уровня, а затем через дочерние окна. Если он не может найти совпадение, он создает ArgumentExceptionисключение.

Можно использовать AppActivate только с процессами, которые имеют собственные окна. Большинство консольных приложений не имеют собственных окон, что означает, что они не отображаются в списке процессов, которые AppActivate выполняют поиск. При запуске из консольного приложения система создает отдельный процесс для запуска приложения и возвращает выходные данные в консольный процесс. Следовательно, при запросе текущего идентификатора процесса вы получите идентификатор процесса этого отдельного процесса, а не идентификатор процесса консольного приложения.

Во время AppActivate выполнения функция активирует любое работающее приложение с заголовком, соответствующим Title или с идентификатором процесса, который соответствует ProcessId. Если точного совпадения нет, он активирует любое приложение, строка заголовка которого заканчивается Title. Если имеется несколько именованных Titleприложений, AppActivate функция произвольно выбирает ее для активации.

Note

Функция AppActivate требуется UIPermission на SafeTopLevelWindows уровне, что может повлиять на его выполнение в ситуациях с частичным доверием. Дополнительные сведения см. в статье UIPermission.

См. также раздел

Применяется к

AppActivate(String)

Активирует приложение, которое уже запущено.

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

Параметры

Title
String

String выражение, указывающее заголовок в строке заголовка приложения, которое требуется активировать. При запуске можно использовать заголовок, назначенный приложению.

Примеры

В этом примере показано использование AppActivate функции для активации окна приложения. Если Блокнот не запущен, в примере возникнет ArgumentExceptionисключение. В процедуре Shell предполагается, что приложения находятся в указанных путях.

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)

Комментарии

Вы используете AppActivate для привлечения активного окна приложения в фокус. Возможно, у вас нет дескриптора или ссылки на активное окно или даже знать, какое окно активно в данный момент. В таком случае нельзя использовать Focus метод.

Функция AppActivate изменяет фокус на именованное приложение или окно, но не влияет на то, является ли она развернутой или свернутой. Фокус перемещается от активированного окна приложения, когда пользователь принимает некоторое действие, чтобы изменить фокус или закрыть окно. Функцию Shell можно использовать для запуска приложения и настройки стиля окна.

Если используется Title параметр, используется сравнение без учета регистра, AppActivate но в противном случае требуется точное совпадение с содержимым строки заголовка. Сначала он просматривает окна верхнего уровня, а затем через дочерние окна. Если он не может найти совпадение, он создает ArgumentExceptionисключение.

Можно использовать AppActivate только с процессами, которые имеют собственные окна. Большинство консольных приложений не имеют собственных окон, что означает, что они не отображаются в списке процессов, которые AppActivate выполняют поиск. При запуске из консольного приложения система создает отдельный процесс для запуска приложения и возвращает выходные данные в консольный процесс. Следовательно, при запросе текущего идентификатора процесса вы получите идентификатор процесса этого отдельного процесса, а не идентификатор процесса консольного приложения.

Во время AppActivate выполнения функция активирует любое работающее приложение с заголовком, соответствующим Title или с идентификатором процесса, который соответствует ProcessId. Если точного совпадения нет, он активирует любое приложение, строка заголовка которого заканчивается Title. Если имеется несколько именованных Titleприложений, AppActivate функция произвольно выбирает ее для активации.

Note

Функция AppActivate требуется UIPermission на SafeTopLevelWindows уровне, что может повлиять на его выполнение в ситуациях с частичным доверием. Дополнительные сведения см. в статье UIPermission.

См. также раздел

Применяется к