|
Siebel Consumer Goods Handheld Guide > Print Tagging Language > Data Output Tags >
Picture Tag
The Picture tag specifies the graphic files that are included in the print template. When used in absolute print mode (with absolute mode-only tags), graphics are printed from the specified file at the specified position, and according to the specified dimensions. Usage
Use the Picture tag to add graphic images, such as a company logo, to your documents. Supported file formats are BMP and JPG. Graphics files are located in the \Program Files\Siebel Handheld\templates directory on the handheld device. Specify the full path name of the file for the Name parameter. Scaling or graphics operations, such as inverse image, are not supported. The alignment and position parameters are used together to place the graphic. Alignment specifies the left edge, the center, or the right edge of the graphic. Position is the distance, specified in millimeters, from the left edge of the paper. Example
- If align="Left" and position="30", then the left edge of the graphic is set 30 mm from the left edge of the paper.
- If align="Center" and Position="30", the center of the graphic is set 30 mm from the left edge of the paper.
- If align="Right" and Position="30", the right edge of the graphic is set 30 mm from the left edge of the paper.
If the position is not specified, the position defaults to 0. Depending on the alignment setting, the graphic is left-aligned (align="Left"), right-aligned (align="Right"), or centered (align="Center").
- In absolute mode-only, if left="20", top="40", right ="80", and bottom="80", then the picture is drawn 20 mm from the left margin and 40 mm from the top margin, and is 60 x 40 millimeters in size.
- In the absolute mode-only, if right="80" and bottom="80", then the picture is drawn at the current location and is 80 x 80 mm in size.
When left="x" and top="y" parameters are not specified, the picture is drawn at the current head position. In such cases, the right="x" and bottom="y" parameters specify the width and height of the image respectively.
Syntax
To use this tag, use the following syntax: <TAG:Picture name="FILE NAME" align="ALIGNMENT" position="POSITION">
|
|
TAG:Picture |
Required. Picture tag indicator. |
name |
(Required) Specifies the full path and name of the graphics file. |
align |
(Optional) Specifies the left edge, the center, or the right edge of the graphic. Used with the Position parameter to specify the horizontal position of the graphic. Valid values are LEFT (default), CENTER, and RIGHT. |
position |
(Optional) Specified in millimeters, this is the distance from the left edge of the paper. Used with the Alignment parameter to specify the horizontal position of the graphic. The default is 0. |
Example
<TAG:Picture name="\Program Files\Siebel Handheld\templates\logo.bmp" alignment="Right" Position="88"> Syntax (absolute mode-only)
To use this tag, use the following syntax: <TAG:Picture name="FULL PATH FILE NAME" left="LEFT VALUE" right="RIGHT VALUE top="TOP VALUE" bottom="BOTTOM VALUE" position="POSITION">
|
|
TAG:Picture |
(Required) Picture tag indicator. |
left |
(Optional, absolute mode-only tag) Specified in millimeters, this is the distance of the left side of the rectangle from the left margin. If omitted, the current head position is used, and the RIGHT parameter is used to specify the width. |
top |
(Optional, absolute mode-only tag) Specified in millimeters, this is the distance of the top side of the rectangle from the top margin. If omitted, the current head position is used, and the BOTTOM parameter is used to specify the height. |
right |
(Required, absolute mode-only tag) Specified in millimeters, this is the position of the right side of the rectangle on the X axis from the left margin. |
bottom |
(Required, absolute mode-only tag) Specified in millimeters, this is the position of the bottom side of the rectangle on the Y axis from the top margin. |
Example (absolute mode-only)
<TAG:Picture name="\Program Files\Siebel Handheld\templates\logo.bmp" left="20" top="40" right="80" bottom="80"> <TAG:Picture name="\Program Files\Siebel Handheld\templates\logo.bmp" right="80" bottom="80">
|
