Compartilhar via


openConfirmDialog (referência da API do cliente)

Exibe uma caixa de diálogo de confirmação que contém uma mensagem e dois botões.

Sintaxe

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

Parâmetros

Observação

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

Nome Tipo Obrigatório Description
confirmStrings Object 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) Cadeia de caracteres. 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) Cadeia de caracteres. O rótulo do botão confirmar. Se você não especificar o rótulo do botão confirmar, OK será usado como o rótulo do botão.
- subtitle: (Opcional) Cadeia de caracteres. O subtítulo a ser exibido na caixa de diálogo de confirmação.
- text:Corda. A mensagem a ser exibida na caixa de diálogo de confirmação.
- title: (Opcional) Cadeia de caracteres. O título a ser exibido na caixa de diálogo de confirmação.
confirmOptions Object Não As opções de altura e largura da caixa de diálogo de confirmação. O objeto contém os seguintes valores:
- height: (Opcional) Número. Altura da caixa de diálogo de confirmação em pixels.
- width: (Opcional) Número. Largura da caixa de diálogo de confirmação em pixels.

Com a nova aparência habilitada, a altura da caixa de diálogo será redimensionada automaticamente se você não definir o valor de altura das opções de 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 na confirmação, cancelamento ou X no canto superior direito da caixa de diálogo. Um objeto com o atributo booliano confirmado é passado que indica se o botão confirmar foi clicado para fechar a caixa de diálogo.
errorCallback função Não Uma função a ser executada quando a operação falhar.

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 confirme ou cancele/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.Navigation