| com.pnfsoftware.jeb.client.api.IGraphicalClientContext |
Specialized context for clients displaying a graphical user interface.
Note: The public context of the official RCP desktop client implements this interface.
Note: Additional methods will be provided in to offer basic manipulation of UI elements.
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| abstract int |
displayList(String caption, String message, String[] headers, Object[][] rows)
Display a table of elements.
| ||||||||||
| abstract int |
displayMessageBox(String caption, String message, IconType iconType, ButtonGroupType bgType)
Display a message box to the user.
| ||||||||||
| abstract String |
displayQuestionBox(String caption, String message, String defaultValue)
Display a message box prompting the user for input.
| ||||||||||
| abstract void |
executeAsync(String taskName, Runnable runnable)
Execute a task asynchronously.
| ||||||||||
| abstract <T> T |
executeAsyncWithReturn(String taskName, Callable<T> callable)
Execute a task asynchronously, and retrieve a value returned by the task.
| ||||||||||
| abstract IUnitFragment |
findFragment(IUnit unit, String label, boolean focus)
Find and focus a view fragment for the provided unit with the provided name.
| ||||||||||
| abstract IUnitFragment |
getFocusedFragment()
Get the currently focused fragment.
| ||||||||||
| abstract IUnitView |
getFocusedView()
Get view containing the currently focused view
| ||||||||||
| abstract List<? extends IUnitView> |
getViews()
Get the list of all views in the current UI client.
| ||||||||||
| abstract List<? extends IUnitView> |
getViews(IUnit targetUnit)
Get the list of views representing the given unit within the UI client.
| ||||||||||
| abstract boolean |
openView(IUnit unit)
Create or open the view or set of views representing a given unit.
| ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From interface
com.pnfsoftware.jeb.client.api.IClientContext
| |||||||||||
Display a table of elements.
| caption | optional caption |
|---|---|
| message | optional message |
| headers | table headers |
| rows | rows; a row must have the same number of elements as the provided headers; objects are rendered using their #toString() method |
Display a message box to the user.
| caption | title for the message box |
|---|---|
| message | text to be displayed, can be multi-line |
| iconType | icon to be displayed in the message box (default: none) |
| bgType | button to be provided in the message box (default: OK) |
Display a message box prompting the user for input.
| caption | title for the message box |
|---|---|
| message | information, should be a single line of text |
| defaultValue | optional default input value, will be selected if provided |
Execute a task asynchronously. The task will not be executed on the UI thread. Users are
offered a way to cancel task execution. Therefore, if possible, the runnable should check for
user-requested interruption (using interrupted()), and interrupt processing
accordingly.
| taskName | optional task name |
|---|---|
| runnable | a runnable |
| InterruptedException | the task was interrupted |
|---|---|
| InvocationTargetException | an exception happened during execution of the task - retrieve it with getTargetException() or getCause() |
Execute a task asynchronously, and retrieve a value returned by the task. Users are offered a
way to cancel task execution. Therefore, if possible, the runnable should check for
user-requested interruption (using interrupted()), and interrupt processing
accordingly.
| taskName | optional task name |
|---|---|
| callable | a callable |
| InterruptedException | the task was interrupted |
|---|---|
| InvocationTargetException | an exception happened during execution of the task - retrieve it with getTargetException() or getCause() |
Find and focus a view fragment for the provided unit with the provided name.
| unit | target unit |
|---|---|
| label | fragment name, e.g. "disassembly" |
| focus | if true, on success, the fragment will also receive focus |
Get the list of all views in the current UI client.
Get the list of views representing the given unit within the UI client.
| targetUnit | the target unit, null to get all views |
|---|
Create or open the view or set of views representing a given unit. On success, one view will also receive focus.
| unit | the unit |
|---|
getViews(IUnit)