Esta seção contém uma demonstração do que pode ser feito com os widgets fornecidos pela biblioteca GNOME-DB. Uma curta explanação sobre a funcionalidade básica de cada widget é apresentada.
O widget GnomeDbLogin provê uma maneira customizada e visual para sua aplicação se conectar ao provedor GDA. Este widget pode ser adicionado a qualquer container, de tal maneira que você pode, por exemplo, criar uma caixa de diálogo com um GnomeDbLogin.
Ao inicializar-se, este widget lê a configuração atual da sua instalação do GDA e lhe apresenta um lista contendo todas as fontes de dados configurados pelo usuário. O usuário apenas tem que selecionar a fonte de dados que deseja e entrar com seu nome e senha. Há também uma lista das fontes de dados acessadas mais recentemente, para que você possa facilmente conectar a seu banco de dados padrão ou favorito.
Este é um widget que existe por mera conveniência para o programador. Este é uma sub-classe do GnomeDialog, então você pode esperar a mesma aparência e funcionamento do resto de sua aplicação.
Este widget não apenas contém um widget GnomeDbLogin, mas também captura os sinais enviados ao GnomeDbLogin. Isto significa que você deve conectar manipuladores de sinais ao GnomeDbLoginDlg ao invés do GnomeDbLogin.
O widget GnomeDbDsnConfig provê uma maneira de permitir que o usuário manipula visualmente as fontes de dados GDA. Este widget pode facilmente ser inserido na caixa de diálogo de configurações da sua aplicação, por exemplo, e assim fornecer uma interface gráfica aos arquivos de configuração GDA.
Este widget encapsula visualmente as funções GdaDsn.
Este é um widget super completo que permite navegar pelo banco de dados, examinando tabelas, views e até mesmo stored procedures. A maneira mais simples de usar este widget é criar um container e adicionar uma GnomeDbBrownser a ele. Ao fazer isso, você adiciona um navegador de banco de dados poderoso a sua aplicação.
Este é o mais requisistado dentre os widgets, tendo como abilidade exibir o conteúdo de um GdaRecordset. O acesso ao banco de dados é de responsabilidade do widget. Você só tem que passar conjuntos de resultados válidos para serem então exibidos.
Os dados são carregadas asincronicamente, então seu programa permite que seu usuário continue usando outras parter do seu programa. Depois que o último registro do resultado for obtido, o GnomeDbGrid emite o sinal "loaded".
O GnomeDbDataset permitir navegar por registros de um-por-um.
Este é um widget bastante útil. É principalmente usado em telas de entrada de dados, dando ao usuário a opção de escolher uma opção a partir de uma lsita de valores.
Este funciona semelhantemente ao GnomeDbrid, uma vez que seu funcionamento é baseado no GdaRecordset que você passa como parâmetro, mas neste caso, é necessário especificar qual coluna deve ser usada para obter os valores que vão para a lista.
O widget GnomeDbList permite que você exiba uma lista de valores para um determinado campo em um resultado. Ele também permite que você decore sua lista com ícones, resultando em um super visual para seu programa.
O widget GnomeDbReport permite que você apresente dados ao usuário através de relatórios customizáveis baseados em dados vindo de uma GdaConnection. Para isso ele usa o gerador de relatórios da libgda.
A estrutura do relatório é armazenada em formato XML, o que torna possível compartilhar dados com outras aplicações. Este widget apenas lê este arquivo XML, lê os dados de um dado banco de dados e apresenta o resultado ao usuário.
O GnomeDbIconList funciona como o GnomeDbList e o GnomeDbCombo. A diferença é que os valores presentes em um determinado campo são exibidos como ícones. Isto lhe oferece uma outra maneira de exibir dados aos usuários.
O widget GnomeDbError apresenta uma interface para navegar pelas mensagens de erro ocorridas em um dado objeto GdaConnection. Você pode usá-lo para informar o usuário sempre que um erro ocorrer, ou deixá-lo disponível caso o usuário queira saber sobre erros ocorridos.
Assim como o GnomeDbLoginDlg, o GnomeDbErrorDlg é apenas mais um widget criado para sua conveniência. Ele é uma sub-classe do GnomeDialog e contém apenas um widget GnomeDbError.