org.apache.poi.xssf.usermodel
Class XSSFEvaluationWorkbook

java.lang.Object
  extended by org.apache.poi.xssf.usermodel.XSSFEvaluationWorkbook
All Implemented Interfaces:
EvaluationWorkbook, FormulaParsingWorkbook, FormulaRenderingWorkbook

public final class XSSFEvaluationWorkbook
extends java.lang.Object
implements FormulaRenderingWorkbook, EvaluationWorkbook, FormulaParsingWorkbook

Internal POI use only


Nested Class Summary
 
Nested classes/interfaces inherited from interface org.apache.poi.ss.formula.EvaluationWorkbook
EvaluationWorkbook.ExternalName, EvaluationWorkbook.ExternalSheet, EvaluationWorkbook.ExternalSheetRange
 
Method Summary
 int convertFromExternSheetIndex(int externSheetIndex)
          XSSF doesn't use external sheet indexes, so when asked treat it just as a local index
static XSSFEvaluationWorkbook create(XSSFWorkbook book)
           
 Ptg get3DReferencePtg(AreaReference area, SheetIdentifier sheet)
          Produce the appropriate Ptg for a 3d area reference
 Ptg get3DReferencePtg(CellReference cell, SheetIdentifier sheet)
          Produce the appropriate Ptg for a 3d cell reference
 EvaluationWorkbook.ExternalName getExternalName(int externSheetIndex, int externNameIndex)
          HSSF Only - fetch the external-style name details
 EvaluationWorkbook.ExternalName getExternalName(java.lang.String nameName, java.lang.String sheetName, int externalWorkbookNumber)
          XSSF Only - fetch the external-style name details
 EvaluationWorkbook.ExternalSheet getExternalSheet(int externSheetIndex)
          HSSF Only - fetch the external-style sheet details Return will have no workbook set if it's actually in our own workbook
 EvaluationWorkbook.ExternalSheet getExternalSheet(java.lang.String firstSheetName, java.lang.String lastSheetName, int externalWorkbookNumber)
          XSSF Only - fetch the external-style sheet details Return will have no workbook set if it's actually in our own workbook
 int getExternalSheetIndex(java.lang.String sheetName)
          gets the externSheet index for a sheet from this workbook
 int getExternalSheetIndex(java.lang.String workbookName, java.lang.String sheetName)
          gets the externSheet index for a sheet from an external workbook
 Ptg[] getFormulaTokens(EvaluationCell evalCell)
           
 EvaluationName getName(NamePtg namePtg)
           
 EvaluationName getName(java.lang.String name, int sheetIndex)
          named range name matching is case insensitive
 java.lang.String getNameText(NamePtg namePtg)
           
 NameXPxg getNameXPtg(java.lang.String name, SheetIdentifier sheet)
           
 EvaluationSheet getSheet(int sheetIndex)
           
 java.lang.String getSheetFirstNameByExternSheet(int externSheetIndex)
           
 int getSheetIndex(EvaluationSheet evalSheet)
           
 int getSheetIndex(java.lang.String sheetName)
          Finds a sheet index by case insensitive name.
 java.lang.String getSheetLastNameByExternSheet(int externSheetIndex)
           
 java.lang.String getSheetName(int sheetIndex)
           
 SpreadsheetVersion getSpreadsheetVersion()
          Returns an enum holding spreadhseet properties specific to an Excel version ( max column and row numbers, max arguments to a function, etc.)
 UDFFinder getUDFFinder()
           
 java.lang.String resolveNameXText(NameXPtg n)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

create

public static XSSFEvaluationWorkbook create(XSSFWorkbook book)

convertFromExternSheetIndex

public int convertFromExternSheetIndex(int externSheetIndex)
XSSF doesn't use external sheet indexes, so when asked treat it just as a local index

Specified by:
convertFromExternSheetIndex in interface EvaluationWorkbook

getExternalSheetIndex

public int getExternalSheetIndex(java.lang.String sheetName)
Description copied from interface: FormulaParsingWorkbook
gets the externSheet index for a sheet from this workbook

Specified by:
getExternalSheetIndex in interface FormulaParsingWorkbook

getName

public EvaluationName getName(java.lang.String name,
                              int sheetIndex)
Description copied from interface: FormulaParsingWorkbook
named range name matching is case insensitive

Specified by:
getName in interface EvaluationWorkbook
Specified by:
getName in interface FormulaParsingWorkbook

getSheetIndex

public int getSheetIndex(EvaluationSheet evalSheet)
Specified by:
getSheetIndex in interface EvaluationWorkbook
Returns:
-1 if the specified sheet is from a different book

getSheetName

public java.lang.String getSheetName(int sheetIndex)
Specified by:
getSheetName in interface EvaluationWorkbook

getExternalName

public EvaluationWorkbook.ExternalName getExternalName(int externSheetIndex,
                                                       int externNameIndex)
Description copied from interface: EvaluationWorkbook
HSSF Only - fetch the external-style name details

Specified by:
getExternalName in interface EvaluationWorkbook

getExternalName

public EvaluationWorkbook.ExternalName getExternalName(java.lang.String nameName,
                                                       java.lang.String sheetName,
                                                       int externalWorkbookNumber)
Description copied from interface: EvaluationWorkbook
XSSF Only - fetch the external-style name details

Specified by:
getExternalName in interface EvaluationWorkbook

getNameXPtg

public NameXPxg getNameXPtg(java.lang.String name,
                            SheetIdentifier sheet)
Specified by:
getNameXPtg in interface FormulaParsingWorkbook

get3DReferencePtg

public Ptg get3DReferencePtg(CellReference cell,
                             SheetIdentifier sheet)
Description copied from interface: FormulaParsingWorkbook
Produce the appropriate Ptg for a 3d cell reference

Specified by:
get3DReferencePtg in interface FormulaParsingWorkbook

get3DReferencePtg

public Ptg get3DReferencePtg(AreaReference area,
                             SheetIdentifier sheet)
Description copied from interface: FormulaParsingWorkbook
Produce the appropriate Ptg for a 3d area reference

Specified by:
get3DReferencePtg in interface FormulaParsingWorkbook

resolveNameXText

public java.lang.String resolveNameXText(NameXPtg n)
Specified by:
resolveNameXText in interface EvaluationWorkbook
Specified by:
resolveNameXText in interface FormulaRenderingWorkbook

getSheet

public EvaluationSheet getSheet(int sheetIndex)
Specified by:
getSheet in interface EvaluationWorkbook

getExternalSheet

public EvaluationWorkbook.ExternalSheet getExternalSheet(int externSheetIndex)
Description copied from interface: EvaluationWorkbook
HSSF Only - fetch the external-style sheet details

Return will have no workbook set if it's actually in our own workbook

Specified by:
getExternalSheet in interface EvaluationWorkbook
Specified by:
getExternalSheet in interface FormulaRenderingWorkbook
Returns:
null if externSheetIndex refers to a sheet inside the current workbook

getExternalSheet

public EvaluationWorkbook.ExternalSheet getExternalSheet(java.lang.String firstSheetName,
                                                         java.lang.String lastSheetName,
                                                         int externalWorkbookNumber)
Description copied from interface: EvaluationWorkbook
XSSF Only - fetch the external-style sheet details

Return will have no workbook set if it's actually in our own workbook

Specified by:
getExternalSheet in interface EvaluationWorkbook

getExternalSheetIndex

public int getExternalSheetIndex(java.lang.String workbookName,
                                 java.lang.String sheetName)
Description copied from interface: FormulaParsingWorkbook
gets the externSheet index for a sheet from an external workbook

Specified by:
getExternalSheetIndex in interface FormulaParsingWorkbook
Parameters:
workbookName - e.g. "Budget.xls"
sheetName - a name of a sheet in that workbook

getSheetIndex

public int getSheetIndex(java.lang.String sheetName)
Description copied from interface: EvaluationWorkbook
Finds a sheet index by case insensitive name.

Specified by:
getSheetIndex in interface EvaluationWorkbook
Returns:
the index of the sheet matching the specified name. -1 if not found

getSheetFirstNameByExternSheet

public java.lang.String getSheetFirstNameByExternSheet(int externSheetIndex)
Specified by:
getSheetFirstNameByExternSheet in interface FormulaRenderingWorkbook
Returns:
the name of the (first) sheet referred to by the given external sheet index

getSheetLastNameByExternSheet

public java.lang.String getSheetLastNameByExternSheet(int externSheetIndex)
Specified by:
getSheetLastNameByExternSheet in interface FormulaRenderingWorkbook
Returns:
the name of the (last) sheet referred to by the given external sheet index

getNameText

public java.lang.String getNameText(NamePtg namePtg)
Specified by:
getNameText in interface FormulaRenderingWorkbook

getName

public EvaluationName getName(NamePtg namePtg)
Specified by:
getName in interface EvaluationWorkbook

getFormulaTokens

public Ptg[] getFormulaTokens(EvaluationCell evalCell)
Specified by:
getFormulaTokens in interface EvaluationWorkbook

getUDFFinder

public UDFFinder getUDFFinder()
Specified by:
getUDFFinder in interface EvaluationWorkbook

getSpreadsheetVersion

public SpreadsheetVersion getSpreadsheetVersion()
Description copied from interface: FormulaParsingWorkbook
Returns an enum holding spreadhseet properties specific to an Excel version ( max column and row numbers, max arguments to a function, etc.)

Specified by:
getSpreadsheetVersion in interface FormulaParsingWorkbook


Copyright 2015 The Apache Software Foundation or its licensors, as applicable.