|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IARGlobeControlDefault
Provides access to members on the control.
The IARGlobeControlDefault interface is the default dispatch interface that most development environments will automatically expose. For example, placing the ArcReaderGlobeControl in a container will typically generate an object called ArcReaderGlobeControl1. The properties and methods available directly on this object correspond to this interface, together with container specific properties and methods.
The IARGlobeControlDefault interface is a 'pure' dispatch interface, so can be extended with new properties and methods at future releases of ArcGIS. The methods and properteis are identical to the highest numbered main interface on the ArcReaderGlobeControl. For example, IARGlobeControlDefault is equivalent to IARGlobeControl, but at future releases this could become IARGlobeControl2. By using the IARGlobeControlDefault interface you are guaranteed to always have access to the latest ArcReaderGlobeControl.
There is a small performance overhead in making calls through to a pure dispatch interface, but to avoild 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.
Method Summary | |
---|---|
void |
aboutBox()
Displays a dialog of information about the control. |
boolean |
checkDocument(String sFilename)
Checks the document filename to determine if its a valid Published Map File (*.PMF), published with permission to load into the control. |
void |
copyViewToClipboard()
Copies the current map or page layout view to the clipboard. |
boolean |
esri_isEnabled()
Indicates whether the control can respond to user generated events. |
void |
esri_setEnabled(boolean rhs1)
Indicates whether the control can respond to user generated events. |
void |
exportView(int format,
String sFilename)
Exports the current view to a file. |
int |
getAppearance()
The appearance of the control. |
IARConfiguration |
getARConfiguration()
The ARConfiguration used by the control. |
IARGlobe |
getARGlobe()
The ARGlobe container for the display of globe data. |
IARUnitConverter |
getARUnitConverter()
The ARUnitConverter contained by the control. |
int |
getBorderStyle()
The border style of the control. |
int |
getCurrentARGlobeTool()
Current active tool for the control. |
int |
getCurrentGlobeViewType()
The type of current globe view. |
Object |
getCustomProperty()
A property to associate data with a control. |
String |
getDocumentComment()
A comment about the currently loaded Published Map File (*.PMF). |
String |
getDocumentFilename()
The file name of the currently loaded Published Map File (*.PMF). |
int |
getHWnd()
Handle to the window associated with the control. |
int |
getMousePointer()
The mouse cursor displayed over the GlobeControl. |
Object |
getObject()
A property that returns the underlying Control. |
IARLayer |
getSelectedARLayer()
The selected ARLayer in the TOC. |
int |
getShowGlobeTips()
Indicates the type of tooltips shown on the Globe. |
IARLayer |
getSwipeLayer()
The swipe layer used by the control. |
int |
getTOCWidth()
The width of the Table of Contents (TOC) in pixels. |
int |
getViewHeight()
The height of the Globe View in pixels. |
int |
getViewLeft()
The number of pixels between the top of the control and the top of the Globe View. |
int |
getViewTop()
The number of pixels between the left edge of the control and the left side of the Globe View. |
int |
getViewWidth()
The width of the Globe View in pixels. |
int |
getViewWindow()
Handle to the view window associated with the control. |
boolean |
hasDocumentPermission(int docPermission)
Indicates if the currently loaded Published Map File (*.PMF) was published with the specified permission. |
boolean |
isARGlobeWindowVisible(int win)
Indicates if the specified control window is visible. |
boolean |
isEnableFileDrop()
Indicates whether Published Map Files can be dropped onto the control. |
boolean |
isHasCustomARConfiguration()
Indicates whether the current PMF is using settings stored in the PMF. |
boolean |
isTOCVisible()
Indicates if the Table of Contents (TOC) is visible. |
void |
loadDocument(String sFilename,
String sPassword)
Loads the Published Map File (*.PMF) into the control. |
void |
printView()
Send the current map or page layout view to the printer. |
void |
refresh()
Redraws the globe display area. |
void |
reloadDocument(String sPassword)
Reloads the currently loaded Published Map File (*.PMF) back into the control. |
void |
setAppearance(int rhs1)
The appearance of the control. |
void |
setARConfigurationByRef(IARConfiguration rhs1)
The ARConfiguration used by the control. |
void |
setBorderStyle(int rhs1)
The border style of the control. |
void |
setCurrentARGlobeTool(int rhs1)
Current active tool for the control. |
void |
setCustomProperty(Object rhs1)
A property to associate data with a control. |
void |
setDocumentFilename(String rhs1)
The file name of the currently loaded Published Map File (*.PMF). |
void |
setEnableFileDrop(boolean rhs1)
Indicates whether Published Map Files can be dropped onto the control. |
void |
setMousePointer(int rhs1)
The mouse cursor displayed over the GlobeControl. |
void |
setShowGlobeTips(int rhs1)
Indicates the type of tooltips shown on the Globe. |
void |
setSwipeLayerByRef(IARLayer rhs1)
The swipe layer used by the control. |
void |
setTOCVisible(boolean rhs1)
Indicates if the Table of Contents (TOC) is visible. |
void |
setTOCWidth(int rhs1)
The width of the Table of Contents (TOC) in pixels. |
void |
showARGlobeWindow(int win,
boolean show,
Object data)
Shows or hides the specified control window. |
void |
unloadDocument()
Unloads the currently loaded Published Map File (*.PMF) from the control. |
Method Detail |
---|
void setBorderStyle(int rhs1) throws IOException, AutomationException
rhs1
- A com.esri.arcgis.controls.esriARBorderStyle constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getBorderStyle() throws IOException, AutomationException
Returns or sets the border style of an ArcReaderGlobeControl. By default a border is drawn.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void esri_setEnabled(boolean rhs1) throws IOException, AutomationException
rhs1
- The rhs1 (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean esri_isEnabled() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setAppearance(int rhs1) throws IOException, AutomationException
rhs1
- A com.esri.arcgis.controls.esriARAppearance constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getAppearance() throws IOException, AutomationException
Returns or sets the paint style of the ArcReaderGlobeControl to either Flat or 3D. By default the appearance is flat.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void aboutBox() throws IOException, AutomationException
The AboutBox method causes a modal dialog box to display on top of the ArcReaderGlobeControl, containing information about the version and creation date of the ArcReaderGlobeControl as well as listing relevant legal and copyright information from ESRI.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void loadDocument(String sFilename, String sPassword) throws IOException, AutomationException
Loads the specified Published Map File (*.pmf) into the ArcReaderGlobeControl. Use the CheckDocument method to determine if the specified Published Map File can be loaded successfully.
If a document was password protected when it was published and the password is not passed within the LoadDocument method, the user will be prompted automatically for a password. If an incorrect password is supplied twice in succession a custom error will be returned.
If a document is successfully loaded the CurrentARGlobeTool will be set. The default CurrentARGlobeTool is specified by the ‘DefaultGlobeTool’ setting in the ARConfiguration. The DocumentFilename property will update itself with the path and filename of the currently loaded document, and the DocumentComment property to update itself with any comments that were supplied by the publisher of the document.
sFilename
- The sFilename (in)sPassword
- The sPassword (in, optional, pass if not required)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void unloadDocument() throws IOException, AutomationException
The UnloadDocument method removes the currently loaded PMF document from the ArcReaderGlobeControl and causes the DocumentFilename property to update itself with an empty string. At this point the ArcReaderGlobeControl is empty.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void reloadDocument(String sPassword) throws IOException, AutomationException
The ReloadDocument method loads the currently loaded Published Map File back into the ArcReaderGlobeControl. This resets the ArcReaderGlobeControl to the state of the Published Map File on disk, resetting the view, the extent of the view and layer visibility.
If a document was password protected when it was published and the password is not passed within the LoadDocument method, the user will be prompted automatically for a password. If an incorrect password is supplied twice in succession a custom error will be returned.
sPassword
- The sPassword (in, optional, pass if not required)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getDocumentComment() throws IOException, AutomationException
Returns any comments that were specified when the currently loaded document was published.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getDocumentFilename() throws IOException, AutomationException
Returns the file name of the currently loaded document.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setDocumentFilename(String rhs1) throws IOException, AutomationException
rhs1
- The rhs1 (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean checkDocument(String sFilename) throws IOException, AutomationException
Determines whether the specified Published Map File (*.pmf) is a valid file and was published with permission to load into the ArcReaderGlobeControl.
sFilename
- The sFilename (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setTOCWidth(int rhs1) throws IOException, AutomationException
rhs1
- The rhs1 (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getTOCWidth() throws IOException, AutomationException
The width of the Table of Contents (TOC) in pixels. By default the TOCWidth property is set to 180. The minimum value that can be set to the TOCWidth property is 4.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void printView() throws IOException, AutomationException
Sends the view to either the system default printer or the last printer selected in either the esriARGlobeWindowsPageSetup or esriARGlobeWindowsPrinter window.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void copyViewToClipboard() throws IOException, AutomationException
Copies a bitmap of the view to the system clipboard so that it can be copied into other applications. The output will exactly reflect the state of the view as seen on the screen.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void exportView(int format, String sFilename) throws IOException, AutomationException
Export the current view of the globe to a file.
format
- A com.esri.arcgis.controls.esriARExportFormat constant (in)sFilename
- The sFilename (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setTOCVisible(boolean rhs1) throws IOException, AutomationException
rhs1
- The rhs1 (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isTOCVisible() throws IOException, AutomationException
Indicates if the Table of Contents (TOC) is visible.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getHWnd() throws IOException, AutomationException
The operating environment identifies each window, form and control in an application by assigning it a handle, or hWnd.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setShowGlobeTips(int rhs1) throws IOException, AutomationException
rhs1
- A com.esri.arcgis.controls.esriARGlobeTips constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getShowGlobeTips() throws IOException, AutomationException
Determines whether globe tips are displayed (if they exist) as the mouse moves over layer features. Globe tips will be present if they were present in the ArcGlobe document at the time of publishing. By default the ShowGlobeTips property is set to true.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setEnableFileDrop(boolean rhs1) throws IOException, AutomationException
rhs1
- The rhs1 (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isEnableFileDrop() throws IOException, AutomationException
Indicates if the ArcReaderGlobeControl will load Published Map Files (*.pmf) by the user interactively dropping files onto the ArcReaderGlobeControl from other applications such as ArcCatalog or Windows Explorer. The ArcReaderGlobeControl itself will determine if the file that has been dropped is a PMF document that can be loaded into the ArcReaderGlobeControl.
By default dragging a file over the ArcReaderGlobeControl will cause the mouse cursor to change to an ‘add data’ cursor. Setting the EnableFileDrop property to False, will cause the mouse cursor to change to a ‘no entry’ cursor when files are dragged over the ArcReaderGlobeControl.
If a document is successfully loaded the CurrentARGlobeTool will be set. The default CurrentARGlobeTool is specified by the ‘DefaultGlobeTool’ setting in the ARConfiguration. The DocumentFilename property will update itself with the path and filename of the currently loaded document, and the DocumentComment property to update itself with any comments that were supplied by the publisher of the document.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getCurrentARGlobeTool() throws IOException, AutomationException
The CurrentTool used to interact with the ARGlobe. Setting the CurrentARGlobeTool will change the mouse cursor and may popup a modeless dialog. For example, setting the current tool to the built in identify tool will cause the identify dialog to open. The CurrentARGlobeTool cannot be set to Nothing, instead set the CurrentARGlobeTool to the NoneSelected tool.
Tool | Description |
---|---|
esriARGlobeToolNoneSelected | Use this tool if you want nothing to happen when the user interacts with the ARGlobe. |
esriARGlobeToolNavigate | Use this tool to navigate the ARGlobe. Activating the tool will set ARGlobe::Pitch = 0. Using the left mouse button the tool allows the user to rotate the globe about its center. Using the right mouse button the tool allows the user to zoom in and out along an imaginary straight line from the observer location to the ARGlobe center. |
esriARGlobeToolTarget | Use this tool to center a location, on the ARGlobe surface, in the view. |
esriARGlobeToolZoomInOut | Use this tool to Zoom In and Zoom Out along an imaginary straight line between the observer location and the target on the ARGlobe surface. |
esriARGlobeToolPan | Use this tool to pan the ARGlobe surface. Depress the mouse and drag the view in a particular direction, before releasing the mouse, to pan. |
esriARGlobeToolPivot | Use this tool to view the point on the ARGlobe surface that is centered in the view. Using the left mouse button the tool allows the user to pivot about a point on the ARGlobe surface that is located at the center of the view. Using the right mouse button the tool allows the user to Zoom In and Zoom Out along an imaginary straight line between the observer location and the center of the view. Activating this tool will set the ARGlobe::Pitch to a none zero value. |
esriARGlobeToolIdentify, esriARGlobeToolIdentifyUsingLayer | Use these tools to identify features in the ARGlobe. Click on a single feature to view its attribute information. The window has its own context menus; incorporates a raster viewer; and can display hyperlinks. |
esriARGlobeToolMeasure | Use this tool to measure distances on the ARGlobe. Measurements are given in IARGlobe::GlobeUnits. |
esriARGlobeToolSwipe | Use this tool to view the layer beneath the ArcReaderGlobeControl::SwipeLayer. |
esriARGlobeToolHyperlink | Use this tool to access any hyperlinks present in the data. |
esriARGlobeToolOrbitalFly |
Use this tool to fly over the ARGlobe surface at a fixed elevation. Activating this tool will display a dialog with buttons that allow a user to control flight. The dialog will be displayed within the ArcReaderGlobeControl, as specified by the window position property, accessed via the ArcReaderGlobeControl property pages. |
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setCurrentARGlobeTool(int rhs1) throws IOException, AutomationException
rhs1
- A com.esri.arcgis.controls.esriARGlobeTool constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setARConfigurationByRef(IARConfiguration rhs1) throws IOException, AutomationException
rhs1
- A reference to a com.esri.arcgis.controls.IARConfiguration (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IARConfiguration getARConfiguration() throws IOException, AutomationException
This is the ARConfiguration object contained within the ArcReaderGlobeControl. It is a helper object for customising the appearance and behaviour of the ArcReaderGlobeControl. It consists of many property and value settings that are stored in a template file (.art), known as an ‘ArcReader Template’.
There are various ways to manage these property and value settings:
In order for the ArcReaderGlobeControl to update itself to match any updated settings the ARConfiguration object must be set back into the ArcReaderGlobeControl.
The ArcReaderGlobeControl will initially look for an template
file in a users local profile. If no template file is
found a default configuration file will be created containing
default settings. The contents of the ARConfiguration can be stored
in a template file in the current user profile and used as an
initialization or "INI" file. The ArcReader desktop application
does this using a
file called ArcReader.art. It is recommended not to reuse this file
as it may break the ArcReader desktop application.
Instead, use a location such as:
User profile\Application Data\CompanyName\ProductName\Templates\FileName.art
Once a template has been saved it can be loaded into the ArcReaderGlobeControl to suit a particular user or application. For example, a user may have a preference about the window position of the magnifier window and whether the table of contents is displayed. When the ArcReaderGlobeControl exits (typically when the form or container is closed) the value of these settings is updated back into the ARConfiguration. Additional custom settings can be added to the ARConfiguration, to store user preferences specific to the custom application.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void showARGlobeWindow(int win, boolean show, Object data) throws IOException, AutomationException
The ShowARGlobeWindow shows or hides the specified built in window. By default all of the esriARGlobeWindows are closed. Before using the ShowARGlobeWindow method make one or all of the following checks:
A modal window requires a response from the user, before they can interact with another part of the application. A modeless window will stay on the screen, available for use, but allow the user to interact with other parts of the application. When the LoadDocument or ReloadDocument methods are used, any modeless windows will be automatically closed.
win
- A com.esri.arcgis.controls.esriARGlobeWindows constant (in)show
- The show (in, optional, pass true if not required)data
- A Variant (in, optional, pass null if not required)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isARGlobeWindowVisible(int win) throws IOException, AutomationException
win
- A com.esri.arcgis.controls.esriARGlobeWindows constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean hasDocumentPermission(int docPermission) throws IOException, AutomationException
The HasDocumentPermission method determines whether the currently loaded document was published with the specified functionality permission.
When a document is published the publisher can set a variety of permissions to limit the functionality that a user has access to when viewing the document in the ArcReaderGlobeControl. These permissions should be checked and the behavior of an application modified appropriately. For example, if permission to access hyperlinks does not exist an application should be modified so that a user can not set the current tool to the hyperlink tool.
docPermission
- A com.esri.arcgis.controls.esriARDocumentPermissions constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IARUnitConverter getARUnitConverter() throws IOException, AutomationException
The ARUnitConverter object is a helper object for firstly converting values between different esriARUnits and secondly for converting values and esriARUnits constants to strings.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.Object getObject() throws IOException, AutomationException
In some development environments it is not possible to query interface directly on the control to other COM interfaces beacuse the control is contained within a wrapper object. To get the real control use the Object property.
When querying interface to IARGlobeControl in Visual Basic 6.0 the Object property must be used. This is because Visual Basic 6.0 contains the real control inside a wrapper object known as an extender object.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.Object getCustomProperty() throws IOException, AutomationException
Use the CustomProperty to associate any useful data with the ArcReaderGlobeControl. This is similar to a 'Tag' property, and can be use to store strings, numbers and objects.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setCustomProperty(Object rhs1) throws IOException, AutomationException
rhs1
- A Variant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void refresh() throws IOException, AutomationException
The Refresh method causes screen display area of the current view to be redrawn by sending a windows paint event.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IARGlobe getARGlobe() throws IOException, AutomationException
Returns the ARGlobe. The ARGlobe represents the globe contained within the Published Map document. A document can contain only one ARGlobe.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getViewTop() throws IOException, AutomationException
The top of the current view display area in pixels. This will always return 0.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getViewLeft() throws IOException, AutomationException
The left of the current view display area in pixels. The ViewLeft is equal to the TOCWidth + 4 (the width of the splitter that separates the TOC from the current view display area).
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getViewHeight() throws IOException, AutomationException
The height of the current view display area in pixels.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getViewWidth() throws IOException, AutomationException
The width of the current view display area in pixels. The ViewWidth is equal to the width of the ArcReaderGlobeControl - TOCWidth - 4 (the width of the splitter that separates the TOC from the current view display area).
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isHasCustomARConfiguration() throws IOException, AutomationException
This property can be used to determine if the currently loaded document has been published with an embedded ArcReader Template File (ART).
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setSwipeLayerByRef(IARLayer rhs1) throws IOException, AutomationException
rhs1
- A reference to a com.esri.arcgis.controls.IARLayer (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IARLayer getSwipeLayer() throws IOException, AutomationException
This property can be used to specify the ARLayer which is used by the esriARToolGlobeSwipe. Layers beneath the ArcReaderGlobeControl::SwipeLayer will be revealed when the esriARToolGlobeSwipe tool is used.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getViewWindow() throws IOException, AutomationException
The operating environment identifies each window, form and control in an application by assigning it a handle, or hWnd. The ArcReaderGlobeControl is composed of several windows, this property returns the hWnd of window containing the current view.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getCurrentGlobeViewType() throws IOException, AutomationException
Returns the type of current view. If no document has been loaded esriARGlobeViewTypeNone will be returned. If a document has been loaded esriARGlobeViewTypeGlobe will be returned.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setMousePointer(int rhs1) throws IOException, AutomationException
rhs1
- A com.esri.arcgis.controls.esriARMousePointer constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getMousePointer() throws IOException, AutomationException
You can use MousePointer to set the system mouse pointer to be one of the standard built-in esriARMousePointers. This is useful if you want to display a wait cursor while you code performs a large process. The specified esriARMousePointer is displayed provided the ArcReaderGlobeControl::CurrentARTool is set to esriARToolNoneSelected.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IARLayer getSelectedARLayer() throws IOException, AutomationException
Returns the ARLayer that has been selected in the Table Of Contents (TOC). If no layer has been selected in the TOC, this method will return nothing.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |