Função "Confirmar"

Aplica-se a: Aplicativos baseados em modelos

Exibe uma caixa de diálogo de confirmação para o usuário.

Description

Nota

No momento, a função Confirm está disponível somente ao escrever comandos do Power Fx para aplicativos baseados em modelo.

A função Confirm exibe uma caixa de diálogo no topo da tela atual. Dois botões são fornecidos: um botão confirmar e um botão cancelar, que têm como padrão versões localizadas de "OK" e "Cancelar", respectivamente. O usuário deve confirmar ou cancelar antes que a caixa de diálogo seja descartada e a função retorne. Além do botão de diálogo, cancelar também pode ser selecionado com a tecla Esc ou outros gestos específicos da plataforma.

O parâmetro Message é exibido no corpo da caixa de diálogo. Se a mensagem for muito longa, ela pode ficar truncada ou uma barra de rolagem pode ser fornecida.

Use o parâmetro OptionsRecord para especificar opções para a caixa de diálogo. Nem todas as opções estão disponíveis em todas as plataformas e são tratadas com base no melhor esforço. Não há suporte a essas opções nos aplicativos de tela.

Campo de Opção	Description
Botão de Confirmação	O texto a ser exibido no botão confirmar, substituindo o texto "OK" localizado, padrão.
Botão Cancelar	O texto a ser exibido no botão cancelar, substituindo o texto "Cancelar" localizado, padrão.
Título	O texto a ser exibido como título da caixa de diálogo. Uma fonte em negrito maior do que a fonte da mensagem pode ser usada para exibir este texto. O texto ficará truncado se ele for muito longo.
Legenda	O texto a ser exibido como subtítulo da caixa de diálogo. Uma fonte em negrito maior do que a fonte da mensagem pode ser usada para exibir este texto. O texto ficará truncado se ele for muito longo.

Confirm retorna true se o botão confirm foi selecionado, false caso contrário.

Use a função Notificar para exibir uma faixa de mensagem na parte superior do aplicativo que não precisa ser descartada.

Sintaxe

Confirmar( Mensagem [, OpçõesRegistro ] )

• Mensagem - Obrigatório. Mensagem a ser exibida ao usuário.
• OptionsRecord - Opcional. Forneça configurações de opção para a caixa de diálogo. Nem todas as opções estão disponíveis em todas as plataformas e são tratadas com base no "melhor esforço".

Exemplos

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Caixa de diálogo de confirmação simples, solicitando ao usuário que confirme a exclusão de um registro antes de removê-lo. A menos que o usuário pressione o botão OK, o registro não será excluído.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

Mesma caixa de diálogo que o último exemplo, mas adiciona o texto do Título.

Set( FavColor, 
     If( Confirm( "What is your favorite color?", 
                  { ConfirmButton: "Red", CancelButton: "Green" } 
         ), 
         "Red", 
         "Green" 
     ) 
)

Solicita ao usuário sua cor favorita, capturando o resultado em uma variável global. O resultado que será colocado em FavColor será a cadeia de texto "Vermelho" ou "Verde". Como opção de confirmação, "Vermelho" é o padrão. Isso só funciona em plataformas que oferecem suporte às opções ConfirmButton e CancelButton.

Confirm( "There was a problem, please review your order." )

Exibe uma mensagem semelhante à função Notificar, mas é modal e exige que o usuário selecione um botão para continuar. Use quando for importante que o usuário reconheça a mensagem antes de prosseguir. Neste caso, não é importante o botão selecionado e o resultado não é verificado.