oaCellView

模块: oapy._oa._dm 导入: from oapy._oa import _dm

概览

oaCellView 在 oapy 中可用，可通过 _dm 模块访问。

本页汇总 oaCellView 当前在 oapy 中可用的 Python 接口。

详细说明

The oaCellView class implements an OpenAccess library cellView file object。 The oaCellView class can be observed by deriving from oaObserver 。 Note: The oaCellView function descriptions indicate if library access is required for the called function。 If the access type must be write access, this requirement also is noted。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

方法总览

状态	Python 调用
✅	_dm.oaCellView.destroy()
✅	obj.getCell()
✅	obj.getView()
✅	obj.getPrimary()
✅	obj.setView(view)
✅	obj.setView(view, mustExist)
✅	_dm.oaCellView.find(cell, view)
✅	_dm.oaCellView.find(lib, cellName, viewName)
✅	_dm.oaCellView.get(cell, view)
✅	_dm.oaCellView.get(lib, cellName, viewName, viewType)

方法说明

_dm.oaCellView.destroy()

绑定状态: 已绑定

Python 调用: _dm.oaCellView.destroy()

This function destroys the this oaCellView。 Note: If you want to destroy a cellView and its related design, first purge the design to remove it from memory。 This function requires write access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if write access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

异常

• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

_dm.oaCellView.destroy()

obj.getCell()

绑定状态: 已绑定

Python 调用: obj.getCell()

此函数返回指向 this cellView 的 cell 的指针。 This function requires access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

异常

• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

# assume obj is a oaCellView
obj.getCell()

obj.getView()

绑定状态: 已绑定

Python 调用: obj.getView()

此函数返回指向 this cellView 的 view 的指针。 This function requires access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

异常

• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

# assume obj is a oaCellView
obj.getView()

obj.getPrimary()

绑定状态: 已绑定

Python 调用: obj.getPrimary()

This function returns the primary file for this cellView。 This function requires access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

异常

• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

# assume obj is a oaCellView
obj.getPrimary()

obj.setView(view)

绑定状态: 已绑定

Python 调用: obj.setView(view)

This function modifies this cellView by associating it with the specified view。 If mustExist is false, this version of the function operates the same as the version of this function that does not include the mustExist argument - the view is changed, and the primary data is renamed (see oaCellView::setView )。 If the mustExist is true, this version of the function assumes that the cellView already contains the appropriate type of data but that it is not currently marked as the primary data for the cellView。 This function makes this data the primary data。 The original data is left in the cellView as non-primary data。 Note: Two setView functions (with and without the mustExist argument) have been implemented in the current release to maintain drop-in compatibility。 These two functions will be merged together at a later date。 An oacCVSetViewPrimaryFileLocked exception is thrown if the primary file cannot be write-locked by the current process -- for example, because it is locked by another process。 New: An oacCVSetViewPrimaryFileDoesNotExist exception is thrown if the file that corresponds to the new viewType does not exist in the cellView。 This function requires write access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if write access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

参数

• view: input parameter - pointer to the view to set for this cellView。
• mustExist-: boolean which should set to true in this version of the function。

异常

• oacCVSetViewPrimaryFileLocked。
• oacCVSetViewPrimaryFileDoesNotExist。
• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

# assume obj is a oaCellView
obj.setView(view)

obj.setView(view, mustExist)

绑定状态: 已绑定

Python 调用: obj.setView(view, mustExist)

This function modifies this cellView by associating it with the specified view。 When using this version of the function, the existing primary data will be renamed to be of the appropriate type。 An oacCVSetViewPrimaryFileExists exception will be thrown if the non-primary data of the specified type already exists in the cellView。 Note: Two setView functions (with and without the mustExist argument) have been implemented in the current release to maintain drop-in compatibility。 These two functions will be merged together at a later date。 An oacCVExists exception is thrown if another cellView (a cellView other than this cellView) already exists with the cellName and viewName that this function is to set on this cellView。 An oacCVSetViewPrimaryFileExists exception is thrown if a file already exists in the cellView with the same name to which the primary file is to be renamed。 An oacCVSetViewPrimaryFileLocked exception is thrown if the primary file cannot be write-locked by the current process -- for example, because it is locked by another process。 This function requires write access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if write access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

参数

• view: input parameter - pointer to the view to set for this cellView。

异常

• oacCVExists。
• oacCVSetViewPrimaryFileExists。
• oacCVSetViewPrimaryFileLocked。
• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

# assume obj is a oaCellView
obj.setView(view, mustExist)

_dm.oaCellView.find(cell, view)

绑定状态: 已绑定

Python 调用: _dm.oaCellView.find(cell, view)

This functions finds and returns a pointer to the cellView specified by the cell and view names。 If not found, NULL is returned。 This function requires access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

参数

• lib: pointer to owning lib for the cellView to be found。
• cellName: name of owning cell for the cellView to be found。
• viewName: name of owning view for the cellView to be found。

异常

• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

_dm.oaCellView.find(cell, view)

_dm.oaCellView.find(lib, cellName, viewName)

绑定状态: 已绑定

Python 调用: _dm.oaCellView.find(lib, cellName, viewName)

This function finds and returns a pointer to the specified cellView。 An exception is thrown if the specified cell and view are not in the same library。 If not found, NULL is returned。 This function requires access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

参数

• cell: pointer to the owning cell for the cellView to be found。
• view: pointer to the owning view for the cellview to be found。

异常

• oacCellViewNotInSameLib。
• oacLibAccessDenied。

Python 示例

from oapy._oa import _dm

_dm.oaCellView.find(lib, cellName, viewName)

_dm.oaCellView.get(cell, view)

绑定状态: 已绑定

Python 调用: _dm.oaCellView.get(cell, view)

This function attempts to find and return the cellView specified by lib, cellName, viewName and viewType。 If it cannot be found, an attempt is made to create the cellView while creating any missing cell and view owners。 Proper library write access is required for the creation to be successful and an exception is thrown if this is not the case。 If successful, a pointer to an oaCellView object is returned。

参数

• lib: A pointer to the oaLib object representing the library。
• cellName: A constant reference to an oaScalarName object holding the name of the cell。
• viewName: A constant reference to an oaScalarName object holding the name of the view。
• viewType: A pointer to a constant viewType object specifying the type of view to obtain。

异常

• oacLibAccessDenied。
• oacMismatchViewType。

Python 示例

from oapy._oa import _dm

_dm.oaCellView.get(cell, view)

_dm.oaCellView.get(lib, cellName, viewName, viewType)

绑定状态: 已绑定

Python 调用: _dm.oaCellView.get(lib, cellName, viewName, viewType)

This function finds and returns the cellView with the specified cell and view if it exists。 If not found, it is created, and a pointer to the new cellView is returned。 An exception is thrown if the specified cell and view are not in the same library。 When a new cellview is created, a new dmFile as the primary of that cellview will be automatically created after that cellview itself is created。 The users will get the postCreate callback on the cellview, followed by the postCreate callback on the primary file。 This function requires write access to the library associated with this object (through a call to oaLib::getAccess )。 An oacLibAccessDenied exception is thrown if the write access to the library does not exist。 For more information on library access, see Library Access in the detailed description for oaLib and OpenAccess 2.2 Libraries and Design Management in the Programmers Guide。

异常

• oacCellViewNotInSameLib。
• oacLibAccessDenied。
• oacMismatchViewType。

Python 示例

from oapy._oa import _dm

_dm.oaCellView.get(lib, cellName, viewName, viewType)