NX Open C++ 参考指南 2406 v1.1
载入中...
搜索中...
未找到
NXOpen::SpreadsheetManager类 参考

电子表格管理器接口 更多...

#include <SpreadsheetManager.hxx>

Public 类型

enum  LookupMode { LookupModeExact , LookupModeHigher , LookupModeLower , LookupModeClosest }
enum  OpenMode { OpenModeRead , OpenModeWrite }
enum  Sheettype { SheettypeGateway , SheettypeModeling , SheettypePartfamily }

Public 成员函数

NXOpen::SpreadsheetCellDataCreateCellData ()
NXString ExportFile (const char *partnum)
NXString ExportFile (const NXString &partnum)
NXOpen::SpreadsheetCellDataHorizontalLookup (const char *file, const char *target, const char *range, int offset, NXOpen::SpreadsheetManager::LookupMode mode)
NXOpen::SpreadsheetCellDataHorizontalLookup (const NXString &file, const NXString &target, const NXString &range, int offset, NXOpen::SpreadsheetManager::LookupMode mode)
NXOpen::SpreadsheetOpen (NXOpen::SpreadsheetManager::Sheettype sheettype, const char *partfile)
NXOpen::SpreadsheetOpen (NXOpen::SpreadsheetManager::Sheettype sheettype, const NXString &partfile)
NXOpen::SpreadsheetExternalOpenFile (const char *sheet, NXOpen::SpreadsheetManager::OpenMode mode)
NXOpen::SpreadsheetExternalOpenFile (const NXString &sheet, NXOpen::SpreadsheetManager::OpenMode mode)
NXOpen::SpreadsheetCellDataReadAny (const char *filename, const char *cell)
NXOpen::SpreadsheetCellDataReadAny (const NXString &filename, const NXString &cell)
NXOpen::SpreadsheetCellDataReadCell (const char *filename, const char *cell)
NXOpen::SpreadsheetCellDataReadCell (const NXString &filename, const NXString &cell)
tag_t Tag () const
NXOpen::SpreadsheetCellDataVerticalLookup (const char *file, const char *target, const char *range, int offset, NXOpen::SpreadsheetManager::LookupMode mode)
NXOpen::SpreadsheetCellDataVerticalLookup (const NXString &file, const NXString &target, const NXString &range, int offset, NXOpen::SpreadsheetManager::LookupMode mode)

详细描述

电子表格管理器接口

表示用于与电子表格交互的类。 此类仅在交互模式下工作,因为电子表格工具在交互会话期间可用。 有多种类型的方法可使用此类中的 API。 要与部件文件关联的电子表格交互,请使用 Spreadsheet 对象,该对象由 NXOpen::SpreadsheetManager::Open 返回。 要与外部电子表格交互,请使用 Spreadsheet 对象,该对象由 NXOpen::SpreadsheetManager::OpenFile 返回。
要获取此类的实例,请参考 NXOpen::Session

仅在 Windows 上可用

创建于 NX11.0.0.

成员枚举类型说明

◆ LookupMode

表格中的查找模式。
创建于 NX11.0.0.

枚举值
LookupModeExact 

需要精确匹配

LookupModeHigher 

返回较高的单元格

LookupModeLower 

返回较低的单元格

LookupModeClosest 

返回最接近的单元格

◆ OpenMode

打开电子表格的工作表类型。
创建于 NX11.0.0.

枚举值
OpenModeRead 

读取模式

OpenModeWrite 

写入模式

◆ Sheettype

打开电子表格的工作表类型。
创建于 NX11.0.0.

枚举值
SheettypeGateway 

指定 Gateway 工作表类型

SheettypeModeling 

指定 Modeling 工作表类型

SheettypePartfamily 

指定 Partfamily 工作表类型

成员函数说明

◆ CreateCellData()

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::CreateCellData ( )

创建SpreadsheetCellData对象。

返回
返回SpreadsheetCellData对象。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无

◆ ExportFile() [1/2]

NXString NXOpen::SpreadsheetManager::ExportFile ( const char * partnum)

在NX/MGR模式下,将Teamcenter数据库中存储的Excel数据集文件 导出到本地文件系统,该文件仅可用于读取。 注意:对于Teamcenter数据库中存储的数据集文件,电子表格必须 存储为MSExcel或MSExcelX类型的数据集,并且该数据集应通过 IMAN_specification关系附加到其所属的项目版本上,最多可附加一个 MSExcel或MSExcelX类型的数据集。

返回
如果文件导出成功,函数返回本地文件系统中的完整文件名; 如果导出失败,函数返回空字符串表示没有可用的本地文件。 在Native模式下,该函数不执行任何操作,始终返回空字符串。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无
参数
partnum包含MsExcel数据集的部件号

◆ ExportFile() [2/2]

NXString NXOpen::SpreadsheetManager::ExportFile ( const NXString & partnum)

在NX/MGR模式下,将Teamcenter数据库中存储的Excel数据集文件 导出到本地文件系统,该文件仅可用于读取。 注意:对于Teamcenter数据库中存储的数据集文件,电子表格必须 存储为MSExcel或MSExcelX类型的数据集,并且该数据集应通过 IMAN_specification关系附加到其所属的项目版本上,最多可附加一个 MSExcel或MSExcelX类型的数据集。

返回
如果文件导出成功,函数返回本地文件系统中的完整文件名; 如果导出失败,函数返回空字符串表示没有可用的本地文件。 在Native模式下,该函数不执行任何操作,始终返回空字符串。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无
参数
partnum包含MsExcel数据集的部件号

◆ HorizontalLookup() [1/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::HorizontalLookup ( const char * file,
const char * target,
const char * range,
int offset,
NXOpen::SpreadsheetManager::LookupMode mode )

使用水平表查找从指定电子表格读取值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。 注意:仅当目标单元格包含数值时,查找模式才会生效;若目标单元格包含文本,则查找模式将被忽略。

返回
根据水平查找计算得到的电子表格单元格值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
file包含完整路径的文件名
target查找目标
range表格范围
offset数据单元格的偏移量。
mode表格中的查找模式。

◆ HorizontalLookup() [2/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::HorizontalLookup ( const NXString & file,
const NXString & target,
const NXString & range,
int offset,
NXOpen::SpreadsheetManager::LookupMode mode )

使用水平表查找从指定电子表格读取值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。 注意:仅当目标单元格包含数值时,查找模式才会生效;若目标单元格包含文本,则查找模式将被忽略。

返回
根据水平查找计算得到的电子表格单元格值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
file包含完整路径的文件名
target查找目标
range表格范围
offset数据单元格的偏移量。
mode表格中的查找模式。

◆ Open() [1/2]

NXOpen::Spreadsheet * NXOpen::SpreadsheetManager::Open ( NXOpen::SpreadsheetManager::Sheettype sheettype,
const char * partfile )

打开与给定部件文件关联的Excel工作表,并返回一个Spreadsheet 对象。

返回
返回一个Spreadsheet 对象,用于访问该电子表格。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无
参数
sheettype工作表类型
partfile部件文件

◆ Open() [2/2]

NXOpen::Spreadsheet * NXOpen::SpreadsheetManager::Open ( NXOpen::SpreadsheetManager::Sheettype sheettype,
const NXString & partfile )

打开与给定部件文件关联的Excel工作表,并返回一个Spreadsheet 对象。

返回
返回一个Spreadsheet 对象,用于访问该电子表格。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无
参数
sheettype工作表类型
partfile部件文件

◆ OpenFile() [1/2]

NXOpen::SpreadsheetExternal * NXOpen::SpreadsheetManager::OpenFile ( const char * sheet,
NXOpen::SpreadsheetManager::OpenMode mode )

打开Excel电子表格文件。 访问模式类型可以是只读或只写。 要打开的Excel电子表格可以来自本地文件系统, 也可以来自Teamcenter数据库中存储的数据集文件。 对于Native NX,请提供Excel的完整路径。 对于Managed NX,请提供item/revision格式(例如:"000023/A")。 该操作需要有活动工作部件。 注意:对于Teamcenter数据库中存储的数据集文件,电子表格必须 存储为MSExcel或MSExcelX类型的数据集,并且该数据集应通过 IMAN_specification关系附加到其所属的项目版本上,最多可附加一个 MSExcel或MSExcelX类型的数据集。

返回
返回一个SpreadsheetExternal 对象,用于访问外部电子表格。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无
参数
sheet外部Excel文件名
mode读写模式

◆ OpenFile() [2/2]

NXOpen::SpreadsheetExternal * NXOpen::SpreadsheetManager::OpenFile ( const NXString & sheet,
NXOpen::SpreadsheetManager::OpenMode mode )

打开Excel电子表格文件。 访问模式类型可以是只读或只写。 要打开的Excel电子表格可以来自本地文件系统, 也可以来自Teamcenter数据库中存储的数据集文件。 对于Native NX,请提供Excel的完整路径。 对于Managed NX,请提供item/revision格式(例如:"000023/A")。 该操作需要有活动工作部件。 注意:对于Teamcenter数据库中存储的数据集文件,电子表格必须 存储为MSExcel或MSExcelX类型的数据集,并且该数据集应通过 IMAN_specification关系附加到其所属的项目版本上,最多可附加一个 MSExcel或MSExcelX类型的数据集。

返回
返回一个SpreadsheetExternal 对象,用于访问外部电子表格。
仅可在Windows系统上使用

创建于NX11.0.0版本

许可证要求:无
参数
sheet外部Excel文件名
mode读写模式

◆ ReadAny() [1/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::ReadAny ( const char * filename,
const char * cell )

从指定电子表格的指定单元格中读取字符串或数值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。

返回
电子表格单元格中的值,可表示为字符串或数值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
filename包含完整路径的文件名
cell单元格编号可包含工作表名和单元格编号,两者用感叹号分隔。例如:Sheet1!A1

◆ ReadAny() [2/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::ReadAny ( const NXString & filename,
const NXString & cell )

从指定电子表格的指定单元格中读取字符串或数值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。

返回
电子表格单元格中的值,可表示为字符串或数值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
filename包含完整路径的文件名
cell单元格编号可包含工作表名和单元格编号,两者用感叹号分隔。例如:Sheet1!A1

◆ ReadCell() [1/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::ReadCell ( const char * filename,
const char * cell )

从指定电子表格的指定单元格中读取数值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。

返回
电子表格单元格中的数值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
filename包含完整路径的文件名
cell单元格编号可包含工作表名和单元格编号,两者用感叹号分隔。例如:Sheet1!A1

◆ ReadCell() [2/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::ReadCell ( const NXString & filename,
const NXString & cell )

从给定电子表格的指定单元格读取数值。 要打开的 Excel 电子表格可以来自本地文件系统, 也可以来自 Teamcenter 数据库中存储的数据集文件。

返回
电子表格单元格中的数值。
仅在 Windows 上可用

创建于 NX11.0.0.

许可证要求:无
参数
filename完整路径的文件名
cell单元格编号可以包含工作表和单元格编号,两者之间用感叹号分隔。例如:Sheet1!A1

◆ Tag()

tag_t NXOpen::SpreadsheetManager::Tag ( ) const

返回此对象的标签。

◆ VerticalLookup() [1/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::VerticalLookup ( const char * file,
const char * target,
const char * range,
int offset,
NXOpen::SpreadsheetManager::LookupMode mode )

使用垂直表查找从指定电子表格读取值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。 注意:仅当目标单元格包含数值时,查找模式才会生效;若目标单元格包含文本,则查找模式将被忽略。

返回
根据垂直查找计算得到的电子表格单元格值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
file包含完整路径的文件名
target查找目标
range表格范围
offset数据单元格的偏移量。
mode表格中的查找模式。

◆ VerticalLookup() [2/2]

NXOpen::SpreadsheetCellData * NXOpen::SpreadsheetManager::VerticalLookup ( const NXString & file,
const NXString & target,
const NXString & range,
int offset,
NXOpen::SpreadsheetManager::LookupMode mode )

使用垂直表查找从指定电子表格读取值。电子表格可以是本地文件系统中的 Excel 文件,也可以是 Teamcenter 数据库中存储的数据集文件。 注意:仅当目标单元格包含数值时,查找模式才会生效;若目标单元格包含文本,则查找模式将被忽略。

返回
根据垂直查找计算得到的电子表格单元格值。
仅在 Windows 系统上可用

创建于 NX11.0.0。

许可要求:无
参数
file包含完整路径的文件名
target查找目标
range表格范围
offset数据单元格的偏移量。
mode表格中的查找模式。