Interaction.AppActivate Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Aktivuje aplikaci, která je již spuštěna.

Přetížení

AppActivate(Int32)	Aktivuje aplikaci, která je již spuštěna.
AppActivate(String)	Aktivuje aplikaci, která je již spuštěna.

AppActivate(Int32)

Zdroj:

Interaction.vb

Aktivuje aplikaci, která je již spuštěna.

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 id procesu Win32 přiřazené tomuto procesu. Id vrácené objektem můžete použít za předpokladu Shell(String, AppWinStyle, Boolean, Int32), že není nula.

Příklady

Tento příklad znázorňuje různé použití AppActivate funkce k aktivaci okna aplikace. Pokud proces Poznámkového bloku není spuštěný, v příkladu se zobrazí ArgumentException. Postup Shell 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

Slouží AppActivate 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 použít metodu Focus .

Funkce AppActivate změní fokus na pojmenovanou aplikaci nebo okno, ale nemá vliv na jeho maximalizaci nebo minimalizaci. Fokus se přesune mimo okno aktivované 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, použije porovnání nerozlišující malá a velká písmena, AppActivate ale jinak vyžaduje přesnou shodu s obsahem záhlaví. Nejprve prohlédnou okna nejvyšší úrovně a pak podřízenými okny. Pokud nenajde shodu, vyhodí 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žádáte o aktuální ID procesu, získáte ID procesu tohoto samostatného procesu, nikoli ID procesu konzolové aplikace.

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

Poznámka

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

Viz také

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

AppActivate(String)

Zdroj:

Interaction.vb

Aktivuje aplikaci, která je již spuštěna.

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. Můžete použít název přiřazený aplikaci při jejím spuštění.

Příklady

Tento příklad znázorňuje různé použití AppActivate funkce k aktivaci okna aplikace. Pokud proces Poznámkového bloku není spuštěný, v příkladu se zobrazí ArgumentException. Postup Shell 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

Slouží AppActivate 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 použít metodu Focus .

Funkce AppActivate změní fokus na pojmenovanou aplikaci nebo okno, ale nemá vliv na jeho maximalizaci nebo minimalizaci. Fokus se přesune mimo okno aktivované 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, použije porovnání nerozlišující malá a velká písmena, AppActivate ale jinak vyžaduje přesnou shodu s obsahem záhlaví. Nejprve prohlédnou okna nejvyšší úrovně a pak podřízenými okny. Pokud nenajde shodu, vyhodí 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žádáte o aktuální ID procesu, získáte ID procesu tohoto samostatného procesu, nikoli ID procesu konzolové aplikace.

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

Poznámka

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

Viz také

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