Given a
client area (as described by the arguments), returns a rectangle, relative to the client area's coordinates, that is the client area expanded by the printer's trim (or minimum margins).
Most printers have a minimum margin on each edge of the paper where the printer device is unable to print. This margin is known as the "trim." This method can be used to calculate the printer's minimum margins by passing in a client area of 0, 0, 0, 0 and then using the resulting x and y coordinates (which will be <= 0) to determine the minimum margins for the top and left edges of the paper, and the resulting width and height (offset by the resulting x and y) to determine the minimum margins for the bottom and right edges of the paper, as follows:
- The left trim width is -x pixels
- The top trim height is -y pixels
- The right trim width is (x + width) pixels
- The bottom trim height is (y + height) pixels
@param x the x coordinate of the client area
@param y the y coordinate of the client area
@param width the width of the client area
@param height the height of the client area
@return a rectangle, relative to the client area's coordinates, that isthe client area expanded by the printer's trim (or minimum margins)
@exception SWTException
- ERROR_DEVICE_DISPOSED - if the receiver has been disposed
@see #getBounds
@see #getClientArea