Process.MainWindowHandle Proprietà
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.
Ottiene l'handle della finestra principale del processo associato.
public:
property IntPtr MainWindowHandle { IntPtr get(); };public IntPtr MainWindowHandle { get; }member this.MainWindowHandle : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrValore della proprietà
nativeint
Handle generato dal sistema della finestra principale del processo associato.
Eccezioni
L'oggetto MainWindowHandle non è definito perché il processo è terminato.
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.
