4D v16.3Controles de entrada de dados e ajuda de entrada |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
Controles de entrada de dados e ajuda de entrada
Controles de entrada de dados e ajuda de entrada
Com a ajuda da Lista de propriedades, pode definir diferentes propriedades que permitem controlar e facilitar a entrada de dados feitas pelo usuário nos objetos ativos editáveis. Estas propriedades lhe permitem:
O atributo Editável indica se os valores podem ser editados pelo usuário no objeto. Este atributo pode ser selecionado no tema “Entrada” da Lista de propriedades para os Get list item font. Um campo de uma tabela relacionada pode não ser editável se desmarcar a opção Campos relacionados acessíveis no assistente de formulários. Pode fazer que o campo relacionado seja editável selecionando a caixa Editável. Todos os campos são editáveis por padrão. Se deseja fazer que um campo não seja editável em um formulário, pode desmarcar a opção Editável para o objeto. Um objeto não editável só mostra dados. Os dados são controlados por métodos que utilizam o nomeda variável ou do campo. Os eventos de formulário On Clicked, On Double Clicked, On Drag Over, On Drop, On Getting Focus e On Losing Focus podem ser usados com objetos não editáveis. Isso facilita em particular a gestão de menus contextuais personalizados e a criação de interfaces onde pode arrastar e soltar e selecionar variáveis não editáveis. Notas:
Selecionar a opção Obrigatório faz com que o campo ou o objeto editável seja obrigatório nesse formulário. 4D não aceitará um registro se o campo ou o objeto não contiverem um valor. Nenhum campo ou objeto editável é obrigatório por padrão. Para tornar um campo obrigatório em todos os formulários, selecione o atributo Obrigatório na janela Inspetor do editor de estrutura. Se você quer que um campo ou algum outro objeto editável seja obrigatório em um formulário particular, selecione a opção Obrigatório nas propriedades do objeto. Os atributos Editável e Obrigatório são similares aos atributos de campo que você pode definir no editor de estrutura. Se você deseja que estes atributos sejam diferentes em um formulário em particular, você pode modificar as propriedades de cada campo na Lista de propriedades, no tema Armazenado em registro, arquivo de dados ou fora do arquivo de dados. É possível definir o atributo Tabulável para cada campo editável. Quando este atributo está selecionado para um campo, inclui-se na ordem de entrada e estará ativo quando o usuário pressionar a tecla Tab. Pode ativar o atributo Tabulável para um objeto não editável. Nesse caso, pode selecionar esse objeto usando a tecla Tab mas não poderá introduzir valores. A propriedade Tabulável só é acessível se a propriedade Enfocável está selecionada. Em outras palavras, todo objeto tabulável pode obter o foco. Entretanto, alguns objetos podem ser “enfocáveis” sem serem “tabuláveis” (por exemplo, um objeto pode ser selecionado clicando nele). Neste caso, o objeto não pertence à sequência de entrada de dados.Esta propriedade é encontrada no tema “Entrada” da Lista de propriedades para os objetos ativos (editáveis ou não) como también para los campos no editables. Quando a propriedade Acessível é selecionada para um objeto, o objeto pode obter o foco (e portanto pode ser ativado pelo teclado por exemplo). É rodeado por uma linha pontilhada cinza quando está selecionada, exceto se a opção "Ocultar retângulo de foco" também tenha sido selecionada (ver a seguinte seção). Caixa de seleção selecionada mas não mostra o foco Caixa de seleção que mostra o foco quando é selecionada Quando a propriedade Enfocável é selecionada para um objeto não editável, o usuário pode selecionar, copiar ou inclusive transportar por arrastar e soltar o conteúdo da área. Durante a execução, um campo ou objeto editável é demarcado por um retângulo de seleção quando tem o foco (através da tecla Tab ou um simples clique). É possível ocultar este retângulo selecionando a opção Ocultar retângulo de foco. Ocultar o retângulo de foco pode ser útil no caso de interfaces específicas. Pode atribuir listas de valores a objetos editáveis dos formulários. Pode utilizar três tipos de listas: listas de valores simples, listas de valores obrigatórios e listas de valores excluídos. As listas simples são definidas no tema “Fontes de dados” da Lista de propriedades. As listas de valores obrigatórios ou excluídos são definidas no tema “Faixa de valores” da Lista de propriedades. Antes de associar uma lista de valores, você deve tê-la criado no Editor de listas (ver Listas). Associar uma lista de valores fonte (tema “Fonte de dados”) a um objeto editável para mostrar uma lista de valores durante a entrada de dados. A lista de valores aparece quando o campo ou objeto editável é selecionado no formulário em execução. Logo, o usuário pode selecionar o valor na lista. Também pode utilizar Menus suspensos/Listas suspensas ou Combo Boxes e associar uma lista de seleção a eles a fim de manipular a entrada e visualização dos valores de um campo ou de uma variável (se a lista de seleção é hierárquica, só o primeiro nível pode ser utilizado). Para isso, basta com introduzir o nome do campo ou da variável na área "Nome da variável" da Lista de propriedades (ver a seção Menus suspensos/Listas suspensas) . O usuário pode sobrescrever a entrada selecionada da lista digitando um novo valor (a menos que a lista também esteja associada como lista de valores obrigatórios).Uma lista de valores excluídos evita que os usuários introduzam os valores dessa lista. Por exemplo, para um campo em um formulário de entrada utilizado só por operários, você poderia associar uma lista de valores reservados só para gerentes. É possível associar uma lista de valores a um campo a nível da tabela ou do formulário. Se você quer associar a lista a nível da tabela, utilize a janela inspetor no editor de estrutura (ver a seção Armazenado em registro, arquivo de dados ou fora do arquivo de dados). A lista de valores estará associada a este campo em todos os formulários e editores de buscas do banco. Se associar a lista a um campo ao nível do formulário unicamente, ela pode servir como lista de seleção apenas para esse formulário. Note que neste caso, pode gerenciar diretamente a entrada de dados e mostrar no campo utilizando um objeto de tipo Menus suspensos/Listas suspensas ou Combo Boxes. Uma lista de valores obrigatórios (tema “Faixa de valores”) limita as entradas válidas aos valores que contém. Por exemplo, é possível utilizar uma lista de empregos com o fim de restringir as entradas válidas aos empregos aprovados pela gerência. Tornar uma lista obrigatória não faz com que a lista seja mostrada automaticamente ao selecionar o campo. Para mostrar a lista obrigatória, atribua a mesma lista como lista de valores (no tema “Fonte de dados”). Um filtro de entrada controla exatamente o que o usuário pode introduzir durante a entrada de dados. Diferente dos controles de entrada tratados anteriormente nessa seção, os filtros de entrada operam caractere por caractere. Por exemplo, se um código identificador sempre consta de duas letras seguidas por três dígitos, é possível utilizar um filtro de entrada para obrigar o usuário a respeitar esse formato. É possível controlar letras e números particulares. Um filtro de entrada só funciona durante a entrada de dados e não tem efeito durante a visualização dos dados depois que o usuário desmarca o campo. Em geral, os filtros de entrada são utilizados conjuntamente com Formatos de saída. Os filtros de entrada controlam os dados introduzidos e os formatos de saída asseguram a apresentação adequada dos dados depois de sua entrada. O filtro de entrada é criado selecionando um dos filtros integrados ou personalizados da lista suspensa Filtro de entrada ou escrevendo-o diretamente na área Filtro de entrada. A lista suspensa Filtro de entrada contém filtros para datas, horas e campos alfa. Na maior parte do tempo, pode usar um dos filtros integrados de 4D, entretanto, também pode criar filtros personalizados (Editor de Filtros e Formatos). Os nomes de filtros personalizados que foram criados são adicionados à lista suspensa Filtros de entrada, precedidos por uma barra vertical (|). É possível modificar um filtro de entrada depois de ter selecionado-o. Por exemplo, se você deseja utilizar um filtro que lhe permita a entrada de minúsculas e maiúsculas, porém também necessita permitir a entrada do caractere arroba (@), é possível selecionar o seguinte filtro: &"a-z;0-9; ;,;.;-" e modificá-lo a: Os códigos de filtros de entrada geralmente começam com o símbolo ampersand (&). Este caractere indica a 4D que deve interpretar o código que se segue como um filtro de entrada. Se o código começa com um til (~), significa o mesmo que “&” exceto que as letras são convertidas automaticamente para maiúsculas. Geralmente, o caractere “&” vai seguido por “A”, “a”, ou “9”, para indicar que só são permitidas maiúsculas (A), minúsculas e maiúsculas (a), ou só caracteres numéricos (9). Por exemplo, &9 só permite números e &A só permite maiúsculas. Essa tabela descreve cada um dos filtros disponíveis na lista Filtro de Entrada:
Geralmente, quando se utiliza um filtro de entrada, cria-se um formato de saída. Um filtro de entrada só funciona durante a entrada de dados, não tendo efeito na forma como se apresenta a informação quando o campo não está selecionado. Por exemplo, se você utiliza o filtro de entrada para o número de segurança social (&9###-##-####), deverá selecionar o formato de saída correspondente ao número de segurança social (###-##-####). Sem o formato de saída, só aparecerão no campo os números, sem os hífens.
É possível utilizar os formatos de saída nos formulários de entrada, de saída e em registros rápidos. Para maiores informações sobre os formatos de saída em registros rápidos, consulte o parágrafo Estabelecer formatos de saída de colunas. 4D mostra textos de exemplo nos campos dos formulários. O texto de exemplo se mostra de novo se o conteúdo do campo se apaga. Pode definir um texto exemplo no tema "Entrada" da Lista de propriedades: A opção Texto de exemplo está disponível para os seguintes objetos:
Um texto de exemplo pode ser mostrado para os seguintes tipos de dados:
Pode utilizar uma referência xliff en ":xliff:resname" como texto de exemplo, por exemplo: :xliff:PH_Lastname Só passe a referência no campo "Texto de exemplo", não é possível combinar uma referência com texto estático. Nota: também pode definir e obter o texto do marcador por programação utilizando os comandos OBJECT SET PLACEHOLDER e OBJECT Get placeholder. É possível aplicar restrições à entrada de campos de tipo numérico, data, hora ou objeto editável definindo valores máximos e mínimos nas áreas de entrada correspondentes no tema “Faixa de valores” das propriedades dos objetos.
É possível atribuir um valor padrão para um campo ou objeto editável. O valor padrão é introduzido quando aparece um novo registro. É possível modificar o valor a menos que o campo ou área de entrada tenha sido definido como não editável. É possível definir o valor padrão no tema “Faixa de valores” da Lista de propriedades. O valor padrão deve corresponder ao tipo de campo para o qual está definido. 4D oferece códigos para gerar valores padrão para datas, horas e números seqüenciais. A data e hora são tomadas do sistema. 4D gera automaticamente qualquer seqüência de números requerida. A tabela a seguir mostra os códigos a se utilizar para gerar automaticamente valores padrão:
É possível utilizar um número de seqüência para criar um número único para cada registro. Um número de seqüência é um número inteiro gerado para cada novo registro. Os números começam com um (1) e aumentam de um em um (1). Um número de seqüência não se repete mesmo quando um registro é apagado da tabela. Cada tabela tem sua própria seqüência de números. Consulte o comando Sequence number no manual Linguagem de 4D. Se o objeto mostra uma lista de valores (tal como um combo box, uma área de rolagem, um menu suspenso, uma aba, ou uma lista suspensa), é possível especificar uma lista de valores a se utilizar como valores padrão. Esta lista será carregada no objeto antes de ser mostrado no formulário. Para os objetos que aceitam uma lista de valores padrão, a área dos valores padrão é convertida em um botão: Quando você clica neste botão, aparece a caixa de diálogo Valores padrão: Escreva a lista de valores padrão. Cada valor deve aparecer em uma linha diferente. Clique no botão Aceitar para fechar a caixa de diálogo e retornar à janela Lista de propriedades.Quando você introduz valores padrão na caixa de diálogo valores padrão, os valores são carregados automaticamente em um array cujo nome é o nome do objeto. Utilizando a linguagem, é possível manipular o objeto fazendo referência a este array.
Nota de compatibilidade: esta opção só é levada em conta quando o banco funciona em modo não Unicode. Em modo Unicode, esta propriedade é ignorada. Para mais informação, consulte a documentação de versões anteriores de 4D. 4D inclui um utilitário de correção ortográfica integrado e personalizável. A verificação ortográfica pode ser efetuada para os campos e variáveis tipo Alfa e Texto, assim como para os documentos 4D Write. A propriedade Correção Ortográfica (tema "Controles de entrada") ativa a correção ortográfica para o objeto. Nesse caso, a verificação ortográfica é realizada automaticamente durante a entrada de dados. Nota: pode executar o comando SPELL CHECKING para cada objeto a controlar.Em 4D, a correção ortográfica se aplica continuamente em áreas de texto, com os erros ressaltados diretamente no texto com um sublinhado de pontos: As linhas de pontos em diferentes cores se utilizam com o propósito de determinar o tipo de correção a realizar:
O usuário pode então corrigir o texto usando o menu contextual (clique direito na palavra sublinhada) ou utilizar o quadro de diálogo do corretor ortográfico. Para mostrar as opções de correção ortográfica, pode fazer clique direito sobre uma palavra desconhecida e aparecerá um menu contextual que contém os comandos de correção ortográfica: Nota: as opções Menu contextual e Correção ortográfica devem estar selecionadas para o objeto. Pode selecionar a opção Mostrar o diálogo de revisão de ortografia para mostrar um diálogo no que pode introduzir um valor corrigido: Este diálogo é uma janela flutuante que continua disponível para todas as janelas da aplicação durante a sessão, até que o usuário a fecha. Além das sugestões de correções, as seguintes opções e funções são propostas pelo corretor em 4D (via o menu contextual e/ou o diálogo de correção):
El submenú Configuración de ortografía ofrece las siguientes funciones:
O corretor ortográfico nativo de OS X oferece várias opções de correção:
A correção ortográfica em 4D agora pode usar:
É possível adicionar uma mensagem de ajuda a campos e objetos ativos em seus formulários para ajudar os usuários a trabalhar de forma mais produtiva com seu banco de dados. As mensagens de ajuda aparecem em quadros emergentes. Por exemplo, é possível criar uma mensagem de ajuda para um campo de tipo Data que recorde o usuário incluir uma barra oblíqua (/) como separador entre o dia, o mês e o ano quando introduzir os dados. Nota: Também se pode associar uma mensagem de ajuda com um campo a nível da estrutura do banco de dados. Neste caso, a mensagem de ajuda aparece em todos os formulários onde esteja o campo. Para maiores informações, consulte “Mensagens de ajuda” em Armazenado em registro, arquivo de dados ou fora do arquivo de dados. É possível associar uma mensagem de ajuda a qualquer objeto ativo em seus formulários, usando a lista Mensagem de ajuda no tema "ajuda" da Lista de propriedades. É possível:
A mensagem selecionada aparecerá como mensagem de ajuda para o campo ou objeto selecionado no formulário. Nota: Em Mac OS, a visualização de mensagens de ajuda não é suportada em janelas de tipo pop-up. Esta propriedade está disponível para os campos ou variáveis de tipo Alfa ou Texto nos formulários. Essa propriedade conserva a visibilidade da seleção ao interior do objeto depois de perder o foco. Isso facilita a implementação de interfaces que permitam modificar o estilo do texto (ver GET DATA SOURCE LIST). Os comandos OPEN FONT PICKER e OPEN COLOR PICKER mostram as janelas do sistema de seleção de cor e de fonte. Os usuários podem mudar o cor ou a fonte do objeto que tem o foco no formulário diretamente fazendo clique em uma destas janelas. Para que possa controlar as ações usuário, esta função está sujeita ao valor da nova propriedade Autorizar seletor fonte/cor do tema “Texto”: Esta propriedade está disponível para os objetos de formulário de tipo campo, variável e combo box. Por padrão, está desativada para todos os objetos dos formulários. Deve selecionar ela de forma explícita para cada objeto no que deseje que a fonte e/ou cor seja modificável utilizando a janela do seletor de sistema.
|
PROPRIEDADES
Produto: 4D
HISTÓRIA
ARTICLE USAGE
Manual de Desenho 4D ( 4D v16) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||