Class ImageCropStyle
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
ObrazPrzytnijStyl
Klasa reprezentująca styl przycinania, który można zastosować do komponentów obrazu. Nie możesz zmienić rozmiaru obrazu, ale możesz go przyciąć.
Szczegółowa dokumentacja
setAspectRatio(ratio)
Ustawia współczynnik proporcji, który ma być używany, jeśli typ przycięcia to RECTANGLE_CUSTOM. Współczynnik musi być wartością dodatnią.
Parametry
| Nazwa | Typ | Opis |
ratio | Number | Stosowany współczynnik. |
Powrót
ImageCropStyle – ten obiekt do łańcucha.
Rzuty
Error – jeśli dane wejściowe mają wartość ujemną lub zero.
setImageCropType(type)
Ustawia typ przycięcia obrazu. Wartość domyślna to SQUARE.
Parametry
Powrót
ImageCropStyle – ten obiekt do łańcucha.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\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."]]
