CheckBox - Documentação Scriptcase
Interface de configuração do campo checkbox.
Tipo do dado : Define o tipo do campo da aplicação. Quando o campo é definido como número, só é permitido informar números.
Forma utilizada para disponibilizar ao usuário final uma lista de valores onde poderão ser selecionados os itens que serão utilizados no formulário. Por exemplo, para um campo sexo no banco de dados com valores M ou F pode ser apresentado como Masculino ou Feminino ou de forma dinâmica, ter esses valores recuperados de uma tabela do banco de dados.
Configuração de exibição de campo com lookup de edição.
Estão disponíveis dois métodos de lookup: Manual (informando manualmente as condições de seleção) ou Automático (utilizando uma query de banco de dados). Seleção do tipo de Lookup.
Lookup utilizado para listar os valores que serão exibidos no campo Select. Estes valores serão recuperados de forma dinâmica através de um Comando Select.
Interface Lookup de Edição Automático.
Comando Select : Define o comando SQL que irá recuperar os valores a serem exibidos no campo do formulário. O comando deverá ter o seguinte formato "SELECT campo_chave , campo_a_ser_exibido FROM tabela".
O valor do campo_chave será armazenado no campo da tabela.
Delimitador : Define o caracter usado para separar os valores selecionados no campo do formulário. Só preencher este campo se
Recarregar formulário após alteração do valor : Com esta opção selecionada, o formulário será recarregado quando houver mudança do item selecionado no objeto select.
Opção marcar todos : Exibe uma opção para marcar e outra para desmarcar todos os itens.
Exibir valor original e lookup : Exibe o valor do campo e o valor retornado pelo lookup.
Separados por : Define que caracter será usado para separar o valor do campo e o valor retornado pelo lookup. Só é necessário preencher este campo se a opção Exibir valor original e lookup estiver selecionada.
Usar conexão específica : Permite selecionar uma outra conexão existente no projeto. O comando select será realizado nesta conexão secundária.
Interface Lookup de Edição Manual.
Tipo de Lookup : Define o modo de funcionamento do lookup, podendo ser : Simples Valor , Múltiplos Valores (delimitador), Múltiplos Valores (posição) e Múltiplos Valores (binário).
Simples Valor :
Configuração do lookup de edição Simples Valor
Label : Texto que será exibido para o item da lista no objeto select.
Valor : Atributo que corresponde ao valor que será armazenado no campo da tabela. Por exemplo, o valor M será incluído no campo da tabela quando na lista estiver selecionado o item Masculino.
Default : Com esta opção marcada o item já virá selecionado quando o formulário estiver em modo de inclusão.
Colunas : Permite informar a quantidade de colunas, para organizar o objeto no formulário.
Poderão ser armazenados vários valores para o campo selecionado. Os valores devem ser separados por um delimitador informado. Por exemplo: a combinação Esportes, Cinema e Turismo selecionada no formulário será gravada como E;C;T caso o delimitador seja ; (ponto e vírgula).
Configuração do lookup de edição Múltiplos Valores (delimitador)
Valor Atributo que corresponde ao valor que será armazenado no campo da tabela. Por exemplo, o valor Cserá incluído no campo da tabela quando na lista estiver selecionado o item Cinema.
Delimitador Caracter(es) utilizado(s) para fazer a separação dos múltiplos valores dentro do campo da tabela. Caso não seja informado, o delimitador padrão será ponto e vírgula ( ; ) .
Permite armazenar diversas informações em uma única string do campo selecionado. Para que estas informações sejam incluídas são informados, além do label, a posição inicial e a quantidade de bytes que cada informação ocupa dentro da string.
Exemplo: Se fossem selecionados Masculino, Casado e Estudar, no banco de dados seria armazenado o seguinte valor MCED.
Configuração do lookup Múltiplos Valores (posição)
Negativo : Valor a ser gravado na tabela caso nenhum valor de uma determinada posição seja selecionada.
Início : Posição inicial na string onde a informação será gravada. A primeira posição é sempre 1.
Tamanho : Quantidade de bytes que a informação ocupará na string.
Permite armazenar diversas informações em um valor inteiro no campo selecionado.
Como exemplo usaremos a seguinte lista (apesar de não ser informado na interface de inclusão de valores na lista, cada item possui um valor atribuído automaticamente de acordo com a ordem):
Para armazenar os dados é realizado uma soma do número decimal. Veja os exemplos abaixo.
Exemplo1: Se fossem selecionados as opções Esportes e Cultura o número armazenado no campo da tabela seria 3.
1 (Esportes) + 2 (Cultura) = 3
Exemplo2: Se fossem selecionados as opções Esportes, Lazer e Leitura o número armazenado no campo da tabela seria 13.
1(Esportes) + 4 (Lazer) + 8 ( Leitura) = 13
Configuração do lookup de edição Múltiplos Valores (Binário)
Colunas : Permite informar a quantidade de colunas para exibição dos itens do checkbox.
Botão Incluir : Inclui na lista os valores preenchidos nos campos Label e Valor.
Botão Alterar : Altera os atributos do item selecionado.
Botão Excluir : Exclui o item selecionado.
Botão Limpar : Limpa os campos.
Botão Salvar : Permite que o usuário salve toda a lista, para posterior utilização através da opção Carregar Definição de Lookup.
Carregar Definição de Lookup : Permite carregar uma Lista de valores pré-definida para uso como lookup. Aparecerão as definições existentes no Scriptcase e as listas salvas pelo usuário.
Separados por : Define o caracter que será usado para separar o valor do campo que está sendo definido e o valor retornado pelo lookup. Só é necessário preencher este campo se a opção Exibir valor original e lookup estiver selecionado.
Interface de configuração do processamento ajax.
Permite definir o(s) campo(s) que será(ão) recarregado(s) após a seleção de um valor do campo (onChange).
Por exemplo: um campo do tipo select com uma lista de estados, e outro campo do tipo select com uma lista de cidades. Ao selecionar um estado será recarregada a lista de cidades.