FormatPicture

Syntax

FormatPicture [.SetSize = number] [, .CropLeft = number or text] [, .CropRight = number or text] [, .CropTop = number or text] [, .CropBottom = number or text] [, .ScaleX = number or text] [, .ScaleY = number or text] [, .SizeX = number or text] [, .SizeY = number or text]

Remarks

Applies formatting to the selected graphic. If the current selection is not a graphic or contains a mixture of text and graphics, an error occurs. The arguments for the FormatPicture statement correspond to the options in the Picture dialog box (Format menu).

Argument

Explanation

.SetSize

Indicates what arguments are used to determine the size of the graphic when both the scale and size are specified:

0 (zero) .ScaleX and .ScaleY are used to format the graphic.

1 .SizeX and .SizeY are used to format the graphic.

.CropLeft, .CropRight,
.CropTop, .CropBottom

Amount to crop the graphic, in points (72 points = 1 inch) or a text measurement. If you specify a negative value, the graphic is not cropped. Instead, the amount of white space around the graphic is increased.

.ScaleX, .ScaleY

The horizontal and vertical proportions of the graphic, as percentages of the original width and height.

.SizeX, .SizeY

The horizontal and vertical dimensions of the graphic, in points or a text measurement.


Example

This example resizes the selected graphic to 75 percent of the original width and height:


FormatPicture .ScaleX = "75%", .ScaleY = "75%"

See Also

InsertPicture