Partilhar via


openConfirmDialog (referência da API do cliente)

Exibe uma caixa de diálogo de confirmação contendo uma mensagem e dois botões.

Sintaxe

Xrm.Navigation.openConfirmDialog(confirmStrings,confirmOptions).then(successCallback,errorCallback);

Parâmetros

Observação

Com a nova aparência ativada, a altura da caixa de diálogo será redimensionada automaticamente se você não definir o valor da altura das opções de diálogo.

Nome Tipo Obrigatório Description
confirmStrings Objeto Yes As cadeias de caracteres a serem usadas na caixa de diálogo de confirmação. O objeto contém os seguintes valores:
- cancelButtonLabel: (Opcional) String. O rótulo do botão cancelar. Se você não especificar o rótulo do botão cancelar, Cancelar será usado como o rótulo do botão.
- confirmButtonLabel: (Opcional) String. O rótulo do botão de confirmação. Se você não especificar o rótulo do botão de confirmação, OK será usado como o rótulo do botão.
- subtitle: (Opcional) String. A legenda a ser exibida na caixa de diálogo de confirmação.
- text: String. A mensagem a ser exibida na caixa de diálogo de confirmação.
- title: (Opcional) String. O título a ser exibido na caixa de diálogo de confirmação.
confirmOptions Objeto Não As opções de altura e largura para a caixa de diálogo de confirmação. O objeto contém os seguintes valores:
- height: Número (opcional). Altura da caixa de diálogo de confirmação em pixels.
- width: Número (opcional). Largura da caixa de diálogo de confirmação em pixels.

Com a nova aparência ativada, a altura da caixa de diálogo é redimensionada automaticamente se você não definir o valor da altura das opções da caixa de diálogo.
successCallback função Não Uma função a ser executada quando a caixa de diálogo de confirmação é fechada clicando em confirmar, cancelar ou X no canto superior direito da caixa de diálogo. Um objeto com o atributo confirmado (Booleano) é passado que indica se o botão de confirmação foi clicado para fechar a caixa de diálogo.
errorCallback função Não Uma função a ser executada quando a operação falha.

Example

O exemplo de código a seguir exibe uma caixa de diálogo de confirmação. A mensagem apropriada é registrada no console dependendo se confirmar ou cancelar/X foi clicado para fechar a caixa de diálogo.

var confirmStrings = { text:"This is a confirmation.", title:"Confirmation Dialog" };
var confirmOptions = { height: 200, width: 450 };
Xrm.Navigation.openConfirmDialog(confirmStrings, confirmOptions).then(
function (success) {    
    if (success.confirmed)
        console.log("Dialog closed using OK button.");
    else
        console.log("Dialog closed using Cancel button or X.");
});

Xrm.Navegação