LinkPattern Property (ContainerRenderer Object)

The LinkPattern property returns or sets a rendering source that determines how a link in a table row is rendered. Read/write.

Syntax

objContRend.LinkPattern

Data Type

String

Remarks

The LinkPattern property supplies rendering information for a link to the object represented in a row of a table view. This link should normally use the complete HTTP syntax.

In a calendar view, a link is rendered from each AppointmentItem object to its related appointment form. The link is rendered on a nonblank property such as Location or Subject, or on StartTime if no other nonblank property can be found on the appointment.

The CDO Rendering Library generates a link for exactly one cell in each row of a table. It attempts to link the cell in the first column that represents a nonempty string property other than the message class. If no such column can be found, the last cell in the row is linked.

The LinkPattern property determines the appearance of the link in the HTML output. The following table shows which substitution tokens can be used. Note that their interpretations are not the same as those for either a column's RenderUsing property or a pattern's RenderUsing property.

Substitution token Attribute of object being linked
%classpath% A special-purpose format with the name "classpath" for rendering a message object's message class.
%obj% The object's unique identifier, expressed as a hexadecimal string.
%rowid% The object's index in its containing table.
%<formatname>% Any user-defined or system-defined named format.

Setting LinkPattern generates a Format object with the name "message_Link" and adds it to the container renderer's Formats collection. This named format is for internal use only. You should always use the combination of Render and LinkPattern to render any link.