|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A watch expression is an expression that is evaluated in the context of a specific stack frame, thread, debug target, process, or launch. Generally, a watch expression is a snippet of code that is evaluated each time a debug target suspends, or when a user provides a context for an evaluation by selecting a debug target or thread. An expression updates its value when it is provided with a context in which it can perform an evaluation.
Clients are not intended to implement this interface. An implementation
is provided by the debug platform. Clients that support watch expressions
should contribute and implement a watch exrepssion delegate. Watch
expressions can be created via the IExpressionManager
.
IWatchExpressionDelegate
,
IExpressionManager
Method Summary | |
---|---|
void |
evaluate()
Updates this watch expression's value based on the current evaluation context. |
boolean |
isEnabled()
Returns whether this expression is enabled. |
boolean |
isPending()
Returns whether the result of this watch expression is pending. |
void |
setEnabled(boolean enabled)
Sets this expression's enabled state. |
void |
setExpressionContext(IDebugElement context)
Sets the context for this watch expression, or null if none.
|
void |
setExpressionText(String expressionText)
Sets this watch expression's snippet of code. |
Methods inherited from interface org.eclipse.debug.core.model.IErrorReportingExpression |
---|
getErrorMessages, hasErrors |
Methods inherited from interface org.eclipse.debug.core.model.IExpression |
---|
dispose, getDebugTarget, getExpressionText, getValue |
Methods inherited from interface org.eclipse.debug.core.model.IDebugElement |
---|
getLaunch, getModelIdentifier |
Methods inherited from interface org.eclipse.core.runtime.IAdaptable |
---|
getAdapter |
Method Detail |
public void evaluate()
public void setExpressionContext(IDebugElement context)
null
if none.
If the given context is valid for this expression, this expression may
update its value. When the value update is complete, a debug change event is
fired. When null
is specified as a context, this expression
may choose to retain its previous value.
The context is usually one of (but not limited to):
IDebugTarget
)IThread
)IStackFrame
)
context
- context in which to update this expression's value, or
null
if nonepublic void setExpressionText(String expressionText)
expressionText
- the snippet which will be evaluatedpublic boolean isPending()
public boolean isEnabled()
public void setEnabled(boolean enabled)
enabled
- whether this expression should be enabled
|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.