Retornará um valor se uma condição for verdadeira e retornará outro valor se a mesma condição for falsa.

Descrição

A função If testa condições até que um resultado verdadeiro seja encontrado. O valor correspondente, consequentemente, é retornado como o resultado. Você pode usar a função If para retornar resultados diferentes com base em comparações e outros testes.

Você pode usar a função If nas fórmulas de comportamento para ramificar entre duas ações. No máximo, uma ramificação será executada. As condições são avaliadas na ordem e, depois que um resultado verdadeiro for encontrado, mais nenhuma condição será verificada.

Se nenhuma das condições for atendida e um número ímpar de argumentos for fornecido, será retornado o valor do último argumento. Esse é o caso comum da função If( Condição, Valor, Else ). Se um número par de argumentos for fornecido, o valor retornará em branco.

Sintaxe

If( Condição, Resultado [, ElseResult ] )
If( Condição1, Resultado1 [, Condição2, Resultado2, ... [ , ElseResult ] ] )

  • Condições - obrigatório. Fórmulas para testar para verdadeiro. Normalmente, essas fórmulas contêm operadores de comparações (como <, >, e =) e funções de teste como IsBlank e IsEmpty.
  • Resultados - obrigatório. O valor correspondente para retornar uma condição que é avaliada como verdadeira.
  • ElseResult - opcional. Valor a ser retornado se nenhuma das condições for atendida. Se você não especificar esse argumento, o valor retornará em branco.

Exemplos

Valores em fórmulas

Nos exemplos a seguir, um controle deslizante Slider1 tem um valor de 25.

Fórmula Descrição Resultado
If( Slider1.Value = 25, "Resultado1") A condição é verdadeira e o resultado correspondente é retornado. "Resultado1"
If( Slider1.Value > 1000, "Resultado1") A condição é falsa e não é fornecido nenhum ElseResult. em branco
If( Slider1.Value = 25, "Resultado1", "Resultado2") A condição é verdadeira e o resultado correspondente é retornado. "Resultado1"
If( Slider1.Value > 1000, "Resultado1", "Resultado2") A condição é falsa e o ElseResult é fornecido e retornado. "Resultado2"
If( Slider1.Value = 25, "Resultado1" Slider1.Value > 0, "Resultado2") A primeira condição é verdadeira e o resultado correspondente é retornado. A segunda condição também é verdadeira, mas seu valor correspondente não é retornado porque ele aparece na lista de argumento depois da primeira condição. "Resultado1"
If( IsBlank( Slider1.Value ), "Resultado1", IsNumeric( Slider1.Value ), "Resultado2") A primeira condição é falsa porque o controle deslizante tem um valor de 25 e não está em branco. A segunda condição é verdadeira porque o valor do controle deslizante é um número e o resultado correspondente será retornado. "Resultado2"
If(Slider1.Value > 1000, "Resultado1" Slider1.Value > 50, "Resultado2", "Resultado3") A primeira e segunda condições são falsas e o ElseResult é fornecido e retornado. "Resultado3"

Ramificação em fórmulas de comportamento

Nos exemplos a seguir, um controle Entrada de texto chamado FirstName tem o valor “Julio” digitado nele.

Fórmula Descrição Resultado
If( ! IsBlank( FirstName.Text ), Navigate( Tela1, ScreenTransition.None ) ) A condição é verdadeirae a função Navigate é executada. Você pode usar a função IsBlank para testar se um campo de formulário obrigatório foi preenchido. Se a caixa de entrada de texto estiver em branco, essa fórmula não terá efeito algum. verdadeiro

A exibição é alterada para Tela1.
If( IsBlank( FirstName.Text ), Navigate( Tela1, ScreenTransition.None ), Back() ) Sem o . operador, a condição é falsae a função Navigate não é executada. Como o ElseResult é fornecido, a função Back é executada. verdadeiro

A exibição volta a exibir a tela que estava em exibição anteriormente.

Passo a passo

  1. Em uma tela vazia, adicione um controle Entrada de texto e nomeie-o Text1 caso ele não tenha esse nome por padrão.

  2. Em Texto1, digite 15.

  3. Adicione um rótulo e defina a propriedade de Texto para as seguintes fórmulas:

Fórmula Descrição Resultado
Text1.Text Com nenhuma condição, o valor de retorno é o valor da entrada-,controle de texto. "15"
If( Value(Text1.Text) < 40, "Solicitar mais!", Text1.Text ) A condição é verdadeira e o valor correspondente é retornado. "Solicitar mais!"
If( Value(Text1.Text) < 20, "Solicitar MUITO mais!", Value(Text1.Text) < 40, "Solicitar mais!", Text1.Text ) A primeira condição é verdadeira e o valor correspondente é retornado. "Solicitar MUITO mais!"