BISListAndManagerWindow - Histórico de revisão

Rodrigogml: /* Botões */

2015-05-19T18:12:42Z

Botões

← Edição anterior		Edição das 18h12min de 19 de maio de 2015
Linha 84:		Linha 84:

	O container retornado é o mesmo atualmente na tabela, bastando uma atualização nos dados do container para que a tabela se atualize automaticamente.		O container retornado é o mesmo atualmente na tabela, bastando uma atualização nos dados do container para que a tabela se atualize automaticamente.

			=== Botão de Relatório ===

			Por padrão este botão também fica oculto, e só aparece a partir do momento em que botões de relatórios são adicionados através do método:
			<pre>addReportButton(String, ClickListener)</pre>

			Cada botão de relatório adicionado é agrupado em um único botão, similar a imagem abaixo.
			[[Image:BISListAndManagerWindow_ReportButton.png\|frame\|Botão 'Relatório'\|center\|link=]]


			=== Botão de Mais Ações ===

			Quando a tela tem muitas funções, o espaço destinado à botões pode ser pouco. Neste caso convêm agrupar a funções menos utilizadas para otimizar o espaço. A maneira padrão de agrupar os comandos é utilizando o botão "Mais Ações", como mostrado na imagem abaixo.

			[[Image:BISListAndManagerWindow_MoreActionButton.png\|frame\|Botão 'Mais Ações'\|center\|link=]]

			O botão mais ações aparece automaticamente a partir do momento que algum botão seja adicionado utilizando o método:
			<pre>addMoreActionsButton(String, ClickListener)</pre>


			{{nota\|Personalização dos Botões de Relatório e Mais Ações\|Os métodos de adicionar botões de Relatório e Mais Ações são "auto suficientes", isto é, eles criam os botões com a característica padrão de cada um. No entanto o objeto criado é retornado no método. O objeto retornado pode ter suas características alteradas, como ícones, aparência, StyelSheet, etc.

			Personalizar o botão pode ser útil para ajudar a identifica-lo mais fácil, principalmente com a aplicação de ícone adequado. No entanto não esqueça de verificar o tópico de [[Padrão Visual]] e de utilizar um bom senso.}}


			=== Botões Personalizados ===
			Os botões "Personalizados" são botões adicionados à tela para realizar funções específicas da tela que podem serão utilizadas com grande frequência. Neste caso convêm um botão visível o tempo todo ao invés de um botão agrupado no "Mais Ações". Para adicionar um botão temos dois métodos:
			<pre>addButtonToListPanelButtonBar(BISButton);</pre>
			Este método adiciona o botão no fim da fila (à direita do botão Excluir). '''Este método não deve ser usado para botões personalizados.''' A direita devem continuar aparecendo os botões Excluir, inserir, etc. para que se torne padrão em todas as telas. Os novos botões devem ser colocados a esquerda. Para isso utilize o método:
			<pre>addButtonToListPanelButtonBar(BISButton, int);</pre>
			Este método permite que um botão seja colocado na ordem desejada, sendo o índice 0 o botão mais a esquerda. Assim, para adicionar novos botões sempre utilize este método passando o índice "0" como argumento. Para organizar a ordem dos botões personalizados apenas organize a ordem com que eles são incluídos.

			[[Image:BISListAndManagerWindow_PersonalizedButton.png\|frame\|Botões Personalizados\|center\|link=]]

	== Layout da Tela ==		== Layout da Tela ==

Rodrigogml: /* Botões */

2015-05-19T17:41:23Z

Botões

@@ Linha 5: / Linha 5: @@
 [[Image:BISListWindow1.png|frame|Padrão Visual da BISListAndManaderWindow - Listagem|link=|center]]
 [[Image:BISListAndManagerWindow1.png|frame|Padrão Visual da BISListAndManagerWindow - Gerenciamento do Objeto|link=|center]]
 == Botões ==
@@ Linha 54: / Linha 72: @@
 * '''ClickEvent:''' Evento do click no botão. Usado apenas na confirmação da tela de gerenciamento da entidade. '''Este atributo é nulo na confirmação da exclusão da entidade.'''
 * '''MANAGERMODE:''' Enum que identifica o que está sendo confirmado, se foi DELETE, uma INSERT, uma EDIT ou uma DUPLICATE.
 === Procurar ===
@@ Linha 64: / Linha 84: @@
 O container retornado é o mesmo atualmente na tabela, bastando uma atualização nos dados do container para que a tabela se atualize automaticamente.

Rodrigogml: Criou página com 'A BISListAndManagerWindows é uma classe de janela pai que facilita a vida do desenvolvedor quando este deseja criar uma tela de gerenciamento de um objeto. Entendendo-se por...'

2015-05-19T16:22:12Z

Criou página com 'A BISListAndManagerWindows é uma classe de janela pai que facilita a vida do desenvolvedor quando este deseja criar uma tela de gerenciamento de um objeto. Entendendo-se por...'

Página nova

A BISListAndManagerWindows é uma classe de janela pai que facilita a vida do desenvolvedor quando este deseja criar uma tela de gerenciamento de um objeto. Entendendo-se por gerenciamento as funções de inserir, alterar e excluir um objeto.

Esta classe, assim como a BISWindow e BISListWindow é abstrata e tem alguns métodos de implementação obrigatória. Os métodos solicitam "blocos" da tela, ou a ação a ser realizada durante o clique de algum componente da tela. A BISListAndManagerWindow já implementa alguns dos métodos das classes pai, no entanto exige a implementação de outros pertinentes a sua especificação.

[[Image:BISListWindow1.png|frame|Padrão Visual da BISListAndManaderWindow - Listagem|link=|center]]
[[Image:BISListAndManagerWindow1.png|frame|Padrão Visual da BISListAndManagerWindow - Gerenciamento do Objeto|link=|center]]

== Botões ==

Os botões principais para as funções que esta janela se dispõe já são criados e colocados na mesma ordem automaticamente. Evitando que o desenvolvedor tenha que lembrar de suas configurações, captions, cores, padrões, etc. Além de centralizar o mesmo trecho de código em um único lugar.

=== Inserir e Alterar ===
Os botões de Inserir, Alterar já são criados e posicionados automaticamente. Quando o usuário clicar no botão o evento é automaticamente repassado para o método abstrato correspondente.

Os métodos de recepção dos eventos do clique nos botões de inserir e alterar são respectivamente:
<pre>clickedEventButtonInsert(...);
clickedEventButtonEdit(...);</pre>

'''O botão de inserir nunca é desabilitado automaticamente.'''
'''O botão de alterar é automaticamente desabilitado caso nenhum ou mais do que 1 item esteja(m) selecionado(s) na tabela.'''

=== Excluir ===

O botão de excluir também é posicionado automaticamente na janela, no entanto ele tem um funcionamento um pouco diferenciado em relação ao Inserir e Alterar. Como o botão excluir não costuma ter uma tela específica além da mensagem de confirmação da exclusão, ao clicar no botão excluir o método abaixo é chamado:
<pre>getDeleteConfirmationMessage()</pre>

{{nota|Mensagem Padrão|O método de mensagem de confirmação de exclusão não é abstrato. Ele já tem uma implementação padrão com uma mensagem genérica. Para personalizar a mensagem basta sobrescrever o método e retornar a mensagem desejada.}}

Este método deve retornar a mensagem que será exibida na dialog de confirmação de exclusão da entidade. Caso o usuário cancele nada mais acontece além da dialog ser fechada. Caso o usuário confirme o método de confirmação é chamado (veja sobre o método de confirmação mais abaixo).

Caso a função de excluir não seja desejada o botão pode ser omitido definindo-se "false" no método:
<pre>setDeletefeatureenabled(boolean)</pre>

'''Este botão é automaticamente desabilitado caso nenhum item esteja selecionado na tabela.'''

=== Duplicar ===

A função do botão duplicar não é comum em todas as telas, tem a finalidade de "facilitar" a inserção de um objeto que seja muito semelhante a outro já existente na base de dados. Esta função praticamente lê o objeto selecionado como base como se fosse para uma alteração, apaga os IDs do objeto atual e outros campos de acordo com os requisitos e exibimos na tela. Ao confirmar o objeto será passado para o método de Insert do CRUD, afinal é um objeto novo para ser persistido. Deste modo permitimos que o usuário consiga fazer cadastros mais rápidos quando as entidades a serem criadas são muito parecidas.

O botão de duplicar também é gerado automaticamente, mas por padrão ele fica "oculto". Ele só é exibido se for configurado para isso. Para determinar se o botão de Duplicar será exibido ou não chame o método:
<pre>setDuplicatefeatureenabled(boolean)</pre>
Ao definir como "true", o botão será exibido na tela ao lado dos demais.

'''Este botão é automaticamente desabilitado caso nenhum ou mais do que 1 item esteja(m) selecionado(s) na tabela.'''

=== Confirmar e Cancelar ===

Botões de confirmar e cancelar são exibidor em dois momentos: Dialog de Confirmação de Exclusão e na tela de gerenciamento do objeto. Ao clicar em confirmar em qualquer um dos momentos citados o método abstrato:
<pre>clickEventButtonConfirm(CliekEvent, MANAGERMODE);</pre>
é chamado para que a classe filha gerencie a confirmação do evento. O método tem dois parametros:
* '''ClickEvent:''' Evento do click no botão. Usado apenas na confirmação da tela de gerenciamento da entidade. '''Este atributo é nulo na confirmação da exclusão da entidade.'''
* '''MANAGERMODE:''' Enum que identifica o que está sendo confirmado, se foi DELETE, uma INSERT, uma EDIT ou uma DUPLICATE.

=== Procurar ===

O botão de procurar é o botão "Default" da tela de listagem. Este botão, quando clicado, chama o método:
<pre>clickEventButtonSearch(ClickEvent);</pre>

Este método deve ser responsável por verificar os campos de filtro e atualizar o container da tabela de listagem. Como a Tabela é criada automaticamente, o container da tabela pode ser recuperado através do método:
<pre>getContainerdatasource();</pre>

O container retornado é o mesmo atualmente na tabela, bastando uma atualização nos dados do container para que a tabela se atualize automaticamente.