Technical Reference > Graphics Builder Automation Interface > Page Properties Functions > PageAddAssociation

PageAddAssociation

Adds a new association to the current page. This function will return an error if an association with the specified name already exists.

Syntax

PageAddAssociation(Name)

Name:

The name of the new association to be added to the current page.

Return Value

0 (zero) if successful, otherwise an error is returned.

Note: For details on handling return and error values, see Error Handling.

Example

Adding a new element and setting its properties:

GraphicsBuilder.PageAddAssociation("MyAssociation")
GraphicsBuilder.SelectAssociationByName("MyAssociation")
GraphicsBuilder.PageAssociationsDefault = "TAG0"
GraphicsBuilder.PageAssociationValueOnError = "Oops"
GraphicsBuilder.PageAssociationDescription = "My Association"

Related Functions

PageAssociationDefault,PageAssociationDescription