您可以通过以下两种方式获取和更改页面元素的大小和位置:
- 针对大小和位置使用 getter 和 setter 函数。
- 使用其
getTransform()
和setTransform()
函数处理其仿射转换,同时保持固有尺寸。
读取页面元素属性
如图所示,在呈现页面元素没有旋转时,以其边界框为参照物,测量尺寸和位置:
- 左侧和顶部:从页面左上角到未旋转边界框的左上角进行测量。使用
getLeft()
和getTop()
读取值。 - Width 和 Height:未旋转边界框的宽度和高度。使用
getWidth()
和getHeight()
读取值。 - 旋转:相对于边界框中心周围的垂直线顺时针旋转。使用
getRotation()
读取值。
所有长度均以点 (pt) 为单位。旋转以度 (°) 为单位。
设置页面元素属性
使用 insertShape()
等插入方法创建页面元素时,您可以设置该元素的大小和位置。对于现有形状,您可以设置大小、位置和旋转角度;此外,您还可以设置元素的缩放比例,以调整大小或沿着元素的某个边缘反射该元素。
创建时
您可以在创建页面元素时提供位置和尺寸信息。
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.TEXT_BOX, 100, 200, 300, 60);
Logger.log('Left: ' + shape.getLeft() + 'pt; Top: '
+ shape.getTop() + 'pt; Width: '
+ shape.getWidth() + 'pt; Height: '
+ shape.getHeight() + 'pt; Rotation: '
+ shape.getRotation() + ' degrees.');
上述脚本会在有效演示文稿的第一张幻灯片上创建一个具有指定位置和大小的形状,并读取该形状的位置和大小信息。预期的日志为:
Left: 100pt; Top: 200pt; Width: 300pt; Height: 60pt; Rotation: 0 degrees.
大小、位置和旋转
您可以在创建页面元素后更新其大小和位置:
- 使用
setLeft()
和setTop()
设置未旋转边界框的左上角的位置。 - 使用
setWidth()
和setHeight()
设置边界框的呈现宽度和高度。 - 使用
setRotation()
可设置边界框围绕其中心顺时针旋转。
以下脚本会在活动演示文稿的第一张幻灯片上创建一个形状,使用 setter 更新其位置、大小和旋转,并读取形状的位置和大小信息。
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setLeft(100).setTop(200).setWidth(50).setHeight(60).setRotation(90);
Logger.log('Left: ' + shape.getLeft()
+ 'pt; Top: ' + shape.getTop()
+ 'pt; Width: ' + shape.getWidth()
+ 'pt; Height: ' + shape.getHeight()
+ 'pt; Rotation: ' + shape.getRotation() + '\u00B0.');
此脚本的预期日志输出如下所示:
Left: 100pt; Top: 200pt; Width: 50pt; Height: 60pt; Rotation: 90°.
尺寸、位置和旋转 setter 可以按任意顺序或组合使用。将上面的第三行替换为以下脚本将产生相同的结果:
shape.setWidth(55);
shape.setRotation(90).setHeight(60).setLeft(100);
shape.setWidth(50).setTop(200);
扩缩
您可以使用 scaleWidth()
和 scaleHeight()
按相对缩放比例拉伸或挤压页面元素,而不是使用上面的 setWidth()
和 setHeight()
将形状大小设置为绝对值。
shape.scaleHeight(0.5).scaleWidth(2);
下图展示了上述代码在旋转 45° 的方形上的工作原理。请注意,在缩放期间,边界框的左上角是固定的。
边缘反射
scaleWidth()
和 scaleHeight()
中的参数可以为负数,以便它们可用于水平或垂直翻转页面元素。
shape.scaleWidth(-1); // Flip horizontally along the left edge of the bounding box.
shape.scaleHeight(-1); // Flip vertically along the top edge of the bounding box.
下图描绘了上述代码如何在旋转 45° 的形状上工作。请注意,页面元素会沿边界框的某一边(而不是中心)翻转。
线条旋转
与其他页面元素一样,线条的旋转并非线条的垂直角度,而是其边界框的旋转。当您创建具有指定起点和终点的线条时,其旋转角度始终为 0°。在 Google 幻灯片界面中拖动线条的端点会更改其垂直角度以及其边界框的大小和位置,但不会改变其旋转角度。使用 setRotation()
可旋转线条的边界框,从而有效地更改其垂直角度。因此,两条直线可以具有相同的视觉垂直角度,但边界框不同,因此大小、位置和旋转值也会不同。
限制
某些大小调整和定位方法与某些类型的页面元素不兼容。下表总结了与某些类型的网页元素不兼容的方法。
方法 | 形状 | 视频 | 表 |
---|---|---|---|
getHeight(), getWidth() | ✔ | ✔ | NO(返回 null) |
setHeight(), setWidth() | ✔ | ✔ | 否 |
setRotation() | ✔ | 否 | 否 |
scaleHeight(), scaleWidth() | ✔ | ✔ | 否 |
如果页面元素有剪切,所有大小调整和定位方法都可能会导致意外结果。所有限制随时可能更改。如需了解最新信息,请参阅参考文档。
使用仿射转换
对于高级控制,还可以通过页面元素固有(原生)大小和仿射转换来计算和调整页面元素的大小和位置。
Google Apps 脚本提供了与使用 Google 幻灯片 API 一样的仿射转换的类似接口。
- 请阅读这篇文章,了解仿射转换的概念以及如何根据页面元素的固有(原生)尺寸和转换来推断渲染大小。在 Apps 脚本中,使用
getInherentWidth()
和getInherentHeight()
,用于设置页面元素的原生尺寸;getTransform()
,用于页面元素的仿射转换。
- 这篇文章介绍了如何使用仿射转换调整页面元素的大小和位置,以实现缩放、旋转、反射等。在 Apps 脚本中,请使用
setTransform()
,用于设置页面元素的仿射转换(类似于绝对模式);preconcatenateTransform()
,用于将仿射转换预先串联到页面元素的当前转换上(类似于 RELATIVE 模式)。
以下脚本会创建一个形状,设置其转换,读取其固有大小,并读取其仿射转换。
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setTransform(SlidesApp.newAffineTransformBuilder()
.setScaleX(2)
.setScaleY(1)
.setTranslateX(100)
.setTranslateY(200)
.build());
Logger.log('Inherent width: ' + shape.getInherentWidth()
+ 'pt; Inherent height: '
+ shape.getInherentHeight() + 'pt.');
此脚本的预期日志输出如下所示:
Inherent width: 236.2pt; Inherent height: 236.2pt.
生成的形状将具有以下转换以及渲染的大小和位置:
AffineTransform{scaleX=2.0, scaleY=1.0, shearX=0.0, shearY=0.0, translateX=100.0, translateY=200.0}
Left: 100pt; Top: 200pt; Width: 472.4pt; Height: 236.2pt; Rotation: 0°.