4D Doc Center : GET PICTURE FROM LIBRARY

4D v14.3

GET PICTURE FROM LIBRARY


GET PICTURE FROM LIBRARY ( refImag \| nomImag ; imagem )

Parâmetro	Tipo	Descrição
refImag \| nomImag	Inteiro longo, cadeia	Número de referência ou Nome da imagem da biblioteca de imagens
imagem	Variável Imagem	Imagem da biblioteca de imagens

Descrição

O comando GET PICTURE FROM LIBRARY devolve no parâmetro imagem a imagem da biblioteca de imagens cujo número de referência se passa em refImag ou cujo nome se passa em nomImag.

Se não houver uma imagem com esse nome ou número de referência, GET PICTURE FROM LIBRARY não modifica imagem.

Exemplo 1

O exemplo a seguir devolve em vgMiImagen a imagem cujo número de referência se armazena na variável local $vlRefImag:

GET PICTURE FROM LIBRARY($vlRefImag;vgMinhaImagem)

Exemplo 2

O exemplo a seguir devolve em $DDcom_Prot_MiImagen a imagem com o nome "DDcom_Prot_Boton1" armazenada na biblioteca de imagens:

GET PICTURE FROM LIBRARY("XP - Aceitar";$XP_Aceitar)

Exemplo 3

Ver o terceiro exemplo para o comando PICTURE LIBRARY LIST.

Variáveis e conjuntos do sistema

A variável sistema OK toma o valor 1 se a imagem existe na biblioteca de imagens. Do contrário, OK toma o valor zero.

Gestão de erros

Se não houver suficiente memória para devolver a imagem, se gera o erro -108. Pode interceptar este erro utilizando um método de gestão de erros.