Compartilhar via

Controle Dialog (experimental)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Um controle usado para agrupar conteúdo.

Controle Dialog.

Importante

  • Este é um recurso experimental.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Description

Uma caixa de diálogo (Dialog) é uma janela pop-up temporária que tira o foco da página ou do aplicativo e exige que as pessoas interajam com ele. É usada principalmente para confirmar ações, como excluir um arquivo ou pedir que as pessoas façam uma escolha.

Este componente de tela imita o estilo e o comportamento do controle Dialog da Interface do Usuário. Consulte a documentação para obter as práticas recomendadas.

Exibir o componente no repositório GitHub do Kit do Criador.

Propriedades

Principais propriedades

Propriedade Description
Buttons Um conjunto de dados que define os botões (saiba mais em Propriedades do botão).
Title Texto exibido na seção de título.
OverlayColor Cor exibida na área de sobreposição.
DialogWidth A largura da caixa de diálogo (não deve ser confundida com a largura do controle, que deve abranger a largura do aplicativo).
DialogHeight A altura da caixa de diálogo (não deve ser confundida com a altura do controle, que deve abranger a altura do aplicativo).
SubTitle Texto exibido sob o título.

Propriedades do Botão

Propriedade Description
Label O rótulo exibido no botão.
ButtonType Enumeração que determina o estilo do botão. Escolha entre Standard e Primary. 
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Propriedades de estilo

Propriedade Description
Theme O objeto do tema. Saiba mais sobre o tema.

Saiba mais sobre formatação na seção Conteúdo do painel Formatar do Painel.

Propriedades do evento

Propriedade Description
OnCloseSelect Expressão de ação executada quando o botão Fechar é selecionado.
OnButtonSelect Expressão de ação executada quando um dos botões de ação é selecionado.

Comportamental

Configurar a visibilidade do Dialog

Torne visível o próprio controle Dialog (ou a superfície em que está localizado) quando uma variável do tipo booliano (verdadeiro/falso) mudar para verdadeiro. Atribua essa variável à propriedade visibilidade da caixa de diálogo. Para ocultar a caixa de diálogo depois que ela for exibida, atualize a variável na propriedade de redefinição, que é acionada quando o ícone fechar for selecionado.

Veja a seguir a fórmula do Power Fx para abrir o controle dialog em uma fórmula de ação em outro componente em algum lugar do aplicativo (por exemplo, a propriedade OnSelect de um botão):

UpdateContext({ showHideDialog: true })

Veja a seguir a fórmula do Power Fx para fechar o controle dialog na propriedade OnCloseSelect do controle dialog:

UpdateContext({ showHideDialog: false })

Atribua a variável à propriedade Visible do diálogo:

showHideDialog

Configurar ações do botão

Na propriedade OnButtonSelect do diálogo, forneça ações em uma condição If() ou Switch() com base no valor de texto Self.SelectedButton.Label para definir a ação. Dependendo da ação, poderá fazer sentido também fechar o diálogo após a conclusão da ação.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

Limitações

Esse componente de tela só pode ser usado em aplicativos de tela e páginas personalizadas.

  • Last updated on