This document is archived and information here might be outdated.  Recommended version.


IGlobeControlDefault Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Controls > ESRI ArcGIS Controls > Interfaces > IG > IGlobeControlDefault Interface
ArcGIS Developer Help

IGlobeControlDefault Interface

Provides access to members that control the GlobeControl.

Product Availability

Available with ArcGIS Engine.

Description

The IGlobeControlDefault interface is the default dispatch interface that most development environments will automatically expose. For example, placing the GlobeControl in a container will typically generate an object called GlobeControl1. The properties and methods available directly on this object correspond to this interface, together with container specific properties and methods.

The IGlobeControlDefault interface is a 'pure' dispatch interface, so can be extended with new properties and methods at future releases of ArcGIS. The methods and properties are identical to the highest numbered main interface on the GlobeControl. For example, IGlobeControlDefault is equivalent to IGlobeControl, but at future releases this could become IGlobeControl2. By using the IGlobeControlDefault interface you are guaranteed to always have access to the latest GlobeControl. 

There is a small performance overhead in making calls through to a pure dispatch interface, but to avoid this you can QI to a specific interface. In some development environments it is not possible to QI directly on the control to other COM interfaces, because the control is contained within a wrapper object. Use the Object property to get the real control before performing the QI.

Members

Name Description
Method AboutBox Displays a dialog of information about the GlobeControl.
Read/write property Appearance The appearance of the GlobeControl.
Read/write property BackColor Background color of the GlobeControl.
Read/write property BorderStyle The border style of the GlobeControl.
Method Check3dFile Checks if a filename is a Globe document.
Read/write property CurrentTool Current active tool for the GlobeControl. Set to nothing to clear the tool.
Read/write property CustomProperty A property to associate data with a control.
Read/write property DocumentFilename The filename of the last globe document loaded into the control.
Read/write property Enabled Indicates whether the GlobeControl can respond to user generated events.
Read-only property Globe The Globe object associated with the GlobeControl.
Read/write property GlobeCamera The GlobeCamera object associated with the GlobeControl.
Read/write property GlobeDisplay The GlobeDisplay object associated with the GlobeControl.
Read-only property GlobeViewer The GlobeViewer associated with the GlobeControl.
Read-only property hWnd Handle to the window associated with the GlobeControl.
Read/write property KeyIntercept A property that specifies interception of key strokes that are normally handled by the container. When intercepted the OnKeyDown and OnKeyUp events will be called. This value can be a combined bit mask of esriKeyIntercept enum values.
Method Load3dFile Loads a Globe document into the GlobeControl.
Read/write property MouseIcon Custom mouse icon used if MousePointer is 99.
Read/write property MousePointer The mouse pointer displayed over the GlobeControl.
Read/write property Navigate Indicates if the GlobeControl performs default scene navigation in response to mouse events.
Read-only property Object A property that returns the underlying control. This can be used when the control is inside a wrapper object that has been added by a development environment.
Read/write property OverrideBackColor Indicates whether to override the background color of the globe document.
Read/write property ShowGlobeTips Indicates the type of globe tips that are shown.
Read/write property TipDelay The delay before globe tips are shown.
Read/write property TipStyle The style of globe tips.

Classes that implement IGlobeControlDefault

Classes Description
GlobeControl Esri GlobeControl
[C#]

When querying interface to IGlobeControlDefault in Visual Basic .NET or Visual C# .NET the Object property or container specific code must be used. This is because .NET contains the real control inside a wrapper object known as an host.

IGlobeControlDefault globeControl = axGlobeControl1.Object as IGlobeControlDefault;

[Visual Basic .NET]

When querying interface to IGlobeControlDefault in Visual Basic .NET or Visual C# .NET the Object property or container specific code must be used. This is because .NET contains the real control inside a wrapper object known as an host.

Dim globeControl As IGlobeControlDefault = AxGlobeControl1.Object