RMDocument (ReportMill 11 API)

Overview

Package

Class

Tree

Deprecated

Index

Help

ReportMill 11 API

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.reportmill.shape
Class RMDocument

java.lang.Object
  com.reportmill.base.RMObject
      com.reportmill.shape.RMShape
          com.reportmill.shape.RMDocument

All Implemented Interfaces:: com.reportmill.base.RMPropertyChanger, java.beans.PropertyChangeListener, java.lang.Cloneable, java.util.EventListener

public class RMDocument
extends RMShape
extends RMShape

The RMDocument class represents a ReportMill document and is also an RMShape subclass, so it can be a real part of the document/shape hierarchy. RMDocuments are also what ReportMill refers to as templates, and is commonly used like this:

   RMDocument template = new RMDocument(aSource); // Load from path String, File, byte array, etc.
   RMDocument report = template.generateReport(aDataset); // Any Java dataset: EJBs, custom classes, collctns, etc.
   report.writePDF("MyReport.pdf");

On rare occasions, you may also want to create a document dynamically. Here's an example:

   RMDocument doc = new RMDocument(612, 792); // Standard US Letter size (8.5" x 11"), in points
   RMTable table = new RMTable(); // Create new table ...
   doc.getPage(0).addChild(table); // ... and add to first page
   table.setBounds(36, 36, 540, 680); // Position and size table
   table.getRow("Objects Details").getColumn(0).setText("Title: @getTitle@"); // Configure first text

Nested Class Summary
`static interface`	`RMDocument.DocListener` An interface to define objects that want to get document notifications.
`static interface`	`RMDocument.Source` A simple interface for a viewer source.

Field Summary
`static java.util.Locale`	`_locale`
`static byte`	`PAGE_LAYOUT_CONTINUOUS`
`static byte`	`PAGE_LAYOUT_CONTINUOUS_DOUBLE`
`static byte`	`PAGE_LAYOUT_DOUBLE`
`static byte`	`PAGE_LAYOUT_FACING`
`static byte`	`PAGE_LAYOUT_QUADRUPLE`
`static byte`	`PAGE_LAYOUT_SINGLE`
`static java.lang.String[]`	`SUPPORTED_UNITS`
`static byte`	`UNIT_CM`
`static byte`	`UNIT_INCHES`
`static byte`	`UNIT_MM`
`static byte`	`UNIT_PICA`
`static byte`	`UNIT_POINTS`

Fields inherited from class com.reportmill.shape.RMShape
`WRAP_TYPE_BOTH, WRAP_TYPE_NONE`

Constructor Summary
`RMDocument()` Creates a plain empty document.
`RMDocument(float aWidth, float aHeight)` Creates a document with the given width and height (in printer points).
`RMDocument(java.lang.Object aSource)` Creates a new document from the given source.

Method Summary
`boolean`	`acceptsChildren()` Editor method indicates that document accepts children (should probably be false).
`void`	`addBinder(com.reportmill.binder.RMBinder aBinder)` Adds a binder to the panel.
`void`	`addPage(RMPage aPage)` Adds a given page to this document.
`void`	`addPage(RMPage aPage, int anIndex)` Adds a given page to this document at the given index.
`void`	`addPages(RMDocument aDoc)` Add the pages in the given document to this document (at end) and clears the pages list in the given document.
`void`	`boundsChanged(RMShape aShape)` Notifies this shape that a given shape's bounds have changed (presumably a descendant).
`boolean`	`childrenSuperSelectImmediately()` Editor method indicates that pages super select immediately.
`RMDocument`	`clone()` Copies basic document attributes (shallow copy only - no children or pages).
`RMDocument`	`cloneDeep()` Copies the complete document, including document pages and all their children.
`com.reportmill.shape.RMShapeLayout`	`createLayout()` Overrides shape version to provide null layout by default.
`boolean`	`equals(java.lang.Object anObj)` Standard equals implementation.
`java.lang.Object`	`fromXMLShape(com.reportmill.archiver.RXArchiver anArchiver, com.reportmill.archiver.RXElement anElement, java.lang.Object anOwner)` XML unarchival.
`void`	`fromXMLShapeChildren(com.reportmill.archiver.RXArchiver anArchiver, com.reportmill.archiver.RXElement anElement, java.lang.Object anOwner)` XML unarchival for shape children.
`RMDocument`	`generateReport()` Returns a generated report from this template evaluated against the given object.
`RMDocument`	`generateReport(java.lang.Object objects)` Returns a generated report from this template evaluated against the given object.
`RMDocument`	`generateReport(java.lang.Object objects, boolean paginate)` Returns a generated report from this template evaluated against the given object with an option to paginate.
`RMDocument`	`generateReport(java.lang.Object objects, java.lang.Object userInfo)` Returns a generated report from this template evaluated against the given object and userInfo.
`RMDocument`	`generateReport(java.lang.Object objects, java.lang.Object userInfo, boolean paginate)` Returns generated report from this template evaluated against given object/userInfo (with option to paginate).
`com.reportmill.graphics.RMAnimator`	`getAnimator(int anIndex)` Returns the animator for a specific page.
`com.reportmill.graphics.RMAnimator`	`getAnimatorLast()` Returns the animator for the last page.
`com.reportmill.binder.RMBinder`	`getBinder(int anIndex)` Returns the specific binder at the given index.
`com.reportmill.binder.RMBinder`	`getBinder(java.lang.String aName)` Returns the named binder for this panel.
`int`	`getBinderCount()` Returns the number of binders for this panel.
`java.util.List<com.reportmill.binder.RMBinder>`	`getBinders()` Returns the binders list.
`byte[]`	`getBytes()` Returns the document as an XML byte array.
`byte[]`	`getBytesCSV()` Returns the document as a byte array of a CSV file.
`byte[]`	`getBytesDelimitedAscii(java.lang.String fieldDelimiter, java.lang.String recordDelimiter, boolean quoteFields)` Returns the document as a byte array of a delimited ASCII file (using given field, record separator strings).
`byte[]`	`getBytesExcel()` Returns the document as byte array of an Excel file.
`byte[]`	`getBytesFlash()` Returns the document as a byte array of a Flash file.
`byte[]`	`getBytesHTML()` Returns the document as a byte array of an HTML file.
`byte[]`	`getBytesJPEG()` Returns the document as byte array of a JPEG file.
`byte[]`	`getBytesPDF()` Returns the document as a byte array of a PDF file.
`byte[]`	`getBytesPNG()` Returns the document as byte array of PNG file.
`byte[]`	`getBytesRTF()` Returns the document as byte array of an Excel file.
`boolean`	`getCompress()` Returns whether the document should compress images in generated file formats like PDF.
`RMEntity`	`getDatasetEntity()` Returns the entity this shape should show in keys browser.
`RMDataSource`	`getDataSource()` Returns the RMDataSource associated with this document.
`RMSchema`	`getDataSourceSchema()` Returns the schema for the RMDataSource associated with this document (convenience).
`static RMDocument`	`getDoc(java.lang.Object aSource)` Creates a new document from aSource using RMArchiver.
`RMDocument.DocListener`	`getDocListener()` Returns the first doc listener from listeners list.
`RMDocument`	`getDocument()` Returns the document itself (over-ridden from RMShape).
`java.lang.String`	`getFilename()` Returns the filename associated with this document, if available.
`float`	`getGridSpacing()` Returns the grid spacing for the document's grid.
`boolean`	`getLoops()` Returns whether the last animator loops.
`java.util.Map`	`getMapHTML(java.lang.String anImageRoot)` Returns the document as a Map of an HTML file and image resources.
`float`	`getMarginBottom()` Returns the margin rects bottom value.
`float`	`getMarginLeft()` Returns the margin rects left value.
`RMRect`	`getMarginRect()` Returns the margin rect for this document.
`float`	`getMarginRight()` Returns the margin rects right value.
`float`	`getMarginTop()` Returns the margin rects top value.
`float`	`getMaxTime()` Returns the total time needed to animate this document (total of all page animators).
`java.lang.String`	`getNullString()` Returns the string used to replace any occurrances of null values in a generated report.
`RMPage`	`getPage(int index)` Returns the page at the given index.
`int`	`getPageCount()` Returns the number of pages in this document.
`RMPage`	`getPageLast()` Returns the last page (convenience).
`byte`	`getPageLayout()` Returns the page layout for the document.
`java.util.List<RMPage>`	`getPages()` Returns the list of pages associated with this document.
`RMSize`	`getPageSize()` Returns the size of a document page.
`java.lang.Boolean`	`getPaginate()` Returns whether the document should paginate generated reports by default.
`float`	`getPointsFromUnits(float aValue)` Converts given value from document units to printer points (1/72 of an inch).
`java.lang.String`	`getPublishUrl()` Returns the URL this document should be uploaded to.
`com.reportmill.base.ReportMill`	`getReportMill()` Returns the reportmill associated with the document.
`RMPage`	`getSelectedPage()` Returns the currently selected page of this document.
`int`	`getSelectedPageIndex()` Returns the current page index of this document.
`boolean`	`getShowGrid()` Returns whether the document should show an alignment grid.
`boolean`	`getShowMargin()` Returns whether the document should show a margin rect.
`boolean`	`getSnapGrid()` Returns whether the document should snap to an alignment grid.
`boolean`	`getSnapMargin()` Returns whether the document should snap to a margin rect.
`java.lang.String`	`getStringCSV()` Returns the document as a string of a CSV file.
`java.lang.String`	`getStringDelimitedText(java.lang.String fieldDelimiter, java.lang.String recordDelimiter, boolean quoteFields)` Returns the document as a string of a delimited text file.
`com.reportmill.base.RMUndoer`	`getUndoer()` Returns the RMUndoer for this document.
`int`	`getUnit()` Returns the units used to express sizes in the current document (POINTS, INCHES, CENTIMETERS).
`float`	`getUnitsFromPoints(float aValue)` Converts given value to document units from printer points (1/72 of an inch).
`float`	`getUnitsMultiplier()` Returns the multiplier used to convert printer points to document units.
`java.lang.String`	`getUnitString()` Returns the units used to express sizes in the current document as one of the strings: point, inch or cm.
`float`	`getVersion()` Returns the version this document was loaded as.
`com.reportmill.archiver.RXElement`	`getWindowXML()` Returns the xml element for the document window.
`boolean`	`isEditing()` Returns whether the document is visible in an editor.
`boolean`	`isShowing()` Returns whether the document is visible in a viewer or editor.
`void`	`paintShape(com.reportmill.shape.RMShapePainter aPainter, java.awt.Graphics2D aGraphics)` Overrides paint shape, because document should never really paint itself.
`byte[]`	`pdfBytes()` Obsolete method for old pdfBytes() method.
`void`	`rebuild()` Rebuilds the document according to the selected page and page layout.
`com.reportmill.binder.RMBinder`	`removeBinder(int anIndex)` Removes a binder at the given index from the panel.
`int`	`removeBinder(com.reportmill.binder.RMBinder aBinder)` Removes a binder from the panel.
`RMPage`	`removePage(int anIndex)` Removes the page at the given index from this document.
`void`	`repaint()` Make sure document registers for repaint too.
`void`	`repaint(RMShape aShape)` This is a notification call for impending visual shape attribute changes.
`void`	`resolvePageReferences()` Performs page substitutions on any text fields that were identified as containing @Page@ keys.
`void`	`setCompress(boolean aValue)` Sets whether the document should compress images in generated file formats like PDF.
`void`	`setDataSource(RMDataSource aDataSource)` Sets the RMDataSource associated with this document.
`void`	`setFilename(java.lang.String aPath)` Sets the filename associated with this document.
`void`	`setGridSpacing(float aValue)` Sets the grid spacing for the document's grid.
`void`	`setMarginRect(RMRect aRect)` Sets the margin rect for this document.
`void`	`setMargins(float left, float right, float top, float bottom)` Sets the margin rect for this document.
`void`	`setNullString(java.lang.String aValue)` Sets the string used to replace any occurrances of null values in a generated report.
`void`	`setPageLayout(byte aValue)` Sets the page layout for the document.
`void`	`setPageSize(float aWidth, float aHeight)` Sets the size of the document (and all of its pages).
`void`	`setPaginate(java.lang.Boolean aValue)` Sets whether the document should paginate generated reports by default.
`void`	`setPublishUrl(java.lang.String aValue)` Sets the URL this document should be uploaded to.
`void`	`setReportMill(com.reportmill.base.ReportMill aReportMill)` Creates an RPG clone of document.
`void`	`setSelectedPage(RMPage aPage)` Selects the given page.
`void`	`setSelectedPageIndex(int anIndex)` Selects the currently selected page by index.
`void`	`setShowGrid(boolean aValue)` Sets whether the document should show an alignment grid.
`void`	`setShowMargin(boolean aValue)` Sets whether the document should show a margin rect.
`void`	`setSnapGrid(boolean aValue)` Sets whether the document should snap to an alignment grid.
`void`	`setSnapMargin(boolean aValue)` Sets whether the document should snap to a margin rect.
`void`	`setUndoer(com.reportmill.base.RMUndoer anUndoer)` Sets the RMUndoer for this document.
`void`	`setUnit(byte aValue)` Sets the units used to express sizes in the current document (POINTS, INCHES, CENTIMETERS).
`void`	`setUnitString(java.lang.String aValue)` Sets the units used to express sizes in the current document with one of the strings: point, inch or cm.
`void`	`setWindowXML(com.reportmill.archiver.RXElement anElement)` Sets the xml element for the document window.
`boolean`	`superSelectable()` Editor method indicates that document is super selectable.
`com.reportmill.archiver.RXElement`	`toXML()` Returns RXElement for document.
`com.reportmill.archiver.RXElement`	`toXMLShape(com.reportmill.archiver.RXArchiver anArchiver, java.lang.Object anOwner)` XML archival.
`void`	`toXMLShapeChildren(com.reportmill.archiver.RXArchiver anArchiver, com.reportmill.archiver.RXElement anElement, java.lang.Object anOwner)` XML archival of children.
`void`	`write(java.io.File aFile)` Writes the document to the given File object
`void`	`write(java.lang.String aPath)` Writes the document out to the given path String (it extracts type from path extension).
`java.util.Map`	`writeHTML(java.lang.String aPath)` Writes the document to the given path String as HTML.
`java.util.Map`	`writeHTML(java.lang.String aPath, java.lang.String anImageRoot)` Writes the document to the given path String as HTML (referenced images are written at the given relative path).
`void`	`writePDF(java.lang.String aPath)` Writes the document to the given path String as PDF.

Methods inherited from class com.reportmill.shape.RMShape
acceptsMouse, addBinding, addChild, addChild, animUpdate, bounds, boundsChanged, bringShapesToFront, checkBindings, contains, convertedPointFromShape, convertedPointToShape, convertedRectFromShape, convertedRectToShape, convertedSizeFromShape, convertedSizeToShape, convertedVectorFromShape, convertedVectorToShape, convertFromShape, convertPathFromShape, convertPathToShape, convertPointFromShape, convertPointToShape, convertRectFromShape, convertRectToShape, convertSizeFromShape, convertSizeToShape, convertToShape, convertVectorFromShape, convertVectorToShape, copyShape, createDivideShapeRemainder, createPartClone, divideShapeFromEdge, divideShapeFromTop, doLayout, firePropertyChange, fromXML, get, getAction, getAncestor, getAncestorCount, getAncestorInCommon, getAnim, getAnim, getAnimator, getAnimator, getAspectMapped, getAspects, getAutosizeHeight, getAutosizing, getBinding, getBinding, getBindingCount, getBounds, getBoundsInside, getBoundsMarked, getBoundsMarkedDeep, getBoundsOfChildren, getCausesWrap, getCausesWrapType, getChild, getChildAnimator, getChildAnimator, getChildArray, getChildClipShape, getChildContaining, getChildCount, getChildCountHitable, getChildCountLayout, getChildCountVisible, getChildHitable, getChildLast, getChildLayout, getChildren, getChildrenIntersecting, getChildrenWhoCauseWrap, getChildrenWithClass, getChildrenWithClass, getChildVisible, getChildWithClass, getChildWithName, getClipShape, getColor, getDatasetKey, getEffect, getFill, getFill, getFillCount, getFont, getFormat, getFrame, getFrame, getFrameMaxX, getFrameMaxY, getFrameX, getFrameXY, getFrameY, getHeight, getHeightToFit, getImageFill, getLayout, getLineWidth, getMaskPath, getMaxX, getMaxY, getName, getOpacity, getOpacityDeep, getOriginal, getOutline, getPageBreak, getPageBreakMax, getPageBreakPage, getPageBreakPageMax, getPageShape, getParent, getParentWithClass, getPart, getPartCount, getPartDeep, getPartDeepCount, getPath, getPathInBounds, getRoll, getRootShape, getScaleX, getScaleY, getShapesToAncestor, getShapesToDescendant, getShapesToShape, getSize, getSizeP, getSkewX, getSkewY, getStroke, getStrokeColor, getTextColor, getTransform, getTransformFromShape, getTransformInverse, getTransformToShape, getUrl, getVisbileBounds, getVisibleBounds, getVisibleBounds, getVisibleBounds, getWidth, getWidthToFit, getX, getXY, getXYP, getY, height, indexOf, indexOfChild, intersects, isAncestor, isAnimProperty, isDescendant, isLocked, isMouseDown, isMouseOver, isRoot, isUnderlined, isValid, isViewing, isVisible, layoutReset, mouseDragged, mouseEntered, mouseExited, mouseMoved, mousePressed, mouseReleased, notRSS, offsetChildrenXY, offsetXY, page, pageMax, paint, paintShapeAll, paintShapeChildren, paintShapeOver, propertyChange, put, removeBinding, removeBinding, removeChild, removeChild, removeChildren, removeFromParent, resolvePageReferences, revalidate, sendShapesToBack, setAction, setAnim, setAutosizeHeight, setAutosizing, setBounds, setBounds, setCausesWrap, setCausesWrapType, setColor, setEffect, setFill, setFont, setFormat, setFrame, setFrame, setFrameSize, setFrameX, setFrameXY, setFrameXY, setFrameY, setHeight, setHeightToFit, setLayout, setLayoutEnabled, setLineWidth, setLocked, setName, setOpacity, setOutline, setParent, setReportMillBindings, setReportMillDeep, setRoll, setScaleX, setScaleXY, setScaleY, setSize, setSize, setSizeP, setSizeToFit, setSizeToFit, setSkewX, setSkewXY, setSkewY, setStroke, setStrokeColor, setTextColor, setTime, setUnderlined, setUrl, setVisible, setWidth, setWidthToFit, setX, setXY, setXY, setXYP, setY, shapeHidden, shapeShown, sizesToFitChildren, toString, toXML, undoerDisable, undoerEnable, undoerSetUndoTitle, validate, width, x, y

Methods inherited from class com.reportmill.shape.RMShape

acceptsMouse, addBinding, addChild, addChild, animUpdate, bounds, boundsChanged, bringShapesToFront, checkBindings, contains, convertedPointFromShape, convertedPointToShape, convertedRectFromShape, convertedRectToShape, convertedSizeFromShape, convertedSizeToShape, convertedVectorFromShape, convertedVectorToShape, convertFromShape, convertPathFromShape, convertPathToShape, convertPointFromShape, convertPointToShape, convertRectFromShape, convertRectToShape, convertSizeFromShape, convertSizeToShape, convertToShape, convertVectorFromShape, convertVectorToShape, copyShape, createDivideShapeRemainder, createPartClone, divideShapeFromEdge, divideShapeFromTop, doLayout, firePropertyChange, fromXML, get, getAction, getAncestor, getAncestorCount, getAncestorInCommon, getAnim, getAnim, getAnimator, getAnimator, getAspectMapped, getAspects, getAutosizeHeight, getAutosizing, getBinding, getBinding, getBindingCount, getBounds, getBoundsInside, getBoundsMarked, getBoundsMarkedDeep, getBoundsOfChildren, getCausesWrap, getCausesWrapType, getChild, getChildAnimator, getChildAnimator, getChildArray, getChildClipShape, getChildContaining, getChildCount, getChildCountHitable, getChildCountLayout, getChildCountVisible, getChildHitable, getChildLast, getChildLayout, getChildren, getChildrenIntersecting, getChildrenWhoCauseWrap, getChildrenWithClass, getChildrenWithClass, getChildVisible, getChildWithClass, getChildWithName, getClipShape, getColor, getDatasetKey, getEffect, getFill, getFill, getFillCount, getFont, getFormat, getFrame, getFrame, getFrameMaxX, getFrameMaxY, getFrameX, getFrameXY, getFrameY, getHeight, getHeightToFit, getImageFill, getLayout, getLineWidth, getMaskPath, getMaxX, getMaxY, getName, getOpacity, getOpacityDeep, getOriginal, getOutline, getPageBreak, getPageBreakMax, getPageBreakPage, getPageBreakPageMax, getPageShape, getParent, getParentWithClass, getPart, getPartCount, getPartDeep, getPartDeepCount, getPath, getPathInBounds, getRoll, getRootShape, getScaleX, getScaleY, getShapesToAncestor, getShapesToDescendant, getShapesToShape, getSize, getSizeP, getSkewX, getSkewY, getStroke, getStrokeColor, getTextColor, getTransform, getTransformFromShape, getTransformInverse, getTransformToShape, getUrl, getVisbileBounds, getVisibleBounds, getVisibleBounds, getVisibleBounds, getWidth, getWidthToFit, getX, getXY, getXYP, getY, height, indexOf, indexOfChild, intersects, isAncestor, isAnimProperty, isDescendant, isLocked, isMouseDown, isMouseOver, isRoot, isUnderlined, isValid, isViewing, isVisible, layoutReset, mouseDragged, mouseEntered, mouseExited, mouseMoved, mousePressed, mouseReleased, notRSS, offsetChildrenXY, offsetXY, page, pageMax, paint, paintShapeAll, paintShapeChildren, paintShapeOver, propertyChange, put, removeBinding, removeBinding, removeChild, removeChild, removeChildren, removeFromParent, resolvePageReferences, revalidate, sendShapesToBack, setAction, setAnim, setAutosizeHeight, setAutosizing, setBounds, setBounds, setCausesWrap, setCausesWrapType, setColor, setEffect, setFill, setFont, setFormat, setFrame, setFrame, setFrameSize, setFrameX, setFrameXY, setFrameXY, setFrameY, setHeight, setHeightToFit, setLayout, setLayoutEnabled, setLineWidth, setLocked, setName, setOpacity, setOutline, setParent, setReportMillBindings, setReportMillDeep, setRoll, setScaleX, setScaleXY, setScaleY, setSize, setSize, setSizeP, setSizeToFit, setSizeToFit, setSkewX, setSkewXY, setSkewY, setStroke, setStrokeColor, setTextColor, setTime, setUnderlined, setUrl, setVisible, setWidth, setWidthToFit, setX, setXY, setXY, setXYP, setY, shapeHidden, shapeShown, sizesToFitChildren, toString, toXML, undoerDisable, undoerEnable, undoerSetUndoTitle, validate, width, x, y

Methods inherited from class com.reportmill.base.RMObject
`addListener, addPropertyChangeListener, firePropertyChange, getListener, getListenerCount, getListeners, isFirePropertyChangeEnabled, isUndoing, removeListener, removePropertyChangeListener, setFirePropertyChangeEnabled, setUndoing`

Methods inherited from class java.lang.Object
`getClass, hashCode, notify, notifyAll, wait, wait, wait`

Field Detail

PAGE_LAYOUT_SINGLE

public static final byte PAGE_LAYOUT_SINGLE

See Also:: Constant Field Values

PAGE_LAYOUT_DOUBLE

public static final byte PAGE_LAYOUT_DOUBLE

See Also:: Constant Field Values

PAGE_LAYOUT_QUADRUPLE

public static final byte PAGE_LAYOUT_QUADRUPLE

See Also:: Constant Field Values

PAGE_LAYOUT_FACING

public static final byte PAGE_LAYOUT_FACING

See Also:: Constant Field Values

PAGE_LAYOUT_CONTINUOUS

public static final byte PAGE_LAYOUT_CONTINUOUS

See Also:: Constant Field Values

PAGE_LAYOUT_CONTINUOUS_DOUBLE

public static final byte PAGE_LAYOUT_CONTINUOUS_DOUBLE

See Also:: Constant Field Values

UNIT_INCHES

public static final byte UNIT_INCHES

See Also:: Constant Field Values

UNIT_POINTS

public static final byte UNIT_POINTS

See Also:: Constant Field Values

UNIT_CM

public static final byte UNIT_CM

See Also:: Constant Field Values

UNIT_MM

public static final byte UNIT_MM

See Also:: Constant Field Values

UNIT_PICA

public static final byte UNIT_PICA

See Also:: Constant Field Values

SUPPORTED_UNITS

public static final java.lang.String[] SUPPORTED_UNITS

_locale

public static java.util.Locale _locale

Constructor Detail

RMDocument

public RMDocument()

Creates a plain empty document. It's really only used by the archiver.

RMDocument

public RMDocument(float aWidth,
                  float aHeight)

Creates a document with the given width and height (in printer points).

RMDocument

public RMDocument(java.lang.Object aSource)

Creates a new document from the given source.

Method Detail

getDoc

public static RMDocument getDoc(java.lang.Object aSource)

Creates a new document from aSource using RMArchiver.

getFilename

public java.lang.String getFilename()

Returns the filename associated with this document, if available.

setFilename

public void setFilename(java.lang.String aPath)

Sets the filename associated with this document.

getVersion

public float getVersion()

Returns the version this document was loaded as.

getPageCount

public int getPageCount()

Returns the number of pages in this document.

getPage

public RMPage getPage(int index)

Returns the page at the given index.

getPageLast

public RMPage getPageLast()

Returns the last page (convenience).

getPages

public java.util.List<RMPage> getPages()

Returns the list of pages associated with this document.

addPage

public void addPage(RMPage aPage)

Adds a given page to this document.

addPage

public void addPage(RMPage aPage,
                    int anIndex)

Adds a given page to this document at the given index.

removePage

public RMPage removePage(int anIndex)

Removes the page at the given index from this document.

addPages

public void addPages(RMDocument aDoc)

Add the pages in the given document to this document (at end) and clears the pages list in the given document.

getSelectedPage

public RMPage getSelectedPage()

Returns the currently selected page of this document.

setSelectedPage

public void setSelectedPage(RMPage aPage)

Selects the given page.

getSelectedPageIndex

public int getSelectedPageIndex()

Returns the current page index of this document.

setSelectedPageIndex

public void setSelectedPageIndex(int anIndex)

Selects the currently selected page by index.

getPageLayout

public byte getPageLayout()

Returns the page layout for the document.

setPageLayout

public void setPageLayout(byte aValue)

Sets the page layout for the document.

getUnit

public int getUnit()

Returns the units used to express sizes in the current document (POINTS, INCHES, CENTIMETERS).

setUnit

public void setUnit(byte aValue)

Sets the units used to express sizes in the current document (POINTS, INCHES, CENTIMETERS).

getUnitString

public java.lang.String getUnitString()

Returns the units used to express sizes in the current document as one of the strings: point, inch or cm.

setUnitString

public void setUnitString(java.lang.String aValue)

Sets the units used to express sizes in the current document with one of the strings: point, inch or cm.

getPointsFromUnits

public float getPointsFromUnits(float aValue)

Converts given value from document units to printer points (1/72 of an inch).

getUnitsFromPoints

public float getUnitsFromPoints(float aValue)

Converts given value to document units from printer points (1/72 of an inch).

getUnitsMultiplier

public float getUnitsMultiplier()

Returns the multiplier used to convert printer points to document units.

getShowGrid

public boolean getShowGrid()

Returns whether the document should show an alignment grid.

setShowGrid

public void setShowGrid(boolean aValue)

Sets whether the document should show an alignment grid.

getSnapGrid

public boolean getSnapGrid()

Returns whether the document should snap to an alignment grid.

setSnapGrid

public void setSnapGrid(boolean aValue)

Sets whether the document should snap to an alignment grid.

getGridSpacing

public float getGridSpacing()

Returns the grid spacing for the document's grid.

setGridSpacing

public void setGridSpacing(float aValue)

Sets the grid spacing for the document's grid.

getShowMargin

public boolean getShowMargin()

Returns whether the document should show a margin rect.

setShowMargin

public void setShowMargin(boolean aValue)

Sets whether the document should show a margin rect.

getSnapMargin

public boolean getSnapMargin()

Returns whether the document should snap to a margin rect.

setSnapMargin

public void setSnapMargin(boolean aValue)

Sets whether the document should snap to a margin rect.

getMarginRect

public RMRect getMarginRect()

Returns the margin rect for this document.

setMarginRect

public void setMarginRect(RMRect aRect)

Sets the margin rect for this document.

setMargins

public void setMargins(float left,
                       float right,
                       float top,
                       float bottom)

Sets the margin rect for this document.

getMarginLeft

public float getMarginLeft()

Returns the margin rects left value.

getMarginRight

public float getMarginRight()

Returns the margin rects right value.

getMarginTop

public float getMarginTop()

Returns the margin rects top value.

getMarginBottom

public float getMarginBottom()

Returns the margin rects bottom value.

getPageSize

public RMSize getPageSize()

Returns the size of a document page.

setPageSize

public void setPageSize(float aWidth,
                        float aHeight)

Sets the size of the document (and all of its pages).

getDataSource

public RMDataSource getDataSource()

Returns the RMDataSource associated with this document.

setDataSource

public void setDataSource(RMDataSource aDataSource)

Sets the RMDataSource associated with this document.

getDataSourceSchema

public RMSchema getDataSourceSchema()

Returns the schema for the RMDataSource associated with this document (convenience).

getDatasetEntity

public RMEntity getDatasetEntity()

Returns the entity this shape should show in keys browser.

Overrides:: getDatasetEntity in class RMShape

getBinderCount

public int getBinderCount()

Returns the number of binders for this panel.

getBinder

public com.reportmill.binder.RMBinder getBinder(int anIndex)

Returns the specific binder at the given index.

getBinders

public java.util.List<com.reportmill.binder.RMBinder> getBinders()

Returns the binders list.

getBinder

public com.reportmill.binder.RMBinder getBinder(java.lang.String aName)

Returns the named binder for this panel.

Overrides:: getBinder in class RMShape

addBinder

public void addBinder(com.reportmill.binder.RMBinder aBinder)

Adds a binder to the panel.

removeBinder

public com.reportmill.binder.RMBinder removeBinder(int anIndex)

Removes a binder at the given index from the panel.

removeBinder

public int removeBinder(com.reportmill.binder.RMBinder aBinder)

Removes a binder from the panel.

getPublishUrl

public java.lang.String getPublishUrl()

Returns the URL this document should be uploaded to.

setPublishUrl

public void setPublishUrl(java.lang.String aValue)

Sets the URL this document should be uploaded to.

getNullString

public java.lang.String getNullString()

Returns the string used to replace any occurrances of null values in a generated report.

setNullString

public void setNullString(java.lang.String aValue)

Sets the string used to replace any occurrances of null values in a generated report.

getPaginate

public java.lang.Boolean getPaginate()

Returns whether the document should paginate generated reports by default.

setPaginate

public void setPaginate(java.lang.Boolean aValue)

Sets whether the document should paginate generated reports by default.

getCompress

public boolean getCompress()

Returns whether the document should compress images in generated file formats like PDF.

setCompress

public void setCompress(boolean aValue)

Sets whether the document should compress images in generated file formats like PDF.

getWindowXML

public com.reportmill.archiver.RXElement getWindowXML()

Returns the xml element for the document window.

setWindowXML

public void setWindowXML(com.reportmill.archiver.RXElement anElement)

Sets the xml element for the document window.

generateReport

public RMDocument generateReport()

Returns a generated report from this template evaluated against the given object.

generateReport

public RMDocument generateReport(java.lang.Object objects)

Returns a generated report from this template evaluated against the given object.

generateReport

public RMDocument generateReport(java.lang.Object objects,
                                 java.lang.Object userInfo)

Returns a generated report from this template evaluated against the given object and userInfo.

generateReport

public RMDocument generateReport(java.lang.Object objects,
                                 boolean paginate)

Returns a generated report from this template evaluated against the given object with an option to paginate.

generateReport

public RMDocument generateReport(java.lang.Object objects,
                                 java.lang.Object userInfo,
                                 boolean paginate)

Returns generated report from this template evaluated against given object/userInfo (with option to paginate).

getBytes

public byte[] getBytes()

Returns the document as an XML byte array.

getBytesPDF

public byte[] getBytesPDF()

Returns the document as a byte array of a PDF file.

getBytesHTML

public byte[] getBytesHTML()

Returns the document as a byte array of an HTML file.

getBytesFlash

public byte[] getBytesFlash()

Returns the document as a byte array of a Flash file.

getBytesCSV

public byte[] getBytesCSV()

Returns the document as a byte array of a CSV file.

getBytesDelimitedAscii

public byte[] getBytesDelimitedAscii(java.lang.String fieldDelimiter,
                                     java.lang.String recordDelimiter,
                                     boolean quoteFields)

Returns the document as a byte array of a delimited ASCII file (using given field, record separator strings).

getBytesExcel

public byte[] getBytesExcel()

Returns the document as byte array of an Excel file.

getBytesRTF

public byte[] getBytesRTF()

Returns the document as byte array of an Excel file.

getBytesJPEG

public byte[] getBytesJPEG()

Returns the document as byte array of a JPEG file.

getBytesPNG

public byte[] getBytesPNG()

Returns the document as byte array of PNG file.

getMapHTML

public java.util.Map getMapHTML(java.lang.String anImageRoot)

Returns the document as a Map of an HTML file and image resources.

getStringCSV

public java.lang.String getStringCSV()

Returns the document as a string of a CSV file.

getStringDelimitedText

public java.lang.String getStringDelimitedText(java.lang.String fieldDelimiter,
                                               java.lang.String recordDelimiter,
                                               boolean quoteFields)

Returns the document as a string of a delimited text file.

write

public void write(java.lang.String aPath)

Writes the document out to the given path String (it extracts type from path extension).

write

public void write(java.io.File aFile)

Writes the document to the given File object

writePDF

public void writePDF(java.lang.String aPath)

Writes the document to the given path String as PDF.

writeHTML

public java.util.Map writeHTML(java.lang.String aPath)

Writes the document to the given path String as HTML.

writeHTML

public java.util.Map writeHTML(java.lang.String aPath,
                               java.lang.String anImageRoot)

Writes the document to the given path String as HTML (referenced images are written at the given relative path).

rebuild

public void rebuild()

Rebuilds the document according to the selected page and page layout.

getMaxTime

public float getMaxTime()

Returns the total time needed to animate this document (total of all page animators).

getDocument

public RMDocument getDocument()

Returns the document itself (over-ridden from RMShape).

Overrides:: getDocument in class RMShape

getAnimator

public com.reportmill.graphics.RMAnimator getAnimator(int anIndex)

Returns the animator for a specific page.

getAnimatorLast

public com.reportmill.graphics.RMAnimator getAnimatorLast()

Returns the animator for the last page.

getLoops

public boolean getLoops()

Returns whether the last animator loops.

getUndoer

public com.reportmill.base.RMUndoer getUndoer()

Returns the RMUndoer for this document.

Overrides:: getUndoer in class RMShape

setUndoer

public void setUndoer(com.reportmill.base.RMUndoer anUndoer)

Sets the RMUndoer for this document.

getDocListener

public RMDocument.DocListener getDocListener()

Returns the first doc listener from listeners list.

isShowing

public boolean isShowing()

Returns whether the document is visible in a viewer or editor.

Overrides:: isShowing in class RMShape

isEditing

public boolean isEditing()

Returns whether the document is visible in an editor.

Overrides:: isEditing in class RMShape

repaint

public void repaint()

Make sure document registers for repaint too.

Overrides:: repaint in class RMShape

repaint

public void repaint(RMShape aShape)

This is a notification call for impending visual shape attribute changes.

Overrides:: repaint in class RMShape

paintShape

public void paintShape(com.reportmill.shape.RMShapePainter aPainter,
                       java.awt.Graphics2D aGraphics)

Overrides paint shape, because document should never really paint itself.

Overrides:: paintShape in class RMShape

boundsChanged

public void boundsChanged(RMShape aShape)

Notifies this shape that a given shape's bounds have changed (presumably a descendant).

Overrides:: boundsChanged in class RMShape

getReportMill

public com.reportmill.base.ReportMill getReportMill()

Returns the reportmill associated with the document.

Overrides:: getReportMill in class RMShape

setReportMill

public void setReportMill(com.reportmill.base.ReportMill aReportMill)

Creates an RPG clone of document.

Overrides:: setReportMill in class RMShape

resolvePageReferences

public void resolvePageReferences()

Performs page substitutions on any text fields that were identified as containing @Page@ keys.

createLayout

public com.reportmill.shape.RMShapeLayout createLayout()

Overrides shape version to provide null layout by default.

Overrides:: createLayout in class RMShape

equals

public boolean equals(java.lang.Object anObj)

Standard equals implementation.

Overrides:: equals in class RMShape

clone

public RMDocument clone()

Copies basic document attributes (shallow copy only - no children or pages).

Overrides:: clone in class RMShape

cloneDeep

public RMDocument cloneDeep()

Copies the complete document, including document pages and all their children.

Overrides:: cloneDeep in class RMShape

toXML

public com.reportmill.archiver.RXElement toXML()

Returns RXElement for document.

toXMLShape

public com.reportmill.archiver.RXElement toXMLShape(com.reportmill.archiver.RXArchiver anArchiver,
                                                    java.lang.Object anOwner)

XML archival.

Overrides:: toXMLShape in class RMShape

toXMLShapeChildren

public void toXMLShapeChildren(com.reportmill.archiver.RXArchiver anArchiver,
                               com.reportmill.archiver.RXElement anElement,
                               java.lang.Object anOwner)

XML archival of children.

Overrides:: toXMLShapeChildren in class RMShape

fromXMLShape

public java.lang.Object fromXMLShape(com.reportmill.archiver.RXArchiver anArchiver,
                                     com.reportmill.archiver.RXElement anElement,
                                     java.lang.Object anOwner)

XML unarchival.

Overrides:: fromXMLShape in class RMShape

fromXMLShapeChildren

public void fromXMLShapeChildren(com.reportmill.archiver.RXArchiver anArchiver,
                                 com.reportmill.archiver.RXElement anElement,
                                 java.lang.Object anOwner)

XML unarchival for shape children.

Overrides:: fromXMLShapeChildren in class RMShape

superSelectable

public boolean superSelectable()

Editor method indicates that document is super selectable.

Overrides:: superSelectable in class RMShape

childrenSuperSelectImmediately

public boolean childrenSuperSelectImmediately()

Editor method indicates that pages super select immediately.

Overrides:: childrenSuperSelectImmediately in class RMShape

acceptsChildren

public boolean acceptsChildren()

Editor method indicates that document accepts children (should probably be false).

Overrides:: acceptsChildren in class RMShape

pdfBytes

public byte[] pdfBytes()

Obsolete method for old pdfBytes() method.

Overview

Package

Class

Tree

Deprecated

Index

Help

ReportMill 11 API

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.reportmill.shape Class RMDocument

PAGE_LAYOUT_SINGLE

PAGE_LAYOUT_DOUBLE

PAGE_LAYOUT_QUADRUPLE

PAGE_LAYOUT_FACING

PAGE_LAYOUT_CONTINUOUS

PAGE_LAYOUT_CONTINUOUS_DOUBLE

UNIT_INCHES

UNIT_POINTS

UNIT_CM

UNIT_MM

UNIT_PICA

SUPPORTED_UNITS

_locale

RMDocument

RMDocument

RMDocument

getDoc

getFilename

setFilename

getVersion

getPageCount

getPage

getPageLast

getPages

addPage

addPage

removePage

addPages

getSelectedPage

setSelectedPage

getSelectedPageIndex

setSelectedPageIndex

getPageLayout

setPageLayout

getUnit

setUnit

getUnitString

setUnitString

getPointsFromUnits

getUnitsFromPoints

getUnitsMultiplier

getShowGrid

setShowGrid

getSnapGrid

setSnapGrid

getGridSpacing

setGridSpacing

getShowMargin

setShowMargin

getSnapMargin

setSnapMargin

getMarginRect

setMarginRect

setMargins

getMarginLeft

getMarginRight

getMarginTop

getMarginBottom

getPageSize

setPageSize

getDataSource

setDataSource

getDataSourceSchema

getDatasetEntity

getBinderCount

getBinder

getBinders

getBinder

addBinder

removeBinder

removeBinder

getPublishUrl

setPublishUrl

getNullString

setNullString

getPaginate

setPaginate

getCompress

setCompress

com.reportmill.shape
Class RMDocument