TableView (gb.form)

Este controle é um GridView editável.

Esta classe herda GridView em gb.qt4.

Esta classe é criável.

Esta classe funciona como um array apenas leitura.

Inherited constants
Both   Indica que ambos os headers, horizontal e vertical devem ser exibidos.
Horizontal   Indica que o header horizontal deve ser exibido.
None   Indica que nenhum header é exibido.
Vertical   Indica que o header vertical deve ser exibido.

Propriedades
Editor   Retorna o controle usado para editar a célula.
NoKeyboard   Retorna ou define se as teclas de seta irá mover da célula atual.

Inherited properties
Action   Retorna ou define a sequência de ação associado ao controle.
AutoResize   Retorna ou define se a última coluna será automaticamente redimensionada para que a área de visão do gridview seja totalmente preenchida.
Background   Retorna ou define a cor de fundo utilizada pelo controle.
Border   Retorna ou define se o controle exibe uma borda.
Children   Retorna uma coleção contendo todos os controles incluídos no contêiner.
ClientH   Um sinônimo para a propriedade ClientHeight.
ClientHeight   Retorne a altura da área interna que contém as células.
ClientW   Um sinônimo para a propriedade ClientWidth.
ClientWidth   Retorna a largura da área interna que contém as células.
ClientX   Retorna à posição esquerda da área interna que contém as células.
ClientY   Retorna à posição superior da área interna que contém as células.
Column   Retorna ou define o índice da coluna atual.
Columns   Retorna uma matriz virtual de cada coluna do gridview.
Current   Retorna a célula atual.
Cursor   Use essa propriedade para atribuir um cursor personalizado para um controle.
Data   Use essa propriedade para armazenar o conteúdo de uma célula durante o manipulador de eventos Data.
Design   Indica que o controle está no modo design.
Direction  
Drop   Retorna ou define se um controle aceita drops.
Enabled   Indica que o controle está habilitado.
Expand   Retorna ou define se um controle irá se expandir se for incluída em um contêiner que organiza seu conteúdo.
Font   Retorna ou define a fonte usada para desenhar o texto no controle.
Foreground   Retorna ou define a cor do primeiro plano usado pelo controle.
Grid   Retorna ou define se a grade é exibida.
H   Um sinónimo para a propriedade Height.
Handle   Retorna a janela X11 interna manipulador do controle.
HasFocus   Retorna se o controle tem o foco.
Header   Retorna ou define quais os headers devem ser exibidos:
Height   Retorna ou define a altura do controle.
Hovered   Retorna se o cursor do mouse está sobre o controle.
Id   Um sinônimo para a propriedade Handle.
Ignore   Retorna ou define se um controle deve ser ignorado quando o controle pai organiza os seus filhos.
Left   Retorna ou define a posição da borda esquerda do controle em relação a seu pai.
Mode   Retorna ou define o modo de seleção:
Mouse   Retorna ou define a aparência do cursor quando ele está sobre o controle.
Name   Retorna ou define o nome do controle.
Next   Retorna o próximo controle que tem o mesmo pai.
NoTabFocus   Retorna ou define se um controle não pode ser focalizado com a tecla TAB.
Padding   Retorna ou define o padding padrão da célula em pixels.
Parent   Retorna o contêiner do controle.
PopupMenu   Retorna ou define o nome do menu pop-up que será exibido quando o usuário pressiona o botão direito do mouse ou a tecla MENU do teclado.
Previous   Retorna o controle anterior que tem o mesmo pai.
Proxy   Retorna ou define o "proxy" de um controle.
Resizable   Retorna ou define se os headers das colunas são redimensionáveis.
RightToLeft  
Row   Retorna ou define o índice da linha atual.
Rows   Retorna uma matriz virtual de cada linha do gridview.
ScreenX   Retorna a posição da borda esquerda do controle em coordenadas da tela.
ScreenY   Retorna a posição da borda superior do controle em coordenadas da tela.
ScrollBar   Retorna ou define que as barras de rolagem são exibidos.
ScrollH   Um sinônimo para ScrollHeight.
ScrollHeight   Retorna a altura conteúdo.
ScrollW   Um sinônimo para ScrollWidth.
ScrollWidth   Retorna a largura conteúdo.
ScrollX   Retorna ou define a posição de rolagem horizontal.
ScrollY   Retorna ou define a posição de rolagem vertical.
ShowCursor   Retorna ou define se uma borda de destaque é desenhada ao redor da célula atual.
Sorted   Retorna ou define se ao clicar no cabeçalho da coluna alterna o indicador de classificação.
Tag   Retorna ou define a marca do controle.
Tooltip   Retorna ou define a dica mostrada quando o mouse permanece no controle pro um determinado tempo.
Top   Retorna ou define a posição da borda superior do controle em relação a seu pai.
Tracking   Retorna ou define se o controle receberá Eventos MouseMove.
Visible   Indica se o controle é visível ou não.
W   Um sinônimo para a propriedade Width.
Width   Retorna ou define a largura do controle.
Window   Retorna a janela de nível superior que contém o controle.
X   Retorna ou define a posição da borda esquerda do controle em relação a seu pai.
Y   Retorna ou define a posição da borda superior do controle em relação a seu pai.

Métodos
Cancel   Cancela a edição atual.
Clear   Apaga o conteúdo estático da grade.
Edit   Inicia a edição da célula atual.
EditWith   Edite a célula atual com um controle específico.
Save   Salva a edição atual e atualiza o item TableView editado.

Inherited methods
AddColumn  
ColumnAt   Retorna o índice da coluna apontada pela posição horizontal especificada.
Delete   Destrói o controle.
Drag   Inicia um processo de arrastar e soltar.
FindChild   Localiza o primeiro controle filho apontado pelas coordenadas X e Y.
Grab   Captura o teclado e o mouse de modo que todos os eventos do teclado e do mouse são interceptados pelo controle.
Hide   Oculta o controle.
Lower   Envia o controle para o background de seu pai.
Move   Move ou redimensiona o controle.
MoveScaled   Move ou redimensiona o controle.
MoveTo   Defina a linha e a coluna da célula atual.
Raise   Envia o controle para o foreground do controle pai.
Refresh   Redesenha o controle, ou apenas uma parte dela.
Reparent   Altera o contêiner de um controlo.
Resize   Redimensiona o controle.
ResizeScaled   Redimensiona o controle.
RowAt   Retorna o índice da linha apontada pela posição vertical especificada.
Scroll   Rolar o conteúdo para uma determinada posição.
Select   Seleciona várias linhas.
SelectAll   Selecione todas as linhas.
SetFocus   Dá o foco para o controle.
Show   Mostra o controle.
UnSelectAll   Desmarca todas as linhas.

Eventos
Click   Este evento é gerado quando o usuário clica em um celular.
Hide  
Insert   Este evento é gerado quando o usuário solicitou uma inserção pressionando a tecla RETURN dentro da ultima célula.
Save   Este evento é disparado quando algum valor deve ser salvo em uma célula especifica.

Inherited events
Activate   Gerado quando o usuário clica duas vezes em uma célula.
Arrange   Este evento é gerado quando um contêiner acabou organizar seu conteúdo.
BeforeArrange   Este evento é gerado antes de um recipiente organizar seu conteúdo.
Change   Gerado quando a célula atual mudou.
ColumnClick   Gerado quando o usuário clica no título da coluna.
ColumnResize   Gerado quando uma coluna é redimensionada.
ColumnSize   Gerado quando uma coluna específica foi redimensionada.
Data   Este evento é gerado quando os dados armazenados na célula especificada é necessário (geralmente para desenhá-lo).
DblClick   Gerado quando o usuário clica duas vezes rapidamente no controle.
Drag   Este evento é gerado quando o mouse entra no controle durante um processo de arrastar e soltar.
DragLeave   Este evento é gerado quando o mouse deixa o controle durante uma operação drag & drop.
DragMove   Este evento é gerado enquanto o mouse se move dentro do controle durante um processo de arrastar e soltar.
Draw   Gerado quando uma célula deve ser desenhada.
Drop   Este evento é gerado quando um drag é descartado no controle.
Enter   Gerado quando o mouse entra no controle.
Font  
GotFocus   Gerado quando o controle recebe o foco.
KeyPress   Gerado quando uma tecla é pressionada enquanto o controle tem o foco.
KeyRelease   Gerado quando uma tecla é liberada enquanto o controle tem o foco.
Leave   Gerado quando o mouse deixa o controle.
LostFocus   Gerado quando o controle perde o foco.
Menu   Gerado quando o usuário clica no controle com o botão direito do mouse, ou pressiona a tecla "Menu".
MouseDown   Gerado quando um botão do mouse é pressionado enquanto o cursor está dentro do controle.
MouseDrag   Este evento é gerado quando uma operação de arrastar (drag) é iniciada.
MouseMove   Gerado quando o mouse se move dentro do controle, enquanto um botão do mouse é pressionado.
MouseUp   Gerado quando um botão do mouse é pressionado enquanto o cursor estiver dentro do controle.
MouseWheel   Este evento é gerado quando o usuário move ou pressiona a roda do mouse enquanto o mouse está dentro do controle
NewChild   Este evento é gerado quando um novo Control filho acaba de ser inserido no contêiner.
RowClick   Gerado quando o usuário clica em um título (header) da linha.
RowResize   Gerado quando uma linha é redimensionada.
RowSize   Gerado quando uma linha específica foi redimensionada.
Scroll   Gerado quando o conteúdo do controle foi rolado.
Select   Gerado quando a seleção muda.
Sort   Gerado quando o conteúdo do GridView deve ser classificada.

Como fazer uma célula editável

Para fazer com que uma célula torne-se editável, você deve chamar o método Edit ou EditWith em resposta a um evento Click ou Activate.

Chamando um destes métodos cria um widget editor celular que permite ao usuário modificar o conteúdo da célula. Este editor é gerenciado automaticamente pelo TableView.

Se o usuário modificar o conteúdo da célula, o evento Save é levantado, e você deve realmente salvar os dados durante o manipulador de eventos Save. Isso não será automático!

Se você deseja cancelar explicitamente uma edição, chame o método Cancel.

Gerenciando o Teclado

Acionar uma tecla de seta durante a edição de uma célula, automaticamente move o editor da célula para a célula editável mais próximo.

Para saber se uma célula é editável ou não, levante o evento Click ou Activate, e se o método Edit ou EditWith não for chamado em resposta ao evento, o movimento é repetido até que o fim do TableView seja atingido.

Acionar a tecla ESC cancela a edição atual.

Acionar a tecla ENTER ou RETURN salta para a próxima célula, como faz a tecla seta para a direita. Mas, se o fim do TableView for atingido, o evento Insert é levantado.

Leve em consideração que o método Edit ou EditWith deve ser chamado durante o manipulador de eventos Click ou Activate, caso contrário, a gestão do teclado não vai funcionar!