Class AffineTransformBuilder
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
AffineTransformBuilder
AffineTransform
物件的建構工具。預設為身分轉換。
呼叫 AffineTransformBuilder#build()
以取得 AffineTransform
物件。
const transform =
SlidesApp.newAffineTransformBuilder().setScaleX(2.0).setShearY(1.1).build();
// The resulting transform matrix is
// [ 2.0 0.0 0.0 ]
// [ 1.1 1.0 0.0 ]
// [ 0 0 1 ]
}
內容詳盡的說明文件
setTranslateY(translateY)
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eAffineTransformBuilder\u003c/code\u003e helps create custom transformations for objects in Google Slides, like scaling or shearing.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to set scaling, shearing, and translation values for the X and Y coordinates.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ebuild()\u003c/code\u003e method finalizes the transformation and returns an \u003ccode\u003eAffineTransform\u003c/code\u003e object, ready to be applied.\u003c/p\u003e\n"],["\u003cp\u003eThis builder uses a fluent interface, allowing you to chain methods together for concise transformation definitions.\u003c/p\u003e\n"]]],["`AffineTransformBuilder` constructs `AffineTransform` objects, defaulting to the identity transform. It uses methods like `setScaleX`, `setScaleY`, `setShearX`, `setShearY`, `setTranslateX`, and `setTranslateY` to modify the transformation elements. Each 'set' method takes a number parameter, and returns the builder. The `build()` method creates the `AffineTransform` object with the specified elements.\n"],null,["# Class AffineTransformBuilder\n\nAffineTransformBuilder\n\nA builder for [AffineTransform](/apps-script/reference/slides/affine-transform) objects. Defaults to the identity transform.\n\nCall `Affine``Transform``Builder#build()` to get the [AffineTransform](/apps-script/reference/slides/affine-transform) object.\n\n```text\nconst transform =\n SlidesApp.newAffineTransformBuilder().setScaleX(2.0).setShearY(1.1).build();\n\n// The resulting transform matrix is\n// [ 2.0 0.0 0.0 ]\n// [ 1.1 1.0 0.0 ]\n// [ 0 0 1 ]\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|-------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| [build()](#build()) | [AffineTransform](/apps-script/reference/slides/affine-transform) | Creates an [AffineTransform](/apps-script/reference/slides/affine-transform) object initialized with the elements set in the builder. |\n| [setScaleX(scaleX)](#setScaleX(Number)) | [AffineTransformBuilder](#) | Sets the X coordinate scaling element and returns the builder. |\n| [setScaleY(scaleY)](#setScaleY(Number)) | [AffineTransformBuilder](#) | Sets the Y coordinate scaling element and returns the builder. |\n| [setShearX(shearX)](#setShearX(Number)) | [AffineTransformBuilder](#) | Sets the X coordinate shearing element and returns the builder. |\n| [setShearY(shearY)](#setShearY(Number)) | [AffineTransformBuilder](#) | Sets the Y coordinate shearing element and returns the builder. |\n| [setTranslateX(translateX)](#setTranslateX(Number)) | [AffineTransformBuilder](#) | Sets the X coordinate translation element in points, and returns the builder. |\n| [setTranslateY(translateY)](#setTranslateY(Number)) | [AffineTransformBuilder](#) | Sets the Y coordinate translation element in points, and returns the builder. |\n\nDetailed documentation\n----------------------\n\n### `build()`\n\nCreates an [AffineTransform](/apps-script/reference/slides/affine-transform) object initialized with the elements set in the builder.\n\n#### Return\n\n\n[AffineTransform](/apps-script/reference/slides/affine-transform)\n\n*** ** * ** ***\n\n### `set``Scale``X(scaleX)`\n\nSets the X coordinate scaling element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `scaleX` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Scale``Y(scaleY)`\n\nSets the Y coordinate scaling element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `scaleY` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Shear``X(shearX)`\n\nSets the X coordinate shearing element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `shearX` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Shear``Y(shearY)`\n\nSets the Y coordinate shearing element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `shearY` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Translate``X(translateX)`\n\nSets the X coordinate translation element in points, and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|----------|-------------|\n| `translateX` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Translate``Y(translateY)`\n\nSets the Y coordinate translation element in points, and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|----------|-------------|\n| `translateY` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)"]]