IMAGEGRABWINDOW(3) 1 IMAGEGRABWINDOW(3)
imagegrabwindow - Captures a window
SYNOPSIS
resource imagegrabwindow (int $window_handle, [int $client_area])
DESCRIPTION
Grabs a window or its client area using a windows handle (HWND property in COM instance)
PARAMETERS
o $window_handle
- The HWND window ID.
o $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(3) 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(3).
PHP Documentation Group IMAGEGRABWINDOW(3)