Definindo uma Função Customizada

Sobre Esta Tarefa

Para definir ou criar uma função customizada:

Procedimento

  1. Selecione a guia Funções. Na guia Função, a lista de funções padrão é exibida. Além disso, a área de janela Ações é aberta.
  2. Para exibir a caixa de diálogo Função Customizada, escolha a partir de uma das seguintes opções:
    • Clique com o botão direito do mouse no nó Função Customizada na guia Funções e, no menu, selecione Incluir Nova Função Customizada... .
    • Na área de janela Ações, selecione Incluir Nova Função Customizada.

      A caixa de diálogo Função Customizada é aberta.

  3. No campo Nome da Função da caixa de diálogo Função Customizada, insira um nome de JavaScript válido para sua função customizada.
    Nota: Esse nome deve ser exclusivo para todas as funções customizadas no projeto atual. O nome da função não faz distinção entre maiúsculas e minúsculas - a caixa de um caractere não é considerada. Por exemplo, o nome da função: Aaa é equivalente ao nome da função: AAA.
  4. Selecione um Tipo de Retorno para sua função customizada a partir de uma das seguintes opções:
    • cadeia
    • número
    • booleano
    Para obter informações adicionais sobre esses tipos de dados, consulte Tipos de Dados de Parâmetro e de Retorno da Função Customizada.
  5. Defina os parâmetros para sua função customizada. Repita as seguintes etapas para cada parâmetro em sua função customizada:
    1. Clique em Incluir.
    2. No campo Nome da tabela Parâmetros, insira o nome do parâmetro e pressione a tecla Retornar.
    3. Selecione um Tipo para o parâmetro, a partir de uma das seguintes opções:
      • cadeia
      • número
      • booleano
    4. Para obter informações adicionais sobre esses tipos de dados, consulte Tipos de Dados de Parâmetro e de Retorno da Função Customizada.
  6. Insira o código de origem para sua função customizada, seguindo estas etapas:
    1. Clique em Avançar.
    2. Na área em branco exibida entre as chaves, insira o código JavaScript de sua função customizada.
    3. Clique em Compilar. A sintaxe da função será verificada e quaisquer erros relatados. O local dos erros é destacado em vermelho no código de origem.
    4. Corrija quaisquer erros de sintaxe e, após a função ser compilada com êxito, clique em OK e, em seguida, Concluir.

Resultados

A função customizada está agora disponível a partir da pasta Funções Customizadas da guia Funções.