Class ImageCropStyle
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
图片剪裁样式
表示可应用于图片组件的剪裁样式的类。您无法设置图片的大小或调整其大小，但可以剪裁图片。
详细文档
setAspectRatio(ratio)
设置剪裁类型为 RECTANGLE_CUSTOM 时要使用的宽高比。该比率必须为正值。
参数
| 名称 | 类型 | 说明 |
ratio | Number | 要应用的比率。 |
返回
ImageCropStyle - 此对象，用于链式调用。
抛出
Error - 如果输入是负数或零。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eImageCropStyle\u003c/code\u003e allows cropping images within Google Apps Script, but not resizing them directly.\u003c/p\u003e\n"],["\u003cp\u003eTwo main methods, \u003ccode\u003esetAspectRatio\u003c/code\u003e and \u003ccode\u003esetImageCropType\u003c/code\u003e, provide control over the cropping process.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetAspectRatio\u003c/code\u003e is applicable only when using the \u003ccode\u003eRECTANGLE_CUSTOM\u003c/code\u003e crop type and requires a positive ratio value.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetImageCropType\u003c/code\u003e lets you choose the shape of the crop, with \u003ccode\u003eSQUARE\u003c/code\u003e being the default option.\u003c/p\u003e\n"],["\u003cp\u003eBoth methods return the \u003ccode\u003eImageCropStyle\u003c/code\u003e object, enabling method chaining for streamlined code.\u003c/p\u003e\n"]]],["The `ImageCropStyle` class allows users to crop images without resizing them. Key actions include setting the image crop type using `setImageCropType`, which defaults to SQUARE. For a `RECTANGLE_CUSTOM` crop type, you can set the aspect ratio via `setAspectRatio`, which requires a positive numeric value. Both methods return the `ImageCropStyle` object, enabling method chaining. `setAspectRatio` throws an error if the ratio is zero or negative.\n"],null,["# Class ImageCropStyle\n\nImageCropStyle\n\nA class that represents a crop style that can be applied to image components. You can't set the\nsize of an image or resize it, but you can crop the image. \n\n### Methods\n\n| Method | Return type | Brief description |\n|------------------------------------------------------------|---------------------|----------------------------------------------------------------------|\n| [setAspectRatio(ratio)](#setAspectRatio(Number)) | [ImageCropStyle](#) | Sets the aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. |\n| [setImageCropType(type)](#setImageCropType(ImageCropType)) | [ImageCropStyle](#) | Sets the crop type for the image. |\n\nDetailed documentation\n----------------------\n\n### `set``Aspect``Ratio(ratio)`\n\nSets the aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. The ratio must\nbe a positive value.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|---------------------|\n| `ratio` | `Number` | The ratio to apply. |\n\n#### Return\n\n\n[ImageCropStyle](#) --- This object, for chaining.\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the input is negative or zero.\n\n*** ** * ** ***\n\n### `set``Image``Crop``Type(type)`\n\nSets the crop type for the image. Default is SQUARE.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------------------------------------------------------------------|----------------|\n| `type` | [ImageCropType](/apps-script/reference/card-service/image-crop-type) | The crop type. |\n\n#### Return\n\n\n[ImageCropStyle](#) --- This object, for chaining."]]
