Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad Process.MainWindowHandle

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Diagnostics
Ensamblado:  System (en System.dll)

public IntPtr MainWindowHandle { get; }

Valor de propiedad

Type: System.IntPtr

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

Exception Condition
InvalidOperationException

MainWindowHandle no está definido porque el proceso ha terminado.

NotSupportedException

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.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium Edition (Windows Me); establezca ProcessStartInfo.UseShellExecute en false para tener acceso a esta propiedad en Windows 98 y Windows Me.

La ventana principal es la ventana abierta por el proceso que tiene actualmente el foco (el TopLevel formulario). Debe utilizar el Refresh método para actualizar la Process objeto para obtener el identificador de ventana principal actual si ha cambiado. En general, porque el identificador de ventana se almacena en caché, utilice Refresh con antelación para garantizar que podrá recuperar el identificador actual.

Puede obtener el MainWindowHandle propiedad únicamente para los procesos que se ejecutan en el equipo local. El MainWindowHandle propiedad es un valor que identifica de forma inequívoca la ventana que está asociada al proceso.

Un proceso tiene una ventana principal asociada sólo 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, procesos que no son visibles en la barra de tareas. Esto puede ser el caso para 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 utilizar el identificador de ventana principal, considere la posibilidad de utilizar el WaitForInputIdle método para permitir que el proceso termine de iniciarse, asegurándose de que se ha creado el identificador de ventana principal. De lo contrario, se producirá una excepción.

Win98WinMe

This property is not available on this platform if you started the process with P:System.Diagnostics.ProcessStartInfo.UseShellExecute set to true.

LinkDemand

for full trust for the immediate caller. This member cannot be used by partially trusted code.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: