Process.MainWindowHandle (Propiedad) (System.Diagnostics)

MainWindowHandle (Propiedad)

Encender vista de ancho de banda bajo

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2008/.NET Framework 3.5

Hay además otras versiones disponibles para:

Microsoft Visual Studio 2005/.NET Framework 2.0

Biblioteca de clases de .NET Framework

Process..::.MainWindowHandle (Propiedad)

Actualización: noviembre 2007

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

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

Sintaxis

Visual Basic (Declaración)

Public ReadOnly Property MainWindowHandle As IntPtr

Visual Basic (Uso)

Dim instance As Process
Dim value As IntPtr

value = instance.MainWindowHandle

public IntPtr MainWindowHandle { get; }

Visual C++

public:
property IntPtr MainWindowHandle {
    IntPtr get ();
}

/** @property */
public IntPtr get_MainWindowHandle()

JScript

public function get MainWindowHandle () : IntPtr

Valor de propiedad

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

Excepciones

Excepción	Condició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.

Comentarios

La ventana principal es la ventana que se crea al iniciarse el proceso. Tras la inicialización, pueden abrirse otras ventanas, incluidas las ventanas Modal y TopLevel, pero la primera ventana asociada al proceso seguirá siendo la ventana principal.

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. 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 Windows 98, Windows Millennium Edition:

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

Permisos

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

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión