ArcObjects Library Reference (PublisherControls)  

IARControlEvents.OnAction Event

Fires when an action takes place.

[Visual Basic 6.0]
Event OnAction(
    ByVal action As esriARAction, _
    ByVal data As Variant, _
    suppressAction As Boolean _
) As Empty
[Visual Basic .NET]
Public Event OnAction As OnActionEventHandler
[C#]
public event OnActionEventHandler OnAction

Product Availability

Available with ArcGIS Desktop. Requires Publisher Extension.

Description

The OnAction event triggers before an action occurs with the ArcReaderControl, and provides you with a mechanism for suppressing the action from taking place or customising the action that will take place. For example, by default any hyperlinks that are accessed when the CurrentARTool is the esriARToolMapHyperlinks tool open in the systems default browser. You may want to suppress this default action and open the hyperlinks in a web browser control.

action indicates the type of action taking place.

data supplied as part of the action.

suppressAction specifies a boolean indicating whether the default action will be suppressed. By default the action will not be suppressed

Remarks

esriARActionMapProperties: Occurs when the user right clicks on a map in the Table of Contents (TOC) and chooses properties from the drop down context menu. The data passed to the event is an ARMap .

esriARActionLayerProperties: Occurs when the user right clicks on a layer in the Table of Contents (TOC) and chooses properties ffrom the drop down context menu. The data passed to the event is an ARLayer.

esriARActionHyperlink: Occurs when the user accesses a hyperlink, either through the CurrentARTool when it is set to the esriARToolMapHyperlink tool, or when accessing hyperlinks through the identify dialog when the CurrentARTool is the esriARToolMapIdentify tool. The data passed to the event is a string representing the URL of the hyperlink.

esriARActionIdentify: Occurs when the CurrentARTool is the esriARToolMapIdentify tool and is used on the CurrentView. The data passed to the event is an array or map coordinates. In the mouse down event of the tool, the array consists of an x and y coordinate. In the mouse up event of the tool, the array consists of the starting x and y coordinates and the finishing x and y coordinates. These four coordinates will be different is the user has tracked a rectangle with the tool. If the user has clicked a point these coordinates will be duplicated. 

See Also

IARControlEvents Interface