Draws a box with text for the given width and height at the specifiy location.
Values passed to this procedure:
| xText, yText | x, y coordinates on the page you want to draw the text. | |
| Text | The text to draw. | |
| FontDictionaryName | The name used to reference the font within the document Font Dictionary. The FontDictionaryName is assigned to the font when you call LoadFont. | |
| FontSize | Font size to be used. | |
| TextAlignment | Text alignment (Center, Left or Right). If the text alignment is left, it is the text beginning position. If the alignment is right, its the ending position. If the alignment is center, its the middle position. | |
| TextColor | Color of the text. | |
| xBox, yBox | x, y coordinates on the page you want to draw the box. This is the top left position of the box. | |
| BoxWidth | Box width. | |
| BoxHeight | Box height. | |
| BorderColor | Color of box border. | |
| BorderThickness | Thickness of the border. | |
| BoxCapStyle | Optional. The box cap style specifies the shape to be used at the ends of each line that makes up the box. The three types are: Squared - the stroke is squared off at the endpoint of the path. There is no projection beyond the end of the path. Round - a semicircular arc with a diameter equal to the line width is drawn around the endpoint and filled in. ProjectingSquare - The stroke continues beyond the endpoint of the path for a distance equal to half the line width and is squared off. The default is Squared. |
The following example uses the GetTextLength function to auto size the the width of the box, based on the width of the text to be dispalyed inside of the box. Because the text x coordinate is 1, the box x coordinate will be .9 (this will leave 1 tenth of an inch between the left border of the box and the first character of text. The box y coordinate will be the value returned by GetTextLength + 2 tenth of an inch.
