csbase.client.util

Class FileTextField

java.lang.Object

csbase.client.util.FileTextField

public class FileTextField
extends java.lang.Object

Classe que representa um componente para busca e validação de arquivos e/ou diretórios no projeto. Oferece um JTextField (obrigatório), um JLabel (opcional) e um JButton (opcional) com a imagem de um binóculo, que podem ser posicionados de acordo com as preferências de layout. O componentes pode apresentar 5 comportamentos diferentes, definidos pela propriedade mode, definida no construtor ou através do método setMode(). De acordo com o modo de operação escolhido, o componente irá validar as entradas do usuário no campo texto, assim como definir filtros para quais tipos de arquivos/diretórios poderão ser escolhidas em uma caixa de diálogo, exibida quando o usuário clica no botão. Para isso, é necessário que seja passada uma referência para o projeto corrente através do método setProject(). Para ativar o diálogo e recuperar a(s) opção(ões) selecionada(s) pelo usuário, deve-se usar o método getButtonPath() ou getButtonPaths(). Para validar o texto entrado no campo e recuperar o(s) caminho(s) lógico(s) escolhido(s) pelo usuário, deve-se usar os métodos getFieldPath() ou getFieldPaths().

Constructor Summary

Constructors

Constructor and Description
FileTextField(java.awt.Window window, java.lang.String labelText, int fieldLength, csbase.logic.CommonClientProject project, int mode, boolean isSaveMode) Construtor inicializando o rótulo, o campo texto e definindo o modo de operação do objeto.
FileTextField(java.awt.Window window, java.lang.String labelText, int fieldLength, csbase.logic.CommonClientProject project, int mode, java.lang.String extension, boolean isSaveMode) Construtor inicializando o rótulo, o campo texto, definindo o modo de operação do objeto e a extensão preferencial do arquivo.

Method Summary

Methods

Modifier and Type	Method and Description
javax.swing.JButton	getButton() Obtém o botão de navegação na árvore de diretórios.
ProjectTreePath	getButtonPath() Obtém o caminho para um arquivo/diretório a partir de uma seleção do usuário em um diálogo ProjectFileChooser.
ProjectTreePath[]	getButtonPaths() Obtém os caminhos para todos os arquivos/diretórios que o usuário selecionar em um diálogo ProjectFileChooser.
javax.swing.JTextField	getField() Obtém o campo texto.
ProjectTreePath	getFieldPath() Obtém (e valida) o caminho para o arquivo/diretório digitado pelo usuário no campo texto.
javax.swing.JLabel	getLabel() Obtém o rótulo associado ao campo texto.
java.lang.String	getText() Obtém o texto do campo.
void	setSaveMode(boolean isSaveMode)

Methods inherited from class java.lang.Object

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

Constructor Detail

FileTextField

public FileTextField(java.awt.Window window,
             java.lang.String labelText,
             int fieldLength,
             csbase.logic.CommonClientProject project,
             int mode,
             boolean isSaveMode)

Construtor inicializando o rótulo, o campo texto e definindo o modo de operação do objeto.

Parameters:

window - .

labelText - texto a ser exibido no rótulo.

fieldLength - tamanho do campo texto.

project - .

mode - modo de operação (ver constantes em ProjectFileChooser).

isSaveMode - .

FileTextField

public FileTextField(java.awt.Window window,
             java.lang.String labelText,
             int fieldLength,
             csbase.logic.CommonClientProject project,
             int mode,
             java.lang.String extension,
             boolean isSaveMode)

Construtor inicializando o rótulo, o campo texto, definindo o modo de operação do objeto e a extensão preferencial do arquivo.

Parameters:

window - .

labelText - texto a ser exibido no rótulo.

fieldLength - tamanho do campo texto.

project - .

mode - modo de operação (ver constantes em ProjectFileChooser).

extension - extensão preferencial para o arquivo.

isSaveMode - .

Method Detail

getField

public javax.swing.JTextField getField()

Obtém o campo texto.

Returns:

campo texto.

getText

public java.lang.String getText()

Obtém o texto do campo.

Returns:

o texto do campo.

getLabel

public javax.swing.JLabel getLabel()

Obtém o rótulo associado ao campo texto.

Returns:

o rótulo.

getButton

public javax.swing.JButton getButton()

Obtém o botão de navegação na árvore de diretórios.

Returns:

o botão de navegação

getButtonPath

public ProjectTreePath getButtonPath()
                              throws ClientException

Obtém o caminho para um arquivo/diretório a partir de uma seleção do usuário em um diálogo ProjectFileChooser.

Returns:

caminho para o arquivo/diretório selecionado.

Throws:

ClientException

getButtonPaths

public ProjectTreePath[] getButtonPaths()
                                 throws ClientException

Obtém os caminhos para todos os arquivos/diretórios que o usuário selecionar em um diálogo ProjectFileChooser.

Returns:

array de caminhos para todos os arquivos/diretórios selecionados.

Throws:

ClientException

getFieldPath

public ProjectTreePath getFieldPath()

Obtém (e valida) o caminho para o arquivo/diretório digitado pelo usuário no campo texto.

Returns:

caminho para o arquivo/diretório.

setSaveMode

public void setSaveMode(boolean isSaveMode)