Home

Download

Documentação

A Fazer...

Links Pascal

Começar

TDataSet - WOLGUI

Descendente de TWOLRoot. A classe apresenta as propriedades básicas para manipular dados de forma que se possa navegar por eles. Essa classe é baseada no TDataSet da FCL do Free Pascal, por isso não leva o prefixo TWOL. Arquivo fonte: WOLDBK01.PP.

Propriedades do TDataSet

Propriedade	Descrição
Active	Propriedade que indica se o dataset está ativo (aberto) ou não.
AutoCalcFields	Propriedade que indica se o dataset chama o evento que calcula os campos calculados automaticamente.
BOF	Propriedade que indica o início da lista de dados (primeiro registro).
Bookmark	Propriedade que retorna um marcador de registro na forma de string. É do tipo TBookmarkStr.
CanModify	Propriedade que indica se os dados do dataset podem ser modificados ou não.
DataSource	Propriedade que carrega em si o datasource associado ao dataset. Essa propriedade é negligenciada na WOL. Os objetos acessam os dados diretamente do banco de dados. É do tipo TDataSource.
DefaultFields	Propriedade que indica que o dataset apresenta os campos defaults.
EOF	Propriedade que indica se a posição corrente é o final da lista de dados (último registro).
FieldCount	Propriedade que indica a quantidade de campos do dataset.
FieldDefs	Propriedade que carrega a lista de definições de campos do dataset. É do tipo TFieldDefs.
Fields[Index:Integer]	Propriedade que carrega o campo de índice especificado. É do tipo TField.
FieldValues[FieldName:string]	Propriedade que carrega o valor do campo de nome indicado. É do tipo Variant.
Filter	Propriedade que carrega a informação de seleção de registro.
Filtered	Propriedade que indica se o dataset está sendo filtrado ou não. Ver Filter.
FilterOptions	Propriedade que indica as opções de filtragem (seleção de registros) do dataset. É do tipo TFilterOptions.
Found	Propriedade que indica que a última busca foi bem sucedida ou não.
Modified	Propriedade que indica se o dataset foi modificado ou não.
RecNo	Propriedade que indica o registro corrente apontado pelo ponteiro do dataset.
RecordCount	Propriedade que retorna a quantidade registros do dataset.
RecordSize	Propriedade que retorna o tamanho de cada registro do dataset.
State	Propriedade que indica o estado de edição do dataset. É do tipo TDataSetState.

Métodos e Eventos Públicos

— function ActiveBuffer:PChar;

Método usado para recuperar o buffer de dados correntemente ativo.

— procedure Append;

Método usado para apendar (inserir ao final) um registro vazio na lista do dataset.

— procedure AppendRecord(const Values: array of const);

Método usado para apendar um registro contendo um conjunto de dados (um para cada campo) na lista do dataset.

— function BookMarkValid(aBookmark:TBookmark):Boolean; virtual;

Método usado para averiguar a validade de um marcador de registro.

— procedure Cancel; virtual;

Método usado para cancelar uma operação. Em geral, a última operação.

— procedure CheckBrowseMode;

Método usado internamente para verificar o modo de edição e gravar informações pendentes.

— procedure ClearFields;

Método usado internamente para limpar as informações dos campos.

— procedure Close;

Método usado para fechar o dataset.

— function CompareBookmarks(Bookmark1, Bookmark2:TBookmark):Integer; virtual;

Método usado internamente para comparar dois marcadores de registros.

— function ControlsDisabled: Boolean;

Método usado para inferir se os objetos agregados ao dataset estão desabilitados.

— constructor Create(AOwner: TWOLRoot); override;

Método usado para criar o objeto.

— procedure CursorPosChanged;

Método usado internamente para informar ao objeto que o ponteiro de registro mudou de posição.

— procedure Delete;

Método usado para apagar o registro corrente.

— destructor Destroy; override;

Método usado para destruir o objeto.

— procedure DisableControls;

Método usado para desabilitar componentes que estejam agregados ao dataset como um datasource.

— procedure Edit;

— Método usado para por o dataset em estado de edição.

— procedure EnableControls;

Método usado para habilitar os objetos agregados ao dataset como um datasource.

— function FieldByName(const FieldName:string):TField;

Método usado para retornar um campo pelo nome que o campo da tabela tem. Muito usado para manipular dados em uma tabela juntamente com as propriedades que retornam valores dos campos: Tabela.FieldByName('NomeCampo').AsString:='Carlos';.

— function FindField(const FieldName:string):TField;

Método usado para procurar um campo pelo nome. Se o campo não existir, retorna nil.

— function FindFirst:Boolean;

Método usado para veriricar se uma informação foi encontrada numa primeira posição.

— function FindLast:Boolean;

Método usado para veriricar se uma informação foi encontrada na posição mais posterior à corrente.

— function FindNext:Boolean

Método usado para verificar se uma informação foi encontrada numa posição posterior à corrente.

— function FindPrior:Boolean;

Método usado para verificar se uma informação foi encontrada numa posição anterior à corrente.

— procedure First;

Método usado para mover o ponteiro de registro para a primeira posição.

— procedure FreeBookmark(aBookmark:TBookmark); virtual;

Método usado para liberar da memória um marcador de registro. Deve ser chamado sempre que GetBookMark o for.

— function GetBookmark:TBookmark; virtual;

Método usado para recuperar o marcador de registro corrente.

— function GetCurrentRecord(Buffer:PChar):Boolean; virtual;

Método usado para recuperar em um buffer o registro corrente.

— procedure GetFieldList(List:TList; const FieldNames:string);

Método usado para recuperar uma lista contendo os campos indicados.

— procedure GetFieldNames(List:TStrings);

Método usado para recuperar uma lista de nomes dos campos do dataset.

— procedure GotoBookmark(aBookmark:TBookmark);

Método usado para se mover do registro corrente para o registro que foi marcado com GetBookMark.

— procedure Insert;

Método usado para inserir um registro em branco na posição corrente do ponteiro de registro.

— procedure InsertRecord(const Values:array of const);

Método usado para inserir um registro contendo os valores indicados na posição corrente do ponteiro de registro.

— function IsEmpty:Boolean;

Método usado para retornar se um dataset está vazio ou não.

— function IsLinkedTo(aDataSource:TDataSource):Boolean;

Método usado para averiguar se um datasource está ligado ao dataset.

— procedure Last;

Método usado para mover o ponteiro de registro para a última posição.

— function Locate(const KeyFields:string; const KeyValues:Variant; Options:TLocateOptions):Boolean; virtual;

Método usado para localizar um registro de acordo com os valores passados para comparação.

— function Lookup(const KeyFields:string; const KeyValues:Variant; const ResultFields:string):Variant; virtual;

Método usado para localizar valores dos campos especificados dentro da lista de dados do dataset.

— function MoveBy(Distance: Integer): Integer;

Método usado para mover o ponteiro de registro em uma determinada quantidade de registros. Valores positivos indicam que o movimento será em direção ao final. Negativos, ao início.

— procedure Next;

Método usado para mover o ponteiro de registro para a próxima posição relativa à corrente.

— procedure Open;

Método usado para abrir o dataset.

— procedure Post; virtual;

Método usado para gravar as informações contidas no registro corrente na lista do dataset.

— procedure Prior;

Método usado para mover o ponteiro de registro para uma posição anterior à atual.

— procedure Refresh;

Método usado para atualizar os dados do dataset.

— procedure Resync(Mode:TResyncMode); virtual;

Método usado para ressincronizar o ponteiro de registro lógico com o ponteiro de registro físico.

— procedure SetFields(const Values: array of const);

Método usado para copiar os valores passados para os valores dos campos do dataset.

— procedure Translate(Src, Dest: PChar; ToOem: Boolean); virtual;

Método usado para traduzir um conjunto de dados antes de gravá-los de acordo com os caracteres que são usados.

— procedure UpdateCursorPos;

Método usado para atualizar a posição do ponteiro de registro.

— procedure UpdateRecord;

Método usado para atualizar o registro corrente.

— AfterCancel:TDataSetNotifyEvent

Evento disparando quando uma operação é cancelada.

— AfterClose:TDataSetNotifyEvent

Evento disparando depois que o dataset é fechado.

— AfterDelete:TDataSetNotifyEvent

Evento disparando depois que um registro é apagado.

— AfterEdit:TDataSetNotifyEvent

Evento disparando depois que um registro é editado.

— AfterInsert:TDataSetNotifyEvent

Evento disparando depois que um registro é inserido.

— AfterOpen:TDataSetNotifyEvent

Evento disparando depois que o dataset é aberto.

— AfterPost:TDataSetNotifyEvent

Evento disparando depois que os dados são gravados.

— AfterScroll:TDataSetNotifyEvent

Evento disparando depois que o ponteiro do dataset muda de posição.

— BeforeCancel:TDataSetNotifyEvent

Evento disparando antes que uma opção seja cancelada.

— BeforeClose:TDataSetNotifyEvent

Evento disparando antes que o dataset seja fechado.

— BeforeDelete:TDataSetNotifyEvent

Evento disparando antes que um registro seja apagado.

— BeforeEdit:TDataSetNotifyEvent

Evento disparando antes que um registro seja editado.

— BeforeInsert:TDataSetNotifyEvent

Evento disparando antes que um registro seja inserido.

— BeforeOpen:TDataSetNotifyEvent

Evento disparando antes que o dataset seja aberto.

— BeforePost:TDataSetNotifyEvent

Evento disparando antes que um registro seja gravado.

— BeforeScroll:TDataSetNotifyEvent

Evento disparando antes que o ponteiro de registro mude a posição.

— OnCalcFields:TDataSetNotifyEvent

Evento disparando quando é necessário o cálculo de campos calculados.

— OnDeleteError:TDataSetErrorEvent

Evento disparando quando ocorre um erro durante a tentativa de apagar o registro corrente.

— OnEditError:TDataSetErrorEvent

Evento disparando quando ocorre um erro durante a edição de um registro.

— OnFilterRecord:TFilterRecordEvent

Evento disparando quando um registro está sendo filtrado.

— OnNewRecord:TDataSetNotifyEvent

Evento disparando quando um novo registro está para ser inserido.

— OnPostError:TDataSetErrorEvent

Evento disparando quando ocorre um erro de gravação.

TDBDataSet

Classe usada para acessar banco de dados. Dessa classe derivam as classes de acesso direto ao dados de um banco. Ela não apresenta nada além da implementação de métodos virtuais para tratamento de informação de banco de dados. Descendente de TDataSet. Devemos notar que a WOLGUI não faz ligação de objetos visuais com banco de dados. Esses casos são feitos manualmente pelo programador. Arquivo fonte:WOLDBK01.PP.

TFieldDefs

Classe de objetos que guardam em si um conjunto de definições de campos associados a uma tabela. Esse conjunto é usado pelo TDataSet para averiguar qual campo está sendo exigido e como ele deve se comportar. Arquivo fonte: WOLDBK01.PP.

Propriedades do TFieldDefs

Propriedade	Descrição
Count	Propriedade que retorna a quantidade de definições da lista.
Items[Index:Integer]	Propriedade que retorna o item da lista especificado pelo índice.

Métodos e Eventos Públicos

— constructor Create(DataSet: TDataSet);

Método usado para criar o objeto.

— destructor Destroy; override;

Método usado para destruir o objeto.

— procedure Add(const Name: string; DataType: TFieldType; Size: Word; Required: Boolean);

Método usado para adicionar um campo à lista.

— procedure Assign(FieldDefs: TFieldDefs);

Método usado para copiar o conjunto de campos de um objeto para outro.

— procedure Clear;

Método usado para limpar a lista de campos do objeto.

— function Find(const Name: string): TFieldDef;

Método usado para procurar o objeto de definição de campo pelo nome do campo.

— function IndexOf(const Name: string): Integer;

Método usado para recuperar o índice de um campo pelo seu nome.

— procedure Update;

Método usado para atualizar o objeto.

TFieldDef

Classe de objetos que carrega informações sobre um campo de uma tabela individualmente. O conjunto de objetos dessa classe, relativos a uma só tabela, forma um objeto da classe anterior. Arquivo fonte: WOLDBK01.PP.

Propriedades do TFieldDef

Propriedade	Descrição
DataType	Propriedade que representa o tipo de dado que o campo suporta. É do tipo TFieldType.
FieldClass	Propriedade que retorna a classe do campo que o objeto representa. É do tipo TFieldClass.
FieldNo	Propriedade que retorna o número associado ao campo.
InternalCalcField	Propriedade que indica se o campo deve ser calculado ou não.
Name	Propriedade que carrega o nome do campo.
Precision	Propriedade que indica a precisão do campo no caso dele ser numérico.
Required	Propriedade que indica se o campo é obrigatório ou não.
Size	Propriedade que indica o tamanho da informação do campo.

Métodos e Eventos Públicos

— constructor Create(Owner:TFieldDefs; const Name:String; DataType:TFieldType; Size:Word; Required:Boolean; FieldNo:Integer);

Método usado para criar o objeto inserindo o mesmo seu proprietário Owner.

— destructor Destroy; override;

Método usado para destruir o objeto.

— function CreateField(Owner:TWOLRoot):TField;

Método usado para criar um campo e retorná-lo.