Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Correção de informações sobre a cláusula SIZE

...

#include "totvs.ch"

Parâmetros

CláusulaTipoObrigatóriaDescrição
<nRow>NSParâmetro obrigatório, indica a linha da tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
<nCol>NSParâmetro obrigatório, indica a coluna da tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
BITMAP
SCláusula obrigatória, identifica o comando
<oBmp>ONPodemos especificar um nome de variável AdvPL no qual o objeto do componente tBITMAP() será armazenado. Deve ser utilizado caso seja necessário alterar propriedades do objeto após criado. 
NAME | RESNAME | RESOURCE <cResName> C
Expressão caractere opcional, pode ser constante ou variável, indica o nome do resource (imagem gravada no repositório de objetos) que deve ser exibido no componente. 
FILE | FILENAME | DISK <cFileName>C
Expressão caractere, constante ou variável, deve conter o nome do arquivo no disco – a partir do RootPath do ambiente – a ser mostrado pelo componente. Não é necessário especificar esta informação no construtor, a imagem pode ser carregada posteriormente pelo método Load(). O tipo ou formato da imagem suportada está documentado na classe tBitmap
NOBORDER
NCláusula opcional, permite especificar que não deve ser desenhada uma borda no componente da imagem. 
SIZE <nWidth>,<nHeight>NNPermite opcionalmente definir um tamanho da área a ser ocupada pelo componente na interface, especificando o comprimento e a altura como variáveis ou constantes numéricas.
Caso não especificado, será assumido o tamanho da imagem carregada
 
OF | WINDOW | DIALOG <oWnd>ONCláusula opcional, quando informada permite especificar o nome de uma variável AdvPL que contenha o objeto ou componente pai de interface (janela ou diálogo, painel, folder) onde o componente deve ser exibido. Caso seja omitida, o componente será criado na janela ou diálogo ativos no momento. 
ON CLICK | ON LEFT CLICK <cbClick>CNExpressão utilizada pelo comando para montar um bloco de código a ser executado caso o usuário realize um clique com o botão esquerdo do mouse sobre a imagem. Não pode ser chamado um CodeBlock, deve ser informada uma função a ser executada de forma literal.  
ON RIGHT CLICK <cbRClick>CNExpressão similar a especificada na cláusula ON CLICK, porém somente será executada caso a imagem receba um clique com o botão direito do mouse.
SCROLL
NQuando informado, indica ao componente que ele está habilitado a habilitar as barras de rolagem lateral e inferior, caso a imagem carregada não caiba no espaço definido para o componente na interface.
ADJUST
NQuando informado, permite ajustar a imagem (stretch) ao espaço reservado ao componente na interface. Dependendo da relação entre o tamanho real da imagem e do espaço definido para o componente, a imagem pode ficar distorcida. 
CURSOR <oCursor>ONCláusula opcional, permite informar um objeto AdvPL do tipo TCursor(), para que seja possível trocar o ponteiro do mouse quando ele estiver sobre a imagem. 
PIXEL 
NCláusula opcional, quando uma delas for especificada, indica que o sistema de coordenadas usado nos parâmetros <nRow> e <nCol> são em pixels (ou pontos) a partir da coordenada superior esquerda (0,0) do componente visual pai em uso no qual o objeto será posicionado. 
WHEN <cbWhen>CNCláusula opcional, permite especificar uma função com retorno booleano, executada a cada troca de foco na interface, para determinar se a imagem atual permite aceitar um evento de clique.
VALID <cbValid>CNCláusula opcional, permite especificar uma função com retorno booleano a ser executada quando o componente – caso habilitado para receber foco – permita a saída do foco do mesmo. 

Classe usada pelo comando

...