Compartir a través de


Process.MainWindowHandle Propiedad

Definición

Obtiene el identificador de ventana de la ventana principal del proceso asociado.

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

Valor de propiedad

IntPtr

nativeint

Identificador de ventana generado por el sistema para la ventana principal del proceso asociado.

Excepciones

MainWindowHandle no está definido porque el proceso ha terminado.

Está intentando obtener acceso a la propiedad MainWindowHandle de un proceso que se ejecuta en un equipo remoto. Esta propiedad está disponible únicamente para los procesos que se ejecutan en el equipo local.

Comentarios

La ventana principal es la ventana abierta por el proceso que tiene actualmente el foco (el TopLevel formulario). Debe usar el Refresh método para actualizar el Process objeto para obtener el identificador de ventana principal más actualizado si ha cambiado. En general, dado que el identificador de ventana está almacenado en caché, use Refresh de antemano para garantizar que recuperará el identificador actual.

Solo puede obtener la MainWindowHandle propiedad para los procesos que se ejecutan en el equipo local. La MainWindowHandle propiedad es un valor que identifica de forma única la ventana asociada al proceso.

Un proceso tiene una ventana principal asociada solo si el proceso tiene una interfaz gráfica. Si el proceso asociado no tiene una ventana principal, el MainWindowHandle valor es cero. El valor también es cero para los procesos que se han ocultado, es decir, los procesos que no están visibles en la barra de tareas. Esto 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.

Si acaba de iniciar un proceso y desea usar su identificador de ventana principal, considere la posibilidad de usar el WaitForInputIdle método para permitir que el proceso termine de comenzar, asegurándose de que se ha creado el identificador de ventana principal. De lo contrario, se producirá una excepción.

Se aplica a

Consulte también