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
To render a custom highlight as a callout in Author mode, a callout information provider must be set from
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.
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 TypeMethodDescriptionvoid
addCalloutActionsProvider
(CalloutActionsProvider actionsProvider) Add a callout actions provider.getCalloutRectangle
(AuthorPersistentHighlight persistentHighlight) Retrieves the bounds of the callout box associated with an Author persistent highlight.Return the default rendering information for built-in persistent highlights (comment, insertion or deletion change).boolean
Check if the callouts corresponding to review comments and Change Tracking deletions and insertions with comments are visible in Author mode.boolean
Check if the callouts corresponding to Change Tracking deletions are visible in Author mode.boolean
Check if the callouts corresponding to Change Tracking insertions are visible in Author mode.void
removeCalloutActionsProvider
(CalloutActionsProvider actionsProvider) Remove a callout actions provider.void
Set the provider for data that will be rendered as a callout, in Author mode, for a specific highlight.void
setShowCommentsCallouts
(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
(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
(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 Details
-
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 thesetShowCommentsCallouts(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
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
- Iftrue
, the review callouts with comments are displayed in Author mode. The callouts with comments are hidden when the provided value isfalse
.
When the value is set tonull
, 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 thesetShowDeletionsCallouts(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
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
- Iftrue
, the Track Changes deletions callouts are displayed in Author mode. The deletions callouts are hidden when the provided value isfalse
.
When the value is set tonull
, 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 thesetShowInsertionsCallouts(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
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
- Iftrue
, the Track Changes insertions callouts are displayed in Author mode. The insertions callouts are hidden when the provided value isfalse
.
When the value is set tonull
, the option from Oxygen Preferences is taken into consideration.
-
setCalloutsRenderingInformationProvider
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 theAuthorCalloutsController
methods.- Parameters:
provider
- The highlights callout rendering information provider.- Throws:
IllegalArgumentException
- Thrown when a property name is not a valid XML attribute name.- Since:
- 14
-
getCalloutRectangle
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
Add a callout actions provider.- Parameters:
actionsProvider
- The callout actions provider.- Since:
- 17
-
removeCalloutActionsProvider
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 aCalloutsRenderingInformationProvider
and overriding its methodCalloutsRenderingInformationProvider.handlesAlsoDefaultHighlights()
to returntrue
.
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 theAuthorPersistentHighlight.getType()
- Returns:
- the default rendering information for built-in persistent highlights (comment, insertion or deletion change).
- Since:
- 17.1
-