Skip to main content

Class: CommentChange

Defined in: packages/blockly/core/events/events_comment_change.ts:23

Notifies listeners that the contents of a workspace comment has changed.

Extends

Properties index

PropertyDescription
workspaceIdThe workspace identifier for this event.
groupAn ID for the group of events this block is associated with.
recordUndoWhether this event is undoable or not.
isUiEventWhether or not the event is a UI event.
isBlankWhether or not the event was constructed without necessary parameters (to be populated by fromJson).
commentIdThe ID of the comment that this event references.
typeType of this event.
oldContents_The previous contents of the comment.
newContents_The new contents of the comment.

Methods index

MethodDescription
getEventWorkspace_Get workspace the event belongs to.
CommentCreateDeleteHelperHelper function for Comment[Create
toJsonEncode the event as JSON.
isNullDoes this event record any change of state?
runRun a change event.

Constructors

Constructor

new CommentChange(
opt_comment?,
opt_oldContents?,
opt_newContents?
): CommentChange;

Defined in: packages/blockly/core/events/events_comment_change.ts:39

Parameters

ParameterTypeDescription
opt_comment?WorkspaceCommentThe comment that is being changed. Undefined for a blank event.
opt_oldContents?stringPrevious contents of the comment.
opt_newContents?stringNew contents of the comment.

Returns

CommentChange

Overrides

CommentBase.constructor

Properties

workspaceId?

optional workspaceId?: string = undefined;

Defined in: packages/blockly/core/events/events_abstract.ts:30

The workspace identifier for this event.

Inherited from

CommentBase.workspaceId


group

group: string;

Defined in: packages/blockly/core/events/events_abstract.ts:38

An ID for the group of events this block is associated with.

Groups define events that should be treated as an single action from the user's perspective, and should be undone together.

Inherited from

CommentBase.group


recordUndo

recordUndo: boolean;

Defined in: packages/blockly/core/events/events_abstract.ts:41

Whether this event is undoable or not.

Inherited from

CommentBase.recordUndo


isUiEvent

isUiEvent: boolean = false;

Defined in: packages/blockly/core/events/events_abstract.ts:44

Whether or not the event is a UI event.

Inherited from

CommentBase.isUiEvent


isBlank

isBlank: boolean = true;

Defined in: packages/blockly/core/events/events_comment_base.ts:29

Whether or not the event was constructed without necessary parameters (to be populated by fromJson).

Inherited from

CommentBase.isBlank


commentId?

optional commentId?: string;

Defined in: packages/blockly/core/events/events_comment_base.ts:32

The ID of the comment that this event references.

Inherited from

CommentBase.commentId


type

type: EventType = EventType.COMMENT_CHANGE;

Defined in: packages/blockly/core/events/events_comment_change.ts:24

Type of this event.

Overrides

CommentBase.type


oldContents_?

optional oldContents_?: string;

Defined in: packages/blockly/core/events/events_comment_change.ts:28

The previous contents of the comment.


newContents_?

optional newContents_?: string;

Defined in: packages/blockly/core/events/events_comment_change.ts:31

The new contents of the comment.

Methods

getEventWorkspace_()

getEventWorkspace_(): Workspace;

Defined in: packages/blockly/core/events/events_abstract.ts:111

Get workspace the event belongs to.

Returns

Workspace

The workspace the event belongs to.

Throws

if workspace is null.

Inherited from

CommentBase.getEventWorkspace_


CommentCreateDeleteHelper()

static CommentCreateDeleteHelper(event, create): void;

Defined in: packages/blockly/core/events/events_comment_base.ts:97

Helper function for Comment[Create|Delete]

Parameters

ParameterTypeDescription
eventCommentCreate | CommentDeleteThe event to run.
createbooleanif True then Create, if False then Delete

Returns

void

Inherited from

CommentBase.CommentCreateDeleteHelper


toJson()

toJson(): CommentChangeJson;

Defined in: packages/blockly/core/events/events_comment_change.ts:61

Encode the event as JSON.

Returns

CommentChangeJson

JSON representation.

Overrides

CommentBase.toJson


isNull()

isNull(): boolean;

Defined in: packages/blockly/core/events/events_comment_change.ts:109

Does this event record any change of state?

Returns

boolean

False if something changed.

Overrides

CommentBase.isNull


run()

run(forward): void;

Defined in: packages/blockly/core/events/events_comment_change.ts:118

Run a change event.

Parameters

ParameterTypeDescription
forwardbooleanTrue if run forward, false if run backward (undo).

Returns

void

Overrides

CommentBase.run