DSIMAGEMFUNDOEXTENSAOCRC005 — Extensão da Imagem de Fundo CRC005

Tela de configuração: REC001 — Parâmetros de Recapadora Tabela: PARAMRECAP.DSIMAGEMFUNDOEXTENSAOCRC005 Tipo: VARCHAR(5) (DOM_VARCHAR5) Valor padrão: (nenhum) — nulo até que uma imagem seja carregada

Finalidade

Armazena a extensão do arquivo de imagem (ex.: .JPG, .GIF) selecionada como imagem de fundo da tela CRC005. O campo é gravado automaticamente pelo sistema quando o usuário seleciona um arquivo de imagem; não é editável diretamente na tela de parâmetros.

A extensão é utilizada por CRC005 para determinar o formato de renderização (JPEG ou GIF). Imagens com extensão .BMP e .PNG são rejeitadas no momento da carga.

Telas impactadas

Tela	Efeito
CRC005 — Tela de recapadora	Lê a extensão para renderizar a imagem de fundo (imgFundo). Se a extensão for .BMP ou .PNG, exibe mensagem de erro e não carrega.

Campos envolvidos

Campo	Tabela	Relação
DSIMAGEMFUNDOEXTENSAOCRC005	PARAMRECAP	Extensão do arquivo (ex.: .JPG)
BIIMAGEMFUNDOCRC005	PARAMRECAP	Blob com o conteúdo binário da imagem

Os dois campos são gravados/atualizados juntos pelo componente updIMAGEM em UdmCRC005.

Opções disponíveis

Este parâmetro não possui lista de opções configuráveis. O valor é preenchido automaticamente pelo sistema ao selecionar um arquivo de imagem.

O que faz	Detalhe
Gravado automaticamente	Ao clicar em "Alterar Imagem de Fundo" em CRC005, o sistema extrai a extensão do arquivo escolhido e salva neste campo.
Limitado a 5 caracteres	Domínio DOM_VARCHAR5 — comporte extensões como .JPEG.
Removido junto com a imagem	Ao remover a imagem de fundo, o campo recebe string vazia ('').

Extensoes suportadas pela renderização

Extensão	Comportamento
.JPG / .JPEG	Renderiza como TJpegImage ✅
.GIF	Renderiza como TGIFImage ✅
.BMP	Rejeitado — exibe erro "A imagem possui extensão .BMP e não é permitida" ❌
.PNG	Rejeitado — exibe erro "A imagem possui extensão .PNG e não é permitida" ❌
Qualquer outra	Imagem não é exibida (atribui nil ao Picture)

Simulação passo a passo — Carregar imagem de fundo

1. Acesse a tela CRC005 (Tela de Recapadora).
2. Localize o menu ou botão de "Alterar Imagem de Fundo".
3. Selecione um arquivo de imagem (ex.: fundo_loja.jpg).
   • O sistema valida o tamanho (máximo 2 MB). Se exceder, exibe: "A Imagem possui tamanho superior à 2 MB. Verifique!".
4. O sistema grava o conteúdo binário em BIIMAGEMFUNDOCRC005 e a extensão .JPG em DSIMAGEMFUNDOEXTENSAOCRC005.
5. A imagem é renderizada como plano de fundo da tela CRC005.

Resultado esperado: A imagem .JPG ou .GIF é exibida como fundo da tela CRC005. A extensão fica salva no banco para reexibição em próximas aberturas.

Excecao / Importante: Arquivos .BMP e .PNG são aceitos na seleção de arquivo, mas rejeitados na renderização com mensagem de erro específica. O sistema não converte o formato — é necessário fornecer arquivo já em formato suportado.

Simulação passo a passo — Remover imagem de fundo

1. Acesse a tela CRC005.
2. Localize o botão de "Remover Imagem de Fundo".
3. Clique para remover.
4. O sistema limpa ambos os campos: BIIMAGEMFUNDOCRC005 recebe nil e DSIMAGEMFUNDOEXTENSAOCRC005 recebe string vazia ('').

Resultado esperado: A imagem de fundo desaparece da tela CRC005. Os campos ficam vazios no banco de dados.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	O que faz
TfrmCRC005.AlterarImagemFundoClick	UCRC005.pas:644	Grava a extensão extraída do nome do arquivo selecionado.
TfrmCRC005.loadImagem	UCRC005.pas:671	Lê a extensão para decidir como renderizar (JPEG, GIF, ou erro).
TfrmCRC005.RemoverImagemFundoClick	UCRC005.pas:723	Limpa o campo (atribui string vazia).

Referências SQL diretas ao campo

Não foram encontradas referências diretas ao campo DSIMAGEMFUNDOEXTENSAOCRC005 em procedures SQL em Scripts/. As queries de acesso ao campo estão encapsuladas nos componentes tabIMAGEM e updIMAGEM do data module UdmCRC005.dfm (INSERT, UPDATE, SELECT, FetchRow).

Candidatas por uso da tabela PARAMRECAP

Diversas procedures em Scripts/ fazem JOIN ou SELECT na tabela PARAMRECAP, mas nenhuma dessas rotinas referencia o campo DSIMAGEMFUNDOEXTENSAOCRC005 — utilizam apenas outros parâmetros da mesma tabela. Não há impacto funcional direto nessas procedures.