T - .public class ContainerSelection<T> extends Object implements FilteredView
ContainerSelection modela um componente que permite
escolher entre um conjunto de ítens disponíveis, usando um segundo conjunto
que guarda os ítens escolhidos. O componente oferece botões que permitem
movimentar os ítens entre os conjuntos de disponíveis e escolhidos.ContainerSelectionSample| Modifier and Type | Class and Description |
|---|---|
static class |
ContainerSelection.SortableContainer
Enumeração usada para especificar qual dos containers deve ser ordenável.
|
| Constructor and Description |
|---|
ContainerSelection(ObjectTableProvider formatter)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
boolean hasAddAllButton,
boolean hasRemoveAllButton)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor,
boolean enableSort)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText,
boolean hasAddAllButton,
boolean hasRemoveAllButton)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor,
boolean enableSort)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor,
boolean enableSort,
boolean showButtonsText)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor,
ContainerSelection.SortableContainer sortableContainer,
boolean showButtonsText)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
boolean enabled,
boolean hasRestoreDefaultsButton,
String availableText,
String selectedText,
boolean hasAddAllButton,
boolean hasRemoveAllButton,
int buttonPanelAnchor,
ContainerSelection.SortableContainer sortableContainer,
boolean showButtonsText,
boolean adjustColumnsWidth)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
ContainerSelection(ObjectTableProvider firstFormatter,
ObjectTableProvider secondFormatter,
ContainerSelection.SortableContainer sortableContainer)
Constrói um componente para seleção de elementos que usa dois conjuntos: um
de elementos disponíveis e outro de elementos escolhidos.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addButton(JButton button)
Adiciona um botão ao painel de botões do seletor.
|
void |
addContainerSelectionListener(ContainerSelectionListener l)
Adiciona um listener de modificação do container de seleção.
|
void |
adjustTableColumns()
Ajusta a largura de todas as colunas das tabelas de exibição dos elementos
disponíveis e escolhidos, buscando a menor largura que seja suficiente para
exibição do conteúdo.
|
void |
clear()
Limpa os ítens selecionados e os disponíveis.
|
void |
clearAvailableItems()
Limpa a lista de ítens disponíveis.
|
void |
clearSelectedItems()
Limpa a lista de ítens selecionados.
|
void |
filter(String toFilter)
Trata o filtro: obtém a string digitada pelo usuário no campo de texto do
painel de filtro e repassa pro itemContainer de valores disponíveis
|
protected void |
fireContainerSelectionEvent()
Dispara um evento de modificação do container de seleção.
|
ItemContainer<T> |
getAvailableContainer()
Obtém o container dos itens disponíveis.
|
List<T> |
getAvailableItems()
Obtém uma lista não-modificável dos elementos disponíveis.
|
T |
getFirstAvailableItem()
Obtém o primeiro item disponivel.
|
T |
getFirstSelectedItem()
Obtém o primeiro item selecionado.
|
JPanel |
getPanel()
Devolve o painel que modela esse componente de seleção.
|
ItemContainer<T> |
getSelectedContainer()
Obtém o container dos itens selecionados.
|
List<T> |
getSelectedItems()
Obtém uma lista não-modificável dos elementos selecionados.
|
boolean |
hasAvailableItems()
Verifica se existem ítens disponíveis.
|
boolean |
hasItems()
Verifica se existem elementos no container.
|
boolean |
hasSelectedItems()
Verifica se existem ítens selecionados.
|
protected void |
loadAvailableItems(Collection<T> elements)
Preenche o conjunto dos elementos disponíveis para seleção.
|
void |
loadItems(Collection<T> availableItems)
Carrega os ítens disponíveis e se houver ítens selecionados, os remove.
|
void |
loadItems(Collection<T> availableItems,
Collection<T> selectedItems)
Carrega os ítens no container.
|
void |
loadItems(Collection<T> availableItems,
Collection<T> selectedItems,
Collection<T> defaultSelectedItems)
Carrega os ítens no container e recebe os ítens que ficarão selecionados
quando se optar por restaura o estado padrão.
|
protected void |
moveAllRows(ItemContainer<T> source,
ItemContainer<T> target)
Transfere todos os elementos de um conjunto para o outro.
|
protected void |
moveRows(ItemContainer<T> source,
ItemContainer<T> target)
Transfere os elementos selecionados de um conjunto para outro.
|
void |
removeContainerSelectionListener(ContainerSelectionListener l)
Remove um listener de modificação do container de seleção.
|
void |
reset()
Restaura os itens dos componentes para o seu estado inicial.
|
void |
restoreDefaults()
Recarrega lista padrão de seleção.
|
void |
setEnabled(boolean enabled)
Habilita os componentes da interface.
|
void |
setShowFilter(boolean showFilter)
Atribui o valor para mostrar ou não o filtro de campo de texto para o
container de itens disponíveis
|
void |
setToolTipEnabled(boolean enabled)
Habilita/desabilita tooltip
|
public ContainerSelection(ObjectTableProvider formatter)
formatter - O formatador responsável pela formatação do conjunto de
elementos disponíveis e do conjunto de elementos escolhidos.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, boolean hasAddAllButton, boolean hasRemoveAllButton)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de butões ficará localizado,
SwingConstants: NORTH, SOUTH, CENTERpublic ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor, boolean enableSort)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de butões ficará localizado,
SwingConstants: NORTH, SOUTH, CENTERenableSort - indica se o container deverá se ordenar ou nãopublic ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText, boolean hasAddAllButton, boolean hasRemoveAllButton)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de Botões deve ficar. Os
valores podem ser: SwingConstants. NORTH, SOUTH, CENTERpublic ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor, boolean enableSort)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de Botões deve ficar. Os
valores podem ser: SwingConstants. NORTH, SOUTH, CENTERenableSort - indica de a ordenação do container está habilitada ou naopublic ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, ContainerSelection.SortableContainer sortableContainer)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.sortableContainer - indica qual dos containers deve ser ordenávelpublic ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor, ContainerSelection.SortableContainer sortableContainer, boolean showButtonsText)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de Botões deve ficar. Os
valores podem ser: SwingConstants. NORTH, SOUTH, CENTERsortableContainer - indica qual dos containers deve ser ordenávelshowButtonsText - indica se o texto dos botões deve ser exibidopublic ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor, ContainerSelection.SortableContainer sortableContainer, boolean showButtonsText, boolean adjustColumnsWidth)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de Botões deve ficar. Os
valores podem ser: SwingConstants. NORTH, SOUTH, CENTERsortableContainer - indica qual dos containers deve ser ordenávelshowButtonsText - indica se o texto dos botões deve ser exibidoadjustColumnsWidth - - Flag que indica se a tabela deve ser ajustada
para ocupar, pelo menos, o tamanho mínimo para que não seja
necessário redimensionar suas colunas para que seja possível ler
todo o conteúdo destas.public ContainerSelection(ObjectTableProvider firstFormatter, ObjectTableProvider secondFormatter, boolean enabled, boolean hasRestoreDefaultsButton, String availableText, String selectedText, boolean hasAddAllButton, boolean hasRemoveAllButton, int buttonPanelAnchor, boolean enableSort, boolean showButtonsText)
firstFormatter - O formatador responsável pela formatação do conjunto
de elementos disponíveis.secondFormatter - O formatador responsável pela formatação do conjunto
de elementos escolhidos.enabled - Indica se os containers estão habilitados ou não.hasRestoreDefaultsButton - Indica se o botão restaurar será usado.availableText - título para a tabela de elementos disponíveis.selectedText - título para a tabela de elementos escolhidos.hasAddAllButton - Indica se o botão de adcionar todos será usado.hasRemoveAllButton - Indica se o botão de adcionar todos será usado.buttonPanelAnchor - Posição onde o painel de Botões deve ficar. Os
valores podem ser: SwingConstants. NORTH, SOUTH, CENTERenableSort - indica se ambos os containers devem ser ordenáveisshowButtonsText - indica se o texto dos botões deve ser exibidoprotected void fireContainerSelectionEvent()
public void addContainerSelectionListener(ContainerSelectionListener l)
l - O listener de alteração do conteúdo do container de seleção.public void removeContainerSelectionListener(ContainerSelectionListener l)
l - O listener de alteração do conteúdo do container de seleção.public void clear()
public void clearAvailableItems()
public ItemContainer<T> getAvailableContainer()
public List<T> getAvailableItems()
Collections.unmodifiableList(List)public T getFirstAvailableItem()
null se não existirem
itens.public boolean hasAvailableItems()
protected void loadAvailableItems(Collection<T> elements)
elements - Uma coleção com os elementos passíveis de seleção.public void clearSelectedItems()
public T getFirstSelectedItem()
null se não existirem
itens.public ItemContainer<T> getSelectedContainer()
public List<T> getSelectedItems()
Collections.unmodifiableList(List)public boolean hasSelectedItems()
public JPanel getPanel()
public boolean hasItems()
true se existem ou false caso contrário.public void loadItems(Collection<T> availableItems, Collection<T> selectedItems)
Carrega os ítens no container.
Se o mesmo ítem estiver na lista de selecionados e na lista de disponíveis, ele aparecerá apenas na lista de selecionados. Desta forma, os ítens disponíveis podem ser todos os ítens utilizados.
availableItems - Os ítens disponíveis.selectedItems - Os ítens selecionados.public void loadItems(Collection<T> availableItems, Collection<T> selectedItems, Collection<T> defaultSelectedItems)
Carrega os ítens no container e recebe os ítens que ficarão selecionados quando se optar por restaura o estado padrão. O botão recuperar ficará desabilitado se ele estiver visível e a lista padrão de itens selecionados for nula.
Se o mesmo ítem estiver na lista de selecionados e na lista de disponíveis, ele aparecerá apenas na lista de selecionados. Desta forma, os ítens disponíveis podem ser todos os ítens utilizados.
availableItems - Os ítens disponíveis.selectedItems - Os ítens selecionados.defaultSelectedItems - Os ítens selecionados pelo botão restaurar.public void loadItems(Collection<T> availableItems)
availableItems - ítens disponíveis.public void setEnabled(boolean enabled)
enabled - true para habilitar.protected void moveAllRows(ItemContainer<T> source, ItemContainer<T> target)
source - O conjunto de origem.target - O conjunto destino.protected void moveRows(ItemContainer<T> source, ItemContainer<T> target)
source - O conjunto de origem.target - O conjunto destino.public void restoreDefaults()
public void reset()
public void adjustTableColumns()
public final void setToolTipEnabled(boolean enabled)
enabled - public void addButton(JButton button)
button não pode ser null.button - o botão a ser adicionado ao seletor.public void setShowFilter(boolean showFilter)
showFilter - public void filter(String toFilter)
filter in interface FilteredViewCopyright © 2017 Tecgraf/PUC-Rio. All rights reserved.