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 プロセス ID 番号を指定します。 0 でない場合は、 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 プロセスの一覧には表示されません。 コンソール アプリケーションから実行する場合、システムはアプリケーションを実行する別のプロセスを作成し、出力をコンソール プロセスに返します。 したがって、現在のプロセス ID を要求すると、コンソール アプリケーションのプロセス ID ではなく、この個別のプロセスのプロセス ID が取得されます。

実行時に、 AppActivate 関数は、 Title に一致するタイトルまたは ProcessIdに一致するプロセス ID を持つ実行中のアプリケーションをアクティブにします。 完全に一致するものがない場合は、タイトル文字列が Title で終わるすべてのアプリケーションがアクティブになります。 Titleという名前のアプリケーションが複数ある場合、AppActivate関数はアクティブ化するアプリケーションを任意に選択します。

Note

AppActivate関数では、SafeTopLevelWindows レベルでUIPermissionが必要です。これは、部分信頼の状況での実行に影響する可能性があります。 詳細については、「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 プロセスの一覧には表示されません。 コンソール アプリケーションから実行する場合、システムはアプリケーションを実行する別のプロセスを作成し、出力をコンソール プロセスに返します。 したがって、現在のプロセス ID を要求すると、コンソール アプリケーションのプロセス ID ではなく、この個別のプロセスのプロセス ID が取得されます。

実行時に、 AppActivate 関数は、 Title に一致するタイトルまたは ProcessIdに一致するプロセス ID を持つ実行中のアプリケーションをアクティブにします。 完全に一致するものがない場合は、タイトル文字列が Title で終わるすべてのアプリケーションがアクティブになります。 Titleという名前のアプリケーションが複数ある場合、AppActivate関数はアクティブ化するアプリケーションを任意に選択します。

Note

AppActivate関数では、SafeTopLevelWindows レベルでUIPermissionが必要です。これは、部分信頼の状況での実行に影響する可能性があります。 詳細については、「UIPermission」を参照してください。

こちらもご覧ください

適用対象