mlreportgen.ppt.Border Class
R2026bNamespace: mlreportgen.ppt
Border of a table, table entry, picture, or video
Description
Use an mlreportgen.ppt.Border format object to customize the border of a
table, table entry, picture, or video in a PowerPoint (PPT) API presentation.
Note
A conflict occurs if two table entries share a border segment. For a conflicting horizontal border segment, Microsoft® PowerPoint® ignores the formats specified by the entry on the bottom. For a conflicting vertical border segment, PowerPoint ignores the formats specified by the entry on the right.
The mlreportgen.ppt.Border class is a handle class.
Class Attributes
ConstructOnLoad | true |
HandleCompatible | true |
For information on class attributes, see Class Attributes.
Creation
Description
mlreportgen.ppt.Border creates an empty
mlreportgen.ppt.Border object. By default, PowerPoint renders table borders as thin, solid, black lines. Use the object properties
to specify a different border width, style, or color.
mlreportgen.ppt.Border(
sets the Style,
TopStyle,
BottomStyle, LeftStyle,
and RightStyle
properties to the value of style)style.
mlreportgen.ppt.Border(
also sets the Color,
TopColor,
BottomColor, LeftColor,
and RightColor
properties to the value of style,color)color.
mlreportgen.ppt.Border(
also sets the Width, TopWidth,
BottomWidth, LeftWidth,
and RightWidth
properties to the value of style,color,width)width.
Input Arguments
Properties
Examples
To customize the border or a border segment of a table or table entry in a PPT API presentation, specify the border style, color, and width in an mlreportgen.ppt.Border format object and add the object to the Style property of an mlreportgen.ppt.Table or mlreportgen.ppt.TableEntry object. This example specifies that the bottom border of the entry in the second row and second column is dashed and red, with a width of three points.
Create a presentation.
import mlreportgen.ppt.* ppt = Presentation("myTEBorders.pptx"); open(ppt);
Add a slide to the presentation.
slide = add(ppt,"Title and Table");Create a table.
t = Table(magic(3));
Create a border object to customize the bottom border segment.
border = Border(); border.BottomStyle = "dash"; border.BottomColor = "red"; border.BottomWidth = "3pt";
Apply the custom border to the entry in the second column and second row.
tr2te2 = t.entry(2,2);
tr2te2.Style = [tr2te2.Style {border}];Add a title and the table to the slide.
replace(slide,"Title","Table entry with custom borders"); replace(slide,"Table",t);
Close and view the presentation.
close(ppt); rptview(ppt);
Here is the table in the generated presentation:
Since R2026b
To customize the border of a picture in a PPT API presentation, specify
the border style, color, and width in an mlreportgen.ppt.Border object and
add the object to the Style property of an
mlreportgen.ppt.Picture object.
Create a presentation.
import mlreportgen.ppt.* ppt = Presentation("myPictureBorder.pptx"); open(ppt);
Add a slide to the presentation.
slide = add(ppt,"Title and Picture");Create a picture.
pic = Picture(which("peppers.png"));Create a border object and apply it to the picture.
border = Border("solid","red","3pt"); pic.Style = [pic.Style {border}];
Add a title and the picture to the slide.
replace(slide,"Title","Picture with a custom border"); replace(slide,"Picture",pic);
Close and view the presentation.
close(ppt); rptview(ppt);
Since R2026b
To customize the border of a video in a PPT API presentation, specify the
border style, color, and width in an mlreportgen.ppt.Border object and
add the object to the Style property of an
mlreportgen.ppt.Video object.
Create a presentation.
import mlreportgen.ppt.* ppt = Presentation("myVideoBorder.pptx"); open(ppt);
Add a slide to the presentation.
slide = add(ppt,"Title and Content");Create a video.
v = Video(which("xylophone.mp4"));Create a border object and apply it to the video.
border = Border("solid","red","3pt"); v.Style = [v.Style {border}];
Add a title and the video to the slide.
replace(slide,"Title","Video with a custom border"); replace(slide,"Content",v);
Close and view the presentation.
close(ppt); rptview(ppt);
Version History
Introduced in R2020a
