PdfViewerControl.ExceptionMessage Event
Allows you to handle exceptions that may raise during various actions on the PDF Viewer.
Namespace: DevExpress.Xpf.PdfViewer
Assembly: DevExpress.Xpf.PdfViewer.v24.2.dll
NuGet Package: DevExpress.Wpf.PdfViewer
#Declaration
public event ExceptionMessageEventHandler ExceptionMessage
#Event Data
The ExceptionMessage event's data class is ExceptionMessageEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Exception | Gets the exception that caused the event. |
Handled |
Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Inherited from Routed |
Message | Gets or sets an error description displayed within an error message box. |
Message |
Gets or sets an action to be performed when the Pdf |
Message |
Gets or sets the icon displayed in the message box. |
Message |
Gets the origin of an exception message. |
Original |
Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
Inherited from Routed |
Routed |
Gets or sets the Routed |
Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
The event data class exposes the following methods:
Method | Description |
---|---|
Invoke |
When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation.
Inherited from Routed |
On |
When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.
Inherited from Routed |
#Remarks
Exceptions may be raised, for example, when you open/save a PDF document or import/export interactive form data. When an exception is caught, a message box is shown. You can handle the ExceptionMessage event to change this behavior. For instance, you can use the ExceptionMessageEventArgs.MessageAction property to suppress the notification or re-raise the exception.
Warning
The Exception
event is not raised in the following cases:
- When a document is loaded in code behind (i.
e. with the PdfViewer method call);Control. Open Document - When the Pdf
Viewer is set toControl. Async Document Load false
, and the exception occurs on the DocumentViewer method call.Control. Document Source