MultiPoint Object Metaclass

Overview

The MultiPoint class is a superclass for all objects that can be defined using a list of points. It defines the symbology for the points, including the symbol type, size and color. This object class must not be instantiated directly.

MultiPoint Object Interactive Creation

Most Graphic objects can be created interactively with function XintEditObjectInsert using translations BSelect Drag (to initiate the insertion) and BSelect Release (to terminate the insertion). The insertion translations for MultiPoint object are different, since they must give the user the ability to specify any number of points. The default translation to insert a MultiPoint object is BSelect to specify a point and Btn2Down to signal that the last point has been inserted.

MultiPoint Object Editing

The Select, Move and Size editing operations are supported by the MultiPoint object class. The Shape operation has a different meaning than for rectangular base objects. For a MultiPoint object, a Shape operation is equivalent to a point move operation.

Two editing operations are defined exclusively for MultiPoint objects. They are, ObjectPointAdd (for adding points to an object) and ObjectPointDelete (for deleting points from an object).

Inherited Behavior and Resources

The MultiPoint object class inherits behavior and resources from the Xt Object and Graphic classes.
The following resources are defined by the MultiPoint object class:
NameTypeDefaultAccess
XmNhandleModeintXintHANDLE_POINTSCSG
XmNsymbolBooleanFalseCSG
XmNsymbolColorPixelForegroundCSG
XmNsymbolDataXintSymbolData *NULLCSG
XmNsymbolSizeint8CSG
XmNsymbolTypeintXintSYMBOL_PLUSCSG

XmNhandleMode

Specifies where the handle bars are drawn when a MultiPoint object is selected. Specify XintHANDLE_POINTS to have a handle bar drawn at each point location or XintHANDLE_BOUNDS to have a handle bar drawn at each of the four corners of the bounding box. This resource only applies if Graphic resource XmNhighlightMode is set to XintHIGHLIGHT_HANDLE.

XmNsymbol

Specifies whether or not symbols are drawn at the point locations.

XmNsymbolColor

Specifies the pixel color used to draw point symbols, if resource XmNsymbol is True.

XmNsymbolData

Specifies a pointer to a symbol descriptor, as returned by Symbol function XintSymbolCreate. This resource allows the application to create its own symbols to display points. To display a symbol defined by XmNsymbolData, resource XmNsymbolType must be set to XintSYMBOL_DATA.

XmNsymbolSize

Specifies the size, in pixels, used to draw point symbols, if resource XmNsymbol is True.

XmNsymbolType

Specifies the type of symbol used to draw points, if resource XmNsymbol is True. One of the following constants can be specified:

Resource ValueDescription
XintSYMBOL_XDraws an "X".
XintSYMBOL_PLUSDraws a "+".
XintSYMBOL_SQUAREDraws a square.
XintSYMBOL_CIRCLEDraws a circle.
XintSYMBOL_TRIANGLEDraws a triangle.
XintSYMBOL_DIAMONDDraws a diamond.
XintSYMBOL_FILLED_SQUAREDraws a filled square.
XintSYMBOL_FILLED_CIRCLEDraws a filled circle.
XintSYMBOL_FILLED_TRIANGLEDraws a filled triangle.
XintSYMBOL_FILLED_DIAMONDDraws a filled diamond.
XintSYMBOL_DATADraws the symbol specified by resource XmNsymbolData.