TCanvas

A classe TCanvas encapsula um dispositivo de contexto Windows na VCL e um dispositivo de pintura (Qt painter) em CLX, que lida com todo desenho para forms, containers visuais (como panels) e o objeto printer, em ambas as formas. Usando o objeto canvas, você não tem dificuldades para alocar pens, brushes, palettes, e assim por diante — todas as alocações e desalocações são tratadas por você.

TCanvas inclui um grande número de gráficos primitivos, rotinas para desenhar linhas, shapes (figuras), polygons (polígonos), fonts (fontes), etc para qualquer controle que contém um canvas.

O exemplo abaixo trata um evento através do clique de um botão, determinando o desenho de uma linha desde as coordenadas X = 100 e Y = 100 até as coordenadas X = 200 e Y = 200, bem como a colocação de um texto, cujo início dar-se-á nessas últimas coordenadas:

void __fastcall TForm1::Button1Click(TObject *Sender)

{
   Canvas->Pen->Color = clBlue;
   Canvas->MoveTo( 100, 100 );
   Canvas->LineTo( 200, 200 );
   Canvas->Brush->Color = clBtnFace;
   Canvas->Font->Name = "Arial";
   Canvas->TextOut( Canvas->PenPos.x, Canvas->PenPos.y,"Este é o fim da linha" );
}

O objeto TCanvas também protege você contra erros gráficos comuns Windows, como por exemplo restaurar dispositivos contexto, pens, brushes, e assim por diante de acordo com os valores que eles possuiam antes da operação desenho. TCanvas é usado em qualquer lugar no C++Builder onde um desenho seja requerido ou possível, e faz gráficos facilmente.