imagegrabwindow

imagegrabwindow(int $handle, [bool $client_area]): GdImage
```php

Captura una ventana o el espacio de su cliente, utilizando un gestor de ventanas (propiedad HWND de la instancia COM).

> [!NOTE]
> Esta función solo está disponible en Windows.

## Parámetros

`handle`  
El identificador HWND de la ventana.

`client_area`  
Incluir o no el espacio del cliente de la ventana de la aplicación.

## Valores devueltos

Devuelve un objeto imagen en caso de éxito, o `false` si ocurre un error.

## Errores/Excepciones

Se emite una alerta de tipo E_NOTICE si `window_handle` es un gestor de ventana no válido. Se emite una alerta de tipo E_WARNING si la API de Windows es demasiado antigua.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | En caso de éxito, esta función devuelve ahora una instancia de `GDImage` ; anteriormente, se devolvía un `resource`. |
| 8.0.0 | `client_area` ahora espera un `bool` ; anteriormente esperaba un `int`. |

## Ejemplos

Ejemplo con `imagegrabwindow`

Captura una ventana (por ejemplo, IE).

Captura una ventana (por ejemplo, IE) pero con su contenido.