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)