PreviewPdfPasswordRequest Event

In This Topic

This event is raised if a password is required to decrypt the loaded PDF document for display. The event is explicitly raised when the PdfShowDialogForPassword property is set to false.

The event makes use of tunel routing strategy. Please check the corresponded GdViewer.PdfPasswordRequestEventArgs for given parameters.

You are allowed to prompt the user with your own dialog box for entering the password for protected PDF documents using this event.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Event PreviewPdfPasswordRequest As GdViewer.PreviewPdfPasswordRequestHandler

public event GdViewer.PreviewPdfPasswordRequestHandler PreviewPdfPasswordRequest

public event PreviewPdfPasswordRequest: GdViewer.PreviewPdfPasswordRequestHandler;

In JScript, you can handle the events defined by another class, but you cannot define your own.

public: __event GdViewer.PreviewPdfPasswordRequestHandler* PreviewPdfPasswordRequest

public:
event GdViewer.PreviewPdfPasswordRequestHandler^ PreviewPdfPasswordRequest

Event Data

The event handler receives an argument of type GdViewer.PdfPasswordRequestEventArgs containing data related to this event. The following GdViewer.PdfPasswordRequestEventArgs properties provide information specific to this event.

Property	Description
Handled	(Inherited from System.Windows.RoutedEventArgs)
OriginalSource	(Inherited from System.Windows.RoutedEventArgs)
Password	The password required to decrypt the loaded PDF document.
RoutedEvent	(Inherited from System.Windows.RoutedEventArgs)
Source	(Inherited from System.Windows.RoutedEventArgs)

Remarks

This event is only meaningful for PDF documents and it is solely raised only if the PdfShowDialogForPassword property is set to false.

Be aware that without entering the correct password the required PDF document will not display.

Example

Please follow the example for the PdfPasswordRequest event to motivate yourself on how to utilize this event in your GdViewer control.

Reference

GdViewer Class
GdViewer Members
GdViewer.PreviewPdfPasswordRequestHandler Delegate
GdViewer.PdfPasswordRequestEventArgs Class
PdfShowDialogForPassword Property
PdfGetEncryptionScheme Method