公告：所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。
ui.Map.DrawingTools.onShapeChange
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
注册一个回调，当绘制模式形状发生更改时触发该回调。
返回一个 ID，该 ID 可传递给 unlisten() 以取消注册回调。
| 用法 | 返回 |
|---|
DrawingTools.onShapeChange(callback) | 字符串 |
| 参数 | 类型 | 详细信息 |
|---|
此：ui.map.drawingtools | ui.Map.DrawingTools | ui.Map.DrawingTools 实例。 |
callback | 函数 | 形状发生变化时要触发的回调。回调会传递两个参数：绘制模式形状（字符串形式，如果取消则为 null）和事件监听器所绑定的 ui.Map.DrawingTools widget。形状值包括：
- point
- line
- polygon
- 矩形
- null
|
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eAllows registration of a callback function triggered when a drawing mode shape is altered.\u003c/p\u003e\n"],["\u003cp\u003eProvides a unique ID to unregister the callback using the \u003ccode\u003eunlisten()\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAccepts a callback function with two parameters: shape (point, line, polygon, rectangle, or null) and the DrawingTools widget.\u003c/p\u003e\n"],["\u003cp\u003eThe callback is invoked, providing the current drawing mode shape and the associated DrawingTools widget, whenever the shape changes.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eDrawingTools.onShapeChange(callback)\u003c/code\u003e method to register the callback and returns a unique ID.\u003c/p\u003e\n"]]],[],null,["# ui.Map.DrawingTools.onShapeChange\n\n\u003cbr /\u003e\n\nRegisters a callback that's fired when a drawing mode shape is changed.\n\n\u003cbr /\u003e\n\nReturns an ID which can be passed to unlisten() to unregister the callback.\n\n| Usage | Returns |\n|----------------------------------------|---------|\n| DrawingTools.onShapeChange`(callback)` | String |\n\n| Argument | Type | Details |\n|-----------------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.map.drawingtools` | ui.Map.DrawingTools | The ui.Map.DrawingTools instance. |\n| `callback` | Function | The callback to fire when the shape is changed. The callback is passed two parameters: the drawing mode shape as a string (or null for cancel) and the ui.Map.DrawingTools widget that the event listener is bound to. The shape values are: - point - line - polygon - rectangle - null |"]]
