net.rim.device.api.lbs.maps
Class MapDimensions

java.lang.Object
  extended by net.rim.device.api.lbs.maps.MapDimensions

public class MapDimensions
extends Object

Represents spatial information for the visible dimensions of the map image. This includes the pixel dimensions of the screen, the latitude and longitude of the centre of the screen, the zoom level, and the rotation factor.

Since:
BlackBerry API 6.0.0

Constructor Summary
MapDimensions()
          Constructs a new MapDimensions instance.
MapDimensions(int pixelWidth, int pixelHeight)
          Constructs a new MapDimensions instance using the width and height of the field.
MapDimensions(MapDimensions clone)
          Constructs a MapDimensions instance copy.
 
Method Summary
 boolean equals(Object obj)
          Indicates whether some other object is "equal to" this one.
 LatLonRectangle getBoundingBox()
           
 MapPoint getCentre()
          Retrieves the coordinates of the centre of the screen.
 int getPixelHeight()
          Gets the pixel height of the field.
 int getPixelWidth()
          Gets the pixel width of the field.
 int getRotation()
          Gets the rotation of the map.
 int getZoom()
          Gets the zoom level of the field.
 int hashCode()
          Returns a hash code value for the object.
 void setCentre(MapPoint centre)
          Sets the coordinates of the centre of the screen.
 void setPixelHeight(int pixelHeight)
          Sets the pixel height of the field.
 void setPixelWidth(int pixelWidth)
          Sets the pixel width of the field.
 void setRotation(int rotation)
          Sets the rotation of the map.
 void setZoom(int zoom)
          Sets the zoom level of the field.
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait
 



Constructor Detail

MapDimensions

public MapDimensions()
Constructs a new MapDimensions instance.

Since:
BlackBerry API 6.0.0

MapDimensions

public MapDimensions(int pixelWidth,
                     int pixelHeight)
Constructs a new MapDimensions instance using the width and height of the field.

Parameters:
pixelWidth - The width of the field (in pixels).
pixelHeight - The height of the field (in pixels).
Since:
BlackBerry API 6.0.0

MapDimensions

public MapDimensions(MapDimensions clone)
Constructs a MapDimensions instance copy.

Parameters:
clone - The object to copy information from.
Since:
BlackBerry API 6.0.0


Method Detail

hashCode

public int hashCode()
Description copied from class: Object
Returns a hash code value for the object. This method is supported for the benefit of hashtables such as those provided by java.util.Hashtable.

The general contract of hashCode is:

As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the JavaTM programming language.)

Overrides:
hashCode in class Object
Returns:
a hash code value for this object.
See Also:
Object.hashCode()
Since:
BlackBerry API 6.0.0

equals

public boolean equals(Object obj)
Description copied from class: Object
Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation:

The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any reference values x and y, this method returns true if and only if x and y refer to the same object (x==y has the value true).

Overrides:
equals in class Object
Parameters:
obj - the reference object with which to compare.
Returns:
true if this object is the same as the obj argument; false otherwise.
See Also:
Object.equals(Object)
Since:
BlackBerry API 6.0.0

getCentre

public MapPoint getCentre()
Retrieves the coordinates of the centre of the screen.

Returns:
The coordinates for the centre of the screen.
Since:
BlackBerry API 6.0.0

setCentre

public void setCentre(MapPoint centre)
Sets the coordinates of the centre of the screen.

Parameters:
centre - The coordinates for the centre of the screen.
Since:
BlackBerry API 6.0.0

getRotation

public int getRotation()
Gets the rotation of the map. The rotation value is in degrees, clockwise, from North.

Returns:
The rotation value of the map.
Since:
BlackBerry API 6.0.0

setRotation

public void setRotation(int rotation)
Sets the rotation of the map. The rotation value is in degrees, clockwise, from North.

Parameters:
rotation - The rotation value of the map.
Since:
BlackBerry API 6.0.0

getPixelWidth

public int getPixelWidth()
Gets the pixel width of the field.

Returns:
The pixel width of the field.
Since:
BlackBerry API 6.0.0

setPixelWidth

public void setPixelWidth(int pixelWidth)
Sets the pixel width of the field.

Parameters:
pixelWidth - The width of the field (in pixels).
Since:
BlackBerry API 6.0.0

getPixelHeight

public int getPixelHeight()
Gets the pixel height of the field.

Returns:
The height of the field (in pixels).
Since:
BlackBerry API 6.0.0

setPixelHeight

public void setPixelHeight(int pixelHeight)
Sets the pixel height of the field.

Parameters:
pixelHeight - The height of the field (in pixels).
Since:
BlackBerry API 6.0.0

getZoom

public int getZoom()
Gets the zoom level of the field.

Returns:
The zoom level of the field.
Since:
BlackBerry API 6.0.0

setZoom

public void setZoom(int zoom)
Sets the zoom level of the field.

Parameters:
zoom - The zoom level of the field.
Since:
BlackBerry API 6.0.0

getBoundingBox

public LatLonRectangle getBoundingBox()
See Also:
Boxable.getBoundingBox()
Since:
BlackBerry API 6.0.0





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.