com.esri.arcgis.beans.symbology
Class SymbologyBean

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by com.esri.arcgis.beans.symbology.SymbologyBean
All Implemented Interfaces:
ISymbologyControl, ISymbologyControlDefault, IConnectionPointContainer, IPersistStreamInit, com.esri.arcgis.interop.RemoteObjRef, IPersist, ISupportErrorInfo, ImageObserver, MenuContainer, Serializable

public class SymbologyBean
extends JComponent
implements com.esri.arcgis.interop.RemoteObjRef, ISymbologyControlDefault, ISymbologyControl, IConnectionPointContainer, IPersistStreamInit, IPersist, ISupportErrorInfo

The SymbologyBean is a symbology container to display and manage the user selected symbology styles.

Here is a code snippet to get a ISymbol object by adding an ISymbologyControlEventsListener to the SymbologyBean class. When user clicks on a symbol item, the method is called:

public void symbologyBean1_onItemSelected(ISymbologyControlEventsOnItemSelectedEvent event)
throws IOException, AutomationException
{
Object itemp = event.getStyleGalleryItem();
IStyleGalleryItem item = new IStyleGalleryItemProxy(itemp);
ISymbol pSymbol = new ISymbolProxy(item.getItem());
}

See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
protected  SymbologyControl _symbologyControl
          The delegated symbology control
 
Fields inherited from class javax.swing.JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
SymbologyBean()
          The default SymbologyBean constructor.
 
Method Summary
 void aboutBox()
          Displays a dialog of information about the SymbologyControl.
 void addISymbologyControlEventsListener(ISymbologyControlEventsAdapter iSymbologyControlEvents)
           
 void clear()
          Clears all symbols and files from the SymbologyControl.
 void enumConnectionPoints(IEnumConnectionPoints[] iEnumConnectionPointsArray)
          enumConnectionPoints
 boolean esri_isEnabled()
          Indicates whether the SymbologyControl can respond to user generated events.
 void esri_setEnabled(boolean enabled)
          Indicates whether the SymbologyControl can respond to user generated events.
 void findConnectionPoint(GUID gUID, IConnectionPoint[] iConnectionPointArray)
          findConnectionPoint
 int getAppearance()
          The appearance of the SymbologyControl.
 int getBackColor()
          Background color of the SymbologyControl.
 int getBorderStyle()
          The border style of the SymbologyControl.
 void getClassID(GUID[] gUIDArray)
          getClassID
 Object getCustomProperty()
          A property to associate data with the SymbologyControl.
 int getDisplayStyle()
          The display style of the SymbologyControl.
 int getHWnd()
          Handle to the window associated with the SymbologyControl.
 com.esri.arcgis.interop.Dispatch getJintegraDispatch()
           
 int getKeyIntercept()
          A property that specifies interception of key strokes that are normally handled by the container.
 Picture getMouseIcon()
          Custom mouse icon used if MousePointer is 99.
 int getMousePointer()
          The mouse pointer displayed over the SymbologyControl.
 Object getObject()
          A property that returns the underlying control.
 void getSizeMax(_ULARGE_INTEGER[] _ULARGE_INTEGERArray)
          getSizeMax
 int getStyleClass()
          The style class used by the SymbologyControl.
 ISymbologyStyleClass getStyleClass2(int style)
          Returns the specified style class from the SymbologyControl.
 String[] getStyleFiles()
          Returns the style file path name
 SymbologyControl getSymbologyControl()
          Returns the wrapped SymbologyControl class.
 IStyleGalleryItem hitTest(int x, int y)
          Returns the item at the specified x and y coordinates.
 void initNew()
          initNew
 void interfaceSupportsErrorInfo(GUID gUID)
          interfaceSupportsErrorInfo
 void isDirty()
          isDirty
 boolean isShowContextMenu()
          Indicates if the SymbologyControl displays a context menu.
 void load(IStream iStream)
          load
 void loadDesktopStyleFile(String styleFile)
          Loads a desktop style file into the SymbologyControl.
 void loadStyleFile(String filepath)
          Loads a server style file into the SymbologyControl.
 void loadStyleFiles(String[] styles)
          Loads the styles files.
 void paint(Graphics g)
          Paints this component in desing tome
 void release()
           
 void removeFile(String filename)
          Removes a file from the SymbologyControl.
 void removeISymbologyControlEventsListener(ISymbologyControlEventsAdapter iSymbologyControlEvents)
           
 void save(IStream iStream, int _int)
          save
 void setAppearance(int appearance)
          The appearance of the SymbologyControl.
 void setBackColor(int color)
          Background color of the SymbologyControl.
 void setBorderStyle(int border)
          The border style of the SymbologyControl.
 void setCustomProperty(Object object)
          A property to associate data with the SymbologyControl.
 void setDisplayStyle(int style)
          The display style of the SymbologyControl.
 void setKeyIntercept(int key)
          A property that specifies interception of key strokes that are normally handled by the container.
 void setLayout(LayoutManager layout)
          Overrides the setLayout method of super class.
 void setMouseIconByRef(Picture picture)
          Custom mouse icon used if MousePointer is 99.
 void setMousePointer(int pointer)
          The mouse pointer displayed over the SymbologyControl.
 void setShowContextMenu(boolean show)
          Indicates if the SymbologyControl displays a context menu.
 void setStyleClass(int styleClass)
          The style class used by the SymbologyControl.
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

_symbologyControl

protected SymbologyControl _symbologyControl
The delegated symbology control

Constructor Detail

SymbologyBean

public SymbologyBean()
The default SymbologyBean constructor.

Method Detail

setLayout

public void setLayout(LayoutManager layout)
Overrides the setLayout method of super class.

Overrides:
setLayout in class Container
Parameters:
layout - LayoutManager - a LayoutManager object.

paint

public void paint(Graphics g)
Paints this component in desing tome

Overrides:
paint in class JComponent
Parameters:
g - the graphics context to use for painting

getSymbologyControl

public SymbologyControl getSymbologyControl()
Returns the wrapped SymbologyControl class.

Returns:
SymbologyControl

getStyleFiles

public String[] getStyleFiles()
Returns the style file path name

Returns:
String a style file string

loadStyleFiles

public void loadStyleFiles(String[] styles)
Loads the styles files.

Parameters:
styles - String[]

addISymbologyControlEventsListener

public void addISymbologyControlEventsListener(ISymbologyControlEventsAdapter iSymbologyControlEvents)
                                        throws IOException
Throws:
IOException

removeISymbologyControlEventsListener

public void removeISymbologyControlEventsListener(ISymbologyControlEventsAdapter iSymbologyControlEvents)
                                           throws IOException
Throws:
IOException

getJintegraDispatch

public com.esri.arcgis.interop.Dispatch getJintegraDispatch()
Specified by:
getJintegraDispatch in interface com.esri.arcgis.interop.RemoteObjRef

release

public void release()
Specified by:
release in interface com.esri.arcgis.interop.RemoteObjRef

getClassID

public void getClassID(GUID[] gUIDArray)
                throws IOException,
                       AutomationException
getClassID

Description

IPersist is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
getClassID in interface IPersist
Parameters:
pClassID - A Structure: com.esri.arcgis.support.ms.stdole.GUID (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setBackColor

public void setBackColor(int color)
                  throws IOException,
                         AutomationException
Background color of the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setBackColor in interface ISymbologyControl
Specified by:
setBackColor in interface ISymbologyControlDefault
Parameters:
rhs1 - The rhs1 (A COM typedef) (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBackColor

public int getBackColor()
                 throws IOException,
                        AutomationException
Background color of the SymbologyControl.

Description

Returns or sets the Background Color of the SymbologyControl. Internally the OLE_Color is stored as a long integer where the value may be calculated for any RGB combination as follows:

OLE_Color = (Red) + (Green * 256) + (Blue * 256 * 256)

Where Red, Green and Blue are Long Integers within the range 0 - 255.

Product Availability

Available with ArcGIS Engine.

Specified by:
getBackColor in interface ISymbologyControl
Specified by:
getBackColor in interface ISymbologyControlDefault
Returns:
The returnValue (A COM typedef)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMousePointer

public void setMousePointer(int pointer)
                     throws IOException,
                            AutomationException
The mouse pointer displayed over the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setMousePointer in interface ISymbologyControl
Specified by:
setMousePointer in interface ISymbologyControlDefault
Parameters:
rhs1 - A com.esri.arcgis.controls.esriControlsMousePointer constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMousePointer

public int getMousePointer()
                    throws IOException,
                           AutomationException
The mouse pointer displayed over the SymbologyControl.

Description

Use this property when you want to indicate changes in functionality as the mouse pointer passes over the SymbologyControl. The esriPointerArrowHourglass setting (11) is useful for indicating that the user should wait for a process or operation to finish.

Product Availability

Available with ArcGIS Engine.

Specified by:
getMousePointer in interface ISymbologyControl
Specified by:
getMousePointer in interface ISymbologyControlDefault
Returns:
A com.esri.arcgis.controls.esriControlsMousePointer constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMouseIconByRef

public void setMouseIconByRef(Picture picture)
                       throws IOException,
                              AutomationException
Custom mouse icon used if MousePointer is 99.

Product Availability

Available with ArcGIS Engine.

Specified by:
setMouseIconByRef in interface ISymbologyControl
Specified by:
setMouseIconByRef in interface ISymbologyControlDefault
Parameters:
rhs1 - A reference to a com.esri.arcgis.support.ms.stdole.Picture (A com.esri.arcgis.support.ms.stdole.Picture COM typedef) (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMouseIcon

public Picture getMouseIcon()
                     throws IOException,
                            AutomationException
Custom mouse icon used if MousePointer is 99.

Description

The MouseIcon property provides a custom icon that is used when the MousePointer property is set to esriPointerArrowHourglass (99).

Remarks

In most development evironments the control's property pages can be used to load either a cursor (.cur) or icon (.ico) file. A cursor contains a custom 'hotspot' location and can be any size. The 'hotspot' location for an icon file defaults to the center of the icon. This property cannot be used to load animated cursor (.ani) files.

To programatically create an object implementing IPictureDisp there is the win32 function OleLoadPicture or helper methods depending on the development environment.

Product Availability

Available with ArcGIS Engine.

Specified by:
getMouseIcon in interface ISymbologyControl
Specified by:
getMouseIcon in interface ISymbologyControlDefault
Returns:
A reference to a com.esri.arcgis.support.ms.stdole.Picture (A com.esri.arcgis.support.ms.stdole.Picture COM typedef)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setBorderStyle

public void setBorderStyle(int border)
                    throws IOException,
                           AutomationException
The border style of the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setBorderStyle in interface ISymbologyControl
Specified by:
setBorderStyle in interface ISymbologyControlDefault
Parameters:
rhs1 - A com.esri.arcgis.controls.esriControlsBorderStyle constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBorderStyle

public int getBorderStyle()
                   throws IOException,
                          AutomationException
The border style of the SymbologyControl.

Description

Returns or sets the border style of a SymbologyControl. By default a border is drawn.

Product Availability

Available with ArcGIS Engine.

Specified by:
getBorderStyle in interface ISymbologyControl
Specified by:
getBorderStyle in interface ISymbologyControlDefault
Returns:
A com.esri.arcgis.controls.esriControlsBorderStyle constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

esri_setEnabled

public void esri_setEnabled(boolean enabled)
                     throws IOException,
                            AutomationException
Indicates whether the SymbologyControl can respond to user generated events.

Product Availability

Available with ArcGIS Engine.

Specified by:
esri_setEnabled in interface ISymbologyControl
Specified by:
esri_setEnabled in interface ISymbologyControlDefault
Parameters:
rhs1 - The rhs1 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

esri_isEnabled

public boolean esri_isEnabled()
                       throws IOException,
                              AutomationException
Indicates whether the SymbologyControl can respond to user generated events.

Product Availability

Available with ArcGIS Engine.

Specified by:
esri_isEnabled in interface ISymbologyControl
Specified by:
esri_isEnabled in interface ISymbologyControlDefault
Returns:
The returnValue
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAppearance

public void setAppearance(int appearance)
                   throws IOException,
                          AutomationException
The appearance of the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setAppearance in interface ISymbologyControl
Specified by:
setAppearance in interface ISymbologyControlDefault
Parameters:
rhs1 - A com.esri.arcgis.controls.esriControlsAppearance constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAppearance

public int getAppearance()
                  throws IOException,
                         AutomationException
The appearance of the SymbologyControl.

Description

Returns or sets the paint style of a SymbologyControl to either Flat or 3D. By default the appearance is flat.

Product Availability

Available with ArcGIS Engine.

Specified by:
getAppearance in interface ISymbologyControl
Specified by:
getAppearance in interface ISymbologyControlDefault
Returns:
A com.esri.arcgis.controls.esriControlsAppearance constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getHWnd

public int getHWnd()
            throws IOException,
                   AutomationException
Handle to the window associated with the SymbologyControl.

Description

The operating environment identifies each window, form and control in an application by assigning it a handle, or hWnd. Many ArcObjects methods and Windows API calls require the hWnd as an argument.

Product Availability

Available with ArcGIS Engine.

Specified by:
getHWnd in interface ISymbologyControl
Specified by:
getHWnd in interface ISymbologyControlDefault
Returns:
The returnValue
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

aboutBox

public void aboutBox()
              throws IOException,
                     AutomationException
Displays a dialog of information about the SymbologyControl.

Description

The AboutBox method causes a modal dialog box to display on top of the SymbologyControl, containing information about the version and creation date of the SymbologyControl as well as listing relevant legal and copyright information from ESRI.

Product Availability

Available with ArcGIS Engine.

Specified by:
aboutBox in interface ISymbologyControl
Specified by:
aboutBox in interface ISymbologyControlDefault
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setStyleClass

public void setStyleClass(int styleClass)
                   throws IOException,
                          AutomationException
The style class used by the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setStyleClass in interface ISymbologyControl
Specified by:
setStyleClass in interface ISymbologyControlDefault
Parameters:
rhs1 - A com.esri.arcgis.controls.esriSymbologyStyleClass constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getStyleClass

public int getStyleClass()
                  throws IOException,
                         AutomationException
The style class used by the SymbologyControl.

Description

The SymbologyStyleClass currently displayed in the SymbologyControl. By default marker symbols are displayed.

The end user can set the StyleClass by interacting with the 'Style Class' context menu. The end user can display the 'Style Class' context menu by right clicking on the SymbologyControl when ShowContextMenu is true.

The OnStyleClassChanged event will fire when the StyleClass is set.

Remarks

The following style classes are only supported with an ArcGIS for Desktop installation:


~ esriStyleClassReferenceSystems
~ esriStyleClassMaplexLabels
~ esriStyleClassVectorizationSettings
~ esriStyleClassHatches

Product Availability

Available with ArcGIS Engine.

Specified by:
getStyleClass in interface ISymbologyControl
Specified by:
getStyleClass in interface ISymbologyControlDefault
Returns:
A com.esri.arcgis.controls.esriSymbologyStyleClass constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDisplayStyle

public void setDisplayStyle(int style)
                     throws IOException,
                            AutomationException
The display style of the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setDisplayStyle in interface ISymbologyControl
Specified by:
setDisplayStyle in interface ISymbologyControlDefault
Parameters:
rhs1 - A com.esri.arcgis.controls.esriSymbologyDisplayStyle constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDisplayStyle

public int getDisplayStyle()
                    throws IOException,
                           AutomationException
The display style of the SymbologyControl.

Description

Returns or sets the style the items are displayed in the SymbologyControl. By default the DisplayStyle is Icon.

esriDisplayStyleIcon

esriDisplayStyleSmallIcon

esriDisplayStyleReport

esriDisplayStyleList

Product Availability

Available with ArcGIS Engine.

Specified by:
getDisplayStyle in interface ISymbologyControl
Specified by:
getDisplayStyle in interface ISymbologyControlDefault
Returns:
A com.esri.arcgis.controls.esriSymbologyDisplayStyle constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setKeyIntercept

public void setKeyIntercept(int key)
                     throws IOException,
                            AutomationException
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.

Product Availability

Available with ArcGIS Engine.

Specified by:
setKeyIntercept in interface ISymbologyControl
Specified by:
setKeyIntercept in interface ISymbologyControlDefault
Parameters:
rhs1 - The rhs1 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getKeyIntercept

public int getKeyIntercept()
                    throws IOException,
                           AutomationException
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.

Description

Returns or sets keys on the keyboard that will be intercepted by the SymbologyControl, triggering the OnKeyDown and OnKeyUp events when pressed. These keys are often hidden from the SymbologyControl by the development environment container. By default the KeyIntercept is set to esriKeyInterceptNone.

Many development environment containers use the up, down, left and right arrow keys to change control focus on a form. These keys can also be useful for navigating around the display. To intercept the arrow keys and the Tab key combine the enum values using a logical OR operation (esriKeyInterceptArrowKeys OR esriKeyInterceptTabKey, which is 1 OR 4 = 5).

Product Availability

Available with ArcGIS Engine.

Specified by:
getKeyIntercept in interface ISymbologyControl
Specified by:
getKeyIntercept in interface ISymbologyControlDefault
Returns:
The returnValue
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCustomProperty

public void setCustomProperty(Object object)
                       throws IOException,
                              AutomationException
A property to associate data with the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
setCustomProperty in interface ISymbologyControl
Specified by:
setCustomProperty in interface ISymbologyControlDefault
Parameters:
rhs1 - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setShowContextMenu

public void setShowContextMenu(boolean show)
                        throws IOException,
                               AutomationException
Indicates if the SymbologyControl displays a context menu.

Product Availability

Available with ArcGIS Engine.

Specified by:
setShowContextMenu in interface ISymbologyControl
Specified by:
setShowContextMenu in interface ISymbologyControlDefault
Parameters:
rhs1 - The rhs1 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isShowContextMenu

public boolean isShowContextMenu()
                          throws IOException,
                                 AutomationException
Indicates if the SymbologyControl displays a context menu.

Description

Determines whether the 'Style Class' context menu will popup when the user right clicks on the control. This property is false by default.

The OnStyleClassChanged event will fire if the user interactively sets the StyleClass property using the 'Style Class' context menu.

Product Availability

Available with ArcGIS Engine.

Specified by:
isShowContextMenu in interface ISymbologyControl
Specified by:
isShowContextMenu in interface ISymbologyControlDefault
Returns:
The returnValue
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getObject

public Object getObject()
                 throws IOException,
                        AutomationException
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.

Description

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.

Product Availability

Available with ArcGIS Engine.

Specified by:
getObject in interface ISymbologyControl
Specified by:
getObject in interface ISymbologyControlDefault
Returns:
A reference to another Automation Object (IDispatch)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

hitTest

public IStyleGalleryItem hitTest(int x,
                                 int y)
                          throws IOException,
                                 AutomationException
Returns the item at the specified x and y coordinates.

Description

Returns the item at the specified x and y coordinates (in pixels). If no item is found, returns Nothing.

Product Availability

Available with ArcGIS Engine.

Specified by:
hitTest in interface ISymbologyControl
Specified by:
hitTest in interface ISymbologyControlDefault
Parameters:
x - The x (in)
y - The y (in)
Returns:
A reference to a com.esri.arcgis.display.IStyleGalleryItem
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

loadStyleFile

public void loadStyleFile(String filepath)
                   throws IOException,
                          AutomationException
Loads a server style file into the SymbologyControl.

Description

Loads the contents of the specified server style file (*.ServerStyle) into the SymbologyControl. Each ServerStyleGalleryItem within the server style file is added to a SymbologyStyleClass based on its type. For example, a SimpleFillSymbol will be added to the esriStyleClassFillSymbols SymbologyStyleClass.

Items are 'demand loaded' to the end of a SymbologyStyleClass item collection. This is done to increase performance and means items are only loaded into a SymbologyStyleClass when it is the current StyleClass or when the SymbologyStyleClass is being accessed programmatically. To force items to be loaded into a SymbologyStyleClass, when it is not the current StyleClass use the ISymbologyStyleClass::Update method.

Passing the same server style file to the LoadStyleFile method multiple times within the lifetime of an application, causes the contents of the server style file to be re-loaded into the SymbologyControl.

Remarks

Server Styles are collections of symbols and map elements that are often grouped by functionality. For example, symbols and map elements used by the transportation industry maybe grouped into Transportation Server Style.

Server Styles are stored in files that have a .ServerStyle extension. ESRI provides several styles for you to use out of the box. These styles are found under \\install_location\ArcGIS\Styles. You will find commonly used symbols and map elements in ESRI.ServerStyle, and more domain specific style items in relevantly named .ServerStyle files (for example, Transportation.ServerStyle).

A style is composed of several style items. These style items provide access to individual map elements and symbols. Style items are organized into style classes, which are types of style items. A style class may have several groups of items organized into categories. For example, Precipitation is style item that belongs to the Color Ramps style class and the Default Ramps category.

Product Availability

Available with ArcGIS Engine.

Specified by:
loadStyleFile in interface ISymbologyControl
Specified by:
loadStyleFile in interface ISymbologyControlDefault
Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

loadDesktopStyleFile

public void loadDesktopStyleFile(String styleFile)
                          throws IOException,
                                 AutomationException
Loads a desktop style file into the SymbologyControl.

Description

Loads the contents of the specified style file (*.Style) into the SymbologyControl. Where possible, always use the LoadStyleFile method to load the contents of server style files (*.ServerStyle) into the SymbologyControl, as style files are only supported with an ArcGIS for Desktop installation.

Each StyleGalleryItem within the style file is added to a SymbologyStyleClass based on its type. For example, a SimpleFillSymbol will be added to the esriStyleClassFillSymbols SymbologyStyleClass.

Items are 'demand loaded' to the end of a SymbologyStyleClass item collection. This is done to increase performance and means items are only loaded into a SymbologyStyleClass when it is the current StyleClass, or when the SymbologyStyleClass is being accessed programmatically. To force items to be loaded into a SymbologyStyleClass when it is not the current StyleClass, use the ISymbologyStyleClass::Update method.

Passing the same style file to the LoadDesktopStyleFile method multiple times within the lifetime of an application, causes the contents of the style file to reload into the SymbologyControl.

Remarks

A 'desktop' Style file is similar to a Server Style file, except is has a .Style extension rather than a .ServerStyle extension. Style files are available to ArcGIS for Desktop products only, whereas Server Style files are available to all ArcGIS products.

Product Availability

Available with ArcGIS Engine.

Specified by:
loadDesktopStyleFile in interface ISymbologyControl
Specified by:
loadDesktopStyleFile in interface ISymbologyControlDefault
Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getStyleClass2

public ISymbologyStyleClass getStyleClass2(int style)
                                    throws IOException,
                                           AutomationException
Returns the specified style class from the SymbologyControl.

Product Availability

Available with ArcGIS Engine.

Specified by:
getStyleClass2 in interface ISymbologyControl
Specified by:
getStyleClass2 in interface ISymbologyControlDefault
Parameters:
styleClass - A com.esri.arcgis.controls.esriSymbologyStyleClass constant (in)
Returns:
A reference to a com.esri.arcgis.controls.ISymbologyStyleClass
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeFile

public void removeFile(String filename)
                throws IOException,
                       AutomationException
Removes a file from the SymbologyControl.

Description

Removes the contents of the specified server style file (*.ServerStyle) or style file (*.Style) from the SymbologyControl. Corresponding items are removed from each SymbologyStyleClass.

Product Availability

Available with ArcGIS Engine.

Specified by:
removeFile in interface ISymbologyControl
Specified by:
removeFile in interface ISymbologyControlDefault
Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

clear

public void clear()
           throws IOException,
                  AutomationException
Clears all symbols and files from the SymbologyControl.

Description

Clears all items from the SymbologyControl. Items are removed from each SymbologyStyleClass regardless of whether they were loaded using the LoadStyleFile, LoadDesktopStyleFile or ISymbologyStyleClass::AddItem methods.

Product Availability

Available with ArcGIS Engine.

Specified by:
clear in interface ISymbologyControl
Specified by:
clear in interface ISymbologyControlDefault
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

enumConnectionPoints

public void enumConnectionPoints(IEnumConnectionPoints[] iEnumConnectionPointsArray)
                          throws IOException,
                                 AutomationException
enumConnectionPoints

Description

IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
enumConnectionPoints in interface IConnectionPointContainer
Parameters:
ppEnum - A reference to a com.esri.arcgis.display.IEnumConnectionPoints (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

findConnectionPoint

public void findConnectionPoint(GUID gUID,
                                IConnectionPoint[] iConnectionPointArray)
                         throws IOException,
                                AutomationException
findConnectionPoint

Description

IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
findConnectionPoint in interface IConnectionPointContainer
Parameters:
riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
ppCP - A reference to a com.esri.arcgis.display.IConnectionPoint (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isDirty

public void isDirty()
             throws IOException,
                    AutomationException
isDirty

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
isDirty in interface IPersistStreamInit
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

load

public void load(IStream iStream)
          throws IOException,
                 AutomationException
load

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
load in interface IPersistStreamInit
Parameters:
pStm - A reference to a com.esri.arcgis.system.IStream (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

save

public void save(IStream iStream,
                 int _int)
          throws IOException,
                 AutomationException
save

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
save in interface IPersistStreamInit
Parameters:
pStm - A reference to a com.esri.arcgis.system.IStream (in)
fClearDirty - The fClearDirty (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSizeMax

public void getSizeMax(_ULARGE_INTEGER[] _ULARGE_INTEGERArray)
                throws IOException,
                       AutomationException
getSizeMax

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
getSizeMax in interface IPersistStreamInit
Parameters:
pCbSize - A Structure: com.esri.arcgis.system._ULARGE_INTEGER (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

initNew

public void initNew()
             throws IOException,
                    AutomationException
initNew

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
initNew in interface IPersistStreamInit
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID gUID)
                                throws IOException,
                                       AutomationException
interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
interfaceSupportsErrorInfo in interface ISupportErrorInfo
Parameters:
riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCustomProperty

public Object getCustomProperty()
                         throws IOException,
                                AutomationException
A property to associate data with the SymbologyControl.

Description

Use the CustomProperty to associate any useful data with the SymbologyControl. This is similar to a 'Tag' property, and can be use to store strings, numbers and objects.

Product Availability

Available with ArcGIS Engine.

Specified by:
getCustomProperty in interface ISymbologyControl
Specified by:
getCustomProperty in interface ISymbologyControlDefault
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.