Laboratório de Programação I Carlos Oberdan Rolim Ciência da Computação Sistemas de Informação

Componentes TStringGrid

TStringGrid A aba Additional do C++ Builder oferece o componente de tabela de strings (classe TStringGrid). Componente permite ao usuário adicionar uma tabela ao seu projeto, podendo preencher as células com dados no formato de objetos da classe AnsiString.

Propriedades mais importantes RowCount e ColCount – estas propriedades permitem mudar/ler o número de linhas ou colunas que compõem o grid, respectivamente. Cells[col][lin] – representa a string armazenada na célula referenciada pela linha lin e pela coluna col. A primeira linha do grid possui índice 0, bem como a primeira coluna.

Propriedades mais importantes Selection – esta propriedade indica a porção do grid que está selecionada, através de um objeto da classe TGridRect. Os atributos Left, Top, Right e Bottom representam, respectivamente, a coluna e a linha da primeira célula da seleção e a coluna e a linha da última célula da seleção. Pode-se impedir que o usuário selecione várias células, mudando-se o valor da subpropriedade goRangeSelect, da propriedade Options para false. FixedRows e FixedCols – permitem fixar um determinado número de linhas ou colunas do grid, respectivamente. As células fixas são pintadas em cor diferente e normalmente são utilizadas para a exibição de informações de cabeçalho da tabela.

Propriedades mais importantes ScrollBars – Define se as barras de rolagem devem aparecer em ambos os lados (ssBoth), somente na horizontal (ssHorizontal), somente na vertical (ssVertical), ou não devem aparecer (ssNone) GridLineWidth – Define o tamanho de cada linha da grid FixedRows / FixedCols – Ativa (valor em 1) ou desativa (valor em 0) as linhas e colunas fixas (primeira a aparecer) da grid FixedColor – Define a cor das colunas fixas

Exemplo de código void __fastcall TForm1::FormCreate(TObject *Sender){ StringGrid1->RowCount = 6; StringGrid1->ColCount = 4; StringGrid1->FixedRows = 1; StringGrid1->FixedCols = 0; StringGrid1->Cells[0][0] = "Coluna 1"; StringGrid1->Cells[1][0] = "Coluna 2"; StringGrid1->Cells[2][0] = "Coluna 3"; //insere a opção goRangeSelect na lista de opções // para permitir a selecao de mais de uma celula StringGrid1->Options = StringGrid1->Options << goRangeSelect; TGridRect coords; coords.Left = 1; coords.Top = 1; coords.Right = 2; coords.Bottom = 3; StringGrid1->Selection = coords; } Usados para efetuar a seleção de celulas. Coordenadas correspondem a retangulo delimitado por coordenada superior x coordenada inferior

Exemplo de form criado com código anterior

Eventos mais importantes OnGetEditMask ocorre quando entramos no modo de edição. Neste momento podemos verificar em qual linha/coluna se encontra o cursor e então, se quiser, poderá especificar uma máscara de edição. Exemplo: void __fastcall TForm1::StringGrid1GetEditMask(TObject *Sender, int ACol, int ARow, UnicodeString &Value) { if (ARow == 1 && ACol == 1) Value = "(999) ;1;_"; // Telefone if (ARow == 1 && ACol == 2) Value = "99/ 99/9999"; // Data }

Eventos mais importantes OnSetEditText ocorre quando saímos do modo de edição. Neste momento podemos manipular a entrada e trocar por um texto equivalente. void __fastcall TForm1::StringGrid1SetEditText(TObject *Sender, int ACol, int ARow, const UnicodeString Value){ if (ARow == 1 && ACol == 2) Label1->Caption = "Valor Digitado: " + Value; }

Eventos mais importantes OnSelectCell ocorre quando selecionamos uma célula void __fastcall TForm1::StringGrid1SelectCell(TObject *Sender, int ACol, int ARow, bool &CanSelect){ if (ARow == 1 && ACol == 2) Label1->Caption = "Selecionada a celula [1][2]"; }