使用者可透過區塊註解,在區塊中新增註解。就像文字式程式語言中的註解一樣,這些註解不會影響區塊的行為。標準語言程式碼產生器會將這些屬性加入產生的程式碼 (包括自訂區塊產生的程式碼)。
附註圖示
使用者可透過留言圖示的文字編輯器輸入區塊留言。
根據預設,系統不會顯示留言圖示。顯示方式有兩種:
- 使用非空值字串呼叫
Block.setCommentText
。 - 讓使用者在區塊的內容選單中按一下「新增註解」即可顯示註解。
如要移除留言圖示,請按照下列步驟操作:
- 使用
null
呼叫Block.setCommentText
。 - 讓使用者在區塊的內容選單中按一下「移除留言」即可移除。
請注意,「新增註解」和「移除註解」只會在下列情況下顯示在內容選單中:
- 這個區塊可編輯。
- 區塊未收合。
comments
設定選項已設為true
。如果您未明確設定這個選項,如果工具箱有類別,則預設為true
;否則為false
。
透過程式碼使用區塊註解
如要取得區塊註解:
// Returns comment text or null if there is no comment.
myBlock.getCommentText();
如要設定區塊註解:
// Sets comment text and displays comment icon.
myBlock.setCommentText('My comment');
如何刪除區塊註解:
// Removes comment text and removes comment icon.
myBlock.setCommentText(null);
以程式輔助方式處理註解的能力不會受到區塊狀態 (例如是否可編輯或已摺疊) 或 comments
設定選項的影響。