|
NX Open C++ 参考指南 2406 v1.1
|
部件集合管理 更多...
#include <PartCollection.hxx>
类 | |
| class | iterator |
部件集合管理
代表会话中所有部件的集合。
在NX Manager模式下,包括NXOpen::PartCollection::NewDisplay、 NXOpen::PartCollection::OpenDisplay 和NXOpen::BasePart::SaveAs 在内的多个方法可接受NX Manager命令行格式的部件名称。 格式如下:
分隔符('/')可以是未在部件编号、版本或类型字段中使用的任意字符,它会被识别为"\<@\>DB"前缀后的第一个字符。
要获取此类实例,请参考NXOpen::Session
创建于NX3.0.0。
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartClosedHandler |
每当部件处于关闭过程中时调用的用户自定义方法。在此回调内请勿创建、打开、保存 请勿在此回调中修改其他部件或切换活动显示部件。 若用户退出NX,会话中的部件不会触发此回调。
版本:NX6.0.0
许可要求:无
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartCreatedHandler |
每当创建新部件时调用的用户自定义方法。在此回调内请勿创建、打开、保存其他部件或更改活动显示部件。
创建于NX6.0.0。
许可要求: 无
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartModifiedHandler |
部件被修改时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartOpenedHandler |
每当打开部件时调用的用户自定义方法。在此回调内请勿创建、打开、保存其他部件或更改活动显示部件。 部件打开处理程序会在"加载操作的目标部件"(例如装配的顶层部件及其组件部件加载完成后)被调用,但仅针对"加载操作的目标部件"触发。如果为已部分加载的部件加载更多数据,也可能会调用此回调。
创建于NX6.0.0。
许可要求: 无
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartRenamedHandler |
部件被重命名时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartSavedAsHandler |
每当部件另存为指定名称时调用的用户自定义方法。在此回调内请勿创建、打开、保存其他部件或更改活动显示部件。
创建于NX6.0.0。
许可要求: 无
| typedef NXOpen::Callback1<void, NXOpen::BasePart *> NXOpen::PartCollection::PartSavedHandler |
每当保存部件时调用的用户自定义方法。在此回调内请勿创建、打开、保存其他部件或更改活动显示部件。
创建于NX6.0.0。
许可要求: 无
工作部件变更时调用的用户自定义方法。 此方法在工作部件变更完成后触发。 传入此方法的原工作部件,可能与新工作部件并无差异。 例如,当活动显示部件变更,但新工作部件仍为同一部件,只是在新活动显示部件中代表不同组件时,此方法也会触发。单个操作过程中此方法可能被多次调用。 请勿在此方法中切换活动显示部件、工作部件或工作组件。
版本:NX6.0.0
许可要求:无
表示是否允许多个显示部件的状态。
| 枚举值 | |
|---|---|
| MultipleDisplayedPartStatusEnabled | 可同时显示多个部件(即添加不同的显示部件)。 |
| MultipleDisplayedPartStatusDisabledByCustomer | 一次仅能显示一个部件。多显示部件功能由客户禁用,例如通过 NXOpen::PartCollection::SetAllowMultipleDisplayedParts 禁用,而非NX会话自身禁用。 |
| MultipleDisplayedPartStatusDisabled | 一次仅能显示一个部件。 多显示部件功能由NX会话自身禁用,而非客户操作。 |
设置工作组件时控制要使用的引用集。 请参考NXOpen::PartCollection::SetWorkComponent
| 枚举值 | |
|---|---|
| RefsetOptionEntire | 为新工作组件使用"整个部件"引用集,并恢复之前工作组件的引用集 |
| RefsetOptionCurrent | 使用组件当前的引用集,并恢复之前工作组件的引用集 |
| RefsetOptionPreserveRefset | 使用组件当前的引用集,且不重置之前工作组件的引用集 |
指示无法使用关联设计(即将工作部件设置为新活动显示部件的组件)的原因。 用作NXOpen::PartCollection::SetDisplay 的返回码
设置工作组件时控制行为。请参考SetWorkComponent
| 枚举值 | |
|---|---|
| WorkComponentOptionVisible | 如果指定的工作组件不可见,则选择代表同一部件的其他组件。如果找不到合适的可见组件,则抛出异常。此选项确保新工作组件始终可见。 |
| WorkComponentOptionGiven | 使用指定的工作组件,无论其是否可见。 |
| int NXOpen::PartCollection::AddPartClosedHandler | ( | const NXOpen::PartCollection::PartClosedHandler & | handler | ) |
注册在部件即将关闭时调用的用户自定义方法
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddPartCreatedHandler | ( | const NXOpen::PartCollection::PartCreatedHandler & | handler | ) |
注册一个用户自定义方法,该方法会在创建新部件时被调用。
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddPartModifiedHandler | ( | const NXOpen::PartCollection::PartModifiedHandler & | handler | ) |
注册在部件被修改时调用的用户自定义方法
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddPartOpenedHandler | ( | const NXOpen::PartCollection::PartOpenedHandler & | handler | ) |
注册一个用户自定义方法,该方法会在打开部件时被调用。 部件打开处理程序会在"加载操作的目标部件"(例如装配的顶层部件及其组件部件)加载完成后立即调用,但仅针对"加载操作的目标部件"触发。若为已部分加载的部件加载更多数据时,也可能触发此回调。
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddPartRenamedHandler | ( | const NXOpen::PartCollection::PartRenamedHandler & | handler | ) |
注册在部件被重命名时调用的用户自定义方法
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddPartSavedAsHandler | ( | const NXOpen::PartCollection::PartSavedAsHandler & | handler | ) |
注册在部件另存为指定名称时调用的用户自定义方法
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddPartSavedHandler | ( | const NXOpen::PartCollection::PartSavedHandler & | handler | ) |
注册一个用户自定义方法,该方法会在保存部件时被调用。
| handler | 要注册的方法 |
| int NXOpen::PartCollection::AddWorkPartChangedHandler | ( | const NXOpen::PartCollection::WorkPartChangedHandler & | handler | ) |
注册在工作部件变更时调用的方法
| handler | 要注册的方法 |
| NXOpen::BasePart * NXOpen::PartCollection::BaseDisplay | ( | ) |
获取当前会话的活动显示部件。
创建于NX4.0.0。
许可证要求:无
| NXOpen::BasePart * NXOpen::PartCollection::BaseWork | ( | ) |
获取当前会话的工作部件。该部件可以是活动显示部件,也可以是活动显示部件的NXOpen::Assemblies::ComponentAssembly 中组件所代表的部件。 参考:NXOpen::PartCollection::WorkComponent
创建于NX4.0.0。
许可证要求:无
| iterator NXOpen::PartCollection::begin | ( | ) |
返回指向第一个元素的迭代器。
| void NXOpen::PartCollection::CloseAll | ( | NXOpen::BasePart::CloseModified | closeModified, |
| NXOpen::PartCloseResponses * | responses ) |
关闭会话中所有打开的部件。
创建于NX3.0.0。
许可证要求:无
| closeModified | 当组件部件已修改时的关闭行为。 |
| responses | 表示要关闭或在修改后保持打开的部件列表的类。仅当 close_modified设置为 NXOpen::BasePart::CloseModifiedUseResponses 时使用。如果设置了 NXOpen::BasePart::CloseModifiedUseResponses,则所有可关闭但未在此列表中的部件,无论是否修改,都将被关闭。请参阅 NXOpen::PartCloseResponses 了解如何向此类添加响应。 |
| void NXOpen::PartCollection::ClosePasswordSafe | ( | ) |
此方法用于关闭当前打开的密码保险箱,仅应与GC工具集配合使用。
创建于NX11.0.0。
许可要求:无
| NXOpen::Gateway::GenericFileNewBuilder * NXOpen::PartCollection::CreateGenericFileNewBuilder | ( | ) |
创建一个 NXOpen::Gateway::GenericFileNewBuilder
创建于NX11.0.0。
许可要求:无
| NXOpen::LinkedMirrorPartBuilder * NXOpen::PartCollection::CreateLinkedMirrorPartBuilder | ( | NXOpen::Part * | part | ) |
创建一个NXOpen::LinkedMirrorPartBuilder
| part | 部件 |
| NXOpen::Part * NXOpen::PartCollection::Display | ( | ) |
获取当前会话的活动显示部件。如果活动显示部件不是.prt部件,将抛出错误。
创建于NX3.0.0。
许可证要求:无
|
inline |
返回指向最后一个元素之后位置的迭代器。
| NXOpen::PartLoadStatus * NXOpen::PartCollection::EnsurePartsLoadedFully | ( | const std::vector< NXOpen::BasePart * > & | parts, |
| bool | includeChildren ) |
确保输入部件被完全加载。若部件已完全加载,则此方法无效果。
| parts | 部件集合 |
| includeChildren | 若为true,在加载处理中包含每个输入部件的子部件(及其递归子部件),否则将忽略输入部件的子部件。 给定部件的“子部件”指直接子实例部件,且未因实例抑制而处于抑制状态。 |
| NXOpen::PartLoadStatus * NXOpen::PartCollection::EnsurePartsLoadedPartially | ( | const std::vector< NXOpen::BasePart * > & | parts, |
| bool | includeChildren ) |
确保输入部件至少被部分加载。 此方法仅对最小化加载的部件生效,若输入部件已至少部分加载,则此方法将忽略该部件。
| parts | 部件集合 |
| includeChildren | 若为true,在部分加载处理中包含每个输入部件的子部件(及其递归子部件),否则将忽略输入部件的子部件。 给定部件的“子部件”指直接子实例部件,且未因实例抑制而处于抑制状态。 |
| NXOpen::FileNew * NXOpen::PartCollection::FileNew | ( | ) |
创建NXOpen::FileNew 对象
创建于NX5.0.0。
许可要求:无
| NXOpen::BasePart * NXOpen::PartCollection::FindObject | ( | const char * | name | ) |
查找具有指定名称的NXOpen::BasePart 。该部件必须已在当前会话中加载。 在原生模式下,此函数接受完整路径名或叶名;在管理模式NX中,需要CLI格式名称(例如"@DB/peters-part/A/spec/sheet1")。 如果找不到具有指定名称的对象,将抛出异常。
| name | 完整名称、叶名或CLI名称(管理模式下) |
| NXOpen::BasePart * NXOpen::PartCollection::FindObject | ( | const NXString & | name | ) |
查找具有指定名称的NXOpen::BasePart 。该部件必须已在当前会话中加载。 在原生模式下,此函数接受完整路径名或叶名;在管理模式NX中,需要CLI格式名称(例如"@DB/peters-part/A/spec/sheet1")。 如果找不到具有指定名称的对象,将抛出异常。
| name | 完整名称、叶名或CLI名称(管理模式下) |
| NXOpen::PartSaveStatus * NXOpen::PartCollection::ForceSaveAll | ( | ) |
保存会话中的所有部件。
| std::vector< NXOpen::BasePart * > NXOpen::PartCollection::GetDisplayedParts | ( | ) |
获取当前所有已显示的部件。 列表中的第一个部件为活动显示部件。 另请参考NXOpen::PartCollection::Display、 NXOpen::PartCollection::Work
注意:NX操作通常在活动显示部件中执行。 在某个显示部件中执行操作前,应先通过NXOpen::PartCollection::SetActiveDisplay 激活该部件。
| NXOpen::LinkedMirrorPartBuilder::MirrorCsysOption NXOpen::PartCollection::GetMirrorCsysOptionOfMirrorPart | ( | NXOpen::Part * | part | ) |
获取指定关联镜像部件的镜像坐标系类型
创建于NX8.5.1。
许可要求:实体建模("SOLIDS MODELING")
| part | 输入的关联镜像部件,若输入不是关联镜像部件将报错 |
| NXOpen::LinkedMirrorPartBuilder::MirrorPartTypeOption NXOpen::PartCollection::GetMirrorPartType | ( | NXOpen::Part * | part | ) |
获取关联镜像部件的类型
版本:NX8.5.0
许可要求:实体建模 ("SOLIDS MODELING")
| part | 输入部件 |
| void NXOpen::PartCollection::GetMirrorPlaneDataOfMirrorPart | ( | NXOpen::Part * | part, |
| NXOpen::Point3d * | mirrorPlaneOrigin, | ||
| NXOpen::Vector3d * | mirrorPlaneDirection ) |
获取指定关联镜像部件的镜像平面原点和法向
创建于NX8.5.1。
许可要求:实体建模("SOLIDS MODELING")
| part | 输入的关联镜像部件,若输入不是关联镜像部件将报错 |
| mirrorPlaneOrigin | 镜像平面原点 |
| mirrorPlaneDirection | 镜像平面法向 |
| NXOpen::PartLoadState NXOpen::PartCollection::GetPartLoadStateOfFileName | ( | const char * | fileName | ) |
根据部件文件名获取加载状态。如果部件未加载,返回NXOpen::PartLoadStateNotLoaded
创建于NX12.0.1。
许可要求:无
| fileName | 文件名 |
| NXOpen::PartLoadState NXOpen::PartCollection::GetPartLoadStateOfFileName | ( | const NXString & | fileName | ) |
根据部件文件名返回其加载状态。若部件未加载,返回NXOpen::PartLoadStateNotLoaded。
创建于NX12.0.1。
许可证要求:无
| fileName | 文件名 |
| NXString NXOpen::PartCollection::GetSourcePartNameOfMirrorPart | ( | NXOpen::Part * | mirrorPart | ) |
获取镜像部件的源部件名称
版本:NX8.5.0
许可要求:实体建模 ("SOLIDS MODELING")
| mirrorPart | 输入部件 |
| NXOpen::Part * NXOpen::PartCollection::ImportToolDesignPackage | ( | const char * | filename, |
| const char * | outputDirectory, | ||
| NXOpen::PartLoadStatus ** | loadStatus, | ||
| NXOpen::PartSaveStatus ** | saveStatus ) |
导入刀具设计包
| filename | 刀具设计包 |
| outputDirectory | 输出目录 |
| loadStatus | 无法加载的部件及其相关错误 |
| saveStatus | 无法保存的部件及其相关错误 |
| NXOpen::Part * NXOpen::PartCollection::ImportToolDesignPackage | ( | const NXString & | filename, |
| const NXString & | outputDirectory, | ||
| NXOpen::PartLoadStatus ** | loadStatus, | ||
| NXOpen::PartSaveStatus ** | saveStatus ) |
导入刀具设计包
| filename | 刀具设计包 |
| outputDirectory | 输出目录 |
| loadStatus | 无法加载的部件及其相关错误 |
| saveStatus | 无法保存的部件及其相关错误 |
| bool NXOpen::PartCollection::IsExactMirroredPart | ( | NXOpen::Part * | part | ) |
检查给定部件是否为精确关联镜像部件
版本:NX8.5.0
许可要求:实体建模 ("SOLIDS MODELING")
| part | 输入部件 |
| bool NXOpen::PartCollection::IsMirroredPart | ( | NXOpen::Part * | part | ) |
检查给定部件是否为关联镜像部件
版本:NX8.5.0
许可要求:实体建模 ("SOLIDS MODELING")
| part | 输入部件 |
| NXOpen::LoadOptions * NXOpen::PartCollection::LoadOptions | ( | ) |
控制当前会话中部件加载方式的NXOpen::LoadOptions
创建于NX3.0.0。
| NXOpen::BasePart * NXOpen::PartCollection::NewBase | ( | const char * | name, |
| NXOpen::BasePart::Units | units ) |
创建新部件。
| name | 新部件的名称 |
| units | 新部件的单位 |
| NXOpen::BasePart * NXOpen::PartCollection::NewBase | ( | const NXString & | name, |
| NXOpen::BasePart::Units | units ) |
创建新部件。
| name | 新部件的名称 |
| units | 新部件的单位 |
| NXOpen::BasePart * NXOpen::PartCollection::NewBaseDisplay | ( | const char * | name, |
| NXOpen::BasePart::Units | units ) |
创建一个新部件,并将其设置为活动显示部件。
| name | 新部件的名称 |
| units | 新部件的单位 |
| NXOpen::BasePart * NXOpen::PartCollection::NewBaseDisplay | ( | const NXString & | name, |
| NXOpen::BasePart::Units | units ) |
创建一个新部件,并将其设置为活动显示部件。
| name | 新部件的名称 |
| units | 新部件的单位 |
| NXOpen::Part * NXOpen::PartCollection::NewDisplay | ( | const char * | name, |
| NXOpen::Part::Units | units ) |
创建一个新的.prt部件,并将其设置为活动显示部件。
注意:此方法仅应用于创建新的.prt部件。 若要创建.prt以外的其他类型部件,请使用NXOpen::PartCollection::NewBaseDisplay。
| name | 新部件的名称 |
| units | 新部件的单位 |
| NXOpen::Part * NXOpen::PartCollection::NewDisplay | ( | const NXString & | name, |
| NXOpen::Part::Units | units ) |
创建一个新的.prt部件,并将其设置为活动显示部件。
注意:此方法仅应用于创建新的.prt部件。 若要创建.prt以外的其他类型部件,请使用NXOpen::PartCollection::NewBaseDisplay。
| name | 新部件的名称 |
| units | 新部件的单位 |
| NXOpen::PartCloseResponses * NXOpen::PartCollection::NewPartCloseResponses | ( | ) |
构造新的PartCloseResponses类。该类用于在部件关闭过程中,若部件已被修改,传递是否关闭特定部件的指令。
| NXOpen::PartCollection::NX_DEPRECATED | ( | "Deprecated in NX12.0.0. A direct call to refresh the part navigator should not be needed." | ) |
刷新部件导航器。此函数会遍历部件导航器的所有节点并逐一更新。请勿在对性能要求高的场景(如循环体内)调用。
| NXOpen::Part * NXOpen::PartCollection::Open | ( | const char * | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开现有.prt部件,但不将其设为活动显示部件。 参见OpenDisplay。
注意:此方法仅用于打开.prt部件。 若要打开.prt以外的其他类型部件,请使用NXOpen::PartCollection::OpenBase。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误 |
| NXOpen::Part * NXOpen::PartCollection::Open | ( | const NXString & | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开现有.prt部件,但不将其设为活动显示部件。 参见OpenDisplay。
注意:此方法仅用于打开.prt部件。 若要打开.prt以外的其他类型部件,请使用NXOpen::PartCollection::OpenBase。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误 |
| NXOpen::BasePart * NXOpen::PartCollection::OpenActiveDisplay | ( | const char * | filename, |
| NXOpen::DisplayPartOption | displayPartOption, | ||
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开已有的部件并将其设置为活动显示部件。 根据输入选项,该部件可与其他已显示的部件同时显示。 另请参见NXOpen::DisplayPartOption。
| filename | 文件名 |
| displayPartOption | 控制该部件是否替换现有活动显示部件 |
| loadStatus | 无法加载的部件及其关联的错误和警告信息 |
| NXOpen::BasePart * NXOpen::PartCollection::OpenActiveDisplay | ( | const NXString & | filename, |
| NXOpen::DisplayPartOption | displayPartOption, | ||
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开已有的部件并将其设置为活动显示部件。 根据输入选项,该部件可与其他已显示的部件同时显示。 另请参见NXOpen::DisplayPartOption。
| filename | 文件名 |
| displayPartOption | 控制该部件是否替换现有活动显示部件 |
| loadStatus | 无法加载的部件及其关联的错误和警告信息 |
| NXOpen::BasePart * NXOpen::PartCollection::OpenBase | ( | const char * | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开现有部件,但不将其设为活动显示部件。 参见OpenBaseDisplay。
注意:此方法也可用于打开书签文件和.prt以外的其他类型部件。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误 |
| NXOpen::BasePart * NXOpen::PartCollection::OpenBase | ( | const NXString & | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开现有部件,但不将其设为活动显示部件。 参见OpenBaseDisplay。
注意:此方法也可用于打开书签文件和.prt以外的其他类型部件。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误 |
| NXOpen::BasePart * NXOpen::PartCollection::OpenBaseDisplay | ( | const char * | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开现有部件并将其设置为活动显示部件。 此方法等效于使用选项 NXOpen::DisplayPartOptionReplaceExisting 的 OpenActiveDisplay。 此方法将根据 NXOpen::LoadOptions::ComponentsToLoad 属性的设置,按以下方式加载组件:
1) "所有组件" (NXOpen::LoadOptions::LoadComponentsAll ) 将加载装配的所有组件。
2) "上次使用的组件集" (NXOpen::LoadOptions::LoadComponentsLastSet ) 将加载上次保存的组件集中的组件。
3) "无组件" (NXOpen::LoadOptions::LoadComponentsNone )、 "使用上次过滤器" (NXOpen::LoadOptions::LoadComponentsLastFilter ) 或 "指定过滤器" (NXOpen::LoadOptions::LoadComponentsSpecifyFilter ) 将不加载装配的任何组件。
注意: 此方法也可用于打开书签文件以及非.prt格式的部件。
注意: 如果在批处理模式下,使用此方法打开通过以下任一选项创建的书签文件: BasePart::BookmarkOptionAllPlusDisplay BasePart::BookmarkOptionComponentGroupsLoadOptionsPlusDisplay BasePart::BookmarkOptionComponentGroupsOnlyPlusDisplay BasePart::BookmarkOptionDisplayOnly 书签文件中的显示数据将不会应用到活动显示部件。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其相关错误。 |
| NXOpen::BasePart * NXOpen::PartCollection::OpenBaseDisplay | ( | const NXString & | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开已有的部件并将其设置为活动显示部件。 此方法等效于使用NXOpen::DisplayPartOptionReplaceExisting 选项的OpenActiveDisplay方法。 此方法将根据NXOpen::LoadOptions::ComponentsToLoad 属性的设置,按以下方式加载组件:
1) "所有组件" (NXOpen::LoadOptions::LoadComponentsAll ) 将加载装配体的所有组件。
2) "上次使用的组件集" (NXOpen::LoadOptions::LoadComponentsLastSet ) 将加载上次保存的组件集中的组件。
3) "无组件" (NXOpen::LoadOptions::LoadComponentsNone )、 "使用上次过滤器" (NXOpen::LoadOptions::LoadComponentsLastFilter ) 或 "指定过滤器" (NXOpen::LoadOptions::LoadComponentsSpecifyFilter ) 将不会加载装配体的任何组件。
注意: 此方法也可用于打开书签文件以及.prt以外的其他类型部件。
注意: 若在批处理模式下使用此方法打开通过以下任一选项创建的书签文件: BasePart::BookmarkOptionAllPlusDisplay BasePart::BookmarkOptionComponentGroupsLoadOptionsPlusDisplay BasePart::BookmarkOptionComponentGroupsOnlyPlusDisplay BasePart::BookmarkOptionDisplayOnly 书签文件中的显示数据将不会应用到活动显示部件。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误信息 |
| NXOpen::Part * NXOpen::PartCollection::OpenDisplay | ( | const char * | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开已有的.prt部件并将其设置为活动显示部件。
注意: 此方法仅应用于打开.prt格式的部件。 若要打开.prt以外的其他类型部件,请使用NXOpen::PartCollection::OpenBaseDisplay。
此方法将根据NXOpen::LoadOptions::ComponentsToLoad 属性的设置,按以下方式加载组件:
1) "所有组件" (NXOpen::LoadOptions::LoadComponentsAll ) 将加载装配体的所有组件。
2) "上次使用的组件集" (NXOpen::LoadOptions::LoadComponentsLastSet ) 将加载上次保存的组件集中的组件。
3) "无组件" (NXOpen::LoadOptions::LoadComponentsNone )、 "使用上次过滤器" (NXOpen::LoadOptions::LoadComponentsLastFilter ) 或 "指定过滤器" (NXOpen::LoadOptions::LoadComponentsSpecifyFilter ) 将不会加载装配体的任何组件。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误信息 |
| NXOpen::Part * NXOpen::PartCollection::OpenDisplay | ( | const NXString & | filename, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
打开现有.prt部件,并将其设为活动显示部件。
注意:此方法仅用于打开.prt部件。 若要打开.prt以外的其他类型部件,请使用NXOpen::PartCollection::OpenBaseDisplay。
根据NXOpen::LoadOptions::ComponentsToLoad 属性的设置,此方法将按以下方式加载组件:
1) "所有组件" (NXOpen::LoadOptions::LoadComponentsAll ) 将加载装配的所有组件。
2) "上次使用的组件集" (NXOpen::LoadOptions::LoadComponentsLastSet ) 将加载上次保存的组件集中的组件。
3) "无组件" (NXOpen::LoadOptions::LoadComponentsNone )、 "使用上次过滤器" (NXOpen::LoadOptions::LoadComponentsLastFilter ) 或 "指定过滤器" (NXOpen::LoadOptions::LoadComponentsSpecifyFilter ) 将不加载装配的任何组件。
| filename | 文件名 |
| loadStatus | 无法加载的部件及其关联错误 |
| void NXOpen::PartCollection::OpenPasswordSafe | ( | const char * | fileName, |
| const char * | password ) |
此方法用于打开密码保险箱,仅应与GC工具集配合使用。
创建于NX11.0.0。
许可要求:无
| fileName | 文件名 |
| password | 打开密码 |
| void NXOpen::PartCollection::OpenPasswordSafe | ( | const NXString & | fileName, |
| const NXString & | password ) |
此方法用于打开密码保险箱,仅应与GC工具集配合使用。
创建于NX11.0.0。
许可要求:无
| fileName | 文件名 |
| password | 打开密码 |
| void NXOpen::PartCollection::OpenSeedPartBlankTemplate | ( | const char * | filename, |
| bool | addMaster ) |
使用空白模板打开未填充的数据集
版本:NX6.0.0
许可要求:无
| filename | 部件名称 |
| addMaster | 是否将主部件作为组件添加 |
| void NXOpen::PartCollection::OpenSeedPartBlankTemplate | ( | const NXString & | filename, |
| bool | addMaster ) |
使用空白模板打开未填充的数据集
版本:NX6.0.0
许可要求:无
| filename | 部件名称 |
| addMaster | 是否将主部件作为组件添加 |
| NXOpen::PDM::PartManager * NXOpen::PartCollection::PDMPartManager | ( | ) |
在NX管理器模式下管理部件创建的NXOpen::PDM::PartManager
创建于NX3.0.0。
| void NXOpen::PartCollection::RemovePartClosedHandler | ( | int | id | ) |
注销在部件即将关闭时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePartCreatedHandler | ( | int | id | ) |
注销一个在创建新部件时被调用的用户自定义方法
创建于NX6.0.0。
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePartModifiedHandler | ( | int | id | ) |
注销在部件被修改时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePartOpenedHandler | ( | int | id | ) |
注销一个在打开部件时被调用的用户自定义方法
创建于NX6.0.0。
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePartRenamedHandler | ( | int | id | ) |
注销在部件被重命名时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePartSavedAsHandler | ( | int | id | ) |
注销在部件另存为指定名称时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePartSavedHandler | ( | int | id | ) |
注销在部件保存时调用的用户自定义方法
版本:NX6.0.0
许可要求:无
| id | 要注销的方法的标识符 |
| void NXOpen::PartCollection::RemovePassword | ( | NXOpen::Part * | part, |
| NXOpen::PartCollection::SetProtectionOn | partoption ) |
此方法用于删除部件的安全保护。此方法仅应与GC工具包配合使用。
创建于NX11.0.0。
许可证要求:无
| part | 部件 |
| partoption | 要移除安全保护的部件范围 |
| void NXOpen::PartCollection::RemoveWorkPartChangedHandler | ( | int | id | ) |
注销在工作部件变更时调用的方法
版本:NX6.0.0
许可要求:无
| id | 要注销的方法的标识符 |
| NXOpen::PartReopenReport * NXOpen::PartCollection::ReopenAll | ( | NXOpen::BasePart::CloseModified | closeModified, |
| NXOpen::PartCloseResponses * | responses ) |
重新打开会话中所有已修改的部件。
| closeModified | 当组件部件已修改时的关闭行为。 |
| responses | 表示要关闭或在修改后保持打开的部件列表的类。仅当 close_modified设置为 NXOpen::BasePart::CloseModifiedUseResponses 时使用。如果设置了 NXOpen::BasePart::CloseModifiedUseResponses,则所有可关闭但未在此列表中的部件,无论是否修改,都将被关闭。请参阅 NXOpen::PartCloseResponses 了解如何向此类添加响应。 |
| void NXOpen::PartCollection::SaveAll | ( | bool * | anyPartsModified, |
| NXOpen::PartSaveStatus ** | saveStatus ) |
保存会话中所有已修改的部件。
创建于NX3.0.0。
许可证要求:无
| anyPartsModified | 指示在调用保存操作前,会话中是否有部件实际被修改。如果为false,则没有部件被修改,因此不会尝试保存任何部件。 |
| saveStatus | 无法保存的部件及其相关错误。 |
| NXOpen::SaveOptions * NXOpen::PartCollection::SaveOptions | ( | ) |
控制当前会话中部件保存方式的NXOpen::SaveOptions
创建于NX3.0.0。
| NXOpen::PartCollection::SdpsStatus NXOpen::PartCollection::SetActiveDisplay | ( | NXOpen::BasePart * | part, |
| NXOpen::DisplayPartOption | displayPartOption, | ||
| NXOpen::PartDisplayPartWorkPartOption | workPartOption, | ||
| NXOpen::PartLoadStatus ** | loadStatus ) |
设置活动显示部件。 根据输入选项,该部件可与已显示的其他部件同时显示。 另请参见@link NXOpen::DisplayPartOption NXOpen::DisplayPartOption@endlink 。 调用此方法可能会重置撤销标记列表,以防止跨显示/取消显示部件操作进行撤销。 @return 若工作部件保持成功则返回OK,否则返回状态码说明原因。
创建于NX12.0.0。
许可要求:无
| part | 新的显示部件 |
| displayPartOption | 控制该部件是否替换现有活动显示部件。 |
| workPartOption | 控制新活动显示部件中的工作部件设置。 |
| loadStatus | 加载新显示部件时发现的所有错误和警告。 |
| NXOpen::PartCollection::SdpsStatus NXOpen::PartCollection::SetActiveDisplayRetainUndoMarks | ( | NXOpen::BasePart * | part, |
| NXOpen::DisplayPartOption | displayPartOption, | ||
| NXOpen::PartDisplayPartWorkPartOption | workPartOption, | ||
| NXOpen::PartLoadStatus ** | loadStatus ) |
设置活动显示部件。 参见@link NXOpen::PartCollection::SetActiveDisplay NXOpen::PartCollection::SetActiveDisplay@endlink 。 与@link NXOpen::PartCollection::SetActiveDisplay NXOpen::PartCollection::SetActiveDisplay@endlink 不同,此方法将保留撤销标记列表。 @return 若工作部件保持成功则返回OK,否则返回状态码说明原因。
创建于NX1953.0.0。
许可要求:无
| part | 新的显示部件 |
| displayPartOption | 控制该部件是否替换现有活动显示部件。 |
| workPartOption | 控制新活动显示部件中的工作部件设置。 |
| loadStatus | 加载新显示部件时发现的所有错误和警告。 |
| void NXOpen::PartCollection::SetAllowMultipleDisplayedParts | ( | bool | additionalPartsDisplayed | ) |
@brief 设置当前会话中是否允许多个显示部件的选项
当设置为false时,所有非活动的显示部件将被隐藏,仅保留活动部件(若存在)可见。 后续任何切换活动显示部件的操作都不会同时显示多个部件,而是用新的显示部件替换单个活动图形窗口的内容。另请参见NXOpen::PartCollection::SetActiveDisplay。 调用NXOpen::PartCollection::AllowMultipleDisplayedParts 将返回 NXOpen::PartCollection::MultipleDisplayedPartStatusDisabledByCustomer。 当设置为true时,NX将允许多个显示部件,但不会恢复之前关闭的非活动窗口。 此选项可通过撤销操作回滚。
创建于NX12.0.0。
许可证要求:无
| additionalPartsDisplayed | 是否允许多个显示部件 |
| NXOpen::PartCollection::SdpsStatus NXOpen::PartCollection::SetDisplay | ( | NXOpen::BasePart * | part, |
| bool | maintainWorkPart, | ||
| bool | setEntirePart, | ||
| NXOpen::PartLoadStatus ** | loadStatus ) |
设置活动显示部件。 等效于使用@link NXOpen::DisplayPartOptionReplaceExisting NXOpen::DisplayPartOptionReplaceExisting@endlink 选项调用@link NXOpen::PartCollection::SetActiveDisplay NXOpen::PartCollection::SetActiveDisplay@endlink 。 @return 若工作部件按要求设置成功则返回OK,否则返回状态码说明失败原因。
创建于NX3.0.0。
许可要求:无
| part | 新的活动显示部件 |
| maintainWorkPart | 若为true,且当前工作部件是新活动显示部件的组件,则工作部件保持不变。否则工作部件将设置为新的活动显示部件。 |
| setEntirePart | 若为true且maintain_work_part为true,工作组件的引用集将设置为"整个部件"。若为false,则保持不变。参见NXOpen::Assemblies::ComponentAssembly::ReplaceReferenceSet |
| loadStatus | 加载新显示部件时发现的所有错误和警告。 |
| void NXOpen::PartCollection::SetMirrorPartType | ( | NXOpen::Part * | part, |
| NXOpen::LinkedMirrorPartBuilder::MirrorPartTypeOption | mirrorOption ) |
设置关联镜像部件的类型
版本:NX8.5.0
许可要求:实体建模 ("SOLIDS MODELING")
| part | 输入部件 |
| mirrorOption | 镜像选项 |
| void NXOpen::PartCollection::SetNonmasterSeedPartData | ( | const char * | filename | ) |
设置非主种子部件数据,用于打开未填充的非主部件
版本:NX6.0.0
许可要求:无
| filename | 部件名称 |
| void NXOpen::PartCollection::SetNonmasterSeedPartData | ( | const NXString & | filename | ) |
设置非主种子部件数据,用于打开未填充的非主部件
版本:NX6.0.0
许可要求:无
| filename | 部件名称 |
| void NXOpen::PartCollection::SetOpenPassword | ( | const char * | fileName, |
| const char * | password ) |
输入打开部件的密码
创建于NX8.5.0。
许可要求:无
| fileName | 文件名 |
| password | 打开密码 |
| void NXOpen::PartCollection::SetOpenPassword | ( | const NXString & | fileName, |
| const NXString & | password ) |
移除部件的密码。此方法仅应与GC工具包配合使用。
部件 输入打开部件的密码
创建于NX8.5.0。
许可要求:无
| fileName | 文件名 |
| password | 打开密码 |
| void NXOpen::PartCollection::SetPassword | ( | NXOpen::Part * | part, |
| const char * | adminPassword, | ||
| const char * | readPassword, | ||
| const char * | writePassword, | ||
| const char * | fullControlPassword, | ||
| NXOpen::PartCollection::SetProtectionOn | partoption ) |
此方法用于为部件设置新密码。设置密码后,若原始密码丢失或遗忘,部件将无法恢复。 请将密码存储在安全可靠的位置。此方法仅应与GC工具包配合使用。
创建于NX11.0.0。
许可证要求:无
| part | 部件 |
| adminPassword | 管理员密码 |
| readPassword | 只读密码 |
| writePassword | 写入密码 |
| fullControlPassword | 完全控制密码 |
| partoption | 要添加安全保护的部件范围 |
| NX_DEPRECATED("Deprecated in NX11.0.0. Use overloaded SetPassword instead.") void SetPassword(NXOpen void NXOpen::PartCollection::SetPassword | ( | NXOpen::Part * | part, |
| const char * | uAdminPassword, | ||
| const char * | uReadPassword, | ||
| const char * | uWritePassword, | ||
| const char * | uFullControlPassword ) |
| void NXOpen::PartCollection::SetPassword | ( | NXOpen::Part * | part, |
| const NXString & | adminPassword, | ||
| const NXString & | readPassword, | ||
| const NXString & | writePassword, | ||
| const NXString & | fullControlPassword, | ||
| NXOpen::PartCollection::SetProtectionOn | partoption ) |
此方法用于为部件设置新密码。设置密码后,若原始密码丢失或遗忘,部件将无法恢复。 请将密码存储在安全可靠的位置。此方法仅应与GC工具包配合使用。
创建于NX11.0.0。
许可证要求:无
| part | 部件 |
| adminPassword | 管理员密码 |
| readPassword | 只读密码 |
| writePassword | 写入密码 |
| fullControlPassword | 完全控制密码 |
| partoption | 要添加安全保护的部件范围 |
| void NXOpen::PartCollection::SetSeedPartTemplateData | ( | const char * | filename, |
| const char * | templateName, | ||
| bool | addMaster ) |
指定用于打开种子部件或空项目版本的模板数据
版本:NX6.0.0
许可要求:无
| filename | 部件名称 |
| templateName | 模板名称 |
| addMaster | 是否将主部件添加为子部件 |
| void NXOpen::PartCollection::SetSeedPartTemplateData | ( | const NXString & | filename, |
| const NXString & | templateName, | ||
| bool | addMaster ) |
指定用于打开种子部件或空项目版本的模板数据
版本:NX6.0.0
许可要求:无
| filename | 部件名称 |
| templateName | 模板名称 |
| addMaster | 是否将主部件添加为子部件 |
| void NXOpen::PartCollection::SetWork | ( | NXOpen::BasePart * | part | ) |
在活动显示部件中设置当前工作部件。工作组件将被设置为当前活动显示部件中代表该部件的可见组件之一。参考SetWorkComponent。 若无可用可见组件,将抛出异常。
创建于NX3.0.0。
许可证要求:无
| part | 新的工作部件。 |
| void NXOpen::PartCollection::SetWorkComponent | ( | NXOpen::Assemblies::Component * | workComponent, |
| NXOpen::PartCollection::RefsetOption | refsetOption, | ||
| NXOpen::PartCollection::WorkComponentOption | visibility, | ||
| NXOpen::PartLoadStatus ** | loadStatus ) |
在活动显示部件中设置工作组件。如果新工作组件代表的部件尚未是工作部件,则相应设置工作部件。
创建于NX3.0.0。
许可证要求:无
| workComponent | 新的工作组件。该组件必须是活动显示部件的NXOpen::Assemblies::ComponentAssembly 中定义的组件。 可为NULL,此时工作部件将重置为活动显示部件。 |
| refsetOption | 控制新组件的引用集。 |
| visibility | 控制新组件不可见时的行为 |
| loadStatus | 加载新工作部件时发现的所有错误。 |
| void NXOpen::PartCollection::SetWorkComponent | ( | NXOpen::Assemblies::Component * | workComponent, |
| NXOpen::PartLoadStatus ** | loadStatus ) |
在当前活动显示部件中设置工作组件。如果新工作组件代表的部件尚未是工作部件,则相应设置工作部件。新组件的引用集将被设置为"整个部件"。
注意:若指定的工作组件不可见,但存在代表同一部件的其他可见组件,则将选择该替代组件作为新工作组件。若找不到可见组件,将抛出异常
创建于NX3.0.0。
许可证要求:无
| workComponent | 新的工作组件。该组件必须是活动显示部件的NXOpen::Assemblies::ComponentAssembly 中定义的组件。 可为NULL,此时工作部件将重置为活动显示部件。 |
| loadStatus | 加载新工作部件时发现的所有错误。 |
| NXOpen::PartLoadStatus * NXOpen::PartCollection::SetWorkComponentOverride | ( | NXOpen::Assemblies::Component * | workComponent | ) |
将带有替代部件的组件设置为活动显示部件中的工作组件。 若组件没有替代部件,将报错。
| workComponent | 新的工作组件。该组件必须是活动显示部件的NXOpen::Assemblies::ComponentAssembly 中定义的组件。 |
| NXOpen::ShapeSearch::SearchManager * NXOpen::PartCollection::ShapeSearchManager | ( | ) |
管理当前会话中形状搜索的NXOpen::ShapeSearch::SearchManager
创建于NX6.0.0。
| void NXOpen::PartCollection::SolveAllPostponedConstraints | ( | ) |
求解会话中所有已加载部件里所有被延迟排布的约束。若有需要,这将触发模型更新。
创建于NX9.0.0。
许可要求:装配("ASSEMBLIES MODULE")
| tag_t NXOpen::PartCollection::Tag | ( | ) | const |
返回此对象的标识。
| NXOpen::Part * NXOpen::PartCollection::Work | ( | ) |
获取会话的当前工作部件。它可以是活动显示部件,也可以是活动显示部件的 NXOpen::Assemblies::ComponentAssembly 中组件所代表的部件。 另请参阅: NXOpen::PartCollection::WorkComponent
如果工作部件不是.prt格式,将抛出错误。
创建于NX3.0.0。
许可证要求:无
| NXOpen::Assemblies::Component * NXOpen::PartCollection::WorkComponent | ( | ) |
获取工作组件。该组件是活动显示部件的NXOpen::Assemblies::ComponentAssembly 中代表当前工作部件的组件。 注意:可能存在多个代表同一工作部件的不同组件,此时将选择其中一个作为工作组件。
创建于NX3.0.0。
许可证要求:无