org.odftoolkit.simple.common.navigation

Class ImageSelection

java.lang.Object

org.odftoolkit.simple.common.navigation.Selection

org.odftoolkit.simple.common.navigation.ImageSelection

public class ImageSelection
extends Selection

This is a decorator class of TextSelection, which help user replace a text content with a Image from Document or from URI.

Field Summary

Fields inherited from class org.odftoolkit.simple.common.navigation.Selection

search

Constructor Summary

Constructors

Constructor and Description
ImageSelection(TextSelection selection) Construct a ImageSelection with TextSelection.

Method Summary

Methods

Modifier and Type	Method and Description
void	cut() Delete the selection from the document the other matched selection in the same container element will be updated automatically because the start index of the following selections will be changed when the previous selection has been deleted.
void	pasteAtEndOf(Selection positionItem) Paste this selection just after a specific selection.
void	pasteAtFrontOf(Selection positionItem) Paste this selection just before a specific selection.
protected void	refresh(int offset) A quick method to update the index of this Selection.
protected void	refreshAfterFrontalDelete(Selection deletedItem) When a selected item has been deleted, the Selections after this deleted Selection should be refreshed, as these Selections index have been changed.
protected void	refreshAfterFrontalInsert(Selection insertedItem) When a selected item has been inserted, the Selection after the inserted item should be refresh, as these Selections index have been changed.
Image	replaceWithImage(Image image) Replace the content with a Image
Image	replaceWithImage(URI imageUri) Replace the content with a Image

Methods inherited from class org.odftoolkit.simple.common.navigation.Selection

getElement, getIndex, getNavigation

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageSelection

public ImageSelection(TextSelection selection)

Construct a ImageSelection with TextSelection. Then user can replace text content with Image from Document or Image form System

Parameters:

selection - the TextSelection to be decorated.

Method Detail

replaceWithImage

public Image replaceWithImage(Image image)

Replace the content with a Image

Parameters:

image - the reference Image to replace.

Returns:

the new Image in the TextDocument,the image name is set to "replace" + System.currentTimeMillis(), please update the name to others by yourself.

replaceWithImage

public Image replaceWithImage(URI imageUri)

Replace the content with a Image

Parameters:

imageUri - the URI of the reference Image to replace

Returns:

the new Image in the TextDocument,the image name is set to "replace" + System.currentTimeMillis(), please update the name to others by yourself

cut

public void cut()
         throws InvalidNavigationException

Delete the selection from the document the other matched selection in the same container element will be updated automatically because the start index of the following selections will be changed when the previous selection has been deleted.

Specified by:

cut in class Selection

Throws:

InvalidNavigationException - if the selection is unavailable.

pasteAtEndOf

public void pasteAtEndOf(Selection positionItem)
                  throws InvalidNavigationException

Paste this selection just after a specific selection.

Specified by:

pasteAtEndOf in class Selection

Parameters:

positionItem - a selection that is used to point out the position

Throws:

InvalidNavigationException - if the selection is unavailable.

pasteAtFrontOf

public void pasteAtFrontOf(Selection positionItem)
                    throws InvalidNavigationException

Paste this selection just before a specific selection.

Specified by:

pasteAtFrontOf in class Selection

Parameters:

positionItem - a selection that is used to point out the position

Throws:

InvalidNavigationException - if the selection is unavailable.

refresh

protected void refresh(int offset)

Description copied from class: Selection

A quick method to update the index of this Selection.

Specified by:

refresh in class Selection

Parameters:

offset - the offset that the index should be added.

refreshAfterFrontalDelete

protected void refreshAfterFrontalDelete(Selection deletedItem)

Description copied from class: Selection

When a selected item has been deleted, the Selections after this deleted Selection should be refreshed, as these Selections index have been changed.

Specified by:

refreshAfterFrontalDelete in class Selection

Parameters:

deletedItem - the deleted Selection

refreshAfterFrontalInsert

protected void refreshAfterFrontalInsert(Selection insertedItem)

Description copied from class: Selection

When a selected item has been inserted, the Selection after the inserted item should be refresh, as these Selections index have been changed.

Specified by:

refreshAfterFrontalInsert in class Selection

Parameters:

insertedItem - the inserted Selection