Process.MainWindowHandle Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 : nativeintPublic ReadOnly Property MainWindowHandle As IntPtrValor de propiedad
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.
