array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagegrabwindow.php', 1 => 'imagegrabwindow', 2 => 'Captura uma janela', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funções de GD e Image', ), 'prev' => array ( 0 => 'function.imagegrabscreen.php', 1 => 'imagegrabscreen', ), 'next' => array ( 0 => 'function.imageinterlace.php', 1 => 'imageinterlace', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/image/functions/imagegrabwindow.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagegrabwindow

(PHP 5 >= 5.2.2, PHP 7, PHP 8)

imagegrabwindow — Captura uma janela

Descrição

imagegrabwindow(int $handle, bool $client_area = false): GdImage|false

Captura uma janela ou sua área de cliente usando um manipulador do Windows (propriedade HWND na instância COM)

Nota:

Esta função está disponível apenas no Windows.

Parâmetros

handle

O ID da janela HWND.

client_area

Inclui a área de cliente da janela da aplicação.

Valor Retornado

Retorna um objeto de imagem em caso de sucesso, false em caso de falha.

Erros/Exceções

E_NOTICE é emitido se handle for um manipulador de janela inválido. E_WARNING é emitido se a API do Windows for muito antiga.

Registro de Alterações

Versão Descrição
8.0.0 Em caso de sucesso, esta função retorna agora uma instância de GDImage; anteriormente, um resource era retornado.
8.0.0 client_area agora espera um valor do tipo bool; anteriormente era esperado um valor do tipo int.

Exemplos

Exemplo #1 Exemplo de imagegrabwindow()

Captura uma janela (IE por exemplo)

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

Captura uma janela (IE por exemplo) mas com seu conteúdo

<?php
$browser = new COM("InternetExplorer.Application");
$handle = $browser->HWND;
$browser->Visible = true;
$browser->Navigate("http://www.libgd.org");

/* Ainda funcionando? */
while ($browser->Busy) {
com_message_pump(4000);
}
$im = imagegrabwindow($handle, 0);
$browser->Quit();
imagepng($im, "iesnap.png");
?>

Veja Também