ro.sync.ecss.extensions.api.callouts

Interface AuthorCalloutsController

@API(type=NOT_EXTENDABLE,
     src=PUBLIC)
public interface AuthorCalloutsController

The callouts are representations of Track Changes insert and delete highlights, review comment highlights and custom review highlights in the Author mode on a side bar.
This controller can be used to decide what types of callouts must be presented in Author mode. It must be provided through AuthorReviewController.getAuthorCalloutsController() method.

To render a custom highlight as a callout in Author mode, a callout information provider must be set from setCalloutsRenderingInformationProvider(CalloutsRenderingInformationProvider) method.

By default, the callouts visibility in Author mode is controlled from Oxygen Preferences but it can be changed by using the methods in this class. The Preferences will not be affected by the API.

Since:

14

Method Summary

Modifier and Type	Method and Description
void	addCalloutActionsProvider(CalloutActionsProvider actionsProvider) Add a callout actions provider.
Rectangle	getCalloutRectangle(AuthorPersistentHighlight persistentHighlight) Retrieves the bounds of the callout box associated with an Author persistent highlight.
AuthorCalloutRenderingInformation	getDefaultAuthorCalloutRenderingInformation(AuthorPersistentHighlight highlight) Return the default rendering information for built-in persistent highlights (comment, insertion or deletion change).
boolean	isShowingCommentsCallouts() Check if the callouts corresponding to review comments and Change Tracking deletions and insertions with comments are visible in Author mode.
boolean	isShowingDeletionsCallouts() Check if the callouts corresponding to Change Tracking deletions are visible in Author mode.
boolean	isShowingInsertionsCallouts() Check if the callouts corresponding to Change Tracking insertions are visible in Author mode.
void	removeCalloutActionsProvider(CalloutActionsProvider actionsProvider) Remove a callout actions provider.
void	setCalloutsRenderingInformationProvider(CalloutsRenderingInformationProvider provider) Set the provider for data that will be rendered as a callout, in Author mode, for a specific highlight.
void	setShowCommentsCallouts(java.lang.Boolean showCommentsCallouts) The Track Changes insert and delete markers, the review comment markers and the custom review markers can be presented in Author mode as callouts.
void	setShowDeletionsCallouts(java.lang.Boolean showDeletionsCallouts) The Track Changes insert and delete markers, the review comment markers and the custom review markers can be presented in Author mode as callouts.
void	setShowInsertionsCallouts(java.lang.Boolean showInsertionsCallouts) The Track Changes insert and delete markers, the review comment markers and the custom review markers can be presented in Author mode as callouts.

Method Detail

isShowingCommentsCallouts

boolean isShowingCommentsCallouts()

Check if the callouts corresponding to review comments and Change Tracking deletions and insertions with comments are visible in Author mode.
By default, the comments callouts visibility in Author mode is controlled from Oxygen Preferences but it can be changed by using the setShowCommentsCallouts(Boolean) method.
Note that when there are no review callouts, the callouts side bar is collapsed.

Returns:

true if the callouts with comments are visible.

setShowCommentsCallouts

void setShowCommentsCallouts(java.lang.Boolean showCommentsCallouts)

The Track Changes insert and delete markers, the review comment markers and the custom review markers can be presented in Author mode as callouts.
This method can be used to override the default option from Oxygen Preferences that controls if the callouts corresponding to review comments and Change Tracking deletions and insertions with comments are displayed in Author mode.
Note that when there are no review callouts, the callouts side bar is collapsed.

Parameters:

showCommentsCallouts - If true, the review callouts with comments are displayed in Author mode. The callouts with comments are hidden when the provided value is false.
When the value is set to null, the option from Oxygen Preferences is taken into consideration.

isShowingDeletionsCallouts

boolean isShowingDeletionsCallouts()

Check if the callouts corresponding to Change Tracking deletions are visible in Author mode.
By default, the Change Tracking deletions callouts visibility in Author mode is controlled from Oxygen Preferences but it can be changed by using the setShowDeletionsCallouts(Boolean) method.
Note that when there are no review callouts, the callouts side bar is collapsed.

Returns:

true if the Track Changes deletions callouts are displayed in Author mode.

setShowDeletionsCallouts

void setShowDeletionsCallouts(java.lang.Boolean showDeletionsCallouts)

The Track Changes insert and delete markers, the review comment markers and the custom review markers can be presented in Author mode as callouts.
This method can be used to override the default option from Oxygen Preferences that controls if the callouts corresponding to Change Tracking deletions are displayed in Author mode.
Note that when there are no review callouts, the callouts side bar is collapsed.

Parameters:

showDeletionsCallouts - If true, the Track Changes deletions callouts are displayed in Author mode. The deletions callouts are hidden when the provided value is false.
When the value is set to null, the option from Oxygen Preferences is taken into consideration.

isShowingInsertionsCallouts

boolean isShowingInsertionsCallouts()

Check if the callouts corresponding to Change Tracking insertions are visible in Author mode.
By default, the Change Tracking insertions callouts visibility in Author mode is controlled from Oxygen Preferences but it can be changed by using the setShowInsertionsCallouts(Boolean) method.
Note that when there are no review callouts, the callouts side bar is collapsed.

Returns:

true if the Track Changes insertions callouts are visible.

setShowInsertionsCallouts

void setShowInsertionsCallouts(java.lang.Boolean showInsertionsCallouts)

The Track Changes insert and delete markers, the review comment markers and the custom review markers can be presented in Author mode as callouts.
This method can be used to override the default option from Oxygen Preferences that controls if the callouts corresponding to Change Tracking insertions are displayed in Author mode.
Note that when there are no review callouts, the callouts side bar is collapsed.

Parameters:

showInsertionsCallouts - If true, the Track Changes insertions callouts are displayed in Author mode. The insertions callouts are hidden when the provided value is false.
When the value is set to null, the option from Oxygen Preferences is taken into consideration.

setCalloutsRenderingInformationProvider

void setCalloutsRenderingInformationProvider(CalloutsRenderingInformationProvider provider)

Set the provider for data that will be rendered as a callout, in Author mode, for a specific highlight.
The callouts are representations of Track Changes insert and delete highlights, review comment highlights and custom review highlights in Author mode.
By default, the callouts visibility in Author mode is controlled from Oxygen Preferences but it can be changed by using the AuthorCalloutsController methods.

Parameters:

provider - The highlights callout rendering information provider.

Throws:

java.lang.IllegalArgumentException - Thrown when a property name is not a valid XML attribute name.

Since:

14

getCalloutRectangle

Rectangle getCalloutRectangle(AuthorPersistentHighlight persistentHighlight)

Retrieves the bounds of the callout box associated with an Author persistent highlight.

Parameters:

persistentHighlight - The Author persistent highlight.

Returns:

The bounds of the callout box associated with the given Author persistent highlight, relative to the editor area's origins, or null if there is no corresponding callout box.

Since:

14.2

addCalloutActionsProvider

void addCalloutActionsProvider(CalloutActionsProvider actionsProvider)

Add a callout actions provider.

Parameters:

actionsProvider - The callout actions provider.

Since:

17

removeCalloutActionsProvider

void removeCalloutActionsProvider(CalloutActionsProvider actionsProvider)

Remove a callout actions provider.

Parameters:

actionsProvider - The callout actions provider.

Since:

17

getDefaultAuthorCalloutRenderingInformation

AuthorCalloutRenderingInformation getDefaultAuthorCalloutRenderingInformation(AuthorPersistentHighlight highlight)

Return the default rendering information for built-in persistent highlights (comment, insertion or deletion change). You can change the rendering information for such highlights by setting a CalloutsRenderingInformationProvider and overriding its method CalloutsRenderingInformationProvider.handlesAlsoDefaultHighlights() to return true.
The callouts are representations of Track Changes insert and delete highlights, review comment highlights and custom review highlights in Author mode.

Parameters:

highlight - The Author persistent highlight. The type of the highlight can be obtained by using the AuthorPersistentHighlight.getType()

Returns:

the default rendering information for built-in persistent highlights (comment, insertion or deletion change).

Since:

17.1