Process.MainWindowHandle Propiedad

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.

Excepciones

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.

Puede obtener la MainWindowHandle propiedad solo 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

• MainWindowTitle
• MainModule