FORM SCREENSHOT
FORM SCREENSHOT ( {{tabela ;} nomeForm ;} imagForm {; pagNum} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tabela | Table | → | Tabela do formulário |
| nomeForm | Text | → | Nome do formulário |
| imagForm | Picture | ← | Imagem do formulário em execução se o primeiro parâmetro se omite, ou Imagem do formulário no editor de formulários se passar um nome de formulário |
| pagNum | Integer | → | Número de página do formulário |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando FORM SCREENSHOT retorna um formulário em forma de imagem. Este comando aceita duas sintaxes diferentes: em função da sintaxe utilizada, você obtém ou uma imagem do formulário em execução ou uma imagem do formulário no editor de formulários.
- FORM SCREENSHOT ( imagF orm )
Esta sintaxe permite obter uma captura de tela exata da página atual do formulário em execução ou carregado sob o comando FORM LOAD: a imagem retorna no parâmetro imagForm contém todos os objetos visíveis do formulário com os valores atuais dos campos e das variáveis do formulário, subformulário, etc. O formulário é retornado em sua totalidade, sem considerar o tamanho da janela que o contenha.
Considere que esta sintaxe só funciona com formulários de entrada. - FORM SCREENSHOT ( {tabela ;} nomeForm; imagForm{; pagNum} )
Esta sintaxe permite obter uma captura de tela (screensho) de um formulário "modelo" do modo como é exibido no Editor de formulários. Todos os objetos visíveis são desenhados da mesma forma que no editor; os comandos consideram os formulários herdados e os objetos localizados na página 0.
Se deseja uma captura de tela de um formulário tabela, passe a tabela do formulário no parâmetro tabela e depois seu nome como uma string em nomeForm. Para um formulário projeto, passe diretamente o nome do formulário em nomeForm.
Automaticamente, o comando retorna uma captura de tela da página 1 do formulário. Se apenas deseja uma imagem da página 0, ou de qualquer outra página do formulário, passe o número de página no parâmetro pagNum.
Notas:
- Àreas Web não são geradas na screenshot retornada.
- Já que os primeiros dois parâmetros do comando são opcionais, não é possível passar uma função retornando um ponteiro, tal como Current form table-> ou Table->, diretamente como argumento. Apesar dessa sintaxe funcionar em modo interpretado, seria rejeitada durante a compilação, então use uma variável ponteiro intermediária nesse caso. Para saber mais, veja "Direct use of commands returning pointers".