Shape.AddToCatalogMergeArea Method (Publisher)

Adds the specified shape or shapes to the publication page's catalog merge area.

Syntax

expression .AddToCatalogMergeArea

expression A variable that represents a Shape object.

Return Value

Nothing

Remarks

The catalog merge area is automatically resized to accommodate objects that are larger than the merge area, or that are positioned outside the catalog merge area when they are added.

The AddToCatalogMergeArea method does not apply to merge data fields:

• Use the Insert method of the MailMergeDataFields collection to add a picture data field to a publication page's catalog merge area.

• Use the InsertMailMergeField method of the TextRange object to add a text data field to a text box.

Note that to add a text box that will contain text data fields to a catalog merge area, you use the AddToCatalogMergeArea method.

Example

The following example adds a rectangle to the catalog merge area on the first page of the specified publication. This example assumes a catalog merge area has been added to the first page.

ThisDocument.Pages(1).Shapes.AddShape(1, 80, 75, 450, 125).AddToCatalogMergeArea