Função Confirm

Aplica-se a: Aplicativos controlados por modelo

Apresente uma caixa de diálogo de confirmação para o utilizador.

Description

Nota

De momento, a função Confirmar só está disponível ao escrever comandos Power Fx para aplicações condicionadas por modelo.

A função Confirmar apresenta uma caixa de diálogo na parte superior do ecrã atual. São fornecidos dois botões: um botão para confirmar e um botão para cancelar, que predefine as versões localizadas de "OK" e "Cancelar", respetivamente. O utilizador deve confirmar ou cancelar antes de a caixa de diálogo ser dispensada e a função voltar. Além do botão de diálogo, o cancelar também pode ser selecionado com a tecla Esc ou outros gestos específicos da plataforma.

O parâmetro Mensagem é apresentado no corpo da caixa de diálogo. Se a mensagem for muito longa, poderá ser truncada ou fornecida uma barra de deslocamento.

Utilize 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. Estas opões não são suportadas em aplicações de tela.

Campo de Opção	Description
ConfirmarButton	O texto a apresentar no botão confirmar, que substitui o texto "OK" localizado predefinido.
CancelarButton	O texto a apresentar no botão cancelar, que substitui o texto "Cancelar" localizado predefinido.
Título	O texto a apresentar como título da caixa de diálogo. Pode ser utilizado um tipo de letra maior e com negrito mais intenso do o tipo de letra da mensagem para apresentar este texto. O texto será truncado, se for demasiado longo.
Subtítulo	O texto a apresentar como subtítulo da caixa de diálogo. Pode ser utilizado um tipo de letra maior e com negrito mais intenso do o tipo de letra da mensagem para apresentar este texto. O texto será truncado, se for demasiado longo.

Confirmar retorna true se o botão confirmar foi selecionado, false caso contrário.

Utilize a função Notificar para apresentar uma faixa de mensagem na parte superior da aplicação que não precisa de ser dispensada.

Sintaxe

Confirmar( Mensagem [, OptionsRecord ] )

• Mensagem - Obrigatório. A mensagem a apresentar ao utilizador.
• OptionsRecord - Opcional. Forneça as opções de definiçõ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".

Exemplos

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

Simples diálogo de confirmação, que pede ao utilizador que confirme a eliminação de um registo antes de este ser removido. A menos que o utilizador prima o botão "OK", o registo não será eliminado.

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

O mesmo diálogo que o último exemplo, mas adiciona o texto Título.

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

Pede ao utilizador a sua cor preferida, captando o resultado numa variável global. O resultado, que será colocado em FavColor, será a cadeia de texto "Vermelho" ou "Verde". Como escolha para confirmar, a predefinição é "Vermelho". Isto funciona apenas em plataformas que suportam as opções ConfirmButton e CancelButton.

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

Apresenta uma mensagem muito parecida com a função Notificar, mas é modal e requer que o utilizador selecione um botão para continuar. Utilize quando é importante que o utilizador tenha consciência da mensagem antes de prosseguir. Nesta situação, o botão que foi selecionado não é importante e o resultado não é verificado.