com.myscript.iink

Class Editor

java.lang.Object

com.myscript.iink.Editor

All Implemented Interfaces:

IAutoCloseable

public class Editor
extends java.lang.Object
implements IAutoCloseable

The Editor is the entry point by which modification is associated to a part. An editor is associated with a single part.

See Also:

ContentPart

Method Summary

Modifier and Type	Method and Description
ContentBlock	addBlock(float x, float y, java.lang.String blockType) Adds a new block to the part.
ContentBlock	addBlock(float x, float y, java.lang.String blockType, MimeType mimeType, java.lang.String data) Adds a new block to the part and fills it with data.
ContentBlock	addImage(float x, float y, java.io.File inputFile, MimeType mimeType) Adds a new image to the part.
void	addListener(IEditorListener listener) Adds the specified listener to this editor.
boolean	canRedo() Tells whether redo can be performed on the part or not
boolean	canUndo() Tells whether undo can be performed on the part or not
void	clampViewOffset(Point viewOffset) Clamps the supplied view offset to the area that ensures standard scrolling behavior.
void	clear() Removes all content from the part.
void	close() Deletes native counterpart of this auto closable object
void	convert(ContentBlock block, ConversionState targetState) Converts the specified content to digital form.
void	copy(ContentBlock block) Copies a block to the internal clipboard.
void	drawStroke(PointerEvent[] events, ICanvas2 canvas) Draws pointer events with current editor style settings on the given canvas.
void	export_(ContentBlock block, java.io.File outputFile, IImageDrawer imageDrawer) Deprecated. use export_(ContentBlock, String, IImageDrawer) instead.
void	export_(ContentBlock block, java.io.File outputFile, MimeType mimeType, IImageDrawer imageDrawer) Deprecated. use export_(ContentBlock, String, MimeType, IImageDrawer) instead.
java.lang.String	export_(ContentBlock block, MimeType mimeType) Exports the specified content.
java.lang.String	export_(ContentBlock block, MimeType mimeType, ParameterSet overrideConfiguration) Exports the specified content.
void	export_(ContentBlock block, java.io.OutputStream outputStream, MimeType mimeType, IImageDrawer imageDrawer) Exports the specified content.
void	export_(ContentBlock block, java.io.OutputStream outputStream, MimeType mimeType, IImageDrawer imageDrawer, ParameterSet overrideConfiguration) Exports the specified content.
void	export_(ContentBlock block, java.lang.String outputFilePath, IImageDrawer imageDrawer) Exports the specified content.
void	export_(ContentBlock block, java.lang.String outputFilePath, IImageDrawer imageDrawer, ParameterSet overrideConfiguration) Exports the specified content.
void	export_(ContentBlock block, java.lang.String outputFilePath, MimeType mimeType, IImageDrawer imageDrawer) Exports the specified content.
void	export_(ContentBlock block, java.lang.String outputFilePath, MimeType mimeType, IImageDrawer imageDrawer, ParameterSet overrideConfiguration) Exports the specified content.
ContentBlock	getBlockById(java.lang.String id) Returns the content block associated with a given id.
Configuration	getConfiguration() Returns the configuration associated with this editor.
Engine	getEngine() Returns the Engine to which this editor is attached.
ContentPart	getPart() Returns the part managed by this editor.
java.lang.String	getPenStyle() Returns the style properties associated with new strokes.
java.lang.String	getPenStyleClasses() Returns the style classes associated with new strokes.
int	getPossibleRedoCount() The number of operations that can be redone.
int	getPossibleUndoCount() The number of operations that can be undone.
Renderer	getRenderer() Returns the Renderer associated with this editor.
ContentBlock	getRootBlock() Returns the content block at the root of the current part.
MimeType[]	getSupportedAddBlockDataMimeTypes(java.lang.String type) Returns the supported formats for adding a new block with data.
java.lang.String[]	getSupportedAddBlockTypes() Returns the types of blocks that can be added to the part.
MimeType[]	getSupportedExportMimeTypes(ContentBlock block) Returns the supported export formats for specified content.
MimeType[]	getSupportedImportMimeTypes(ContentBlock block) Returns the supported import formats for specified content.
ConversionState[]	getSupportedTargetConversionStates(ContentBlock block) Returns the supported target conversion states for the specified content.
java.lang.String	getTheme() Returns the rendering theme style sheet, in CSS format.
java.lang.String	getUndoRedoIdAt(int stackIndex) Returns the id of an undo or redo action, based on its position in the stack index.
int	getUndoStackIndex() Returns the number of operations performed on the part, since content part was opened.
int	getViewHeight() The height of the view.
int	getViewWidth() The width of the view.
ContentBlock	hitBlock(float x, float y) Return the block at the given position, or null if there is no block at that position.
void	import_(MimeType mimeType, java.lang.String data, ContentBlock block) Imports data into the part or a block.
boolean	isClosed() Tells whether the close() method has been called.
boolean	isEmpty(ContentBlock block) Checks whether a block is empty.
boolean	isIdle() Checks whether part modification operations are over.
boolean	isScrollAllowed() Checks whether scrolling on the part is allowed at this time.
java.util.Map<java.lang.String,Style>	listStyleClasses(IPredicate<java.lang.String> predicate) Lists the style classes that match a given predicate, associated with their styling properties.
void	paste(float x, float y) Pastes the content of the internal clipboard at a given position.
void	pointerCancel(int pointerId) Cancels an ongoing pointer trace.
java.lang.String	pointerDown(float x, float y, long t, float f, PointerType pointerType, int pointerId) Registers a pointer down event.
void	pointerEvents(PointerEvent[] events, boolean processGestures) Registers a list of pointer events.
void	pointerMove(float x, float y, long t, float f, PointerType pointerType, int pointerId) Registers a pointer move event.
void	pointerUp(float x, float y, long t, float f, PointerType pointerType, int pointerId) Registers a pointer up event.
void	redo() Redo the last action reverted by undo on part.
void	removeBlock(ContentBlock block) Removes a block from the part.
void	removeListener(IEditorListener listener) Removes the specified listener from this editor.
void	setFontMetricsProvider(IFontMetricsProvider fontMetricsProvider) Sets a font metrics provider to this editor.
void	setPart(ContentPart part) Sets the part managed by this editor.
void	setPenStyle(java.lang.String styleProperties) Sets the CSS style properties associated with new strokes.
void	setPenStyleClasses(java.lang.String styleClasses) Sets the style classes associated with new strokes.
void	setTheme(java.lang.String styleSheet) Changes the rendering theme style sheet, from a buffer containing CSS styling information.
void	setViewSize(int width, int height) Sets the size of the view.
void	undo() Undo the last action on part.
void	waitForIdle() Waits until part modification operations are over.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

close

public void close()

Description copied from interface: IAutoCloseable

Deletes native counterpart of this auto closable object

Specified by:

close in interface IAutoCloseable

isClosed

public final boolean isClosed()

Tells whether the close() method has been called. Once an object is closed any method will throw IllegalStateException.

Returns:

true if this object is closed.

addListener

public final void addListener(IEditorListener listener)

Adds the specified listener to this editor.

Parameters:

listener - the listener to be added.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalArgumentException - when listener is null.

removeListener

public final void removeListener(IEditorListener listener)

Removes the specified listener from this editor.

Parameters:

listener - the listener to be removed.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalArgumentException - when listener is null.

setFontMetricsProvider

public final void setFontMetricsProvider(IFontMetricsProvider fontMetricsProvider)

Sets a font metrics provider to this editor.

Parameters:

fontMetricsProvider - a IFontMetricsProvider.

Throws:

java.lang.IllegalStateException - when this editor is closed.

getEngine

public final Engine getEngine()

Returns the Engine to which this editor is attached.

Returns:

the engine.

getRenderer

public final Renderer getRenderer()

Returns the Renderer associated with this editor.

Returns:

the renderer.

getPart

public final ContentPart getPart()

Returns the part managed by this editor.

Returns:

the part.

setPart

public final void setPart(ContentPart part)

Sets the part managed by this editor.

Parameters:

part - the part.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when no IFontMetricsProvider has been set, via setFontMetricsProvider(IFontMetricsProvider)).

java.lang.IllegalStateException - when part is already bound.

java.lang.IllegalStateException - when this editor cannot be configured.

clear

public final void clear()

Removes all content from the part.

Throws:

java.lang.IllegalStateException - when this editor is closed.

canUndo

public final boolean canUndo()

Tells whether undo can be performed on the part or not

Returns:

true if undo can be performed, otherwise false.

Throws:

java.lang.IllegalStateException - when this editor is closed.

undo

public final void undo()

Undo the last action on part.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when undo operations failed.

canRedo

public final boolean canRedo()

Tells whether redo can be performed on the part or not

Returns:

true if redo can be performed, otherwise false.

Throws:

java.lang.IllegalStateException - when this editor is closed.

redo

public final void redo()

Redo the last action reverted by undo on part.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when redo operations failed.

getUndoStackIndex

public final int getUndoStackIndex()

Returns the number of operations performed on the part, since content part was opened.

Note: the undo stack is partially purged from time to time to control memory consumption. The number of possible undo operations at a given time is provided by getPossibleUndoCount(), while the total number of operations since content part was opened is provided by getUndoStackIndex().

Returns:

the number of operations performed on the part.

Throws:

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalStateException - when this editor is closed.

Since:

1.1

getPossibleUndoCount

public final int getPossibleUndoCount()

The number of operations that can be undone.

Returns:

the number of operations that can be undone.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

Since:

1.1

getPossibleRedoCount

public final int getPossibleRedoCount()

The number of operations that can be redone.

Returns:

the number of operations that can be redone.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

Since:

1.2

getUndoRedoIdAt

public final java.lang.String getUndoRedoIdAt(int stackIndex)

Returns the id of an undo or redo action, based on its position in the stack index. Valid stack index values range from (current stack index - possible undo count) to (current stack index + possible redo count - 1).

Parameters:

stackIndex - the index in the stack of the undo/redo action to retrieve.

Returns:

the id of the undo/redo operation at the specific index in the undo/redo stack.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when stackIndex is invalid.

java.lang.IllegalStateException - when this editor is not associated with a part.

Since:

1.2

pointerDown

public final java.lang.String pointerDown(float x,
                                          float y,
                                          long t,
                                          float f,
                                          PointerType pointerType,
                                          int pointerId)

Registers a pointer down event.

Parameters:

x - pointer event x coordinate (view coordinates in pixel).

y - pointer event y coordinate (view coordinates in pixel).

t - pointer event timestamp, in ms since Unix EPOCH.

f - normalized pressure.

pointerType - the type of input.

pointerId - the id of the pointer.

Returns:

the render item identifier of the starting stroke if any, otherwise null.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.NullPointerException - when pointerType is null.

java.lang.IllegalArgumentException - when x is not a number.

java.lang.IllegalArgumentException - when y is not a number.

java.lang.IllegalArgumentException - when t exceeds year 9999.

java.lang.IllegalArgumentException - when f is not a number.

java.lang.IllegalArgumentException - when f is negative.

java.lang.UnsupportedOperationException - when pointerDown() has already been called.

java.lang.IllegalStateException - in "Text Document" parts, when no view size is set.

pointerMove

public final void pointerMove(float x,
                              float y,
                              long t,
                              float f,
                              PointerType pointerType,
                              int pointerId)

Registers a pointer move event.

Parameters:

x - pointer event x coordinate (view coordinates in pixel).

y - pointer event y coordinate (view coordinates in pixel).

t - pointer event timestamp, in ms since Unix EPOCH.

f - normalized pressure.

pointerType - the type of input.

pointerId - the id of the pointer.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.NullPointerException - when pointerType is null.

java.lang.IllegalArgumentException - when x is not a number.

java.lang.IllegalArgumentException - when y is not a number.

java.lang.IllegalArgumentException - when t exceeds year 9999.

java.lang.IllegalArgumentException - when f is not a number.

java.lang.IllegalArgumentException - when f is negative.

java.lang.UnsupportedOperationException - when pointerDown() has not been called before.

pointerUp

public final void pointerUp(float x,
                            float y,
                            long t,
                            float f,
                            PointerType pointerType,
                            int pointerId)

Registers a pointer up event.

Parameters:

x - pointer event x coordinate (view coordinates in pixel).

y - pointer event y coordinate (view coordinates in pixel).

t - pointer event timestamp, in ms since Unix EPOCH.

f - normalized pressure.

pointerType - the type of input.

pointerId - the id of the pointer.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.NullPointerException - when pointerType is null.

java.lang.IllegalArgumentException - when x is not a number.

java.lang.IllegalArgumentException - when y is not a number.

java.lang.IllegalArgumentException - when t exceeds year 9999.

java.lang.IllegalArgumentException - when f is not a number.

java.lang.IllegalArgumentException - when f is negative.

java.lang.UnsupportedOperationException - when pointerDown() has not been called before.

pointerCancel

public final void pointerCancel(int pointerId)

Cancels an ongoing pointer trace.

Parameters:

pointerId - the id of the pointer.

Throws:

java.lang.IllegalStateException - when this editor is closed.

pointerEvents

public final void pointerEvents(PointerEvent[] events,
                                boolean processGestures)

Registers a list of pointer events.

Parameters:

events - the list of events (view coordinates in pixel).

processGestures - tells whether to process gestures or not.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.NullPointerException - when events is null.

java.lang.NullPointerException - when a pointer event contains a null pointerType.

java.lang.IllegalArgumentException - when a pointer event contains incorrect data.

java.lang.UnsupportedOperationException - when event sequence is not allowed.

setViewSize

public final void setViewSize(int width,
                              int height)

Sets the size of the view.

Parameters:

width - the view width (view coordinates in pixel).

height - the view height (view coordinates in pixel).

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalArgumentException - when width or height is negative.

getViewWidth

public final int getViewWidth()

The width of the view.

Returns:

the width of the view (view coordinates in pixel).

Throws:

java.lang.IllegalStateException - when this editor is closed.

Since:

1.3

getViewHeight

public final int getViewHeight()

The height of the view.

Returns:

the height of the view (view coordinates in pixel).

Throws:

java.lang.IllegalStateException - when this editor is closed.

Since:

1.3

clampViewOffset

public void clampViewOffset(Point viewOffset)

Clamps the supplied view offset to the area that ensures standard scrolling behavior. For "Diagram", "Drawing" and "Math" it allows scrolling one screen outside of the view box on each direction. For "Text" and "Text Document" it allows scrolling one screen outside of the view box downward.

Parameters:

viewOffset - the view offset to clamp (document coordinates in mm).

setTheme

public final void setTheme(java.lang.String styleSheet)

Changes the rendering theme style sheet, from a buffer containing CSS styling information.

Parameters:

styleSheet - the style sheet, in CSS format.

Throws:

java.lang.IllegalArgumentException - when styleSheet is invalid.

getTheme

public final java.lang.String getTheme()

Returns the rendering theme style sheet, in CSS format.

Returns:

the style sheet, in CSS format.

setPenStyleClasses

public final void setPenStyleClasses(java.lang.String styleClasses)

Sets the style classes associated with new strokes.

Note: style properties provided via setPenStyle() may override the styling associated with the style classes provided here.

Parameters:

styleClasses - the style class names associated with new strokes, by spaces.

Throws:

java.lang.IllegalStateException - when this editor is closed.

getPenStyleClasses

public final java.lang.String getPenStyleClasses()

Returns the style classes associated with new strokes.

Note: style properties provided with setPenStyle() may override the styling associated with the style classes provided here.

Returns:

the style class names associated with new strokes, separated by spaces.

Throws:

java.lang.IllegalStateException - when this editor is closed.

setPenStyle

public final void setPenStyle(java.lang.String styleProperties)

Sets the CSS style properties associated with new strokes.

Note: style properties provided with setPenStyle() may override the properties associated with the style classes provided via setPenStyleClasses().

Parameters:

styleProperties - the CSS style properties associated with new strokes.

Throws:

java.lang.IllegalStateException - when this editor is closed.

getPenStyle

public final java.lang.String getPenStyle()

Returns the style properties associated with new strokes.

Returns:

the style class names associated with new strokes, separated by spaces.

Throws:

java.lang.IllegalStateException - when this editor is closed.

listStyleClasses

public final java.util.Map<java.lang.String,Style> listStyleClasses(IPredicate<java.lang.String> predicate)

Lists the style classes that match a given predicate, associated with their styling properties.

Parameters:

predicate - a function that checks style class names and returns true if class should be added to the returned map, otherwise false.

Returns:

a map associating class names with styling properties.

Throws:

java.lang.IllegalStateException - when this editor is closed.

getRootBlock

public final ContentBlock getRootBlock()

Returns the content block at the root of the current part.

Returns:

the root content block.

getBlockById

public final ContentBlock getBlockById(java.lang.String id)

Returns the content block associated with a given id.

Parameters:

id - the identifier of the block.

Returns:

the content block associated with id or null if there is no such block in the current part.

isEmpty

public final boolean isEmpty(ContentBlock block)

Checks whether a block is empty.

Parameters:

block - the block to check, null means check the full part.

Returns:

true if block is empty or invalid or editor is not associated with a part, otherwise false.

getSupportedAddBlockTypes

public final java.lang.String[] getSupportedAddBlockTypes()

Returns the types of blocks that can be added to the part.

Note: new blocks can be added only to a content part with type "Text Document". "Text" blocks are automatically created but other blocks must be added via addBlock(float, float, String). Blocks cannot be added on other types of part.

Returns:

an array of the supported new content block types.

Throws:

java.lang.IllegalStateException - when this editor is closed.

getSupportedAddBlockDataMimeTypes

public final MimeType[] getSupportedAddBlockDataMimeTypes(java.lang.String type)

Returns the supported formats for adding a new block with data.

Parameters:

type - the type of the new block.

Returns:

an array of the supported mime types.

addBlock

public final ContentBlock addBlock(float x,
                                   float y,
                                   java.lang.String blockType)

Adds a new block to the part.

Parameters:

x - the approximate x position of the new block (view coordinates in pixel).

y - the approximate y position of the new block (view coordinates in pixel).

blockType - the type of the new block.

Returns:

block the newly added block.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalStateException - if type is not supported by current part type.

java.lang.IllegalStateException - if editor is not configured.

java.lang.IllegalStateException - if a block already exists at this position, and is not a "Container" block.

java.lang.IllegalStateException - if empty space around position is too small for a new block.

addBlock

public final ContentBlock addBlock(float x,
                                   float y,
                                   java.lang.String blockType,
                                   MimeType mimeType,
                                   java.lang.String data)

Adds a new block to the part and fills it with data.

Parameters:

x - the approximate x position of the new block (view coordinates in pixel).

y - the approximate y position of the new block (view coordinates in pixel).

blockType - the type of the new block.

mimeType - the mime type that specifies the format of data.

data - the data to put in the new block.

Returns:

block the newly added block.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - if type is not supported by current part type.

java.lang.IllegalStateException - if editor is not configured.

java.lang.IllegalStateException - if a block already exists at this position, and is not a "Container" block.

java.lang.IllegalStateException - if empty space around position is too small for a new block.

java.lang.IllegalStateException - when the content of data could not be added to the new block.

addImage

public final ContentBlock addImage(float x,
                                   float y,
                                   java.io.File inputFile,
                                   MimeType mimeType)
                            throws java.lang.NullPointerException,
                                   java.lang.IllegalArgumentException,
                                   java.io.IOException

Adds a new image to the part.

Note: this method creates a new "Drawing" block in which the image will be added.

Parameters:

x - the approximate x position of the new image (view coordinates in pixel).

y - the approximate y position of the new image (view coordinates in pixel).

inputFile - the image file to add.

mimeType - the mime type that specifies the format of inputFile.

Returns:

the "Drawing" block associated with the newly added image.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - if editor is not configured.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if mimeType is null.

java.lang.NullPointerException - if inputFile is null.

java.lang.IllegalStateException - if inputFile does not exist.

java.lang.IllegalArgumentException - if the mime type is not an image format.

java.lang.IllegalStateException - if a block already exists at this position, and is not a "Container" block.

java.lang.IllegalStateException - if empty space around position is too small for a new block.

java.io.IOException - if an I/O operation fails.

removeBlock

public final void removeBlock(ContentBlock block)

Removes a block from the part.

Note: the root block cannot be removed.

Parameters:

block - the block to remove.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalArgumentException - if block is a root block.

java.lang.IllegalStateException - if editor is not configured.

hitBlock

public final ContentBlock hitBlock(float x,
                                   float y)

Return the block at the given position, or null if there is no block at that position.

Parameters:

x - the hit position x coordinate (view coordinates in pixel).

y - the hit position y coordinate (view coordinates in pixel).

Returns:

the block below hit position, or null if no block was found.

Throws:

java.lang.IllegalStateException - when this editor is closed.

getSupportedTargetConversionStates

public final ConversionState[] getSupportedTargetConversionStates(ContentBlock block)

Returns the supported target conversion states for the specified content.

Parameters:

block - the block for which the supported target conversion states are requested, null means convert full part.

Returns:

an array of the supported target conversion states.

convert

public final void convert(ContentBlock block,
                          ConversionState targetState)

Converts the specified content to digital form.

Parameters:

block - the block to convert, null means convert full part.

targetState - the target conversion state for the block.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalStateException - if editor is not configured.

java.lang.IllegalArgumentException - when the target conversion state is not reachable from the current state of the specified block.

getSupportedExportMimeTypes

public final MimeType[] getSupportedExportMimeTypes(ContentBlock block)

Returns the supported export formats for specified content.

Parameters:

block - the block to request, null means full part.

Returns:

an array of the supported mime types.

Throws:

java.lang.IllegalStateException - when this editor is closed.

export_

public final java.lang.String export_(ContentBlock block,
                                      MimeType mimeType)
                               throws java.lang.NullPointerException,
                                      java.lang.IllegalArgumentException,
                                      java.lang.IllegalStateException,
                                      java.lang.UnsupportedOperationException,
                                      java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

mimeType - the mime type that specifies the output format.

Returns:

the exported content.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if mimeType is null.

java.lang.IllegalArgumentException - if the mime type is not a textual format.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

public final void export_(ContentBlock block,
                          java.io.OutputStream outputStream,
                          MimeType mimeType,
                          IImageDrawer imageDrawer)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalStateException,
                          java.lang.UnsupportedOperationException,
                          java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputStream - the stream to export to.

mimeType - the MIME type that specifies the desired output format.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputStream is null.

java.lang.NullPointerException - if mimeType is null.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

public final void export_(ContentBlock block,
                          java.io.OutputStream outputStream,
                          MimeType mimeType,
                          IImageDrawer imageDrawer,
                          ParameterSet overrideConfiguration)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalStateException,
                          java.lang.UnsupportedOperationException,
                          java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputStream - the stream to export to.

mimeType - the MIME type that specifies the desired output format.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

overrideConfiguration - the extra configuration used when exporting.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputStream is null.

java.lang.NullPointerException - if mimeType is null.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

@Deprecated
public final void export_(ContentBlock block,
                                      java.io.File outputFile,
                                      IImageDrawer imageDrawer)
                               throws java.lang.NullPointerException,
                                      java.lang.IllegalArgumentException,
                                      java.lang.IllegalStateException,
                                      java.lang.UnsupportedOperationException,
                                      java.io.IOException

Deprecated. use export_(ContentBlock, String, IImageDrawer) instead.

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputFile - the file to export to.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputFile is null.

java.lang.IllegalArgumentException - if the mime type cannot be determined from the output file name.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

@Deprecated
public final void export_(ContentBlock block,
                                      java.io.File outputFile,
                                      MimeType mimeType,
                                      IImageDrawer imageDrawer)
                               throws java.lang.NullPointerException,
                                      java.lang.IllegalStateException,
                                      java.lang.UnsupportedOperationException,
                                      java.io.IOException

Deprecated. use export_(ContentBlock, String, MimeType, IImageDrawer) instead.

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputFile - the file to export to.

mimeType - the mime type that specifies the output format.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputFile is null.

java.lang.NullPointerException - if mimeType is null.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

public final void export_(ContentBlock block,
                          java.lang.String outputFilePath,
                          IImageDrawer imageDrawer)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalArgumentException,
                          java.lang.IllegalStateException,
                          java.lang.UnsupportedOperationException,
                          java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputFilePath - the path of the file to export to.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputFilePath is null.

java.lang.IllegalArgumentException - if outputFilePath is invalid.

java.lang.IllegalArgumentException - if the mime type cannot be determined from the output file name.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

public final void export_(ContentBlock block,
                          java.lang.String outputFilePath,
                          MimeType mimeType,
                          IImageDrawer imageDrawer)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalStateException,
                          java.lang.UnsupportedOperationException,
                          java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputFilePath - the path of the file to export to.

mimeType - the mime type that specifies the output format.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputFilePath is null.

java.lang.IllegalArgumentException - if outputFilePath is invalid.

java.lang.NullPointerException - if mimeType is null.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

export_

public final java.lang.String export_(ContentBlock block,
                                      MimeType mimeType,
                                      ParameterSet overrideConfiguration)
                               throws java.lang.NullPointerException,
                                      java.lang.IllegalArgumentException,
                                      java.lang.IllegalStateException,
                                      java.lang.UnsupportedOperationException,
                                      java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

mimeType - the mime type that specifies the output format.

overrideConfiguration - the extra configuration used when exporting.

Returns:

the exported content.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if mimeType is null.

java.lang.IllegalArgumentException - if the mime type is not a textual format.

java.lang.IllegalStateException - if there is nothing to export.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

java.lang.IllegalArgumentException - if overrideConfiguration is invalid.

Since:

1.2

export_

public final void export_(ContentBlock block,
                          java.lang.String outputFilePath,
                          IImageDrawer imageDrawer,
                          ParameterSet overrideConfiguration)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalArgumentException,
                          java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputFilePath - the path of the file to export to.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

overrideConfiguration - the extra configuration used when exporting.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputFilePath is null.

java.lang.IllegalArgumentException - if outputFilePath is invalid.

java.lang.IllegalArgumentException - if the mime type cannot be determined from the output file name.

java.lang.IllegalStateException - if there is nothing to export.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

java.lang.IllegalArgumentException - if overrideConfiguration is invalid.

Since:

1.2

export_

public final void export_(ContentBlock block,
                          java.lang.String outputFilePath,
                          MimeType mimeType,
                          IImageDrawer imageDrawer,
                          ParameterSet overrideConfiguration)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalStateException,
                          java.lang.UnsupportedOperationException,
                          java.io.IOException

Exports the specified content.

Parameters:

block - the block to export, null means export full part.

outputFilePath - the path of the file to export to.

mimeType - the mime type that specifies the output format.

imageDrawer - an image drawer that is required for some output formats. If you know that the specified output format does not require it you can leave it null.

overrideConfiguration - the extra configuration used when exporting.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - if outputFilePath is null.

java.lang.IllegalArgumentException - if outputFilePath is invalid.

java.lang.NullPointerException - if mimeType is null.

java.lang.IllegalStateException - if there is nothing to export.

java.lang.UnsupportedOperationException - if the specified mime type is not supported.

java.io.IOException - if an I/O operation fails.

java.lang.IllegalStateException - when there are some ongoing operations on the part that prevent export, see isIdle().

java.lang.IllegalArgumentException - if overrideConfiguration is invalid.

Since:

1.2

getSupportedImportMimeTypes

public final MimeType[] getSupportedImportMimeTypes(ContentBlock block)

Returns the supported import formats for specified content.

Parameters:

block - the block to request, null means full part.

Returns:

an array of the supported mime types.

Throws:

java.lang.IllegalStateException - when this editor is closed.

import_

public final void import_(MimeType mimeType,
                          java.lang.String data,
                          ContentBlock block)
                   throws java.lang.IllegalStateException

Imports data into the part or a block.

Parameters:

mimeType - the mime type that specifies the format of data.

data - the data to import.

block - the target content block, or null to let editor detect the target.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalStateException - when the specified mime type is not supported.

java.lang.IllegalStateException - when data could not be imported.

copy

public final void copy(ContentBlock block)
                throws java.lang.IllegalStateException

Copies a block to the internal clipboard.

Parameters:

block - the block to copy, null means full part.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalStateException - when block cannot be copied.

paste

public final void paste(float x,
                        float y)
                 throws java.lang.IllegalStateException

Pastes the content of the internal clipboard at a given position. Internal clipboard is filled by calling copy(ContentBlock). If internal clipboard is empty, this does nothing.

Note: Following limitation applies: the part managed by this editor must be a "Text Document" and clipboard must contain a single block, that is not a "Container", from a "Text Document".

Parameters:

x - the target pasted block x coordinate (view coordinates in pixel).

y - the target pasted block y coordinate (view coordinates in pixel).

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.IllegalStateException - when content of the clipboard cannot be pasted on the part.

isIdle

public final boolean isIdle()

Checks whether part modification operations are over.

Returns:

true if there are no pending operations.

waitForIdle

public final void waitForIdle()

Waits until part modification operations are over.

isScrollAllowed

public final boolean isScrollAllowed()

Checks whether scrolling on the part is allowed at this time.

Returns:

true if scrolling is allowed.

getConfiguration

public final Configuration getConfiguration()

Returns the configuration associated with this editor.

Note: do not close the returned object as it is owned by the editor.

Returns:

the editor configuration.

drawStroke

public final void drawStroke(PointerEvent[] events,
                             ICanvas2 canvas)

Draws pointer events with current editor style settings on the given canvas.

Parameters:

events - the list of events (view coordinates in pixel).

canvas - the canvas on which editor should send the drawing commands.

Throws:

java.lang.IllegalStateException - when this editor is closed.

java.lang.IllegalStateException - when this editor is not associated with a part.

java.lang.NullPointerException - when events is null.

java.lang.NullPointerException - when a pointer event contains a null pointerType.

java.lang.IllegalArgumentException - when when renderer configuration is invalid.

java.lang.IllegalArgumentException - when a pointer event contains incorrect data.

java.lang.UnsupportedOperationException - when events sequence is invalid.