public final class Monitor
- Object
- Monitor
One physical display attached to the desktop.
A Window sits on exactly one monitor at a time and takes its scale and density
from that monitor, so two windows of the same application can legitimately render
at different scales. Obtain instances through Desktop#getMonitors().
Instances are snapshots. A monitor that is unplugged, moved or has its resolution
changed produces a fresh set, announced through
Desktop#addMonitorListener(com.codename1.ui.events.ActionListener).
Methods
public Rectangle getBounds() | Returns the monitor’s full area in desktop coordinates. |
public Rectangle getWorkArea() | Returns the part of the monitor that is actually usable by a window, with the task bar, dock and any reserved panels excluded. |
public int getDensity() | Returns the density bucket of this monitor, as one of the Display density constants. |
public double getScale() | Returns the backing scale of this monitor: one for a conventional display, two for a high resolution one, and fractional values on platforms that allow them. |
public int getDotsPerInch() | Returns the resolution of this monitor in dots per inch. |
public String getName() | Returns a name for this monitor suitable for showing to a person. |
public boolean isPrimary() | Indicates whether this is the primary monitor, the one the platform treats as the origin of the desktop. |
public boolean equals(Object other) | Indicates whether some other object is “equal to” this one. |
public int hashCode() | Returns a hash code value for the object. |
public String toString() | Returns a string representation of the object. |
Inherited methods
Method details
getBounds
public Rectangle getBounds()Returns the monitor’s full area in desktop coordinates.
Desktop coordinates span every monitor, so a secondary display placed left of or above the primary one legitimately has a negative origin.
Returns
getWorkArea
public Rectangle getWorkArea()Returns the part of the monitor that is actually usable by a window, with the task bar, dock and any reserved panels excluded.
Prefer this over #getBounds() when placing or maximising a window.
Returns
getDensity
public int getDensity()Display density
constants.Returns
getScale
public double getScale()Returns
getDotsPerInch
public int getDotsPerInch()Returns
getName
public String getName()Returns
isPrimary
public boolean isPrimary()Returns
equals
public boolean equals(Object other)Indicates whether some other object is “equal to” this one. The equals method implements an equivalence relation: It is reflexive: for any reference value x, x.equals(x) should return true. It is symmetric: for any reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true. It is transitive: for any reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true. It is consistent: for any reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the object is modified. For any non-null reference value x, x.equals(null) should return false. 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).
Every property counts, not just the index and the bounds. A monitor can be
reconfigured without either changing – display scaling adjusted, a taskbar
switched to auto-hide, a monitor promoted to primary – and Desktop reports
that and hands out fresh snapshots. Comparing only index and bounds made the
new snapshot equal to the old one, so anything that caches getMonitors() and
uses equality to spot what changed kept the stale scale or work area.
hashCode
public int hashCode()toString
public String toString()