Captures a window

imagegrabscreen
imageinterlace
GD and Image Functions
PHP Manual

# imagegrabwindow

(PHP 5 >= 5.2.2)

imagegrabwindow — Captures a window

### Description

resource imagegrabwindow ( int `$window_handle` [, int `$client_area` = 0 ] )

Grabs a window or its client area using a windows handle (HWND property in COM instance)

### Parameters

`window_handle`

  The HWND window ID.

`client_area`

  Include the client area of the application window.

### Return Values

Returns an image resource identifier on success, `FALSE` on failure.

### Errors/Exceptions

E_NOTICE is issued if `window_handle` is invalid window handle. E_WARNING is issued if the Windows API is too old.

### Examples

Example #1 imagegrabwindow() example

Capture a window (IE for example)

`<?php
$browser = new COM("InternetExplorer.Application");
$handle = $browser->HWND;
$browser->Visible = true;
$im = imagegrabwindow($handle);
$browser->Quit();
imagepng($im, "iesnap.png");
imagedestroy($im);
?>`

Capture a window (IE for example) but with its content

`<?php
$browser = new COM("InternetExplorer.Application");
$handle = $browser->HWND;
$browser->Visible = true;
$browser->Navigate("http://www.libgd.org");
/* Still working? */
while ($browser->Busy) {
com_message_pump(4000);
}
$im = imagegrabwindow($handle, 0);
$browser->Quit();
imagepng($im, "iesnap.png");
imagedestroy($im);
?>`

### Notes

> Note:

> This function is only available on Windows.

### See Also

- imagegrabscreen() - Captures the whole screen

imagegrabscreen
imageinterlace
GD and Image Functions
PHP Manual