公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ui.Map.DrawingTools.onShapeChange
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
註冊在繪圖模式形狀變更時觸發的回呼。
傳回可傳遞至 unlisten() 的 ID，用於取消註冊回呼。
| 用量 | 傳回 |
|---|
DrawingTools.onShapeChange(callback) | 字串 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：ui.map.drawingtools | ui.Map.DrawingTools | ui.Map.DrawingTools 執行個體。 |
callback | 函式 | 形狀變更時要觸發的回呼。回呼會傳遞兩個參數：繪圖模式形狀 (字串，取消時為空值)，以及事件監聽器繫結的 ui.Map.DrawingTools 小工具。形狀值如下：
|
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：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 |"]]
