Chapter 14
Corel® Presentations™ Product Commands
Ba to Bu
The macro commands in Corel Presentations help you automate your slide show and drawing tasks, from adding slides to a slide show to drawing shapes automatically.
BackgroundGallery
Purpose
Display a gallery of slide show backgrounds that you can choose from.
Syntax
BackgroundGallery ()
See Also
BackgroundInsert
BackgroundGetNext
Purpose
Select the next background in the Background Name dialog box.
Syntax
BackgroundGetNext ()
See Also
BackgroundGetPrevious
BackgroundGetPrevious
Purpose
Select the previous background in the Background Name dialog box.
Syntax
BackgroundGetPrevious ()
See Also
BackgroundGetNext
BackgroundInsert
Purpose
Specify a background from the Background Gallery and apply it to your slide show.
Syntax
BackgroundInsert (Filename: string; KeepObjects: enumeration)
Parameters
Filename
string The name of the .WPG file to insert as the new background.
KeepObjects
enumeration Specify whether to keep objects from the existing background before replacing it with the new one.
No!
Yes!
See Also
BackgroundGallery
BackgroundNext
Purpose
Open the next background in the Background Editor.
Syntax
BackgroundNext ()
See Also
BackgroundPrevious
BackgroundPrevious
Purpose
Open the previous background in the Background Editor.
Syntax
BackgroundPrevious ()
See Also
BackgroundNext
Backspace
Purpose
Delete the character to the left of the insertion point in the Text Editor.
Syntax
Backspace ()
BeginAcquireImageArea
Purpose
Activate the tool used to define a rectangular area which will contain a scanned image. The image is scaled to fit inside the area, matching the closest width or height dimension of the area and maintaining the aspect ratio. A scanning device with a TWAIN driver must be installed for this command to function.
Syntax
BeginAcquireImageArea ()
See Also
BeginAcquireImageFixedSize
BeginAcquireImageFixedSize
Purpose
Activate the tool used to scan an image into a rectangular area. The image is scaled to match both the width and height of the area. The aspect ration is maintained if the scanning software supports it. If not, the image width and height are scaled non-uniformly and the image may be distorted. A scanning device with a TWAIN driver must be installed for this command to function.
Syntax
BeginAcquireImageFixedSize ()
See Also
BeginAcquireImageArea
BeginAirBrush
Purpose
Activate the Air Brush tool in the Bitmap Editor.
Syntax
BeginAirBrush ()
See Also
AirBrush
BeginArrow
Purpose
Activate the Arrow drawing tool.
Syntax
BeginArrow ()
See Also
AddPolyCurve
BeginBezier
Purpose
Activate the Bezier Curve drawing tool.
Syntax
BeginBezier ()
See Also
AddPolyCurve
BeginBitmap
Purpose
Activate the Bitmap tool.
Syntax
BeginBitmap ()
BeginBulletChart
Purpose
Activate the tool used to create a new bulleted list.
Syntax
BeginBulletChart ()
See Also
ChartCreateBullet
BeginCircle
Purpose
Activate the Circle drawing tool.
Syntax
BeginCircle ()
See Also
AddArc
BeginCircularArc
Purpose
Activate the Circular Arc drawing tool.
Syntax
BeginCircularArc ()
See Also
AddArc
BeginClosedCurve
Purpose
Activate the Closed Curve drawing tool.
Syntax
BeginClosedCurve ()
See Also
AddPolyCurve
BeginCurve
Purpose
Activate the Curve drawing tool.
Syntax
BeginCurve ()
See Also
AddPolyCurve
BeginDataChart
Purpose
Activate the tool used to create a data chart.
Syntax
BeginDataChart ()
See Also
ChartCreate, ChartSetCreateSize
BeginEllipse
Purpose
Activate the Ellipse drawing tool.
Syntax
BeginEllipse ()
See Also
AddArc
BeginEllipticalArc
Purpose
Activate the Elliptical Arc drawing tool.
Syntax
BeginEllipticalArc ()
See Also
AddArc
BeginFloodFill
Purpose
Activate Flood Fill in the Bitmap Editor.
Syntax
BeginFloodFill ()
See Also
FloodFill
BeginFreehand
Purpose
Activate the Freehand drawing tool.
Syntax
BeginFreehand ()
See Also
AddPolyCurve
BeginLine
Purpose
Activate the Polyline drawing tool.
Syntax
BeginLine ()
See Also
AddPolyLine
BeginLine2
Purpose
Activate the Line drawing tool.
Syntax
BeginLine2 ()
See Also
AddPolyLine
BeginOrgChart
Purpose
Activate the tool used to create a new organization chart.
Syntax
BeginOrgChart ()
See Also
ChartCreateOrg
BeginPaintBrush
Purpose
Activate the Paint Brush tool in the Bitmap Editor.
Syntax
BeginPaintBrush ()
See Also
PaintBrush
BeginPaintDropper
Purpose
Activate the Pickup Color tool in the Bitmap Editor.
Syntax
BeginPaintDropper ()
See Also
PaintDropper
BeginPaintEraser
Purpose
Activate the Eraser tool in the Bitmap Editor.
Syntax
BeginPaintEraser ()
See Also
PaintEraser
BeginPolygon
Purpose
Activate the Polygon drawing tool.
Syntax
BeginPolygon ()
See Also
AddPolyLine
BeginRectangle
Purpose
Activate the Rectangle drawing tool.
Syntax
BeginRectangle ()
See Also
AddPolyLine
BeginRegularPolygon
Purpose
Activate the Regular Polygon drawing tool.
Syntax
BeginRegularPolygon ()
See Also
AddPolyLine
BeginRetrieveFigure
Purpose
Activate the Clipart drawing tool, which is used to insert a figure into the current document.
Syntax
BeginRetrieveFigure ()
See Also
RetrieveFigure
BeginRoundedRectangle
Purpose
Activate the Rounded Rectangle drawing tool.
Syntax
BeginRoundedRectangle ()
See Also
AddRoundedRect
BeginSelect
Purpose
Activate the Select drawing tool, which is used to select items to modify.
Syntax
BeginSelect ()
BeginSelectArea
Purpose
Activate the tool used to select part of the current drawing in the Bitmap Editor.
Syntax
BeginSelectArea ()
BeginSelectiveReplace
Purpose
Activate Selective Replace in the Bitmap Editor. Selective Replace allows you replace foreground-color pixels with background-color pixels.
Syntax
BeginSelectiveReplace ()
See Also
SelectiveReplace
BegOfLine
Purpose
Move the insertion point to the beginning of the current line of text in the Text Editor.
Syntax
BegOfLine ()
See Also
EndOfLine
BitmapBlur
Purpose
Apply the Blur effect to the current bitmap image.
Syntax
BitmapBlur (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Amount: enumeration)
Parameters
Region
enumeration (optional) Blur the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Amount
enumeration (optional) The amount of blurring.
High!
Low!
Medium!
See Also
BitmapSpecialEffectsDlg
BitmapBrightness
Purpose
Change the brightness of the current bitmap image.
Syntax
BitmapBrightness (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Percent: numeric)
Parameters
Region
enumeration (optional) Change the brightness of the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Percent
numeric (optional) The percentage by which to increase or decrease brightness. A value of 50% specifies no change.
See Also
BitmapSpecialEffectsDlg
BitmapCancel
Purpose
Close the Bitmap Editor without saving changes.
Syntax
BitmapCancel ()
BitmapContrast
Purpose
Change the contrast values for the current bitmap image.
Syntax
BitmapContrast (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Percent: numeric)
Parameters
Region
enumeration (optional) Change the contrast for the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Percent
numeric (optional) The percentage by which to increase or decrease contrast. A value of 50% specifies no change.
See Also
BitmapSpecialEffectsDlg
BitmapCreate
Purpose
Open the Bitmap Editor to create a new bitmap image. If no parameters are specified, this command creates a full-page bitmap area.
Syntax
BitmapCreate (Left: numeric; Top: numeric; Right: numeric; Bottom: numeric)
Parameters
Left
numeric (optional) The horizontal position of the lower left corner of the bitmap area, in Corel WordPerfect units (1200ths of an inch).
Top
numeric (optional) The vertical position of the lower left corner of the bitmap area, in Corel WordPerfect units.
Right
numeric (optional) The horizontal position of the upper right corner of the bitmap area, in Corel WordPerfect units.
Bottom
numeric (optional) The vertical position of the upper right corner of the bitmap area, in Corel WordPerfect units.
BitmapEmboss
Purpose
Apply the Emboss effect to the current bitmap image.
Syntax
BitmapEmboss (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric)
Parameters
Region
enumeration (optional) Emboss the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
See Also
BitmapSpecialEffectsDlg
BitmapEqualize
Purpose
Apply the Equalize effect to the current bitmap image.
Syntax
BitmapEqualize (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric)
Parameters
Region
enumeration (optional) Equalize the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
See Also
BitmapSpecialEffectsDlg
BitmapMosaic
Purpose
Apply the Mosaic effect to the current bitmap image.
Syntax
BitmapMosaic (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Size: numeric)
Parameters
Region
enumeration (optional) Apply the Mosaic effect to the full image or to the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Size
numeric (optional) The size of mosaic “tiles.”
See Also
BitmapSpecialEffectsDlg
BitmapRain
Purpose
Apply the Rain effect to the current bitmap image.
Syntax
BitmapRain (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Length: numeric)
Parameters
Region
enumeration (optional) Apply the Rain effect to the full image or to the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Length
numeric (optional) The length of streaks, in pixels.
See Also
BitmapSpecialEffectsDlg
BitmapReturn
Purpose
Close the Bitmap Editor and insert the bitmap object into the current drawing.
Syntax
BitmapReturn ()
See Also
BeginBitmap, BitmapCancel, BitmapCreate
BitmapSaturation
Purpose
Change color saturation for the current bitmap image.
Syntax
BitmapSaturation (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Percent: numeric)
Parameters
Region
enumeration (optional) Specify whether to change color saturation for the full image or for the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Percent
numeric (optional) The percentage by which to increase or decrease saturation. A value of 50% specifies no change.
See Also
BitmapSpecialEffectsDlg
BitmapSharpen
Purpose
Apply the Sharpen effect to the current bitmap image.
Syntax
BitmapSharpen (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Amount: enumeration)
Parameters
Region
enumeration (optional) Specify whether to sharpen the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Amount
enumeration (optional) The sharpness level.
High!
Low!
Medium!
See Also
BitmapSpecialEffectsDlg
BitmapSmooth
Purpose
Apply the Smooth effect to the current bitmap image.
Syntax
BitmapSmooth (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Amount: enumeration)
Parameters
Region
enumeration (optional) Smooth the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selection area.
Amount
enumeration (optional) The smoothness level.
High!
Low!
Medium!
See Also
BitmapSpecialEffectsDlg
BitmapSpecialEffectsDlg
Purpose
Display the Special Effects dialog box, which is used to specify visual effects for a bitmap object in the Bitmap Editor.
Syntax
BitmapSpecialEffectsDlg ()
BitmapSpikeRemoval
Purpose
Remove spikes from the current bitmap image.
Syntax
BitmapSpikeRemoval (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Amount: enumeration)
Parameters
Region
enumeration (optional) Remove spikes from the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Amount
enumeration (optional) The smoothness level.
High!
Low!
Medium!
See Also
BitmapSpecialEffectsDlg
BitmapStereogram
Purpose
Apply the Stereogram effect to the current bitmap image.
Syntax
BitmapStereogram (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric)
Parameters
Region
enumeration (optional) Apply effect to the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
See Also
BitmapSpecialEffectsDlg
BitmapTrace
Purpose
Convert a bitmap image into a vector image.
Syntax
BitmapTrace ()
BitmapTraceContours
Purpose
Trace the edge of a bitmap object.
Syntax
BitmapTraceContours (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Amount: enumeration)
Parameters
Region
enumeration (optional) Trace the full image or the portion inside or outside a selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel of the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Amount
enumeration (optional) The amount of tracing.
High!
Low!
Medium!
See Also
BitmapSpecialEffectsDlg
BitmapUndo
Purpose
Reverse the effects of the most recent editing change in the Bitmap Editor.
Syntax
BitmapUndo ()
BitmapWind
Purpose
Apply the Wind effect to the current bitmap image.
Syntax
BitmapWind (Region: enumeration; Left: numeric; Top: numeric; Right: numeric; Bottom: numeric; Length: numeric; Direction: enumeration)
Parameters
Region
enumeration (optional) Apply the wind effect to the full image or the area inside or outside the selected area.
Full!
Inside!
Outside!
Left
numeric (optional) The horizontal coordinate of the pixel in the top left corner of the selected area. Coordinates are measured from the top left pixel in the bitmap area (0,0).
Top
numeric (optional) The vertical coordinate of the pixel in the top left corner of the selected area.
Right
numeric (optional) The horizontal coordinate of the pixel in the bottom right corner of the selected area.
Bottom
numeric (optional) The vertical coordinate of the pixel in the bottom right corner of the selected area.
Length
numeric (optional) The length of streaks, in pixels.
Direction
enumeration (optional) The direction the wind blows.
Both!
Left!
Right!
See Also
BitmapSpecialEffectsDlg
BitmapZoom
Purpose
Toggle magnification in the Bitmap Editor so you can edit a bitmap area one pixel at a time.
Syntax
BitmapZoom (Direction: enumeration)
Parameters
Direction
enumeration (optional) Zoom in or out.
In!
Out!
See Also
BitmapCreate
BlackAndWhite
Purpose
Change the colors of the selected objects to black and white.
Syntax
BlackAndWhite ()
See Also
InvertColors, OutlineObject, SilhouetteObject
BlendDlg
Purpose
Display the Blend dialog box, which is used to combine the shapes, sizes, and colors of two selected objects.
Syntax
BlendDlg ()
See Also
BlendObjects
BlendObjects
Purpose
Combine the shapes, sizes, and colors of two selected objects.
Syntax
BlendObjects (BlendSteps: numeric)
Parameters
BlendSteps
numeric (optional) The number of blending steps.
See Also
BlendDlg
BoxAttributesDlg
Purpose
Display the BoxProperties dialog box, which is used in organization charts to change box colors, appearance, and style.
Syntax
BoxAttributesDlg ()
BranchZoomInOut
Purpose
Zoom the selected branch in or out.
Syntax
BranchZoomInOut (ZoomInOut: enumeration)
Parameters
ZoomInOut
enumeration (optional)
OFF!
ON!
BrushAttributesDlg
Purpose
Display the Brush Attributes dialog box, which is used in the Bitmap Editor to specify brush shape, width, and spray density.
Syntax
BrushAttributesDlg ()
BulletChartAttrEnd
Purpose
Close a command sequence used to specify bulleted list attributes. Precede with BulletChartAttrStart and commands which specify attributes.
Syntax
BulletChartAttrEnd (SaveTo: enumeration)
Parameters
SaveTo
enumeration (optional) Specify where to save style information.
Chart!
Layout!
See Also
BulletChartAttrStart
BulletChartAttrStart
Purpose
Begin a command sequence used to specify bullet chart attributes. Follow with commands which specify attributes and with BulletChartAttrEnd.
Syntax
BulletChartAttrStart ()
See Also
BulletChartAttrEnd