tecgraf.javautils.gui.selector
Class ContainerSelection<T>

java.lang.Object
  tecgraf.javautils.gui.selector.ContainerSelection<T>

Type Parameters:

T - .

public class ContainerSelection<T>
extends Object

A classe 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.

Author:

Julia

See Also:

ContainerSelectionSample

Nested Class Summary

static class

ContainerSelection.SortableContainer Enumeração usada para especificar qual dos containers deve ser ordenável.

Constructor Summary

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.

Method Summary

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.
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	setToolTipEnabled(boolean enabled) Habilita/desabilita tooltip

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ContainerSelection

public 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. Esse componente terá o botão restaurar e estará habilitado para o uso.

Parameters:

formatter - O formatador responsável pela formatação do conjunto de elementos disponíveis e do conjunto de elementos escolhidos.

ContainerSelection

public 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. Esse componente terá o botão restaurar e estará habilitado para o uso.

Parameters:

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.

ContainerSelection

public 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. Esse componente terá o botão restaurar.

Parameters:

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.

ContainerSelection

public 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.

Parameters:

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.

ContainerSelection

public 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.

Parameters:

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.

ContainerSelection

public 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.

Parameters:

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, CENTER

ContainerSelection

public 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.

Parameters:

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, CENTER

enableSort - indica se o container deverá se ordenar ou não

ContainerSelection

public 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.

Parameters:

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.

ContainerSelection

public 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.

Parameters:

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.

ContainerSelection

public 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.

Parameters:

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, CENTER

ContainerSelection

public 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.

Parameters:

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, CENTER

enableSort - indica de a ordenação do container está habilitada ou nao

ContainerSelection

public 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.

Parameters:

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ável

ContainerSelection

public 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.

Parameters:

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, CENTER

sortableContainer - indica qual dos containers deve ser ordenável

showButtonsText - indica se o texto dos botões deve ser exibido

ContainerSelection

public 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.

Parameters:

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, CENTER

sortableContainer - indica qual dos containers deve ser ordenável

showButtonsText - indica se o texto dos botões deve ser exibido

adjustColumnsWidth - - 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.

ContainerSelection

public 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.

Parameters:

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, CENTER

enableSort - indica se ambos os containers devem ser ordenáveis

showButtonsText - indica se o texto dos botões deve ser exibido

Method Detail

fireContainerSelectionEvent

protected void fireContainerSelectionEvent()

Dispara um evento de modificação do container de seleção.

addContainerSelectionListener

public void addContainerSelectionListener(ContainerSelectionListener l)

Adiciona um listener de modificação do container de seleção. Esse listener é notificado sempre que algum elemento é colocado ou removido do container com os elementos selecionados.

Parameters:

l - O listener de alteração do conteúdo do container de seleção.

removeContainerSelectionListener

public void removeContainerSelectionListener(ContainerSelectionListener l)

Remove um listener de modificação do container de seleção. Esse listener é notificado sempre que algum elemento é colocado ou removido do container com os elementos selecionados.

Parameters:

l - O listener de alteração do conteúdo do container de seleção.

clear

public void clear()

Limpa os ítens selecionados e os disponíveis.

clearAvailableItems

public void clearAvailableItems()

Limpa a lista de ítens disponíveis.

getAvailableContainer

public ItemContainer<T> getAvailableContainer()

Obtém o container dos itens disponíveis.

Returns:

ItemContainer O container.

getAvailableItems

public List<T> getAvailableItems()

Obtém uma lista não-modificável dos elementos disponíveis.

Returns:

A lista com os elementos disponíveis.

See Also:

Collections.unmodifiableList(List)

getFirstAvailableItem

public T getFirstAvailableItem()

Obtém o primeiro item disponivel.

Returns:

O primeiro item selecionado ou null se não existirem itens.

hasAvailableItems

public boolean hasAvailableItems()

Verifica se existem ítens disponíveis.

Returns:

true se houver ítens disponíveis.

loadAvailableItems

protected void loadAvailableItems(Collection<T> elements)

Preenche o conjunto dos elementos disponíveis para seleção.

Parameters:

elements - Uma coleção com os elementos passíveis de seleção.

clearSelectedItems

public void clearSelectedItems()

Limpa a lista de ítens selecionados.

getFirstSelectedItem

public T getFirstSelectedItem()

Obtém o primeiro item selecionado.

Returns:

O primeiro item selecionado ou null se não existirem itens.

getSelectedContainer

public ItemContainer<T> getSelectedContainer()

Obtém o container dos itens selecionados.

Returns:

ItemContainer O container.

getSelectedItems

public List<T> getSelectedItems()

Obtém uma lista não-modificável dos elementos selecionados.

Returns:

A lista dos elementos selecionados.

See Also:

Collections.unmodifiableList(List)

hasSelectedItems

public boolean hasSelectedItems()

Verifica se existem ítens selecionados.

Returns:

true se houver ítens selecionados.

getPanel

public JPanel getPanel()

Devolve o painel que modela esse componente de seleção.

Returns:

O painel para ser usado como componente de seleção em uma janela ou diálogo.

hasItems

public boolean hasItems()

Verifica se existem elementos no container.

Returns:

true se existem ou false caso contrário.

loadItems

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.

Parameters:

availableItems - Os ítens disponíveis.

selectedItems - Os ítens selecionados.

loadItems

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.

Parameters:

availableItems - Os ítens disponíveis.

selectedItems - Os ítens selecionados.

defaultSelectedItems - Os ítens selecionados pelo botão restaurar.

loadItems

public void loadItems(Collection<T> availableItems)

Carrega os ítens disponíveis e se houver ítens selecionados, os remove.

Parameters:

availableItems - ítens disponíveis.

setEnabled

public void setEnabled(boolean enabled)

Habilita os componentes da interface.

Parameters:

enabled - true para habilitar.

moveAllRows

protected void moveAllRows(ItemContainer<T> source,
                           ItemContainer<T> target)

Transfere todos os elementos de um conjunto para o outro.

Parameters:

source - O conjunto de origem.

target - O conjunto destino.

moveRows

protected void moveRows(ItemContainer<T> source,
                        ItemContainer<T> target)

Transfere os elementos selecionados de um conjunto para outro.

Parameters:

source - O conjunto de origem.

target - O conjunto destino.

restoreDefaults

public void restoreDefaults()

Recarrega lista padrão de seleção.

reset

public void reset()

Restaura os itens dos componentes para o seu estado inicial.

adjustTableColumns

public 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.

setToolTipEnabled

public final void setToolTipEnabled(boolean enabled)

Habilita/desabilita tooltip

Parameters:

enabled -

addButton

public void addButton(JButton button)

Adiciona um botão ao painel de botões do seletor. O valor de button não pode ser null.

Parameters:

button - o botão a ser adicionado ao seletor.