com.iizix.prop.ui.map

Class MapMarker

java.lang.Object

com.iizix.prop.ui.map.MapMarker

All Implemented Interfaces:

IContentData<MapMarkerProp>

public class MapMarker
extends Object
implements IContentData<MapMarkerProp>

The marker for the map consists of a location, text and attributes.

Markers can be placed on a map by means of either API directory against the map component or in the VirtualSpace by means of connections to the map.

A marker that is enabled and not read-only can be dragged on a map if the markers settings allows draggable markers.

Author:

Christopher Mindus

Constructor Summary

Constructors

Modifier	Constructor and Description
	MapMarker() Constructor for API.
protected	MapMarker(VSRow row) Constructor for VS-connected content provider.

Method Summary

Modifier and Type	Method and Description
boolean	addMappings(VSMappings mappings, String uiRef, MapMarkerProp item) Adds the mappings of a VirtualSpace to the panel components.
MapMarkerProp	getItemProp() Returns the property that was used to update this data content.
char	getLabel() Gets the marker label character.
PlainKString	getLabelChar() Gets the marker label character text.
double	getLatitude() Gets the latitude of the marker.
double	getLongitude() Gets the longitude of the marker.
MapMarkers	getMarkers() Gets the map markers container.
PlainKString	getTooltipText() Gets the marker tooltip text.
VSRow	getVSRow() Gets the associated VSRow for this item.
void	initialize(MapMarkerProp item) Initializes the item property from the content data.
boolean	isEnabled() Gets the enabled state.
boolean	isReadOnly() Gets the read-only state.
boolean	isSelected() Gets the selection state of the item.
boolean	isVisible() Gets the visibility state.
void	refreshFromVS(int[] columns) Refreshes contents from VirtualSpace.
boolean	setEnabled(boolean newState) Sets the enabled state.
boolean	setLabel(char ch) Sets the marker label character.
boolean	setLabelChar(PlainKString text) Sets the marker label character.
boolean	setLatitude(double latitude) Sets the latitude of the marker.
boolean	setLongitude(double longitude) Sets the longitude of the marker.
boolean	setReadOnly(boolean newState) Sets the read-only state.
String	setSelection(boolean on) Sets the selection state of an item.
String	setSelectionInternal(boolean on) Internal method to sets the selection state of an item.
boolean	setTooltipText(PlainKString text) Sets the marker tooltip text.
boolean	setVisible(boolean newState) Sets the visibility state.
void	toggleSelection() Toggle the selected state of the map marker.
String	toString() Returns a String representation of the marker.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MapMarker

public MapMarker()

Constructor for API.

MapMarker

protected MapMarker(VSRow row)

Constructor for VS-connected content provider.

Method Detail

refreshFromVS

public void refreshFromVS(int[] columns)

Refreshes contents from VirtualSpace.

Specified by:

refreshFromVS in interface IContentData<MapMarkerProp>

Parameters:

columns - The connected table columns.

getVSRow

public VSRow getVSRow()

Gets the associated VSRow for this item.

Specified by:

getVSRow in interface IContentData<MapMarkerProp>

Returns:

The row, or null if not associated with VirtualSpace.

getItemProp

public MapMarkerProp getItemProp()

Returns the property that was used to update this data content.

Specified by:

getItemProp in interface IContentData<MapMarkerProp>

Returns:

The property, or null if none is assigned.

getMarkers

public MapMarkers getMarkers()

Gets the map markers container.

Returns:

The container, or null if not yet associated.

initialize

public void initialize(MapMarkerProp item)

Initializes the item property from the content data.

Specified by:

initialize in interface IContentData<MapMarkerProp>

Parameters:

item - The item.

toString

public String toString()

Returns a String representation of the marker.

Overrides:

toString in class Object

Returns:

String as "latitude=nn,longitude=nn,label=xxx,tooltip=yyy".

getTooltipText

public PlainKString getTooltipText()

Gets the marker tooltip text.

Returns:

The tooltip text as a plain KString, null if not set.

setTooltipText

public boolean setTooltipText(PlainKString text)

Sets the marker tooltip text.

Parameters:

text - The text, or null for none.

Returns:

true for changed, false for no change.

getLabel

public char getLabel()

Gets the marker label character.

Returns:

The label character, '\0' if not set.

getLabelChar

public PlainKString getLabelChar()

Gets the marker label character text.

Returns:

The label character, null if not set.

setLabel

public boolean setLabel(char ch)

Sets the marker label character.

Parameters:

ch - The character, or '\0' for none.

Returns:

true for changed, false for no change.

setLabelChar

public boolean setLabelChar(PlainKString text)

Sets the marker label character.

Parameters:

text - The text, or null for none. Only the first character is used.

Returns:

true for changed, false for no change.

getLatitude

public double getLatitude()

Gets the latitude of the marker.

Returns:

The latitude -90 to 90, initialized by default to zero.

setLatitude

public boolean setLatitude(double latitude)

Sets the latitude of the marker.

For reference, the Equator has a latitude of 0°, the North pole has a latitude of 90° north (written 90° N or +90°), and the South pole has a latitude of -90°. Prime Meridian has a longitude of 0° that goes through Greenwich, England.

Parameters:

latitude - The latitude.

Returns:

true if changed, false for no change.

Throws:

IllegalArgumentException - If the latitude is not -90 to 90 degrees.

getLongitude

public double getLongitude()

Gets the longitude of the marker.

Returns:

The longitude -180 to 180, initialized by default to zero.

setLongitude

public boolean setLongitude(double longitude)

Sets the longitude of the marker.

Longitude is in the range -180 and +180 specifying the east-west position. For reference, the Equator has a latitude of 0°, the North pole has a latitude of 90° north (written 90° N or +90°), and the South pole has a latitude of -90°. Prime Meridian has a longitude of 0° that goes through Greenwich, England.

Parameters:

longitude - The longitude.

Returns:

true if changed, false for no change.

Throws:

IllegalArgumentException - If the longitude is not -180 to 180 degrees.

isVisible

public boolean isVisible()

Gets the visibility state.

This is the items individual state and does not take parent states into account.

Returns:

true for visible, false for hidden.

isEnabled

public boolean isEnabled()

Gets the enabled state.

This is the items individual state and does not take parent states into account.

Returns:

true for enabled, false for disabled.

isReadOnly

public boolean isReadOnly()

Gets the read-only state.

This is the items individual state and does not take parent states into account.

Returns:

true for read-only, false otherwise.

isSelected

public boolean isSelected()

Gets the selection state of the item.

Specified by:

isSelected in interface IContentData<MapMarkerProp>

Returns:

The selected state.

setVisible

public boolean setVisible(boolean newState)

Sets the visibility state.

This is the items individual state and does not take parent states into account.

Parameters:

newState - the new state: true for visible, false for hidden.

Returns:

true for changed state, false for no change.

setEnabled

public boolean setEnabled(boolean newState)

Sets the enabled state.

This is the items individual state and does not take parent states into account.

Parameters:

newState - The new state: true for enabled, false for disabled.

setReadOnly

public boolean setReadOnly(boolean newState)

Sets the read-only state.

This is the items individual state and does not take parent states into account.

Parameters:

newState - The new state: true for read-only, false otherwise.

setSelection

public String setSelection(boolean on)

Sets the selection state of an item.

Specified by:

setSelection in interface IContentData<MapMarkerProp>

Parameters:

on - The new selection state.

Returns:

null for success.

setSelectionInternal

public String setSelectionInternal(boolean on)

Internal method to sets the selection state of an item. This method is not intended to be called as it is used by the framework and will not cause a callback or event notification of selection changes.

Specified by:

setSelectionInternal in interface IContentData<MapMarkerProp>

Parameters:

on - The new selection state.

Returns:

null for success, empty string for no change.

toggleSelection

public void toggleSelection()

Toggle the selected state of the map marker.

addMappings

public boolean addMappings(VSMappings mappings,
                           String uiRef,
                           MapMarkerProp item)

Adds the mappings of a VirtualSpace to the panel components.

The default is to find the relative references to VS and add those references. Override to provide other functionality.

Specified by:

addMappings in interface IContentData<MapMarkerProp>

Parameters:

mappings - The mappings instance to fill in.

uiRef - The reference.

item - The item property.

Returns:

true if there was a match, false otherwise.