FormEvents.Submit Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o comando Enviar é usado na interface do usuário ou o Submit() método é usado.
public:
abstract event Microsoft::Office::InfoPath::SubmitEventHandler ^ Submit;public abstract event Microsoft.Office.InfoPath.SubmitEventHandler Submit;member this.Submit : Microsoft.Office.InfoPath.SubmitEventHandler Public MustOverride Custom Event Submit As SubmitEventHandler Tipo de evento
Exceções
O desenvolvedor tentou associar o evento em algum local diferente do método InternalStartup .
Exemplos
No exemplo a seguir, o manipulador de eventos do Submit evento é usado para impedir que o formulário seja enviado se o formulário não tiver sido salvo.
public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
if(this.Dirty || this.New)
MessageBox.Show("Please save this form before submitting it.");
e.CancelableArgs.Cancel = true;
else
e.CancelableArgs.Message = "Submit succeeded.";
}
Public Sub FormEvents_Submit(ByVal sender As Object, _
ByVal e As SubmitEventArgs)
If(Me.Dirty Or Me.New) Then
MessageBox.Show("Please save this form before submitting it.")
e.CancelableArgs.Cancel = True
Else
e.CancelableArgs.Message = "Submit succeeded."
End If
End Sub
Comentários
Importante: o Submit evento não deve ser instanciado pelo desenvolvedor no código de formulário. Você só deve adicionar manipuladores de eventos para eventos no nível do formulário na interface do usuário do modo de design do Microsoft InfoPath. Quando você adiciona um manipulador de eventos ao modelo de formulário da interface do usuário do modo de design, o InfoPath gera código no método InternalStartup do arquivo de código de formulário usando a EventManager classe e o FormEvents membro da classe para associar o evento ao manipulador de eventos. Para obter informações sobre como adicionar manipuladores de eventos no modo de design do InfoPath, consulte Como adicionar um manipulador de eventos.
O Submit evento será gerado somente se o modelo de formulário tiver a opção Executar ação personalizada usando a opção Código definida na caixa de diálogo Enviar Opções.
O Submit evento está vinculado usando o SubmitEventHandler delegado.
O Submit evento pode ser cancelado usando a CancelableArgs propriedade da MergeEventArgs classe para definir a propriedade Cancel como true.
Se o código do manipulador de eventos usar a CancelableArgs propriedade para definir as cadeias de caracteres das Message propriedades ou MessageDetails , mas a propriedade CancelableArgs.Cancel for deixada para a configuração padrão de false, uma mensagem de sucesso será exibida com o texto das propriedades Message e MessageDetails . Essa mensagem substituirá a caixa de diálogo Mostrar uma mensagem de sucesso ou falha e Sobre o sucesso das configurações de mensagem personalizadas na caixa de diálogo Opções de Envio de Formulários.
Da mesma forma, se o código do manipulador de eventos definir as cadeias de caracteres Message ou MessageDetails e definir CancelableArgs.Cancel como true, uma mensagem de falha será mostrada, a mensagem será exibida com o texto das propriedades Mensagem e MessageDetails, substituindo as configurações da caixa de diálogo Opções de Envio de Formulário.
Se o código do manipulador de eventos deixar as propriedades Message e MessageDetails no valor padrão de uma referência nula (Nada no Visual Basic), mas definir CancelableArgs.Cancel como true, a operação de envio será considerada com falha. Se uma mensagem de falha será mostrada e qual será a mensagem determinada pelas configurações na caixa de diálogo Enviar Opções.
Não é possível fazer chamadas para o Quit() método da Application classe no manipulador de Submit eventos.
This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.