vcProperty

Property object with its own set of properties, methods and event handlers.

See in: Overview

Module: vcCore

Parent: vcObject

Children: vcBoolListProperty, vcBoolProperty, vcButtonProperty, vcExpressionProperty, vcIntEnumProperty, vcIntLimitProperty, ... (see more)
vcBoolListProperty
vcBoolProperty
vcButtonProperty
vcExpressionProperty
vcIntEnumProperty
vcIntLimitProperty
vcIntListProperty
vcIntProperty
vcIntStepProperty
vcListReferenceProperty
vcMaterialProperty
vcMatrixListProperty
vcMatrixProperty
vcMatrixStepProperty
vcRealLimitProperty
vcRealListProperty
vcRealProperty
vcRealStepProperty
vcReferenceProperty
vcStringListProperty
vcStringProperty
vcStringStepProperty
vcUriProperty
vcVectorListProperty
vcVectorProperty
vcVectorStepProperty

Referenced by: vcGetPropertyStatement.SelectedProperty, vcProcessSetPropertyStatement.ValueExpression, vcProductTypeFilter.AcceptedFlowGroupsProperty, vcProductTypeFilter.AcceptedProductTypesProperty, ... (see more)
vcGetPropertyStatement.SelectedProperty
vcProcessSetPropertyStatement.ValueExpression
vcProductTypeFilter.AcceptedFlowGroupsProperty
vcProductTypeFilter.AcceptedProductTypesProperty
vcPropertyConditionStatement.SelectedProperty
vcPropertyContainer.create()
vcPropertyExpressionProperty.CalculatedValue
vcRunRobotRoutineStatement.RoutineNameProperty
vcSetPropertyStatement.TargetPropertyName
vcSetPropertyStatement.Value
vcStatisticsSeries.Property

Properties

Learn how to use properties here. The properties are also inherited from the parent class.

NameTypeAccessDescription
GroupIntegerRWGets or sets the group assignment of property.
See more
Properties are ordered by groups, and a group number is automatically assigned at the time of creation. This order can be overridden to have properties come before or after one another when listed in the GUI.
IsPersistentBooleanRWGets or sets if property value is saved with component or layout.

Exceptions:
ValueError: When changing the persistency of a built-in property.
IsVisibleBooleanRWGets or sets if the property is visible in the Properties panel.
NameStringRWGets or sets the name of property.
See more
Exceptions:
ValueError: When changing the name of a built-in property.
ValueError: When name is not unique inside the property container.
RebuildOnChangeBooleanRWGets or sets if component geometry is rebuilt when the property value is changed.
See more
Exceptions:
ValueError: When changing the component rebuild behavior of a built-in property.
ReconfigureOnChangeBooleanRWGets or sets if component structure is reconfigured when the property value is changed.
See more
Exceptions:
ValueError: When changing the component reconfiguration behavior of a built-in property.
UpdateOnChangeBooleanRWGets or sets if simulation world is updated when the property value is changed.
See more
Exceptions:
ValueError: When changing the simulation world update behavior of a built-in property.
WritableWhenConnectedBooleanRWGets or sets if property value can be set when component of property is connected to another component via interface.

Exceptions:
ValueError: When changing the writability of a built-in property.
WritableWhenDisconnectedBooleanRWGets or sets if property value can be set when component of property is not connected to another component via interface.

Exceptions:
ValueError: When changing the writability of a built-in property.
WritableWhenSimulatingBooleanRWGets or sets if property value can be set when a simulation is running.

Exceptions:
ValueError: When changing the writability of a built-in property.

Methods

Learn how to use methods here. The methods are also inherited from the parent class.

NameReturn TypeParametersDescription
deleteNoneNoneDeletes the property.
See more
Exceptions:
ValueError: When deleting a built-in property.
ValueError: When the property container cannot be modified.

Events

Learn how to use events here. The events are also inherited from the parent class.

NameParametersDescription
OnChangedvcProperty propertyTriggered when value of property is changed.

Parameters:
property (vcProperty): The property that changed.

Example: Create New Property

"""This example shows how to create a property and set its value."""

import vcCore as vc

comp = vc.getComponent()
prop_container = comp.Properties
counter_prop = prop_container.create(vc.vcPropertyType.INT,"Counter")
counter_prop.Value = 10

Example: Wait for Property Value

""" This example shows how to wait for a property value to change."""

import vcCore as vc

comp = vc.getComponent()

async def OnRun():
  int_prop = comp.Properties["Integer_1"]
  await int_prop.waitFor(5, waitTrigger = True)
 

Example: Read Property Value

""" This example shows how to read a property value from a component."""

import vcCore as vc

comp = vc.getComponent()
counter_prop = comp.Properties["Counter"]
print (counter_prop.Value)