零件对象首选项更多...

#include <Preferences_PartObject.hxx>

Public 类型
enum	ColorSelection { ColorSelectionNoChange , ColorSelectionDefaultColor , ColorSelectionColor }
enum	LineFontType { LineFontTypePartDefault = 1 , LineFontTypeSolid , LineFontTypeDashed , LineFontTypePhantom , LineFontTypeCenterline , LineFontTypeDotted , LineFontTypeLongDashed , LineFontTypeDottedDashed , LineFontTypeEight , LineFontTypeNine , LineFontTypeTen , LineFontTypeEleven }
enum	ObjectType { ObjectTypeGeneral , ObjectTypeLine , ObjectTypeArc , ObjectTypeConic , ObjectTypeSpline , ObjectTypeSolidbody , ObjectTypeSheetbody , ObjectTypeDatum , ObjectTypePoint , ObjectTypeCoordinateSystem , ObjectTypeAllButDefault , ObjectTypeDatumCsys , ObjectTypeTraceline , ObjectTypeInfiniteLine , ObjectTypePointCloud }
enum	WidthType { WidthTypePartDefault = 1 , WidthTypeThinWidth , WidthTypeNormalWidth , WidthTypeThickWidth , WidthTypeWidthOne , WidthTypeWidthTwo , WidthTypeWidthThree , WidthTypeWidthFour , WidthTypeWidthFive , WidthTypeWidthSix , WidthTypeWidthSeven , WidthTypeWidthEight , WidthTypeWidthNine }

Public 成员函数
NXOpen::Preferences::ViewVisualizationSpecialEffects::ColorRGB	ConvertColorNumberToRGBValue (int colorNumber)
int	ConvertRGBValueToColorNumber (const NXOpen::Preferences::ViewVisualizationSpecialEffects::ColorRGB &fogColorRgbValue)
bool	FaceAnalysis ()
void	GetLegacyLineWidthMap (std::vector< NXOpen::Preferences::PartObject::WidthType > &newLineWidths)
NXOpen::Preferences::PartObject::LineFontType	GetLineFont (NXOpen::Preferences::PartObject::ObjectType type)
int	GetObjectColor (NXOpen::Preferences::PartObject::ObjectType type, NXOpen::Preferences::PartObject::ColorSelection *colorSelection)
NXOpen::Preferences::PartObject::WidthType	GetWidth (NXOpen::Preferences::PartObject::ObjectType type)
bool	MigrateLegacyLineWidths ()
bool	PartiallyShaded ()
int	PointSymbol ()
void	SetFaceAnalysis (bool faceAnalysis)
void	SetLegacyLineWidthMap (const std::vector< NXOpen::Preferences::PartObject::WidthType > &newLineWidths)
void	SetLineFont (NXOpen::Preferences::PartObject::ObjectType type, NXOpen::Preferences::PartObject::LineFontType lineFont)
void	SetObjectColor (NXOpen::Preferences::PartObject::ObjectType type, NXOpen::Preferences::PartObject::ColorSelection colorSelection, int color)
void	SetPartiallyShaded (bool partiallyShaded)
void	SetPointSymbol (int pointSymbol)
void	SetTranslucency (int translucency)
void	SetWidth (NXOpen::Preferences::PartObject::ObjectType type, NXOpen::Preferences::PartObject::WidthType width)
tag_t	Tag () const
int	Translucency ()

详细描述

零件对象首选项

表示适用于整个部件的对象首选项集合。除工作层外，UG界面中所有对象相关首选项均可通过此类设置。工作层需通过 NXOpen::Layer::LayerManager 类设置，该类包含工作层属性。
要获取此类实例，请参考 NXOpen::Preferences::PartPreferences

在NX3.0.0版本创建。

成员枚举类型说明

◆ ColorSelection

enum NXOpen::Preferences::PartObject::ColorSelection

描述对象颜色状态：不修改、使用默认颜色或使用用户定义颜色

枚举值
ColorSelectionNoChange	不修改
ColorSelectionDefaultColor	默认颜色
ColorSelectionColor	用户定义颜色

◆ LineFontType

enum NXOpen::Preferences::PartObject::LineFontType

表示可用的线型类型

枚举值
LineFontTypePartDefault	部件默认值
LineFontTypeSolid	实线
LineFontTypeDashed	虚线
LineFontTypePhantom	双点划线
LineFontTypeCenterline	中心线
LineFontTypeDotted	点线
LineFontTypeLongDashed	长虚线
LineFontTypeDottedDashed	点划线
LineFontTypeEight	长双点划线（默认字体）
LineFontTypeNine	长点划线（默认字体）/波浪线（造船字体）
LineFontTypeTen	长三点划线（默认字体）/锯齿线（造船字体）
LineFontTypeEleven	长短双划线（默认字体）/铁路线（造船字体）

◆ ObjectType

enum NXOpen::Preferences::PartObject::ObjectType

描述所有可用的对象选择类型

枚举值
ObjectTypeGeneral	默认类型值
ObjectTypeLine	直线
ObjectTypeArc	圆弧
ObjectTypeConic	圆锥曲线
ObjectTypeSpline	样条曲线
ObjectTypeSolidbody	实体
ObjectTypeSheetbody	片体
ObjectTypeDatum	基准
ObjectTypePoint	点
ObjectTypeCoordinateSystem	坐标系
ObjectTypeAllButDefault	除默认外全部
ObjectTypeDatumCsys	基准坐标系特征
ObjectTypeTraceline	轨迹线
ObjectTypeInfiniteLine	无限长直线
ObjectTypePointCloud	点云

◆ WidthType

enum NXOpen::Preferences::PartObject::WidthType

表示可用的线宽类型

枚举值
WidthTypePartDefault	部件默认值
WidthTypeThinWidth	细线宽
WidthTypeNormalWidth	正常线宽
WidthTypeThickWidth	粗线宽
WidthTypeWidthOne	线宽1
WidthTypeWidthTwo	线宽2
WidthTypeWidthThree	线宽3
WidthTypeWidthFour	线宽4
WidthTypeWidthFive	线宽5
WidthTypeWidthSix	线宽6
WidthTypeWidthSeven	线宽7
WidthTypeWidthEight	线宽8
WidthTypeWidthNine	线宽9

成员函数说明

◆ ConvertColorNumberToRGBValue()

NXOpen::Preferences::ViewVisualizationSpecialEffects::ColorRGB NXOpen::Preferences::PartObject::ConvertColorNumberToRGBValue ( int colorNumber )

将颜色编号转换为RGB分量。传入的颜色编号需在1到216之间

返回: 对应的RGB分量
版本：NX3.0.0

许可要求：无

参数

colorNumber 颜色编号

◆ ConvertRGBValueToColorNumber()

int NXOpen::Preferences::PartObject::ConvertRGBValueToColorNumber ( const NXOpen::Preferences::ViewVisualizationSpecialEffects::ColorRGB & fogColorRgbValue )

将RGB颜色分量转换为颜色编号。红、绿、蓝分量需在0到255之间

返回: 对应的颜色编号
版本：NX3.0.0

许可要求：无

参数

fogColorRgbValue 雾色RGB值

◆ FaceAnalysis()

bool NXOpen::Preferences::PartObject::FaceAnalysis ( )

获取实体和曲面的面分析标志
版本：NX3.0.0

许可要求：无

◆ GetLegacyLineWidthMap()

void NXOpen::Preferences::PartObject::GetLegacyLineWidthMap ( std::vector< NXOpen::Preferences::PartObject::WidthType > & newLineWidths )

获取用于将旧版线宽转换为新版线宽的映射关系。以下为旧版线宽： Preferences::PartObject::WidthTypeThinWidth Preferences::PartObject::WidthTypeNormalWidth Preferences::PartObject::WidthTypeThickWidth 新版线宽包含上述三种旧版线宽分别对应的线宽，从 Preferences::PartObject::WidthTypeWidthOne 开始。
版本：NX10.0.0

许可要求：无

参数

newLineWidths 包含3个新版线宽的数组，分别对应一种旧版线宽。第一个元素对应细宽第二个元素对应标准宽第三个元素对应粗宽。

◆ GetLineFont()

NXOpen::Preferences::PartObject::LineFontType NXOpen::Preferences::PartObject::GetLineFont ( NXOpen::Preferences::PartObject::ObjectType type )

返回指定对象类型的当前线型

返回: 创建于NX3.0.0。

许可要求：无

参数

type 类型

◆ GetObjectColor()

int NXOpen::Preferences::PartObject::GetObjectColor	(	NXOpen::Preferences::PartObject::ObjectType	type,
		NXOpen::Preferences::PartObject::ColorSelection *	colorSelection )

返回指定类型的当前颜色值。可调用ConvertColorNumberToRGBValue 获取对应的RGB值。红色分量计算公式：((((216 - color_number) % 36)/6)* 51) 绿色分量计算公式：(((216 - color_number)/36) * 51) 蓝色分量计算公式：(((216 - color_number) % 6)* 51)。例如，若返回的颜色值为47：红色 = ((((216 - 47) % 36)/6)* 51) = (((169 % 36)/6)* 51) = ((25/6)* 51) = 4*51 = 204 绿色 = (((216 - 47)/36) * 51) = ((169/36) * 51) = 4*51 = 204 蓝色 = (((216 - 47) % 6)* 51) = ((169 % 6)* 51) = 1*51 = 51

返回

弃用: 在NX2312.0.0中废弃。请使用NXOpen::Preferences::PartObject::GetObjectColor

创建于NX3.0.0。

许可要求：无

类型设置颜色。传入-2表示默认颜色，传入-1表示不修改颜色。其他颜色需按RGB格式计算。若传入红色分量R、绿色分量G、蓝色分量B，颜色值计算公式为： color = (((255-R)/51)*6 + ((255-G)/51)*36 + ((255-B)/51)*1) + 1 ; 其中R、G、B取值范围为0到255。例如绿色(0,255,0)的计算： color = (((255-0)/51)*6 + ((255-255)/51)*36 + ((255-0)/51)*1) + 1 = 30+0+5+1 = 36 可调用ConvertRGBValueToColorNumber 获取对应的颜色编号。

弃用: 在NX2312.0.0中废弃。请使用NXOpen::Preferences::PartObject::SetObjectColor

创建于NX3.0.0。

许可要求：无

类型指定颜色返回指定类型的当前颜色值。可调用ConvertColorNumberToRGBValue 获取对应的RGB值。红色分量计算公式：((((216 - color_number) % 36)/6)* 51) 绿色分量计算公式：(((216 - color_number)/36) * 51) 蓝色分量计算公式：(((216 - color_number) % 6)* 51)。例如，若返回的颜色值为47：红色 = ((((216 - 47) % 36)/6)* 51) = (((169 % 36)/6)* 51) = ((25/6)* 51) = 4*51 = 204 绿色 = (((216 - 47)/36) * 51) = ((169/36) * 51) = 4*51 = 204 蓝色 = (((216 - 47) % 6)* 51) = ((169 % 6)* 51) = 1*51 = 51

返回: 创建于NX2312.0.0。

许可要求：无

参数

type	类型
colorSelection	颜色选择

◆ GetWidth()

NXOpen::Preferences::PartObject::WidthType NXOpen::Preferences::PartObject::GetWidth ( NXOpen::Preferences::PartObject::ObjectType type )

返回指定对象类型的当前线宽

返回: 创建于NX3.0.0。

许可要求：无

参数

type 类型

◆ MigrateLegacyLineWidths()

bool NXOpen::Preferences::PartObject::MigrateLegacyLineWidths ( )

将部件文件中存储的线宽属性迁移到对应的新线宽。迁移基于部件文件中存储的旧版线宽映射执行。请参考 Preferences::PartObject::GetLegacyLineWidthMap 各类可显示对象（如实体、线框、工程图视图等）的线宽将更新为新线宽。必要时会重新生成显示以反映更改。已分配新线宽的可显示对象不受影响。

返回: 是否至少有一个旧版线宽属性已完成迁移。
创建于NX10.0.0。

许可要求：无

◆ PartiallyShaded()

bool NXOpen::Preferences::PartObject::PartiallyShaded ( )

获取实体和曲面的半着色标志
版本：NX3.0.0

许可要求：无

◆ PointSymbol()

int NXOpen::Preferences::PartObject::PointSymbol ( )

获取点的点符号
创建于NX1872.0.0。

许可要求：无

◆ SetFaceAnalysis()

void NXOpen::Preferences::PartObject::SetFaceAnalysis ( bool faceAnalysis )

设置实体和曲面的面分析标志
版本：NX3.0.0

许可要求：无

参数

faceAnalysis 面分析状态

◆ SetLegacyLineWidthMap()

void NXOpen::Preferences::PartObject::SetLegacyLineWidthMap ( const std::vector< NXOpen::Preferences::PartObject::WidthType > & newLineWidths )

设置用于将旧版线宽转换为新版线宽的映射关系。参见 Preferences::PartObject::GetLegacyLineWidthMap 用于映射旧版线宽的新版线宽需符合逻辑顺序；即 Preferences::PartObject::WidthTypeThinWidth 对应的线宽值需小于 Preferences::PartObject::WidthTypeNormalWidth ，以此类推。否则，旧版线宽映射关系将被拒绝。
版本：NX10.0.0

许可要求：无

参数

newLineWidths 包含3个新版线宽的数组，分别对应一种旧版线宽。第一个元素对应细宽第二个元素对应标准宽第三个元素对应粗宽。

◆ SetLineFont()

void NXOpen::Preferences::PartObject::SetLineFont	(	NXOpen::Preferences::PartObject::ObjectType	type,
		NXOpen::Preferences::PartObject::LineFontType	lineFont )

设置指定对象类型的线型
创建于NX3.0.0。

许可要求：无

参数

type	类型
lineFont	线型

◆ SetObjectColor()

void NXOpen::Preferences::PartObject::SetObjectColor	(	NXOpen::Preferences::PartObject::ObjectType	type,
		NXOpen::Preferences::PartObject::ColorSelection	colorSelection,
		int	color )

设置颜色。使用默认颜色请调用NXOpen::Preferences::PartObject::ColorSelection::DefaultColor 不修改颜色请调用NXOpen::Preferences::PartObject::ColorSelection::NoChange 其他颜色请使用NXOpen::Preferences::PartObject::ColorSelection::Color 并按RGB格式计算颜色值。若传入红色分量R、绿色分量G、蓝色分量B，颜色值计算公式为： color = (((255-R)/51)*6 + ((255-G)/51)*36 + ((255-B)/51)*1) + 1 ; 其中R、G、B取值范围为0到255。例如绿色(0,255,0)的计算： color = (((255-0)/51)*6 + ((255-255)/51)*36 + ((255-0)/51)*1) + 1 = 30+0+5+1 = 36 可调用ConvertRGBValueToColorNumber 获取对应的颜色编号。
创建于NX2312.0.0。

许可要求：无

参数

type	类型
colorSelection	颜色选择
color	指定颜色

◆ SetPartiallyShaded()

void NXOpen::Preferences::PartObject::SetPartiallyShaded ( bool partiallyShaded )

设置实体和曲面的半着色标志
版本：NX3.0.0

许可要求：无

参数

partiallyShaded 半着色状态

◆ SetPointSymbol()

void NXOpen::Preferences::PartObject::SetPointSymbol ( int pointSymbol )

设置点的点符号
创建于NX1872.0.0。

许可要求：无

参数

pointSymbol 点符号

◆ SetTranslucency()

void NXOpen::Preferences::PartObject::SetTranslucency ( int translucency )

设置透明度值
版本：NX3.0.0

许可要求：无

参数

translucency 透明度值

◆ SetWidth()

void NXOpen::Preferences::PartObject::SetWidth	(	NXOpen::Preferences::PartObject::ObjectType	type,
		NXOpen::Preferences::PartObject::WidthType	width )

设置指定对象类型的线宽
版本：NX3.0.0

许可要求：无

参数

type	对象类型
width	线宽类型

◆ Tag()

tag_t NXOpen::Preferences::PartObject::Tag ( ) const

返回此对象的标识。

◆ Translucency()

int NXOpen::Preferences::PartObject::Translucency ( )

获取透明度值
版本：NX3.0.0

许可要求：无

Public 类型

Public 成员函数

详细描述

成员枚举类型说明

◆ ColorSelection

◆ LineFontType

◆ ObjectType

◆ WidthType

成员函数说明

◆ ConvertColorNumberToRGBValue()

◆ ConvertRGBValueToColorNumber()

◆ FaceAnalysis()

◆ GetLegacyLineWidthMap()

◆ GetLineFont()

◆ GetObjectColor()

◆ GetWidth()

◆ MigrateLegacyLineWidths()

◆ PartiallyShaded()

◆ PointSymbol()

◆ SetFaceAnalysis()

◆ SetLegacyLineWidthMap()

◆ SetLineFont()

◆ SetObjectColor()

◆ SetPartiallyShaded()

◆ SetPointSymbol()

◆ SetTranslucency()

◆ SetWidth()

◆ Tag()

◆ Translucency()