Process.MainWindowHandle Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Source:

Process.Unix.cs

Ottiene l'handle della finestra principale del processo associato.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };

public IntPtr MainWindowHandle { get; }

member this.MainWindowHandle : nativeint

Public ReadOnly Property MainWindowHandle As IntPtr

Valore della proprietà

IntPtr

nativeint

Handle generato dal sistema della finestra principale del processo associato.

Eccezioni

InvalidOperationException

L'oggetto MainWindowHandle non è definito perché il processo è terminato.

NotSupportedException

Si sta provando ad accedere alla proprietà MainWindowHandle per un processo in esecuzione in un computer remoto. Questa proprietà è disponibile solo per i processi in esecuzione nel computer locale.

Commenti

La finestra principale è la finestra aperta dal processo che attualmente ha lo stato attivo (il TopLevel modulo). È necessario utilizzare il Refresh metodo per aggiornare l'oggetto per ottenere l'handle Process della finestra principale più aggiornato se è stato modificato. In generale, poiché l'handle della finestra viene memorizzato nella cache, usare Refresh prima per garantire che si recupererà l'handle corrente.

È possibile ottenere la MainWindowHandle proprietà solo per i processi in esecuzione nel computer locale. La MainWindowHandle proprietà è un valore che identifica in modo univoco la finestra associata al processo.

A un processo è associata una finestra principale solo se il processo ha un'interfaccia grafica. Se il processo associato non ha una finestra principale, il MainWindowHandle valore è zero. Il valore è anche zero per i processi nascosti, ovvero i processi che non sono visibili nella barra delle applicazioni. Questo può essere il caso dei processi visualizzati come icone nell'area di notifica, all'estrema destra della barra delle applicazioni.

Se è stato appena avviato un processo e si vuole usare il relativo handle della finestra principale, è consigliabile usare il WaitForInputIdle metodo per consentire al processo di completare l'avvio, assicurandosi che l'handle della finestra principale sia stato creato. In caso contrario, verrà generata un'eccezione.

Vedi anche

• MainWindowTitle
• MainModule