ITE3DWindowEx

In addition to the regular TE3DWindow (which can only be embedded once in an application), the client can create one or more external TE3DWindowEx objects in the same application. The ITE3DWindowEx interface provides control over the 3D window elements of each of the TE3DWindowEx windows. See “In-Process vs. Out-of-Process ActiveX Controls” in this chapter for more information.

 

	Properties
	BorderStyle	Gets and sets the border style surrounding the 3D Window.
	Caption	Gets and sets the text displayed in the title bar of messages issued by the object.
	Text	Reserved. Currently not used.
	Methods
	CreateInstance	Creates an SGWorld instance.

BorderStyle

Gets and sets the border style surrounding the 3D Window. The value is a number between 0 and 4, according to the following options.

§   0 = None

§   1 = Solid

§   2 = Three-dimensional border style

§   3 = Border with a sunken edge

§   4 = Double border

 

JavaScript
BorderStyle

 

C#
int BorderStyle { get; set; }

 

C++
HRESULT BorderStyle([in] long pstyle) HRESULT BorderStyle([out, retval] long* pstyle)

Caption

Gets and sets the text displayed in the title bar of messages issued by the object.

 

JavaScript
Caption

 

C#
string Caption { get; set; }

 

C++
HRESULT Caption([in] BSTR pstrCaption) HRESULT Caption([out, retval] BSTR* pstrCaption)

CreateInstance

This method is used to create an object, generally an SGWorld80 instance, from a specific 3D Window. When using the ITE3DWindowEx interface to create multiple TE3DWindowEx objects in the same application, a specific SGWorld instance can be created using the CreateInstance method for each of the 3D windows. Each SGWorld instance can then load a different Fly file so that each window displays distinct content.

Example in C#:

SGWorld80 globe = (SGWorld80)axTE3DWindowEx1.CreateInstance("TerraExplorerX.SGWorld80");

 

JavaScript
CreateInstance(        ProgID)

 

C#
dynamic CreateInstance(        string ProgID)

 

C++
HRESULT CreateInstance(        BSTR ProgID,        IUnknown** ppUnk)

Parameters

ProgID

This parameter can be either of the following values:

·          ProgID of the desired object we want to create (e.g. “TerraExplorerX.SGWorld80”)

·          CLSID of the desired object (e.g. “{3A4F91A0-65A8-11D5-85C1-0001023952C1}”).

Return Value

ppUnk

A pointer to the newly created object after the call returns successfully.

Exceptions

See: HRESULT Return Values for a list of possible values returned by the HRESULT.