Package ro.sync.ecss.extensions.dita

Class DITAAuthorTableOperationsHandler

java.lang.Object

ro.sync.ecss.extensions.api.table.operations.AuthorTableOperationsHandler

ro.sync.ecss.extensions.dita.DITAAuthorTableOperationsHandler

@API(type=INTERNAL,
     src=PUBLIC)
public class DITAAuthorTableOperationsHandler
extends AuthorTableOperationsHandler

Author table operations handler for DITA framework.

Constructor Summary

Constructors

Constructor	Description
DITAAuthorTableOperationsHandler()

Method Summary

Modifier and Type	Method	Description
TableColumnSpecificationInformation	getColumnSpecification(AuthorAccess authorAccess, AuthorElement tableElement, int columnIndex)	Returns the column specification information of a table column.
AuthorElement	getTableElementContainingOffset(AuthorAccess access, int offset)	Returns the element representing the table that contains the given offset.
boolean	handleAttributeChange(AuthorAccess authorAccess, AuthorElement currentElement, java.lang.String attributeName, AttrValue newValue)	Handle an attribute change.
boolean	handleCreateTable(AuthorTableArguments arguments)	Handles how a new table is created from cells selected from other table.
boolean	handleDeleteColumn(AuthorTableDeleteColumnArguments arguments)	Handles delete column operation.
boolean	handleDeleteRow(AuthorTableDeleteRowArguments arguments)	Handles delete row operation.
boolean	handleDeleteRows(AuthorTableDeleteRowsArguments arguments)	Handles delete rows operation.
boolean	handleInsertColumn(AuthorTableInsertColumnArguments tablePasteColumnArgs)	Handles insert column operation.
boolean	handlePasteRows(AuthorTableInsertRowArguments arguments)	Handles paste rows operation.
void	handleRemoveInvalidColNamesFromTableCells(AuthorAccess authorAccess, AuthorElement tableElement, java.util.List<AuthorElement> cells)	Remove from each cell attributes pointing to missing column names (usually namest, nameend, colname).

Methods inherited from class java.lang.Object

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

Constructor Detail

DITAAuthorTableOperationsHandler

public DITAAuthorTableOperationsHandler()

Method Detail

handleInsertColumn

public boolean handleInsertColumn(AuthorTableInsertColumnArguments tablePasteColumnArgs)
                           throws AuthorOperationException

Description copied from class: AuthorTableOperationsHandler

Handles insert column operation.
This method is called when pasting or dropping content for which the SelectionInterpretationMode.TABLE_COLUMN interpretation mode was imposed.

The SelectionInterpretationMode.TABLE_COLUMN interpretation mode is already set by default by the application when a table column is selected. It can be also imposed from the AuthorSelectionModel.setSelectionInterpretationMode(SelectionInterpretationMode) method, for any selection content.
For instance, when two paragraphs are copied, the clipboard object contains a list with two Author document fragments (one for each paragraph). If the selection interpretation mode is imposed to SelectionInterpretationMode.TABLE_COLUMN, when pasting the fragments this method is called. The fragments array are included in the argument object.

Overrides:

handleInsertColumn in class AuthorTableOperationsHandler

Parameters:

tablePasteColumnArgs - The arguments for insert column operation like: the offset where the column is inserted, the array containing the cells fragments that compose an Author table column, information about column width specification, the Author access.

Returns:

true if the insert column operation succeeds.

Throws:

AuthorOperationException - An insert column operation exception. If the AuthorOperationException.isOperationRejectedOnPurpose() method of this exception returns true, the exception is presented to the user.

See Also:

AuthorTableOperationsHandler.handleInsertColumn(ro.sync.ecss.extensions.api.table.operations.AuthorTableInsertColumnArguments)

handleDeleteColumn

public boolean handleDeleteColumn(AuthorTableDeleteColumnArguments arguments)
                           throws AuthorOperationException

Description copied from class: AuthorTableOperationsHandler

Handles delete column operation.
This method is called when deleting content (by drag and drop or cut operations) for which the SelectionInterpretationMode.TABLE_COLUMN interpretation mode was imposed.

The SelectionInterpretationMode.TABLE_COLUMN interpretation mode is already set by default by the application when a table column is selected. It can be also imposed from the AuthorSelectionModel.setSelectionInterpretationMode(SelectionInterpretationMode) method, for any selection content.
For instance, when two paragraphs are copied, the clipboard object contains a list with two Author document fragments (one for each paragraph). If the selection interpretation mode is imposed to SelectionInterpretationMode.TABLE_COLUMN, when deleting the fragments this method is called. The fragments array are included in the argument object.

Overrides:

handleDeleteColumn in class AuthorTableOperationsHandler

Parameters:

arguments - The arguments for delete column operation (like the Author access and the column cells start and end offsets).

Returns:

true if the delete column operation succeeds.

Throws:

AuthorOperationException - A delete column operation exception. If the AuthorOperationException.isOperationRejectedOnPurpose() method of this exception returns true, the exception is presented to the user.

See Also:

AuthorTableOperationsHandler.handleDeleteColumn(ro.sync.ecss.extensions.api.table.operations.AuthorTableDeleteColumnArguments)

handleDeleteRow

public boolean handleDeleteRow(AuthorTableDeleteRowArguments arguments)
                        throws AuthorOperationException

Description copied from class: AuthorTableOperationsHandler

Handles delete row operation.
This method is called when deleting content (by drag and drop or cut operations) for which the SelectionInterpretationMode.TABLE_ROW interpretation mode was imposed.

The SelectionInterpretationMode.TABLE_ROW interpretation mode is already set by default by the application when a table row is selected. It can be also imposed from the AuthorSelectionModel.setSelectionInterpretationMode(SelectionInterpretationMode) method, for any selection content.
For instance, when two paragraphs are copied, the clipboard object contains a list with two Author document fragments (one for each paragraph). If the selection interpretation mode is imposed to SelectionInterpretationMode.TABLE_ROW, when deleting the fragments this method is called. The fragments array are included in the argument object.

Overrides:

handleDeleteRow in class AuthorTableOperationsHandler

Parameters:

arguments - The arguments for delete row operation (like the Author access and the content interval of the row element that must be deleted).

Returns:

true if the delete row operation succeeds.

Throws:

AuthorOperationException - A delete row operation exception. If the AuthorOperationException.isOperationRejectedOnPurpose() method of this exception returns true, the exception is presented to the user.

See Also:

AuthorTableOperationsHandler.handleDeleteRow(ro.sync.ecss.extensions.api.table.operations.AuthorTableDeleteRowArguments)

handleDeleteRows

public boolean handleDeleteRows(AuthorTableDeleteRowsArguments arguments)
                         throws AuthorOperationException

Description copied from class: AuthorTableOperationsHandler

Handles delete rows operation. All the rows that intersects the given content intervals will be deleted.
This method is called when deleting content (by drag and drop or cut operations) for which the SelectionInterpretationMode.TABLE_ROW interpretation mode was imposed.

The SelectionInterpretationMode.TABLE_ROW interpretation mode is already set by default by the application when a table row is selected. It can be also imposed from the AuthorSelectionModel.setSelectionInterpretationMode(SelectionInterpretationMode) method, for any selection content.
For instance, when two paragraphs are copied, the clipboard object contains a list with two Author document fragments (one for each paragraph). If the selection interpretation mode is imposed to SelectionInterpretationMode.TABLE_ROW, when deleting the fragments this method is called.

Overrides:

handleDeleteRows in class AuthorTableOperationsHandler

Parameters:

arguments - The arguments for delete rows operation (like the Author access and the content intervals that determine the rows element that must be deleted).

Returns:

true if the delete rows operation succeeds.

Throws:

AuthorOperationException - A delete row operation exception. If the AuthorOperationException.isOperationRejectedOnPurpose() method of this exception returns true, the exception is presented to the user.

See Also:

AuthorTableOperationsHandler.handleDeleteRows(ro.sync.ecss.extensions.api.table.operations.AuthorTableDeleteRowsArguments)

getTableElementContainingOffset

public AuthorElement getTableElementContainingOffset(AuthorAccess access,
                                                     int offset)

Description copied from class: AuthorTableOperationsHandler

Returns the element representing the table that contains the given offset. This method can be used to obtain the closest table that contains the given offset.

Overrides:

getTableElementContainingOffset in class AuthorTableOperationsHandler

Parameters:

access - Access to Author operations.

offset - The offset to search the parent table element for.

Returns:

The table node that contains the given offset.

See Also:

AuthorTableOperationsHandler.getTableElementContainingOffset(ro.sync.ecss.extensions.api.AuthorAccess, int)

getColumnSpecification

public TableColumnSpecificationInformation getColumnSpecification(AuthorAccess authorAccess,
                                                                  AuthorElement tableElement,
                                                                  int columnIndex)

Description copied from class: AuthorTableOperationsHandler

Returns the column specification information of a table column.
This information is requested when a column is copied or dragged and it can be used when the column must be inserted in the document (on paste or drop). The column specification is send as an argument to the AuthorTableOperationsHandler.handleInsertColumn(AuthorTableInsertColumnArguments) method.

Overrides:

getColumnSpecification in class AuthorTableOperationsHandler

Parameters:

authorAccess - Access to Author operations.

tableElement - The table that contains the column.

columnIndex - The column index, 0 based.

Returns:

The column specification element. It can be null if there is no specification for this column.

See Also:

AuthorTableOperationsHandler.getColumnSpecification(ro.sync.ecss.extensions.api.AuthorAccess, ro.sync.ecss.extensions.api.node.AuthorElement, int)

handleRemoveInvalidColNamesFromTableCells

public void handleRemoveInvalidColNamesFromTableCells(AuthorAccess authorAccess,
                                                      AuthorElement tableElement,
                                                      java.util.List<AuthorElement> cells)

Description copied from class: AuthorTableOperationsHandler

Remove from each cell attributes pointing to missing column names (usually namest, nameend, colname).

Overrides:

handleRemoveInvalidColNamesFromTableCells in class AuthorTableOperationsHandler

Parameters:

authorAccess - The author access.

tableElement - The table element.

cells - The list of table cells.

See Also:

AuthorTableOperationsHandler.handleRemoveInvalidColNamesFromTableCells(ro.sync.ecss.extensions.api.AuthorAccess, ro.sync.ecss.extensions.api.node.AuthorElement, java.util.List)

handleAttributeChange

public boolean handleAttributeChange(AuthorAccess authorAccess,
                                     AuthorElement currentElement,
                                     java.lang.String attributeName,
                                     AttrValue newValue)

Description copied from class: AuthorTableOperationsHandler

Handle an attribute change.

Overrides:

handleAttributeChange in class AuthorTableOperationsHandler

Parameters:

authorAccess - The Author Access.

currentElement - The current element.

attributeName - The attribute name.

newValue - The new value.

Returns:

true if the changed was handled, false to perform the default bahavior.

See Also:

AuthorTableOperationsHandler.handleAttributeChange(ro.sync.ecss.extensions.api.AuthorAccess, ro.sync.ecss.extensions.api.node.AuthorElement, java.lang.String, ro.sync.ecss.extensions.api.node.AttrValue)

handlePasteRows

public boolean handlePasteRows(AuthorTableInsertRowArguments arguments)
                        throws AuthorOperationException

Description copied from class: AuthorTableOperationsHandler

Handles paste rows operation.
This method is called when pasting or dropping content for which the SelectionInterpretationMode.TABLE_ROW interpretation mode was imposed.

The SelectionInterpretationMode.TABLE_ROW interpretation mode is already set by default by the application when a table row is selected. It can be also imposed from the AuthorSelectionModel.setSelectionInterpretationMode(SelectionInterpretationMode) method, for any selection content.
For instance, when two paragraphs are copied, the clipboard object contains a list with two Author document fragments (one for each paragraph). If the selection interpretation mode is imposed to SelectionInterpretationMode.TABLE_ROW, when pasting the fragments this method is called. The fragments array are included in the argument object.

Overrides:

handlePasteRows in class AuthorTableOperationsHandler

Parameters:

arguments - The arguments for insert column operation like: the offset where the rows are inserted, the array containing the rows fragments, information about column width specification, the Author access.

Returns:

true if the paste rows operation succeeds.

Throws:

AuthorOperationException - An insert rows operation exception. If the AuthorOperationException.isOperationRejectedOnPurpose() method of this exception returns true, the exception is presented to the user.

See Also:

AuthorTableOperationsHandler.handlePasteRows(AuthorTableInsertRowArguments)

handleCreateTable

public boolean handleCreateTable(AuthorTableArguments arguments)
                          throws AuthorOperationException

Description copied from class: AuthorTableOperationsHandler

Handles how a new table is created from cells selected from other table.

Overrides:

handleCreateTable in class AuthorTableOperationsHandler

Parameters:

arguments - The arguments for copied cells like: the offset where the rows are inserted, the array containing the rows fragments, how many rows and columns the new table should have, the Author access.

Returns:

true of the table was successfully created.

Throws:

AuthorOperationException - A table creation exception. If the AuthorOperationException.isOperationRejectedOnPurpose() method of this exception returns true, the exception is presented to the user.

See Also:

AuthorTableOperationsHandler.handleCreateTable(ro.sync.ecss.extensions.api.table.operations.AuthorTableArguments)