Process.MainWindowHandle Propiedad

Definición

Obtiene el identificador de ventana de la ventana principal del proceso asociado.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

Valor de propiedad

Identificador de ventana generado por el sistema para la ventana principal del proceso asociado.The system-generated window handle of the main window of the associated process.

Excepciones

MainWindowHandle no está definido porque el proceso ha terminado.The MainWindowHandle is not defined because the process has exited.

Está intentando obtener acceso a la propiedad MainWindowHandle de un proceso que se ejecuta en un equipo remoto.You are trying to access the MainWindowHandle property for a process that is running on a remote computer. Esta propiedad está disponible únicamente para los procesos que se ejecutan en el equipo local.This property is available only for processes that are running on the local computer.

Comentarios

La ventana principal es la ventana abierta por el proceso que actualmente tiene el foco (el formulario TopLevel).The main window is the window opened by the process that currently has the focus (the TopLevel form). Debe utilizar el método Refresh para actualizar el objeto Process para obtener el identificador de ventana principal actual si ha cambiado.You must use the Refresh method to refresh the Process object to get the current main window handle if it has changed. En general, dado que el identificador de ventana se almacena en la memoria caché, use Refresh con antelación para garantizar que recuperará el identificador actual.In general, because the window handle is cached, use Refresh beforehand to guarantee that you'll retrieve the current handle.

Solo puede obtener la propiedad MainWindowHandle para los procesos que se ejecutan en el equipo local.You can get the MainWindowHandle property only for processes that are running on the local computer. La propiedad MainWindowHandle es un valor que identifica de forma única la ventana asociada al proceso.The MainWindowHandle property is a value that uniquely identifies the window that is associated with the process.

Un proceso tiene asociada una ventana principal solo si el proceso tiene una interfaz gráfica.A process has a main window associated with it only if the process has a graphical interface. Si el proceso asociado no tiene una ventana principal, el valor de MainWindowHandle es cero.If the associated process does not have a main window, the MainWindowHandle value is zero. El valor también es cero para los procesos que se han ocultado, es decir, procesos que no están visibles en la barra de tareas.The value is also zero for processes that have been hidden, that is, processes that are not visible in the taskbar. Este puede ser el caso de los procesos que aparecen como iconos en el área de notificación, en el extremo derecho de la barra de tareas.This can be the case for processes that appear as icons in the notification area, at the far right of the taskbar.

Si acaba de iniciar un proceso y desea utilizar su identificador de ventana principal, considere la posibilidad de usar el método WaitForInputIdle para permitir que el proceso termine de iniciarse, asegurándose de que se ha creado el identificador de la ventana principal.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. De lo contrario, se producirá una excepción.Otherwise, an exception will be thrown.

Se aplica a

Consulte también: