Compartilhar via


Classe CUserException

Lançada para interromper uma operação de usuário participante.

class CUserException : public CSimpleException

Comentários

Use CUserException Quando você deseja usar o mecanismo de exceção throw/catch para exceções específicas do aplicativo. "O usuário"no nome de classe pode ser interpretado sistema autônomo"o usuário fez alguma coisa excepcional que preciso manipular."

A CUserException geralmente é lançada após chamar a função global AfxMessageBox para notificar o usuário que uma operação falhou. Quando você escrever um manipulador de exceção, trata a exceção, especialmente, já que o usuário normalmente foi já notificado da falha.A estrutura lança essa exceção em alguns casos.Lançar um CUserException Você mesmo, alertar o usuário e, em seguida, chamar a função global AfxThrowUserException.

No exemplo a seguir, uma função que contém as operações que podem falhar alerta o usuário e lança um CUserException. A função chamada captura a exceção e manipula-lo:

void DoSomeOperation()
{
   // Processing
   // If something goes wrong...
   AfxMessageBox(_T("The x operation failed"));
   AfxThrowUserException();
}

BOOL TrySomething()
{
   try
   {
      // Could throw a CUserException or other exception.
      DoSomeOperation(); 
   }
   catch(CUserException* pe)
   {
      pe->Delete();
      return FALSE;    // User already notified.
   }
   catch(CException* pe)
   {
      // For other exception types, notify user here.
      pe->ReportError();
      return FALSE;
   }
   return TRUE;   // No exception thrown.
}

Para obter mais informações sobre como usar CUserException, consulte o artigo (MFC) de manipulação de exceções.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Gráfico de hierarquia

Classe CException

AfxMessageBox

AfxThrowUserException

Outros recursos

CException membros