Interaction.AppActivate Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Aktivuje aplikaci, která už je spuštěná.

Přetížení

Name	Description
AppActivate(Int32)	Aktivuje aplikaci, která už je spuštěná.
AppActivate(String)	Aktivuje aplikaci, která už je spuštěná.

AppActivate(Int32)

Zdroj:

Interaction.vb

Aktivuje aplikaci, která už je spuštěná.

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 určuje číslo ID procesu Win32 přiřazené k tomuto procesu. Můžete použít ID vrácené Shell(String, AppWinStyle, Boolean, Int32)hodnotou , pokud není nula.

Příklady

Tento příklad ukazuje různé použití AppActivate funkce k aktivaci okna aplikace. Pokud není spuštěný proces Poznámkového bloku, příklad vyvolá chybu ArgumentException. Tento Shell postup předpokládá, že aplikace jsou v zadaných cestách.

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)

Poznámky

Používá AppActivate se k přenesení aktivního okna aplikace do fokusu. Možná nemáte popisovač nebo odkaz na aktivní okno nebo dokonce víte, které okno je v daném okamžiku aktivní. V takovém případě nemůžete metodu Focus použít.

Funkce AppActivate změní fokus na pojmenovanou aplikaci nebo okno, ale nemá vliv na to, jestli je maximalizovaná nebo minimalizovaná. Fokus se přesune mimo aktivované okno aplikace, když uživatel provede nějakou akci, aby změnil fokus nebo zavře okno. Pomocí funkce můžete Shell spustit aplikaci a nastavit styl okna.

Pokud použijete Title parametr, AppActivate použije porovnání bez rozlišování malých a velkých písmen, ale jinak vyžaduje přesnou shodu s obsahem záhlaví. Nejprve projde okna nejvyšší úrovně a pak projde podřízenými okny. Pokud nemůže najít shodu, vyvolá chybu ArgumentException.

Můžete použít AppActivate pouze s procesy, které vlastní okna. Většina konzolových aplikací nevlastní okna, což znamená, že se nezobrazují v seznamu procesů, které AppActivate prohledávají. Při spuštění z konzolové aplikace systém vytvoří samostatný proces pro spuštění aplikace a vrátí výstup do procesu konzoly. V důsledku toho, když požadujete aktuální ID procesu, získáte ID procesu tohoto samostatného procesu, nikoli ID procesu konzolové aplikace.

V době AppActivate běhu funkce aktivuje jakoukoli spuštěnou aplikaci s názvem, který odpovídá Title , nebo s ID procesu, který odpovídá ProcessId. Pokud neexistuje žádná přesná shoda, aktivuje jakoukoli aplikaci, jejíž název řetězec končí Title. Pokud existuje více než jedna aplikace s názvem Title, AppActivate funkce libovolně zvolí jednu, která se má aktivovat.

Note

Funkce AppActivate vyžaduje UIPermission na SafeTopLevelWindows úrovni, která může ovlivnit její spuštění v situacích s částečnou důvěryhodností. Další informace naleznete v tématu UIPermission .

Viz také

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

AppActivate(String)

Zdroj:

Interaction.vb

Aktivuje aplikaci, která už je spuštěná.

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 výraz určující název v záhlaví aplikace, kterou chcete aktivovat. Název přiřazený aplikaci můžete použít při jejím spuštění.

Příklady

Tento příklad ukazuje různé použití AppActivate funkce k aktivaci okna aplikace. Pokud není spuštěný proces Poznámkového bloku, příklad vyvolá chybu ArgumentException. Tento Shell postup předpokládá, že aplikace jsou v zadaných cestách.

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)

Poznámky

Používá AppActivate se k přenesení aktivního okna aplikace do fokusu. Možná nemáte popisovač nebo odkaz na aktivní okno nebo dokonce víte, které okno je v daném okamžiku aktivní. V takovém případě nemůžete metodu Focus použít.

Funkce AppActivate změní fokus na pojmenovanou aplikaci nebo okno, ale nemá vliv na to, jestli je maximalizovaná nebo minimalizovaná. Fokus se přesune mimo aktivované okno aplikace, když uživatel provede nějakou akci, aby změnil fokus nebo zavře okno. Pomocí funkce můžete Shell spustit aplikaci a nastavit styl okna.

Pokud použijete Title parametr, AppActivate použije porovnání bez rozlišování malých a velkých písmen, ale jinak vyžaduje přesnou shodu s obsahem záhlaví. Nejprve projde okna nejvyšší úrovně a pak projde podřízenými okny. Pokud nemůže najít shodu, vyvolá chybu ArgumentException.

Můžete použít AppActivate pouze s procesy, které vlastní okna. Většina konzolových aplikací nevlastní okna, což znamená, že se nezobrazují v seznamu procesů, které AppActivate prohledávají. Při spuštění z konzolové aplikace systém vytvoří samostatný proces pro spuštění aplikace a vrátí výstup do procesu konzoly. V důsledku toho, když požadujete aktuální ID procesu, získáte ID procesu tohoto samostatného procesu, nikoli ID procesu konzolové aplikace.

V době AppActivate běhu funkce aktivuje jakoukoli spuštěnou aplikaci s názvem, který odpovídá Title , nebo s ID procesu, který odpovídá ProcessId. Pokud neexistuje žádná přesná shoda, aktivuje jakoukoli aplikaci, jejíž název řetězec končí Title. Pokud existuje více než jedna aplikace s názvem Title, AppActivate funkce libovolně zvolí jednu, která se má aktivovat.

Note

Funkce AppActivate vyžaduje UIPermission na SafeTopLevelWindows úrovni, která může ovlivnit její spuštění v situacích s částečnou důvěryhodností. Další informace naleznete v tématu UIPermission .

Viz také

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