Pular para o conteúdo

Como Pintar DBGrid Delphi: 5 Blocos Prontos (OnDrawColumnCell)

Quem nunca precisou pintar DBGrid Delphi para dar uma “vida” naquela tabela cinza e sem graça, destacar um registro cancelado ou mostrar claramente qual linha o usuário selecionou?

O segredo para fazer isso sem precisar comprar componentes de terceiros está no evento OnDrawColumnCell.

A ideia aqui é bem simples: antes de o Delphi desenhar a célula na tela, a gente intercepta o pincel (Canvas.Brush.Color) para mudar o fundo ou a caneta (Canvas.Font.Color) para mudar a cor da letra. Depois, mandamos ele terminar o serviço com o FillRect e o DefaultDrawColumnCell.

⚠️ Um aviso rápido antes de sair copiando:

Os códigos que deixei abaixo são blocos independentes.

Pegue apenas o trecho que resolve o seu problema de agora.

Se você colar tudo junto de uma vez sem adaptar a lógica, uma cor vai atropelar a outra e sua tela vai virar um carnaval.

Só não se esqueça de manter as duas linhas finais de renderização no encerramento do evento, combinado?


O que você precisa para pintar o DBGrid no Delphi?

Eu testei e uso esses trechos no dia a dia em sistemas VCL rodando no Delphi 10 Seattle. Para o compilador não reclamar de constantes como gdSelected “ou”clGreen, dê uma conferida se essas três units estão declaradas na uses do seu formulário:

  • Vcl.Graphics
  • Vcl.Grids
  • Vcl.DBGrids

Onde colar o código?

Ilustração conceitual de um pincel digital pintando células sobre uma grade, representando o Canvas no evento OnDrawColumnCell do Delphi.

Clique no seu TDBGrid, vá lá no Object Inspector, abra a aba Events e dê um duplo clique no OnDrawColumnCell.

O Delphi vai criar a estrutura abaixo para você. Tudo o que formos fazer vai entrar exatamente onde está o comentário:

Procedure TForm1.DBGrid1DrawColumnCell(Sender: TObject; const Rect: TRect;
  DataCol: Integer; Column: TColumn; State: TGridDrawState);
begin
  
   // ---> COLE AQUI APENAS O BLOCO QUE VOCÊ PRECISA <---

   // Essas duas linhas são obrigatórias no final para pintar a tela:
   TDBGrid(Sender).Canvas.FillRect(Rect);
   TDBGrid(Sender).DefaultDrawColumnCell(Rect, DataCol, Column, State);
end;

Blocos Prontos!

1. Destacar a linha selecionada ou em foco.

Sabe quando o usuário navega pela tabela e se perde porque a seleção padrão é fraca?

Esse bloco resolve isso pintando a linha inteira de verde e jogando a letra para branco (porque ninguém merece ler texto preto no fundo escuro).

if (gdSelected in State) or (gdFocused in State) then
begin
  TDBGrid(Sender).Canvas.Brush.Color := clGreen;
  TDBGrid(Sender).Canvas.Font.Color := clWhite; // Garante que dê para ler direito
end
else
begin
  TDBGrid(Sender).Canvas.Brush.Color := clWindow;
end;

2. Fazer aquele efeito zebrado (linhas alternadas).

Quando a tabela tem muitas colunas, o olho do usuário agradece se você alternar as cores das linhas para ele não ler o dado da linha de baixo por engano.

if not (gdSelected in State) then
begin
  if Odd(TDBGrid(Sender).DataSource.DataSet.RecNo) then
    TDBGrid(Sender).Canvas.Brush.Color := clWindow
  else
    TDBGrid(Sender).Canvas.Brush.Color := $00F5F5F5; // Um cinza bem suave
end;

Dica de trincheira:

O RecNo funciona perfeitamente com TClientDataSet e TFDQuery (FireDAC). Mas, se você estiver usando algum dataset unidirecional antigo (tipo TSQLQuery do dbExpress), o RecNo costuma retornar -1 e o efeito não acontece.

👀 Fica o alerta!


3. Mudar a cor da letra por regra de negócio (ex: Item Cancelado).

Esse é clássico de tela de vendas ou estoque.

Se o registro estiver marcado como cancelado no banco, a gente joga a fonte para vermelho na hora.

if (cdsProdutosCancelados.AsString = 'S') then
  TDBGrid(Sender).Canvas.Font.Color := clRed;

4. Pintar apenas o texto de uma coluna específica.

Aqui a gente usa o DataCol que é a posição da coluna na grade.

Lembre-se de que a contagem no Delphi começa no 0 (então 0 é a primeira coluna da esquerda).

if (DataCol = 0) then
  TDBGrid(Sender).Canvas.Font.Color := clGreen;

5. Pintar o fundo de uma coluna inteira.

Se você quer chamar atenção para uma coluna de total ou status, basta mudar o Brush.Color olhando para o índice dela (no exemplo abaixo, a terceira coluna, índice 2).

if (DataCol = 2) then
  TDBGrid(Sender).Canvas.Brush.Color := clAqua;

Dúvidas que sempre aparecem na hora H.

Coloquei o código e a cor da linha selecionada não mudou nada. E agora?

Dá uma olhada em duas coisas: primeiro, veja se a propriedade DefaultDrawing do seu TDBGrid está como True no Object Inspector.

Segundo, se o seu sistema usa VCL Styles (aqueles temas visuais do Delphi), o tema costuma passar por cima das cores manuais do Canvas.

Tem como pintar a coluna pelo nome do campo em vez do número?

Com certeza, e na prática é até mais seguro.

Se o usuário arrastar a coluna para o lado com o mouse, o índice DataCol muda e a cor vai para o lugar errado. Para travar no campo certo, troque o if (DataCol = 2) por if (Column.FieldName = 'NOME_DO_CAMPO')


Testado e rodando em produção no Delphi 10 Seattle.


Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *