|
Eclipse Platform Release 3.6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IWatchExpression
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.
An implementation is provided by the debug platform. Clients that support watch expressions
should contribute and implement a watch expression 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 |
---|
void evaluate()
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 nonevoid setExpressionText(String expressionText)
expressionText
- the snippet which will be evaluatedboolean isPending()
boolean isEnabled()
void setEnabled(boolean enabled)
enabled
- whether this expression should be enabled
|
Eclipse Platform Release 3.6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2010. All rights reserved.