Process.MainWindowHandle Process.MainWindowHandle Process.MainWindowHandle Process.MainWindowHandle Property

Definizione

Ottiene l'handle della finestra principale del processo associato.Gets the window handle of the main window of the associated process.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };
public IntPtr MainWindowHandle { get; }
member this.MainWindowHandle : nativeint
Public ReadOnly Property MainWindowHandle As IntPtr

Valore della proprietà

Handle generato dal sistema della finestra principale del processo associato.The system-generated window handle of the main window of the associated process.

Eccezioni

L'oggetto MainWindowHandle non è definito perché il processo è terminato.The MainWindowHandle is not defined because the process has exited.

Si sta provando ad accedere alla proprietà MainWindowHandle per un processo in esecuzione in un computer remoto.You are trying to access the MainWindowHandle property for a process that is running on a remote computer. Questa proprietà è disponibile solo per i processi in esecuzione nel computer locale.This property is available only for processes that are running on the local computer.

La piattaforma è Windows 98 o Windows Millennium Edition (Windows Me); impostare UseShellExecute su false per accedere a questa proprietà in Windows 98 e Windows Me.The platform is Windows 98 or Windows Millennium Edition (Windows Me); set UseShellExecute to false to access this property on Windows 98 and Windows Me.

Commenti

La finestra principale è la finestra aperta dal processo che ha attualmente lo stato attivo (il TopLevel modulo).The main window is the window opened by the process that currently has the focus (the TopLevel form). È necessario usare il Refresh per aggiornare il Process oggetto per cui ottenere l'handle della finestra principale corrente, se è stata modificata.You must use the Refresh method to refresh the Process object to get the current main window handle if it has changed. In generale, poiché viene memorizzato nella cache l'handle di finestra, usare Refresh in anticipo per garantire che è possibile recuperare l'handle corrente.In general, because the window handle is cached, use Refresh beforehand to guarantee that you'll retrieve the current handle.

È possibile ottenere il MainWindowHandle proprietà solo per i processi in esecuzione nel computer locale.You can get the MainWindowHandle property only for processes that are running on the local computer. Il MainWindowHandle proprietà è un valore che identifica in modo univoco la finestra che viene associata al processo.The MainWindowHandle property is a value that uniquely identifies the window that is associated with the process.

Un processo ha una finestra principale associata solo se il processo ha un'interfaccia grafica.A process has a main window associated with it only if the process has a graphical interface. Se il processo associato non dispone di una finestra principale, il MainWindowHandle valore è uguale a zero.If the associated process does not have a main window, the MainWindowHandle value is zero. Anche il valore è zero per i processi che sono stati nascosti, vale a dire a processi non sono visibili nella barra degli strumenti.The value is also zero for processes that have been hidden, that is, processes that are not visible in the taskbar. Ciò può verificarsi per i processi che vengono visualizzati come icone nell'area di notifica, all'estrema destra della barra delle applicazioni.This can be the case for processes that appear as icons in the notification area, at the far right of the taskbar.

Se è stato appena avviato un processo e si vuole usare il relativo handle di finestra principale, è consigliabile usare il WaitForInputIdle metodo per consentire il processo completare l'avvio, assicurando che sia stato creato l'handle della finestra principale.If you have just started a process and want to use its main window handle, consider using the WaitForInputIdle method to allow the process to finish starting, ensuring that the main window handle has been created. In caso contrario, verrà generata un'eccezione.Otherwise, an exception will be thrown.

Sicurezza

LinkDemand
per un'attendibilità totale per il chiamante immediato.for full trust for the immediate caller. Impossibile utilizzare questo membro in codice parzialmente attendibile.This member cannot be used by partially trusted code.

Si applica a

Vedi anche