| Visual Basic (Declaration) | |
|---|---|
Public Delegate Sub View3D.DrawOpenGLFinishEventHandler( _ ByVal sender As Object, _ ByVal e As EventArgs _ ) | |
| Visual Basic (Usage) | Copy Code |
|---|---|
| |
Parameters
- sender
- A reference to the View3D, the source of the event.
- e
- An EventArgs object that contains the event data.
The DrawOpenGLFinish event occurs after ArcGIS Explorer has finished drawing the globe to the View3D, at which point you can use OpenGL functions to perform addional drawing to the view.
When you create a DrawOpenGLFinishEventHandler delegate, you identify a method in your code which will be called once ArcGIS Explorer has finished drawing the globe. It is within this identified method that you can perform custom drawing.
To associate the DrawOpenGLFinish event with your event handler method, add an instance of the delegate to the event; the event handler will then be called whenever the event fires. To stop the event handler being called, remove the delegate from the event. See the topic How to add event handlers for custom drawing for more information.
Ensure delegates are not garbage collected incorrectly by declaring them as member variables of the TaskUI or Task control class (or the View3D class as a member variable). This ensures that the delegates do not go out of scope and get garbage collected, guaranteeing the event handler will be called throughout the lifetime of your task.
This event does not currently pass any custom event data in the EventArgs parameter.
For more information about custom drawing, see the DrawOpenGLFinish event, the Custom Drawing Sample and Custom Drawing in ArcGIS Explorer help topic. For more information about event-handler delegates, see the How to add event handlers for custom drawing topic, and also MSDN topics about Events and Delegates.
Requirements
Namespace: ESRI.ArcGIS.E2API
Platforms: Windows 2000 Professional, Windows XP Home Edition, Windows XP Professional Edition, Windows 2003 Server Terminal Services
Assembly: ESRI.ArcGIS.E2API (in ESRI.ArcGIS.E2API.dll)