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

このプロセスに割り当てられた Win32 プロセス ID 番号を指定する Integer。 Shell(String, AppWinStyle, Boolean, Int32) によって返される ID がゼロでなければ、その 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、 と一致するタイトルまたは に一致TitleProcessIdするプロセス ID を持つ実行中のアプリケーションをアクティブにします。 完全に一致するものがない場合は、タイトル文字列が で Title終わるアプリケーションがアクティブになります。 という名前 Titleのアプリケーションが複数ある場合、関数は AppActivate アクティブ化するアプリケーションを任意に選択します。

注意

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

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

注意

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

こちらもご覧ください

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