PV SET BORDER STYLE

The PV SET BORDER STYLE command sets the style and color for the border edge.

Note: This command does not apply to the style of area cells. It only defines styles which should then be applied using the PV SET RANGE BORDER style.

To define the edge parameter, use the PV Border edge constants:

A border is defined as an edge (side) of a frame: upper, lower, left, right. To set several borders using a unique call to PV SET BORDER STYLE, simply add constants, for example pv border edge top + pv border edge bottom for a line above and below the frame.

Borders can be combined to form a partial or complete frame for a cell range. In this case, the inner border is the edge of each cell included in the frame and can be addressed using the pv border edge inner vert and pv border edge inner hor constants. Each border can also contain specific, unique characteristics: PV SET BORDER STYLE can be called as many times as there are borders needing to contain different styles.

To define the style parameter, use the PV Border style constants:

These constants are defined as follows:

• For simple borders, the constant indicates the number of pixels (for example pv border style 4 = a line of 4 pixels).
• For combined borders, the constant indicates the number of pixels for each component (for example pv border style 211  = a line of 2 pixels, 1 space of 1 pixel, a line of 1 pixel).
  These constants are detailed in the following illustration:

The constants pv border style quarter and pv border style half are used to set or get a border size of respectively 0.25 pixels and 0.5 pixels. These values are only significant at the time of printing.

The color parameter is a BGR-type long integer. This value can be taken from one of the 256 colors of the 4D palette using the PV Index to color command: specifically, it is possible to use the constants of the 4D language, Colors theme, available for the first 16 colors (the first row of the color palette).
Refer to the description of the following 4D commands for details on the colors available in 4D:

• OBJECT SET RGB COLORS for the system of RGB colors used by 4D.
• OBJECT SET COLOR for the 4D palette of indexed colors.

Note: Internal coding of 4D View colors is of the BGR type, which is reversed with respect to 4D's RGB coding; however, the principles of use are the same.

See the example for the PV SET RANGE BORDER command.