DataSource (gb.db.form)

DataSource é um contêiner que fornece dados a partir de um banco de dados para todos os seus filhos e netos de forma recursiva: Ele usa suas propriedades Table e Filter e uma conexão aberta para fazer um objeto Result. A partir deste Result, ele preenche seus controles filhos.

A base de dados é definida pela propriedade Connection.

Propriedades

Ascending	Retorno ou define se a classificação é ascendente.
Connection	Retorno ou define a Connection que será utilizado pelo controle DataSource.
Count	Retorna o número de registros.
Current	Retornar os valores de todas as chaves primárias do registro atual como uma matriz Variant.
Filter	Retorna ou define os critérios da propriedade Filter. Uma string vazia (o padrão) aceita tudo.
IgnoreParent
Index	Retorne o índice do registro atual.
Modified	Retorno se o registro atual foi modificado por um dos controles filhos do DataSource.
ReadOnly	Retorno ou define se o DataSource é somente leitura.
Sort	Retorno ou defina o campo usado para classificar os dados.
Table	Retorna ou define o nome da tabela que deseja usar.

Action	Retorna ou define a sequência de ação associado ao controle.
Arrangement	Retorna ou define como este contêiner organizar seus controles filhos.
AutoResize	Indica que o contêiner é redimensionado automaticamente para ajustar-se ao tamanho do seu conteúdo.
Background	Retorna ou define a cor de fundo utilizada pelo controle.
Border	Retorna ou define o tipo de borda do controle.
Centered
Children	Retorna uma coleção contendo todos os controles incluídos no contêiner.
ClientH	Um sinônimo para a propriedade ClientHeight property.
ClientHeight	Retorna a altura da área que contém os controlos.
ClientW	Um sinônimo para a propriedade ClientWidth.
ClientWidth	Retorna a largura da área que contém os controlos.
ClientX	Retorna a posição da borda superior da área que contém os controles.
ClientY	Retorna a posição da borda esquerda da área que contém os controles.
Cursor	Use essa propriedade para atribuir um cursor personalizado para um controle.
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.
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.
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.
Indent	Retorna ou define se os controles filhos do contêiner são recuados.
Invert	Retorna ou define se a direção de arranjo horizontal ou vertical é invertido.
Left	Retorna ou define a posição da borda esquerda do controle em relação a seu pai.
Margin	Retorna ou define se existe uma margem entre a borda do contêiner e todos os seus filhos.
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 número de pixels usados como espaço entre controles filhos, ou margem interna do contêiner.
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.
RightToLeft
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.
Spacing	Retorna ou define se existe espaço entre os controles filhos do contêiner.
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 qualquer edição atual dos controles filhos.
Create	Salva os dados dos data controls e limpa-os depois. Se bRefresh é False, não Commit a operação até que o método Refresh seja usado.
Find	Find the first row matching a SQL request from the current position.
FindNext	Find the next row matching a SQL request from a specific position.
GetKeys	O método GetKeys retorna como uma matriz todos os campos usados como chave primária.
MoveFirst	Move do registro atual para o primeiro registro e retornar se o movimento foi possível.
MoveLast	Move do registro atual para o último registro e retornar se o movimento foi possível.
MoveNext	Move do registro atual para a próxima e retornar se o movimento foi possível.
MovePrevious	Move do registro atual para o anterior e retornar se o movimento foi possível.
MoveTo	Move do registro atual para o registro Indexth e retorna se o movimento foi possível.
Remove	Remove o registro atual do banco de dados, e retornar se a remoção foi possível.
Reset	Redefine o cache de metadados da conexão interna utilizada pelo DataSource.
ResetAll	Redefine completamente o cache de metadados da conexão interna.
Save	Escreve os valores de DataControls para o banco de dados (ligado através da propriedade Connection).
Update	Atualiza os dados DataSource e atualiza todos os controles filhos vinculados em conformidade.

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.
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.
SetFocus	Dá o foco para o controle.
Show	Mostra o controle.

Eventos

BeforeDelete	Este evento é gerado pouco antes de excluir um registro.
BeforeSave	Este evento é gerado um pouco antes do DataSource salvar os dados.
Change	Gerado quando o registro atual DataSource mudou e todos os controles filhos anexos são atualizados.
Invalid	This event is raised when the value entered for a specific field is invalid.

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.
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.
Drop	Este evento é gerado quando um drag é descartado no controle.
Enter	Gerado quando o mouse entra no controle.
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.

Veja também