Actualización: noviembre 2007
Obtiene el identificador de ventana de la ventana principal del proceso asociado.
(en System.dll)
Visual Basic (Declaración)
Public ReadOnly Property MainWindowHandle As IntPtr
Dim instance As Process
Dim value As IntPtr
value = instance.MainWindowHandle
public IntPtr MainWindowHandle { get; }
public:
property IntPtr MainWindowHandle {
IntPtr get ();
}
/** @property */
public IntPtr get_MainWindowHandle()
public function get MainWindowHandle () : IntPtr
Valor de propiedad
Tipo:
System..::.IntPtrIdentificador de ventana generado por el sistema para la ventana principal del proceso asociado.
| 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. |
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.
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.
.NET Framework
Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 3.5, 2.0
Referencia