Class ImageCropStyle
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
圖片裁剪樣式
此類別代表可套用至圖片元件的裁剪樣式。您無法設定圖片大小或調整大小，但可以裁剪圖片。
內容詳盡的說明文件
setAspectRatio(ratio)
如果裁剪類型為 RECTANGLE_CUSTOM，則會設定要使用的顯示比例。比率必須為正值。
參數
| 名稱 | 類型 | 說明 |
ratio | Number | 要套用的比率。 |
回攻員
ImageCropStyle：這個物件用於鏈結。
擲回
Error：如果輸入值為負數或零。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：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."]]
