Partilhar via

Confirm Função

Aplica-se a: Aplicativos de tela Aplicativos orientados por modelos

Use esta função para mostrar uma caixa de diálogo de confirmação ao utilizador.

Description

A Confirm função apresenta uma caixa de diálogo no topo do ecrã atual com dois botões: um botão de confirmar e um botão de cancelar . Em aplicações orientadas a modelos, estes botões indicam por defeito versões localizadas de "OK" e "Cancelar", respetivamente. Confirm também está disponível em aplicações canvas para mostrar um simples diálogo de confirmação e devolver um resultado booleano.

O utilizador deve escolher um dos botões antes de o diálogo ser encerrado. Além de selecionar o botão Cancelar, o diálogo pode ser dispensado através de gestos específicos da plataforma (como a tecla Esc ou clicar fora do diálogo). Nas aplicações canvas, este caminho de dispensa é tratado como nenhuma ação (ou seja, devolve blank).

Nota

Nas aplicações Canvas, a Confirm função utiliza o diálogo Fluent. Certifique-se de que os controlos modernos estão ativados; caso contrário, aparece o diálogo nativo do navegador.

Sintaxe

Confirm( Message [, 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. Veja abaixo as opções disponíveis.

Opções

Use o parâmetro OptionsRecord para personalizar o diálogo de confirmação:

Opção Description
ConfirmarButton O texto para ser exibido no botão de confirmação, substituindo o texto localizado predefinido "OK" ou "Confirm".
CancelarButton O texto para mostrar no botão de cancelar, substituindo o texto "Cancelar" localizado por defeito.
Cargo O texto para mostrar como título do diálogo. Exibido numa fonte maior e mais a negrito do que a mensagem. Pode ser truncado se for muito longo.
Subtítulo O texto para mostrar como legenda de diálogo. Exibido entre o título e a mensagem. Pode ser truncado se for muito longo.

Comportamento padrão

Etiquetas de botões: Se não forneceres etiquetas de botão personalizadas, Confirm usa texto de botão por defeito localizado:

  • Nas aplicações Canvas (pré-visualização), os valores predefinidos são "Confirm" e "Cancelar" (localizado).
  • Em aplicações orientadas a modelos, os valores predefinidos são "OK" e "Cancelar" (localizado).

Valor de devolução:Confirm retorna true se o utilizador selecionar o botão de confirmação, e false caso contrário.

Exemplos

Aplicações condicionadas por modelo

Confirmação simples antes de remover um registo

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

Exibe um diálogo de confirmação com os botões predefinidos. Se o utilizador selecionar o botão de confirmação, o registo é removido.

Confirmação com título personalizado

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

Adiciona um título ao diálogo de confirmação antes de remover um registo.

Etiquetas de botões personalizadas para preferência do utilizador

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

Usa etiquetas de botões personalizadas para captar uma preferência simples. O resultado é armazenado na variável FavColorglobal .

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

Apresenta uma mensagem modal que o utilizador deve reconhecer antes de continuar. O valor de devolução não é verificado.

Aplicações de tela

Confirm Antes de eliminar

Uso Confirm para evitar a eliminação acidental de registos:

// Button.OnSelect
If(
    Confirm(
        "Are you sure you want to delete this record?",
        {
            Title: "Delete confirmation",
            Subtitle: "This action can't be undone.",
            ConfirmButton: "Delete",
            CancelButton: "Cancel"
        }
    ),
    Remove(YourDataSource, Gallery1.Selected);
    Notify("Record deleted.", NotificationType.Success)
)

Exibe um diálogo de confirmação com título, legendas e etiquetas de botões personalizadas. O registo só é eliminado se o utilizador selecionar Eliminar.

Confirm antes de guardar um formulário

Use Confirm para validar a intenção do utilizador antes de submeter dados:

// Save button.OnSelect
If(
    Confirm(
        "Do you want to save these changes?",
        { Title: "Save changes" }
    ),
    SubmitForm(EditForm1);
    ResetForm(EditForm1);
    Notify("Changes saved successfully.", NotificationType.Success)
)

Exibe um diálogo de confirmação antes de submeter o formulário. O formulário só é submetido se o utilizador confirmar.

Armazenar resultado numa variável para múltiplas ações

Armazene o resultado de confirmação para usar em múltiplas operações a jusante:

// Button.OnSelect
Set(
    varConfirmed,
    Confirm("Do you want to proceed with this operation?")
);

If(
    varConfirmed,
    Notify("Processing your request...", NotificationType.Information);
    /* Additional operations */,
    Notify("Operation canceled.", NotificationType.Warning)
)

O resultado booleano é armazenado em varConfirmed e pode ser referenciado várias vezes para lógica condicional.

Personalização total com todas as opções

Mostre todas as opções de personalização disponíveis:

// Button.OnSelect
If(
    Confirm(
        "This is the main message that describes what the user needs to confirm.",
        {
            Title: "Action Required 🔔",
            Subtitle: "Please choose one of the options below.",
            ConfirmButton: "Yes, proceed",
            CancelButton: "No, cancel"
        }
    ),
    Notify("User confirmed!", NotificationType.Success),
    Notify("User canceled.", NotificationType.Warning)
)

Exibe um diálogo totalmente personalizado com título, legendas, mensagens e etiquetas de botões personalizadas.

FAQs

Posso esconder o botão Cancelar?

Não. O design atual mostra sempre tanto o Confirm botão como o botão Cancelar. Os utilizadores devem ter a capacidade de encerrar ou cancelar o diálogo.

Posso adicionar um terceiro botão ou mais de duas opções?

Não. Confirm Suporta exatamente duas opções: uma ação de confirmar e uma ação de cancelar. Para cenários que exigem múltiplas escolhas, considere usar um padrão de interface diferente, como um ecrã personalizado ou um controlo suspenso.

Bloqueia Confirm outras operações?

Yes. Confirm apresenta-se como um diálogo modal que o utilizador deve ignorar antes de poder interagir com outras partes da aplicação.

Consulte também

Notificar - Mostra uma mensagem de banner não modal no topo do ecrã que não exige rejeição do utilizador.

  • Last updated on