Klasse ReportProperties

java.lang.Object
com.inet.report.ReportProperties
Alle implementierten Schnittstellen:
NodeParser, Serializable

public class ReportProperties extends Object implements Serializable, NodeParser
The report properties describes global options for a report or sub report.
Siehe auch:
  • Feldübersicht

    Felder
    Modifikator und Typ
    Feld
    Beschreibung
    static final int
    Paper orientation is system default.
    static final int
    Paper size is system default.
    static final int
    Paper orientation is landscape.
    static final int[]
    The sizes of all currently supported page formats in twips.
    static final int
    Paper size is 10 x 11 in.
    static final int
    Paper size is 10 x 14 in.
    static final int
    Paper size is 11 x 17 in.
    static final int
    Paper size is 15 x 11 in.
    static final int
    Paper size is 9 x 11 in.
    static final int
    Paper size is A2, 420 x 594 mm.
    static final int
    Paper size is A3, 297 x 420 mm.
    static final int
    Paper size is A4, 210 x 297 mm.
    static final int
    Paper size is A4 SMALL, 210 x 297 mm.
    static final int
    Paper size is A5, 148 x 210 mm.
    static final int
    Paper size is B4 (JIS), 257 x 364 mm.
    static final int
    Paper size is B4 (ISO), 250 x 353 mm.
    static final int
    Paper size is B5 (JIS), 182 x 257 mm.
    static final int
    Paper size is C size sheet, 431,7 x 558,7 mm.
    static final int
    Paper size is D size sheet, 558,7 x 863,4 mm .
    static final int
    Paper size is E size sheet, 863,4 x 1117,4 mm.
    static final int
    Paper size is Envelope #10, 4 1/8 x 9 1/2 in.
    static final int
    Paper size is Envelope #11, 4 1/2 x 10 3/8 in.
    static final int
    Paper size is Envelope #12, 4 3/4 x 11 in.
    static final int
    Paper size is Envelope #14, 5 x 11 1/2 in.
    static final int
    Paper size is Envelope #9, 3 7/8 x 8 7/8 in.
    static final int
    Paper size is Envelope B4, 250 x 353 mm.
    static final int
    Paper size is Envelope B5, 176 x 250 mm.
    static final int
    Paper size is Envelope B6, 176 x 125 mm.
    static final int
    Paper size is Envelope C3, 324 x 458 mm.
    static final int
    Paper size is Envelope C4, 229 x 324 mm.
    static final int
    Paper size is Envelope C5, 162 x 229 mm.
    static final int
    Paper size is Envelope C6, 114 x 162 mm.
    static final int
    Paper size is Envelope C65, 114 x 229 mm.
    static final int
    Paper size is Envelope DL, 110 x 220 mm.
    static final int
    Paper size is Envelope Italy, 110 x 230 mm.
    static final int
    Paper size is Envelope Monarch, 3 7/8 x 7 1/2 in.
    static final int
    Paper size is 6 3/4 Envelope, 3 5/8 x 6 1/2 in.
    static final int
    Paper size is Executive, 7 1/4 x 10 1/2 in.
    static final int
    Paper size is German Legal Fanfold, 8 1/2 x 13 in.
    static final int
    Paper size is German Standard Fanfold, 8 1/2 x 12 in.
    static final int
    Paper size is US Standard Fanfold, 14 7/8 x 11 in.
    static final int
    Paper size is Folio, 8 1/2 x 13 in.
    static final int
    Paper size is Japanese Postcard, 100 x 148 mm.
    static final int
    Paper size is Ledger, 17 x 11 in.
    static final int
    Paper size is Legal, 8 1/2 x 14 in.
    static final int
    Paper size is LETTER, 8 1/2 x 11 in.
    static final int
    Paper size is Letter Small, 8 1/2 x 11 in.
    static final int
    The last possible paper.
    static final int
    Paper size is Note, 8 1/2 x 11 in.
    static final int
    Paper size is Quarto, 215 x 275 mm.
    static final int
    Paper size is Statement, 5 1/2 x 8 1/2 in.
    static final int
    Paper size is Tabloid, 11 x 17 in.
    static final int
    Paper orientation is portrait.
    static final int
    User Defined Paper Size
  • Methodenübersicht

    Modifikator und Typ
    Methode
    Beschreibung
    static int
    findPaperFormat(int x, int y, boolean isLandscape)
    Find the best best match for paper format.
    Returns the valid output formats for this report.
    int
    Returns the horizontal gap between multi-column labels.
    int
    Returns the height of a multi-column label.
    Returns the name of a multi-column label.
    This will return the complete name for predefined labels of the i-net designer or the name you set before with setLabelName(String).
    int
    Returns the width of a multi-column label.
    int
    Returns the bottom margin of the page in twips.
    int
    Returns the left margin of the page in twips.
    int
    Returns the right margin of the page in twips.
    int
    Returns the top margin of the page in twips.
    int
    Returns the format of the paper as a constant.
    int
    Returns the height of the report page in twips.
    int
    Returns the orientation of the paper.
    int
    Returns the width of the report page in twips.
    Returns the default formula/resource locale defined for the current report.
    int
    Returns the number of rows which will be cached in the row buffer.
    int
    Returns the vertical gap between multi-column labels.
    int
    Returns the major version of the report XML of the template underlying this report.
    int
    Returns the minor version of the report XML of the template underlying this report.
    boolean
    Returns the printing direction of a multi-column report.
    boolean
    Returns true if the report comes from i-net Clear Reports file format, else false.
    boolean
    Returns whether the clipboard is enabled for the Java Viewer, that is, whether it is possible to copy text from the Viewer to the clipboard.
    boolean
    If convertNullValuesToDefault is set to true the report will convert null values from the database to a 0 (for numeric fields) or a blank (for non-numeric fields).
    boolean
    Returns the value of the property 'distinct'.
    boolean
    FOR INTERNAL USE ONLY Internal method for reading report XML
    boolean
    Returns the flag ExportEnabled for this report.
    boolean
    Should be group header/footer be treated as an ordinary label in a multi-column report?
    boolean
    Test if the detail section of the report should be formatted in multiple columns of variable or fixed (labels) length.
    boolean
    Returns the flag FormPrint for this report.
    boolean
    Returns the flag GroupTreeVisible for this report.
    boolean
    Returns the value of the flag "Hide PageFooter inside ReportHeader".
    boolean
    Veraltet.
    As of i-net Clear Reports 15, instead remove the record selection from the report with Report.setRecordSelectionFormula(FormulaField)
    boolean
    Veraltet.
    As of i-net Clear Reports 15, instead remove sort fields from the report with Fields.removeSortField(int)
    boolean
    Returns if printing is enabled for this report.
    boolean
    Returns true if the used datasource configurations should save in the report file.
    boolean
    Returns the flag that controls the group tree nodes of suppressed group areas will be shown.
    boolean
    If suppressIfNoRows is set to true the (sub)report will only be printed if rows are fetched from the database.
    boolean
    Returns whether or not this report is suited for buffering of rows.
    void
    parseDOM(Node node, Map<String,Object> parserMap)
    FOR INTERNAL USE ONLY Internal method for reading report XML
    parseElement(com.inet.report.parser.XMLTag group, String tag, Attributes atts, Map<String,Object> parserMap)
    FOR INTERNAL USE ONLY Internal method for reading report XML
    void
    parseEndElement(com.inet.report.parser.XMLTag group, String tag, Map<String,Object> parserMap)
    FOR INTERNAL USE ONLY Internal method for reading report XML
    void
    parseText(String text, Map<String,Object> parserMap)
    FOR INTERNAL USE ONLY Internal method for reading report XML
    void
    setAcrossThenDown(boolean acrossThenDown)
    Sets the printing direction of a multi-column report.
    void
    setClipboardEnabled(boolean value)
    Enable the clipboard of the new Java Viewer.
    void
    setConvertNullValuesToDefault(boolean convertNullValuesToDefault)
    If convertNullValuesToDefault is set to true the report will convert null values from the database to a 0 (for numeric fields) or a blank (for non-numeric fields).
    void
    setDistinct(boolean distinct)
    Set the value of the property 'distinct'.
    void
    Sets a list of valid formats, that is, which formats it is possible to render.
    void
    setExportEnabled(boolean value)
    Enable or disable the export button and the export API of the new Java Viewer.
    void
    setFormatGroupsWithMultipleColumn(boolean formatGroupsWithMultipleColumn)
    Should be group header/footer be treated as an ordinary label in a multi-column report?
    void
    Sets if the detail section of the report should be formatted in multiple columns of variable or fixed (labels) length.
    void
    setFormPrint(boolean value)
    Determines whether this report is a form - forms are never automatically resized if the designed margins are larger than the printable area, rather, the area which is not printable is truncated instead.
    void
    setGroupTreeVisible(boolean value)
    Enable or disable the GroupTree of the Java Viewer.
    void
    setHidePageFooterInsideReportHeader(boolean hidePageFooterInsideReportHeader)
    Set value of the flag "Hide PageFooter inside ReportHeader".
    void
    setHorizontal(int horizontal)
    Sets the horizontal gap between multi-column labels.
    void
    setIgnoreFiltering(boolean ignoreFiltering)
    Veraltet.
    As of i-net Clear Reports 15, instead remove the record selection from the report with Report.setRecordSelectionFormula(FormulaField)
    void
    setIgnoreSorting(boolean ignoreSorting)
    Veraltet.
    As of i-net Clear Reports 15, instead remove sort fields from the report with Fields.removeSortField(int)
    void
    setLabelHeight(int labelHeight)
    Sets the height of a multi-column label.
    void
    Sets the label name, such as "User Defined Label" or "Address"
    void
    setLabelWidth(int labelWidth)
    Sets the width of a multi-column label.
    void
    setMarginBottom(int margin)
    Sets the bottom margin of the page in twips.
    void
    setMarginLeft(int margin)
    Sets the left margin of the page in twips.
    void
    setMarginRight(int margin)
    Sets the right margin of the page in twips.
    void
    setMarginTop(int margin)
    Sets the top margin of the page in twips.
    void
    setPaperHeight(int height)
    Sets the height of the report page in twips.
    1 pica = 1/6 inch
    1 point = 1/12 pica
    1 twip = 1/20 point or 20 twips = 1 point
    1 twip = 1/567 centimeter or 567 twips = 1 centimeter
    1 twip = 1/1440 inch or 1440 twips = 1 inch
    void
    setPaperOrient(int paperOrientation, int paperSize)
    Sets the orientation and size of the report for printing.
    void
    setPaperSize(int paperOrient, int paperFormat)
    Sets the paper width and paper height depending on the supplied paper format and orientation.
    void
    setPaperWidth(int width)
    Sets the width of the report page in twips.
    1 pica = 1/6 inch
    1 point = 1/12 pica
    1 twip = 1/20 point or 20 twips = 1 point
    1 twip = 1/567 centimeter or 567 twips = 1 centimeter
    1 twip = 1/1440 inch or 1440 twips = 1 inch
    void
    setPrintingEnabled(boolean value)
    Enable or disable the print button and the print API of the Java Viewer.
    void
    setReportLocale(Locale reportLocale)
    Sets the formula/resource default locale for the current report.
    void
    setRowBufferSize(int rowCount)
    Sets the row count which will be cached during the rendering process.
    void
    setSaveDatasource(boolean save)
    Set the flag if a copy of the datasource configuration should be saved in the report file.
    void
    setShowSuppressedGroupTreeNodes(boolean showSuppressedGroupTreeNodes)
    Sets the flag that controls the group tree nodes of suppressed group areas will be shown.
    void
    setSuppressIfNoRows(boolean suppressIfNoRows)
    If suppressIfNoRows is set to true the (sub)report will only be printed if rows are fetched from the database.
    void
    setVertical(int vertical)
    Sets the vertical gap between multi-column labels.

    Von Klasse geerbte Methoden Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Felddetails

    • DEFAULT_PAPER_ORIENTATION

      public static final int DEFAULT_PAPER_ORIENTATION
      Paper orientation is system default.
      Siehe auch:
    • PORTRAIT

      public static final int PORTRAIT
      Paper orientation is portrait.
      Siehe auch:
    • LANDSCAPE

      public static final int LANDSCAPE
      Paper orientation is landscape.
      Siehe auch:
    • DEFAULT_PAPERSIZE

      public static final int DEFAULT_PAPERSIZE
      Paper size is system default.
      Siehe auch:
    • PAPER_LETTER

      public static final int PAPER_LETTER
      Paper size is LETTER, 8 1/2 x 11 in.
      Siehe auch:
    • PAPER_LETTER_SMALL

      public static final int PAPER_LETTER_SMALL
      Paper size is Letter Small, 8 1/2 x 11 in.
      Siehe auch:
    • PAPER_TABLOID

      public static final int PAPER_TABLOID
      Paper size is Tabloid, 11 x 17 in.
      Siehe auch:
    • PAPER_LEDGER

      public static final int PAPER_LEDGER
      Paper size is Ledger, 17 x 11 in.
      Siehe auch:
    • PAPER_STATEMENT

      public static final int PAPER_STATEMENT
      Paper size is Statement, 5 1/2 x 8 1/2 in.
      Siehe auch:
    • PAPER_EXECUTIVE

      public static final int PAPER_EXECUTIVE
      Paper size is Executive, 7 1/4 x 10 1/2 in.
      Siehe auch:
    • PAPER_A3

      public static final int PAPER_A3
      Paper size is A3, 297 x 420 mm.
      Siehe auch:
    • PAPER_A4

      public static final int PAPER_A4
      Paper size is A4, 210 x 297 mm.
      Siehe auch:
    • PAPER_A4_SMALL

      public static final int PAPER_A4_SMALL
      Paper size is A4 SMALL, 210 x 297 mm.
      Siehe auch:
    • PAPER_A5

      public static final int PAPER_A5
      Paper size is A5, 148 x 210 mm.
      Siehe auch:
    • PAPER_B4

      public static final int PAPER_B4
      Paper size is B4 (JIS), 257 x 364 mm.
      Siehe auch:
    • PAPER_B5

      public static final int PAPER_B5
      Paper size is B5 (JIS), 182 x 257 mm.
      Siehe auch:
    • PAPER_FOLIO

      public static final int PAPER_FOLIO
      Paper size is Folio, 8 1/2 x 13 in.
      Siehe auch:
    • PAPER_QUATRO

      public static final int PAPER_QUATRO
      Paper size is Quarto, 215 x 275 mm.
      Siehe auch:
    • PAPER_10_X_14

      public static final int PAPER_10_X_14
      Paper size is 10 x 14 in.
      Siehe auch:
    • PAPER_11_X_17

      public static final int PAPER_11_X_17
      Paper size is 11 x 17 in.
      Siehe auch:
    • PAPER_NOTE

      public static final int PAPER_NOTE
      Paper size is Note, 8 1/2 x 11 in.
      Siehe auch:
    • PAPER_ENVELOPE_9

      public static final int PAPER_ENVELOPE_9
      Paper size is Envelope #9, 3 7/8 x 8 7/8 in.
      Siehe auch:
    • PAPER_ENVELOPE_10

      public static final int PAPER_ENVELOPE_10
      Paper size is Envelope #10, 4 1/8 x 9 1/2 in.
      Siehe auch:
    • PAPER_ENVELOPE_11

      public static final int PAPER_ENVELOPE_11
      Paper size is Envelope #11, 4 1/2 x 10 3/8 in.
      Siehe auch:
    • PAPER_ENVELOPE_12

      public static final int PAPER_ENVELOPE_12
      Paper size is Envelope #12, 4 3/4 x 11 in.
      Siehe auch:
    • PAPER_ENVELOPE_14

      public static final int PAPER_ENVELOPE_14
      Paper size is Envelope #14, 5 x 11 1/2 in.
      Siehe auch:
    • PAPER_C_SHEET

      public static final int PAPER_C_SHEET
      Paper size is C size sheet, 431,7 x 558,7 mm.
      Siehe auch:
    • PAPER_D_SHEET

      public static final int PAPER_D_SHEET
      Paper size is D size sheet, 558,7 x 863,4 mm .
      Siehe auch:
    • PAPER_E_SHEET

      public static final int PAPER_E_SHEET
      Paper size is E size sheet, 863,4 x 1117,4 mm.
      Siehe auch:
    • PAPER_ENVELOPE_DL

      public static final int PAPER_ENVELOPE_DL
      Paper size is Envelope DL, 110 x 220 mm.
      Siehe auch:
    • PAPER_ENVELOPE_C5

      public static final int PAPER_ENVELOPE_C5
      Paper size is Envelope C5, 162 x 229 mm.
      Siehe auch:
    • PAPER_ENVELOPE_C3

      public static final int PAPER_ENVELOPE_C3
      Paper size is Envelope C3, 324 x 458 mm.
      Siehe auch:
    • PAPER_ENVELOPE_C4

      public static final int PAPER_ENVELOPE_C4
      Paper size is Envelope C4, 229 x 324 mm.
      Siehe auch:
    • PAPER_ENVELOPE_C6

      public static final int PAPER_ENVELOPE_C6
      Paper size is Envelope C6, 114 x 162 mm.
      Siehe auch:
    • PAPER_ENVELOPE_C65

      public static final int PAPER_ENVELOPE_C65
      Paper size is Envelope C65, 114 x 229 mm.
      Siehe auch:
    • PAPER_ENVELOPE_B4

      public static final int PAPER_ENVELOPE_B4
      Paper size is Envelope B4, 250 x 353 mm.
      Siehe auch:
    • PAPER_ENVELOPE_B5

      public static final int PAPER_ENVELOPE_B5
      Paper size is Envelope B5, 176 x 250 mm.
      Siehe auch:
    • PAPER_ENVELOPE_B6

      public static final int PAPER_ENVELOPE_B6
      Paper size is Envelope B6, 176 x 125 mm.
      Siehe auch:
    • PAPER_ENVELOPE_ITALY

      public static final int PAPER_ENVELOPE_ITALY
      Paper size is Envelope Italy, 110 x 230 mm.
      Siehe auch:
    • PAPER_ENVELOPE_MONARCH

      public static final int PAPER_ENVELOPE_MONARCH
      Paper size is Envelope Monarch, 3 7/8 x 7 1/2 in.
      Siehe auch:
    • PAPER_ENVELOPE_PERSONAL

      public static final int PAPER_ENVELOPE_PERSONAL
      Paper size is 6 3/4 Envelope, 3 5/8 x 6 1/2 in.
      Siehe auch:
    • PAPER_FANFOLD_US

      public static final int PAPER_FANFOLD_US
      Paper size is US Standard Fanfold, 14 7/8 x 11 in.
      Siehe auch:
    • PAPER_FANFOLD_STD_GERMAN

      public static final int PAPER_FANFOLD_STD_GERMAN
      Paper size is German Standard Fanfold, 8 1/2 x 12 in.
      Siehe auch:
    • PAPER_B4_ISO

      public static final int PAPER_B4_ISO
      Paper size is B4 (ISO), 250 x 353 mm.
      Siehe auch:
    • PAPER_JAPANESE_POSTCARD

      public static final int PAPER_JAPANESE_POSTCARD
      Paper size is Japanese Postcard, 100 x 148 mm.
      Siehe auch:
    • PAPER_9_X_11

      public static final int PAPER_9_X_11
      Paper size is 9 x 11 in.
      Siehe auch:
    • PAPER_10_X_11

      public static final int PAPER_10_X_11
      Paper size is 10 x 11 in.
      Siehe auch:
    • PAPER_15_X_11

      public static final int PAPER_15_X_11
      Paper size is 15 x 11 in.
      Siehe auch:
    • PAPER_MAX

      public static final int PAPER_MAX
      The last possible paper. All integers between DEFAULT_PAPERSIZE and PAPER_MAX are valid.
      Siehe auch:
    • pageSizes

      public static final int[] pageSizes
      The sizes of all currently supported page formats in twips. Returns the size of a page according to a symbol (i.e. ReportProperties.PAPER_A4) with
      ReportProperties.pageSizes[2*(ReportProperties.PAPER_A4-1)]; or
      ReportProperties.pageSizes[(2*(ReportProperties.PAPER_A4-1))+1];
    • PAPER_A2

      public static final int PAPER_A2
      Paper size is A2, 420 x 594 mm.
      Siehe auch:
    • USERDEFINED_PAPER

      public static final int USERDEFINED_PAPER
      User Defined Paper Size
      Siehe auch:
  • Methodendetails

    • isSuppressIfNoRows

      public boolean isSuppressIfNoRows()
      If suppressIfNoRows is set to true the (sub)report will only be printed if rows are fetched from the database. Otherwise nothing will be printed.
      Gibt zurück:
      Returns the suppressIfNoRows.
      Seit:
      6.0
    • setSuppressIfNoRows

      public void setSuppressIfNoRows(boolean suppressIfNoRows)
      If suppressIfNoRows is set to true the (sub)report will only be printed if rows are fetched from the database. Otherwise nothing will be printed.
      Parameter:
      suppressIfNoRows - The suppressIfNoRows to set.
      Seit:
      6.0
    • setDistinct

      public void setDistinct(boolean distinct)
      Set the value of the property 'distinct'. If it is true then duplicated records will not be fetched.
      Parameter:
      distinct - true if distinct records should be fetched only, else false.
      Seit:
      6.1
    • isDistinct

      public boolean isDistinct()
      Returns the value of the property 'distinct'. If true duplicated records will not be fetched.
      Gibt zurück:
      true if distinct records should be fetched only, else false.
      Seit:
      7.0
    • isConvertNullValuesToDefault

      public boolean isConvertNullValuesToDefault()
      If convertNullValuesToDefault is set to true the report will convert null values from the database to a 0 (for numeric fields) or a blank (for non-numeric fields).
      Gibt zurück:
      Returns the convertNullValuesToDefault
      Seit:
      6.0
    • setConvertNullValuesToDefault

      public void setConvertNullValuesToDefault(boolean convertNullValuesToDefault)
      If convertNullValuesToDefault is set to true the report will convert null values from the database to a 0 (for numeric fields) or a blank (for non-numeric fields).
      Parameter:
      convertNullValuesToDefault - The convertNullValuesToDefault to set.
      Seit:
      6.0
    • isShowSuppressedGroupTreeNodes

      public boolean isShowSuppressedGroupTreeNodes()
      Returns the flag that controls the group tree nodes of suppressed group areas will be shown.
      Gibt zurück:
      the flag
      Seit:
      8.1
      Siehe auch:
    • setShowSuppressedGroupTreeNodes

      public void setShowSuppressedGroupTreeNodes(boolean showSuppressedGroupTreeNodes)
      Sets the flag that controls the group tree nodes of suppressed group areas will be shown.
      Parameter:
      showSuppressedGroupTreeNodes - the flag
      Seit:
      8.1
      Siehe auch:
    • setRowBufferSize

      public void setRowBufferSize(int rowCount)
      Sets the row count which will be cached during the rendering process. We advise to set this at 30000 rows. The minimum size of buffer is 3 rows. A row count of 0 disables the row buffer. Decrease this value if the engine throws OutOfMemoryError but note that this increases the rendering time.
      Parameter:
      rowCount - The amount of rows to be cached during the rendering process. 30000 is usually a good value.
      Seit:
      6.1
      Siehe auch:
    • getRowBufferSize

      public int getRowBufferSize()
      Returns the number of rows which will be cached in the row buffer.
      Gibt zurück:
      Number of rows or 0 if row buffer is disabled.
      Seit:
      6.1
      Siehe auch:
    • isValidForRowBuffer

      public boolean isValidForRowBuffer()
      Returns whether or not this report is suited for buffering of rows. Buffering rows causes the engine to only fetch parts of the data at a time, reducing memory usage, but raising the rendering time. Row buffering is intended for rendering large amounts of data. In order to use row buffering, the report should not contain groups, summary functions, charts, or crosstabs. To use row buffering, set the buffer size with setRowBufferSize.
      Gibt zurück:
      true if this report is suited for row buffering
      Seit:
      6.1
      Siehe auch:
    • setPaperOrient

    • getPaperOrient

      public int getPaperOrient()
      Returns the orientation of the paper.
      Gibt zurück:
      one of the following constants PORTRAIT, LANDSCAPE or DEFAULT_PAPER_ORIENTATION
      Seit:
      6.0
      Siehe auch:
    • getPaperHeight

      public int getPaperHeight()
      Returns the height of the report page in twips.
      Gibt zurück:
      the paper height value
      Seit:
      6.0
    • setPaperHeight

      public void setPaperHeight(int height)
      Sets the height of the report page in twips.
      1 pica = 1/6 inch
      1 point = 1/12 pica
      1 twip = 1/20 point or 20 twips = 1 point
      1 twip = 1/567 centimeter or 567 twips = 1 centimeter
      1 twip = 1/1440 inch or 1440 twips = 1 inch
      Parameter:
      height - the new paper height
      Löst aus:
      IllegalArgumentException - if height is negative or if margin top and margin bottom are greater than height.
      Seit:
      6.0
    • getPaperWidth

      public int getPaperWidth()
      Returns the width of the report page in twips.
      Gibt zurück:
      the paper width value
      Seit:
      6.0
    • setPaperWidth

      public void setPaperWidth(int width) throws ReportException
      Sets the width of the report page in twips.
      1 pica = 1/6 inch
      1 point = 1/12 pica
      1 twip = 1/20 point or 20 twips = 1 point
      1 twip = 1/567 centimeter or 567 twips = 1 centimeter
      1 twip = 1/1440 inch or 1440 twips = 1 inch
      Parameter:
      width - the new paper width
      Löst aus:
      IllegalArgumentException - if width is negative or if margin left and margin right are greater than width.
      ReportException - The currently used Engine isn't valid anymore.
      Seit:
      6.0
    • getPaperFormat

      public int getPaperFormat()
      Returns the format of the paper as a constant. See the various PAPER constants.
      Gibt zurück:
      the paper format of this report
      Seit:
      6.0
    • findPaperFormat

      public static int findPaperFormat(int x, int y, boolean isLandscape)
      Find the best best match for paper format.
      Parameter:
      x - width in Twips
      y - height in Twips
      isLandscape - true for landscape page orientation
      Gibt zurück:
      constant for paper format
      Löst aus:
      IllegalArgumentException - if x or y is less than 1
      Seit:
      14.0
    • getLabelWidth

      public int getLabelWidth()
      Returns the width of a multi-column label.
      Gibt zurück:
      width of multi-column label
      Seit:
      6.0
    • setLabelWidth

      public void setLabelWidth(int labelWidth)
      Sets the width of a multi-column label.
      Parameter:
      labelWidth - new label width
      Löst aus:
      IllegalArgumentException - if labelWidth is negative
      Seit:
      6.0
    • getLabelHeight

      public int getLabelHeight()
      Returns the height of a multi-column label.
      Gibt zurück:
      height of multi-column label
      Seit:
      6.0
    • setLabelHeight

      public void setLabelHeight(int labelHeight)
      Sets the height of a multi-column label.
      Parameter:
      labelHeight - new height
      Löst aus:
      IllegalArgumentException - if labelHeight is negative
      Seit:
      6.0
    • getHorizontal

      public int getHorizontal()
      Returns the horizontal gap between multi-column labels.
      Gibt zurück:
      horizontal gap between labels
      Seit:
      6.0
    • setHorizontal

      public void setHorizontal(int horizontal)
      Sets the horizontal gap between multi-column labels.
      Parameter:
      horizontal - new gap
      Löst aus:
      IllegalArgumentException - if horizontal is negative
      Seit:
      6.0
    • getVertical

      public int getVertical()
      Returns the vertical gap between multi-column labels.
      Gibt zurück:
      vertical gap between labels
      Seit:
      6.0
    • setVertical

      public void setVertical(int vertical)
      Sets the vertical gap between multi-column labels.
      Parameter:
      vertical - new gap
      Löst aus:
      IllegalArgumentException - if vertical is negative
      Seit:
      6.0
    • setLabelName

      public void setLabelName(String s)
      Sets the label name, such as "User Defined Label" or "Address"
      Parameter:
      s - label name to set.
      Seit:
      6.0
      Siehe auch:
    • getLabelName

      public String getLabelName()
      Returns the name of a multi-column label.
      This will return the complete name for predefined labels of the i-net designer or the name you set before with setLabelName(String).
      Gibt zurück:
      String type of the multi-column label
      Seit:
      6.0
    • isAcrossThenDown

      public boolean isAcrossThenDown()
      Returns the printing direction of a multi-column report.
      Gibt zurück:
      true if printing goes first across the page (left-right-top-down), false otherwise.
      Seit:
      7.0
    • setAcrossThenDown

      public void setAcrossThenDown(boolean acrossThenDown)
      Sets the printing direction of a multi-column report.
      Parameter:
      acrossThenDown - true if printing goes first across the page (left-right-top-down)
      Seit:
      6.0
    • isFormatGroupsWithMultipleColumn

      public boolean isFormatGroupsWithMultipleColumn()
      Should be group header/footer be treated as an ordinary label in a multi-column report?
      Gibt zurück:
      true if the group's header/footer are lined up with the other fields in a multi-column report, false otherwise.
      Seit:
      7.0
    • setFormatGroupsWithMultipleColumn

      public void setFormatGroupsWithMultipleColumn(boolean formatGroupsWithMultipleColumn)
      Should be group header/footer be treated as an ordinary label in a multi-column report?
      Parameter:
      formatGroupsWithMultipleColumn - true if the group's header/footer should be lined up with the other fields in a multi-column report
      Seit:
      6.0
    • setMarginTop

      public void setMarginTop(int margin)
      Sets the top margin of the page in twips.
      Parameter:
      margin - the new top margin
      Löst aus:
      IllegalArgumentException - if margin is negative or if top and bottom margin are greater than page height
      Seit:
      6.0
    • getMarginTop

      public int getMarginTop()
      Returns the top margin of the page in twips.
      Gibt zurück:
      the top margin value
      Seit:
      6.0
    • setMarginBottom

      public void setMarginBottom(int margin)
      Sets the bottom margin of the page in twips.
      Parameter:
      margin - the new bottom margin
      Löst aus:
      IllegalArgumentException - if margin is negative or if top and bottom margin are greater than page height
      Seit:
      6.0
    • getMarginBottom

      public int getMarginBottom()
      Returns the bottom margin of the page in twips.
      Gibt zurück:
      the bottom margin value
      Seit:
      6.0
    • setMarginLeft

      public void setMarginLeft(int margin) throws ReportException
      Sets the left margin of the page in twips.
      Parameter:
      margin - the new left margin
      Löst aus:
      IllegalArgumentException - if margin is negative
      ReportException - if left and right margin are greater than page width
      Seit:
      6.0
    • getMarginLeft

      public int getMarginLeft()
      Returns the left margin of the page in twips.
      Gibt zurück:
      the left margin value
      Seit:
      6.0
    • setMarginRight

      public void setMarginRight(int margin) throws ReportException
      Sets the right margin of the page in twips.
      Parameter:
      margin - the new right margin
      Löst aus:
      ReportException - if left and right margin are greater than page width
      IllegalArgumentException - if margin is negative
      Seit:
      6.0
    • getMarginRight

      public int getMarginRight()
      Returns the right margin of the page in twips.
      Gibt zurück:
      the right margin value
      Seit:
      6.0
    • isFormatWithMultipleColumns

      public boolean isFormatWithMultipleColumns()
      Test if the detail section of the report should be formatted in multiple columns of variable or fixed (labels) length.
      Gibt zurück:
      true if the detail section should be formatted with multiple columns, false otherwise.
      Seit:
      6.0
    • setFormatWithMultipleColumns

      public void setFormatWithMultipleColumns(boolean val)
      Sets if the detail section of the report should be formatted in multiple columns of variable or fixed (labels) length.
      Parameter:
      val - true if the detail section should be formatted with multiple columns, false otherwise.
      Seit:
      6.0
    • setPaperSize

      public void setPaperSize(int paperOrient, int paperFormat) throws ReportException
      Sets the paper width and paper height depending on the supplied paper format and orientation. If the paper format is one of the pre-defined like PAPER_A4 then the paper width smaller side of the paper for PORTRAIT orientation and the paper height the wider side or vise versa for LANDSCAPE. If the paper format is USERDEFINED_PAPER then the width and height are not changed as they have to be set manually. In case the paper format is DEFAULT_PAPERSIZE the width and height will be set using the default paper size defined in the i-net Clear Reports configuration regarding the supplied paper orientation. If an unknown paper format is supplied a warning will be written to the log and paper format PAPER_LETTER will be set.
      Parameter:
      paperOrient - The paper orientation to set for this report.
      paperFormat - The paper format to set for this report.
      Löst aus:
      ReportException - If an invalid page width shall be set.
      Seit:
      6.0
    • isHidePageFooterInsideReportHeader

      public boolean isHidePageFooterInsideReportHeader()
      Returns the value of the flag "Hide PageFooter inside ReportHeader".
      Gibt zurück:
      true if the page footer will be hidden inside the report header, false otherwise.
      Seit:
      6.0
      Siehe auch:
    • setHidePageFooterInsideReportHeader

      public void setHidePageFooterInsideReportHeader(boolean hidePageFooterInsideReportHeader)
      Set value of the flag "Hide PageFooter inside ReportHeader". If the flag is true and the ReportHeader span over multiple pages then no PageFooter is printed before the ReportHeader is finish.
      Parameter:
      hidePageFooterInsideReportHeader - true if the page footer will be hidden inside the report header, false otherwise.
      Seit:
      6.0
      Siehe auch:
    • setFormPrint

      public void setFormPrint(boolean value)
      Determines whether this report is a form - forms are never automatically resized if the designed margins are larger than the printable area, rather, the area which is not printable is truncated instead. The default value is false.
      Parameter:
      value - true if form print will be enabled for this report, false otherwise.
      Seit:
      7.0
    • isFormPrint

      public boolean isFormPrint()
      Returns the flag FormPrint for this report.
      Gibt zurück:
      true if form print is enabled for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • setPrintingEnabled

      public void setPrintingEnabled(boolean value)
      Enable or disable the print button and the print API of the Java Viewer.
      • Disabled, Viewer API print methods will have no effect.
      • Enabled, the button can be modified with the API.
      The default value is false.
      Parameter:
      value - true if printing will be enabled, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • isPrintingEnabled

      public boolean isPrintingEnabled()
      Returns if printing is enabled for this report.
      Gibt zurück:
      true if printing is enabled for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • setEnabledFormats

      public void setEnabledFormats(String[] formats)
      Sets a list of valid formats, that is, which formats it is possible to render. All values that can be used in the Engine Constructor are valid.
      Parameter:
      formats - export formats which are valid for this report, null if all formats are valid
      Seit:
      7.0
      Siehe auch:
    • getEnabledFormats

      public String[] getEnabledFormats()
      Returns the valid output formats for this report.
      Gibt zurück:
      the export formats which are valid for this report or null if all formats are valid
      Seit:
      7.0
      Siehe auch:
    • setClipboardEnabled

      public void setClipboardEnabled(boolean value)
      Enable the clipboard of the new Java Viewer. If disabled, then the user can't copy text from the viewer to the clipboard. This setting is on by default.
      Parameter:
      value - true if the clipboard will be enabled for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • isClipboardEnabled

      public boolean isClipboardEnabled()
      Returns whether the clipboard is enabled for the Java Viewer, that is, whether it is possible to copy text from the Viewer to the clipboard.
      Gibt zurück:
      true if the clipboard is enabled for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • setExportEnabled

      public void setExportEnabled(boolean value)
      Enable or disable the export button and the export API of the new Java Viewer. If disabled, the viewer API export methods will have no effect. If enabled, the button can be modified with the API.
      Parameter:
      value - true if the export will be enabled for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • isExportEnabled

      public boolean isExportEnabled()
      Returns the flag ExportEnabled for this report.
      Gibt zurück:
      true if the export is enabled for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • setGroupTreeVisible

      public void setGroupTreeVisible(boolean value)
      Enable or disable the GroupTree of the Java Viewer. If disabled, the viewer API group tree methods will have no effect. If enabled, the button can be modified with the API.
      Parameter:
      value - true if the group tree will be visible for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • isGroupTreeVisible

      public boolean isGroupTreeVisible()
      Returns the flag GroupTreeVisible for this report.
      Gibt zurück:
      true if the group tree is visible for this report, false otherwise.
      Seit:
      7.0
      Siehe auch:
    • isIgnoreSorting

      @Deprecated public boolean isIgnoreSorting()
      Veraltet.
      As of i-net Clear Reports 15, instead remove sort fields from the report with Fields.removeSortField(int)
      Returns the flag that indicates whether or not the sorting performed on engine.
      Gibt zurück:
      true if sorting is not performed on engine, false otherwise.
      Seit:
      7.7
      Siehe auch:
    • setIgnoreSorting

      @Deprecated public void setIgnoreSorting(boolean ignoreSorting)
      Veraltet.
      As of i-net Clear Reports 15, instead remove sort fields from the report with Fields.removeSortField(int)
      Sets the flag that deactivates the sorting on engine. You can use this flag to deactivate the sorting on engine by setSQL, setData, Command. Note this flag do not takes effect if your report contains a group with specified, by summary or hierarchical sort order.
      Parameter:
      ignoreSorting - the flag, default false.
      Seit:
      7.7
      Siehe auch:
    • isIgnoreFiltering

      @Deprecated public boolean isIgnoreFiltering()
      Veraltet.
      As of i-net Clear Reports 15, instead remove the record selection from the report with Report.setRecordSelectionFormula(FormulaField)
      Returns whether the data filtering performed on engine or not.
      Gibt zurück:
      true if data filtering is not performed on engine, false otherwise.
      Seit:
      7.7
      Siehe auch:
    • setIgnoreFiltering

      @Deprecated public void setIgnoreFiltering(boolean ignoreFiltering)
      Veraltet.
      As of i-net Clear Reports 15, instead remove the record selection from the report with Report.setRecordSelectionFormula(FormulaField)
      Set if the data filtering on engine should be deactivated or not. You can use this flag to deactivate the filtering on engine by setSQL, setData, Command.
      Parameter:
      ignoreFiltering - true if data filtering on engine should be deactivated, false otherwise.
      Seit:
      7.7
      Siehe auch:
    • parseElement

      public NodeParser parseElement(com.inet.report.parser.XMLTag group, String tag, Attributes atts, Map<String,Object> parserMap) throws FatalParserException
      FOR INTERNAL USE ONLY Internal method for reading report XML

      Parses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself. Note that the parsing is highly tolerant, i.e. exceptions are intercepted and suppressed if at all possible.

      Angegeben von:
      parseElement in Schnittstelle NodeParser
      Parameter:
      group - XMLTag of the current node to be parsed, or null if there is no such current group. An XMLTag is a group of nodes bundled together, usually it is a Properties node such as CommonProperties, BorderProperties, etc.
      tag - The XMLTag to be parsed
      atts - The set of attributes in the current XMLTag
      parserMap - The map of current Parser.
      Gibt zurück:
      The NodeParser sub-element if one needed to be created, or null if none was created.
      Löst aus:
      FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.
    • parseText

      public void parseText(String text, Map<String,Object> parserMap)
      FOR INTERNAL USE ONLY Internal method for reading report XML

      This method is called if text was encountered in the context of this node. (Examples would be a formula's text or a text element's text)

      Angegeben von:
      parseText in Schnittstelle NodeParser
      Parameter:
      text - text encountered and to be stored
      parserMap - The map of current Parser.
    • parseEndElement

      public void parseEndElement(com.inet.report.parser.XMLTag group, String tag, Map<String,Object> parserMap) throws FatalParserException
      FOR INTERNAL USE ONLY Internal method for reading report XML

      Receive notification of the end of an XML tag.

      Angegeben von:
      parseEndElement in Schnittstelle NodeParser
      Parameter:
      group - XMLTag of the current node to be parsed, or null if there is no such current group.
      tag - The XMLTag to be parsed
      parserMap - The map of current Parser.
      Löst aus:
      FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.
    • isDOMParser

      public boolean isDOMParser()
      FOR INTERNAL USE ONLY Internal method for reading report XML

      Returns whether this node is to be read via a DOM parser.

      Angegeben von:
      isDOMParser in Schnittstelle NodeParser
      Gibt zurück:
      true if this node is to be read via a DOM parser, false otherwise.
    • parseDOM

      public void parseDOM(Node node, Map<String,Object> parserMap) throws FatalParserException
      FOR INTERNAL USE ONLY Internal method for reading report XML

      Parses the node.

      Angegeben von:
      parseDOM in Schnittstelle NodeParser
      Parameter:
      node - the node
      parserMap - The map of current Parser.
      Löst aus:
      FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.
    • setReportLocale

      public void setReportLocale(Locale reportLocale)
      Sets the formula/resource default locale for the current report. If the report locale is set, any call to get the servers default locale will return the report locale instead, while the report gets rendered.
      Invoking Engine.setLocale(Locale) or Engine.setClientLocale(Locale) will override the report locale, because the report locale only replaces the default locale.
      Parameter:
      reportLocale - The new default locale for the current report. If null, the locale of the Java Virtual Machine will be used as default locale.
      Seit:
      8.2
      Siehe auch:
    • getReportLocale

      public Locale getReportLocale()
      Returns the default formula/resource locale defined for the current report. If this property is not set, it will return null.
      This locale does not reflect, which locale is used to render the report because it might be overridden by Engine.setLocale(Locale) or Engine.setClientLocale(Locale). It only indicates, which default will be used.
      Gibt zurück:
      The default locale set by the report or null, if this property is not set.
      Seit:
      8.2
      Siehe auch:
    • isCCFormat

      public boolean isCCFormat()
      Returns true if the report comes from i-net Clear Reports file format, else false.
      Gibt zurück:
      Whether or not the report is based on a template in i-net Clear Reports RPT format.
      Seit:
      9.0
    • getXMLMajorVersion

      public int getXMLMajorVersion()
      Returns the major version of the report XML of the template underlying this report. Note: returns -1 if the report template underlying this report is not XML-based. For example, a report created with i-net Crystal-Clear 8.2 would return 8.
      Gibt zurück:
      the major version of the XML of the template underlying this report. -1 if not XML-based
      Seit:
      9.0
    • getXMLMinorVersion

      public int getXMLMinorVersion()
      Returns the minor version of the report XML of the template underlying this report. Note: returns -1 if the report template underlying this report is not XML-based. For example, a report created with i-net Crystal-Clear 8.2 would return 2.
      Gibt zurück:
      the minor version of the XML of the template underlying this report. -1 if not XML-based
      Seit:
      9.0
    • setSaveDatasource

      public void setSaveDatasource(boolean save)
      Set the flag if a copy of the datasource configuration should be saved in the report file. NOTE: THIS WILL ENABLE ANYONE WITH THIS REPORT TEMPLATE TO ACCESS THE DATA IN YOUR DATA SOURCE.
      Parameter:
      save - true, save the datasource configuration with next save
      Seit:
      9.2
    • isSaveDatasource

      public boolean isSaveDatasource()
      Returns true if the used datasource configurations should save in the report file. This is helpful if the report is used on different computers in a intranet.
      Gibt zurück:
      true, if a copy is saved.
      Seit:
      9.2