dbMergeSingleProp

dbMergeSingleProp( 
d_srcPropId 
g_dstObjId 
) 
=> d_dstPropId 

Description

Merges a property with a destination object without overwriting the property if it already exists.

Arguments

d_srcPropId	Source property to be merged.
g_dstObjId	Destination object where the property is to be merged. The destination object can be a property, dbId, ddId, or dbBagId.

Value Returned

d_dstPropId

The property ID of the merged property.

Examples

A property on cellview cv1 is created and copied to cellview cv2.

cv1 = dbOpenCellViewByType("test" "abc" "layout" "maskLayout" "a")

cv2 = dbOpenCellViewByType("test" "xyz" "layout" "" "a")

prop = dbCreateProp(cv1 "width" "int" 10)

dstProp = dbCopySingleProp(prop cv2)

dstProp1 = dbMergeSingleProp(prop cv2)

The same property is merged from cv1 to cv2. The return values, dstProp and dstProp1, have the same property ID because the merge process does not overwrite a property that already exists.

Related Topics

Property Creation and Modification Functions

Return to top