Interaction.AppActivate Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Attiva un'applicazione già in esecuzione.
Overload
| Nome | Descrizione |
|---|---|
| AppActivate(Int32) |
Attiva un'applicazione già in esecuzione. |
| AppActivate(String) |
Attiva un'applicazione già in esecuzione. |
AppActivate(Int32)
Attiva un'applicazione già in esecuzione.
public:
static void AppActivate(int ProcessId);public static void AppActivate(int ProcessId);static member AppActivate : int -> unitPublic Sub AppActivate (ProcessId As Integer)Parametri
- ProcessId
- Int32
Integer specifica del numero ID del processo Win32 assegnato a questo processo. È possibile usare l'ID restituito da Shell(String, AppWinStyle, Boolean, Int32), purché non sia zero.
Esempio
In questo esempio vengono illustrati vari usi della AppActivate funzione per attivare una finestra dell'applicazione. Se un processo Notepad non è in esecuzione, nell'esempio viene generata un'eccezione ArgumentException. La Shell procedura presuppone che le applicazioni si trovino nei percorsi specificati.
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)
Commenti
Si usa AppActivate per attivare la finestra attiva di un'applicazione. Potrebbe non essere presente un handle o un riferimento alla finestra attiva o addirittura sapere quale finestra è attiva in un determinato momento. In questo caso, non è possibile usare il Focus metodo .
La AppActivate funzione modifica lo stato attivo sull'applicazione o sulla finestra denominata, ma non influisce sul fatto che sia ingrandita o ridotta a icona. Lo stato attivo si allontana dalla finestra dell'applicazione attivata quando l'utente esegue un'azione per modificare lo stato attivo o chiudere la finestra. È possibile usare la Shell funzione per avviare un'applicazione e impostare lo stile della finestra.
Se si usa il Title parametro , AppActivate usa un confronto senza distinzione tra maiuscole e minuscole, ma in caso contrario richiede una corrispondenza esatta con il contenuto della barra del titolo. Esamina prima le finestre di primo livello e quindi attraverso le finestre figlio. Se non riesce a trovare una corrispondenza, genera un'eccezione ArgumentException.
È possibile usare AppActivate solo con processi che possiedono finestre. La maggior parte delle applicazioni console non possiede finestre, il che significa che non vengono visualizzate nell'elenco dei processi in cui AppActivate viene eseguita la ricerca. Quando si esegue da un'applicazione console, il sistema crea un processo separato per eseguire l'applicazione e restituisce l'output al processo della console. Di conseguenza, quando si richiede l'ID processo corrente, si ottiene l'ID processo di questo processo separato, anziché l'ID processo dell'applicazione console.
In fase di esecuzione, la AppActivate funzione attiva qualsiasi applicazione in esecuzione con un titolo corrispondente Title o con un ID processo corrispondente a ProcessId. Se non esiste una corrispondenza esatta, attiva qualsiasi applicazione la cui stringa del titolo termina con Title. Se sono presenti più applicazioni denominate Title, la AppActivate funzione sceglie arbitrariamente una da attivare.
Note
La AppActivate funzione richiede UIPermission a SafeTopLevelWindows livello, che può influire sull'esecuzione in situazioni di attendibilità parziale. Per altre informazioni, vedere UIPermission.
Vedi anche
Si applica a
AppActivate(String)
Attiva un'applicazione già in esecuzione.
public:
static void AppActivate(System::String ^ Title);public static void AppActivate(string Title);static member AppActivate : string -> unitPublic Sub AppActivate (Title As String)Parametri
- Title
- String
String espressione che specifica il titolo nella barra del titolo dell'applicazione da attivare. È possibile usare il titolo assegnato all'applicazione al momento dell'avvio.
Esempio
In questo esempio vengono illustrati vari usi della AppActivate funzione per attivare una finestra dell'applicazione. Se un processo Notepad non è in esecuzione, nell'esempio viene generata un'eccezione ArgumentException. La Shell procedura presuppone che le applicazioni si trovino nei percorsi specificati.
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)
Commenti
Si usa AppActivate per attivare la finestra attiva di un'applicazione. Potrebbe non essere presente un handle o un riferimento alla finestra attiva o addirittura sapere quale finestra è attiva in un determinato momento. In questo caso, non è possibile usare il Focus metodo .
La AppActivate funzione modifica lo stato attivo sull'applicazione o sulla finestra denominata, ma non influisce sul fatto che sia ingrandita o ridotta a icona. Lo stato attivo si allontana dalla finestra dell'applicazione attivata quando l'utente esegue un'azione per modificare lo stato attivo o chiudere la finestra. È possibile usare la Shell funzione per avviare un'applicazione e impostare lo stile della finestra.
Se si usa il Title parametro , AppActivate usa un confronto senza distinzione tra maiuscole e minuscole, ma in caso contrario richiede una corrispondenza esatta con il contenuto della barra del titolo. Esamina prima le finestre di primo livello e quindi attraverso le finestre figlio. Se non riesce a trovare una corrispondenza, genera un'eccezione ArgumentException.
È possibile usare AppActivate solo con processi che possiedono finestre. La maggior parte delle applicazioni console non possiede finestre, il che significa che non vengono visualizzate nell'elenco dei processi in cui AppActivate viene eseguita la ricerca. Quando si esegue da un'applicazione console, il sistema crea un processo separato per eseguire l'applicazione e restituisce l'output al processo della console. Di conseguenza, quando si richiede l'ID processo corrente, si ottiene l'ID processo di questo processo separato, anziché l'ID processo dell'applicazione console.
In fase di esecuzione, la AppActivate funzione attiva qualsiasi applicazione in esecuzione con un titolo corrispondente Title o con un ID processo corrispondente a ProcessId. Se non esiste una corrispondenza esatta, attiva qualsiasi applicazione la cui stringa del titolo termina con Title. Se sono presenti più applicazioni denominate Title, la AppActivate funzione sceglie arbitrariamente una da attivare.
Note
La AppActivate funzione richiede UIPermission a SafeTopLevelWindows livello, che può influire sull'esecuzione in situazioni di attendibilità parziale. Per altre informazioni, vedere UIPermission.