AttributePropertiesBaseBuilder Class¶
-
class
NXOpen.
AttributePropertiesBaseBuilder
¶ Bases:
NXOpen.Builder
Represents an
NXOpen.AttributePropertiesBaseBuilder
to be used for creating attributes.A basic attribute consists of a title, a type, and a value. There are six types of attributes: Null, Boolean, Integer, Number, String, and Date. The type detemines which value field will be read during creation. An attribute may reference an expression instead of setting a value. In this case, the referenced expression’s value will also serve as the attribute’s value and will update when the expression changes.
If an attribute template exists with the same title as the attribute, then the attribute will assume all characteristics of the cooresponding template including the type. Attribute templates reside at the part level and provide extra information for referencing attributes. They are created using
NXOpen.AttributeTemplatesBuilder
.The attribute will be distributed to all objects supplied in the selected object list.
This is an abstract class, and cannot be instantiated.
New in version NX8.0.0.
Properties¶
Property | Description |
---|---|
ArrayIndex | Returns or sets the array index. |
BooleanValue | Returns or sets the boolean value. |
Category | Returns or sets the category. |
DataType | Returns or sets the data type, which determines the type of attribute to be created. |
DateValue | Returns the date value. |
Expression | Returns or sets the expression referenced from this attribute. |
IntegerValue | Returns or sets the integer value. |
IsArray | Returns or sets the ‘is array’ flag is set for attributes that have more than one value. |
IsReferenceType | Returns or sets the ‘is reference type’ flag is set for attributes that are linked to system expressions. |
LockOnSave | Returns or sets the ‘LockOnSave’ flag is set for attributes that will be locked once the part is saved (and reloaded) |
NumberValue | Returns or sets the number value. |
ObjectPicker | Returns or sets the object picker. |
SelectedObjects | Returns the selected object(s) list. |
StringValue | Returns or sets the string value. |
Tag | Returns the Tag for this object. |
Title | Returns or sets the attribute title. |
Units | Returns or sets the units associated with an attribute of type Number. |
ValueAlias | Returns or sets the value alias. |
Methods¶
Method | Description |
---|---|
ApplyUnits | Apply the units currently set on the builder to any objects that have a value set for the current attribute. |
Commit | Commits any edits that have been applied to the builder. |
CreateAttribute | Create the attribute from the data set in the builder. |
Delete | Delete the attribute from the given object. |
DeleteArray | Delete the attribute array from the given object. |
Destroy | Deletes the builder, and cleans up any objects created by the builder. |
GetCommittedObjects | For builders that create more than one object, this method returns the objects that are created by commit. |
GetObject | Returns the object currently being edited by this builder. |
SetAttributeObjects | Sets the array of objects that have this attribute |
ShowResults | Updates the model to reflect the result of an edit to the model for all builders that support showing results. |
Validate | Validate whether the inputs to the component are sufficient for commit to be called. |
Enumerations¶
AttributePropertiesBaseBuilderBooleanValueOptions Enumeration | The value choices for an attribute of type Boolean |
AttributePropertiesBaseBuilderDataTypeOptions Enumeration | Specifies the data type of the attribute, this cannot be changed once the attribute has been created |
AttributePropertiesBaseBuilderObjectOptions Enumeration | Specifies which object will be used when applying attributes. |
Property Detail¶
ArrayIndex¶
-
AttributePropertiesBaseBuilder.
ArrayIndex
¶ Returns or sets the array index.
Required if modifying an attribute that has more than one value. The IsArray flag must also be set.
-------------------------------------
Getter Method
Signature
ArrayIndex()
Returns: Return type: int New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
ArrayIndex(arrayIndex)
Parameters: arrayIndex (int) – New in version NX8.0.0.
License requirements: None.
BooleanValue¶
-
AttributePropertiesBaseBuilder.
BooleanValue
¶ Returns or sets the boolean value.
Required if creating an attribute of type Boolean.
-------------------------------------
Getter Method
Signature
BooleanValue()
Returns: Return type: NXOpen.AttributePropertiesBaseBuilderBooleanValueOptions
New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
BooleanValue(boolValue)
Parameters: boolValue ( NXOpen.AttributePropertiesBaseBuilderBooleanValueOptions
) –New in version NX8.0.0.
License requirements: None.
Category¶
-
AttributePropertiesBaseBuilder.
Category
¶ Returns or sets the category.
The category is an optional, user-defined string that allows attributes to be grouped together.
-------------------------------------
Getter Method
Signature
Category()
Returns: Return type: str New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
Category(category)
Parameters: category (str) – New in version NX8.0.0.
License requirements: None.
DataType¶
-
AttributePropertiesBaseBuilder.
DataType
¶ Returns or sets the data type, which determines the type of attribute to be created.
Once the attribute is created, the data type cannot be modified.
-------------------------------------
Getter Method
Signature
DataType()
Returns: Return type: NXOpen.AttributePropertiesBaseBuilderDataTypeOptions
New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
DataType(dataType)
Parameters: dataType ( NXOpen.AttributePropertiesBaseBuilderDataTypeOptions
) –New in version NX8.0.0.
License requirements: None.
DateValue¶
-
AttributePropertiesBaseBuilder.
DateValue
¶ Returns the date value.
The Date object will contain the value for an attribute of type Date.
-------------------------------------
Getter Method
Signature
DateValue()
Returns: Return type: NXOpen.DateBuilder
New in version NX8.0.0.
License requirements: None.
Expression¶
-
AttributePropertiesBaseBuilder.
Expression
¶ Returns or sets the expression referenced from this attribute.
Only used for attributes of type Number, Integer, Boolean, and String. If an expression is referenced, no value fields need to be set, as the attribute uses the value from the expression.
-------------------------------------
Getter Method
Signature
Expression()
Returns: Return type: NXOpen.Expression
New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
Expression(expression)
Parameters: expression ( NXOpen.Expression
) –New in version NX8.0.0.
License requirements: None.
IntegerValue¶
-
AttributePropertiesBaseBuilder.
IntegerValue
¶ Returns or sets the integer value.
Required if creating an attribute of type Integer.
-------------------------------------
Getter Method
Signature
IntegerValue()
Returns: Return type: int New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
IntegerValue(integerValue)
Parameters: integerValue (int) – New in version NX8.0.0.
License requirements: None.
IsArray¶
-
AttributePropertiesBaseBuilder.
IsArray
¶ Returns or sets the ‘is array’ flag is set for attributes that have more than one value.
When this is set, the index needs to be provided to indicate which element will be modified.
-------------------------------------
Getter Method
Signature
IsArray()
Returns: Return type: bool New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
IsArray(isArray)
Parameters: isArray (bool) – New in version NX8.0.0.
License requirements: None.
IsReferenceType¶
-
AttributePropertiesBaseBuilder.
IsReferenceType
¶ Returns or sets the ‘is reference type’ flag is set for attributes that are linked to system expressions.
The type must also be set to String for the Reference attribut to be created/edited. If a Reference attribute is no longer linked to a system expression, it will become a String attribute.
-------------------------------------
Getter Method
Signature
IsReferenceType()
Returns: Return type: bool New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
IsReferenceType(isReferenceType)
Parameters: isReferenceType (bool) – New in version NX8.0.0.
License requirements: None.
LockOnSave¶
-
AttributePropertiesBaseBuilder.
LockOnSave
¶ Returns or sets the ‘LockOnSave’ flag is set for attributes that will be locked once the part is saved (and reloaded)
-------------------------------------
Getter Method
Signature
LockOnSave()
Returns: Return type: bool New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
LockOnSave(lockOnSave)
Parameters: lockOnSave (bool) – New in version NX8.0.0.
License requirements: None.
NumberValue¶
-
AttributePropertiesBaseBuilder.
NumberValue
¶ Returns or sets the number value.
Required if creating an attribute of type Number.
-------------------------------------
Getter Method
Signature
NumberValue()
Returns: Return type: float New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
NumberValue(numberValue)
Parameters: numberValue (float) – New in version NX8.0.0.
License requirements: None.
ObjectPicker¶
-
AttributePropertiesBaseBuilder.
ObjectPicker
¶ Returns or sets the object picker.
This determines what objects the attribute will be applied to. If modified, the select object list will change based on this value.
-------------------------------------
Getter Method
Signature
ObjectPicker()
Returns: Return type: NXOpen.AttributePropertiesBaseBuilderObjectOptions
New in version NX8.0.0.
Deprecated since version NX10.0.0: Use
NXOpen.AttributePropertiesBaseBuilder.SetAttributeObjects()
instead.License requirements: None.
-------------------------------------
Setter Method
Signature
ObjectPicker(objectPicker)
Parameters: objectPicker ( NXOpen.AttributePropertiesBaseBuilderObjectOptions
) –New in version NX8.0.0.
Deprecated since version NX10.0.0: Use
NXOpen.AttributePropertiesBaseBuilder.SetAttributeObjects()
instead.License requirements: None.
SelectedObjects¶
-
AttributePropertiesBaseBuilder.
SelectedObjects
¶ Returns the selected object(s) list.
The created attribute will be applied to all objects in this list.
-------------------------------------
Getter Method
Signature
SelectedObjects()
Returns: Return type: NXOpen.SelectNXObjectList
New in version NX8.0.0.
License requirements: None.
StringValue¶
-
AttributePropertiesBaseBuilder.
StringValue
¶ Returns or sets the string value.
Required if creating an attribute of type String.
-------------------------------------
Getter Method
Signature
StringValue()
Returns: Return type: str New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
StringValue(stringValue)
Parameters: stringValue (str) – New in version NX8.0.0.
License requirements: None.
Title¶
-
AttributePropertiesBaseBuilder.
Title
¶ Returns or sets the attribute title.
The title is required for creating an attribute and must be unique on the given object. Once the attribute is created, the title cannot be modified.
-------------------------------------
Getter Method
Signature
Title()
Returns: Return type: str New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
Title(title)
Parameters: title (str) – New in version NX8.0.0.
License requirements: None.
Units¶
-
AttributePropertiesBaseBuilder.
Units
¶ Returns or sets the units associated with an attribute of type Number.
Once the attribute is created, the unit measure (length, area, etc) cannot be changed. However the units (mm, ft, etc) within the measure can be changed.
-------------------------------------
Getter Method
Signature
Units()
Returns: Return type: str New in version NX8.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
Units(units)
Parameters: units (str) – New in version NX8.0.0.
License requirements: None.
ValueAlias¶
-
AttributePropertiesBaseBuilder.
ValueAlias
¶ Returns or sets the value alias.
Optional for any attribute.
-------------------------------------
Getter Method
Signature
ValueAlias()
Returns: Return type: str New in version NX10.0.0.
License requirements: None.
-------------------------------------
Setter Method
Signature
ValueAlias(valueAlias)
Parameters: valueAlias (str) – New in version NX10.0.0.
License requirements: None.
Method Detail¶
ApplyUnits¶
-
AttributePropertiesBaseBuilder.
ApplyUnits
¶ Apply the units currently set on the builder to any objects that have a value set for the current attribute.
This method does not apply the current value set on the builder.
NXOpen.AttributePropertiesBaseBuilder.CreateAttribute()
should be used for doing that.Signature
ApplyUnits()
Returns: True if attributes were updated successfully Return type: bool New in version NX11.0.0.
License requirements: None.
CreateAttribute¶
-
AttributePropertiesBaseBuilder.
CreateAttribute
¶ Create the attribute from the data set in the builder.
Unlike calling commit, this method will not perform an update.
Signature
CreateAttribute()
Returns: True if the attribute was created/edited successfully Return type: bool New in version NX8.0.0.
License requirements: None.
Delete¶
-
AttributePropertiesBaseBuilder.
Delete
¶ Delete the attribute from the given object.
Signature
Delete(object)
Parameters: object ( NXOpen.NXObject
) – The object containing the attributeNew in version NX8.0.0.
License requirements: None.
DeleteArray¶
-
AttributePropertiesBaseBuilder.
DeleteArray
¶ Delete the attribute array from the given object.
Signature
DeleteArray(object)
Parameters: object ( NXOpen.NXObject
) – The object containing the attributeNew in version NX8.0.0.
License requirements: None.
SetAttributeObjects¶
-
AttributePropertiesBaseBuilder.
SetAttributeObjects
¶ Sets the array of objects that have this attribute
Signature
SetAttributeObjects(objects)
Parameters: objects (list of NXOpen.NXObject
) – the array of objectsNew in version NX8.5.0.
License requirements: None.
Validate¶
-
AttributePropertiesBaseBuilder.
Validate
¶ Validate whether the inputs to the component are sufficient for commit to be called.
If the component is not in a state to commit then an exception is thrown. For example, if the component requires you to set some property, this method will throw an exception if you haven’t set it. This method throws a not-yet-implemented NXException for some components.
Signature
Validate()
Returns: Was self validation successful Return type: bool New in version NX3.0.1.
License requirements: None.