Noeud:Collection of Regions, Noeud « Next »:, Noeud « Previous »:Program Listing With Areas, Noeud « Up »:Program Listing With Areas


Collection of Regions

Attributes : Units, OtherUnits, Coords.

A collection of regions AreaSpec is composed of one or several of the following elements, in any order:

A set of regions AreaSet is composed of one or several regions Area.

The AreaSpec, AreaSet and Area elements accept the Units and OtherUnits attributes, defining in which unit are defined the coordinates specified by the included Area element.

The Units attribute can get the following values:

CALSPair x1,y1 x2,y2
bottom-left and up-right coordinates in a rectangle defining the area reproducing the graphics, where the X and Y dimensions get a value between 0 and 10000, indicating the percentage*100 of the total graphics dimension. This kind of coordinates is used for graphics only, and not for specific verbatim environments like ProgramListing or Screen.
LineColumn line column
Line number and column number indicating the beginning of the area, in a line specific environment.
LineRange start_line end_line
The area is contained between the start_line and end_line lines, in a line specific environment.
LineColumnPair line1 column1 line2 coumn2
The area is contained between the points (line1, column1) and (line2, column2). The lines between line1 et line2 are entirely contained in the area, in a line specific environment.
Other
The OtherUnits attribute defines the unit for the coordinates.

The default value for the Units attribute depends on the parent element. For ProgramListingCO or ScreenCO elements, the default value is LineColumn.

The OtherUnits attribute is used when the value of Units is Other. The possible values for OtherUnits are defined by the processing system.

If the Units and OtherUnits attributes are not defined in AreaSet or Area elements, their values are inherited from AreaSpec or AreaSet parent elements.

The Area element is used to define the Coords attribute, giving the area coordinates, in the unit defined by the Units attribute of the current or parent element.

The AreaSet element must also contain a Coords attribute, but the value of this attribute is not used. As a matter of fact, the Coords attribute has to be redefined in the Area elements contained in an AreaSet.

Last, an ID attribute must be defined for the AreaSet and Area elements. This ID will permit to reference the corresponding area or the area set from the CalloutList element included in the same ProgramListingCO or ScreenCO element.

Program Listing

When the ProgramListing element is found inside a ProgramListingCO element, it is better to use an area specification AreaSpec instead of CO elements to define areas inside the program listing.