Tarefa Orientada 5 Aplic. Manutenção de Facturas de Clientes

Transcrição

1 Tarefa Orientada 5 Aplic. Manutenção de Facturas de Clientes Objectivos: Aplicação Manutenção de Facturas de Clientes Utilização de uma fonte de dados. Formulários Master/Detail. Adicionar consultas a um Table Adapter. Alterar consultas de um Table Adapter Eliminar colunas de um controlo DataGridView. Obter o último valor gerado para uma coluna IDENTITY. Alterar um controlo ToolStrip. Aplicação Manutenção de Facturas de Clientes Neste projecto, vamos implementar uma aplicação de base de dados para gerir as facturas dos clientes de uma pequena editora. Quando a aplicação é iniciada é mostrado o formulário frmfacturasclientes. Neste formulário o utilizador pode procurar um cliente pelo seu identificador ou pelo seu nome, através da barra de ferramentas. Se o utilizador introduzir parte do nome, ou o nome completo, e pressionar o botão procurar correspondente (à direita da caixa de texto onde foi introduzido o nome a pesquisar), é mostrado o formulário frmseleccionarcliente. Este formulário mostra, numa grelha, todos os clientes cujo nome estão de acordo com o padrão de pesquisa utilizado no formulário frmfacturasclientes para procurar clientes. Visual Studio

2 Depois, o utilizador pode efectuar um duplo toque sobre um registo da grelha para seleccionar um cliente ou, alternativamente, pode seleccionar o registo e, depois pressionar o botão Seleccionar. Em ambos os casos, o controlo vai ser devolvido ao formulário frmfacturasclientes e a informação relativa ao cliente é também mostrada. Após ter sido seleccionado um cliente, o utilizador pode pressionar o botão Alterar Cliente para mostrar o formulário frmmanutençãoclientes. Este formulário é utilizado quer para alterar os dados de um cliente já existente, quer para introduzir dados de um novo cliente. O título do formulário muda de acordo com a situação. Após o utilizador ter efectuado as alterações ou ter introduzido os dados de um novo cliente, pode pressionar os botões Aceitar ou Cancelar para gravar ou cancelar as respectivas operações e para voltar ao formulário frmfacturasclientes. O utilizador pode também adicionar um novo cliente pressionando o botão Adicionar Cliente. Como resultado, é mostrado o formulário frmmanutençãoclientes, com o título Adicionar Cliente. Depois, o utilizador pode introduzir os dados relativos ao novo cliente e pode pressionar os botões Aceitar ou Cancelar para gravar ou cancelar, respectivamente e para voltar ao formulário frmfacturasclientes. Para eliminar um cliente, o utilizador pode pressionar o botão Eliminar Cliente do formulário frmmanutençãoclientes. É mostrada uma caixa de diálogo para confirmar, ou não, a eliminação. Se a operação for confirmada, é removido o cliente correspondente, assim como as respectivas facturas e itens de factura. O formulário frmmanutençãoclientes também contém uma grelha onde são mostradas as facturas do cliente seleccionado. O utilizador pode esta grelha para rever as facturas, para mostrar os itens de cada factura, ou para eliminar uma factura. Visual Studio

3 Para visualizar os itens de uma factura, o utilizador pode pressionar duplamente sobre o registo correspondente na grelha ou, alternativamente, pode seleccionar o registo e, depois pressionar o botão Ver Itens Factura. Em ambos os casos, vai ser mostrado o formulário frmitensfactura e a informação relativa à factura é também mostrada. Para eliminar uma factura, o utilizador pode seleccionar, na grelha, o registo relativo à factura e, depois pode pressionar o botão Eliminar Factura. Depois é solicitada a confirmação de remoção. Caso seja confirmada, a factura é eliminada, bem como todos os seus itens. O utilizador pode também adicionar uma factura para o cliente seleccionado. Para tal, deve pressionar o botão Adicionar Factura. Como resultado, é mostrado o formulário frmadicionarfactura. Neste formulário, o utilizador selecciona um produto na caixa de combinação correspondente, introduz a quantidade na caixa de texto correspondente, e pressiona o botão Adicionar. Como resultado, é acrescentado um item (registo) à grelha deste formulário e são calculados, e mostrados, os totais para a factura. O utilizador também pode eliminar um item desta grelha. Para tal, deve pressionar o botão Eliminar que se encontra à sua direita. Após ter adicionado todos os itens a uma factura, o utilizador pode pressionar o botão Guardar Factura, de modo a que a factura e os seus itens sejam armazenados na base de dados e seja, novamente, mostrado o formulário frmfacturasclientes. O utilizador pode também pressionar o botão Cancelar para voltar ao formulário frmfacturasclientes sem gravar os dados relativos à factura e respectivos itens. Visual Studio

4 Neste projecto, vamos continuar a utilizar o DataSource Configuration Wizard para criar uma fonte de dados. 1 Execute os passos 1 a 5 da tarefa orientada 1, sobre Visual Basic 2005, para criar um novo projecto para uma aplicação Windows. 2 Criação de uma fonte de dados, a partir de uma base de dados no Sql Server, recorrendo ao assistente de configuração. 2.1 Siga os passos 2.1 a 2.12 da tarefa orientada 2 para criar uma fonte de dados. 2.2 Agora escolha os objectos da base de dados para a fonte de dados que vão ser incluídos no DataSet. Expanda o nó associado à caixa de verificação Tables e seleccione as tabelas ClientesED, FacturasED, ItensFacturasED, OpçõesEncomenda, Produtos e Províncias. Visual Studio

5 2.3 Neste passo, pode ainda especificar o nome para o DataSet que vai ser criado. De modo predefinido, este nome é constituído pelo nome da base de dados seguido da palavra DataSet 2.4 Pressione o botão Finish. Terminados os passos do assistente, a nova fonte de dados é mostrada na janela DataSources. Na janela Solution Explorer, é também incluído um ficheiro com o nome que foi atribuído ao DataSet e com a extensão xsd. Este ficheiro contém o esquema para a classe DataSet gerada pelo wizard, isto é, define a estrutura do DataSet. Data Sources Solution Explorer Visual Studio

6 Formulário frmfacturasclientes Neste formulário o utilizador pode procurar um cliente pelo seu identificador ou pelo seu nome, através da barra de ferramentas e pode, entre outras coisas, visualizar as suas facturas. 3 Desenho do formulário frmfacturasclientes. 3.1 Defina as propriedades Name, Text, AutoScaleMode, StartPosition e File Name com os valores frmfacturasclientes, Manutenção de facturas de clientes, Font, CenterScreen e frmfacturasclientes, respectivamente. Depois de ter criado um uma fonte de dados, vamos criar controlos ligados para aceder aos dados. 3.2 Seleccione, na janela Data Sources, a opção Details da caixa de listagem associada à tabela ClientesED. 3.3 Arraste a tabela ClientesED para o formulário. Como resultado, vão ser criados objectos Label e TextBox ligados a cada uma das colunas da tabela. Visual Studio

7 Como resultado do passo anterior, além dos objectos TextBox e Label, criados para cada coluna da tabela, foram também criados os objectos EditoraDataSet, clientesedtableadapter, clientesedsbindingsource e clientesedbindingnavigator. Adicionalmente, o Visual Studio liga as caixas de texto e a caixa de combinação às respectivas colunas da tabela. Adicionalmente, o Visual Studio também gera código, que iremos analisar mais à frente. 3.4 Elimine a barra de navegação criada pelo wizard. 3.5 Para todas as caixas de texto recentemente criadas, defina as propriedades BackColor, ReadOnly e TabStop com os valores Control, True e False, respectivamente. 3.6 Adicione três botões ao formulário. Defina as suas propriedades Name, com os valores btnadicionarcliente, btnalterarcliente e btneliminarcliente e Text, com os valores Adicionar Cliente, Alterar Cliente, Eliminar Cliente, de acordo com a figura seguinte (ver pg. 9). Visual Studio

8 3.7 Para criar uma consulta com parâmetros, seleccione uma qualquer caixa de texto do formulário que esteja ligada ao data source. Aceda ao seu menu smart tag e escolha a opção Add query. Vai surgir a caixa de diálogo Search Criteria Builder. 3.8 Atribua o nome FillByIDCliente à nova consulta que está a criar. Visual Studio

9 3.9 Na secção Query Text, introduza o código SQL necessário para que fique de acordo com a figura acima ilustrada. Esta consulta vai ser utilizada para obter os clientes que vão ser mostrados neste formulário e no formulário frmmanutençãoclientes Pressione o botão OK. Como resultado, o Visual Studio vai acrescentar, ao formulário, uma barra de ferramentas com uma caixa de texto e um botão para que o utilizador possa introduzir um valor para o parâmetro e depois possa executar a consulta. Note que, adicionalmente, o Visual Studio também gerou código, que iremos analisar mais à frente. Vamos ainda adicionar mais duas consultas ao Table Adapter ClientesEDTableAdapter Seleccione, no DataSet Designer, o Table Adapter ClientesEDTableAdapter com o botão direito do rato. Depois, seleccione o comando Add Query. Visual Studio

10 Utilize o Table Adapter Query Configuration Wizard para criar a consulta No primeiro passo do wizard, seleccione a opção Use SQL statements Pressione o botão Next. Visual Studio

11 3.14 No segundo passo do wizard, seleccione a opção SELECT which returns rows Pressione o botão Next No terceiro passo do wizard, introduza o código SQL necessário para que fique de acordo com a figura abaixo ilustrada. Esta consulta vai ser utilizada para obter os clientes que vão ser mostrados no formulário frmseleccionarcliente. Note que é usado o operador LIKE na cláusula WHERE, de modo a que seja possível utilizar meta caracteres para representar padrões alfanuméricos. Por exemplo, se o utilizador especificar, na barra de ferramentas para introdução de parâmetros, a cadeia de caracteres Ped% para o irão ser devolvidos os registos dos clientes cujo nome se inicia com as letras Ped. Visual Studio

12 3.17 Pressione o botão Next No quarto passo do wizard, mantenha activada a caixa de verificação Fill a DataTable, atribua o valor FillByNome na caixa de texto Method name e desactive a caixa de combinação Return a DataTable Pressione o botão Finish. Visual Studio

13 Note que, ao criar uma consulta com parâmetros deste modo, não vai ser acrescentada ao formulário uma nova barra de ferramentas para introdução de parâmetros. Vamos agora alterar o aspecto da barra de ferramentas criada no passo 3.10, de modo a que tenha a seguinte apresentação Aceda ao menu smart tag da barra de ferramentas criada no passo 3.10 e seleccione o comando Edit Items. Como resultado, vai ser mostrada a caixa de diálogo Items Collection Editor Na secção Members, Seleccione o botão com o nome FillByIDClienteToolStripButton e, na janela de propriedades do lado Visual Studio

14 direito da caixa de diálogo, defina as propriedades Text e DisplayStyle com os valores Procurar e Text, respectivamente Para adicionar um separador à barra de ferramentas, escolha a opção Separator, na caixa de combinação Select item and add to list below. Depois, pressione o botão Add localizado à direita da caixa de combinação De modo análogo ao anterior, adicione uma legenda (label) à barra de ferramentas. Visual Studio

15 3.24 Na secção Members, Seleccione a legenda acabada de criar e, na janela de propriedades do lado direito da caixa de diálogo, defina as propriedades Name, Text e DisplayStyle com os valores NomeToolStripLabel, Nome e Text, respectivamente Adicione uma caixa de texto (TextBox) à barra de ferramentas e defina a sua propriedade Name com o valor NomeToolStripTextBox Adicione um botão (Button) à barra de ferramentas e defina as suas propriedades Name, Text e DisplayStyle com os valores FillByNomeToolStripButton, Procurar e Text, respectivamente Pressione o botão OK a caixa de diálogo Items Collection Editor. A barra de ferramentas do formulário passa a ter o seguinte aspecto. Para adicionar um controlo DataGridView que mostre os dados de uma tabela relacionada com a tabela principal de um formulário, basta arrastar, da janela Data Source, a tabela subordinada para o formulário. Como resultado, o Visual Studio, além de adicionar a grelha ao formulário, também gera os objectos BindingSource e TableAdapter. Adicionalmente, o Visual Studio também gera código, que analisaremos mais à frente, e define as propriedades (DataSource e DataMember) do objecto BindingSource, de modo a que sejam visualizados os dados da tabela relacionada Na janela Data Sources, expanda a caixa de verificação relativa à tabela ClientesED e arraste a tabela subordinada FacturasED para a parte inferior do formulário frmfacturasclientes. Visual Studio

16 Como resultado do passo anterior, além do objecto DataGridView, foram também criados os objectos FacturasEDTableAdapter e FacturasEDsBindingSource. Visual Studio

17 3.29 Adicione três botões ao formulário. Defina as suas propriedades Name, com os valores btnitensfactura, btneliminarfactura e btnadicionarfactura e Text, com os valores Ver Itens da Factura, Eliminar Factura, Adicionar Factura, de acordo com a figura anterior De modo a tornar a grelha apenas disponível para visualização de dados, aceda ao menu smart tag do comando FacturasEDDataGridView e desactive as caixas de verificação Enable Adding, Enable Editing e Enable Deleting. Desactive ainda a caixa de verificação Enable Column Reordering. Vamos ainda adicionar mais uma consulta ao Table Adapter ClientesEDTableAdapter para obter o valor do último identificador de cliente (IDCliente) atribuído pelo SQL SERVER. Note que o atributo IDCliente é uma coluna IDENTITY Seleccione, no DataSet Designer, o Table Adapter ClientesEDTableAdapter com o botão direito do rato. Depois, seleccione o comando Add Query. Visual Studio

18 Utilize o Table Adapter Query Configuration Wizard para criar a consulta No primeiro passo do wizard, seleccione a opção Use SQL statements Pressione o botão Next. Visual Studio

19 3.34 No segundo passo do wizard, seleccione a opção SELECT which returns a single value Pressione o botão Next No terceiro passo do wizard, introduza o código SQL necessário para que fique de acordo com a figura abaixo ilustrada. Esta consulta vai ser utilizada para obter o valor do último identificador de cliente (IDCliente) atribuído pelo SQL SERVER. Para tal, é utilizada a função IDENT_CURRENT( Nome_Tabela ). Esta função devolve o último valor gerado para a coluna IDENTITY da tabela especificada no seu argumento. Visual Studio

20 3.37 Pressione o botão Next No quarto passo do wizard atribua o valor ObterÚltimoValorIDENTITY ao nome do método que está a criar. Visual Studio

21 3.39 Pressione o botão Next Pressione o botão Finish. Sempre que desejar alterar uma consulta previamente criada, seleccione-a com o botão direito, no respectivo TableAdapter, e escolha o comando Configure. Visual Studio

22 Formulário frmseleccionarcliente Este formulário mostra, numa grelha, todos os clientes cujo nome estão de acordo com o padrão de pesquisa utilizado no formulário frmfacturasclientes para procurar clientes. 4 Desenho do formulário frmseleccionarcliente. 4.1 Adicione um novo formulário ao projecto. Para tal, seleccione a opção Add Windows Form do menu Project. Aparece a caixa de diálogo Add New Item. 4.2 Na secção Templates da caixa de diálogo Add New Item, seleccione a opção Windows Form. Depois introduza o nome para o formulário e pressione o botão Add. Como pode observar na figura anterior, sugerese que utilize o prefixo frm para o nome de cada formulário criado, de modo a que fique claro que o ficheiro gerado contém um formulário. Introduza o nome frmseleccionarcliente. Visual Studio

23 4.3 Defina as propriedades Text, StartPosition, MaximizeBox, AutoScaleMode e ControlBox do formulário com os valores Seleccionar cliente, CenterScreen, False, Font e False, respectivamente. Vamos agora criar um controlo DataGridView ligado à tabela ClientesED para aceder aos clientes que verificam a condição de pesquisa introduzida no formulário frmfacturasclientes. 4.4 Seleccione, na janela Data Sources, a opção DataGridView da caixa de listagem associada à tabela ClientesED. 4.5 Arraste a tabela ClientesED para o formulário. Como resultado, vai ser criado um objecto DataGridView. Como resultado do passo anterior, além do objecto DataGridView, foram também criados os objectos EditoraDataSet, clientesedtableadapter, clientesedsbindingsource e clientesedbindingnavigator. Adicionalmente, o Visual Studio liga as caixas de texto e a caixa de combinação às respectivas colunas da tabela. 4.6 Elimine a barra de navegação criada pelo wizard. Visual Studio

24 Adicionalmente, o Visual Studio também gera código, que iremos analisar mais à frente. 4.7 Adicione dois botões ao formulário. Defina as suas propriedades Name, com os valores btnseleccionar e btncancelar e Text, com os valores Seleccionar e Cancelar, de acordo com a figura anterior. 4.8 De modo a tornar a grelha apenas disponível para visualização de dados, aceda ao menu smart tag do comando FacturasEDDataGridView e desactive as caixas de verificação Enable Adding, Enable Editing e Enable Deleting. Desactive ainda a caixa de verificação Enable Column Reordering. Visual Studio

25 Formulário frmmanutençãoclientes Este formulário é utilizado quer para alterar os dados de um cliente já existente, quer para introduzir dados de um novo cliente. 5 Desenho do formulário frmmanutençãoclientes. 5.1 Adicione um novo formulário ao projecto. Para tal, seleccione a opção Add Windows Form do menu Project. Como resultado, aparece a caixa de diálogo Add New Item. 5.2 Na secção Templates da caixa de diálogo Add New Item, seleccione a opção Windows Form. Depois introduza o nome para o formulário e pressione o botão Add. Introduza o nome frmmanutençãoclientes. 5.3 Defina as propriedades Text, StartPosition, AutoScaleMode e ControlBox com os valores Manutenção de Clientes, CenterScreen, Font e False. Vamos agora criar controlos TextBox e ComboBox, a partir de uma fonte de dados, recorrendo à janela Data Sources. 5.4 Seleccione, na janela Data Sources, a opção Details da caixa de listagem associada à tabela ClientesED. Deste modo, ao arrastar a tabela ClientesED para o formulário irão ser criados objectos Label e TextBox ligados a cada uma das colunas da tabela. Visual Studio

26 5.5 Seleccione, na janela Data Sources, a opção ComboBox da caixa de listagem associada à coluna Província da tabela ClientesED. Deste modo, ao arrastar a tabela ClientesED para o formulário irá ser criado um controlo ComboBox ligado à coluna Província da tabela ClientesED e irão ser criados objectos Label e TextBox ligados a cada uma das restantes colunas da tabela. 5.6 Arraste a tabela ClientesED da janela Data Sources para o formulário do projecto. Visual Studio

27 Como resultado do passo anterior, além dos objectos Label e TextBox, criados para cada coluna da tabela, foram também criados os objectos EditoraDataSet, clientesedtableadapter, clientesedsbindingsource, clientesedbindingnavigator e ComboBox. Adicionalmente, o Visual Studio liga as caixas de texto e a caixa de combinação às respectivas colunas da tabela. Adicionalmente, o Visual Studio gera também código, que iremos analisar mais à frente. 5.7 Elimine a barra de navegação criada pelo wizard. 5.8 Elimine a legenda IDCliente (IDClienteLabel) e a caixa de texto correspondente (IDClienteTextBox) criadas pelo assistente, pois o atributo IDCliente é uma coluna IDENTITY e, consequentemente, o utilizador não deve aceder aos seus valores. De seguida, vamos ligar o controlo Combobox à tabela Províncias, de modo a que seja possível, ao utilizador, atribuir a província para um cliente, a partir das províncias existentes na tabela Províncias. 5.9 Aceda ao menu smart tag do controlo ProvínciaComboBox. Active a caixa de verificação Use data bound items. Como resultado, vão ser mostradas as propriedades de ligação. Visual Studio

28 5.10 Para especificar o valor da propriedade Data Source, seleccione a tabela Províncias, de acordo com a figura seguinte Para especificar o valor da propriedade Display Member, seleccione o campo Província do controlo ProvínciasBindingSource, de acordo com a figura seguinte Para especificar o valor da propriedade Value Member, seleccione o campo Código do controlo ProvínciasBindingSource, de acordo com a figura seguinte. Visual Studio

29 5.13 Para especificar o valor da propriedade Selected Value, seleccione o campo Província do controlo ClientesEDBindingSource, de acordo com a figura seguinte De modo resumido, os valores para as propriedades Data Source, Display Member, Value Member e Selected Value, devem estar de acordo com a imagem seguinte. Visual Studio

30 5.15 Seleccione a opção DropDownList para a propriedade DropDownStyle do controlo ProvínciaComboBox, de modo a impedir que o utilizador introduza dados nesta caixa de combinação Altere, na secção DataBindings do controlo ProvínciaComboBox, o valor da propriedade Text para none, de modo a que o valor armazenado nesta propriedade seja ligado ao data source Adicione dois botões ao formulário. Defina as suas propriedades Name, com os valores btnaceitar e btncancelar e Text, com os valores Aceitar e Cancelar, de acordo com a figura seguinte Defina a propriedade AcceptButton do formulário com o valor btnaceitar Defina a propriedade Tag dos controlos NomeTextBox, EndereçoTextBox, LocalidadeTextBox, ProvínciaComboBox e CódigoPostalTextBox com os valores Nome, Endereço, Localidade, Província e Código Postal, respectivamente. Visual Studio

31 Formulário frmitensfactura Este formulário permite visualizar os itens de uma factura seleccionada na grelha do formulário frmfacturasclientes. 6 Desenho do formulário frmitensfactura. 6.1 Adicione um novo formulário ao projecto. Para tal, seleccione a opção Add Windows Form do menu Project. Como resultado, aparece a caixa de diálogo Add New Item. 6.2 Na secção Templates da caixa de diálogo Add New Item, seleccione a opção Windows Form. Depois introduza o nome para o formulário e pressione o botão Add. Introduza o nome frmitensfactura. 6.3 Defina as propriedades Text, StartPosition e AutoScaleMode, com os valores Ver Itens Factura, WindowsDefaultLocation e Font. Vamos agora editar o comando SQL gerado, de modo predefinido, pelo assistente para o Table Adapter ItensFacturasED, de modo a que incluía uma operação de junção interna entre as tabelas Produtos e ItensFacturasED. 6.4 Seleccione, no DataSet Designer, a consulta Fill do Table Adapter ItensFacturasED. 6.5 Na janela de propriedades, toque na elipse à direita da propriedade CommandText. Visual Studio

32 Como resultado, é mostrada a caixa de diálogo Query Builder, apresentada a seguir. 6.6 Toque com o lado direito do rato no painel superior do construtor de consultas e seleccione o comando Add Table. Visual Studio

33 6.7 Como resultado, é mostrada a caixa de diálogo Add Table. Seleccione a tabela Produtos e pressione o botão Add. Depois, pressione o botão Close. 6.8 Ainda no painel superior do construtor de consultas, construa a consulta de acordo com a imagem seguinte. Visual Studio

34 6.9 Depois de testar a execução da consulta, através do botão Execute Query, pressione o botão OK. Como resultado, vai surgir uma caixa de diálogo a questionar se deseja regenerar os comandos de UPDATE como base no novo comando SELECT. Por outras palavras, se pretende modificar as instruções INSERT, UPDATE e DELETE, de modo a que estejam de acordo com o novo comando SELECT. Visual Studio

35 6.10 Pressione o botão Não, dado que o Visual Studio não pode gerar instruções de INSERT, UPDATE e DELETE que contenham campos de mais do que uma tabela. Assim, as instruções de INSERT, UPDATE e DELETE vão permanecer inalteradas, de modo a incluírem os atributos da tabela principal Arraste o atributo Factura da tabela ItensFacturasED da janela Data Sources para o formulário do projecto. Como resultado do passo anterior, além dos objectos Label e TextBox, criados para a coluna Factura, são também criados os objectos EditoraDataSet, ItensFacturasEDTableAdapter, ItensFacturasEDBindingSource e ItensFacturasEDBindingNavigator. Adicionalmente, o Visual Studio gera também código, que iremos analisar mais à frente Arraste a tabela ItensFacturasED da janela Data Sources para o formulário do projecto Aceda ao menu smart tag da grelha e seleccione o comando Edit Columns. Como resultado, surge a caixa de diálogo Edit Columns. Visual Studio

36 6.14 Na secção Selected Columns, seleccione a coluna Factura e pressione o botão Remove, de modo a remover esta coluna da grelha Seleccione a coluna Designação e toque no botão para a colocar em segundo lugar da lista, a seguir à coluna Produto Elimine a barra de navegação criada pelo wizard. Neste momento, o formulário deve apresentar o seguinte aspecto. Visual Studio

37 6.17 De modo a tornar a grelha apenas disponível para visualização de dados, aceda ao menu smart tag do comando ItensFacturasEDDataGridView e desactive as caixas de verificação Enable Adding, Enable Editing e Enable Deleting. Desactive ainda a caixa de verificação Enable Column Reordering. Vamos ainda adicionar mais uma consulta ao Table Adapter ItensFacturasEDTableAdapter para obter os itens de uma factura. Esta consulta utiliza o identificador da factura seleccionada na grelha do formulário frmfacturasclientes Seleccione, no DataSet Designer, o Table Adapter ItensFacturasEDTableAdapter com o botão direito do rato. Depois, seleccione o comando Add Query. Visual Studio

38 Utilize o Table Adapter Query Configuration Wizard para criar a consulta No primeiro passo do wizard, seleccione a opção Use SQL statements Pressione o botão Next No segundo passo do wizard, seleccione a opção SELECT which returns rows. Visual Studio

39 6.22 Pressione o botão Next No terceiro passo do wizard, pressione o botão Query Builder para construir a consulta graficamente, de acordo com a figura seguinte. Esta consulta vai ser utilizada para obter os itens das facturas que vão ser mostrados neste formulário. Note que, além da operação de junção interna, é também utilizado um parâmetro. Visual Studio

40 6.24 Na caixa de diálogo Query Builder, pressione o botão OK No terceiro passo do wizard, pressione o botão Next No quarto passo do wizard, mantenha activada a caixa de verificação Fill a DataTable, atribua o valor FillByFactura na caixa de texto Method name e desactive a caixa de combinação Return a DataTable, de acordo com a figura seguinte. Visual Studio

41 Pressione o botão Finish. Visual Studio

42 Formulário frmadicionarfactura Este formulário permite adicionar uma factura, com um ou mais itens, para o cliente seleccionado no formulário frmfacturasclientes. 7 Desenho do formulário frmadicionarfactura. 7.1 Adicione um novo formulário ao projecto. Para tal, seleccione a opção Add Windows Form do menu Project. Como resultado, aparece a caixa de diálogo Add New Item. 7.2 Na secção Templates da caixa de diálogo Add New Item, seleccione a opção Windows Form. Depois introduza o nome para o formulário e pressione o botão Add. Introduza o nome frmadicionarfactura. 7.3 Defina as propriedades Text, StartPosition e AutoScaleMode, com os valores Adicionar Factura, CenterScreen e Font. 7.4 Na janela Data Sources, expanda a caixa de verificação correspondente à tabela ClientesED. Depois, arraste os atributos IDCliente e Nome para o formulário frmadicionarfactura. Como resultado do passo anterior, além dos objectos Label e TextBox, criados para cada coluna, são também criados os objectos EditoraDataSet, ClientesEDTableAdapter, ClientesEDBindingSource e ClientesEDBindingNavigator. Adicionalmente, o Visual Studio gera também código, que iremos analisar mais à frente. 7.5 Para as caixas de texto recentemente criadas, defina as suas propriedades BackColor, ReadOnly e TabStop com os valores Control, True e False, respectivamente. 7.6 Elimine a barra de navegação criada pelo wizard. Visual Studio

43 7.7 Na janela Data Sources, expanda a caixa de verificação correspondente à tabela FacturasED. Depois, arraste o atributo DataFactura para o formulário frmadicionarfactura. Deste modo, irá ser criado um controlo DateTimePicker ligado à coluna DataFactura da tabela FacturasED e irão ser gerados os objectos FacturasEDTableAdapter e FacturasEDBindingSource. 7.8 Defina a propriedade Format do controlo DateTimePicker, recentemente criado, com o valor Short. 7.9 Seleccione, na janela Data Sources, a opção Details da caixa de listagem associada à tabela Produtos. Visual Studio

44 7.10 Seleccione, na janela Data Sources, a opção ComboBox da caixa de listagem associada à coluna Código da tabela Produtos Arraste o atributo Código da tabela Produtos da janela Data Sources para o formulário frmadicionarfactura. Como resultado, são criados os controlos Label, ComboBox, ProdutosTableAdapter e ProdutosBindingSource Aceda ao menu smart tag do controlo CódigoComboBox. Active a caixa de verificação Use data bound items. Como resultado, vão ser mostradas as propriedades de ligação. Visual Studio

45 7.13 Atribuía os valores para as propriedades Data Source, Display Member, Value Member e Selected Value, de acordo com a imagem seguinte Seleccione a opção DropDownList para a propriedade DropDownStyle do controlo CódigoComboBox, de modo a impedir que o utilizador introduza dados nesta caixa de combinação Altere, na secção DataBindings do controlo CódigoComboBox, o valor da propriedade Text para none Defina as propriedades Name e Text do controlo CódigoLabel recentemente criado pelo assistente, com os valores ProdutoLabel e Produto:, respectivamente Adicione um controlo Label e defina as suas propriedades Name e Text com os valores e QuantidadeLabel e Quantidade, respectivamente Adicione um controlo TextBox e defina as suas propriedades Name, Tag e Text com os valores QuantidadeTextBox, Quantidade e 1, respectivamente Adicione um botão ao formulário. Defina as suas propriedades Name e Text com os valores btnadicionaritem e Adicionar Item, respectivamente Arraste a tabela ItensFacturasED da janela Data Sources para o formulário do projecto. Visual Studio