Ações padrões

Esta seção descreve todas as ações automáticas que podem ser atribuídas a um botão e a certos objetos ativos dos formulários (ou a comandos de menu, consulte o parágrafo Especificar a ação do menu).

• Sem ação: use um botão Sem ação para um botão que não realize uma ação automática. Escolha Sem ação quando necessite escrever um método para controlar um botão. Por exemplo, um botão que mostre uma caixa de diálogo de pesquisa personalizada em uma aplicação teria Sem ação como ação automática porque é necessário definir um método para abrir a caixa de diálogo de pesquisa personalizada.
• Ações aceitar e cancelar: clicar em um botão Aceitar salva o registro e dispara o evento On Saving New Record Event ou On Saving Existing Record Event além de On Validate. . Clicar em um botão Cancelar sai do registro atual sem salvar as alterações.
• Eliminar registro: clicar em um botão Eliminar registro mostra um alerta pedindo ao usuário confirmar a eliminação. Ao clicar em Sim no alerta, o registro atual é eliminado. Se o usuário estiver utilizando o formulário de entrada para um subregistro, Eliminar registro eliminar o subregistro atual.
• Uma vez que o usuário clique no botão Eliminar registro, 4D automaticamente volta ao formulário de saída.
  
• Nota: Um botão com esta ação é desativado automaticamente quando se adiciona um novo registro.
•  Ações de navegação entre registros: os botões Próximo registro, Registro anterior, Primeiro registro e último registro primeiro aceitam o registro atual e logo tornam o registro especificado como atual. O registro específico que será convertido em registro atual por um destes botões depende da ordem de seleção.
• Estas ações são apropriadas em subregistros quando o usuário está introduzindo subregistros.
• Um objeto deste tipo é desativado automáticamente quando sua ação não é apropriada. Por exemplo, se o usuário mostra o primeiro regitro, o botão Registro anterior é desativado.
• Ações de navegação entre páginas: os botões Primeira página, Última página, Próxima página e Página anterior mostram a página especificada em um formulário multipáginas. Se o formulário tem somente uma página, estes botões são desativados.
  Um objeto deste tipo é desativado automaticamente quando sua ação não for apropriada. Por exemplo, se o usuário mostra a primeira página, o botão Primeira Página é desativado.
• Modificar subregistro: esta ação pode ser utilizada em três contextos: os list box, os subformulários e os formulários listados mostrados utilizando os comandos MODIFY SELECTION /  DISPLAY SELECTION ou no modo Desenho.
• • List box: um botão associado a ação estandarte Modificar subregistro se ativa automaticamente quando pelo menos uma linha de list box de tipo "selection" está selecionada (ver Utilizar ações estandarte).
  • Subformulario: localizado no formulário de um registro pai, este botão está ativo quando o registro do subformulário estiver selecionado.
    Se o usuário seleciona um subregistro e logo clica no botão Modificar subregistro, o subregistro passa ao modo edição, seja diretamente na lista, ou no formulário detalhado associado (dependendo das propriedades do subformulário).
  • Formulários listados: este botão está ativo quando um registro está selecionado na lista. Quando um usuário clica neste botão, o registro passa ao modo edição. Com as listas mostradas através dos comandos  MODIFY SELECTION / DISPLAY SELECTION a modificação é efetuada na lista ou na página detalhada dependendo do valor do parâmetro enterList. Na janela de visualização de registros, a modificação é efetuada na página detalhada (a ação é equivalente a um clique duplo).
• Adicionar subregistro: esta ação pode ser utilizada em três contextos: os list box, os subformulários e formulários listados suspensos utilizando os comandos MODIFY SELECTION /  DISPLAY SELECTION ou na janela de visualização de registros no modo Desenho.
  • List box: um botão associado a ação estandarte Adicionar subregistro se ativa automaticamente quando pelo menos um list box de tipo "selection" está presente no formulário (ver Utilizar ações estandarte).
  • Subformulário: localizado no formulário de um registro pai, este botão está ativado quando um registro do subformulário estiver selecionado.Quando o usuário clicar neste botão, 4D cria um novo registro na tabela ou subtabela relacionada, seja diretamente na lista, ou no formulário detalhado associado (em função das propriedades do subformulário).
  • Formulários listados: este botão está ativado sempre. Quando o usuário clica neste botão , é criado um novo registro vazio, Com as listas suspensas utilizando os comandos  MODIFY SELECTION / DISPLAY SELECTION o registro é adicionado na lista o una página detalhada dependendo do valor do parâmetro enterList.. Na janela de visualização de registros, o registro é adicionado à lista.

• Eliminar subregistro: esta ação pode ser utilizada em três contextos: os list box, os subformulários e formulários listados mostrados utilizando os comandos MODIFY SELECTION/ DISPLAY SELECTION ou na janela de visualização dos registros em modo Desenho.
• • List box: um botão associado a ação estandarte Eliminar subregistro se ativa automaticamente quando pelo menos uma linha de list box de tipo "selection" está selecionada no formulário (ver [#title id="3411"/]).
  • Subformulário: localizado no formulário de um registro pai, este botão está ativo quando um subregistro tiver sido selecionado em um subformulário.
  • Formulários listados: este botão está ativo quando pelo meno um registro estiver selecionado  na lista. Quando o usuário clica neste botão, aparece uma caixa de diálogo, que permite confirmar ou cancelar a eliminação

                        Para maiores informações sobre a utilização de botões em subformulario, consulte o parágrafo .

• Separador automático: esta ação automática permite criar separadores personalizados em seus formulários. Esta ação só pode ser atribuída a um botão invisível (ver Botões). Quando se atribui esta ação a um botão invisível, este se comporta como um separador. Colando uma imagem no botão invisível, é possível criar qualquer tipo de interface personalizada para seus separadores. Para maiores informações sobre separadores, consulte Separador..

• Desfazer: cancela a última ação efetuada (= ao comando Desfazer do menu Edição). Não se deve confundir Desfazer com Cancelar (= cancela as modificações realizadas a um registro durante sua visualização e retorna ao formulário de saída).
•  Refazer: repete a última ação cancelada (= ao comando Refazer do menu Edição).
• Cortar: apaga a seleção e a guarda na área de transferência
• Copiar: guarda uma cópia da seleção na área de transferência
• Colar: insere o conteúdo da área de transferência onde se encontra o cursor.
• Excluir: apaga a seleção. Se não existe nada selecionado, apaga a totalidade da área que contém o cursor  (somente áreas editáveis).
• Selecionar tudo: seleciona todos os elementos selecionáveis no contexto.
• Mostrar área de transferência: abre uma nova janela que mostra o conteúdo atual da área de transferência.
• Propriedades do banco: mostra a caixa de diálogo padrão de Propriedades do banco. (ver nota na parte inferior).
•  Aplicação: passa ao primeiro plano a janela e a apaga de menus do modo Aplicação de 4D.
• Sair: mostra uma caixa de diálogo de confirmação “Tem certeza?”, logo sai da aplicação 4D em caso de validação. Caso contrário, a operação é cancelada.
  Quando esta ação é atribuída a um botão com o qual um método de objeto também está associado, se executa a seguinte seqüência: primeiro, aparece a caixa de diálogo de confirmação. Se for validada, 4D executa o método do objeto. Depois de sua execução, a aplicação se fecha.
  Nota Mac OS: em Mac OS X, os comandos de menus personalizados associados às ações Propriedades do banco e Sair se localizam automaticamente no menu da aplicação, quando o banco de dados é executado neste ambiente. Este mecanismo simplifica o controle do comando Quit sob Mac OS X 
• Retorno ao modo Desenho: passa ao primeiro plano as janelas e a barra de menus do modo Desenho de 4D. Quando o banco se executa em modo interpretado, esta ação provoca a visualização da janela atual do modo Desenho. Quando o banco se executa em modo compilado, esta ação provoca a visualização da janela de registros da tabela atual (em modo compilado, somente o acesso aos registros é possível).
• CSM: mostra a janela do Centro de segurança e manutenção.
• Ir a página: esta ação está disponível apenas para objetos do tipo Abas. Quando essa opção estiver ativa, 4D mostra automaticamente a página do formulário correspondente ao número de aba selecionada. Para mais informação, consulte Ação Goto Page

 As seguintes ações são utilizadas no contexto de um formulário que contém uma área web (para maiores informações sobre este tipo de objeto, consulte o parágrafo Área Web).

 Abrir URL anterior: provoca a abertura da URL anterior entre a sequência de navegação efetuada pelo usuário na área web. Se não houver uma URL anterior, ou seja se o usuário só tiver mostrado uma página na área, o botão ou o comando de menu associado se desativa.
    Abrir URL seguinte: provoca a abertura da URL seguinte entre a sequência de navegação efetuada pelo usuário na área web. Se não houver uma URL seguinte, ou seja se o usuário não tiver retrocedido uma página na sequência, o botão ou o comando de menu associado é desativado.
    Atualizar URL atual: recarrega o conteúdo atual da área web.
    Deter carga URL: detém a carga da página ou os objetos presentes na URL atual na área web.

• Abrir URL anterior: provoca a abertura da URL anterior entre a seqüência de navegação efetuada pelo usuário na área web. Se não existe uma URL anterior, ou seja, se o usuário só mostrou uma página na área, o botão ou o comando de menu associado se desativa.
• Abrir próxima URL: provoca a abertura da URL seguinte entre a seqüência de navegação efetuada pelo usuário na área web. Se não existe uma URL seguinte, ou seja, se o usuário não retrocedeu uma página na seqüência, o botão ou o comando de menu associado se desativa.
• Atualizar URL atual: recarrega o conteúdo atual da área web.
• Parar carga URL: para a carga da página e/ou os objetos presentes na URL atual na área web.