Interaction.AppActivate 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

啟動已經在執行的應用程式。

多載

AppActivate(Int32)	啟動已經在執行的應用程式。
AppActivate(String)	啟動已經在執行的應用程式。

AppActivate(Int32)

來源:

Interaction.vb

啟動已經在執行的應用程式。

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，指定指派給這個處理序 (Process) 的 Win32 處理序 ID 編號。 如果由 Shell(String, AppWinStyle, Boolean, Int32) 傳回的 ID 不為零，您就可以使用此編號。

範例

此範例說明函式的各種 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 式會任意選擇一個要啟動的應用程式。

注意

函 AppActivate 式在 UIPermissionSafeTopLevelWindows 層級需要 ，這可能會影響其在部分信任情況下的執行。 如需詳細資訊，請參閱UIPermission。

另請參閱

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

AppActivate(String)

來源:

Interaction.vb

啟動已經在執行的應用程式。

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 式會任意選擇一個要啟動的應用程式。

注意

函 AppActivate 式在 UIPermissionSafeTopLevelWindows 層級需要 ，這可能會影響其在部分信任情況下的執行。 如需詳細資訊，請參閱UIPermission。

另請參閱

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