¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Process.MainWindowHandle (Propiedad)

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

Tipo: System.IntPtr
Identificador de ventana generado por el sistema para la ventana principal del proceso asociado.

ExcepciónCondición
InvalidOperationException

La propiedad MainWindowHandle no está definida porque el proceso ha terminado.

NotSupportedException

Se está intentando obtener acceso a la propiedad MainWindowHandle de un proceso que se está ejecutando en un equipo remoto. Esta propiedad sólo está disponible para los procesos que se ejecutan en el equipo local.

PlatformNotSupportedException

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

La ventana principal es la ventana abierto por el proceso que tiene actualmente el foco (formulario de TopLevel ). Debe utilizar el método de Refresh para actualizar el objeto de Process para obtener el identificador de ventana principal actual si ha cambiado.

Sólo es posible obtener la propiedad MainWindowHandle de los procesos que se estén ejecutando en el equipo local. La propiedad MainWindowHandle es un valor que identifica de forma inequívoca la ventana que está asociada al proceso.

Para que un proceso tenga una ventana principal asociada, debe disponer de una interfaz gráfica. Si el proceso asociado no tiene una ventana principal, el valor de la propiedad MainWindowHandle es cero. 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. Éste 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 método WaitForInputIdle para permitir que el proceso termine de iniciarse; así se garantiza la creación del identificador de ventana principal. De lo contrario, se producirá una excepción.

Nota de la plataforma : Esta propiedad no se encuentra disponible en esta plataforma si el proceso se ha iniciado con la propiedad ProcessStartInfo.UseShellExecute establecida en true.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

  • LinkDemand 

    para que haya plena confianza para el llamador inmediato. Este miembro no puede ser utilizado por código de confianza parcial.

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft