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 della finestra generata dal sistema della finestra principale del processo associato.
Eccezioni
L'oggetto MainWindowHandle non è definito perché il processo è stato chiuso.
Si sta tentando di accedere alla MainWindowHandle proprietà 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 con lo stato attivo (modulo TopLevel ). È 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 di finestra viene memorizzato nella cache, usare Refresh in anticipo per garantire che l'handle corrente venga recuperato.
È 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 per i 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 di 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 una eccezione.
