RWA_IMAGE_ANCHOR

Purpose

Creates an anchor for up to three different images in a single position. For example, it could be used to display a button that changes colour when the mouse hovers above it, then changes colour again when you click it - that is, three different images of the button are displayed showing it in three different colours. This subroutine appends the code generated to a string.

Syntax

RWA_IMAGE_ANCHOR(vString, LinkURL, Description, aImageURLArray, TargetFrame, aClass)

Parameters

vString A variable containing the string to which the generated code is appended. On return, the variable contains the modified string. If the string does not exist, it is created.

LinkURL URLClosed Uniform Resource Locator - a web address.  to be called when the image is clicked.

Description Alternative text for the image (the text displayed if the image cannot be displayed).

aImageURLArray
A dynamic arrayClosed A multi-element string variable in which data is divided into elements by attribute marks, value marks and subvalue marks, matching the structure of a Reality file item. The entire array is referenced and stored as a single variable. For more information, refer to the Reality DataBasic Reference Manual.  containing up to 3 image URLs:

  • Element 1 specifies the default URLClosed Uniform Resource Locator - a web address.  for the image.
  • Element 2, if specified, is the URL of the text or image to be displayed when the mouse is over the image.
  • Element 3, if specified, is the URL of the text or image to be displayed when the user clicks on the image.

TargetFrame Identity of the frame in which the LinkURL is to be activated.  If this parameter is an empty string, the default is the top level window.

aClass A dynamic array that can contain the following elements:

Element No.

Attribute

Description

1

CLASS

The name of a tag class defined in a CSSClosed Cascading Style Sheet - a mechanism by which the presentation of an HTML page can be separated from the content. A style sheet can be used to determine the appearance of one or more HTML pages.  stylesheet.

Attributes defined in the aClass parameter are applied to the IMG tag.

For information about using aClass, see The aClass Parameter.