public interface IWidgetTokenKeeper
IWidgetTokenOwner and release the token to the
owner after usage. A widget token owner may request the token from the token
keeper. The keeper may deny the return of the token.
The widget token owner and keeper interplay is used by a text viewer in
order to manage the appearance and disappearance of addition, on-top popup
windows such as text hovers, content assist, etc.
In order to provide backward compatibility for clients of
IWidgetTokeKeeper, extension interfaces are used as a means
of evolution. The following extension interfaces exist:
IWidgetTokenKeeperExtension since version
3.0 introducing priorities when requesting a widget token and thus replacing
the non-prioritized scheme. It also allows a client to force a widget token
keeper to accept focus.IWidgetTokenKeeperExtension| Modifier and Type | Method and Description |
|---|---|
boolean |
requestWidgetToken(IWidgetTokenOwner owner)
The given widget token owner requests the widget token from this token
keeper.
|
boolean requestWidgetToken(IWidgetTokenOwner owner)
true if the token is released by this
token keeper. Note, the keeper must not call
releaseWidgetToken(IWidgetTokenKeeper) explicitly.
Replaced by
IWidgetTokenKeeperExtension.requestWidgetToken(IWidgetTokenOwner, int).
owner - the token ownertrue if token has been released false
otherwiseGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.