RegionSelected Event

In This Topic

This event is raised when a highlighted region has been selected by a user using the mouse.

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

Highlighted regions for currently displayed document are identified and created when searching text, for example using the SearchText(String,Int32,Boolean) method or the second similar overloaded method as well. You can also define highlighted regions directly using the AddRegion(String,Double,Double,Double,Double,Color,RegionFillMode) method.

Syntax

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

'Declaration
 
Public Event RegionSelected As GdViewer.RegionSelectedHandler

public event GdViewer.RegionSelectedHandler RegionSelected

public event RegionSelected: GdViewer.RegionSelectedHandler;

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

public: __event GdViewer.RegionSelectedHandler* RegionSelected

public:
event GdViewer.RegionSelectedHandler^ RegionSelected

Event Data

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

Property	Description
Handled	(Inherited from System.Windows.RoutedEventArgs)
OriginalSource	(Inherited from System.Windows.RoutedEventArgs)
RegionID	The unique region identifier of the highlighted region selected by a user.
RoutedEvent	(Inherited from System.Windows.RoutedEventArgs)
Source	(Inherited from System.Windows.RoutedEventArgs)

Remarks

Be aware that the RegionsAreEditable property needs to be turned on to enable the region selection.

Example

How to utilize this event in your GdViewer control.

VB.NET
C#

'We assume that the GdViewer1 control has been properly integrated
'and the RegionSelected event has been properly added.
            
'Define the event.
Sub GdViewer1_RegionSelected(ByVal sender As Object, ByVal e As GdPicture14.WPF.GdViewer.RegionSelectedEventArgs)
    'Do your stuff here.
End Sub

//We assume that the GdViewer1 control has been properly integrated
//and the RegionSelected event has been properly added.
            
//Define the event.
void GdViewer1_RegionSelected(object sender, GdPicture14.WPF.GdViewer.RegionSelectedEventArgs e)
{
    //Do your stuff here.
}

Reference

GdViewer Class
GdViewer Members
GdViewer.RegionSelectedHandler Delegate
GdViewer.RegionSelectedEventArgs Class
PreviewRegionSelected Event
RegionEdited Event
PreviewRegionEdited Event
RegionsAreEditable Property